Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /****************************************************************************** |
2 | * | |
3 | * Module Name: utobject - ACPI object create/delete/size/cache routines | |
4 | * | |
5 | *****************************************************************************/ | |
6 | ||
7 | /* | |
6c9deb72 | 8 | * Copyright (C) 2000 - 2007, R. Byron Moore |
1da177e4 LT |
9 | * All rights reserved. |
10 | * | |
11 | * Redistribution and use in source and binary forms, with or without | |
12 | * modification, are permitted provided that the following conditions | |
13 | * are met: | |
14 | * 1. Redistributions of source code must retain the above copyright | |
15 | * notice, this list of conditions, and the following disclaimer, | |
16 | * without modification. | |
17 | * 2. Redistributions in binary form must reproduce at minimum a disclaimer | |
18 | * substantially similar to the "NO WARRANTY" disclaimer below | |
19 | * ("Disclaimer") and any redistribution must be conditioned upon | |
20 | * including a substantially similar Disclaimer requirement for further | |
21 | * binary redistribution. | |
22 | * 3. Neither the names of the above-listed copyright holders nor the names | |
23 | * of any contributors may be used to endorse or promote products derived | |
24 | * from this software without specific prior written permission. | |
25 | * | |
26 | * Alternatively, this software may be distributed under the terms of the | |
27 | * GNU General Public License ("GPL") version 2 as published by the Free | |
28 | * Software Foundation. | |
29 | * | |
30 | * NO WARRANTY | |
31 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
32 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
33 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR | |
34 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
35 | * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
36 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
37 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
38 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | |
39 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING | |
40 | * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | |
41 | * POSSIBILITY OF SUCH DAMAGES. | |
42 | */ | |
43 | ||
1da177e4 LT |
44 | #include <acpi/acpi.h> |
45 | #include <acpi/acnamesp.h> | |
46 | #include <acpi/amlcode.h> | |
47 | ||
1da177e4 | 48 | #define _COMPONENT ACPI_UTILITIES |
4be44fcd | 49 | ACPI_MODULE_NAME("utobject") |
1da177e4 | 50 | |
44f6c012 | 51 | /* Local prototypes */ |
44f6c012 | 52 | static acpi_status |
4be44fcd LB |
53 | acpi_ut_get_simple_object_size(union acpi_operand_object *obj, |
54 | acpi_size * obj_length); | |
44f6c012 RM |
55 | |
56 | static acpi_status | |
4be44fcd LB |
57 | acpi_ut_get_package_object_size(union acpi_operand_object *obj, |
58 | acpi_size * obj_length); | |
44f6c012 RM |
59 | |
60 | static acpi_status | |
4be44fcd LB |
61 | acpi_ut_get_element_length(u8 object_type, |
62 | union acpi_operand_object *source_object, | |
63 | union acpi_generic_state *state, void *context); | |
1da177e4 LT |
64 | |
65 | /******************************************************************************* | |
66 | * | |
67 | * FUNCTION: acpi_ut_create_internal_object_dbg | |
68 | * | |
69 | * PARAMETERS: module_name - Source file name of caller | |
70 | * line_number - Line number of caller | |
71 | * component_id - Component type of caller | |
72 | * Type - ACPI Type of the new object | |
73 | * | |
44f6c012 | 74 | * RETURN: A new internal object, null on failure |
1da177e4 LT |
75 | * |
76 | * DESCRIPTION: Create and initialize a new internal object. | |
77 | * | |
78 | * NOTE: We always allocate the worst-case object descriptor because | |
79 | * these objects are cached, and we want them to be | |
80 | * one-size-satisifies-any-request. This in itself may not be | |
81 | * the most memory efficient, but the efficiency of the object | |
82 | * cache should more than make up for this! | |
83 | * | |
84 | ******************************************************************************/ | |
85 | ||
4be44fcd LB |
86 | union acpi_operand_object *acpi_ut_create_internal_object_dbg(char *module_name, |
87 | u32 line_number, | |
88 | u32 component_id, | |
89 | acpi_object_type | |
90 | type) | |
1da177e4 | 91 | { |
4be44fcd LB |
92 | union acpi_operand_object *object; |
93 | union acpi_operand_object *second_object; | |
1da177e4 | 94 | |
b229cf92 | 95 | ACPI_FUNCTION_TRACE_STR(ut_create_internal_object_dbg, |
4be44fcd | 96 | acpi_ut_get_type_name(type)); |
1da177e4 LT |
97 | |
98 | /* Allocate the raw object descriptor */ | |
99 | ||
4be44fcd LB |
100 | object = |
101 | acpi_ut_allocate_object_desc_dbg(module_name, line_number, | |
102 | component_id); | |
1da177e4 | 103 | if (!object) { |
4be44fcd | 104 | return_PTR(NULL); |
1da177e4 LT |
105 | } |
106 | ||
107 | switch (type) { | |
108 | case ACPI_TYPE_REGION: | |
109 | case ACPI_TYPE_BUFFER_FIELD: | |
ef805d95 | 110 | case ACPI_TYPE_LOCAL_BANK_FIELD: |
1da177e4 LT |
111 | |
112 | /* These types require a secondary object */ | |
113 | ||
4be44fcd LB |
114 | second_object = acpi_ut_allocate_object_desc_dbg(module_name, |
115 | line_number, | |
116 | component_id); | |
1da177e4 | 117 | if (!second_object) { |
4be44fcd LB |
118 | acpi_ut_delete_object_desc(object); |
119 | return_PTR(NULL); | |
1da177e4 LT |
120 | } |
121 | ||
122 | second_object->common.type = ACPI_TYPE_LOCAL_EXTRA; | |
123 | second_object->common.reference_count = 1; | |
124 | ||
125 | /* Link the second object to the first */ | |
126 | ||
127 | object->common.next_object = second_object; | |
128 | break; | |
129 | ||
130 | default: | |
131 | /* All others have no secondary object */ | |
132 | break; | |
133 | } | |
134 | ||
135 | /* Save the object type in the object descriptor */ | |
136 | ||
137 | object->common.type = (u8) type; | |
138 | ||
139 | /* Init the reference count */ | |
140 | ||
141 | object->common.reference_count = 1; | |
142 | ||
143 | /* Any per-type initialization should go here */ | |
144 | ||
4be44fcd | 145 | return_PTR(object); |
1da177e4 LT |
146 | } |
147 | ||
6287ee32 BM |
148 | /******************************************************************************* |
149 | * | |
150 | * FUNCTION: acpi_ut_create_package_object | |
151 | * | |
152 | * PARAMETERS: Count - Number of package elements | |
153 | * | |
154 | * RETURN: Pointer to a new Package object, null on failure | |
155 | * | |
156 | * DESCRIPTION: Create a fully initialized package object | |
157 | * | |
158 | ******************************************************************************/ | |
159 | ||
160 | union acpi_operand_object *acpi_ut_create_package_object(u32 count) | |
161 | { | |
162 | union acpi_operand_object *package_desc; | |
163 | union acpi_operand_object **package_elements; | |
164 | ||
165 | ACPI_FUNCTION_TRACE_U32(ut_create_package_object, count); | |
166 | ||
167 | /* Create a new Package object */ | |
168 | ||
169 | package_desc = acpi_ut_create_internal_object(ACPI_TYPE_PACKAGE); | |
170 | if (!package_desc) { | |
171 | return_PTR(NULL); | |
172 | } | |
173 | ||
174 | /* | |
175 | * Create the element array. Count+1 allows the array to be null | |
176 | * terminated. | |
177 | */ | |
178 | package_elements = ACPI_ALLOCATE_ZEROED((acpi_size) | |
179 | (count + 1) * sizeof(void *)); | |
180 | if (!package_elements) { | |
83dd4504 | 181 | acpi_ut_remove_reference(package_desc); |
6287ee32 BM |
182 | return_PTR(NULL); |
183 | } | |
184 | ||
185 | package_desc->package.count = count; | |
186 | package_desc->package.elements = package_elements; | |
187 | return_PTR(package_desc); | |
188 | } | |
189 | ||
1da177e4 LT |
190 | /******************************************************************************* |
191 | * | |
192 | * FUNCTION: acpi_ut_create_buffer_object | |
193 | * | |
194 | * PARAMETERS: buffer_size - Size of buffer to be created | |
195 | * | |
44f6c012 | 196 | * RETURN: Pointer to a new Buffer object, null on failure |
1da177e4 LT |
197 | * |
198 | * DESCRIPTION: Create a fully initialized buffer object | |
199 | * | |
200 | ******************************************************************************/ | |
201 | ||
4be44fcd | 202 | union acpi_operand_object *acpi_ut_create_buffer_object(acpi_size buffer_size) |
1da177e4 | 203 | { |
4be44fcd LB |
204 | union acpi_operand_object *buffer_desc; |
205 | u8 *buffer = NULL; | |
1da177e4 | 206 | |
b229cf92 | 207 | ACPI_FUNCTION_TRACE_U32(ut_create_buffer_object, buffer_size); |
1da177e4 LT |
208 | |
209 | /* Create a new Buffer object */ | |
210 | ||
4be44fcd | 211 | buffer_desc = acpi_ut_create_internal_object(ACPI_TYPE_BUFFER); |
1da177e4 | 212 | if (!buffer_desc) { |
4be44fcd | 213 | return_PTR(NULL); |
1da177e4 LT |
214 | } |
215 | ||
216 | /* Create an actual buffer only if size > 0 */ | |
217 | ||
218 | if (buffer_size > 0) { | |
52fc0b02 | 219 | |
1da177e4 LT |
220 | /* Allocate the actual buffer */ |
221 | ||
8313524a | 222 | buffer = ACPI_ALLOCATE_ZEROED(buffer_size); |
1da177e4 | 223 | if (!buffer) { |
b8e4d893 BM |
224 | ACPI_ERROR((AE_INFO, "Could not allocate size %X", |
225 | (u32) buffer_size)); | |
4be44fcd LB |
226 | acpi_ut_remove_reference(buffer_desc); |
227 | return_PTR(NULL); | |
1da177e4 LT |
228 | } |
229 | } | |
230 | ||
231 | /* Complete buffer object initialization */ | |
232 | ||
233 | buffer_desc->buffer.flags |= AOPOBJ_DATA_VALID; | |
234 | buffer_desc->buffer.pointer = buffer; | |
235 | buffer_desc->buffer.length = (u32) buffer_size; | |
236 | ||
237 | /* Return the new buffer descriptor */ | |
238 | ||
4be44fcd | 239 | return_PTR(buffer_desc); |
1da177e4 LT |
240 | } |
241 | ||
1da177e4 LT |
242 | /******************************************************************************* |
243 | * | |
244 | * FUNCTION: acpi_ut_create_string_object | |
245 | * | |
44f6c012 RM |
246 | * PARAMETERS: string_size - Size of string to be created. Does not |
247 | * include NULL terminator, this is added | |
248 | * automatically. | |
1da177e4 LT |
249 | * |
250 | * RETURN: Pointer to a new String object | |
251 | * | |
252 | * DESCRIPTION: Create a fully initialized string object | |
253 | * | |
254 | ******************************************************************************/ | |
255 | ||
4be44fcd | 256 | union acpi_operand_object *acpi_ut_create_string_object(acpi_size string_size) |
1da177e4 | 257 | { |
4be44fcd LB |
258 | union acpi_operand_object *string_desc; |
259 | char *string; | |
1da177e4 | 260 | |
b229cf92 | 261 | ACPI_FUNCTION_TRACE_U32(ut_create_string_object, string_size); |
1da177e4 LT |
262 | |
263 | /* Create a new String object */ | |
264 | ||
4be44fcd | 265 | string_desc = acpi_ut_create_internal_object(ACPI_TYPE_STRING); |
1da177e4 | 266 | if (!string_desc) { |
4be44fcd | 267 | return_PTR(NULL); |
1da177e4 LT |
268 | } |
269 | ||
270 | /* | |
271 | * Allocate the actual string buffer -- (Size + 1) for NULL terminator. | |
272 | * NOTE: Zero-length strings are NULL terminated | |
273 | */ | |
8313524a | 274 | string = ACPI_ALLOCATE_ZEROED(string_size + 1); |
1da177e4 | 275 | if (!string) { |
b8e4d893 BM |
276 | ACPI_ERROR((AE_INFO, "Could not allocate size %X", |
277 | (u32) string_size)); | |
4be44fcd LB |
278 | acpi_ut_remove_reference(string_desc); |
279 | return_PTR(NULL); | |
1da177e4 LT |
280 | } |
281 | ||
282 | /* Complete string object initialization */ | |
283 | ||
284 | string_desc->string.pointer = string; | |
285 | string_desc->string.length = (u32) string_size; | |
286 | ||
287 | /* Return the new string descriptor */ | |
288 | ||
4be44fcd | 289 | return_PTR(string_desc); |
1da177e4 LT |
290 | } |
291 | ||
1da177e4 LT |
292 | /******************************************************************************* |
293 | * | |
294 | * FUNCTION: acpi_ut_valid_internal_object | |
295 | * | |
296 | * PARAMETERS: Object - Object to be validated | |
297 | * | |
44f6c012 RM |
298 | * RETURN: TRUE if object is valid, FALSE otherwise |
299 | * | |
300 | * DESCRIPTION: Validate a pointer to be an union acpi_operand_object | |
1da177e4 LT |
301 | * |
302 | ******************************************************************************/ | |
303 | ||
4be44fcd | 304 | u8 acpi_ut_valid_internal_object(void *object) |
1da177e4 LT |
305 | { |
306 | ||
b229cf92 | 307 | ACPI_FUNCTION_NAME(ut_valid_internal_object); |
1da177e4 LT |
308 | |
309 | /* Check for a null pointer */ | |
310 | ||
311 | if (!object) { | |
4be44fcd | 312 | ACPI_DEBUG_PRINT((ACPI_DB_INFO, "**** Null Object Ptr\n")); |
1da177e4 LT |
313 | return (FALSE); |
314 | } | |
315 | ||
316 | /* Check the descriptor type field */ | |
317 | ||
4be44fcd | 318 | switch (ACPI_GET_DESCRIPTOR_TYPE(object)) { |
1da177e4 LT |
319 | case ACPI_DESC_TYPE_OPERAND: |
320 | ||
321 | /* The object appears to be a valid union acpi_operand_object */ | |
322 | ||
323 | return (TRUE); | |
324 | ||
325 | default: | |
4be44fcd LB |
326 | ACPI_DEBUG_PRINT((ACPI_DB_INFO, |
327 | "%p is not not an ACPI operand obj [%s]\n", | |
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 | * | |
343 | * RETURN: Pointer to newly allocated object descriptor. Null on error | |
344 | * | |
345 | * DESCRIPTION: Allocate a new object descriptor. Gracefully handle | |
346 | * error conditions. | |
347 | * | |
348 | ******************************************************************************/ | |
349 | ||
4be44fcd LB |
350 | void *acpi_ut_allocate_object_desc_dbg(char *module_name, |
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 | |
73459f73 | 367 | memset(object, 0, sizeof(union acpi_operand_object)); |
4be44fcd | 368 | ACPI_SET_DESCRIPTOR_TYPE(object, ACPI_DESC_TYPE_OPERAND); |
1da177e4 | 369 | |
4be44fcd LB |
370 | ACPI_DEBUG_PRINT((ACPI_DB_ALLOCATIONS, "%p Size %X\n", |
371 | object, (u32) sizeof(union acpi_operand_object))); | |
1da177e4 | 372 | |
4be44fcd | 373 | return_PTR(object); |
1da177e4 LT |
374 | } |
375 | ||
1da177e4 LT |
376 | /******************************************************************************* |
377 | * | |
378 | * FUNCTION: acpi_ut_delete_object_desc | |
379 | * | |
380 | * PARAMETERS: Object - An Acpi internal object to be deleted | |
381 | * | |
382 | * RETURN: None. | |
383 | * | |
384 | * DESCRIPTION: Free an ACPI object descriptor or add it to the object cache | |
385 | * | |
386 | ******************************************************************************/ | |
387 | ||
4be44fcd | 388 | void acpi_ut_delete_object_desc(union acpi_operand_object *object) |
1da177e4 | 389 | { |
b229cf92 | 390 | ACPI_FUNCTION_TRACE_PTR(ut_delete_object_desc, object); |
1da177e4 LT |
391 | |
392 | /* Object must be an union acpi_operand_object */ | |
393 | ||
4be44fcd | 394 | if (ACPI_GET_DESCRIPTOR_TYPE(object) != ACPI_DESC_TYPE_OPERAND) { |
b8e4d893 BM |
395 | ACPI_ERROR((AE_INFO, |
396 | "%p is not an ACPI Operand object [%s]", object, | |
397 | acpi_ut_get_descriptor_name(object))); | |
1da177e4 LT |
398 | return_VOID; |
399 | } | |
400 | ||
4be44fcd | 401 | (void)acpi_os_release_object(acpi_gbl_operand_cache, object); |
1da177e4 LT |
402 | return_VOID; |
403 | } | |
1da177e4 | 404 | |
1da177e4 LT |
405 | /******************************************************************************* |
406 | * | |
407 | * FUNCTION: acpi_ut_get_simple_object_size | |
408 | * | |
44f6c012 RM |
409 | * PARAMETERS: internal_object - An ACPI operand object |
410 | * obj_length - Where the length is returned | |
1da177e4 LT |
411 | * |
412 | * RETURN: Status | |
413 | * | |
414 | * DESCRIPTION: This function is called to determine the space required to | |
415 | * contain a simple object for return to an external user. | |
416 | * | |
417 | * The length includes the object structure plus any additional | |
418 | * needed space. | |
419 | * | |
420 | ******************************************************************************/ | |
421 | ||
44f6c012 | 422 | static acpi_status |
4be44fcd LB |
423 | acpi_ut_get_simple_object_size(union acpi_operand_object *internal_object, |
424 | acpi_size * obj_length) | |
1da177e4 | 425 | { |
4be44fcd LB |
426 | acpi_size length; |
427 | acpi_status status = AE_OK; | |
1da177e4 | 428 | |
b229cf92 | 429 | ACPI_FUNCTION_TRACE_PTR(ut_get_simple_object_size, internal_object); |
1da177e4 | 430 | |
44f6c012 RM |
431 | /* |
432 | * Handle a null object (Could be a uninitialized package | |
433 | * element -- which is legal) | |
434 | */ | |
1da177e4 | 435 | if (!internal_object) { |
c8d16e27 | 436 | *obj_length = sizeof(union acpi_object); |
4be44fcd | 437 | return_ACPI_STATUS(AE_OK); |
1da177e4 LT |
438 | } |
439 | ||
440 | /* Start with the length of the Acpi object */ | |
441 | ||
4be44fcd | 442 | length = sizeof(union acpi_object); |
1da177e4 | 443 | |
4be44fcd | 444 | if (ACPI_GET_DESCRIPTOR_TYPE(internal_object) == ACPI_DESC_TYPE_NAMED) { |
52fc0b02 | 445 | |
1da177e4 LT |
446 | /* Object is a named object (reference), just return the length */ |
447 | ||
4be44fcd LB |
448 | *obj_length = ACPI_ROUND_UP_TO_NATIVE_WORD(length); |
449 | return_ACPI_STATUS(status); | |
1da177e4 LT |
450 | } |
451 | ||
452 | /* | |
453 | * The final length depends on the object type | |
454 | * Strings and Buffers are packed right up against the parent object and | |
455 | * must be accessed bytewise or there may be alignment problems on | |
456 | * certain processors | |
457 | */ | |
4be44fcd | 458 | switch (ACPI_GET_OBJECT_TYPE(internal_object)) { |
1da177e4 LT |
459 | case ACPI_TYPE_STRING: |
460 | ||
461 | length += (acpi_size) internal_object->string.length + 1; | |
462 | break; | |
463 | ||
1da177e4 LT |
464 | case ACPI_TYPE_BUFFER: |
465 | ||
466 | length += (acpi_size) internal_object->buffer.length; | |
467 | break; | |
468 | ||
1da177e4 LT |
469 | case ACPI_TYPE_INTEGER: |
470 | case ACPI_TYPE_PROCESSOR: | |
471 | case ACPI_TYPE_POWER: | |
472 | ||
473 | /* | |
474 | * No extra data for these types | |
475 | */ | |
476 | break; | |
477 | ||
1da177e4 LT |
478 | case ACPI_TYPE_LOCAL_REFERENCE: |
479 | ||
480 | switch (internal_object->reference.opcode) { | |
481 | case AML_INT_NAMEPATH_OP: | |
482 | ||
483 | /* | |
484 | * Get the actual length of the full pathname to this object. | |
485 | * The reference will be converted to the pathname to the object | |
486 | */ | |
4be44fcd LB |
487 | length += |
488 | ACPI_ROUND_UP_TO_NATIVE_WORD | |
489 | (acpi_ns_get_pathname_length | |
490 | (internal_object->reference.node)); | |
1da177e4 LT |
491 | break; |
492 | ||
493 | default: | |
494 | ||
495 | /* | |
496 | * No other reference opcodes are supported. | |
497 | * Notably, Locals and Args are not supported, but this may be | |
498 | * required eventually. | |
499 | */ | |
b8e4d893 BM |
500 | ACPI_ERROR((AE_INFO, |
501 | "Unsupported Reference opcode=%X in object %p", | |
502 | internal_object->reference.opcode, | |
503 | internal_object)); | |
1da177e4 LT |
504 | status = AE_TYPE; |
505 | break; | |
506 | } | |
507 | break; | |
508 | ||
1da177e4 LT |
509 | default: |
510 | ||
b8e4d893 BM |
511 | ACPI_ERROR((AE_INFO, "Unsupported type=%X in object %p", |
512 | ACPI_GET_OBJECT_TYPE(internal_object), | |
513 | internal_object)); | |
1da177e4 LT |
514 | status = AE_TYPE; |
515 | break; | |
516 | } | |
517 | ||
518 | /* | |
519 | * Account for the space required by the object rounded up to the next | |
520 | * multiple of the machine word size. This keeps each object aligned | |
521 | * on a machine word boundary. (preventing alignment faults on some | |
522 | * machines.) | |
523 | */ | |
4be44fcd LB |
524 | *obj_length = ACPI_ROUND_UP_TO_NATIVE_WORD(length); |
525 | return_ACPI_STATUS(status); | |
1da177e4 LT |
526 | } |
527 | ||
1da177e4 LT |
528 | /******************************************************************************* |
529 | * | |
530 | * FUNCTION: acpi_ut_get_element_length | |
531 | * | |
532 | * PARAMETERS: acpi_pkg_callback | |
533 | * | |
534 | * RETURN: Status | |
535 | * | |
536 | * DESCRIPTION: Get the length of one package element. | |
537 | * | |
538 | ******************************************************************************/ | |
539 | ||
44f6c012 | 540 | static acpi_status |
4be44fcd LB |
541 | acpi_ut_get_element_length(u8 object_type, |
542 | union acpi_operand_object *source_object, | |
543 | union acpi_generic_state *state, void *context) | |
1da177e4 | 544 | { |
4be44fcd LB |
545 | acpi_status status = AE_OK; |
546 | struct acpi_pkg_info *info = (struct acpi_pkg_info *)context; | |
547 | acpi_size object_space; | |
1da177e4 LT |
548 | |
549 | switch (object_type) { | |
550 | case ACPI_COPY_TYPE_SIMPLE: | |
551 | ||
552 | /* | |
553 | * Simple object - just get the size (Null object/entry is handled | |
554 | * here also) and sum it into the running package length | |
555 | */ | |
4be44fcd LB |
556 | status = |
557 | acpi_ut_get_simple_object_size(source_object, | |
558 | &object_space); | |
559 | if (ACPI_FAILURE(status)) { | |
1da177e4 LT |
560 | return (status); |
561 | } | |
562 | ||
563 | info->length += object_space; | |
564 | break; | |
565 | ||
1da177e4 LT |
566 | case ACPI_COPY_TYPE_PACKAGE: |
567 | ||
568 | /* Package object - nothing much to do here, let the walk handle it */ | |
569 | ||
570 | info->num_packages++; | |
571 | state->pkg.this_target_obj = NULL; | |
572 | break; | |
573 | ||
1da177e4 LT |
574 | default: |
575 | ||
576 | /* No other types allowed */ | |
577 | ||
578 | return (AE_BAD_PARAMETER); | |
579 | } | |
580 | ||
581 | return (status); | |
582 | } | |
583 | ||
1da177e4 LT |
584 | /******************************************************************************* |
585 | * | |
586 | * FUNCTION: acpi_ut_get_package_object_size | |
587 | * | |
44f6c012 RM |
588 | * PARAMETERS: internal_object - An ACPI internal object |
589 | * obj_length - Where the length is returned | |
1da177e4 LT |
590 | * |
591 | * RETURN: Status | |
592 | * | |
593 | * DESCRIPTION: This function is called to determine the space required to | |
594 | * contain a package object for return to an external user. | |
595 | * | |
596 | * This is moderately complex since a package contains other | |
597 | * objects including packages. | |
598 | * | |
599 | ******************************************************************************/ | |
600 | ||
44f6c012 | 601 | static acpi_status |
4be44fcd LB |
602 | acpi_ut_get_package_object_size(union acpi_operand_object *internal_object, |
603 | acpi_size * obj_length) | |
1da177e4 | 604 | { |
4be44fcd LB |
605 | acpi_status status; |
606 | struct acpi_pkg_info info; | |
1da177e4 | 607 | |
b229cf92 | 608 | ACPI_FUNCTION_TRACE_PTR(ut_get_package_object_size, internal_object); |
1da177e4 | 609 | |
4be44fcd | 610 | info.length = 0; |
1da177e4 LT |
611 | info.object_space = 0; |
612 | info.num_packages = 1; | |
613 | ||
4be44fcd LB |
614 | status = acpi_ut_walk_package_tree(internal_object, NULL, |
615 | acpi_ut_get_element_length, &info); | |
616 | if (ACPI_FAILURE(status)) { | |
617 | return_ACPI_STATUS(status); | |
1da177e4 LT |
618 | } |
619 | ||
620 | /* | |
621 | * We have handled all of the objects in all levels of the package. | |
622 | * just add the length of the package objects themselves. | |
623 | * Round up to the next machine word. | |
624 | */ | |
4be44fcd LB |
625 | info.length += ACPI_ROUND_UP_TO_NATIVE_WORD(sizeof(union acpi_object)) * |
626 | (acpi_size) info.num_packages; | |
1da177e4 LT |
627 | |
628 | /* Return the total package length */ | |
629 | ||
630 | *obj_length = info.length; | |
4be44fcd | 631 | return_ACPI_STATUS(status); |
1da177e4 LT |
632 | } |
633 | ||
1da177e4 LT |
634 | /******************************************************************************* |
635 | * | |
636 | * FUNCTION: acpi_ut_get_object_size | |
637 | * | |
44f6c012 RM |
638 | * PARAMETERS: internal_object - An ACPI internal object |
639 | * obj_length - Where the length will be returned | |
1da177e4 LT |
640 | * |
641 | * RETURN: Status | |
642 | * | |
643 | * DESCRIPTION: This function is called to determine the space required to | |
644 | * contain an object for return to an API user. | |
645 | * | |
646 | ******************************************************************************/ | |
647 | ||
648 | acpi_status | |
4be44fcd LB |
649 | acpi_ut_get_object_size(union acpi_operand_object *internal_object, |
650 | acpi_size * obj_length) | |
1da177e4 | 651 | { |
4be44fcd LB |
652 | acpi_status status; |
653 | ||
654 | ACPI_FUNCTION_ENTRY(); | |
655 | ||
656 | if ((ACPI_GET_DESCRIPTOR_TYPE(internal_object) == | |
657 | ACPI_DESC_TYPE_OPERAND) | |
658 | && (ACPI_GET_OBJECT_TYPE(internal_object) == ACPI_TYPE_PACKAGE)) { | |
659 | status = | |
660 | acpi_ut_get_package_object_size(internal_object, | |
661 | obj_length); | |
662 | } else { | |
663 | status = | |
664 | acpi_ut_get_simple_object_size(internal_object, obj_length); | |
1da177e4 LT |
665 | } |
666 | ||
667 | return (status); | |
668 | } |