sys/contrib/dev/acpica/source/components/debugger/dbdisply.c

   1 /*******************************************************************************
   2  *
   3  * Module Name: dbdisply - debug display commands
   4  *
   5  ******************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2014, Intel Corp.
   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
  44 #include "acpi.h"
  45 #include "accommon.h"
  46 #include "amlcode.h"
  47 #include "acdispat.h"
  48 #include "acnamesp.h"
  49 #include "acparser.h"
  50 #include "acinterp.h"
  51 #include "acdebug.h"
  52 #include "acdisasm.h"
  53
  54
  55 #ifdef ACPI_DEBUGGER
  56
  57 #define _COMPONENT          ACPI_CA_DEBUGGER
  58         ACPI_MODULE_NAME    ("dbdisply")
  59
  60 /* Local prototypes */
  61
  62 static void
  63 AcpiDbDumpParserDescriptor (
  64     ACPI_PARSE_OBJECT       *Op);
  65
  66 static void *
  67 AcpiDbGetPointer (
  68     void                    *Target);
  69
  70 static ACPI_STATUS
  71 AcpiDbDisplayNonRootHandlers (
  72     ACPI_HANDLE             ObjHandle,
  73     UINT32                  NestingLevel,
  74     void                    *Context,
  75     void                    **ReturnValue);
  76
  77 /*
  78  * System handler information.
  79  * Used for Handlers command, in AcpiDbDisplayHandlers.
  80  */
  81 #define ACPI_PREDEFINED_PREFIX          "%25s (%.2X) : "
  82 #define ACPI_HANDLER_NAME_STRING               "%30s : "
  83 #define ACPI_HANDLER_PRESENT_STRING                    "%-9s (%p)\n"
  84 #define ACPI_HANDLER_PRESENT_STRING2                   "%-9s (%p)"
  85 #define ACPI_HANDLER_NOT_PRESENT_STRING                "%-9s\n"
  86
  87 /* All predefined Address Space IDs */
  88
  89 static ACPI_ADR_SPACE_TYPE  AcpiGbl_SpaceIdList[] =
  90 {
  91     ACPI_ADR_SPACE_SYSTEM_MEMORY,
  92     ACPI_ADR_SPACE_SYSTEM_IO,
  93     ACPI_ADR_SPACE_PCI_CONFIG,
  94     ACPI_ADR_SPACE_EC,
  95     ACPI_ADR_SPACE_SMBUS,
  96     ACPI_ADR_SPACE_CMOS,
  97     ACPI_ADR_SPACE_PCI_BAR_TARGET,
  98     ACPI_ADR_SPACE_IPMI,
  99     ACPI_ADR_SPACE_GPIO,
 100     ACPI_ADR_SPACE_GSBUS,
 101     ACPI_ADR_SPACE_DATA_TABLE,
 102     ACPI_ADR_SPACE_FIXED_HARDWARE
 103 };
 104
 105 /* Global handler information */
 106
 107 typedef struct acpi_handler_info
 108 {
 109     void                    *Handler;
 110     char                    *Name;
 111
 112 } ACPI_HANDLER_INFO;
 113
 114 static ACPI_HANDLER_INFO    AcpiGbl_HandlerList[] =
 115 {
 116     {&AcpiGbl_GlobalNotify[0].Handler,  "System Notifications"},
 117     {&AcpiGbl_GlobalNotify[1].Handler,  "Device Notifications"},
 118     {&AcpiGbl_TableHandler,             "ACPI Table Events"},
 119     {&AcpiGbl_ExceptionHandler,         "Control Method Exceptions"},
 120     {&AcpiGbl_InterfaceHandler,         "OSI Invocations"}
 121 };
 122
 123
 124 /*******************************************************************************
 125  *
 126  * FUNCTION:    AcpiDbGetPointer
 127  *
 128  * PARAMETERS:  Target          - Pointer to string to be converted
 129  *
 130  * RETURN:      Converted pointer
 131  *
 132  * DESCRIPTION: Convert an ascii pointer value to a real value
 133  *
 134  ******************************************************************************/
 135
 136 static void *
 137 AcpiDbGetPointer (
 138     void                    *Target)
 139 {
 140     void                    *ObjPtr;
 141     ACPI_SIZE               Address;
 142
 143
 144     Address = ACPI_STRTOUL (Target, NULL, 16);
 145     ObjPtr = ACPI_TO_POINTER (Address);
 146     return (ObjPtr);
 147 }
 148
 149
 150 /*******************************************************************************
 151  *
 152  * FUNCTION:    AcpiDbDumpParserDescriptor
 153  *
 154  * PARAMETERS:  Op              - A parser Op descriptor
 155  *
 156  * RETURN:      None
 157  *
 158  * DESCRIPTION: Display a formatted parser object
 159  *
 160  ******************************************************************************/
 161
 162 static void
 163 AcpiDbDumpParserDescriptor (
 164     ACPI_PARSE_OBJECT       *Op)
 165 {
 166     const ACPI_OPCODE_INFO  *Info;
 167
 168
 169     Info = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
 170
 171     AcpiOsPrintf ("Parser Op Descriptor:\n");
 172     AcpiOsPrintf ("%20.20s : %4.4X\n", "Opcode", Op->Common.AmlOpcode);
 173
 174     ACPI_DEBUG_ONLY_MEMBERS (AcpiOsPrintf ("%20.20s : %s\n", "Opcode Name",
 175         Info->Name));
 176
 177     AcpiOsPrintf ("%20.20s : %p\n", "Value/ArgList", Op->Common.Value.Arg);
 178     AcpiOsPrintf ("%20.20s : %p\n", "Parent", Op->Common.Parent);
 179     AcpiOsPrintf ("%20.20s : %p\n", "NextOp", Op->Common.Next);
 180 }
 181
 182
 183 /*******************************************************************************
 184  *
 185  * FUNCTION:    AcpiDbDecodeAndDisplayObject
 186  *
 187  * PARAMETERS:  Target          - String with object to be displayed. Names
 188  *                                and hex pointers are supported.
 189  *              OutputType      - Byte, Word, Dword, or Qword (B|W|D|Q)
 190  *
 191  * RETURN:      None
 192  *
 193  * DESCRIPTION: Display a formatted ACPI object
 194  *
 195  ******************************************************************************/
 196
 197 void
 198 AcpiDbDecodeAndDisplayObject (
 199     char                    *Target,
 200     char                    *OutputType)
 201 {
 202     void                    *ObjPtr;
 203     ACPI_NAMESPACE_NODE     *Node;
 204     ACPI_OPERAND_OBJECT     *ObjDesc;
 205     UINT32                  Display = DB_BYTE_DISPLAY;
 206     char                    Buffer[80];
 207     ACPI_BUFFER             RetBuf;
 208     ACPI_STATUS             Status;
 209     UINT32                  Size;
 210
 211
 212     if (!Target)
 213     {
 214         return;
 215     }
 216
 217     /* Decode the output type */
 218
 219     if (OutputType)
 220     {
 221         AcpiUtStrupr (OutputType);
 222         if (OutputType[0] == 'W')
 223         {
 224             Display = DB_WORD_DISPLAY;
 225         }
 226         else if (OutputType[0] == 'D')
 227         {
 228             Display = DB_DWORD_DISPLAY;
 229         }
 230         else if (OutputType[0] == 'Q')
 231         {
 232             Display = DB_QWORD_DISPLAY;
 233         }
 234     }
 235
 236     RetBuf.Length = sizeof (Buffer);
 237     RetBuf.Pointer = Buffer;
 238
 239     /* Differentiate between a number and a name */
 240
 241     if ((Target[0] >= 0x30) && (Target[0] <= 0x39))
 242     {
 243         ObjPtr = AcpiDbGetPointer (Target);
 244         if (!AcpiOsReadable (ObjPtr, 16))
 245         {
 246             AcpiOsPrintf ("Address %p is invalid in this address space\n",
 247                 ObjPtr);
 248             return;
 249         }
 250
 251         /* Decode the object type */
 252
 253         switch (ACPI_GET_DESCRIPTOR_TYPE (ObjPtr))
 254         {
 255         case ACPI_DESC_TYPE_NAMED:
 256
 257             /* This is a namespace Node */
 258
 259             if (!AcpiOsReadable (ObjPtr, sizeof (ACPI_NAMESPACE_NODE)))
 260             {
 261                 AcpiOsPrintf (
 262                     "Cannot read entire Named object at address %p\n", ObjPtr);
 263                 return;
 264             }
 265
 266             Node = ObjPtr;
 267             goto DumpNode;
 268
 269         case ACPI_DESC_TYPE_OPERAND:
 270
 271             /* This is a ACPI OPERAND OBJECT */
 272
 273             if (!AcpiOsReadable (ObjPtr, sizeof (ACPI_OPERAND_OBJECT)))
 274             {
 275                 AcpiOsPrintf ("Cannot read entire ACPI object at address %p\n",
 276                     ObjPtr);
 277                 return;
 278             }
 279
 280             AcpiUtDebugDumpBuffer (ObjPtr, sizeof (ACPI_OPERAND_OBJECT), Display,
 281                 ACPI_UINT32_MAX);
 282             AcpiExDumpObjectDescriptor (ObjPtr, 1);
 283             break;
 284
 285         case ACPI_DESC_TYPE_PARSER:
 286
 287             /* This is a Parser Op object */
 288
 289             if (!AcpiOsReadable (ObjPtr, sizeof (ACPI_PARSE_OBJECT)))
 290             {
 291                 AcpiOsPrintf (
 292                     "Cannot read entire Parser object at address %p\n", ObjPtr);
 293                 return;
 294             }
 295
 296             AcpiUtDebugDumpBuffer (ObjPtr, sizeof (ACPI_PARSE_OBJECT), Display,
 297                 ACPI_UINT32_MAX);
 298             AcpiDbDumpParserDescriptor ((ACPI_PARSE_OBJECT *) ObjPtr);
 299             break;
 300
 301         default:
 302
 303             /* Is not a recognizeable object */
 304
 305             AcpiOsPrintf (
 306                 "Not a known ACPI internal object, descriptor type %2.2X\n",
 307                 ACPI_GET_DESCRIPTOR_TYPE (ObjPtr));
 308
 309             Size = 16;
 310             if (AcpiOsReadable (ObjPtr, 64))
 311             {
 312                 Size = 64;
 313             }
 314
 315             /* Just dump some memory */
 316
 317             AcpiUtDebugDumpBuffer (ObjPtr, Size, Display, ACPI_UINT32_MAX);
 318             break;
 319         }
 320
 321         return;
 322     }
 323
 324     /* The parameter is a name string that must be resolved to a Named obj */
 325
 326     Node = AcpiDbLocalNsLookup (Target);
 327     if (!Node)
 328     {
 329         return;
 330     }
 331
 332
 333 DumpNode:
 334     /* Now dump the NS node */
 335
 336     Status = AcpiGetName (Node, ACPI_FULL_PATHNAME, &RetBuf);
 337     if (ACPI_FAILURE (Status))
 338     {
 339         AcpiOsPrintf ("Could not convert name to pathname\n");
 340     }
 341
 342     else
 343     {
 344         AcpiOsPrintf ("Object (%p) Pathname:  %s\n",
 345             Node, (char *) RetBuf.Pointer);
 346     }
 347
 348     if (!AcpiOsReadable (Node, sizeof (ACPI_NAMESPACE_NODE)))
 349     {
 350         AcpiOsPrintf ("Invalid Named object at address %p\n", Node);
 351         return;
 352     }
 353
 354     AcpiUtDebugDumpBuffer ((void *) Node, sizeof (ACPI_NAMESPACE_NODE),
 355         Display, ACPI_UINT32_MAX);
 356     AcpiExDumpNamespaceNode (Node, 1);
 357
 358     ObjDesc = AcpiNsGetAttachedObject (Node);
 359     if (ObjDesc)
 360     {
 361         AcpiOsPrintf ("\nAttached Object (%p):\n", ObjDesc);
 362         if (!AcpiOsReadable (ObjDesc, sizeof (ACPI_OPERAND_OBJECT)))
 363         {
 364             AcpiOsPrintf ("Invalid internal ACPI Object at address %p\n",
 365                 ObjDesc);
 366             return;
 367         }
 368
 369         AcpiUtDebugDumpBuffer ((void *) ObjDesc, sizeof (ACPI_OPERAND_OBJECT),
 370             Display, ACPI_UINT32_MAX);
 371         AcpiExDumpObjectDescriptor (ObjDesc, 1);
 372     }
 373 }
 374
 375
 376 /*******************************************************************************
 377  *
 378  * FUNCTION:    AcpiDbDisplayMethodInfo
 379  *
 380  * PARAMETERS:  StartOp         - Root of the control method parse tree
 381  *
 382  * RETURN:      None
 383  *
 384  * DESCRIPTION: Display information about the current method
 385  *
 386  ******************************************************************************/
 387
 388 void
 389 AcpiDbDisplayMethodInfo (
 390     ACPI_PARSE_OBJECT       *StartOp)
 391 {
 392     ACPI_WALK_STATE         *WalkState;
 393     ACPI_OPERAND_OBJECT     *ObjDesc;
 394     ACPI_NAMESPACE_NODE     *Node;
 395     ACPI_PARSE_OBJECT       *RootOp;
 396     ACPI_PARSE_OBJECT       *Op;
 397     const ACPI_OPCODE_INFO  *OpInfo;
 398     UINT32                  NumOps = 0;
 399     UINT32                  NumOperands = 0;
 400     UINT32                  NumOperators = 0;
 401     UINT32                  NumRemainingOps = 0;
 402     UINT32                  NumRemainingOperands = 0;
 403     UINT32                  NumRemainingOperators = 0;
 404     BOOLEAN                 CountRemaining = FALSE;
 405
 406
 407     WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
 408     if (!WalkState)
 409     {
 410         AcpiOsPrintf ("There is no method currently executing\n");
 411         return;
 412     }
 413
 414     ObjDesc = WalkState->MethodDesc;
 415     Node    = WalkState->MethodNode;
 416
 417     AcpiOsPrintf ("Currently executing control method is [%4.4s]\n",
 418             AcpiUtGetNodeName (Node));
 419     AcpiOsPrintf ("%X Arguments, SyncLevel = %X\n",
 420             (UINT32) ObjDesc->Method.ParamCount,
 421             (UINT32) ObjDesc->Method.SyncLevel);
 422
 423
 424     RootOp = StartOp;
 425     while (RootOp->Common.Parent)
 426     {
 427         RootOp = RootOp->Common.Parent;
 428     }
 429
 430     Op = RootOp;
 431
 432     while (Op)
 433     {
 434         if (Op == StartOp)
 435         {
 436             CountRemaining = TRUE;
 437         }
 438
 439         NumOps++;
 440         if (CountRemaining)
 441         {
 442             NumRemainingOps++;
 443         }
 444
 445         /* Decode the opcode */
 446
 447         OpInfo = AcpiPsGetOpcodeInfo (Op->Common.AmlOpcode);
 448         switch (OpInfo->Class)
 449         {
 450         case AML_CLASS_ARGUMENT:
 451
 452             if (CountRemaining)
 453             {
 454                 NumRemainingOperands++;
 455             }
 456
 457             NumOperands++;
 458             break;
 459
 460         case AML_CLASS_UNKNOWN:
 461
 462             /* Bad opcode or ASCII character */
 463
 464             continue;
 465
 466         default:
 467
 468             if (CountRemaining)
 469             {
 470                 NumRemainingOperators++;
 471             }
 472
 473             NumOperators++;
 474             break;
 475         }
 476
 477         Op = AcpiPsGetDepthNext (StartOp, Op);
 478     }
 479
 480     AcpiOsPrintf (
 481         "Method contains:       %X AML Opcodes - %X Operators, %X Operands\n",
 482         NumOps, NumOperators, NumOperands);
 483
 484     AcpiOsPrintf (
 485         "Remaining to execute:  %X AML Opcodes - %X Operators, %X Operands\n",
 486         NumRemainingOps, NumRemainingOperators, NumRemainingOperands);
 487 }
 488
 489
 490 /*******************************************************************************
 491  *
 492  * FUNCTION:    AcpiDbDisplayLocals
 493  *
 494  * PARAMETERS:  None
 495  *
 496  * RETURN:      None
 497  *
 498  * DESCRIPTION: Display all locals for the currently running control method
 499  *
 500  ******************************************************************************/
 501
 502 void
 503 AcpiDbDisplayLocals (
 504     void)
 505 {
 506     ACPI_WALK_STATE         *WalkState;
 507
 508
 509     WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
 510     if (!WalkState)
 511     {
 512         AcpiOsPrintf ("There is no method currently executing\n");
 513         return;
 514     }
 515
 516     AcpiDmDisplayLocals (WalkState);
 517 }
 518
 519
 520 /*******************************************************************************
 521  *
 522  * FUNCTION:    AcpiDbDisplayArguments
 523  *
 524  * PARAMETERS:  None
 525  *
 526  * RETURN:      None
 527  *
 528  * DESCRIPTION: Display all arguments for the currently running control method
 529  *
 530  ******************************************************************************/
 531
 532 void
 533 AcpiDbDisplayArguments (
 534     void)
 535 {
 536     ACPI_WALK_STATE         *WalkState;
 537
 538
 539     WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
 540     if (!WalkState)
 541     {
 542         AcpiOsPrintf ("There is no method currently executing\n");
 543         return;
 544     }
 545
 546     AcpiDmDisplayArguments (WalkState);
 547 }
 548
 549
 550 /*******************************************************************************
 551  *
 552  * FUNCTION:    AcpiDbDisplayResults
 553  *
 554  * PARAMETERS:  None
 555  *
 556  * RETURN:      None
 557  *
 558  * DESCRIPTION: Display current contents of a method result stack
 559  *
 560  ******************************************************************************/
 561
 562 void
 563 AcpiDbDisplayResults (
 564     void)
 565 {
 566     UINT32                  i;
 567     ACPI_WALK_STATE         *WalkState;
 568     ACPI_OPERAND_OBJECT     *ObjDesc;
 569     UINT32                  ResultCount = 0;
 570     ACPI_NAMESPACE_NODE     *Node;
 571     ACPI_GENERIC_STATE      *Frame;
 572     UINT32                  Index; /* Index onto current frame */
 573
 574
 575     WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
 576     if (!WalkState)
 577     {
 578         AcpiOsPrintf ("There is no method currently executing\n");
 579         return;
 580     }
 581
 582     ObjDesc = WalkState->MethodDesc;
 583     Node    = WalkState->MethodNode;
 584
 585     if (WalkState->Results)
 586     {
 587         ResultCount = WalkState->ResultCount;
 588     }
 589
 590     AcpiOsPrintf ("Method [%4.4s] has %X stacked result objects\n",
 591             AcpiUtGetNodeName (Node), ResultCount);
 592
 593     /* From the top element of result stack */
 594
 595     Frame = WalkState->Results;
 596     Index = (ResultCount - 1) % ACPI_RESULTS_FRAME_OBJ_NUM;
 597
 598     for (i = 0; i < ResultCount; i++)
 599     {
 600         ObjDesc = Frame->Results.ObjDesc[Index];
 601         AcpiOsPrintf ("Result%u: ", i);
 602         AcpiDmDisplayInternalObject (ObjDesc, WalkState);
 603         if (Index == 0)
 604         {
 605             Frame = Frame->Results.Next;
 606             Index = ACPI_RESULTS_FRAME_OBJ_NUM;
 607         }
 608         Index--;
 609     }
 610 }
 611
 612
 613 /*******************************************************************************
 614  *
 615  * FUNCTION:    AcpiDbDisplayCallingTree
 616  *
 617  * PARAMETERS:  None
 618  *
 619  * RETURN:      None
 620  *
 621  * DESCRIPTION: Display current calling tree of nested control methods
 622  *
 623  ******************************************************************************/
 624
 625 void
 626 AcpiDbDisplayCallingTree (
 627     void)
 628 {
 629     ACPI_WALK_STATE         *WalkState;
 630     ACPI_NAMESPACE_NODE     *Node;
 631
 632
 633     WalkState = AcpiDsGetCurrentWalkState (AcpiGbl_CurrentWalkList);
 634     if (!WalkState)
 635     {
 636         AcpiOsPrintf ("There is no method currently executing\n");
 637         return;
 638     }
 639
 640     Node = WalkState->MethodNode;
 641     AcpiOsPrintf ("Current Control Method Call Tree\n");
 642
 643     while (WalkState)
 644     {
 645         Node = WalkState->MethodNode;
 646
 647         AcpiOsPrintf ("    [%4.4s]\n", AcpiUtGetNodeName (Node));
 648
 649         WalkState = WalkState->Next;
 650     }
 651 }
 652
 653
 654 /*******************************************************************************
 655  *
 656  * FUNCTION:    AcpiDbDisplayObjectType
 657  *
 658  * PARAMETERS:  Name            - User entered NS node handle or name
 659  *
 660  * RETURN:      None
 661  *
 662  * DESCRIPTION: Display type of an arbitrary NS node
 663  *
 664  ******************************************************************************/
 665
 666 void
 667 AcpiDbDisplayObjectType (
 668     char                    *Name)
 669 {
 670     ACPI_NAMESPACE_NODE     *Node;
 671     ACPI_DEVICE_INFO        *Info;
 672     ACPI_STATUS             Status;
 673     UINT32                  i;
 674
 675
 676     Node = AcpiDbConvertToNode (Name);
 677     if (!Node)
 678     {
 679         return;
 680     }
 681
 682     Status = AcpiGetObjectInfo (ACPI_CAST_PTR (ACPI_HANDLE, Node), &Info);
 683     if (ACPI_FAILURE (Status))
 684     {
 685         AcpiOsPrintf ("Could not get object info, %s\n",
 686             AcpiFormatException (Status));
 687         return;
 688     }
 689
 690     if (Info->Valid & ACPI_VALID_ADR)
 691     {
 692         AcpiOsPrintf ("ADR: %8.8X%8.8X, STA: %8.8X, Flags: %X\n",
 693             ACPI_FORMAT_UINT64 (Info->Address),
 694             Info->CurrentStatus, Info->Flags);
 695     }
 696     if (Info->Valid & ACPI_VALID_SXDS)
 697     {
 698         AcpiOsPrintf ("S1D-%2.2X S2D-%2.2X S3D-%2.2X S4D-%2.2X\n",
 699             Info->HighestDstates[0], Info->HighestDstates[1],
 700             Info->HighestDstates[2], Info->HighestDstates[3]);
 701     }
 702     if (Info->Valid & ACPI_VALID_SXWS)
 703     {
 704         AcpiOsPrintf ("S0W-%2.2X S1W-%2.2X S2W-%2.2X S3W-%2.2X S4W-%2.2X\n",
 705             Info->LowestDstates[0], Info->LowestDstates[1],
 706             Info->LowestDstates[2], Info->LowestDstates[3],
 707             Info->LowestDstates[4]);
 708     }
 709
 710     if (Info->Valid & ACPI_VALID_HID)
 711     {
 712         AcpiOsPrintf ("HID: %s\n", Info->HardwareId.String);
 713     }
 714     if (Info->Valid & ACPI_VALID_UID)
 715     {
 716         AcpiOsPrintf ("UID: %s\n", Info->UniqueId.String);
 717     }
 718     if (Info->Valid & ACPI_VALID_SUB)
 719     {
 720         AcpiOsPrintf ("SUB: %s\n", Info->SubsystemId.String);
 721     }
 722     if (Info->Valid & ACPI_VALID_CID)
 723     {
 724         for (i = 0; i < Info->CompatibleIdList.Count; i++)
 725         {
 726             AcpiOsPrintf ("CID %u: %s\n", i,
 727                 Info->CompatibleIdList.Ids[i].String);
 728         }
 729     }
 730
 731     ACPI_FREE (Info);
 732 }
 733
 734
 735 /*******************************************************************************
 736  *
 737  * FUNCTION:    AcpiDbDisplayResultObject
 738  *
 739  * PARAMETERS:  ObjDesc         - Object to be displayed
 740  *              WalkState       - Current walk state
 741  *
 742  * RETURN:      None
 743  *
 744  * DESCRIPTION: Display the result of an AML opcode
 745  *
 746  * Note: Curently only displays the result object if we are single stepping.
 747  * However, this output may be useful in other contexts and could be enabled
 748  * to do so if needed.
 749  *
 750  ******************************************************************************/
 751
 752 void
 753 AcpiDbDisplayResultObject (
 754     ACPI_OPERAND_OBJECT     *ObjDesc,
 755     ACPI_WALK_STATE         *WalkState)
 756 {
 757
 758     /* Only display if single stepping */
 759
 760     if (!AcpiGbl_CmSingleStep)
 761     {
 762         return;
 763     }
 764
 765     AcpiOsPrintf ("ResultObj: ");
 766     AcpiDmDisplayInternalObject (ObjDesc, WalkState);
 767     AcpiOsPrintf ("\n");
 768 }
 769
 770
 771 /*******************************************************************************
 772  *
 773  * FUNCTION:    AcpiDbDisplayArgumentObject
 774  *
 775  * PARAMETERS:  ObjDesc         - Object to be displayed
 776  *              WalkState       - Current walk state
 777  *
 778  * RETURN:      None
 779  *
 780  * DESCRIPTION: Display the result of an AML opcode
 781  *
 782  ******************************************************************************/
 783
 784 void
 785 AcpiDbDisplayArgumentObject (
 786     ACPI_OPERAND_OBJECT     *ObjDesc,
 787     ACPI_WALK_STATE         *WalkState)
 788 {
 789
 790     if (!AcpiGbl_CmSingleStep)
 791     {
 792         return;
 793     }
 794
 795     AcpiOsPrintf ("ArgObj:    ");
 796     AcpiDmDisplayInternalObject (ObjDesc, WalkState);
 797 }
 798
 799
 800 #if (!ACPI_REDUCED_HARDWARE)
 801 /*******************************************************************************
 802  *
 803  * FUNCTION:    AcpiDbDisplayGpes
 804  *
 805  * PARAMETERS:  None
 806  *
 807  * RETURN:      None
 808  *
 809  * DESCRIPTION: Display the current GPE structures
 810  *
 811  ******************************************************************************/
 812
 813 void
 814 AcpiDbDisplayGpes (
 815     void)
 816 {
 817     ACPI_GPE_BLOCK_INFO     *GpeBlock;
 818     ACPI_GPE_XRUPT_INFO     *GpeXruptInfo;
 819     ACPI_GPE_EVENT_INFO     *GpeEventInfo;
 820     ACPI_GPE_REGISTER_INFO  *GpeRegisterInfo;
 821     char                    *GpeType;
 822     ACPI_GPE_NOTIFY_INFO    *Notify;
 823     UINT32                  GpeIndex;
 824     UINT32                  Block = 0;
 825     UINT32                  i;
 826     UINT32                  j;
 827     UINT32                  Count;
 828     char                    Buffer[80];
 829     ACPI_BUFFER             RetBuf;
 830     ACPI_STATUS             Status;
 831
 832
 833     RetBuf.Length = sizeof (Buffer);
 834     RetBuf.Pointer = Buffer;
 835
 836     Block = 0;
 837
 838     /* Walk the GPE lists */
 839
 840     GpeXruptInfo = AcpiGbl_GpeXruptListHead;
 841     while (GpeXruptInfo)
 842     {
 843         GpeBlock = GpeXruptInfo->GpeBlockListHead;
 844         while (GpeBlock)
 845         {
 846             Status = AcpiGetName (GpeBlock->Node, ACPI_FULL_PATHNAME, &RetBuf);
 847             if (ACPI_FAILURE (Status))
 848             {
 849                 AcpiOsPrintf ("Could not convert name to pathname\n");
 850             }
 851
 852             if (GpeBlock->Node == AcpiGbl_FadtGpeDevice)
 853             {
 854                 GpeType = "FADT-defined GPE block";
 855             }
 856             else
 857             {
 858                 GpeType = "GPE Block Device";
 859             }
 860
 861             AcpiOsPrintf ("\nBlock %u - Info %p  DeviceNode %p [%s] - %s\n",
 862                 Block, GpeBlock, GpeBlock->Node, Buffer, GpeType);
 863
 864             AcpiOsPrintf ("    Registers:    %u (%u GPEs)\n",
 865                 GpeBlock->RegisterCount, GpeBlock->GpeCount);
 866
 867             AcpiOsPrintf ("    GPE range:    0x%X to 0x%X on interrupt %u\n",
 868                 GpeBlock->BlockBaseNumber,
 869                 GpeBlock->BlockBaseNumber + (GpeBlock->GpeCount - 1),
 870                 GpeXruptInfo->InterruptNumber);
 871
 872             AcpiOsPrintf (
 873                 "    RegisterInfo: %p  Status %8.8X%8.8X Enable %8.8X%8.8X\n",
 874                 GpeBlock->RegisterInfo,
 875                 ACPI_FORMAT_UINT64 (GpeBlock->RegisterInfo->StatusAddress.Address),
 876                 ACPI_FORMAT_UINT64 (GpeBlock->RegisterInfo->EnableAddress.Address));
 877
 878             AcpiOsPrintf ("    EventInfo:    %p\n", GpeBlock->EventInfo);
 879
 880             /* Examine each GPE Register within the block */
 881
 882             for (i = 0; i < GpeBlock->RegisterCount; i++)
 883             {
 884                 GpeRegisterInfo = &GpeBlock->RegisterInfo[i];
 885
 886                 AcpiOsPrintf (
 887                     "    Reg %u: (GPE %.2X-%.2X)  RunEnable %2.2X WakeEnable %2.2X"
 888                     " Status %8.8X%8.8X Enable %8.8X%8.8X\n",
 889                     i, GpeRegisterInfo->BaseGpeNumber,
 890                     GpeRegisterInfo->BaseGpeNumber + (ACPI_GPE_REGISTER_WIDTH - 1),
 891                     GpeRegisterInfo->EnableForRun,
 892                     GpeRegisterInfo->EnableForWake,
 893                     ACPI_FORMAT_UINT64 (GpeRegisterInfo->StatusAddress.Address),
 894                     ACPI_FORMAT_UINT64 (GpeRegisterInfo->EnableAddress.Address));
 895
 896                 /* Now look at the individual GPEs in this byte register */
 897
 898                 for (j = 0; j < ACPI_GPE_REGISTER_WIDTH; j++)
 899                 {
 900                     GpeIndex = (i * ACPI_GPE_REGISTER_WIDTH) + j;
 901                     GpeEventInfo = &GpeBlock->EventInfo[GpeIndex];
 902
 903                     if ((GpeEventInfo->Flags & ACPI_GPE_DISPATCH_MASK) ==
 904                         ACPI_GPE_DISPATCH_NONE)
 905                     {
 906                         /* This GPE is not used (no method or handler), ignore it */
 907
 908                         continue;
 909                     }
 910
 911                     AcpiOsPrintf (
 912                         "        GPE %.2X: %p  RunRefs %2.2X Flags %2.2X (",
 913                         GpeBlock->BlockBaseNumber + GpeIndex, GpeEventInfo,
 914                         GpeEventInfo->RuntimeCount, GpeEventInfo->Flags);
 915
 916                     /* Decode the flags byte */
 917
 918                     if (GpeEventInfo->Flags & ACPI_GPE_LEVEL_TRIGGERED)
 919                     {
 920                         AcpiOsPrintf ("Level, ");
 921                     }
 922                     else
 923                     {
 924                         AcpiOsPrintf ("Edge,  ");
 925                     }
 926
 927                     if (GpeEventInfo->Flags & ACPI_GPE_CAN_WAKE)
 928                     {
 929                         AcpiOsPrintf ("CanWake, ");
 930                     }
 931                     else
 932                     {
 933                         AcpiOsPrintf ("RunOnly, ");
 934                     }
 935
 936                     switch (GpeEventInfo->Flags & ACPI_GPE_DISPATCH_MASK)
 937                     {
 938                     case ACPI_GPE_DISPATCH_NONE:
 939
 940                         AcpiOsPrintf ("NotUsed");
 941                         break;
 942
 943                     case ACPI_GPE_DISPATCH_METHOD:
 944
 945                         AcpiOsPrintf ("Method");
 946                         break;
 947                     case ACPI_GPE_DISPATCH_HANDLER:
 948
 949                         AcpiOsPrintf ("Handler");
 950                         break;
 951
 952                     case ACPI_GPE_DISPATCH_NOTIFY:
 953
 954                         Count = 0;
 955                         Notify = GpeEventInfo->Dispatch.NotifyList;
 956                         while (Notify)
 957                         {
 958                             Count++;
 959                             Notify = Notify->Next;
 960                         }
 961                         AcpiOsPrintf ("Implicit Notify on %u devices", Count);
 962                         break;
 963
 964                     default:
 965
 966                         AcpiOsPrintf ("UNKNOWN: %X",
 967                             GpeEventInfo->Flags & ACPI_GPE_DISPATCH_MASK);
 968                         break;
 969                     }
 970
 971                     AcpiOsPrintf (")\n");
 972                 }
 973             }
 974             Block++;
 975             GpeBlock = GpeBlock->Next;
 976         }
 977         GpeXruptInfo = GpeXruptInfo->Next;
 978     }
 979 }
 980 #endif /* !ACPI_REDUCED_HARDWARE */
 981
 982
 983 /*******************************************************************************
 984  *
 985  * FUNCTION:    AcpiDbDisplayHandlers
 986  *
 987  * PARAMETERS:  None
 988  *
 989  * RETURN:      None
 990  *
 991  * DESCRIPTION: Display the currently installed global handlers
 992  *
 993  ******************************************************************************/
 994
 995 void
 996 AcpiDbDisplayHandlers (
 997     void)
 998 {
 999     ACPI_OPERAND_OBJECT     *ObjDesc;
1000     ACPI_OPERAND_OBJECT     *HandlerObj;
1001     ACPI_ADR_SPACE_TYPE     SpaceId;
1002     UINT32                  i;
1003
1004
1005     /* Operation region handlers */
1006
1007     AcpiOsPrintf ("\nOperation Region Handlers at the namespace root:\n");
1008
1009     ObjDesc = AcpiNsGetAttachedObject (AcpiGbl_RootNode);
1010     if (ObjDesc)
1011     {
1012         for (i = 0; i < ACPI_ARRAY_LENGTH (AcpiGbl_SpaceIdList); i++)
1013         {
1014             SpaceId = AcpiGbl_SpaceIdList[i];
1015             HandlerObj = ObjDesc->Device.Handler;
1016
1017             AcpiOsPrintf (ACPI_PREDEFINED_PREFIX,
1018                 AcpiUtGetRegionName ((UINT8) SpaceId), SpaceId);
1019
1020             while (HandlerObj)
1021             {
1022                 if (AcpiGbl_SpaceIdList[i] == HandlerObj->AddressSpace.SpaceId)
1023                 {
1024                     AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING,
1025                         (HandlerObj->AddressSpace.HandlerFlags &
1026                             ACPI_ADDR_HANDLER_DEFAULT_INSTALLED) ? "Default" : "User",
1027                         HandlerObj->AddressSpace.Handler);
1028                     goto FoundHandler;
1029                 }
1030
1031                 HandlerObj = HandlerObj->AddressSpace.Next;
1032             }
1033
1034             /* There is no handler for this SpaceId */
1035
1036             AcpiOsPrintf ("None\n");
1037
1038         FoundHandler:;
1039         }
1040
1041         /* Find all handlers for user-defined SpaceIDs */
1042
1043         HandlerObj = ObjDesc->Device.Handler;
1044         while (HandlerObj)
1045         {
1046             if (HandlerObj->AddressSpace.SpaceId >= ACPI_USER_REGION_BEGIN)
1047             {
1048                 AcpiOsPrintf (ACPI_PREDEFINED_PREFIX,
1049                     "User-defined ID", HandlerObj->AddressSpace.SpaceId);
1050                 AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING,
1051                     (HandlerObj->AddressSpace.HandlerFlags &
1052                         ACPI_ADDR_HANDLER_DEFAULT_INSTALLED) ? "Default" : "User",
1053                     HandlerObj->AddressSpace.Handler);
1054             }
1055
1056             HandlerObj = HandlerObj->AddressSpace.Next;
1057         }
1058     }
1059
1060 #if (!ACPI_REDUCED_HARDWARE)
1061
1062     /* Fixed event handlers */
1063
1064     AcpiOsPrintf ("\nFixed Event Handlers:\n");
1065
1066     for (i = 0; i < ACPI_NUM_FIXED_EVENTS; i++)
1067     {
1068         AcpiOsPrintf (ACPI_PREDEFINED_PREFIX, AcpiUtGetEventName (i), i);
1069         if (AcpiGbl_FixedEventHandlers[i].Handler)
1070         {
1071             AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING, "User",
1072                 AcpiGbl_FixedEventHandlers[i].Handler);
1073         }
1074         else
1075         {
1076             AcpiOsPrintf (ACPI_HANDLER_NOT_PRESENT_STRING, "None");
1077         }
1078     }
1079
1080 #endif /* !ACPI_REDUCED_HARDWARE */
1081
1082     /* Miscellaneous global handlers */
1083
1084     AcpiOsPrintf ("\nMiscellaneous Global Handlers:\n");
1085
1086     for (i = 0; i < ACPI_ARRAY_LENGTH (AcpiGbl_HandlerList); i++)
1087     {
1088         AcpiOsPrintf (ACPI_HANDLER_NAME_STRING, AcpiGbl_HandlerList[i].Name);
1089         if (AcpiGbl_HandlerList[i].Handler)
1090         {
1091             AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING, "User",
1092                 AcpiGbl_HandlerList[i].Handler);
1093         }
1094         else
1095         {
1096             AcpiOsPrintf (ACPI_HANDLER_NOT_PRESENT_STRING, "None");
1097         }
1098     }
1099
1100
1101     /* Other handlers that are installed throughout the namespace */
1102
1103     AcpiOsPrintf ("\nOperation Region Handlers for specific devices:\n");
1104
1105     (void) AcpiWalkNamespace (ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT,
1106                 ACPI_UINT32_MAX, AcpiDbDisplayNonRootHandlers,
1107                 NULL, NULL, NULL);
1108 }
1109
1110
1111 /*******************************************************************************
1112  *
1113  * FUNCTION:    AcpiDbDisplayNonRootHandlers
1114  *
1115  * PARAMETERS:  ACPI_WALK_CALLBACK
1116  *
1117  * RETURN:      Status
1118  *
1119  * DESCRIPTION: Display information about all handlers installed for a
1120  *              device object.
1121  *
1122  ******************************************************************************/
1123
1124 static ACPI_STATUS
1125 AcpiDbDisplayNonRootHandlers (
1126     ACPI_HANDLE             ObjHandle,
1127     UINT32                  NestingLevel,
1128     void                    *Context,
1129     void                    **ReturnValue)
1130 {
1131     ACPI_NAMESPACE_NODE     *Node = ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, ObjHandle);
1132     ACPI_OPERAND_OBJECT     *ObjDesc;
1133     ACPI_OPERAND_OBJECT     *HandlerObj;
1134     char                    *Pathname;
1135
1136
1137     ObjDesc = AcpiNsGetAttachedObject (Node);
1138     if (!ObjDesc)
1139     {
1140         return (AE_OK);
1141     }
1142
1143     Pathname = AcpiNsGetExternalPathname (Node);
1144     if (!Pathname)
1145     {
1146         return (AE_OK);
1147     }
1148
1149     /* Display all handlers associated with this device */
1150
1151     HandlerObj = ObjDesc->Device.Handler;
1152     while (HandlerObj)
1153     {
1154         AcpiOsPrintf (ACPI_PREDEFINED_PREFIX,
1155             AcpiUtGetRegionName ((UINT8) HandlerObj->AddressSpace.SpaceId),
1156             HandlerObj->AddressSpace.SpaceId);
1157
1158         AcpiOsPrintf (ACPI_HANDLER_PRESENT_STRING2,
1159             (HandlerObj->AddressSpace.HandlerFlags &
1160                 ACPI_ADDR_HANDLER_DEFAULT_INSTALLED) ? "Default" : "User",
1161             HandlerObj->AddressSpace.Handler);
1162
1163         AcpiOsPrintf (" Device Name: %s (%p)\n", Pathname, Node);
1164
1165         HandlerObj = HandlerObj->AddressSpace.Next;
1166     }
1167
1168     ACPI_FREE (Pathname);
1169     return (AE_OK);
1170 }
1171
1172 #endif /* ACPI_DEBUGGER */