1 /****************************************************************************** 2 * 3 * Module Name: exdump - Interpreter debug output routines 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 __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 1106