1 // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2 /******************************************************************************
4 * Module Name: exdump - Interpreter debug output routines
6 * Copyright (C) 2000 - 2020, Intel Corp.
8 *****************************************************************************/
10 #include <acpi/acpi.h>
16 #define _COMPONENT ACPI_EXECUTER
17 ACPI_MODULE_NAME("exdump")
20 * The following routines are used for debug output only
22 #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
23 /* Local prototypes */
24 static void acpi_ex_out_string(const char *title
, const char *value
);
26 static void acpi_ex_out_pointer(const char *title
, const void *value
);
29 acpi_ex_dump_object(union acpi_operand_object
*obj_desc
,
30 struct acpi_exdump_info
*info
);
32 static void acpi_ex_dump_reference_obj(union acpi_operand_object
*obj_desc
);
35 acpi_ex_dump_package_obj(union acpi_operand_object
*obj_desc
,
36 u32 level
, u32 index
);
38 /*******************************************************************************
40 * Object Descriptor info tables
42 * Note: The first table entry must be an INIT opcode and must contain
43 * the table length (number of table entries)
45 ******************************************************************************/
47 static struct acpi_exdump_info acpi_ex_dump_integer
[2] = {
48 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_integer
), NULL
},
49 {ACPI_EXD_UINT64
, ACPI_EXD_OFFSET(integer
.value
), "Value"}
52 static struct acpi_exdump_info acpi_ex_dump_string
[4] = {
53 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_string
), NULL
},
54 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(string
.length
), "Length"},
55 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(string
.pointer
), "Pointer"},
56 {ACPI_EXD_STRING
, 0, NULL
}
59 static struct acpi_exdump_info acpi_ex_dump_buffer
[5] = {
60 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_buffer
), NULL
},
61 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(buffer
.length
), "Length"},
62 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(buffer
.pointer
), "Pointer"},
63 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(buffer
.node
), "Parent Node"},
64 {ACPI_EXD_BUFFER
, 0, NULL
}
67 static struct acpi_exdump_info acpi_ex_dump_package
[6] = {
68 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_package
), NULL
},
69 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(package
.node
), "Parent Node"},
70 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(package
.flags
), "Flags"},
71 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(package
.count
), "Element Count"},
72 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(package
.elements
), "Element List"},
73 {ACPI_EXD_PACKAGE
, 0, NULL
}
76 static struct acpi_exdump_info acpi_ex_dump_device
[4] = {
77 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_device
), NULL
},
78 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(device
.notify_list
[0]),
80 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(device
.notify_list
[1]),
82 {ACPI_EXD_HDLR_LIST
, ACPI_EXD_OFFSET(device
.handler
), "Handler"}
85 static struct acpi_exdump_info acpi_ex_dump_event
[2] = {
86 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_event
), NULL
},
87 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(event
.os_semaphore
), "OsSemaphore"}
90 static struct acpi_exdump_info acpi_ex_dump_method
[9] = {
91 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_method
), NULL
},
92 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(method
.info_flags
), "Info Flags"},
93 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(method
.param_count
),
95 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(method
.sync_level
), "Sync Level"},
96 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(method
.mutex
), "Mutex"},
97 {ACPI_EXD_UINT16
, ACPI_EXD_OFFSET(method
.owner_id
), "Owner Id"},
98 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(method
.thread_count
), "Thread Count"},
99 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(method
.aml_length
), "Aml Length"},
100 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(method
.aml_start
), "Aml Start"}
103 static struct acpi_exdump_info acpi_ex_dump_mutex
[6] = {
104 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_mutex
), NULL
},
105 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(mutex
.sync_level
), "Sync Level"},
106 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(mutex
.original_sync_level
),
107 "Original Sync Level"},
108 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(mutex
.owner_thread
), "Owner Thread"},
109 {ACPI_EXD_UINT16
, ACPI_EXD_OFFSET(mutex
.acquisition_depth
),
111 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(mutex
.os_mutex
), "OsMutex"}
114 static struct acpi_exdump_info acpi_ex_dump_region
[8] = {
115 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_region
), NULL
},
116 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(region
.space_id
), "Space Id"},
117 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(region
.flags
), "Flags"},
118 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(region
.node
), "Parent Node"},
119 {ACPI_EXD_ADDRESS
, ACPI_EXD_OFFSET(region
.address
), "Address"},
120 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(region
.length
), "Length"},
121 {ACPI_EXD_HDLR_LIST
, ACPI_EXD_OFFSET(region
.handler
), "Handler"},
122 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(region
.next
), "Next"}
125 static struct acpi_exdump_info acpi_ex_dump_power
[6] = {
126 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_power
), NULL
},
127 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(power_resource
.system_level
),
129 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(power_resource
.resource_order
),
131 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(power_resource
.notify_list
[0]),
133 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(power_resource
.notify_list
[1]),
135 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(power_resource
.handler
), "Handler"}
138 static struct acpi_exdump_info acpi_ex_dump_processor
[7] = {
139 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_processor
), NULL
},
140 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(processor
.proc_id
), "Processor ID"},
141 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(processor
.length
), "Length"},
142 {ACPI_EXD_ADDRESS
, ACPI_EXD_OFFSET(processor
.address
), "Address"},
143 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(processor
.notify_list
[0]),
145 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(processor
.notify_list
[1]),
147 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(processor
.handler
), "Handler"}
150 static struct acpi_exdump_info acpi_ex_dump_thermal
[4] = {
151 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_thermal
), NULL
},
152 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(thermal_zone
.notify_list
[0]),
154 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(thermal_zone
.notify_list
[1]),
156 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(thermal_zone
.handler
), "Handler"}
159 static struct acpi_exdump_info acpi_ex_dump_buffer_field
[3] = {
160 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_buffer_field
), NULL
},
161 {ACPI_EXD_FIELD
, 0, NULL
},
162 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(buffer_field
.buffer_obj
),
166 static struct acpi_exdump_info acpi_ex_dump_region_field
[5] = {
167 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_region_field
), NULL
},
168 {ACPI_EXD_FIELD
, 0, NULL
},
169 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(field
.access_length
), "AccessLength"},
170 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(field
.region_obj
), "Region Object"},
171 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(field
.resource_buffer
),
175 static struct acpi_exdump_info acpi_ex_dump_bank_field
[5] = {
176 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_bank_field
), NULL
},
177 {ACPI_EXD_FIELD
, 0, NULL
},
178 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(bank_field
.value
), "Value"},
179 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(bank_field
.region_obj
),
181 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(bank_field
.bank_obj
), "Bank Object"}
184 static struct acpi_exdump_info acpi_ex_dump_index_field
[5] = {
185 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_bank_field
), NULL
},
186 {ACPI_EXD_FIELD
, 0, NULL
},
187 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(index_field
.value
), "Value"},
188 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(index_field
.index_obj
),
190 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(index_field
.data_obj
), "Data Object"}
193 static struct acpi_exdump_info acpi_ex_dump_reference
[9] = {
194 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_reference
), NULL
},
195 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(reference
.class), "Class"},
196 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(reference
.target_type
), "Target Type"},
197 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(reference
.value
), "Value"},
198 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(reference
.object
), "Object Desc"},
199 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(reference
.node
), "Node"},
200 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(reference
.where
), "Where"},
201 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(reference
.index_pointer
),
203 {ACPI_EXD_REFERENCE
, 0, NULL
}
206 static struct acpi_exdump_info acpi_ex_dump_address_handler
[6] = {
207 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_address_handler
),
209 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(address_space
.space_id
), "Space Id"},
210 {ACPI_EXD_HDLR_LIST
, ACPI_EXD_OFFSET(address_space
.next
), "Next"},
211 {ACPI_EXD_RGN_LIST
, ACPI_EXD_OFFSET(address_space
.region_list
),
213 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(address_space
.node
), "Node"},
214 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(address_space
.context
), "Context"}
217 static struct acpi_exdump_info acpi_ex_dump_notify
[7] = {
218 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_notify
), NULL
},
219 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(notify
.node
), "Node"},
220 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(notify
.handler_type
), "Handler Type"},
221 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(notify
.handler
), "Handler"},
222 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(notify
.context
), "Context"},
223 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(notify
.next
[0]),
224 "Next System Notify"},
225 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(notify
.next
[1]), "Next Device Notify"}
228 static struct acpi_exdump_info acpi_ex_dump_extra
[6] = {
229 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_extra
), NULL
},
230 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(extra
.method_REG
), "_REG Method"},
231 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(extra
.scope_node
), "Scope Node"},
232 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(extra
.region_context
),
234 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(extra
.aml_start
), "Aml Start"},
235 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(extra
.aml_length
), "Aml Length"}
238 static struct acpi_exdump_info acpi_ex_dump_data
[3] = {
239 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_data
), NULL
},
240 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(data
.handler
), "Handler"},
241 {ACPI_EXD_POINTER
, ACPI_EXD_OFFSET(data
.pointer
), "Raw Data"}
244 /* Miscellaneous tables */
246 static struct acpi_exdump_info acpi_ex_dump_common
[5] = {
247 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_common
), NULL
},
248 {ACPI_EXD_TYPE
, 0, NULL
},
249 {ACPI_EXD_UINT16
, ACPI_EXD_OFFSET(common
.reference_count
),
251 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(common
.flags
), "Flags"},
252 {ACPI_EXD_LIST
, ACPI_EXD_OFFSET(common
.next_object
), "Object List"}
255 static struct acpi_exdump_info acpi_ex_dump_field_common
[7] = {
256 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_field_common
), NULL
},
257 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(common_field
.field_flags
),
259 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(common_field
.access_byte_width
),
260 "Access Byte Width"},
261 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(common_field
.bit_length
),
263 {ACPI_EXD_UINT8
, ACPI_EXD_OFFSET(common_field
.start_field_bit_offset
),
265 {ACPI_EXD_UINT32
, ACPI_EXD_OFFSET(common_field
.base_byte_offset
),
267 {ACPI_EXD_NODE
, ACPI_EXD_OFFSET(common_field
.node
), "Parent Node"}
270 static struct acpi_exdump_info acpi_ex_dump_node
[7] = {
271 {ACPI_EXD_INIT
, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_node
), NULL
},
272 {ACPI_EXD_UINT16
, ACPI_EXD_NSOFFSET(flags
), "Flags"},
273 {ACPI_EXD_UINT16
, ACPI_EXD_NSOFFSET(owner_id
), "Owner Id"},
274 {ACPI_EXD_LIST
, ACPI_EXD_NSOFFSET(object
), "Object List"},
275 {ACPI_EXD_NODE
, ACPI_EXD_NSOFFSET(parent
), "Parent"},
276 {ACPI_EXD_NODE
, ACPI_EXD_NSOFFSET(child
), "Child"},
277 {ACPI_EXD_NODE
, ACPI_EXD_NSOFFSET(peer
), "Peer"}
280 /* Dispatch table, indexed by object type */
282 static struct acpi_exdump_info
*acpi_ex_dump_info
[] = {
284 acpi_ex_dump_integer
,
287 acpi_ex_dump_package
,
295 acpi_ex_dump_processor
,
296 acpi_ex_dump_thermal
,
297 acpi_ex_dump_buffer_field
,
300 acpi_ex_dump_region_field
,
301 acpi_ex_dump_bank_field
,
302 acpi_ex_dump_index_field
,
303 acpi_ex_dump_reference
,
307 acpi_ex_dump_address_handler
,
315 /*******************************************************************************
317 * FUNCTION: acpi_ex_dump_object
319 * PARAMETERS: obj_desc - Descriptor to dump
320 * info - Info table corresponding to this object
325 * DESCRIPTION: Walk the info table for this object
327 ******************************************************************************/
330 acpi_ex_dump_object(union acpi_operand_object
*obj_desc
,
331 struct acpi_exdump_info
*info
)
336 union acpi_operand_object
*start
;
337 union acpi_operand_object
*data
= NULL
;
338 union acpi_operand_object
*next
;
339 struct acpi_namespace_node
*node
;
343 ("ExDumpObject: Display not implemented for object type %s\n",
344 acpi_ut_get_object_type_name(obj_desc
));
348 /* First table entry must contain the table length (# of table entries) */
350 count
= info
->offset
;
357 target
= ACPI_ADD_PTR(u8
, obj_desc
, info
->offset
);
360 switch (info
->opcode
) {
367 acpi_os_printf("%20s : %2.2X [%s]\n", "Type",
368 obj_desc
->common
.type
,
369 acpi_ut_get_object_type_name(obj_desc
));
374 acpi_os_printf("%20s : %2.2X\n", name
, *target
);
377 case ACPI_EXD_UINT16
:
379 acpi_os_printf("%20s : %4.4X\n", name
,
383 case ACPI_EXD_UINT32
:
385 acpi_os_printf("%20s : %8.8X\n", name
,
389 case ACPI_EXD_UINT64
:
391 acpi_os_printf("%20s : %8.8X%8.8X\n", "Value",
392 ACPI_FORMAT_UINT64(ACPI_GET64(target
)));
395 case ACPI_EXD_POINTER
:
396 case ACPI_EXD_ADDRESS
:
398 acpi_ex_out_pointer(name
,
399 *ACPI_CAST_PTR(void *, target
));
402 case ACPI_EXD_STRING
:
404 acpi_ut_print_string(obj_desc
->string
.pointer
,
406 acpi_os_printf("\n");
409 case ACPI_EXD_BUFFER
:
411 ACPI_DUMP_BUFFER(obj_desc
->buffer
.pointer
,
412 obj_desc
->buffer
.length
);
415 case ACPI_EXD_PACKAGE
:
417 /* Dump the package contents */
419 acpi_os_printf("\nPackage Contents:\n");
420 acpi_ex_dump_package_obj(obj_desc
, 0, 0);
425 acpi_ex_dump_object(obj_desc
,
426 acpi_ex_dump_field_common
);
429 case ACPI_EXD_REFERENCE
:
431 acpi_ex_out_string("Class Name",
432 acpi_ut_get_reference_name
434 acpi_ex_dump_reference_obj(obj_desc
);
439 start
= *ACPI_CAST_PTR(void *, target
);
442 acpi_os_printf("%20s : %p ", name
, next
);
444 acpi_os_printf("%s (Type %2.2X)",
445 acpi_ut_get_object_type_name
446 (next
), next
->common
.type
);
448 while (next
->common
.next_object
) {
449 if ((next
->common
.type
==
450 ACPI_TYPE_LOCAL_DATA
) && !data
) {
454 next
= next
->common
.next_object
;
455 acpi_os_printf("->%p(%s %2.2X)", next
,
456 acpi_ut_get_object_type_name
460 if ((next
== start
) || (next
== data
)) {
462 ("\n**** Error: Object list appears to be circular linked");
467 acpi_os_printf("- No attached objects");
470 acpi_os_printf("\n");
473 case ACPI_EXD_HDLR_LIST
:
475 start
= *ACPI_CAST_PTR(void *, target
);
478 acpi_os_printf("%20s : %p", name
, next
);
480 acpi_os_printf("(%s %2.2X)",
481 acpi_ut_get_object_type_name
483 next
->address_space
.space_id
);
485 while (next
->address_space
.next
) {
486 if ((next
->common
.type
==
487 ACPI_TYPE_LOCAL_DATA
) && !data
) {
491 next
= next
->address_space
.next
;
492 acpi_os_printf("->%p(%s %2.2X)", next
,
493 acpi_ut_get_object_type_name
498 if ((next
== start
) || (next
== data
)) {
500 ("\n**** Error: Handler list appears to be circular linked");
506 acpi_os_printf("\n");
509 case ACPI_EXD_RGN_LIST
:
511 start
= *ACPI_CAST_PTR(void *, target
);
514 acpi_os_printf("%20s : %p", name
, next
);
516 acpi_os_printf("(%s %2.2X)",
517 acpi_ut_get_object_type_name
518 (next
), next
->common
.type
);
520 while (next
->region
.next
) {
521 if ((next
->common
.type
==
522 ACPI_TYPE_LOCAL_DATA
) && !data
) {
526 next
= next
->region
.next
;
527 acpi_os_printf("->%p(%s %2.2X)", next
,
528 acpi_ut_get_object_type_name
532 if ((next
== start
) || (next
== data
)) {
534 ("\n**** Error: Region list appears to be circular linked");
540 acpi_os_printf("\n");
546 *ACPI_CAST_PTR(struct acpi_namespace_node
*,
549 acpi_os_printf("%20s : %p", name
, node
);
551 acpi_os_printf(" [%4.4s]", node
->name
.ascii
);
553 acpi_os_printf("\n");
558 acpi_os_printf("**** Invalid table opcode [%X] ****\n",
568 /*******************************************************************************
570 * FUNCTION: acpi_ex_dump_operand
572 * PARAMETERS: *obj_desc - Pointer to entry to be dumped
573 * depth - Current nesting depth
577 * DESCRIPTION: Dump an operand object
579 ******************************************************************************/
581 void acpi_ex_dump_operand(union acpi_operand_object
*obj_desc
, u32 depth
)
586 ACPI_FUNCTION_NAME(ex_dump_operand
);
588 /* Check if debug output enabled */
590 if (!ACPI_IS_DEBUG_ENABLED(ACPI_LV_EXEC
, _COMPONENT
)) {
596 /* This could be a null element of a package */
598 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "Null Object Descriptor\n"));
602 if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc
) == ACPI_DESC_TYPE_NAMED
) {
603 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "%p Namespace Node: ",
605 ACPI_DUMP_ENTRY(obj_desc
, ACPI_LV_EXEC
);
609 if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc
) != ACPI_DESC_TYPE_OPERAND
) {
610 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
,
611 "%p is not a node or operand object: [%s]\n",
613 acpi_ut_get_descriptor_name(obj_desc
)));
614 ACPI_DUMP_BUFFER(obj_desc
, sizeof(union acpi_operand_object
));
618 /* obj_desc is a valid object */
621 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "%*s[%u] %p Refs=%u ",
622 depth
, " ", depth
, obj_desc
,
623 obj_desc
->common
.reference_count
));
625 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "%p Refs=%u ",
626 obj_desc
, obj_desc
->common
.reference_count
));
629 /* Decode object type */
631 switch (obj_desc
->common
.type
) {
632 case ACPI_TYPE_LOCAL_REFERENCE
:
634 acpi_os_printf("Reference: [%s] ",
635 acpi_ut_get_reference_name(obj_desc
));
637 switch (obj_desc
->reference
.class) {
638 case ACPI_REFCLASS_DEBUG
:
640 acpi_os_printf("\n");
643 case ACPI_REFCLASS_INDEX
:
645 acpi_os_printf("%p\n", obj_desc
->reference
.object
);
648 case ACPI_REFCLASS_TABLE
:
650 acpi_os_printf("Table Index %X\n",
651 obj_desc
->reference
.value
);
654 case ACPI_REFCLASS_REFOF
:
656 acpi_os_printf("%p [%s]\n", obj_desc
->reference
.object
,
657 acpi_ut_get_type_name(((union
666 case ACPI_REFCLASS_NAME
:
668 acpi_ut_repair_name(obj_desc
->reference
.node
->name
.
670 acpi_os_printf("- [%4.4s] (Node %p)\n",
671 obj_desc
->reference
.node
->name
.ascii
,
672 obj_desc
->reference
.node
);
675 case ACPI_REFCLASS_ARG
:
676 case ACPI_REFCLASS_LOCAL
:
678 acpi_os_printf("%X\n", obj_desc
->reference
.value
);
681 default: /* Unknown reference class */
683 acpi_os_printf("%2.2X\n", obj_desc
->reference
.class);
688 case ACPI_TYPE_BUFFER
:
690 acpi_os_printf("Buffer length %.2X @ %p\n",
691 obj_desc
->buffer
.length
,
692 obj_desc
->buffer
.pointer
);
694 /* Debug only -- dump the buffer contents */
696 if (obj_desc
->buffer
.pointer
) {
697 length
= obj_desc
->buffer
.length
;
703 ("Buffer Contents: (displaying length 0x%.2X)\n",
705 ACPI_DUMP_BUFFER(obj_desc
->buffer
.pointer
, length
);
709 case ACPI_TYPE_INTEGER
:
711 acpi_os_printf("Integer %8.8X%8.8X\n",
712 ACPI_FORMAT_UINT64(obj_desc
->integer
.value
));
715 case ACPI_TYPE_PACKAGE
:
717 acpi_os_printf("Package [Len %X] ElementArray %p\n",
718 obj_desc
->package
.count
,
719 obj_desc
->package
.elements
);
722 * If elements exist, package element pointer is valid,
723 * and debug_level exceeds 1, dump package's elements.
725 if (obj_desc
->package
.count
&&
726 obj_desc
->package
.elements
&& acpi_dbg_level
> 1) {
727 for (index
= 0; index
< obj_desc
->package
.count
;
729 acpi_ex_dump_operand(obj_desc
->package
.
736 case ACPI_TYPE_REGION
:
738 acpi_os_printf("Region %s (%X)",
739 acpi_ut_get_region_name(obj_desc
->region
.
741 obj_desc
->region
.space_id
);
744 * If the address and length have not been evaluated,
747 if (!(obj_desc
->region
.flags
& AOPOBJ_DATA_VALID
)) {
748 acpi_os_printf("\n");
750 acpi_os_printf(" base %8.8X%8.8X Length %X\n",
751 ACPI_FORMAT_UINT64(obj_desc
->region
.
753 obj_desc
->region
.length
);
757 case ACPI_TYPE_STRING
:
759 acpi_os_printf("String length %X @ %p ",
760 obj_desc
->string
.length
,
761 obj_desc
->string
.pointer
);
763 acpi_ut_print_string(obj_desc
->string
.pointer
, ACPI_UINT8_MAX
);
764 acpi_os_printf("\n");
767 case ACPI_TYPE_LOCAL_BANK_FIELD
:
769 acpi_os_printf("BankField\n");
772 case ACPI_TYPE_LOCAL_REGION_FIELD
:
775 ("RegionField: Bits=%X AccWidth=%X Lock=%X Update=%X at "
776 "byte=%X bit=%X of below:\n", obj_desc
->field
.bit_length
,
777 obj_desc
->field
.access_byte_width
,
778 obj_desc
->field
.field_flags
& AML_FIELD_LOCK_RULE_MASK
,
779 obj_desc
->field
.field_flags
& AML_FIELD_UPDATE_RULE_MASK
,
780 obj_desc
->field
.base_byte_offset
,
781 obj_desc
->field
.start_field_bit_offset
);
783 acpi_ex_dump_operand(obj_desc
->field
.region_obj
, depth
+ 1);
786 case ACPI_TYPE_LOCAL_INDEX_FIELD
:
788 acpi_os_printf("IndexField\n");
791 case ACPI_TYPE_BUFFER_FIELD
:
793 acpi_os_printf("BufferField: %X bits at byte %X bit %X of\n",
794 obj_desc
->buffer_field
.bit_length
,
795 obj_desc
->buffer_field
.base_byte_offset
,
796 obj_desc
->buffer_field
.start_field_bit_offset
);
798 if (!obj_desc
->buffer_field
.buffer_obj
) {
799 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
, "*NULL*\n"));
800 } else if ((obj_desc
->buffer_field
.buffer_obj
)->common
.type
!=
802 acpi_os_printf("*not a Buffer*\n");
804 acpi_ex_dump_operand(obj_desc
->buffer_field
.buffer_obj
,
809 case ACPI_TYPE_EVENT
:
811 acpi_os_printf("Event\n");
814 case ACPI_TYPE_METHOD
:
816 acpi_os_printf("Method(%X) @ %p:%X\n",
817 obj_desc
->method
.param_count
,
818 obj_desc
->method
.aml_start
,
819 obj_desc
->method
.aml_length
);
822 case ACPI_TYPE_MUTEX
:
824 acpi_os_printf("Mutex\n");
827 case ACPI_TYPE_DEVICE
:
829 acpi_os_printf("Device\n");
832 case ACPI_TYPE_POWER
:
834 acpi_os_printf("Power\n");
837 case ACPI_TYPE_PROCESSOR
:
839 acpi_os_printf("Processor\n");
842 case ACPI_TYPE_THERMAL
:
844 acpi_os_printf("Thermal\n");
851 acpi_os_printf("Unknown Type %X\n", obj_desc
->common
.type
);
858 /*******************************************************************************
860 * FUNCTION: acpi_ex_dump_operands
862 * PARAMETERS: operands - A list of Operand objects
863 * opcode_name - AML opcode name
864 * num_operands - Operand count for this opcode
866 * DESCRIPTION: Dump the operands associated with the opcode
868 ******************************************************************************/
871 acpi_ex_dump_operands(union acpi_operand_object
**operands
,
872 const char *opcode_name
, u32 num_operands
)
874 ACPI_FUNCTION_TRACE(ex_dump_operands
);
877 opcode_name
= "UNKNOWN";
880 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
,
881 "**** Start operand dump for opcode [%s], %u operands\n",
882 opcode_name
, num_operands
));
884 if (num_operands
== 0) {
888 /* Dump the individual operands */
890 while (num_operands
) {
891 acpi_ex_dump_operand(*operands
, 0);
896 ACPI_DEBUG_PRINT((ACPI_DB_EXEC
,
897 "**** End operand dump for [%s]\n", opcode_name
));
901 /*******************************************************************************
903 * FUNCTION: acpi_ex_out* functions
905 * PARAMETERS: title - Descriptive text
906 * value - Value to be displayed
908 * DESCRIPTION: Object dump output formatting functions. These functions
909 * reduce the number of format strings required and keeps them
910 * all in one place for easy modification.
912 ******************************************************************************/
914 static void acpi_ex_out_string(const char *title
, const char *value
)
916 acpi_os_printf("%20s : %s\n", title
, value
);
919 static void acpi_ex_out_pointer(const char *title
, const void *value
)
921 acpi_os_printf("%20s : %p\n", title
, value
);
924 /*******************************************************************************
926 * FUNCTION: acpi_ex_dump_namespace_node
928 * PARAMETERS: node - Descriptor to dump
929 * flags - Force display if TRUE
931 * DESCRIPTION: Dumps the members of the given.Node
933 ******************************************************************************/
935 void acpi_ex_dump_namespace_node(struct acpi_namespace_node
*node
, u32 flags
)
938 ACPI_FUNCTION_ENTRY();
942 /* Check if debug output enabled */
944 if (!ACPI_IS_DEBUG_ENABLED(ACPI_LV_OBJECTS
, _COMPONENT
)) {
949 acpi_os_printf("%20s : %4.4s\n", "Name", acpi_ut_get_node_name(node
));
950 acpi_os_printf("%20s : %2.2X [%s]\n", "Type",
951 node
->type
, acpi_ut_get_type_name(node
->type
));
953 acpi_ex_dump_object(ACPI_CAST_PTR(union acpi_operand_object
, node
),
957 /*******************************************************************************
959 * FUNCTION: acpi_ex_dump_reference_obj
961 * PARAMETERS: object - Descriptor to dump
963 * DESCRIPTION: Dumps a reference object
965 ******************************************************************************/
967 static void acpi_ex_dump_reference_obj(union acpi_operand_object
*obj_desc
)
969 struct acpi_buffer ret_buf
;
972 ret_buf
.length
= ACPI_ALLOCATE_LOCAL_BUFFER
;
974 if (obj_desc
->reference
.class == ACPI_REFCLASS_NAME
) {
975 acpi_os_printf(" %p ", obj_desc
->reference
.node
);
977 status
= acpi_ns_handle_to_pathname(obj_desc
->reference
.node
,
979 if (ACPI_FAILURE(status
)) {
981 (" Could not convert name to pathname: %s\n",
982 acpi_format_exception(status
));
984 acpi_os_printf("%s: %s\n",
985 acpi_ut_get_type_name(obj_desc
->
988 (char *)ret_buf
.pointer
);
989 ACPI_FREE(ret_buf
.pointer
);
991 } else if (obj_desc
->reference
.object
) {
992 if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc
) ==
993 ACPI_DESC_TYPE_OPERAND
) {
994 acpi_os_printf("%22s %p", "Target :",
995 obj_desc
->reference
.object
);
996 if (obj_desc
->reference
.class == ACPI_REFCLASS_TABLE
) {
997 acpi_os_printf(" Table Index: %X\n",
998 obj_desc
->reference
.value
);
1000 acpi_os_printf(" [%s]\n",
1001 acpi_ut_get_type_name(((union
1011 acpi_os_printf(" Target: %p\n",
1012 obj_desc
->reference
.object
);
1017 /*******************************************************************************
1019 * FUNCTION: acpi_ex_dump_package_obj
1021 * PARAMETERS: obj_desc - Descriptor to dump
1022 * level - Indentation Level
1023 * index - Package index for this object
1025 * DESCRIPTION: Dumps the elements of the package
1027 ******************************************************************************/
1030 acpi_ex_dump_package_obj(union acpi_operand_object
*obj_desc
,
1031 u32 level
, u32 index
)
1035 /* Indentation and index output */
1038 for (i
= 0; i
< level
; i
++) {
1039 acpi_os_printf(" ");
1042 acpi_os_printf("[%.2d] ", index
);
1045 acpi_os_printf("%p ", obj_desc
);
1047 /* Null package elements are allowed */
1050 acpi_os_printf("[Null Object]\n");
1054 /* Packages may only contain a few object types */
1056 switch (obj_desc
->common
.type
) {
1057 case ACPI_TYPE_INTEGER
:
1059 acpi_os_printf("[Integer] = %8.8X%8.8X\n",
1060 ACPI_FORMAT_UINT64(obj_desc
->integer
.value
));
1063 case ACPI_TYPE_STRING
:
1065 acpi_os_printf("[String] Value: ");
1066 acpi_ut_print_string(obj_desc
->string
.pointer
, ACPI_UINT8_MAX
);
1067 acpi_os_printf("\n");
1070 case ACPI_TYPE_BUFFER
:
1072 acpi_os_printf("[Buffer] Length %.2X = ",
1073 obj_desc
->buffer
.length
);
1074 if (obj_desc
->buffer
.length
) {
1075 acpi_ut_debug_dump_buffer(ACPI_CAST_PTR
1077 obj_desc
->buffer
.pointer
),
1078 obj_desc
->buffer
.length
,
1079 DB_DWORD_DISPLAY
, _COMPONENT
);
1081 acpi_os_printf("\n");
1085 case ACPI_TYPE_PACKAGE
:
1087 acpi_os_printf("[Package] Contains %u Elements:\n",
1088 obj_desc
->package
.count
);
1090 for (i
= 0; i
< obj_desc
->package
.count
; i
++) {
1091 acpi_ex_dump_package_obj(obj_desc
->package
.elements
[i
],
1096 case ACPI_TYPE_LOCAL_REFERENCE
:
1098 acpi_os_printf("[Object Reference] Class [%s]",
1099 acpi_ut_get_reference_name(obj_desc
));
1100 acpi_ex_dump_reference_obj(obj_desc
);
1105 acpi_os_printf("[%s] Type: %2.2X\n",
1106 acpi_ut_get_type_name(obj_desc
->common
.type
),
1107 obj_desc
->common
.type
);
1112 /*******************************************************************************
1114 * FUNCTION: acpi_ex_dump_object_descriptor
1116 * PARAMETERS: obj_desc - Descriptor to dump
1117 * flags - Force display if TRUE
1119 * DESCRIPTION: Dumps the members of the object descriptor given.
1121 ******************************************************************************/
1124 acpi_ex_dump_object_descriptor(union acpi_operand_object
*obj_desc
, u32 flags
)
1126 ACPI_FUNCTION_TRACE(ex_dump_object_descriptor
);
1134 /* Check if debug output enabled */
1136 if (!ACPI_IS_DEBUG_ENABLED(ACPI_LV_OBJECTS
, _COMPONENT
)) {
1141 if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc
) == ACPI_DESC_TYPE_NAMED
) {
1142 acpi_ex_dump_namespace_node((struct acpi_namespace_node
*)
1145 obj_desc
= ((struct acpi_namespace_node
*)obj_desc
)->object
;
1150 acpi_os_printf("\nAttached Object %p", obj_desc
);
1151 if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc
) == ACPI_DESC_TYPE_NAMED
) {
1152 acpi_os_printf(" - Namespace Node");
1155 acpi_os_printf(":\n");
1159 if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc
) != ACPI_DESC_TYPE_OPERAND
) {
1160 acpi_os_printf("%p is not an ACPI operand object: [%s]\n",
1161 obj_desc
, acpi_ut_get_descriptor_name(obj_desc
));
1165 /* Validate the object type */
1167 if (obj_desc
->common
.type
> ACPI_TYPE_LOCAL_MAX
) {
1168 acpi_os_printf("Not a known object type: %2.2X\n",
1169 obj_desc
->common
.type
);
1181 acpi_ex_dump_object(obj_desc
, acpi_ex_dump_common
);
1183 /* Object-specific fields */
1185 acpi_ex_dump_object(obj_desc
, acpi_ex_dump_info
[obj_desc
->common
.type
]);
1187 if (obj_desc
->common
.type
== ACPI_TYPE_REGION
) {
1188 obj_desc
= obj_desc
->common
.next_object
;
1189 if (obj_desc
->common
.type
> ACPI_TYPE_LOCAL_MAX
) {
1191 ("Secondary object is not a known object type: %2.2X\n",
1192 obj_desc
->common
.type
);
1197 acpi_os_printf("\nExtra attached Object (%p):\n", obj_desc
);
1198 acpi_ex_dump_object(obj_desc
,
1199 acpi_ex_dump_info
[obj_desc
->common
.type
]);