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