sys/contrib/dev/acpica/components/namespace/nsdump.c

   1 /******************************************************************************
   2  *
   3  * Module Name: nsdump - table dumping routines for debug
   4  *
   5  *****************************************************************************/
   6
   7 /*
   8  * Copyright (C) 2000 - 2013, 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 #define __NSDUMP_C__
  45
  46 #include <contrib/dev/acpica/include/acpi.h>
  47 #include <contrib/dev/acpica/include/accommon.h>
  48 #include <contrib/dev/acpica/include/acnamesp.h>
  49 #include <contrib/dev/acpica/include/acoutput.h>
  50
  51
  52 #define _COMPONENT          ACPI_NAMESPACE
  53         ACPI_MODULE_NAME    ("nsdump")
  54
  55 /* Local prototypes */
  56
  57 #ifdef ACPI_OBSOLETE_FUNCTIONS
  58 void
  59 AcpiNsDumpRootDevices (
  60     void);
  61
  62 static ACPI_STATUS
  63 AcpiNsDumpOneDevice (
  64     ACPI_HANDLE             ObjHandle,
  65     UINT32                  Level,
  66     void                    *Context,
  67     void                    **ReturnValue);
  68 #endif
  69
  70
  71 #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
  72
  73 static ACPI_STATUS
  74 AcpiNsDumpOneObjectPath (
  75     ACPI_HANDLE             ObjHandle,
  76     UINT32                  Level,
  77     void                    *Context,
  78     void                    **ReturnValue);
  79
  80 static ACPI_STATUS
  81 AcpiNsGetMaxDepth (
  82     ACPI_HANDLE             ObjHandle,
  83     UINT32                  Level,
  84     void                    *Context,
  85     void                    **ReturnValue);
  86
  87
  88 /*******************************************************************************
  89  *
  90  * FUNCTION:    AcpiNsPrintPathname
  91  *
  92  * PARAMETERS:  NumSegments         - Number of ACPI name segments
  93  *              Pathname            - The compressed (internal) path
  94  *
  95  * RETURN:      None
  96  *
  97  * DESCRIPTION: Print an object's full namespace pathname
  98  *
  99  ******************************************************************************/
 100
 101 void
 102 AcpiNsPrintPathname (
 103     UINT32                  NumSegments,
 104     char                    *Pathname)
 105 {
 106     UINT32                  i;
 107
 108
 109     ACPI_FUNCTION_NAME (NsPrintPathname);
 110
 111
 112     /* Check if debug output enabled */
 113
 114     if (!ACPI_IS_DEBUG_ENABLED (ACPI_LV_NAMES, ACPI_NAMESPACE))
 115     {
 116         return;
 117     }
 118
 119     /* Print the entire name */
 120
 121     ACPI_DEBUG_PRINT ((ACPI_DB_NAMES, "["));
 122
 123     while (NumSegments)
 124     {
 125         for (i = 0; i < 4; i++)
 126         {
 127             ACPI_IS_PRINT (Pathname[i]) ?
 128                 AcpiOsPrintf ("%c", Pathname[i]) :
 129                 AcpiOsPrintf ("?");
 130         }
 131
 132         Pathname += ACPI_NAME_SIZE;
 133         NumSegments--;
 134         if (NumSegments)
 135         {
 136             AcpiOsPrintf (".");
 137         }
 138     }
 139
 140     AcpiOsPrintf ("]\n");
 141 }
 142
 143
 144 /*******************************************************************************
 145  *
 146  * FUNCTION:    AcpiNsDumpPathname
 147  *
 148  * PARAMETERS:  Handle              - Object
 149  *              Msg                 - Prefix message
 150  *              Level               - Desired debug level
 151  *              Component           - Caller's component ID
 152  *
 153  * RETURN:      None
 154  *
 155  * DESCRIPTION: Print an object's full namespace pathname
 156  *              Manages allocation/freeing of a pathname buffer
 157  *
 158  ******************************************************************************/
 159
 160 void
 161 AcpiNsDumpPathname (
 162     ACPI_HANDLE             Handle,
 163     char                    *Msg,
 164     UINT32                  Level,
 165     UINT32                  Component)
 166 {
 167
 168     ACPI_FUNCTION_TRACE (NsDumpPathname);
 169
 170
 171     /* Do this only if the requested debug level and component are enabled */
 172
 173     if (!ACPI_IS_DEBUG_ENABLED (Level, Component))
 174     {
 175         return_VOID;
 176     }
 177
 178     /* Convert handle to a full pathname and print it (with supplied message) */
 179
 180     AcpiNsPrintNodePathname (Handle, Msg);
 181     AcpiOsPrintf ("\n");
 182     return_VOID;
 183 }
 184
 185
 186 /*******************************************************************************
 187  *
 188  * FUNCTION:    AcpiNsDumpOneObject
 189  *
 190  * PARAMETERS:  ObjHandle           - Node to be dumped
 191  *              Level               - Nesting level of the handle
 192  *              Context             - Passed into WalkNamespace
 193  *              ReturnValue         - Not used
 194  *
 195  * RETURN:      Status
 196  *
 197  * DESCRIPTION: Dump a single Node
 198  *              This procedure is a UserFunction called by AcpiNsWalkNamespace.
 199  *
 200  ******************************************************************************/
 201
 202 ACPI_STATUS
 203 AcpiNsDumpOneObject (
 204     ACPI_HANDLE             ObjHandle,
 205     UINT32                  Level,
 206     void                    *Context,
 207     void                    **ReturnValue)
 208 {
 209     ACPI_WALK_INFO          *Info = (ACPI_WALK_INFO *) Context;
 210     ACPI_NAMESPACE_NODE     *ThisNode;
 211     ACPI_OPERAND_OBJECT     *ObjDesc = NULL;
 212     ACPI_OBJECT_TYPE        ObjType;
 213     ACPI_OBJECT_TYPE        Type;
 214     UINT32                  BytesToDump;
 215     UINT32                  DbgLevel;
 216     UINT32                  i;
 217
 218
 219     ACPI_FUNCTION_NAME (NsDumpOneObject);
 220
 221
 222     /* Is output enabled? */
 223
 224     if (!(AcpiDbgLevel & Info->DebugLevel))
 225     {
 226         return (AE_OK);
 227     }
 228
 229     if (!ObjHandle)
 230     {
 231         ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Null object handle\n"));
 232         return (AE_OK);
 233     }
 234
 235     ThisNode = AcpiNsValidateHandle (ObjHandle);
 236     if (!ThisNode)
 237     {
 238         ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Invalid object handle %p\n",
 239             ObjHandle));
 240         return (AE_OK);
 241     }
 242
 243     Type = ThisNode->Type;
 244
 245     /* Check if the owner matches */
 246
 247     if ((Info->OwnerId != ACPI_OWNER_ID_MAX) &&
 248         (Info->OwnerId != ThisNode->OwnerId))
 249     {
 250         return (AE_OK);
 251     }
 252
 253     if (!(Info->DisplayType & ACPI_DISPLAY_SHORT))
 254     {
 255         /* Indent the object according to the level */
 256
 257         AcpiOsPrintf ("%2d%*s", (UINT32) Level - 1, (int) Level * 2, " ");
 258
 259         /* Check the node type and name */
 260
 261         if (Type > ACPI_TYPE_LOCAL_MAX)
 262         {
 263             ACPI_WARNING ((AE_INFO, "Invalid ACPI Object Type 0x%08X", Type));
 264         }
 265
 266         AcpiOsPrintf ("%4.4s", AcpiUtGetNodeName (ThisNode));
 267     }
 268
 269     /* Now we can print out the pertinent information */
 270
 271     AcpiOsPrintf (" %-12s %p %2.2X ",
 272             AcpiUtGetTypeName (Type), ThisNode, ThisNode->OwnerId);
 273
 274     DbgLevel = AcpiDbgLevel;
 275     AcpiDbgLevel = 0;
 276     ObjDesc = AcpiNsGetAttachedObject (ThisNode);
 277     AcpiDbgLevel = DbgLevel;
 278
 279     /* Temp nodes are those nodes created by a control method */
 280
 281     if (ThisNode->Flags & ANOBJ_TEMPORARY)
 282     {
 283         AcpiOsPrintf ("(T) ");
 284     }
 285
 286     switch (Info->DisplayType & ACPI_DISPLAY_MASK)
 287     {
 288     case ACPI_DISPLAY_SUMMARY:
 289
 290         if (!ObjDesc)
 291         {
 292             /* No attached object. Some types should always have an object */
 293
 294             switch (Type)
 295             {
 296             case ACPI_TYPE_INTEGER:
 297             case ACPI_TYPE_PACKAGE:
 298             case ACPI_TYPE_BUFFER:
 299             case ACPI_TYPE_STRING:
 300             case ACPI_TYPE_METHOD:
 301
 302                 AcpiOsPrintf ("<No attached object>");
 303                 break;
 304
 305             default:
 306
 307                 break;
 308             }
 309
 310             AcpiOsPrintf ("\n");
 311             return (AE_OK);
 312         }
 313
 314         switch (Type)
 315         {
 316         case ACPI_TYPE_PROCESSOR:
 317
 318             AcpiOsPrintf ("ID %02X Len %02X Addr %p\n",
 319                 ObjDesc->Processor.ProcId, ObjDesc->Processor.Length,
 320                 ACPI_CAST_PTR (void, ObjDesc->Processor.Address));
 321             break;
 322
 323         case ACPI_TYPE_DEVICE:
 324
 325             AcpiOsPrintf ("Notify Object: %p\n", ObjDesc);
 326             break;
 327
 328         case ACPI_TYPE_METHOD:
 329
 330             AcpiOsPrintf ("Args %X Len %.4X Aml %p\n",
 331                 (UINT32) ObjDesc->Method.ParamCount,
 332                 ObjDesc->Method.AmlLength, ObjDesc->Method.AmlStart);
 333             break;
 334
 335         case ACPI_TYPE_INTEGER:
 336
 337             AcpiOsPrintf ("= %8.8X%8.8X\n",
 338                 ACPI_FORMAT_UINT64 (ObjDesc->Integer.Value));
 339             break;
 340
 341         case ACPI_TYPE_PACKAGE:
 342
 343             if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
 344             {
 345                 AcpiOsPrintf ("Elements %.2X\n",
 346                     ObjDesc->Package.Count);
 347             }
 348             else
 349             {
 350                 AcpiOsPrintf ("[Length not yet evaluated]\n");
 351             }
 352             break;
 353
 354         case ACPI_TYPE_BUFFER:
 355
 356             if (ObjDesc->Common.Flags & AOPOBJ_DATA_VALID)
 357             {
 358                 AcpiOsPrintf ("Len %.2X",
 359                             ObjDesc->Buffer.Length);
 360
 361                 /* Dump some of the buffer */
 362
 363                 if (ObjDesc->Buffer.Length > 0)
 364                 {
 365                     AcpiOsPrintf (" =");
 366                     for (i = 0; (i < ObjDesc->Buffer.Length && i < 12); i++)
 367                     {
 368                         AcpiOsPrintf (" %.2hX", ObjDesc->Buffer.Pointer[i]);
 369                     }
 370                 }
 371                 AcpiOsPrintf ("\n");
 372             }
 373             else
 374             {
 375                 AcpiOsPrintf ("[Length not yet evaluated]\n");
 376             }
 377             break;
 378
 379         case ACPI_TYPE_STRING:
 380
 381             AcpiOsPrintf ("Len %.2X ", ObjDesc->String.Length);
 382             AcpiUtPrintString (ObjDesc->String.Pointer, 32);
 383             AcpiOsPrintf ("\n");
 384             break;
 385
 386         case ACPI_TYPE_REGION:
 387
 388             AcpiOsPrintf ("[%s]",
 389                 AcpiUtGetRegionName (ObjDesc->Region.SpaceId));
 390             if (ObjDesc->Region.Flags & AOPOBJ_DATA_VALID)
 391             {
 392                 AcpiOsPrintf (" Addr %8.8X%8.8X Len %.4X\n",
 393                     ACPI_FORMAT_NATIVE_UINT (ObjDesc->Region.Address),
 394                     ObjDesc->Region.Length);
 395             }
 396             else
 397             {
 398                 AcpiOsPrintf (" [Address/Length not yet evaluated]\n");
 399             }
 400             break;
 401
 402         case ACPI_TYPE_LOCAL_REFERENCE:
 403
 404             AcpiOsPrintf ("[%s]\n", AcpiUtGetReferenceName (ObjDesc));
 405             break;
 406
 407         case ACPI_TYPE_BUFFER_FIELD:
 408
 409             if (ObjDesc->BufferField.BufferObj &&
 410                 ObjDesc->BufferField.BufferObj->Buffer.Node)
 411             {
 412                 AcpiOsPrintf ("Buf [%4.4s]",
 413                     AcpiUtGetNodeName (
 414                         ObjDesc->BufferField.BufferObj->Buffer.Node));
 415             }
 416             break;
 417
 418         case ACPI_TYPE_LOCAL_REGION_FIELD:
 419
 420             AcpiOsPrintf ("Rgn [%4.4s]",
 421                 AcpiUtGetNodeName (
 422                     ObjDesc->CommonField.RegionObj->Region.Node));
 423             break;
 424
 425         case ACPI_TYPE_LOCAL_BANK_FIELD:
 426
 427             AcpiOsPrintf ("Rgn [%4.4s] Bnk [%4.4s]",
 428                 AcpiUtGetNodeName (
 429                     ObjDesc->CommonField.RegionObj->Region.Node),
 430                 AcpiUtGetNodeName (
 431                     ObjDesc->BankField.BankObj->CommonField.Node));
 432             break;
 433
 434         case ACPI_TYPE_LOCAL_INDEX_FIELD:
 435
 436             AcpiOsPrintf ("Idx [%4.4s] Dat [%4.4s]",
 437                 AcpiUtGetNodeName (
 438                     ObjDesc->IndexField.IndexObj->CommonField.Node),
 439                 AcpiUtGetNodeName (
 440                     ObjDesc->IndexField.DataObj->CommonField.Node));
 441             break;
 442
 443         case ACPI_TYPE_LOCAL_ALIAS:
 444         case ACPI_TYPE_LOCAL_METHOD_ALIAS:
 445
 446             AcpiOsPrintf ("Target %4.4s (%p)\n",
 447                 AcpiUtGetNodeName (ObjDesc), ObjDesc);
 448             break;
 449
 450         default:
 451
 452             AcpiOsPrintf ("Object %p\n", ObjDesc);
 453             break;
 454         }
 455
 456         /* Common field handling */
 457
 458         switch (Type)
 459         {
 460         case ACPI_TYPE_BUFFER_FIELD:
 461         case ACPI_TYPE_LOCAL_REGION_FIELD:
 462         case ACPI_TYPE_LOCAL_BANK_FIELD:
 463         case ACPI_TYPE_LOCAL_INDEX_FIELD:
 464
 465             AcpiOsPrintf (" Off %.3X Len %.2X Acc %.2hd\n",
 466                 (ObjDesc->CommonField.BaseByteOffset * 8)
 467                     + ObjDesc->CommonField.StartFieldBitOffset,
 468                 ObjDesc->CommonField.BitLength,
 469                 ObjDesc->CommonField.AccessByteWidth);
 470             break;
 471
 472         default:
 473
 474             break;
 475         }
 476         break;
 477
 478     case ACPI_DISPLAY_OBJECTS:
 479
 480         AcpiOsPrintf ("O:%p", ObjDesc);
 481         if (!ObjDesc)
 482         {
 483             /* No attached object, we are done */
 484
 485             AcpiOsPrintf ("\n");
 486             return (AE_OK);
 487         }
 488
 489         AcpiOsPrintf ("(R%u)", ObjDesc->Common.ReferenceCount);
 490
 491         switch (Type)
 492         {
 493         case ACPI_TYPE_METHOD:
 494
 495             /* Name is a Method and its AML offset/length are set */
 496
 497             AcpiOsPrintf (" M:%p-%X\n", ObjDesc->Method.AmlStart,
 498                 ObjDesc->Method.AmlLength);
 499             break;
 500
 501         case ACPI_TYPE_INTEGER:
 502
 503             AcpiOsPrintf (" I:%8.8X8.8%X\n",
 504                 ACPI_FORMAT_UINT64 (ObjDesc->Integer.Value));
 505             break;
 506
 507         case ACPI_TYPE_STRING:
 508
 509             AcpiOsPrintf (" S:%p-%X\n", ObjDesc->String.Pointer,
 510                 ObjDesc->String.Length);
 511             break;
 512
 513         case ACPI_TYPE_BUFFER:
 514
 515             AcpiOsPrintf (" B:%p-%X\n", ObjDesc->Buffer.Pointer,
 516                 ObjDesc->Buffer.Length);
 517             break;
 518
 519         default:
 520
 521             AcpiOsPrintf ("\n");
 522             break;
 523         }
 524         break;
 525
 526     default:
 527         AcpiOsPrintf ("\n");
 528         break;
 529     }
 530
 531     /* If debug turned off, done */
 532
 533     if (!(AcpiDbgLevel & ACPI_LV_VALUES))
 534     {
 535         return (AE_OK);
 536     }
 537
 538     /* If there is an attached object, display it */
 539
 540     DbgLevel     = AcpiDbgLevel;
 541     AcpiDbgLevel = 0;
 542     ObjDesc      = AcpiNsGetAttachedObject (ThisNode);
 543     AcpiDbgLevel = DbgLevel;
 544
 545     /* Dump attached objects */
 546
 547     while (ObjDesc)
 548     {
 549         ObjType = ACPI_TYPE_INVALID;
 550         AcpiOsPrintf ("Attached Object %p: ", ObjDesc);
 551
 552         /* Decode the type of attached object and dump the contents */
 553
 554         switch (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc))
 555         {
 556         case ACPI_DESC_TYPE_NAMED:
 557
 558             AcpiOsPrintf ("(Ptr to Node)\n");
 559             BytesToDump = sizeof (ACPI_NAMESPACE_NODE);
 560             ACPI_DUMP_BUFFER (ObjDesc, BytesToDump);
 561             break;
 562
 563         case ACPI_DESC_TYPE_OPERAND:
 564
 565             ObjType = ObjDesc->Common.Type;
 566
 567             if (ObjType > ACPI_TYPE_LOCAL_MAX)
 568             {
 569                 AcpiOsPrintf ("(Pointer to ACPI Object type %.2X [UNKNOWN])\n",
 570                     ObjType);
 571                 BytesToDump = 32;
 572             }
 573             else
 574             {
 575                 AcpiOsPrintf ("(Pointer to ACPI Object type %.2X [%s])\n",
 576                     ObjType, AcpiUtGetTypeName (ObjType));
 577                 BytesToDump = sizeof (ACPI_OPERAND_OBJECT);
 578             }
 579
 580             ACPI_DUMP_BUFFER (ObjDesc, BytesToDump);
 581             break;
 582
 583         default:
 584
 585             break;
 586         }
 587
 588         /* If value is NOT an internal object, we are done */
 589
 590         if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND)
 591         {
 592             goto Cleanup;
 593         }
 594
 595         /* Valid object, get the pointer to next level, if any */
 596
 597         switch (ObjType)
 598         {
 599         case ACPI_TYPE_BUFFER:
 600         case ACPI_TYPE_STRING:
 601             /*
 602              * NOTE: takes advantage of common fields between string/buffer
 603              */
 604             BytesToDump = ObjDesc->String.Length;
 605             ObjDesc = (void *) ObjDesc->String.Pointer;
 606             AcpiOsPrintf ( "(Buffer/String pointer %p length %X)\n",
 607                 ObjDesc, BytesToDump);
 608             ACPI_DUMP_BUFFER (ObjDesc, BytesToDump);
 609             goto Cleanup;
 610
 611         case ACPI_TYPE_BUFFER_FIELD:
 612
 613             ObjDesc = (ACPI_OPERAND_OBJECT *) ObjDesc->BufferField.BufferObj;
 614             break;
 615
 616         case ACPI_TYPE_PACKAGE:
 617
 618             ObjDesc = (void *) ObjDesc->Package.Elements;
 619             break;
 620
 621         case ACPI_TYPE_METHOD:
 622
 623             ObjDesc = (void *) ObjDesc->Method.AmlStart;
 624             break;
 625
 626         case ACPI_TYPE_LOCAL_REGION_FIELD:
 627
 628             ObjDesc = (void *) ObjDesc->Field.RegionObj;
 629             break;
 630
 631         case ACPI_TYPE_LOCAL_BANK_FIELD:
 632
 633             ObjDesc = (void *) ObjDesc->BankField.RegionObj;
 634             break;
 635
 636         case ACPI_TYPE_LOCAL_INDEX_FIELD:
 637
 638             ObjDesc = (void *) ObjDesc->IndexField.IndexObj;
 639             break;
 640
 641         default:
 642
 643             goto Cleanup;
 644         }
 645
 646         ObjType = ACPI_TYPE_INVALID;   /* Terminate loop after next pass */
 647     }
 648
 649 Cleanup:
 650     AcpiOsPrintf ("\n");
 651     return (AE_OK);
 652 }
 653
 654
 655 /*******************************************************************************
 656  *
 657  * FUNCTION:    AcpiNsDumpObjects
 658  *
 659  * PARAMETERS:  Type                - Object type to be dumped
 660  *              DisplayType         - 0 or ACPI_DISPLAY_SUMMARY
 661  *              MaxDepth            - Maximum depth of dump. Use ACPI_UINT32_MAX
 662  *                                    for an effectively unlimited depth.
 663  *              OwnerId             - Dump only objects owned by this ID. Use
 664  *                                    ACPI_UINT32_MAX to match all owners.
 665  *              StartHandle         - Where in namespace to start/end search
 666  *
 667  * RETURN:      None
 668  *
 669  * DESCRIPTION: Dump typed objects within the loaded namespace. Uses
 670  *              AcpiNsWalkNamespace in conjunction with AcpiNsDumpOneObject.
 671  *
 672  ******************************************************************************/
 673
 674 void
 675 AcpiNsDumpObjects (
 676     ACPI_OBJECT_TYPE        Type,
 677     UINT8                   DisplayType,
 678     UINT32                  MaxDepth,
 679     ACPI_OWNER_ID           OwnerId,
 680     ACPI_HANDLE             StartHandle)
 681 {
 682     ACPI_WALK_INFO          Info;
 683     ACPI_STATUS             Status;
 684
 685
 686     ACPI_FUNCTION_ENTRY ();
 687
 688
 689     /*
 690      * Just lock the entire namespace for the duration of the dump.
 691      * We don't want any changes to the namespace during this time,
 692      * especially the temporary nodes since we are going to display
 693      * them also.
 694      */
 695     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
 696     if (ACPI_FAILURE (Status))
 697     {
 698         AcpiOsPrintf ("Could not acquire namespace mutex\n");
 699         return;
 700     }
 701
 702     Info.DebugLevel = ACPI_LV_TABLES;
 703     Info.OwnerId = OwnerId;
 704     Info.DisplayType = DisplayType;
 705
 706     (void) AcpiNsWalkNamespace (Type, StartHandle, MaxDepth,
 707                 ACPI_NS_WALK_NO_UNLOCK | ACPI_NS_WALK_TEMP_NODES,
 708                 AcpiNsDumpOneObject, NULL, (void *) &Info, NULL);
 709
 710     (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
 711 }
 712
 713
 714 /*******************************************************************************
 715  *
 716  * FUNCTION:    AcpiNsDumpOneObjectPath, AcpiNsGetMaxDepth
 717  *
 718  * PARAMETERS:  ObjHandle           - Node to be dumped
 719  *              Level               - Nesting level of the handle
 720  *              Context             - Passed into WalkNamespace
 721  *              ReturnValue         - Not used
 722  *
 723  * RETURN:      Status
 724  *
 725  * DESCRIPTION: Dump the full pathname to a namespace object. AcpNsGetMaxDepth
 726  *              computes the maximum nesting depth in the namespace tree, in
 727  *              order to simplify formatting in AcpiNsDumpOneObjectPath.
 728  *              These procedures are UserFunctions called by AcpiNsWalkNamespace.
 729  *
 730  ******************************************************************************/
 731
 732 static ACPI_STATUS
 733 AcpiNsDumpOneObjectPath (
 734     ACPI_HANDLE             ObjHandle,
 735     UINT32                  Level,
 736     void                    *Context,
 737     void                    **ReturnValue)
 738 {
 739     UINT32                  MaxLevel = *((UINT32 *) Context);
 740     char                    *Pathname;
 741     ACPI_NAMESPACE_NODE     *Node;
 742     int                     PathIndent;
 743
 744
 745     if (!ObjHandle)
 746     {
 747         return (AE_OK);
 748     }
 749
 750     Node = AcpiNsValidateHandle (ObjHandle);
 751     Pathname = AcpiNsGetExternalPathname (Node);
 752
 753     PathIndent = 1;
 754     if (Level <= MaxLevel)
 755     {
 756         PathIndent = MaxLevel - Level + 1;
 757     }
 758
 759     AcpiOsPrintf ("%2d%*s%-12s%*s",
 760         Level, Level, " ", AcpiUtGetTypeName (Node->Type),
 761         PathIndent, " ");
 762
 763     AcpiOsPrintf ("%s\n", &Pathname[1]);
 764     ACPI_FREE (Pathname);
 765     return (AE_OK);
 766 }
 767
 768
 769 static ACPI_STATUS
 770 AcpiNsGetMaxDepth (
 771     ACPI_HANDLE             ObjHandle,
 772     UINT32                  Level,
 773     void                    *Context,
 774     void                    **ReturnValue)
 775 {
 776     UINT32                  *MaxLevel = (UINT32 *) Context;
 777
 778
 779     if (Level > *MaxLevel)
 780     {
 781         *MaxLevel = Level;
 782     }
 783     return (AE_OK);
 784 }
 785
 786
 787 /*******************************************************************************
 788  *
 789  * FUNCTION:    AcpiNsDumpObjectPaths
 790  *
 791  * PARAMETERS:  Type                - Object type to be dumped
 792  *              DisplayType         - 0 or ACPI_DISPLAY_SUMMARY
 793  *              MaxDepth            - Maximum depth of dump. Use ACPI_UINT32_MAX
 794  *                                    for an effectively unlimited depth.
 795  *              OwnerId             - Dump only objects owned by this ID. Use
 796  *                                    ACPI_UINT32_MAX to match all owners.
 797  *              StartHandle         - Where in namespace to start/end search
 798  *
 799  * RETURN:      None
 800  *
 801  * DESCRIPTION: Dump full object pathnames within the loaded namespace. Uses
 802  *              AcpiNsWalkNamespace in conjunction with AcpiNsDumpOneObjectPath.
 803  *
 804  ******************************************************************************/
 805
 806 void
 807 AcpiNsDumpObjectPaths (
 808     ACPI_OBJECT_TYPE        Type,
 809     UINT8                   DisplayType,
 810     UINT32                  MaxDepth,
 811     ACPI_OWNER_ID           OwnerId,
 812     ACPI_HANDLE             StartHandle)
 813 {
 814     ACPI_STATUS             Status;
 815     UINT32                  MaxLevel = 0;
 816
 817
 818     ACPI_FUNCTION_ENTRY ();
 819
 820
 821     /*
 822      * Just lock the entire namespace for the duration of the dump.
 823      * We don't want any changes to the namespace during this time,
 824      * especially the temporary nodes since we are going to display
 825      * them also.
 826      */
 827     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
 828     if (ACPI_FAILURE (Status))
 829     {
 830         AcpiOsPrintf ("Could not acquire namespace mutex\n");
 831         return;
 832     }
 833
 834     /* Get the max depth of the namespace tree, for formatting later */
 835
 836     (void) AcpiNsWalkNamespace (Type, StartHandle, MaxDepth,
 837                 ACPI_NS_WALK_NO_UNLOCK | ACPI_NS_WALK_TEMP_NODES,
 838                 AcpiNsGetMaxDepth, NULL, (void *) &MaxLevel, NULL);
 839
 840     /* Now dump the entire namespace */
 841
 842     (void) AcpiNsWalkNamespace (Type, StartHandle, MaxDepth,
 843                 ACPI_NS_WALK_NO_UNLOCK | ACPI_NS_WALK_TEMP_NODES,
 844                 AcpiNsDumpOneObjectPath, NULL, (void *) &MaxLevel, NULL);
 845
 846     (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
 847 }
 848
 849
 850 /*******************************************************************************
 851  *
 852  * FUNCTION:    AcpiNsDumpEntry
 853  *
 854  * PARAMETERS:  Handle              - Node to be dumped
 855  *              DebugLevel          - Output level
 856  *
 857  * RETURN:      None
 858  *
 859  * DESCRIPTION: Dump a single Node
 860  *
 861  ******************************************************************************/
 862
 863 void
 864 AcpiNsDumpEntry (
 865     ACPI_HANDLE             Handle,
 866     UINT32                  DebugLevel)
 867 {
 868     ACPI_WALK_INFO          Info;
 869
 870
 871     ACPI_FUNCTION_ENTRY ();
 872
 873
 874     Info.DebugLevel = DebugLevel;
 875     Info.OwnerId = ACPI_OWNER_ID_MAX;
 876     Info.DisplayType = ACPI_DISPLAY_SUMMARY;
 877
 878     (void) AcpiNsDumpOneObject (Handle, 1, &Info, NULL);
 879 }
 880
 881
 882 #ifdef ACPI_ASL_COMPILER
 883 /*******************************************************************************
 884  *
 885  * FUNCTION:    AcpiNsDumpTables
 886  *
 887  * PARAMETERS:  SearchBase          - Root of subtree to be dumped, or
 888  *                                    NS_ALL to dump the entire namespace
 889  *              MaxDepth            - Maximum depth of dump. Use INT_MAX
 890  *                                    for an effectively unlimited depth.
 891  *
 892  * RETURN:      None
 893  *
 894  * DESCRIPTION: Dump the name space, or a portion of it.
 895  *
 896  ******************************************************************************/
 897
 898 void
 899 AcpiNsDumpTables (
 900     ACPI_HANDLE             SearchBase,
 901     UINT32                  MaxDepth)
 902 {
 903     ACPI_HANDLE             SearchHandle = SearchBase;
 904
 905
 906     ACPI_FUNCTION_TRACE (NsDumpTables);
 907
 908
 909     if (!AcpiGbl_RootNode)
 910     {
 911         /*
 912          * If the name space has not been initialized,
 913          * there is nothing to dump.
 914          */
 915         ACPI_DEBUG_PRINT ((ACPI_DB_TABLES, "namespace not initialized!\n"));
 916         return_VOID;
 917     }
 918
 919     if (ACPI_NS_ALL == SearchBase)
 920     {
 921         /* Entire namespace */
 922
 923         SearchHandle = AcpiGbl_RootNode;
 924         ACPI_DEBUG_PRINT ((ACPI_DB_TABLES, "\\\n"));
 925     }
 926
 927     AcpiNsDumpObjects (ACPI_TYPE_ANY, ACPI_DISPLAY_OBJECTS, MaxDepth,
 928             ACPI_OWNER_ID_MAX, SearchHandle);
 929     return_VOID;
 930 }
 931 #endif
 932 #endif