1 /*******************************************************************************
3 * Module Name: dbdisply - debug display commands
5 ******************************************************************************/
7 /******************************************************************************
11 * Some or all of this work - Copyright (c) 1999 - 2017, 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 *****************************************************************************
116 * Alternatively, you may choose to be licensed under the terms of the
119 * Redistribution and use in source and binary forms, with or without
120 * modification, are permitted provided that the following conditions
122 * 1. Redistributions of source code must retain the above copyright
123 * notice, this list of conditions, and the following disclaimer,
124 * without modification.
125 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126 * substantially similar to the "NO WARRANTY" disclaimer below
127 * ("Disclaimer") and any redistribution must be conditioned upon
128 * including a substantially similar Disclaimer requirement for further
129 * binary redistribution.
130 * 3. Neither the names of the above-listed copyright holders nor the names
131 * of any contributors may be used to endorse or promote products derived
132 * from this software without specific prior written permission.
134 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
146 * Alternatively, you may choose to be licensed under the terms of the
147 * GNU General Public License ("GPL") version 2 as published by the Free
148 * Software Foundation.
150 *****************************************************************************/
152 #include <contrib/dev/acpica/include/acpi.h>
153 #include <contrib/dev/acpica/include/accommon.h>
154 #include <contrib/dev/acpica/include/amlcode.h>
155 #include <contrib/dev/acpica/include/acdispat.h>
156 #include <contrib/dev/acpica/include/acnamesp.h>
157 #include <contrib/dev/acpica/include/acparser.h>
158 #include <contrib/dev/acpica/include/acinterp.h>
159 #include <contrib/dev/acpica/include/acevents.h>
160 #include <contrib/dev/acpica/include/acdebug.h>
163 #define _COMPONENT ACPI_CA_DEBUGGER
164 ACPI_MODULE_NAME ("dbdisply")
166 /* Local prototypes */
169 AcpiDbDumpParserDescriptor (
170 ACPI_PARSE_OBJECT *Op);
177 AcpiDbDisplayNonRootHandlers (
178 ACPI_HANDLE ObjHandle,
184 * System handler information.
185 * Used for Handlers command, in AcpiDbDisplayHandlers.
187 #define ACPI_PREDEFINED_PREFIX "%25s (%.2X) : "
188 #define ACPI_HANDLER_NAME_STRING "%30s : "
189 #define ACPI_HANDLER_PRESENT_STRING "%-9s (%p)\n"
190 #define ACPI_HANDLER_PRESENT_STRING2 "%-9s (%p)"
191 #define ACPI_HANDLER_NOT_PRESENT_STRING "%-9s\n"
193 /* All predefined Address Space IDs */
195 static ACPI_ADR_SPACE_TYPE AcpiGbl_SpaceIdList[] =
197 ACPI_ADR_SPACE_SYSTEM_MEMORY,
198 ACPI_ADR_SPACE_SYSTEM_IO,
199 ACPI_ADR_SPACE_PCI_CONFIG,
201 ACPI_ADR_SPACE_SMBUS,
203 ACPI_ADR_SPACE_PCI_BAR_TARGET,
206 ACPI_ADR_SPACE_GSBUS,
207 ACPI_ADR_SPACE_DATA_TABLE,
208 ACPI_ADR_SPACE_FIXED_HARDWARE
211 /* Global handler information */
213 typedef struct acpi_handler_info
220 static ACPI_HANDLER_INFO AcpiGbl_HandlerList[] =
222 {&AcpiGbl_GlobalNotify[0].Handler, "System Notifications"},
223 {&AcpiGbl_GlobalNotify[1].Handler, "Device Notifications"},
224 {&AcpiGbl_TableHandler, "ACPI Table Events"},
225 {&AcpiGbl_ExceptionHandler, "Control Method Exceptions"},
226 {&AcpiGbl_InterfaceHandler, "OSI Invocations"}
230 /*******************************************************************************
232 * FUNCTION: AcpiDbGetPointer
234 * PARAMETERS: Target - Pointer to string to be converted
236 * RETURN: Converted pointer
238 * DESCRIPTION: Convert an ascii pointer value to a real value
240 ******************************************************************************/
250 Address = strtoul (Target, NULL, 16);
251 ObjPtr = ACPI_TO_POINTER (Address);
256 /*******************************************************************************
258 * FUNCTION: AcpiDbDumpParserDescriptor
260 * PARAMETERS: Op - A parser Op descriptor
264 * DESCRIPTION: Display a formatted parser object
266 ******************************************************************************/
269 AcpiDbDumpParserDescriptor (
270 ACPI_PARSE_OBJECT *Op)
272 const ACPI_OPCODE_INFO *Info;
275 Info = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
277 AcpiOsPrintf ("Parser Op Descriptor:\n");
278 AcpiOsPrintf ("%20.20s : %4.4X\n", "Opcode", Op->Common.AmlOpcode);
280 ACPI_DEBUG_ONLY_MEMBERS (AcpiOsPrintf ("%20.20s : %s\n", "Opcode Name",
283 AcpiOsPrintf ("%20.20s : %p\n", "Value/ArgList", Op->Common.Value.Arg);
284 AcpiOsPrintf ("%20.20s : %p\n", "Parent", Op->Common.Parent);
285 AcpiOsPrintf ("%20.20s : %p\n", "NextOp", Op->Common.Next);
289 /*******************************************************************************
291 * FUNCTION: AcpiDbDecodeAndDisplayObject
293 * PARAMETERS: Target - String with object to be displayed. Names
294 * and hex pointers are supported.
295 * OutputType - Byte, Word, Dword, or Qword (B|W|D|Q)
299 * DESCRIPTION: Display a formatted ACPI object
301 ******************************************************************************/
304 AcpiDbDecodeAndDisplayObject (
309 ACPI_NAMESPACE_NODE *Node;
310 ACPI_OPERAND_OBJECT *ObjDesc;
311 UINT32 Display = DB_BYTE_DISPLAY;
323 /* Decode the output type */
327 AcpiUtStrupr (OutputType);
328 if (OutputType[0] == 'W')
330 Display = DB_WORD_DISPLAY;
332 else if (OutputType[0] == 'D')
334 Display = DB_DWORD_DISPLAY;
336 else if (OutputType[0] == 'Q')
338 Display = DB_QWORD_DISPLAY;
342 RetBuf.Length = sizeof (Buffer);
343 RetBuf.Pointer = Buffer;
345 /* Differentiate between a number and a name */
347 if ((Target[0] >= 0x30) && (Target[0] <= 0x39))
349 ObjPtr = AcpiDbGetPointer (Target);
350 if (!AcpiOsReadable (ObjPtr, 16))
353 "Address %p is invalid in this address space\n",
358 /* Decode the object type */
360 switch (ACPI_GET_DESCRIPTOR_TYPE (ObjPtr))
362 case ACPI_DESC_TYPE_NAMED:
364 /* This is a namespace Node */
366 if (!AcpiOsReadable (ObjPtr, sizeof (ACPI_NAMESPACE_NODE)))
369 "Cannot read entire Named object at address %p\n",
377 case ACPI_DESC_TYPE_OPERAND:
379 /* This is a ACPI OPERAND OBJECT */
381 if (!AcpiOsReadable (ObjPtr, sizeof (ACPI_OPERAND_OBJECT)))
384 "Cannot read entire ACPI object at address %p\n",
389 AcpiUtDebugDumpBuffer (ObjPtr, sizeof (ACPI_OPERAND_OBJECT),
390 Display, ACPI_UINT32_MAX);
391 AcpiExDumpObjectDescriptor (ObjPtr, 1);
394 case ACPI_DESC_TYPE_PARSER:
396 /* This is a Parser Op object */
398 if (!AcpiOsReadable (ObjPtr, sizeof (ACPI_PARSE_OBJECT)))
401 "Cannot read entire Parser object at address %p\n",
406 AcpiUtDebugDumpBuffer (ObjPtr, sizeof (ACPI_PARSE_OBJECT),
407 Display, ACPI_UINT32_MAX);
408 AcpiDbDumpParserDescriptor ((ACPI_PARSE_OBJECT *) ObjPtr);
413 /* Is not a recognizeable object */
416 "Not a known ACPI internal object, descriptor type %2.2X\n",
417 ACPI_GET_DESCRIPTOR_TYPE (ObjPtr));
420 if (AcpiOsReadable (ObjPtr, 64))
425 /* Just dump some memory */
427 AcpiUtDebugDumpBuffer (ObjPtr, Size, Display, ACPI_UINT32_MAX);
434 /* The parameter is a name string that must be resolved to a Named obj */
436 Node = AcpiDbLocalNsLookup (Target);
444 /* Now dump the NS node */
446 Status = AcpiGetName (Node, ACPI_FULL_PATHNAME_NO_TRAILING, &RetBuf);
447 if (ACPI_FAILURE (Status))
449 AcpiOsPrintf ("Could not convert name to pathname\n");
454 AcpiOsPrintf ("Object (%p) Pathname: %s\n",
455 Node, (char *) RetBuf.Pointer);
458 if (!AcpiOsReadable (Node, sizeof (ACPI_NAMESPACE_NODE)))
460 AcpiOsPrintf ("Invalid Named object at address %p\n", Node);
464 AcpiUtDebugDumpBuffer ((void *) Node, sizeof (ACPI_NAMESPACE_NODE),
465 Display, ACPI_UINT32_MAX);
466 AcpiExDumpNamespaceNode (Node, 1);
468 ObjDesc = AcpiNsGetAttachedObject (Node);
471 AcpiOsPrintf ("\nAttached Object (%p):\n", ObjDesc);
472 if (!AcpiOsReadable (ObjDesc, sizeof (ACPI_OPERAND_OBJECT)))
474 AcpiOsPrintf ("Invalid internal ACPI Object at address %p\n",
479 AcpiUtDebugDumpBuffer ((void *) ObjDesc,
480 sizeof (ACPI_OPERAND_OBJECT), Display, ACPI_UINT32_MAX);
481 AcpiExDumpObjectDescriptor (ObjDesc, 1);
486 /*******************************************************************************
488 * FUNCTION: AcpiDbDisplayMethodInfo
490 * PARAMETERS: StartOp - Root of the control method parse tree
494 * DESCRIPTION: Display information about the current method
496 ******************************************************************************/
499 AcpiDbDisplayMethodInfo (
500 ACPI_PARSE_OBJECT *StartOp)
502 ACPI_WALK_STATE *WalkState;
503 ACPI_OPERAND_OBJECT *ObjDesc;
504 ACPI_NAMESPACE_NODE *Node;
505 ACPI_PARSE_OBJECT *RootOp;
506 ACPI_PARSE_OBJECT *Op;
507 const ACPI_OPCODE_INFO *OpInfo;
509 UINT32 NumOperands = 0;
510 UINT32 NumOperators = 0;
511 UINT32 NumRemainingOps = 0;
512 UINT32 NumRemainingOperands = 0;
513 UINT32 NumRemainingOperators = 0;
514 BOOLEAN CountRemaining = FALSE;
517 WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
520 AcpiOsPrintf ("There is no method currently executing\n");
524 ObjDesc = WalkState->MethodDesc;
525 Node = WalkState->MethodNode;
527 AcpiOsPrintf ("Currently executing control method is [%4.4s]\n",
528 AcpiUtGetNodeName (Node));
529 AcpiOsPrintf ("%X Arguments, SyncLevel = %X\n",
530 (UINT32) ObjDesc->Method.ParamCount,
531 (UINT32) ObjDesc->Method.SyncLevel);
534 while (RootOp->Common.Parent)
536 RootOp = RootOp->Common.Parent;
545 CountRemaining = TRUE;
554 /* Decode the opcode */
556 OpInfo = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
557 switch (OpInfo->Class)
559 case AML_CLASS_ARGUMENT:
563 NumRemainingOperands++;
569 case AML_CLASS_UNKNOWN:
571 /* Bad opcode or ASCII character */
579 NumRemainingOperators++;
586 Op = AcpiPsGetDepthNext (StartOp, Op);
590 "Method contains: %X AML Opcodes - %X Operators, %X Operands\n",
591 NumOps, NumOperators, NumOperands);
594 "Remaining to execute: %X AML Opcodes - %X Operators, %X Operands\n",
595 NumRemainingOps, NumRemainingOperators, NumRemainingOperands);
599 /*******************************************************************************
601 * FUNCTION: AcpiDbDisplayLocals
607 * DESCRIPTION: Display all locals for the currently running control method
609 ******************************************************************************/
612 AcpiDbDisplayLocals (
615 ACPI_WALK_STATE *WalkState;
618 WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
621 AcpiOsPrintf ("There is no method currently executing\n");
625 AcpiDbDecodeLocals (WalkState);
629 /*******************************************************************************
631 * FUNCTION: AcpiDbDisplayArguments
637 * DESCRIPTION: Display all arguments for the currently running control method
639 ******************************************************************************/
642 AcpiDbDisplayArguments (
645 ACPI_WALK_STATE *WalkState;
648 WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
651 AcpiOsPrintf ("There is no method currently executing\n");
655 AcpiDbDecodeArguments (WalkState);
659 /*******************************************************************************
661 * FUNCTION: AcpiDbDisplayResults
667 * DESCRIPTION: Display current contents of a method result stack
669 ******************************************************************************/
672 AcpiDbDisplayResults (
676 ACPI_WALK_STATE *WalkState;
677 ACPI_OPERAND_OBJECT *ObjDesc;
678 UINT32 ResultCount = 0;
679 ACPI_NAMESPACE_NODE *Node;
680 ACPI_GENERIC_STATE *Frame;
681 UINT32 Index; /* Index onto current frame */
684 WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
687 AcpiOsPrintf ("There is no method currently executing\n");
691 ObjDesc = WalkState->MethodDesc;
692 Node = WalkState->MethodNode;
694 if (WalkState->Results)
696 ResultCount = WalkState->ResultCount;
699 AcpiOsPrintf ("Method [%4.4s] has %X stacked result objects\n",
700 AcpiUtGetNodeName (Node), ResultCount);
702 /* From the top element of result stack */
704 Frame = WalkState->Results;
705 Index = (ResultCount - 1) % ACPI_RESULTS_FRAME_OBJ_NUM;
707 for (i = 0; i < ResultCount; i++)
709 ObjDesc = Frame->Results.ObjDesc[Index];
710 AcpiOsPrintf ("Result%u: ", i);
711 AcpiDbDisplayInternalObject (ObjDesc, WalkState);
715 Frame = Frame->Results.Next;
716 Index = ACPI_RESULTS_FRAME_OBJ_NUM;
724 /*******************************************************************************
726 * FUNCTION: AcpiDbDisplayCallingTree
732 * DESCRIPTION: Display current calling tree of nested control methods
734 ******************************************************************************/
737 AcpiDbDisplayCallingTree (
740 ACPI_WALK_STATE *WalkState;
741 ACPI_NAMESPACE_NODE *Node;
744 WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
747 AcpiOsPrintf ("There is no method currently executing\n");
751 Node = WalkState->MethodNode;
752 AcpiOsPrintf ("Current Control Method Call Tree\n");
756 Node = WalkState->MethodNode;
757 AcpiOsPrintf (" [%4.4s]\n", AcpiUtGetNodeName (Node));
759 WalkState = WalkState->Next;
764 /*******************************************************************************
766 * FUNCTION: AcpiDbDisplayObjectType
768 * PARAMETERS: ObjectArg - User entered NS node handle
772 * DESCRIPTION: Display type of an arbitrary NS node
774 ******************************************************************************/
777 AcpiDbDisplayObjectType (
782 ACPI_DEVICE_INFO *Info;
787 Arg = strtoul (ObjectArg, NULL, 16);
788 Handle = ACPI_TO_POINTER (Arg);
790 Status = AcpiGetObjectInfo (Handle, &Info);
791 if (ACPI_FAILURE (Status))
793 AcpiOsPrintf ("Could not get object info, %s\n",
794 AcpiFormatException (Status));
798 AcpiOsPrintf ("ADR: %8.8X%8.8X, STA: %8.8X, Flags: %X\n",
799 ACPI_FORMAT_UINT64 (Info->Address),
800 Info->CurrentStatus, Info->Flags);
802 AcpiOsPrintf ("S1D-%2.2X S2D-%2.2X S3D-%2.2X S4D-%2.2X\n",
803 Info->HighestDstates[0], Info->HighestDstates[1],
804 Info->HighestDstates[2], Info->HighestDstates[3]);
806 AcpiOsPrintf ("S0W-%2.2X S1W-%2.2X S2W-%2.2X S3W-%2.2X S4W-%2.2X\n",
807 Info->LowestDstates[0], Info->LowestDstates[1],
808 Info->LowestDstates[2], Info->LowestDstates[3],
809 Info->LowestDstates[4]);
811 if (Info->Valid & ACPI_VALID_HID)
813 AcpiOsPrintf ("HID: %s\n", Info->HardwareId.String);
816 if (Info->Valid & ACPI_VALID_UID)
818 AcpiOsPrintf ("UID: %s\n", Info->UniqueId.String);
821 if (Info->Valid & ACPI_VALID_CID)
823 for (i = 0; i < Info->CompatibleIdList.Count; i++)
825 AcpiOsPrintf ("CID %u: %s\n", i,
826 Info->CompatibleIdList.Ids[i].String);
834 /*******************************************************************************
836 * FUNCTION: AcpiDbDisplayResultObject
838 * PARAMETERS: ObjDesc - Object to be displayed
839 * WalkState - Current walk state
843 * DESCRIPTION: Display the result of an AML opcode
845 * Note: Curently only displays the result object if we are single stepping.
846 * However, this output may be useful in other contexts and could be enabled
847 * to do so if needed.
849 ******************************************************************************/
852 AcpiDbDisplayResultObject (
853 ACPI_OPERAND_OBJECT *ObjDesc,
854 ACPI_WALK_STATE *WalkState)
857 #ifndef ACPI_APPLICATION
858 if (AcpiGbl_DbThreadId != AcpiOsGetThreadId())
864 /* Only display if single stepping */
866 if (!AcpiGbl_CmSingleStep)
871 AcpiOsPrintf ("ResultObj: ");
872 AcpiDbDisplayInternalObject (ObjDesc, WalkState);
877 /*******************************************************************************
879 * FUNCTION: AcpiDbDisplayArgumentObject
881 * PARAMETERS: ObjDesc - Object to be displayed
882 * WalkState - Current walk state
886 * DESCRIPTION: Display the result of an AML opcode
888 ******************************************************************************/
891 AcpiDbDisplayArgumentObject (
892 ACPI_OPERAND_OBJECT *ObjDesc,
893 ACPI_WALK_STATE *WalkState)
896 #ifndef ACPI_APPLICATION
897 if (AcpiGbl_DbThreadId != AcpiOsGetThreadId())
903 if (!AcpiGbl_CmSingleStep)
908 AcpiOsPrintf ("ArgObj: ");
909 AcpiDbDisplayInternalObject (ObjDesc, WalkState);
913 #if (!ACPI_REDUCED_HARDWARE)
914 /*******************************************************************************
916 * FUNCTION: AcpiDbDisplayGpes
922 * DESCRIPTION: Display the current GPE structures
924 ******************************************************************************/
930 ACPI_GPE_BLOCK_INFO *GpeBlock;
931 ACPI_GPE_XRUPT_INFO *GpeXruptInfo;
932 ACPI_GPE_EVENT_INFO *GpeEventInfo;
933 ACPI_GPE_REGISTER_INFO *GpeRegisterInfo;
935 ACPI_GPE_NOTIFY_INFO *Notify;
946 RetBuf.Length = sizeof (Buffer);
947 RetBuf.Pointer = Buffer;
951 /* Walk the GPE lists */
953 GpeXruptInfo = AcpiGbl_GpeXruptListHead;
956 GpeBlock = GpeXruptInfo->GpeBlockListHead;
959 Status = AcpiGetName (GpeBlock->Node,
960 ACPI_FULL_PATHNAME_NO_TRAILING, &RetBuf);
961 if (ACPI_FAILURE (Status))
963 AcpiOsPrintf ("Could not convert name to pathname\n");
966 if (GpeBlock->Node == AcpiGbl_FadtGpeDevice)
968 GpeType = "FADT-defined GPE block";
972 GpeType = "GPE Block Device";
976 "\nBlock %u - Info %p DeviceNode %p [%s] - %s\n",
977 Block, GpeBlock, GpeBlock->Node, Buffer, GpeType);
980 " Registers: %u (%u GPEs)\n",
981 GpeBlock->RegisterCount, GpeBlock->GpeCount);
984 " GPE range: 0x%X to 0x%X on interrupt %u\n",
985 GpeBlock->BlockBaseNumber,
986 GpeBlock->BlockBaseNumber + (GpeBlock->GpeCount - 1),
987 GpeXruptInfo->InterruptNumber);
990 " RegisterInfo: %p Status %8.8X%8.8X Enable %8.8X%8.8X\n",
991 GpeBlock->RegisterInfo,
993 GpeBlock->RegisterInfo->StatusAddress.Address),
995 GpeBlock->RegisterInfo->EnableAddress.Address));
997 AcpiOsPrintf (" EventInfo: %p\n", GpeBlock->EventInfo);
999 /* Examine each GPE Register within the block */
1001 for (i = 0; i < GpeBlock->RegisterCount; i++)
1003 GpeRegisterInfo = &GpeBlock->RegisterInfo[i];
1006 " Reg %u: (GPE %.2X-%.2X) "
1007 "RunEnable %2.2X WakeEnable %2.2X"
1008 " Status %8.8X%8.8X Enable %8.8X%8.8X\n",
1009 i, GpeRegisterInfo->BaseGpeNumber,
1010 GpeRegisterInfo->BaseGpeNumber +
1011 (ACPI_GPE_REGISTER_WIDTH - 1),
1012 GpeRegisterInfo->EnableForRun,
1013 GpeRegisterInfo->EnableForWake,
1014 ACPI_FORMAT_UINT64 (
1015 GpeRegisterInfo->StatusAddress.Address),
1016 ACPI_FORMAT_UINT64 (
1017 GpeRegisterInfo->EnableAddress.Address));
1019 /* Now look at the individual GPEs in this byte register */
1021 for (j = 0; j < ACPI_GPE_REGISTER_WIDTH; j++)
1023 GpeIndex = (i * ACPI_GPE_REGISTER_WIDTH) + j;
1024 GpeEventInfo = &GpeBlock->EventInfo[GpeIndex];
1026 if (ACPI_GPE_DISPATCH_TYPE (GpeEventInfo->Flags) ==
1027 ACPI_GPE_DISPATCH_NONE)
1029 /* This GPE is not used (no method or handler), ignore it */
1035 " GPE %.2X: %p RunRefs %2.2X Flags %2.2X (",
1036 GpeBlock->BlockBaseNumber + GpeIndex, GpeEventInfo,
1037 GpeEventInfo->RuntimeCount, GpeEventInfo->Flags);
1039 /* Decode the flags byte */
1041 if (GpeEventInfo->Flags & ACPI_GPE_LEVEL_TRIGGERED)
1043 AcpiOsPrintf ("Level, ");
1047 AcpiOsPrintf ("Edge, ");
1050 if (GpeEventInfo->Flags & ACPI_GPE_CAN_WAKE)
1052 AcpiOsPrintf ("CanWake, ");
1056 AcpiOsPrintf ("RunOnly, ");
1059 switch (ACPI_GPE_DISPATCH_TYPE (GpeEventInfo->Flags))
1061 case ACPI_GPE_DISPATCH_NONE:
1063 AcpiOsPrintf ("NotUsed");
1066 case ACPI_GPE_DISPATCH_METHOD:
1068 AcpiOsPrintf ("Method");
1071 case ACPI_GPE_DISPATCH_HANDLER:
1073 AcpiOsPrintf ("Handler");
1076 case ACPI_GPE_DISPATCH_NOTIFY:
1079 Notify = GpeEventInfo->Dispatch.NotifyList;
1083 Notify = Notify->Next;
1086 AcpiOsPrintf ("Implicit Notify on %u devices",
1090 case ACPI_GPE_DISPATCH_RAW_HANDLER:
1092 AcpiOsPrintf ("RawHandler");
1097 AcpiOsPrintf ("UNKNOWN: %X",
1098 ACPI_GPE_DISPATCH_TYPE (GpeEventInfo->Flags));
1102 AcpiOsPrintf (")\n");
1107 GpeBlock = GpeBlock->Next;
1110 GpeXruptInfo = GpeXruptInfo->Next;
1113 #endif /* !ACPI_REDUCED_HARDWARE */
1116 /*******************************************************************************
1118 * FUNCTION: AcpiDbDisplayHandlers
1124 * DESCRIPTION: Display the currently installed global handlers
1126 ******************************************************************************/
1129 AcpiDbDisplayHandlers (
1132 ACPI_OPERAND_OBJECT *ObjDesc;
1133 ACPI_OPERAND_OBJECT *HandlerObj;
1134 ACPI_ADR_SPACE_TYPE SpaceId;
1138 /* Operation region handlers */
1140 AcpiOsPrintf ("\nOperation Region Handlers at the namespace root:\n");
1142 ObjDesc = AcpiNsGetAttachedObject (AcpiGbl_RootNode);
1145 for (i = 0; i < ACPI_ARRAY_LENGTH (AcpiGbl_SpaceIdList); i++)
1147 SpaceId = AcpiGbl_SpaceIdList[i];
1149 AcpiOsPrintf (ACPI_PREDEFINED_PREFIX,
1150 AcpiUtGetRegionName ((UINT8) SpaceId), SpaceId);
1152 HandlerObj = AcpiEvFindRegionHandler (
1153 SpaceId, ObjDesc->CommonNotify.Handler);
1156 AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING,
1157 (HandlerObj->AddressSpace.HandlerFlags &
1158 ACPI_ADDR_HANDLER_DEFAULT_INSTALLED) ?
1160 HandlerObj->AddressSpace.Handler);
1165 /* There is no handler for this SpaceId */
1167 AcpiOsPrintf ("None\n");
1172 /* Find all handlers for user-defined SpaceIDs */
1174 HandlerObj = ObjDesc->CommonNotify.Handler;
1177 if (HandlerObj->AddressSpace.SpaceId >= ACPI_USER_REGION_BEGIN)
1179 AcpiOsPrintf (ACPI_PREDEFINED_PREFIX,
1180 "User-defined ID", HandlerObj->AddressSpace.SpaceId);
1181 AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING,
1182 (HandlerObj->AddressSpace.HandlerFlags &
1183 ACPI_ADDR_HANDLER_DEFAULT_INSTALLED) ?
1185 HandlerObj->AddressSpace.Handler);
1188 HandlerObj = HandlerObj->AddressSpace.Next;
1192 #if (!ACPI_REDUCED_HARDWARE)
1194 /* Fixed event handlers */
1196 AcpiOsPrintf ("\nFixed Event Handlers:\n");
1198 for (i = 0; i < ACPI_NUM_FIXED_EVENTS; i++)
1200 AcpiOsPrintf (ACPI_PREDEFINED_PREFIX, AcpiUtGetEventName (i), i);
1201 if (AcpiGbl_FixedEventHandlers[i].Handler)
1203 AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING, "User",
1204 AcpiGbl_FixedEventHandlers[i].Handler);
1208 AcpiOsPrintf (ACPI_HANDLER_NOT_PRESENT_STRING, "None");
1212 #endif /* !ACPI_REDUCED_HARDWARE */
1214 /* Miscellaneous global handlers */
1216 AcpiOsPrintf ("\nMiscellaneous Global Handlers:\n");
1218 for (i = 0; i < ACPI_ARRAY_LENGTH (AcpiGbl_HandlerList); i++)
1220 AcpiOsPrintf (ACPI_HANDLER_NAME_STRING,
1221 AcpiGbl_HandlerList[i].Name);
1223 if (AcpiGbl_HandlerList[i].Handler)
1225 AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING, "User",
1226 AcpiGbl_HandlerList[i].Handler);
1230 AcpiOsPrintf (ACPI_HANDLER_NOT_PRESENT_STRING, "None");
1235 /* Other handlers that are installed throughout the namespace */
1237 AcpiOsPrintf ("\nOperation Region Handlers for specific devices:\n");
1239 (void) AcpiWalkNamespace (ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT,
1240 ACPI_UINT32_MAX, AcpiDbDisplayNonRootHandlers,
1245 /*******************************************************************************
1247 * FUNCTION: AcpiDbDisplayNonRootHandlers
1249 * PARAMETERS: ACPI_WALK_CALLBACK
1253 * DESCRIPTION: Display information about all handlers installed for a
1256 ******************************************************************************/
1259 AcpiDbDisplayNonRootHandlers (
1260 ACPI_HANDLE ObjHandle,
1261 UINT32 NestingLevel,
1265 ACPI_NAMESPACE_NODE *Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, ObjHandle);
1266 ACPI_OPERAND_OBJECT *ObjDesc;
1267 ACPI_OPERAND_OBJECT *HandlerObj;
1271 ObjDesc = AcpiNsGetAttachedObject (Node);
1277 Pathname = AcpiNsGetNormalizedPathname (Node, TRUE);
1283 /* Display all handlers associated with this device */
1285 HandlerObj = ObjDesc->CommonNotify.Handler;
1288 AcpiOsPrintf (ACPI_PREDEFINED_PREFIX,
1289 AcpiUtGetRegionName ((UINT8) HandlerObj->AddressSpace.SpaceId),
1290 HandlerObj->AddressSpace.SpaceId);
1292 AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING2,
1293 (HandlerObj->AddressSpace.HandlerFlags &
1294 ACPI_ADDR_HANDLER_DEFAULT_INSTALLED) ? "Default" : "User",
1295 HandlerObj->AddressSpace.Handler);
1297 AcpiOsPrintf (" Device Name: %s (%p)\n", Pathname, Node);
1299 HandlerObj = HandlerObj->AddressSpace.Next;
1302 ACPI_FREE (Pathname);