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