1 /******************************************************************************
3 * Module Name: exdump - Interpreter debug output routines
5 *****************************************************************************/
7 /******************************************************************************
11 * Some or all of this work - Copyright (c) 1999 - 2009, Intel Corp.
12 * All rights reserved.
16 * 2.1. This is your license from Intel Corp. under its intellectual property
17 * rights. You may have additional license terms from the party that provided
18 * you this software, covering your right to use that party's intellectual
21 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22 * copy of the source code appearing in this file ("Covered Code") an
23 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24 * base code distributed originally by Intel ("Original Intel Code") to copy,
25 * make derivatives, distribute, use and display any portion of the Covered
26 * Code in any form, with the right to sublicense such rights; and
28 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29 * license (with the right to sublicense), under only those claims of Intel
30 * patents that are infringed by the Original Intel Code, to make, use, sell,
31 * offer to sell, and import the Covered Code and derivative works thereof
32 * solely to the minimum extent necessary to exercise the above copyright
33 * license, and in no event shall the patent license extend to any additions
34 * to or modifications of the Original Intel Code. No other license or right
35 * is granted directly or by implication, estoppel or otherwise;
37 * The above copyright and patent license is granted only if the following
42 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43 * Redistribution of source code of any substantial portion of the Covered
44 * Code or modification with rights to further distribute source must include
45 * the above Copyright Notice, the above License, this list of Conditions,
46 * and the following Disclaimer and Export Compliance provision. In addition,
47 * Licensee must cause all Covered Code to which Licensee contributes to
48 * contain a file documenting the changes Licensee made to create that Covered
49 * Code and the date of any change. Licensee must include in that file the
50 * documentation of any changes made by any predecessor Licensee. Licensee
51 * must include a prominent statement that the modification is derived,
52 * directly or indirectly, from Original Intel Code.
54 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55 * Redistribution of source code of any substantial portion of the Covered
56 * Code or modification without rights to further distribute source must
57 * include the following Disclaimer and Export Compliance provision in the
58 * documentation and/or other materials provided with distribution. In
59 * addition, Licensee may not authorize further sublicense of source of any
60 * portion of the Covered Code, and must include terms to the effect that the
61 * license from Licensee to its licensee is limited to the intellectual
62 * property embodied in the software Licensee provides to its licensee, and
63 * not to intellectual property embodied in modifications its licensee may
66 * 3.3. Redistribution of Executable. Redistribution in executable form of any
67 * substantial portion of the Covered Code or modification must reproduce the
68 * above Copyright Notice, and the following Disclaimer and Export Compliance
69 * provision in the documentation and/or other materials provided with the
72 * 3.4. Intel retains all right, title, and interest in and to the Original
75 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76 * Intel shall be used in advertising or otherwise to promote the sale, use or
77 * other dealings in products derived from or relating to the Covered Code
78 * without prior written authorization from Intel.
80 * 4. Disclaimer and Export Compliance
82 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
90 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
99 * 4.3. Licensee shall not export, either directly or indirectly, any of this
100 * software or system incorporating such software without first obtaining any
101 * required license or other approval from the U. S. Department of Commerce or
102 * any other agency or department of the United States Government. In the
103 * event Licensee exports any such software from the United States or
104 * re-exports any such software from a foreign destination, Licensee shall
105 * ensure that the distribution and export/re-export of the software is in
106 * compliance with all laws, regulations, orders, or other restrictions of the
107 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108 * any of its subsidiaries will export/re-export any technical data, process,
109 * software, or service, directly or indirectly, to any country for which the
110 * United States government or any agency thereof requires an export license,
111 * other governmental approval, or letter of assurance, without first obtaining
112 * such license, approval or letter.
114 *****************************************************************************/
119 #include "accommon.h"
120 #include "acinterp.h"
122 #include "acnamesp.h"
125 #define _COMPONENT ACPI_EXECUTER
126 ACPI_MODULE_NAME ("exdump")
129 * The following routines are used for debug output only
131 #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
133 /* Local prototypes */
147 ACPI_OPERAND_OBJECT *ObjDesc,
148 ACPI_EXDUMP_INFO *Info);
151 AcpiExDumpReferenceObj (
152 ACPI_OPERAND_OBJECT *ObjDesc);
155 AcpiExDumpPackageObj (
156 ACPI_OPERAND_OBJECT *ObjDesc,
161 /*******************************************************************************
163 * Object Descriptor info tables
165 * Note: The first table entry must be an INIT opcode and must contain
166 * the table length (number of table entries)
168 ******************************************************************************/
170 static ACPI_EXDUMP_INFO AcpiExDumpInteger[2] =
172 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpInteger), NULL},
173 {ACPI_EXD_UINT64, ACPI_EXD_OFFSET (Integer.Value), "Value"}
176 static ACPI_EXDUMP_INFO AcpiExDumpString[4] =
178 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpString), NULL},
179 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (String.Length), "Length"},
180 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (String.Pointer), "Pointer"},
181 {ACPI_EXD_STRING, 0, NULL}
184 static ACPI_EXDUMP_INFO AcpiExDumpBuffer[5] =
186 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBuffer), NULL},
187 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Buffer.Length), "Length"},
188 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Buffer.Pointer), "Pointer"},
189 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Buffer.Node), "Parent Node"},
190 {ACPI_EXD_BUFFER, 0, NULL}
193 static ACPI_EXDUMP_INFO AcpiExDumpPackage[5] =
195 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpPackage), NULL},
196 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Package.Flags), "Flags"},
197 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Package.Count), "Elements"},
198 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Package.Elements), "Element List"},
199 {ACPI_EXD_PACKAGE, 0, NULL}
202 static ACPI_EXDUMP_INFO AcpiExDumpDevice[4] =
204 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpDevice), NULL},
205 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Device.Handler), "Handler"},
206 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Device.SystemNotify), "System Notify"},
207 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Device.DeviceNotify), "Device Notify"}
210 static ACPI_EXDUMP_INFO AcpiExDumpEvent[2] =
212 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpEvent), NULL},
213 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Event.OsSemaphore), "OsSemaphore"}
216 static ACPI_EXDUMP_INFO AcpiExDumpMethod[9] =
218 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpMethod), NULL},
219 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.MethodFlags), "Method Flags"},
220 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.ParamCount), "Parameter Count"},
221 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.SyncLevel), "Sync Level"},
222 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Method.Mutex), "Mutex"},
223 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.OwnerId), "Owner Id"},
224 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.ThreadCount), "Thread Count"},
225 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Method.AmlLength), "Aml Length"},
226 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Method.AmlStart), "Aml Start"}
229 static ACPI_EXDUMP_INFO AcpiExDumpMutex[5] =
231 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpMutex), NULL},
232 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Mutex.SyncLevel), "Sync Level"},
233 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Mutex.OwnerThread), "Owner Thread"},
234 {ACPI_EXD_UINT16, ACPI_EXD_OFFSET (Mutex.AcquisitionDepth), "Acquire Depth"},
235 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Mutex.OsMutex), "OsMutex"}
238 static ACPI_EXDUMP_INFO AcpiExDumpRegion[7] =
240 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpRegion), NULL},
241 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Region.SpaceId), "Space Id"},
242 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Region.Flags), "Flags"},
243 {ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET (Region.Address), "Address"},
244 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Region.Length), "Length"},
245 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Region.Handler), "Handler"},
246 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Region.Next), "Next"}
249 static ACPI_EXDUMP_INFO AcpiExDumpPower[5] =
251 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpPower), NULL},
252 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (PowerResource.SystemLevel), "System Level"},
253 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (PowerResource.ResourceOrder), "Resource Order"},
254 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (PowerResource.SystemNotify), "System Notify"},
255 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (PowerResource.DeviceNotify), "Device Notify"}
258 static ACPI_EXDUMP_INFO AcpiExDumpProcessor[7] =
260 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpProcessor), NULL},
261 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Processor.ProcId), "Processor ID"},
262 {ACPI_EXD_UINT8 , ACPI_EXD_OFFSET (Processor.Length), "Length"},
263 {ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET (Processor.Address), "Address"},
264 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Processor.SystemNotify), "System Notify"},
265 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Processor.DeviceNotify), "Device Notify"},
266 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Processor.Handler), "Handler"}
269 static ACPI_EXDUMP_INFO AcpiExDumpThermal[4] =
271 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpThermal), NULL},
272 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (ThermalZone.SystemNotify), "System Notify"},
273 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (ThermalZone.DeviceNotify), "Device Notify"},
274 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (ThermalZone.Handler), "Handler"}
277 static ACPI_EXDUMP_INFO AcpiExDumpBufferField[3] =
279 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBufferField), NULL},
280 {ACPI_EXD_FIELD, 0, NULL},
281 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (BufferField.BufferObj), "Buffer Object"}
284 static ACPI_EXDUMP_INFO AcpiExDumpRegionField[3] =
286 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpRegionField), NULL},
287 {ACPI_EXD_FIELD, 0, NULL},
288 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Field.RegionObj), "Region Object"}
291 static ACPI_EXDUMP_INFO AcpiExDumpBankField[5] =
293 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBankField), NULL},
294 {ACPI_EXD_FIELD, 0, NULL},
295 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (BankField.Value), "Value"},
296 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (BankField.RegionObj), "Region Object"},
297 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (BankField.BankObj), "Bank Object"}
300 static ACPI_EXDUMP_INFO AcpiExDumpIndexField[5] =
302 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBankField), NULL},
303 {ACPI_EXD_FIELD, 0, NULL},
304 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (IndexField.Value), "Value"},
305 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (IndexField.IndexObj), "Index Object"},
306 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (IndexField.DataObj), "Data Object"}
309 static ACPI_EXDUMP_INFO AcpiExDumpReference[8] =
311 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpReference), NULL},
312 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Reference.Class), "Class"},
313 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Reference.TargetType), "Target Type"},
314 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Reference.Value), "Value"},
315 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Reference.Object), "Object Desc"},
316 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Reference.Node), "Node"},
317 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Reference.Where), "Where"},
318 {ACPI_EXD_REFERENCE,0, NULL}
321 static ACPI_EXDUMP_INFO AcpiExDumpAddressHandler[6] =
323 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpAddressHandler), NULL},
324 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (AddressSpace.SpaceId), "Space Id"},
325 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.Next), "Next"},
326 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.RegionList), "Region List"},
327 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.Node), "Node"},
328 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.Context), "Context"}
331 static ACPI_EXDUMP_INFO AcpiExDumpNotify[3] =
333 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpNotify), NULL},
334 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Node), "Node"},
335 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Context), "Context"}
339 /* Miscellaneous tables */
341 static ACPI_EXDUMP_INFO AcpiExDumpCommon[4] =
343 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpCommon), NULL},
344 {ACPI_EXD_TYPE , 0, NULL},
345 {ACPI_EXD_UINT16, ACPI_EXD_OFFSET (Common.ReferenceCount), "Reference Count"},
346 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Common.Flags), "Flags"}
349 static ACPI_EXDUMP_INFO AcpiExDumpFieldCommon[7] =
351 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpFieldCommon), NULL},
352 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (CommonField.FieldFlags), "Field Flags"},
353 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (CommonField.AccessByteWidth), "Access Byte Width"},
354 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (CommonField.BitLength), "Bit Length"},
355 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (CommonField.StartFieldBitOffset),"Field Bit Offset"},
356 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (CommonField.BaseByteOffset), "Base Byte Offset"},
357 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (CommonField.Node), "Parent Node"}
360 static ACPI_EXDUMP_INFO AcpiExDumpNode[5] =
362 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpNode), NULL},
363 {ACPI_EXD_UINT8, ACPI_EXD_NSOFFSET (Flags), "Flags"},
364 {ACPI_EXD_UINT8, ACPI_EXD_NSOFFSET (OwnerId), "Owner Id"},
365 {ACPI_EXD_POINTER, ACPI_EXD_NSOFFSET (Child), "Child List"},
366 {ACPI_EXD_POINTER, ACPI_EXD_NSOFFSET (Peer), "Next Peer"}
370 /* Dispatch table, indexed by object type */
372 static ACPI_EXDUMP_INFO *AcpiExDumpInfo[] =
388 AcpiExDumpBufferField,
391 AcpiExDumpRegionField,
393 AcpiExDumpIndexField,
398 AcpiExDumpAddressHandler,
405 /*******************************************************************************
407 * FUNCTION: AcpiExDumpObject
409 * PARAMETERS: ObjDesc - Descriptor to dump
410 * Info - Info table corresponding to this object
415 * DESCRIPTION: Walk the info table for this object
417 ******************************************************************************/
421 ACPI_OPERAND_OBJECT *ObjDesc,
422 ACPI_EXDUMP_INFO *Info)
433 "ExDumpObject: Display not implemented for object type %s\n",
434 AcpiUtGetObjectTypeName (ObjDesc));
438 /* First table entry must contain the table length (# of table entries) */
440 Count = Info->Offset;
444 Target = ACPI_ADD_PTR (UINT8, ObjDesc, Info->Offset);
447 switch (Info->Opcode)
454 AcpiExOutString ("Type", AcpiUtGetObjectTypeName (ObjDesc));
459 AcpiOsPrintf ("%20s : %2.2X\n", Name, *Target);
462 case ACPI_EXD_UINT16:
464 AcpiOsPrintf ("%20s : %4.4X\n", Name, ACPI_GET16 (Target));
467 case ACPI_EXD_UINT32:
469 AcpiOsPrintf ("%20s : %8.8X\n", Name, ACPI_GET32 (Target));
472 case ACPI_EXD_UINT64:
474 AcpiOsPrintf ("%20s : %8.8X%8.8X\n", "Value",
475 ACPI_FORMAT_UINT64 (ACPI_GET64 (Target)));
478 case ACPI_EXD_POINTER:
479 case ACPI_EXD_ADDRESS:
481 AcpiExOutPointer (Name, *ACPI_CAST_PTR (void *, Target));
484 case ACPI_EXD_STRING:
486 AcpiUtPrintString (ObjDesc->String.Pointer, ACPI_UINT8_MAX);
490 case ACPI_EXD_BUFFER:
492 ACPI_DUMP_BUFFER (ObjDesc->Buffer.Pointer, ObjDesc->Buffer.Length);
495 case ACPI_EXD_PACKAGE:
497 /* Dump the package contents */
499 AcpiOsPrintf ("\nPackage Contents:\n");
500 AcpiExDumpPackageObj (ObjDesc, 0, 0);
505 AcpiExDumpObject (ObjDesc, AcpiExDumpFieldCommon);
508 case ACPI_EXD_REFERENCE:
510 str = AcpiUtGetReferenceName (ObjDesc);
511 AcpiExOutString ("Class Name", __DECONST(char *, str));
512 AcpiExDumpReferenceObj (ObjDesc);
517 AcpiOsPrintf ("**** Invalid table opcode [%X] ****\n",
528 /*******************************************************************************
530 * FUNCTION: AcpiExDumpOperand
532 * PARAMETERS: *ObjDesc - Pointer to entry to be dumped
533 * Depth - Current nesting depth
537 * DESCRIPTION: Dump an operand object
539 ******************************************************************************/
543 ACPI_OPERAND_OBJECT *ObjDesc,
550 ACPI_FUNCTION_NAME (ExDumpOperand)
553 if (!((ACPI_LV_EXEC & AcpiDbgLevel) && (_COMPONENT & AcpiDbgLayer)))
560 /* This could be a null element of a package */
562 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Null Object Descriptor\n"));
566 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) == ACPI_DESC_TYPE_NAMED)
568 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%p Namespace Node: ", ObjDesc));
569 ACPI_DUMP_ENTRY (ObjDesc, ACPI_LV_EXEC);
573 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND)
575 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
576 "%p is not a node or operand object: [%s]\n",
577 ObjDesc, AcpiUtGetDescriptorName (ObjDesc)));
578 ACPI_DUMP_BUFFER (ObjDesc, sizeof (ACPI_OPERAND_OBJECT));
582 /* ObjDesc is a valid object */
586 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%*s[%u] %p ",
587 Depth, " ", Depth, ObjDesc));
591 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%p ", ObjDesc));
594 /* Decode object type */
596 switch (ObjDesc->Common.Type)
598 case ACPI_TYPE_LOCAL_REFERENCE:
600 AcpiOsPrintf ("Reference: [%s] ", AcpiUtGetReferenceName (ObjDesc));
602 switch (ObjDesc->Reference.Class)
604 case ACPI_REFCLASS_DEBUG:
610 case ACPI_REFCLASS_INDEX:
612 AcpiOsPrintf ("%p\n", ObjDesc->Reference.Object);
616 case ACPI_REFCLASS_TABLE:
618 AcpiOsPrintf ("Table Index %X\n", ObjDesc->Reference.Value);
622 case ACPI_REFCLASS_REFOF:
624 AcpiOsPrintf ("%p [%s]\n", ObjDesc->Reference.Object,
625 AcpiUtGetTypeName (((ACPI_OPERAND_OBJECT *)
626 ObjDesc->Reference.Object)->Common.Type));
630 case ACPI_REFCLASS_NAME:
632 AcpiOsPrintf ("- [%4.4s]\n", ObjDesc->Reference.Node->Name.Ascii);
636 case ACPI_REFCLASS_ARG:
637 case ACPI_REFCLASS_LOCAL:
639 AcpiOsPrintf ("%X\n", ObjDesc->Reference.Value);
643 default: /* Unknown reference class */
645 AcpiOsPrintf ("%2.2X\n", ObjDesc->Reference.Class);
651 case ACPI_TYPE_BUFFER:
653 AcpiOsPrintf ("Buffer length %.2X @ %p\n",
654 ObjDesc->Buffer.Length, ObjDesc->Buffer.Pointer);
656 /* Debug only -- dump the buffer contents */
658 if (ObjDesc->Buffer.Pointer)
660 Length = ObjDesc->Buffer.Length;
666 AcpiOsPrintf ("Buffer Contents: (displaying length 0x%.2X)\n",
668 ACPI_DUMP_BUFFER (ObjDesc->Buffer.Pointer, Length);
673 case ACPI_TYPE_INTEGER:
675 AcpiOsPrintf ("Integer %8.8X%8.8X\n",
676 ACPI_FORMAT_UINT64 (ObjDesc->Integer.Value));
680 case ACPI_TYPE_PACKAGE:
682 AcpiOsPrintf ("Package [Len %X] ElementArray %p\n",
683 ObjDesc->Package.Count, ObjDesc->Package.Elements);
686 * If elements exist, package element pointer is valid,
687 * and debug_level exceeds 1, dump package's elements.
689 if (ObjDesc->Package.Count &&
690 ObjDesc->Package.Elements &&
693 for (Index = 0; Index < ObjDesc->Package.Count; Index++)
695 AcpiExDumpOperand (ObjDesc->Package.Elements[Index], Depth+1);
701 case ACPI_TYPE_REGION:
703 AcpiOsPrintf ("Region %s (%X)",
704 AcpiUtGetRegionName (ObjDesc->Region.SpaceId),
705 ObjDesc->Region.SpaceId);
708 * If the address and length have not been evaluated,
711 if (!(ObjDesc->Region.Flags & AOPOBJ_DATA_VALID))
717 AcpiOsPrintf (" base %8.8X%8.8X Length %X\n",
718 ACPI_FORMAT_NATIVE_UINT (ObjDesc->Region.Address),
719 ObjDesc->Region.Length);
724 case ACPI_TYPE_STRING:
726 AcpiOsPrintf ("String length %X @ %p ",
727 ObjDesc->String.Length,
728 ObjDesc->String.Pointer);
730 AcpiUtPrintString (ObjDesc->String.Pointer, ACPI_UINT8_MAX);
735 case ACPI_TYPE_LOCAL_BANK_FIELD:
737 AcpiOsPrintf ("BankField\n");
741 case ACPI_TYPE_LOCAL_REGION_FIELD:
743 AcpiOsPrintf ("RegionField: Bits=%X AccWidth=%X Lock=%X Update=%X at "
744 "byte=%X bit=%X of below:\n",
745 ObjDesc->Field.BitLength,
746 ObjDesc->Field.AccessByteWidth,
747 ObjDesc->Field.FieldFlags & AML_FIELD_LOCK_RULE_MASK,
748 ObjDesc->Field.FieldFlags & AML_FIELD_UPDATE_RULE_MASK,
749 ObjDesc->Field.BaseByteOffset,
750 ObjDesc->Field.StartFieldBitOffset);
752 AcpiExDumpOperand (ObjDesc->Field.RegionObj, Depth+1);
756 case ACPI_TYPE_LOCAL_INDEX_FIELD:
758 AcpiOsPrintf ("IndexField\n");
762 case ACPI_TYPE_BUFFER_FIELD:
764 AcpiOsPrintf ("BufferField: %X bits at byte %X bit %X of\n",
765 ObjDesc->BufferField.BitLength,
766 ObjDesc->BufferField.BaseByteOffset,
767 ObjDesc->BufferField.StartFieldBitOffset);
769 if (!ObjDesc->BufferField.BufferObj)
771 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "*NULL*\n"));
773 else if ((ObjDesc->BufferField.BufferObj)->Common.Type !=
776 AcpiOsPrintf ("*not a Buffer*\n");
780 AcpiExDumpOperand (ObjDesc->BufferField.BufferObj, Depth+1);
785 case ACPI_TYPE_EVENT:
787 AcpiOsPrintf ("Event\n");
791 case ACPI_TYPE_METHOD:
793 AcpiOsPrintf ("Method(%X) @ %p:%X\n",
794 ObjDesc->Method.ParamCount,
795 ObjDesc->Method.AmlStart,
796 ObjDesc->Method.AmlLength);
800 case ACPI_TYPE_MUTEX:
802 AcpiOsPrintf ("Mutex\n");
806 case ACPI_TYPE_DEVICE:
808 AcpiOsPrintf ("Device\n");
812 case ACPI_TYPE_POWER:
814 AcpiOsPrintf ("Power\n");
818 case ACPI_TYPE_PROCESSOR:
820 AcpiOsPrintf ("Processor\n");
824 case ACPI_TYPE_THERMAL:
826 AcpiOsPrintf ("Thermal\n");
833 AcpiOsPrintf ("Unknown Type %X\n", ObjDesc->Common.Type);
841 /*******************************************************************************
843 * FUNCTION: AcpiExDumpOperands
845 * PARAMETERS: Operands - A list of Operand objects
846 * OpcodeName - AML opcode name
847 * NumOperands - Operand count for this opcode
849 * DESCRIPTION: Dump the operands associated with the opcode
851 ******************************************************************************/
855 ACPI_OPERAND_OBJECT **Operands,
856 const char *OpcodeName,
859 ACPI_FUNCTION_NAME (ExDumpOperands);
864 OpcodeName = "UNKNOWN";
867 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
868 "**** Start operand dump for opcode [%s], %d operands\n",
869 OpcodeName, NumOperands));
871 if (NumOperands == 0)
876 /* Dump the individual operands */
880 AcpiExDumpOperand (*Operands, 0);
885 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
886 "**** End operand dump for [%s]\n", OpcodeName));
891 /*******************************************************************************
893 * FUNCTION: AcpiExOut* functions
895 * PARAMETERS: Title - Descriptive text
896 * Value - Value to be displayed
898 * DESCRIPTION: Object dump output formatting functions. These functions
899 * reduce the number of format strings required and keeps them
900 * all in one place for easy modification.
902 ******************************************************************************/
909 AcpiOsPrintf ("%20s : %s\n", Title, Value);
917 AcpiOsPrintf ("%20s : %p\n", Title, Value);
921 /*******************************************************************************
923 * FUNCTION: AcpiExDumpNamespaceNode
925 * PARAMETERS: Node - Descriptor to dump
926 * Flags - Force display if TRUE
928 * DESCRIPTION: Dumps the members of the given.Node
930 ******************************************************************************/
933 AcpiExDumpNamespaceNode (
934 ACPI_NAMESPACE_NODE *Node,
938 ACPI_FUNCTION_ENTRY ();
943 if (!((ACPI_LV_OBJECTS & AcpiDbgLevel) && (_COMPONENT & AcpiDbgLayer)))
949 AcpiOsPrintf ("%20s : %4.4s\n", "Name", AcpiUtGetNodeName (Node));
950 AcpiExOutString ("Type", AcpiUtGetTypeName (Node->Type));
951 AcpiExOutPointer ("Attached Object", AcpiNsGetAttachedObject (Node));
952 AcpiExOutPointer ("Parent", AcpiNsGetParentNode (Node));
954 AcpiExDumpObject (ACPI_CAST_PTR (ACPI_OPERAND_OBJECT, Node),
959 /*******************************************************************************
961 * FUNCTION: AcpiExDumpReferenceObj
963 * PARAMETERS: Object - Descriptor to dump
965 * DESCRIPTION: Dumps a reference object
967 ******************************************************************************/
970 AcpiExDumpReferenceObj (
971 ACPI_OPERAND_OBJECT *ObjDesc)
977 RetBuf.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
979 if (ObjDesc->Reference.Class == ACPI_REFCLASS_NAME)
981 AcpiOsPrintf (" %p ", ObjDesc->Reference.Node);
983 Status = AcpiNsHandleToPathname (ObjDesc->Reference.Node, &RetBuf);
984 if (ACPI_FAILURE (Status))
986 AcpiOsPrintf (" Could not convert name to pathname\n");
990 AcpiOsPrintf ("%s\n", (char *) RetBuf.Pointer);
991 ACPI_FREE (RetBuf.Pointer);
994 else if (ObjDesc->Reference.Object)
996 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) == ACPI_DESC_TYPE_OPERAND)
998 AcpiOsPrintf (" Target: %p", ObjDesc->Reference.Object);
999 if (ObjDesc->Reference.Class == ACPI_REFCLASS_TABLE)
1001 AcpiOsPrintf (" Table Index: %X\n", ObjDesc->Reference.Value);
1005 AcpiOsPrintf (" Target: %p [%s]\n", ObjDesc->Reference.Object,
1006 AcpiUtGetTypeName (((ACPI_OPERAND_OBJECT *)
1007 ObjDesc->Reference.Object)->Common.Type));
1012 AcpiOsPrintf (" Target: %p\n", ObjDesc->Reference.Object);
1018 /*******************************************************************************
1020 * FUNCTION: AcpiExDumpPackageObj
1022 * PARAMETERS: ObjDesc - Descriptor to dump
1023 * Level - Indentation Level
1024 * Index - Package index for this object
1026 * DESCRIPTION: Dumps the elements of the package
1028 ******************************************************************************/
1031 AcpiExDumpPackageObj (
1032 ACPI_OPERAND_OBJECT *ObjDesc,
1039 /* Indentation and index output */
1043 for (i = 0; i < Level; i++)
1048 AcpiOsPrintf ("[%.2d] ", Index);
1051 AcpiOsPrintf ("%p ", ObjDesc);
1053 /* Null package elements are allowed */
1057 AcpiOsPrintf ("[Null Object]\n");
1061 /* Packages may only contain a few object types */
1063 switch (ObjDesc->Common.Type)
1065 case ACPI_TYPE_INTEGER:
1067 AcpiOsPrintf ("[Integer] = %8.8X%8.8X\n",
1068 ACPI_FORMAT_UINT64 (ObjDesc->Integer.Value));
1072 case ACPI_TYPE_STRING:
1074 AcpiOsPrintf ("[String] Value: ");
1075 for (i = 0; i < ObjDesc->String.Length; i++)
1077 AcpiOsPrintf ("%c", ObjDesc->String.Pointer[i]);
1079 AcpiOsPrintf ("\n");
1083 case ACPI_TYPE_BUFFER:
1085 AcpiOsPrintf ("[Buffer] Length %.2X = ", ObjDesc->Buffer.Length);
1086 if (ObjDesc->Buffer.Length)
1088 AcpiUtDumpBuffer (ACPI_CAST_PTR (UINT8, ObjDesc->Buffer.Pointer),
1089 ObjDesc->Buffer.Length, DB_DWORD_DISPLAY, _COMPONENT);
1093 AcpiOsPrintf ("\n");
1098 case ACPI_TYPE_PACKAGE:
1100 AcpiOsPrintf ("[Package] Contains %d Elements:\n",
1101 ObjDesc->Package.Count);
1103 for (i = 0; i < ObjDesc->Package.Count; i++)
1105 AcpiExDumpPackageObj (ObjDesc->Package.Elements[i], Level+1, i);
1110 case ACPI_TYPE_LOCAL_REFERENCE:
1112 AcpiOsPrintf ("[Object Reference] Type [%s] %2.2X",
1113 AcpiUtGetReferenceName (ObjDesc),
1114 ObjDesc->Reference.Class);
1115 AcpiExDumpReferenceObj (ObjDesc);
1121 AcpiOsPrintf ("[Unknown Type] %X\n", ObjDesc->Common.Type);
1127 /*******************************************************************************
1129 * FUNCTION: AcpiExDumpObjectDescriptor
1131 * PARAMETERS: ObjDesc - Descriptor to dump
1132 * Flags - Force display if TRUE
1134 * DESCRIPTION: Dumps the members of the object descriptor given.
1136 ******************************************************************************/
1139 AcpiExDumpObjectDescriptor (
1140 ACPI_OPERAND_OBJECT *ObjDesc,
1143 ACPI_FUNCTION_TRACE (ExDumpObjectDescriptor);
1153 if (!((ACPI_LV_OBJECTS & AcpiDbgLevel) && (_COMPONENT & AcpiDbgLayer)))
1159 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) == ACPI_DESC_TYPE_NAMED)
1161 AcpiExDumpNamespaceNode ((ACPI_NAMESPACE_NODE *) ObjDesc, Flags);
1163 AcpiOsPrintf ("\nAttached Object (%p):\n",
1164 ((ACPI_NAMESPACE_NODE *) ObjDesc)->Object);
1166 AcpiExDumpObjectDescriptor (
1167 ((ACPI_NAMESPACE_NODE *) ObjDesc)->Object, Flags);
1171 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND)
1174 "ExDumpObjectDescriptor: %p is not an ACPI operand object: [%s]\n",
1175 ObjDesc, AcpiUtGetDescriptorName (ObjDesc));
1179 if (ObjDesc->Common.Type > ACPI_TYPE_NS_NODE_MAX)
1186 AcpiExDumpObject (ObjDesc, AcpiExDumpCommon);
1188 /* Object-specific fields */
1190 AcpiExDumpObject (ObjDesc, AcpiExDumpInfo[ObjDesc->Common.Type]);