1 /******************************************************************************
2 *
3 * Module Name: exdump - Interpreter debug output routines
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 #define __EXDUMP_C__
45
46 #include "acpi.h"
47 #include "accommon.h"
48 #include "acinterp.h"
49 #include "amlcode.h"
50 #include "acnamesp.h"
51
52
53 #define _COMPONENT ACPI_EXECUTER
54 ACPI_MODULE_NAME ("exdump")
55
56 /*
57 * The following routines are used for debug output only
58 */
59 #if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
60
61 /* Local prototypes */
62
63 static void
64 AcpiExOutString (
65 char *Title,
66 char *Value);
67
68 static void
69 AcpiExOutPointer (
70 char *Title,
71 void *Value);
72
73 static void
74 AcpiExDumpObject (
75 ACPI_OPERAND_OBJECT *ObjDesc,
76 ACPI_EXDUMP_INFO *Info);
77
78 static void
79 AcpiExDumpReferenceObj (
80 ACPI_OPERAND_OBJECT *ObjDesc);
81
82 static void
83 AcpiExDumpPackageObj (
84 ACPI_OPERAND_OBJECT *ObjDesc,
85 UINT32 Level,
86 UINT32 Index);
87
88
89 /*******************************************************************************
90 *
91 * Object Descriptor info tables
92 *
93 * Note: The first table entry must be an INIT opcode and must contain
94 * the table length (number of table entries)
95 *
96 ******************************************************************************/
97
98 static ACPI_EXDUMP_INFO AcpiExDumpInteger[2] =
99 {
100 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpInteger), NULL},
101 {ACPI_EXD_UINT64, ACPI_EXD_OFFSET (Integer.Value), "Value"}
102 };
103
104 static ACPI_EXDUMP_INFO AcpiExDumpString[4] =
105 {
106 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpString), NULL},
107 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (String.Length), "Length"},
108 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (String.Pointer), "Pointer"},
109 {ACPI_EXD_STRING, 0, NULL}
110 };
111
112 static ACPI_EXDUMP_INFO AcpiExDumpBuffer[5] =
113 {
114 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBuffer), NULL},
115 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Buffer.Length), "Length"},
116 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Buffer.Pointer), "Pointer"},
117 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Buffer.Node), "Parent Node"},
118 {ACPI_EXD_BUFFER, 0, NULL}
119 };
120
121 static ACPI_EXDUMP_INFO AcpiExDumpPackage[5] =
122 {
123 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpPackage), NULL},
124 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Package.Flags), "Flags"},
125 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Package.Count), "Elements"},
126 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Package.Elements), "Element List"},
127 {ACPI_EXD_PACKAGE, 0, NULL}
128 };
129
130 static ACPI_EXDUMP_INFO AcpiExDumpDevice[4] =
131 {
132 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpDevice), NULL},
133 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Device.Handler), "Handler"},
134 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Device.NotifyList[0]), "System Notify"},
135 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Device.NotifyList[1]), "Device Notify"}
136 };
137
138 static ACPI_EXDUMP_INFO AcpiExDumpEvent[2] =
139 {
140 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpEvent), NULL},
141 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Event.OsSemaphore), "OsSemaphore"}
142 };
143
144 static ACPI_EXDUMP_INFO AcpiExDumpMethod[9] =
145 {
146 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpMethod), NULL},
147 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.InfoFlags), "Info Flags"},
148 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.ParamCount), "Parameter Count"},
149 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.SyncLevel), "Sync Level"},
150 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Method.Mutex), "Mutex"},
151 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.OwnerId), "Owner Id"},
152 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Method.ThreadCount), "Thread Count"},
153 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Method.AmlLength), "Aml Length"},
154 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Method.AmlStart), "Aml Start"}
155 };
156
157 static ACPI_EXDUMP_INFO AcpiExDumpMutex[5] =
158 {
159 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpMutex), NULL},
160 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Mutex.SyncLevel), "Sync Level"},
161 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Mutex.OwnerThread), "Owner Thread"},
162 {ACPI_EXD_UINT16, ACPI_EXD_OFFSET (Mutex.AcquisitionDepth), "Acquire Depth"},
163 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Mutex.OsMutex), "OsMutex"}
164 };
165
166 static ACPI_EXDUMP_INFO AcpiExDumpRegion[7] =
167 {
168 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpRegion), NULL},
169 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Region.SpaceId), "Space Id"},
170 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Region.Flags), "Flags"},
171 {ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET (Region.Address), "Address"},
172 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Region.Length), "Length"},
173 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Region.Handler), "Handler"},
174 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Region.Next), "Next"}
175 };
176
177 static ACPI_EXDUMP_INFO AcpiExDumpPower[5] =
178 {
179 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpPower), NULL},
180 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (PowerResource.SystemLevel), "System Level"},
181 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (PowerResource.ResourceOrder), "Resource Order"},
182 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (PowerResource.NotifyList[0]), "System Notify"},
183 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (PowerResource.NotifyList[1]), "Device Notify"}
184 };
185
186 static ACPI_EXDUMP_INFO AcpiExDumpProcessor[7] =
187 {
188 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpProcessor), NULL},
189 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Processor.ProcId), "Processor ID"},
190 {ACPI_EXD_UINT8 , ACPI_EXD_OFFSET (Processor.Length), "Length"},
191 {ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET (Processor.Address), "Address"},
192 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Processor.NotifyList[0]), "System Notify"},
193 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Processor.NotifyList[1]), "Device Notify"},
194 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Processor.Handler), "Handler"}
195 };
196
197 static ACPI_EXDUMP_INFO AcpiExDumpThermal[4] =
198 {
199 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpThermal), NULL},
200 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (ThermalZone.NotifyList[0]), "System Notify"},
201 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (ThermalZone.NotifyList[1]), "Device Notify"},
202 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (ThermalZone.Handler), "Handler"}
203 };
204
205 static ACPI_EXDUMP_INFO AcpiExDumpBufferField[3] =
206 {
207 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBufferField), NULL},
208 {ACPI_EXD_FIELD, 0, NULL},
209 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (BufferField.BufferObj), "Buffer Object"}
210 };
211
212 static ACPI_EXDUMP_INFO AcpiExDumpRegionField[5] =
213 {
214 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpRegionField), NULL},
215 {ACPI_EXD_FIELD, 0, NULL},
216 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Field.AccessLength), "AccessLength"},
217 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Field.RegionObj), "Region Object"},
218 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Field.ResourceBuffer), "ResourceBuffer"}
219 };
220
221 static ACPI_EXDUMP_INFO AcpiExDumpBankField[5] =
222 {
223 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBankField), NULL},
224 {ACPI_EXD_FIELD, 0, NULL},
225 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (BankField.Value), "Value"},
226 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (BankField.RegionObj), "Region Object"},
227 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (BankField.BankObj), "Bank Object"}
228 };
229
230 static ACPI_EXDUMP_INFO AcpiExDumpIndexField[5] =
231 {
232 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpBankField), NULL},
233 {ACPI_EXD_FIELD, 0, NULL},
234 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (IndexField.Value), "Value"},
235 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (IndexField.IndexObj), "Index Object"},
236 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (IndexField.DataObj), "Data Object"}
237 };
238
239 static ACPI_EXDUMP_INFO AcpiExDumpReference[8] =
240 {
241 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpReference), NULL},
242 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Reference.Class), "Class"},
243 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Reference.TargetType), "Target Type"},
244 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Reference.Value), "Value"},
245 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Reference.Object), "Object Desc"},
246 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Reference.Node), "Node"},
247 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Reference.Where), "Where"},
248 {ACPI_EXD_REFERENCE,0, NULL}
249 };
250
251 static ACPI_EXDUMP_INFO AcpiExDumpAddressHandler[6] =
252 {
253 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpAddressHandler), NULL},
254 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (AddressSpace.SpaceId), "Space Id"},
255 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.Next), "Next"},
256 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.RegionList), "Region List"},
257 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.Node), "Node"},
258 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (AddressSpace.Context), "Context"}
259 };
260
261 static ACPI_EXDUMP_INFO AcpiExDumpNotify[7] =
262 {
263 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpNotify), NULL},
264 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Node), "Node"},
265 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (Notify.HandlerType), "Handler Type"},
266 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Handler), "Handler"},
267 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Context), "Context"},
268 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Next[0]), "Next System Notify"},
269 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (Notify.Next[1]), "Next Device Notify"}
270 };
271
272
273 /* Miscellaneous tables */
274
275 static ACPI_EXDUMP_INFO AcpiExDumpCommon[4] =
276 {
277 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpCommon), NULL},
278 {ACPI_EXD_TYPE , 0, NULL},
279 {ACPI_EXD_UINT16, ACPI_EXD_OFFSET (Common.ReferenceCount), "Reference Count"},
280 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (Common.Flags), "Flags"}
281 };
282
283 static ACPI_EXDUMP_INFO AcpiExDumpFieldCommon[7] =
284 {
285 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpFieldCommon), NULL},
286 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (CommonField.FieldFlags), "Field Flags"},
287 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (CommonField.AccessByteWidth), "Access Byte Width"},
288 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (CommonField.BitLength), "Bit Length"},
289 {ACPI_EXD_UINT8, ACPI_EXD_OFFSET (CommonField.StartFieldBitOffset),"Field Bit Offset"},
290 {ACPI_EXD_UINT32, ACPI_EXD_OFFSET (CommonField.BaseByteOffset), "Base Byte Offset"},
291 {ACPI_EXD_POINTER, ACPI_EXD_OFFSET (CommonField.Node), "Parent Node"}
292 };
293
294 static ACPI_EXDUMP_INFO AcpiExDumpNode[5] =
295 {
296 {ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE (AcpiExDumpNode), NULL},
297 {ACPI_EXD_UINT8, ACPI_EXD_NSOFFSET (Flags), "Flags"},
298 {ACPI_EXD_UINT8, ACPI_EXD_NSOFFSET (OwnerId), "Owner Id"},
299 {ACPI_EXD_POINTER, ACPI_EXD_NSOFFSET (Child), "Child List"},
300 {ACPI_EXD_POINTER, ACPI_EXD_NSOFFSET (Peer), "Next Peer"}
301 };
302
303
304 /* Dispatch table, indexed by object type */
305
306 static ACPI_EXDUMP_INFO *AcpiExDumpInfo[] =
307 {
308 NULL,
309 AcpiExDumpInteger,
310 AcpiExDumpString,
311 AcpiExDumpBuffer,
312 AcpiExDumpPackage,
313 NULL,
314 AcpiExDumpDevice,
315 AcpiExDumpEvent,
316 AcpiExDumpMethod,
317 AcpiExDumpMutex,
318 AcpiExDumpRegion,
319 AcpiExDumpPower,
320 AcpiExDumpProcessor,
321 AcpiExDumpThermal,
322 AcpiExDumpBufferField,
323 NULL,
324 NULL,
325 AcpiExDumpRegionField,
326 AcpiExDumpBankField,
327 AcpiExDumpIndexField,
328 AcpiExDumpReference,
329 NULL,
330 NULL,
331 AcpiExDumpNotify,
332 AcpiExDumpAddressHandler,
333 NULL,
334 NULL,
335 NULL
336 };
337
338
339 /*******************************************************************************
340 *
341 * FUNCTION: AcpiExDumpObject
342 *
343 * PARAMETERS: ObjDesc - Descriptor to dump
344 * Info - Info table corresponding to this object
345 * type
346 *
347 * RETURN: None
348 *
349 * DESCRIPTION: Walk the info table for this object
350 *
351 ******************************************************************************/
352
353 static void
354 AcpiExDumpObject (
355 ACPI_OPERAND_OBJECT *ObjDesc,
356 ACPI_EXDUMP_INFO *Info)
357 {
358 UINT8 *Target;
359 char *Name;
360 const char *ReferenceName;
361 UINT8 Count;
362
363
364 if (!Info)
365 {
366 AcpiOsPrintf (
367 "ExDumpObject: Display not implemented for object type %s\n",
368 AcpiUtGetObjectTypeName (ObjDesc));
369 return;
370 }
371
372 /* First table entry must contain the table length (# of table entries) */
373
374 Count = Info->Offset;
375
376 while (Count)
377 {
378 Target = ACPI_ADD_PTR (UINT8, ObjDesc, Info->Offset);
379 Name = Info->Name;
380
381 switch (Info->Opcode)
382 {
383 case ACPI_EXD_INIT:
384
385 break;
386
387 case ACPI_EXD_TYPE:
388
389 AcpiExOutString ("Type", AcpiUtGetObjectTypeName (ObjDesc));
390 break;
391
392 case ACPI_EXD_UINT8:
393
394 AcpiOsPrintf ("%20s : %2.2X\n", Name, *Target);
395 break;
396
397 case ACPI_EXD_UINT16:
398
399 AcpiOsPrintf ("%20s : %4.4X\n", Name, ACPI_GET16 (Target));
400 break;
401
402 case ACPI_EXD_UINT32:
403
404 AcpiOsPrintf ("%20s : %8.8X\n", Name, ACPI_GET32 (Target));
405 break;
406
407 case ACPI_EXD_UINT64:
408
409 AcpiOsPrintf ("%20s : %8.8X%8.8X\n", "Value",
410 ACPI_FORMAT_UINT64 (ACPI_GET64 (Target)));
411 break;
412
413 case ACPI_EXD_POINTER:
414 case ACPI_EXD_ADDRESS:
415
416 AcpiExOutPointer (Name, *ACPI_CAST_PTR (void *, Target));
417 break;
418
419 case ACPI_EXD_STRING:
420
421 AcpiUtPrintString (ObjDesc->String.Pointer, ACPI_UINT8_MAX);
422 AcpiOsPrintf ("\n");
423 break;
424
425 case ACPI_EXD_BUFFER:
426
427 ACPI_DUMP_BUFFER (ObjDesc->Buffer.Pointer, ObjDesc->Buffer.Length);
428 break;
429
430 case ACPI_EXD_PACKAGE:
431
432 /* Dump the package contents */
433
434 AcpiOsPrintf ("\nPackage Contents:\n");
435 AcpiExDumpPackageObj (ObjDesc, 0, 0);
436 break;
437
438 case ACPI_EXD_FIELD:
439
440 AcpiExDumpObject (ObjDesc, AcpiExDumpFieldCommon);
441 break;
442
443 case ACPI_EXD_REFERENCE:
444
445 ReferenceName = AcpiUtGetReferenceName (ObjDesc);
446 AcpiExOutString ("Class Name", ACPI_CAST_PTR (char, ReferenceName));
447 AcpiExDumpReferenceObj (ObjDesc);
448 break;
449
450 default:
451
452 AcpiOsPrintf ("**** Invalid table opcode [%X] ****\n",
453 Info->Opcode);
454 return;
455 }
456
457 Info++;
458 Count--;
459 }
460 }
461
462
463 /*******************************************************************************
464 *
465 * FUNCTION: AcpiExDumpOperand
466 *
467 * PARAMETERS: *ObjDesc - Pointer to entry to be dumped
468 * Depth - Current nesting depth
469 *
470 * RETURN: None
471 *
472 * DESCRIPTION: Dump an operand object
473 *
474 ******************************************************************************/
475
476 void
477 AcpiExDumpOperand (
478 ACPI_OPERAND_OBJECT *ObjDesc,
479 UINT32 Depth)
480 {
481 UINT32 Length;
482 UINT32 Index;
483
484
485 ACPI_FUNCTION_NAME (ExDumpOperand)
486
487
488 /* Check if debug output enabled */
489
490 if (!ACPI_IS_DEBUG_ENABLED (ACPI_LV_EXEC, _COMPONENT))
491 {
492 return;
493 }
494
495 if (!ObjDesc)
496 {
497 /* This could be a null element of a package */
498
499 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Null Object Descriptor\n"));
500 return;
501 }
502
503 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) == ACPI_DESC_TYPE_NAMED)
504 {
505 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%p Namespace Node: ", ObjDesc));
506 ACPI_DUMP_ENTRY (ObjDesc, ACPI_LV_EXEC);
507 return;
508 }
509
510 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND)
511 {
512 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
513 "%p is not a node or operand object: [%s]\n",
514 ObjDesc, AcpiUtGetDescriptorName (ObjDesc)));
515 ACPI_DUMP_BUFFER (ObjDesc, sizeof (ACPI_OPERAND_OBJECT));
516 return;
517 }
518
519 /* ObjDesc is a valid object */
520
521 if (Depth > 0)
522 {
523 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%*s[%u] %p ",
524 Depth, " ", Depth, ObjDesc));
525 }
526 else
527 {
528 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%p ", ObjDesc));
529 }
530
531 /* Decode object type */
532
533 switch (ObjDesc->Common.Type)
534 {
535 case ACPI_TYPE_LOCAL_REFERENCE:
536
537 AcpiOsPrintf ("Reference: [%s] ", AcpiUtGetReferenceName (ObjDesc));
538
539 switch (ObjDesc->Reference.Class)
540 {
541 case ACPI_REFCLASS_DEBUG:
542
543 AcpiOsPrintf ("\n");
544 break;
545
546 case ACPI_REFCLASS_INDEX:
547
548 AcpiOsPrintf ("%p\n", ObjDesc->Reference.Object);
549 break;
550
551 case ACPI_REFCLASS_TABLE:
552
553 AcpiOsPrintf ("Table Index %X\n", ObjDesc->Reference.Value);
554 break;
555
556 case ACPI_REFCLASS_REFOF:
557
558 AcpiOsPrintf ("%p [%s]\n", ObjDesc->Reference.Object,
559 AcpiUtGetTypeName (((ACPI_OPERAND_OBJECT *)
560 ObjDesc->Reference.Object)->Common.Type));
561 break;
562
563 case ACPI_REFCLASS_NAME:
564
565 AcpiOsPrintf ("- [%4.4s]\n", ObjDesc->Reference.Node->Name.Ascii);
566 break;
567
568 case ACPI_REFCLASS_ARG:
569 case ACPI_REFCLASS_LOCAL:
570
571 AcpiOsPrintf ("%X\n", ObjDesc->Reference.Value);
572 break;
573
574 default: /* Unknown reference class */
575
576 AcpiOsPrintf ("%2.2X\n", ObjDesc->Reference.Class);
577 break;
578 }
579 break;
580
581 case ACPI_TYPE_BUFFER:
582
583 AcpiOsPrintf ("Buffer length %.2X @ %p\n",
584 ObjDesc->Buffer.Length, ObjDesc->Buffer.Pointer);
585
586 /* Debug only -- dump the buffer contents */
587
588 if (ObjDesc->Buffer.Pointer)
589 {
590 Length = ObjDesc->Buffer.Length;
591 if (Length > 128)
592 {
593 Length = 128;
594 }
595
596 AcpiOsPrintf ("Buffer Contents: (displaying length 0x%.2X)\n",
597 Length);
598 ACPI_DUMP_BUFFER (ObjDesc->Buffer.Pointer, Length);
599 }
600 break;
601
602 case ACPI_TYPE_INTEGER:
603
604 AcpiOsPrintf ("Integer %8.8X%8.8X\n",
605 ACPI_FORMAT_UINT64 (ObjDesc->Integer.Value));
606 break;
607
608 case ACPI_TYPE_PACKAGE:
609
610 AcpiOsPrintf ("Package [Len %X] ElementArray %p\n",
611 ObjDesc->Package.Count, ObjDesc->Package.Elements);
612
613 /*
614 * If elements exist, package element pointer is valid,
615 * and debug_level exceeds 1, dump package's elements.
616 */
617 if (ObjDesc->Package.Count &&
618 ObjDesc->Package.Elements &&
619 AcpiDbgLevel > 1)
620 {
621 for (Index = 0; Index < ObjDesc->Package.Count; Index++)
622 {
623 AcpiExDumpOperand (ObjDesc->Package.Elements[Index], Depth+1);
624 }
625 }
626 break;
627
628 case ACPI_TYPE_REGION:
629
630 AcpiOsPrintf ("Region %s (%X)",
631 AcpiUtGetRegionName (ObjDesc->Region.SpaceId),
632 ObjDesc->Region.SpaceId);
633
634 /*
635 * If the address and length have not been evaluated,
636 * don't print them.
637 */
638 if (!(ObjDesc->Region.Flags & AOPOBJ_DATA_VALID))
639 {
640 AcpiOsPrintf ("\n");
641 }
642 else
643 {
644 AcpiOsPrintf (" base %8.8X%8.8X Length %X\n",
645 ACPI_FORMAT_NATIVE_UINT (ObjDesc->Region.Address),
646 ObjDesc->Region.Length);
647 }
648 break;
649
650 case ACPI_TYPE_STRING:
651
652 AcpiOsPrintf ("String length %X @ %p ",
653 ObjDesc->String.Length,
654 ObjDesc->String.Pointer);
655
656 AcpiUtPrintString (ObjDesc->String.Pointer, ACPI_UINT8_MAX);
657 AcpiOsPrintf ("\n");
658 break;
659
660 case ACPI_TYPE_LOCAL_BANK_FIELD:
661
662 AcpiOsPrintf ("BankField\n");
663 break;
664
665 case ACPI_TYPE_LOCAL_REGION_FIELD:
666
667 AcpiOsPrintf ("RegionField: Bits=%X AccWidth=%X Lock=%X Update=%X at "
668 "byte=%X bit=%X of below:\n",
669 ObjDesc->Field.BitLength,
670 ObjDesc->Field.AccessByteWidth,
671 ObjDesc->Field.FieldFlags & AML_FIELD_LOCK_RULE_MASK,
672 ObjDesc->Field.FieldFlags & AML_FIELD_UPDATE_RULE_MASK,
673 ObjDesc->Field.BaseByteOffset,
674 ObjDesc->Field.StartFieldBitOffset);
675
676 AcpiExDumpOperand (ObjDesc->Field.RegionObj, Depth+1);
677 break;
678
679 case ACPI_TYPE_LOCAL_INDEX_FIELD:
680
681 AcpiOsPrintf ("IndexField\n");
682 break;
683
684 case ACPI_TYPE_BUFFER_FIELD:
685
686 AcpiOsPrintf ("BufferField: %X bits at byte %X bit %X of\n",
687 ObjDesc->BufferField.BitLength,
688 ObjDesc->BufferField.BaseByteOffset,
689 ObjDesc->BufferField.StartFieldBitOffset);
690
691 if (!ObjDesc->BufferField.BufferObj)
692 {
693 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "*NULL*\n"));
694 }
695 else if ((ObjDesc->BufferField.BufferObj)->Common.Type !=
696 ACPI_TYPE_BUFFER)
697 {
698 AcpiOsPrintf ("*not a Buffer*\n");
699 }
700 else
701 {
702 AcpiExDumpOperand (ObjDesc->BufferField.BufferObj, Depth+1);
703 }
704 break;
705
706 case ACPI_TYPE_EVENT:
707
708 AcpiOsPrintf ("Event\n");
709 break;
710
711 case ACPI_TYPE_METHOD:
712
713 AcpiOsPrintf ("Method(%X) @ %p:%X\n",
714 ObjDesc->Method.ParamCount,
715 ObjDesc->Method.AmlStart,
716 ObjDesc->Method.AmlLength);
717 break;
718
719 case ACPI_TYPE_MUTEX:
720
721 AcpiOsPrintf ("Mutex\n");
722 break;
723
724 case ACPI_TYPE_DEVICE:
725
726 AcpiOsPrintf ("Device\n");
727 break;
728
729 case ACPI_TYPE_POWER:
730
731 AcpiOsPrintf ("Power\n");
732 break;
733
734 case ACPI_TYPE_PROCESSOR:
735
736 AcpiOsPrintf ("Processor\n");
737 break;
738
739 case ACPI_TYPE_THERMAL:
740
741 AcpiOsPrintf ("Thermal\n");
742 break;
743
744 default:
745
746 /* Unknown Type */
747
748 AcpiOsPrintf ("Unknown Type %X\n", ObjDesc->Common.Type);
749 break;
750 }
751
752 return;
753 }
754
755
756 /*******************************************************************************
757 *
758 * FUNCTION: AcpiExDumpOperands
759 *
760 * PARAMETERS: Operands - A list of Operand objects
761 * OpcodeName - AML opcode name
762 * NumOperands - Operand count for this opcode
763 *
764 * DESCRIPTION: Dump the operands associated with the opcode
765 *
766 ******************************************************************************/
767
768 void
769 AcpiExDumpOperands (
770 ACPI_OPERAND_OBJECT **Operands,
771 const char *OpcodeName,
772 UINT32 NumOperands)
773 {
774 ACPI_FUNCTION_NAME (ExDumpOperands);
775
776
777 if (!OpcodeName)
778 {
779 OpcodeName = "UNKNOWN";
780 }
781
782 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
783 "**** Start operand dump for opcode [%s], %u operands\n",
784 OpcodeName, NumOperands));
785
786 if (NumOperands == 0)
787 {
788 NumOperands = 1;
789 }
790
791 /* Dump the individual operands */
792
793 while (NumOperands)
794 {
795 AcpiExDumpOperand (*Operands, 0);
796 Operands++;
797 NumOperands--;
798 }
799
800 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
801 "**** End operand dump for [%s]\n", OpcodeName));
802 return;
803 }
804
805
806 /*******************************************************************************
807 *
808 * FUNCTION: AcpiExOut* functions
809 *
810 * PARAMETERS: Title - Descriptive text
811 * Value - Value to be displayed
812 *
813 * DESCRIPTION: Object dump output formatting functions. These functions
814 * reduce the number of format strings required and keeps them
815 * all in one place for easy modification.
816 *
817 ******************************************************************************/
818
819 static void
820 AcpiExOutString (
821 char *Title,
822 char *Value)
823 {
824 AcpiOsPrintf ("%20s : %s\n", Title, Value);
825 }
826
827 static void
828 AcpiExOutPointer (
829 char *Title,
830 void *Value)
831 {
832 AcpiOsPrintf ("%20s : %p\n", Title, Value);
833 }
834
835
836 /*******************************************************************************
837 *
838 * FUNCTION: AcpiExDumpNamespaceNode
839 *
840 * PARAMETERS: Node - Descriptor to dump
841 * Flags - Force display if TRUE
842 *
843 * DESCRIPTION: Dumps the members of the given.Node
844 *
845 ******************************************************************************/
846
847 void
848 AcpiExDumpNamespaceNode (
849 ACPI_NAMESPACE_NODE *Node,
850 UINT32 Flags)
851 {
852
853 ACPI_FUNCTION_ENTRY ();
854
855
856 if (!Flags)
857 {
858 /* Check if debug output enabled */
859
860 if (!ACPI_IS_DEBUG_ENABLED (ACPI_LV_OBJECTS, _COMPONENT))
861 {
862 return;
863 }
864 }
865
866 AcpiOsPrintf ("%20s : %4.4s\n", "Name", AcpiUtGetNodeName (Node));
867 AcpiExOutString ("Type", AcpiUtGetTypeName (Node->Type));
868 AcpiExOutPointer ("Attached Object", AcpiNsGetAttachedObject (Node));
869 AcpiExOutPointer ("Parent", Node->Parent);
870
871 AcpiExDumpObject (ACPI_CAST_PTR (ACPI_OPERAND_OBJECT, Node),
872 AcpiExDumpNode);
873 }
874
875
876 /*******************************************************************************
877 *
878 * FUNCTION: AcpiExDumpReferenceObj
879 *
880 * PARAMETERS: Object - Descriptor to dump
881 *
882 * DESCRIPTION: Dumps a reference object
883 *
884 ******************************************************************************/
885
886 static void
887 AcpiExDumpReferenceObj (
888 ACPI_OPERAND_OBJECT *ObjDesc)
889 {
890 ACPI_BUFFER RetBuf;
891 ACPI_STATUS Status;
892
893
894 RetBuf.Length = ACPI_ALLOCATE_LOCAL_BUFFER;
895
896 if (ObjDesc->Reference.Class == ACPI_REFCLASS_NAME)
897 {
898 AcpiOsPrintf (" %p ", ObjDesc->Reference.Node);
899
900 Status = AcpiNsHandleToPathname (ObjDesc->Reference.Node, &RetBuf);
901 if (ACPI_FAILURE (Status))
902 {
903 AcpiOsPrintf (" Could not convert name to pathname\n");
904 }
905 else
906 {
907 AcpiOsPrintf ("%s\n", (char *) RetBuf.Pointer);
908 ACPI_FREE (RetBuf.Pointer);
909 }
910 }
911 else if (ObjDesc->Reference.Object)
912 {
913 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) == ACPI_DESC_TYPE_OPERAND)
914 {
915 AcpiOsPrintf (" Target: %p", ObjDesc->Reference.Object);
916 if (ObjDesc->Reference.Class == ACPI_REFCLASS_TABLE)
917 {
918 AcpiOsPrintf (" Table Index: %X\n", ObjDesc->Reference.Value);
919 }
920 else
921 {
922 AcpiOsPrintf (" Target: %p [%s]\n", ObjDesc->Reference.Object,
923 AcpiUtGetTypeName (((ACPI_OPERAND_OBJECT *)
924 ObjDesc->Reference.Object)->Common.Type));
925 }
926 }
927 else
928 {
929 AcpiOsPrintf (" Target: %p\n", ObjDesc->Reference.Object);
930 }
931 }
932 }
933
934
935 /*******************************************************************************
936 *
937 * FUNCTION: AcpiExDumpPackageObj
938 *
939 * PARAMETERS: ObjDesc - Descriptor to dump
940 * Level - Indentation Level
941 * Index - Package index for this object
942 *
943 * DESCRIPTION: Dumps the elements of the package
944 *
945 ******************************************************************************/
946
947 static void
948 AcpiExDumpPackageObj (
949 ACPI_OPERAND_OBJECT *ObjDesc,
950 UINT32 Level,
951 UINT32 Index)
952 {
953 UINT32 i;
954
955
956 /* Indentation and index output */
957
958 if (Level > 0)
959 {
960 for (i = 0; i < Level; i++)
961 {
962 AcpiOsPrintf (" ");
963 }
964
965 AcpiOsPrintf ("[%.2d] ", Index);
966 }
967
968 AcpiOsPrintf ("%p ", ObjDesc);
969
970 /* Null package elements are allowed */
971
972 if (!ObjDesc)
973 {
974 AcpiOsPrintf ("[Null Object]\n");
975 return;
976 }
977
978 /* Packages may only contain a few object types */
979
980 switch (ObjDesc->Common.Type)
981 {
982 case ACPI_TYPE_INTEGER:
983
984 AcpiOsPrintf ("[Integer] = %8.8X%8.8X\n",
985 ACPI_FORMAT_UINT64 (ObjDesc->Integer.Value));
986 break;
987
988 case ACPI_TYPE_STRING:
989
990 AcpiOsPrintf ("[String] Value: ");
991 AcpiUtPrintString (ObjDesc->String.Pointer, ACPI_UINT8_MAX);
992 AcpiOsPrintf ("\n");
993 break;
994
995 case ACPI_TYPE_BUFFER:
996
997 AcpiOsPrintf ("[Buffer] Length %.2X = ", ObjDesc->Buffer.Length);
998 if (ObjDesc->Buffer.Length)
999 {
1000 AcpiUtDebugDumpBuffer (ACPI_CAST_PTR (UINT8, ObjDesc->Buffer.Pointer),
1001 ObjDesc->Buffer.Length, DB_DWORD_DISPLAY, _COMPONENT);
1002 }
1003 else
1004 {
1005 AcpiOsPrintf ("\n");
1006 }
1007 break;
1008
1009 case ACPI_TYPE_PACKAGE:
1010
1011 AcpiOsPrintf ("[Package] Contains %u Elements:\n",
1012 ObjDesc->Package.Count);
1013
1014 for (i = 0; i < ObjDesc->Package.Count; i++)
1015 {
1016 AcpiExDumpPackageObj (ObjDesc->Package.Elements[i], Level+1, i);
1017 }
1018 break;
1019
1020 case ACPI_TYPE_LOCAL_REFERENCE:
1021
1022 AcpiOsPrintf ("[Object Reference] Type [%s] %2.2X",
1023 AcpiUtGetReferenceName (ObjDesc),
1024 ObjDesc->Reference.Class);
1025 AcpiExDumpReferenceObj (ObjDesc);
1026 break;
1027
1028 default:
1029
1030 AcpiOsPrintf ("[Unknown Type] %X\n", ObjDesc->Common.Type);
1031 break;
1032 }
1033 }
1034
1035
1036 /*******************************************************************************
1037 *
1038 * FUNCTION: AcpiExDumpObjectDescriptor
1039 *
1040 * PARAMETERS: ObjDesc - Descriptor to dump
1041 * Flags - Force display if TRUE
1042 *
1043 * DESCRIPTION: Dumps the members of the object descriptor given.
1044 *
1045 ******************************************************************************/
1046
1047 void
1048 AcpiExDumpObjectDescriptor (
1049 ACPI_OPERAND_OBJECT *ObjDesc,
1050 UINT32 Flags)
1051 {
1052 ACPI_FUNCTION_TRACE (ExDumpObjectDescriptor);
1053
1054
1055 if (!ObjDesc)
1056 {
1057 return_VOID;
1058 }
1059
1060 if (!Flags)
1061 {
1062 /* Check if debug output enabled */
1063
1064 if (!ACPI_IS_DEBUG_ENABLED (ACPI_LV_OBJECTS, _COMPONENT))
1065 {
1066 return_VOID;
1067 }
1068 }
1069
1070 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) == ACPI_DESC_TYPE_NAMED)
1071 {
1072 AcpiExDumpNamespaceNode ((ACPI_NAMESPACE_NODE *) ObjDesc, Flags);
1073
1074 AcpiOsPrintf ("\nAttached Object (%p):\n",
1075 ((ACPI_NAMESPACE_NODE *) ObjDesc)->Object);
1076
1077 AcpiExDumpObjectDescriptor (
1078 ((ACPI_NAMESPACE_NODE *) ObjDesc)->Object, Flags);
1079 return_VOID;
1080 }
1081
1082 if (ACPI_GET_DESCRIPTOR_TYPE (ObjDesc) != ACPI_DESC_TYPE_OPERAND)
1083 {
1084 AcpiOsPrintf (
1085 "ExDumpObjectDescriptor: %p is not an ACPI operand object: [%s]\n",
1086 ObjDesc, AcpiUtGetDescriptorName (ObjDesc));
1087 return_VOID;
1088 }
1089
1090 if (ObjDesc->Common.Type > ACPI_TYPE_NS_NODE_MAX)
1091 {
1092 return_VOID;
1093 }
1094
1095 /* Common Fields */
1096
1097 AcpiExDumpObject (ObjDesc, AcpiExDumpCommon);
1098
1099 /* Object-specific fields */
1100
1101 AcpiExDumpObject (ObjDesc, AcpiExDumpInfo[ObjDesc->Common.Type]);
1102 return_VOID;
1103 }
1104
1105 #endif