Commit | Line | Data |
---|---|---|
95857638 | 1 | // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 |
1da177e4 LT |
2 | /****************************************************************************** |
3 | * | |
4 | * Module Name: utobject - ACPI object create/delete/size/cache routines | |
5 | * | |
da6f8320 | 6 | * Copyright (C) 2000 - 2018, Intel Corp. |
1da177e4 | 7 | * |
95857638 | 8 | *****************************************************************************/ |
1da177e4 | 9 | |
1da177e4 | 10 | #include <acpi/acpi.h> |
e2f7a777 LB |
11 | #include "accommon.h" |
12 | #include "acnamesp.h" | |
1da177e4 | 13 | |
1da177e4 | 14 | #define _COMPONENT ACPI_UTILITIES |
4be44fcd | 15 | ACPI_MODULE_NAME("utobject") |
1da177e4 | 16 | |
44f6c012 | 17 | /* Local prototypes */ |
44f6c012 | 18 | static acpi_status |
4be44fcd | 19 | acpi_ut_get_simple_object_size(union acpi_operand_object *obj, |
f5c1e1c5 | 20 | acpi_size *obj_length); |
44f6c012 RM |
21 | |
22 | static acpi_status | |
4be44fcd | 23 | acpi_ut_get_package_object_size(union acpi_operand_object *obj, |
f5c1e1c5 | 24 | acpi_size *obj_length); |
44f6c012 RM |
25 | |
26 | static acpi_status | |
4be44fcd LB |
27 | acpi_ut_get_element_length(u8 object_type, |
28 | union acpi_operand_object *source_object, | |
29 | union acpi_generic_state *state, void *context); | |
1da177e4 LT |
30 | |
31 | /******************************************************************************* | |
32 | * | |
33 | * FUNCTION: acpi_ut_create_internal_object_dbg | |
34 | * | |
35 | * PARAMETERS: module_name - Source file name of caller | |
36 | * line_number - Line number of caller | |
37 | * component_id - Component type of caller | |
ba494bee | 38 | * type - ACPI Type of the new object |
1da177e4 | 39 | * |
44f6c012 | 40 | * RETURN: A new internal object, null on failure |
1da177e4 LT |
41 | * |
42 | * DESCRIPTION: Create and initialize a new internal object. | |
43 | * | |
44 | * NOTE: We always allocate the worst-case object descriptor because | |
45 | * these objects are cached, and we want them to be | |
73a3090a | 46 | * one-size-satisifies-any-request. This in itself may not be |
1da177e4 LT |
47 | * the most memory efficient, but the efficiency of the object |
48 | * cache should more than make up for this! | |
49 | * | |
50 | ******************************************************************************/ | |
51 | ||
4b8ed631 BM |
52 | union acpi_operand_object *acpi_ut_create_internal_object_dbg(const char |
53 | *module_name, | |
4be44fcd LB |
54 | u32 line_number, |
55 | u32 component_id, | |
56 | acpi_object_type | |
57 | type) | |
1da177e4 | 58 | { |
4be44fcd LB |
59 | union acpi_operand_object *object; |
60 | union acpi_operand_object *second_object; | |
1da177e4 | 61 | |
b229cf92 | 62 | ACPI_FUNCTION_TRACE_STR(ut_create_internal_object_dbg, |
4be44fcd | 63 | acpi_ut_get_type_name(type)); |
1da177e4 LT |
64 | |
65 | /* Allocate the raw object descriptor */ | |
66 | ||
4be44fcd LB |
67 | object = |
68 | acpi_ut_allocate_object_desc_dbg(module_name, line_number, | |
69 | component_id); | |
1da177e4 | 70 | if (!object) { |
4be44fcd | 71 | return_PTR(NULL); |
1da177e4 LT |
72 | } |
73 | ||
74 | switch (type) { | |
75 | case ACPI_TYPE_REGION: | |
76 | case ACPI_TYPE_BUFFER_FIELD: | |
ef805d95 | 77 | case ACPI_TYPE_LOCAL_BANK_FIELD: |
1da177e4 LT |
78 | |
79 | /* These types require a secondary object */ | |
80 | ||
1fad8738 BM |
81 | second_object = |
82 | acpi_ut_allocate_object_desc_dbg(module_name, line_number, | |
83 | component_id); | |
1da177e4 | 84 | if (!second_object) { |
4be44fcd LB |
85 | acpi_ut_delete_object_desc(object); |
86 | return_PTR(NULL); | |
1da177e4 LT |
87 | } |
88 | ||
89 | second_object->common.type = ACPI_TYPE_LOCAL_EXTRA; | |
90 | second_object->common.reference_count = 1; | |
91 | ||
92 | /* Link the second object to the first */ | |
93 | ||
94 | object->common.next_object = second_object; | |
95 | break; | |
96 | ||
97 | default: | |
1d1ea1b7 | 98 | |
1da177e4 LT |
99 | /* All others have no secondary object */ |
100 | break; | |
101 | } | |
102 | ||
103 | /* Save the object type in the object descriptor */ | |
104 | ||
105 | object->common.type = (u8) type; | |
106 | ||
107 | /* Init the reference count */ | |
108 | ||
109 | object->common.reference_count = 1; | |
110 | ||
111 | /* Any per-type initialization should go here */ | |
112 | ||
4be44fcd | 113 | return_PTR(object); |
1da177e4 LT |
114 | } |
115 | ||
6287ee32 BM |
116 | /******************************************************************************* |
117 | * | |
118 | * FUNCTION: acpi_ut_create_package_object | |
119 | * | |
ba494bee | 120 | * PARAMETERS: count - Number of package elements |
6287ee32 BM |
121 | * |
122 | * RETURN: Pointer to a new Package object, null on failure | |
123 | * | |
124 | * DESCRIPTION: Create a fully initialized package object | |
125 | * | |
126 | ******************************************************************************/ | |
127 | ||
128 | union acpi_operand_object *acpi_ut_create_package_object(u32 count) | |
129 | { | |
130 | union acpi_operand_object *package_desc; | |
131 | union acpi_operand_object **package_elements; | |
132 | ||
133 | ACPI_FUNCTION_TRACE_U32(ut_create_package_object, count); | |
134 | ||
135 | /* Create a new Package object */ | |
136 | ||
137 | package_desc = acpi_ut_create_internal_object(ACPI_TYPE_PACKAGE); | |
138 | if (!package_desc) { | |
139 | return_PTR(NULL); | |
140 | } | |
141 | ||
142 | /* | |
143 | * Create the element array. Count+1 allows the array to be null | |
144 | * terminated. | |
145 | */ | |
f5c1e1c5 | 146 | package_elements = ACPI_ALLOCATE_ZEROED(((acpi_size)count + |
67a119f9 | 147 | 1) * sizeof(void *)); |
6287ee32 | 148 | if (!package_elements) { |
bd48d677 | 149 | ACPI_FREE(package_desc); |
6287ee32 BM |
150 | return_PTR(NULL); |
151 | } | |
152 | ||
153 | package_desc->package.count = count; | |
154 | package_desc->package.elements = package_elements; | |
155 | return_PTR(package_desc); | |
156 | } | |
157 | ||
502f7efa BM |
158 | /******************************************************************************* |
159 | * | |
160 | * FUNCTION: acpi_ut_create_integer_object | |
161 | * | |
162 | * PARAMETERS: initial_value - Initial value for the integer | |
163 | * | |
164 | * RETURN: Pointer to a new Integer object, null on failure | |
165 | * | |
166 | * DESCRIPTION: Create an initialized integer object | |
167 | * | |
168 | ******************************************************************************/ | |
169 | ||
170 | union acpi_operand_object *acpi_ut_create_integer_object(u64 initial_value) | |
171 | { | |
172 | union acpi_operand_object *integer_desc; | |
173 | ||
174 | ACPI_FUNCTION_TRACE(ut_create_integer_object); | |
175 | ||
176 | /* Create and initialize a new integer object */ | |
177 | ||
178 | integer_desc = acpi_ut_create_internal_object(ACPI_TYPE_INTEGER); | |
179 | if (!integer_desc) { | |
180 | return_PTR(NULL); | |
181 | } | |
182 | ||
183 | integer_desc->integer.value = initial_value; | |
184 | return_PTR(integer_desc); | |
185 | } | |
186 | ||
1da177e4 LT |
187 | /******************************************************************************* |
188 | * | |
189 | * FUNCTION: acpi_ut_create_buffer_object | |
190 | * | |
191 | * PARAMETERS: buffer_size - Size of buffer to be created | |
192 | * | |
44f6c012 | 193 | * RETURN: Pointer to a new Buffer object, null on failure |
1da177e4 LT |
194 | * |
195 | * DESCRIPTION: Create a fully initialized buffer object | |
196 | * | |
197 | ******************************************************************************/ | |
198 | ||
4be44fcd | 199 | union acpi_operand_object *acpi_ut_create_buffer_object(acpi_size buffer_size) |
1da177e4 | 200 | { |
4be44fcd LB |
201 | union acpi_operand_object *buffer_desc; |
202 | u8 *buffer = NULL; | |
1da177e4 | 203 | |
b229cf92 | 204 | ACPI_FUNCTION_TRACE_U32(ut_create_buffer_object, buffer_size); |
1da177e4 LT |
205 | |
206 | /* Create a new Buffer object */ | |
207 | ||
4be44fcd | 208 | buffer_desc = acpi_ut_create_internal_object(ACPI_TYPE_BUFFER); |
1da177e4 | 209 | if (!buffer_desc) { |
4be44fcd | 210 | return_PTR(NULL); |
1da177e4 LT |
211 | } |
212 | ||
213 | /* Create an actual buffer only if size > 0 */ | |
214 | ||
215 | if (buffer_size > 0) { | |
52fc0b02 | 216 | |
1da177e4 LT |
217 | /* Allocate the actual buffer */ |
218 | ||
8313524a | 219 | buffer = ACPI_ALLOCATE_ZEROED(buffer_size); |
1da177e4 | 220 | if (!buffer) { |
f6a22b0b | 221 | ACPI_ERROR((AE_INFO, "Could not allocate size %u", |
5431b654 | 222 | (u32)buffer_size)); |
1fad8738 | 223 | |
4be44fcd LB |
224 | acpi_ut_remove_reference(buffer_desc); |
225 | return_PTR(NULL); | |
1da177e4 LT |
226 | } |
227 | } | |
228 | ||
229 | /* Complete buffer object initialization */ | |
230 | ||
231 | buffer_desc->buffer.flags |= AOPOBJ_DATA_VALID; | |
232 | buffer_desc->buffer.pointer = buffer; | |
233 | buffer_desc->buffer.length = (u32) buffer_size; | |
234 | ||
235 | /* Return the new buffer descriptor */ | |
236 | ||
4be44fcd | 237 | return_PTR(buffer_desc); |
1da177e4 LT |
238 | } |
239 | ||
1da177e4 LT |
240 | /******************************************************************************* |
241 | * | |
242 | * FUNCTION: acpi_ut_create_string_object | |
243 | * | |
44f6c012 RM |
244 | * PARAMETERS: string_size - Size of string to be created. Does not |
245 | * include NULL terminator, this is added | |
246 | * automatically. | |
1da177e4 LT |
247 | * |
248 | * RETURN: Pointer to a new String object | |
249 | * | |
250 | * DESCRIPTION: Create a fully initialized string object | |
251 | * | |
252 | ******************************************************************************/ | |
253 | ||
4be44fcd | 254 | union acpi_operand_object *acpi_ut_create_string_object(acpi_size string_size) |
1da177e4 | 255 | { |
4be44fcd LB |
256 | union acpi_operand_object *string_desc; |
257 | char *string; | |
1da177e4 | 258 | |
b229cf92 | 259 | ACPI_FUNCTION_TRACE_U32(ut_create_string_object, string_size); |
1da177e4 LT |
260 | |
261 | /* Create a new String object */ | |
262 | ||
4be44fcd | 263 | string_desc = acpi_ut_create_internal_object(ACPI_TYPE_STRING); |
1da177e4 | 264 | if (!string_desc) { |
4be44fcd | 265 | return_PTR(NULL); |
1da177e4 LT |
266 | } |
267 | ||
268 | /* | |
269 | * Allocate the actual string buffer -- (Size + 1) for NULL terminator. | |
270 | * NOTE: Zero-length strings are NULL terminated | |
271 | */ | |
8313524a | 272 | string = ACPI_ALLOCATE_ZEROED(string_size + 1); |
1da177e4 | 273 | if (!string) { |
f6a22b0b | 274 | ACPI_ERROR((AE_INFO, "Could not allocate size %u", |
5431b654 | 275 | (u32)string_size)); |
1fad8738 | 276 | |
4be44fcd LB |
277 | acpi_ut_remove_reference(string_desc); |
278 | return_PTR(NULL); | |
1da177e4 LT |
279 | } |
280 | ||
281 | /* Complete string object initialization */ | |
282 | ||
283 | string_desc->string.pointer = string; | |
284 | string_desc->string.length = (u32) string_size; | |
285 | ||
286 | /* Return the new string descriptor */ | |
287 | ||
4be44fcd | 288 | return_PTR(string_desc); |
1da177e4 LT |
289 | } |
290 | ||
1da177e4 LT |
291 | /******************************************************************************* |
292 | * | |
293 | * FUNCTION: acpi_ut_valid_internal_object | |
294 | * | |
ba494bee | 295 | * PARAMETERS: object - Object to be validated |
1da177e4 | 296 | * |
44f6c012 RM |
297 | * RETURN: TRUE if object is valid, FALSE otherwise |
298 | * | |
cf48958e | 299 | * DESCRIPTION: Validate a pointer to be of type union acpi_operand_object |
1da177e4 LT |
300 | * |
301 | ******************************************************************************/ | |
302 | ||
4be44fcd | 303 | u8 acpi_ut_valid_internal_object(void *object) |
1da177e4 LT |
304 | { |
305 | ||
b229cf92 | 306 | ACPI_FUNCTION_NAME(ut_valid_internal_object); |
1da177e4 LT |
307 | |
308 | /* Check for a null pointer */ | |
309 | ||
310 | if (!object) { | |
7bcc06e8 | 311 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "**** Null Object Ptr\n")); |
1da177e4 LT |
312 | return (FALSE); |
313 | } | |
314 | ||
315 | /* Check the descriptor type field */ | |
316 | ||
4be44fcd | 317 | switch (ACPI_GET_DESCRIPTOR_TYPE(object)) { |
1da177e4 LT |
318 | case ACPI_DESC_TYPE_OPERAND: |
319 | ||
cf48958e | 320 | /* The object appears to be a valid union acpi_operand_object */ |
1da177e4 LT |
321 | |
322 | return (TRUE); | |
323 | ||
324 | default: | |
1d1ea1b7 | 325 | |
7bcc06e8 | 326 | ACPI_DEBUG_PRINT((ACPI_DB_EXEC, |
6d3be300 | 327 | "%p is not an ACPI operand obj [%s]\n", |
4be44fcd | 328 | object, acpi_ut_get_descriptor_name(object))); |
1da177e4 LT |
329 | break; |
330 | } | |
331 | ||
332 | return (FALSE); | |
333 | } | |
334 | ||
1da177e4 LT |
335 | /******************************************************************************* |
336 | * | |
337 | * FUNCTION: acpi_ut_allocate_object_desc_dbg | |
338 | * | |
339 | * PARAMETERS: module_name - Caller's module name (for error output) | |
340 | * line_number - Caller's line number (for error output) | |
341 | * component_id - Caller's component ID (for error output) | |
342 | * | |
73a3090a | 343 | * RETURN: Pointer to newly allocated object descriptor. Null on error |
1da177e4 | 344 | * |
73a3090a | 345 | * DESCRIPTION: Allocate a new object descriptor. Gracefully handle |
1da177e4 LT |
346 | * error conditions. |
347 | * | |
348 | ******************************************************************************/ | |
349 | ||
4b8ed631 | 350 | void *acpi_ut_allocate_object_desc_dbg(const char *module_name, |
4be44fcd | 351 | u32 line_number, u32 component_id) |
1da177e4 | 352 | { |
4be44fcd | 353 | union acpi_operand_object *object; |
1da177e4 | 354 | |
b229cf92 | 355 | ACPI_FUNCTION_TRACE(ut_allocate_object_desc_dbg); |
1da177e4 | 356 | |
4be44fcd | 357 | object = acpi_os_acquire_object(acpi_gbl_operand_cache); |
1da177e4 | 358 | if (!object) { |
b8e4d893 BM |
359 | ACPI_ERROR((module_name, line_number, |
360 | "Could not allocate an object descriptor")); | |
1da177e4 | 361 | |
4be44fcd | 362 | return_PTR(NULL); |
1da177e4 LT |
363 | } |
364 | ||
365 | /* Mark the descriptor type */ | |
8313524a | 366 | |
4be44fcd | 367 | ACPI_SET_DESCRIPTOR_TYPE(object, ACPI_DESC_TYPE_OPERAND); |
1da177e4 | 368 | |
4be44fcd LB |
369 | ACPI_DEBUG_PRINT((ACPI_DB_ALLOCATIONS, "%p Size %X\n", |
370 | object, (u32) sizeof(union acpi_operand_object))); | |
1da177e4 | 371 | |
4be44fcd | 372 | return_PTR(object); |
1da177e4 LT |
373 | } |
374 | ||
1da177e4 LT |
375 | /******************************************************************************* |
376 | * | |
377 | * FUNCTION: acpi_ut_delete_object_desc | |
378 | * | |
ba494bee | 379 | * PARAMETERS: object - An Acpi internal object to be deleted |
1da177e4 LT |
380 | * |
381 | * RETURN: None. | |
382 | * | |
383 | * DESCRIPTION: Free an ACPI object descriptor or add it to the object cache | |
384 | * | |
385 | ******************************************************************************/ | |
386 | ||
4be44fcd | 387 | void acpi_ut_delete_object_desc(union acpi_operand_object *object) |
1da177e4 | 388 | { |
b229cf92 | 389 | ACPI_FUNCTION_TRACE_PTR(ut_delete_object_desc, object); |
1da177e4 | 390 | |
75c8044f | 391 | /* Object must be of type union acpi_operand_object */ |
1da177e4 | 392 | |
4be44fcd | 393 | if (ACPI_GET_DESCRIPTOR_TYPE(object) != ACPI_DESC_TYPE_OPERAND) { |
b8e4d893 BM |
394 | ACPI_ERROR((AE_INFO, |
395 | "%p is not an ACPI Operand object [%s]", object, | |
396 | acpi_ut_get_descriptor_name(object))); | |
1da177e4 LT |
397 | return_VOID; |
398 | } | |
399 | ||
4be44fcd | 400 | (void)acpi_os_release_object(acpi_gbl_operand_cache, object); |
1da177e4 LT |
401 | return_VOID; |
402 | } | |
1da177e4 | 403 | |
1da177e4 LT |
404 | /******************************************************************************* |
405 | * | |
406 | * FUNCTION: acpi_ut_get_simple_object_size | |
407 | * | |
44f6c012 RM |
408 | * PARAMETERS: internal_object - An ACPI operand object |
409 | * obj_length - Where the length is returned | |
1da177e4 LT |
410 | * |
411 | * RETURN: Status | |
412 | * | |
413 | * DESCRIPTION: This function is called to determine the space required to | |
414 | * contain a simple object for return to an external user. | |
415 | * | |
416 | * The length includes the object structure plus any additional | |
417 | * needed space. | |
418 | * | |
419 | ******************************************************************************/ | |
420 | ||
44f6c012 | 421 | static acpi_status |
4be44fcd | 422 | acpi_ut_get_simple_object_size(union acpi_operand_object *internal_object, |
f5c1e1c5 | 423 | acpi_size *obj_length) |
1da177e4 | 424 | { |
4be44fcd | 425 | acpi_size length; |
3c7db22a | 426 | acpi_size size; |
4be44fcd | 427 | acpi_status status = AE_OK; |
1da177e4 | 428 | |
b229cf92 | 429 | ACPI_FUNCTION_TRACE_PTR(ut_get_simple_object_size, internal_object); |
1da177e4 | 430 | |
130797a6 LZ |
431 | /* Start with the length of the (external) Acpi object */ |
432 | ||
433 | length = sizeof(union acpi_object); | |
434 | ||
435 | /* A NULL object is allowed, can be a legal uninitialized package element */ | |
436 | ||
437 | if (!internal_object) { | |
44f6c012 | 438 | /* |
130797a6 LZ |
439 | * Object is NULL, just return the length of union acpi_object |
440 | * (A NULL union acpi_object is an object of all zeroes.) | |
44f6c012 | 441 | */ |
130797a6 | 442 | *obj_length = ACPI_ROUND_UP_TO_NATIVE_WORD(length); |
4be44fcd | 443 | return_ACPI_STATUS(AE_OK); |
1da177e4 LT |
444 | } |
445 | ||
130797a6 | 446 | /* A Namespace Node should never appear here */ |
1da177e4 | 447 | |
4be44fcd | 448 | if (ACPI_GET_DESCRIPTOR_TYPE(internal_object) == ACPI_DESC_TYPE_NAMED) { |
52fc0b02 | 449 | |
130797a6 | 450 | /* A namespace node should never get here */ |
1da177e4 | 451 | |
a62a7117 BM |
452 | ACPI_ERROR((AE_INFO, |
453 | "Received a namespace node [%4.4s] " | |
454 | "where an operand object is required", | |
455 | ACPI_CAST_PTR(struct acpi_namespace_node, | |
456 | internal_object)->name.ascii)); | |
130797a6 | 457 | return_ACPI_STATUS(AE_AML_INTERNAL); |
1da177e4 LT |
458 | } |
459 | ||
460 | /* | |
461 | * The final length depends on the object type | |
462 | * Strings and Buffers are packed right up against the parent object and | |
463 | * must be accessed bytewise or there may be alignment problems on | |
464 | * certain processors | |
465 | */ | |
3371c19c | 466 | switch (internal_object->common.type) { |
1da177e4 LT |
467 | case ACPI_TYPE_STRING: |
468 | ||
f5c1e1c5 | 469 | length += (acpi_size)internal_object->string.length + 1; |
1da177e4 LT |
470 | break; |
471 | ||
1da177e4 LT |
472 | case ACPI_TYPE_BUFFER: |
473 | ||
f5c1e1c5 | 474 | length += (acpi_size)internal_object->buffer.length; |
1da177e4 LT |
475 | break; |
476 | ||
1da177e4 LT |
477 | case ACPI_TYPE_INTEGER: |
478 | case ACPI_TYPE_PROCESSOR: | |
479 | case ACPI_TYPE_POWER: | |
480 | ||
7a5bb996 LM |
481 | /* No extra data for these types */ |
482 | ||
1da177e4 LT |
483 | break; |
484 | ||
1da177e4 LT |
485 | case ACPI_TYPE_LOCAL_REFERENCE: |
486 | ||
1044f1f6 BM |
487 | switch (internal_object->reference.class) { |
488 | case ACPI_REFCLASS_NAME: | |
1da177e4 LT |
489 | /* |
490 | * Get the actual length of the full pathname to this object. | |
491 | * The reference will be converted to the pathname to the object | |
492 | */ | |
3c7db22a BM |
493 | size = |
494 | acpi_ns_get_pathname_length(internal_object-> | |
495 | reference.node); | |
496 | if (!size) { | |
497 | return_ACPI_STATUS(AE_BAD_PARAMETER); | |
498 | } | |
499 | ||
500 | length += ACPI_ROUND_UP_TO_NATIVE_WORD(size); | |
1da177e4 LT |
501 | break; |
502 | ||
503 | default: | |
1da177e4 LT |
504 | /* |
505 | * No other reference opcodes are supported. | |
506 | * Notably, Locals and Args are not supported, but this may be | |
507 | * required eventually. | |
508 | */ | |
b8e4d893 | 509 | ACPI_ERROR((AE_INFO, |
c2de3a49 | 510 | "Cannot convert to external object - " |
f6a22b0b | 511 | "unsupported Reference Class [%s] 0x%X in object %p", |
c2de3a49 | 512 | acpi_ut_get_reference_name(internal_object), |
1044f1f6 | 513 | internal_object->reference.class, |
b8e4d893 | 514 | internal_object)); |
1da177e4 LT |
515 | status = AE_TYPE; |
516 | break; | |
517 | } | |
518 | break; | |
519 | ||
1da177e4 LT |
520 | default: |
521 | ||
c2de3a49 | 522 | ACPI_ERROR((AE_INFO, "Cannot convert to external object - " |
f6a22b0b | 523 | "unsupported type [%s] 0x%X in object %p", |
c2de3a49 | 524 | acpi_ut_get_object_type_name(internal_object), |
3371c19c | 525 | internal_object->common.type, internal_object)); |
1da177e4 LT |
526 | status = AE_TYPE; |
527 | break; | |
528 | } | |
529 | ||
530 | /* | |
531 | * Account for the space required by the object rounded up to the next | |
73a3090a | 532 | * multiple of the machine word size. This keeps each object aligned |
1da177e4 LT |
533 | * on a machine word boundary. (preventing alignment faults on some |
534 | * machines.) | |
535 | */ | |
4be44fcd LB |
536 | *obj_length = ACPI_ROUND_UP_TO_NATIVE_WORD(length); |
537 | return_ACPI_STATUS(status); | |
1da177e4 LT |
538 | } |
539 | ||
1da177e4 LT |
540 | /******************************************************************************* |
541 | * | |
542 | * FUNCTION: acpi_ut_get_element_length | |
543 | * | |
544 | * PARAMETERS: acpi_pkg_callback | |
545 | * | |
546 | * RETURN: Status | |
547 | * | |
548 | * DESCRIPTION: Get the length of one package element. | |
549 | * | |
550 | ******************************************************************************/ | |
551 | ||
44f6c012 | 552 | static acpi_status |
4be44fcd LB |
553 | acpi_ut_get_element_length(u8 object_type, |
554 | union acpi_operand_object *source_object, | |
555 | union acpi_generic_state *state, void *context) | |
1da177e4 | 556 | { |
4be44fcd LB |
557 | acpi_status status = AE_OK; |
558 | struct acpi_pkg_info *info = (struct acpi_pkg_info *)context; | |
559 | acpi_size object_space; | |
1da177e4 LT |
560 | |
561 | switch (object_type) { | |
562 | case ACPI_COPY_TYPE_SIMPLE: | |
1da177e4 LT |
563 | /* |
564 | * Simple object - just get the size (Null object/entry is handled | |
565 | * here also) and sum it into the running package length | |
566 | */ | |
4be44fcd LB |
567 | status = |
568 | acpi_ut_get_simple_object_size(source_object, | |
569 | &object_space); | |
570 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
571 | return (status); |
572 | } | |
573 | ||
574 | info->length += object_space; | |
575 | break; | |
576 | ||
1da177e4 LT |
577 | case ACPI_COPY_TYPE_PACKAGE: |
578 | ||
579 | /* Package object - nothing much to do here, let the walk handle it */ | |
580 | ||
581 | info->num_packages++; | |
582 | state->pkg.this_target_obj = NULL; | |
583 | break; | |
584 | ||
1da177e4 LT |
585 | default: |
586 | ||
587 | /* No other types allowed */ | |
588 | ||
589 | return (AE_BAD_PARAMETER); | |
590 | } | |
591 | ||
592 | return (status); | |
593 | } | |
594 | ||
1da177e4 LT |
595 | /******************************************************************************* |
596 | * | |
597 | * FUNCTION: acpi_ut_get_package_object_size | |
598 | * | |
44f6c012 RM |
599 | * PARAMETERS: internal_object - An ACPI internal object |
600 | * obj_length - Where the length is returned | |
1da177e4 LT |
601 | * |
602 | * RETURN: Status | |
603 | * | |
604 | * DESCRIPTION: This function is called to determine the space required to | |
605 | * contain a package object for return to an external user. | |
606 | * | |
607 | * This is moderately complex since a package contains other | |
608 | * objects including packages. | |
609 | * | |
610 | ******************************************************************************/ | |
611 | ||
44f6c012 | 612 | static acpi_status |
4be44fcd | 613 | acpi_ut_get_package_object_size(union acpi_operand_object *internal_object, |
f5c1e1c5 | 614 | acpi_size *obj_length) |
1da177e4 | 615 | { |
4be44fcd LB |
616 | acpi_status status; |
617 | struct acpi_pkg_info info; | |
1da177e4 | 618 | |
b229cf92 | 619 | ACPI_FUNCTION_TRACE_PTR(ut_get_package_object_size, internal_object); |
1da177e4 | 620 | |
4be44fcd | 621 | info.length = 0; |
1da177e4 LT |
622 | info.object_space = 0; |
623 | info.num_packages = 1; | |
624 | ||
1fad8738 BM |
625 | status = |
626 | acpi_ut_walk_package_tree(internal_object, NULL, | |
627 | acpi_ut_get_element_length, &info); | |
4be44fcd LB |
628 | if (ACPI_FAILURE(status)) { |
629 | return_ACPI_STATUS(status); | |
1da177e4 LT |
630 | } |
631 | ||
632 | /* | |
633 | * We have handled all of the objects in all levels of the package. | |
634 | * just add the length of the package objects themselves. | |
635 | * Round up to the next machine word. | |
636 | */ | |
1fad8738 BM |
637 | info.length += |
638 | ACPI_ROUND_UP_TO_NATIVE_WORD(sizeof(union acpi_object)) * | |
f5c1e1c5 | 639 | (acpi_size)info.num_packages; |
1da177e4 LT |
640 | |
641 | /* Return the total package length */ | |
642 | ||
643 | *obj_length = info.length; | |
4be44fcd | 644 | return_ACPI_STATUS(status); |
1da177e4 LT |
645 | } |
646 | ||
1da177e4 LT |
647 | /******************************************************************************* |
648 | * | |
649 | * FUNCTION: acpi_ut_get_object_size | |
650 | * | |
44f6c012 RM |
651 | * PARAMETERS: internal_object - An ACPI internal object |
652 | * obj_length - Where the length will be returned | |
1da177e4 LT |
653 | * |
654 | * RETURN: Status | |
655 | * | |
656 | * DESCRIPTION: This function is called to determine the space required to | |
657 | * contain an object for return to an API user. | |
658 | * | |
659 | ******************************************************************************/ | |
660 | ||
661 | acpi_status | |
4be44fcd | 662 | acpi_ut_get_object_size(union acpi_operand_object *internal_object, |
f5c1e1c5 | 663 | acpi_size *obj_length) |
1da177e4 | 664 | { |
4be44fcd LB |
665 | acpi_status status; |
666 | ||
667 | ACPI_FUNCTION_ENTRY(); | |
668 | ||
669 | if ((ACPI_GET_DESCRIPTOR_TYPE(internal_object) == | |
1fad8738 BM |
670 | ACPI_DESC_TYPE_OPERAND) && |
671 | (internal_object->common.type == ACPI_TYPE_PACKAGE)) { | |
4be44fcd LB |
672 | status = |
673 | acpi_ut_get_package_object_size(internal_object, | |
674 | obj_length); | |
675 | } else { | |
676 | status = | |
677 | acpi_ut_get_simple_object_size(internal_object, obj_length); | |
1da177e4 LT |
678 | } |
679 | ||
680 | return (status); | |
681 | } |