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