Linux Audio

Check our new training course

Loading...
v3.5.6
 
   1/******************************************************************************
   2 *
   3 * Module Name: exdump - Interpreter debug output routines
   4 *
   5 *****************************************************************************/
   6
   7/*
   8 * Copyright (C) 2000 - 2012, Intel Corp.
   9 * All rights reserved.
  10 *
  11 * Redistribution and use in source and binary forms, with or without
  12 * modification, are permitted provided that the following conditions
  13 * are met:
  14 * 1. Redistributions of source code must retain the above copyright
  15 *    notice, this list of conditions, and the following disclaimer,
  16 *    without modification.
  17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
  18 *    substantially similar to the "NO WARRANTY" disclaimer below
  19 *    ("Disclaimer") and any redistribution must be conditioned upon
  20 *    including a substantially similar Disclaimer requirement for further
  21 *    binary redistribution.
  22 * 3. Neither the names of the above-listed copyright holders nor the names
  23 *    of any contributors may be used to endorse or promote products derived
  24 *    from this software without specific prior written permission.
  25 *
  26 * Alternatively, this software may be distributed under the terms of the
  27 * GNU General Public License ("GPL") version 2 as published by the Free
  28 * Software Foundation.
  29 *
  30 * NO WARRANTY
  31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
  34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
  40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  41 * POSSIBILITY OF SUCH DAMAGES.
  42 */
  43
  44#include <acpi/acpi.h>
  45#include "accommon.h"
  46#include "acinterp.h"
  47#include "amlcode.h"
  48#include "acnamesp.h"
  49
  50#define _COMPONENT          ACPI_EXECUTER
  51ACPI_MODULE_NAME("exdump")
  52
  53/*
  54 * The following routines are used for debug output only
  55 */
  56#if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
  57/* Local prototypes */
  58static void acpi_ex_out_string(char *title, char *value);
  59
  60static void acpi_ex_out_pointer(char *title, void *value);
  61
  62static void
  63acpi_ex_dump_object(union acpi_operand_object *obj_desc,
  64		    struct acpi_exdump_info *info);
  65
  66static void acpi_ex_dump_reference_obj(union acpi_operand_object *obj_desc);
  67
  68static void
  69acpi_ex_dump_package_obj(union acpi_operand_object *obj_desc,
  70			 u32 level, u32 index);
  71
  72/*******************************************************************************
  73 *
  74 * Object Descriptor info tables
  75 *
  76 * Note: The first table entry must be an INIT opcode and must contain
  77 * the table length (number of table entries)
  78 *
  79 ******************************************************************************/
  80
  81static struct acpi_exdump_info acpi_ex_dump_integer[2] = {
  82	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_integer), NULL},
  83	{ACPI_EXD_UINT64, ACPI_EXD_OFFSET(integer.value), "Value"}
  84};
  85
  86static struct acpi_exdump_info acpi_ex_dump_string[4] = {
  87	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_string), NULL},
  88	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(string.length), "Length"},
  89	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(string.pointer), "Pointer"},
  90	{ACPI_EXD_STRING, 0, NULL}
  91};
  92
  93static struct acpi_exdump_info acpi_ex_dump_buffer[5] = {
  94	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_buffer), NULL},
  95	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(buffer.length), "Length"},
  96	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(buffer.pointer), "Pointer"},
  97	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(buffer.node), "Parent Node"},
  98	{ACPI_EXD_BUFFER, 0, NULL}
  99};
 100
 101static struct acpi_exdump_info acpi_ex_dump_package[5] = {
 102	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_package), NULL},
 
 103	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(package.flags), "Flags"},
 104	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(package.count), "Elements"},
 105	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(package.elements), "Element List"},
 106	{ACPI_EXD_PACKAGE, 0, NULL}
 107};
 108
 109static struct acpi_exdump_info acpi_ex_dump_device[4] = {
 110	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_device), NULL},
 111	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(device.handler), "Handler"},
 112	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(device.system_notify),
 113	 "System Notify"},
 114	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(device.device_notify),
 115	 "Device Notify"}
 
 116};
 117
 118static struct acpi_exdump_info acpi_ex_dump_event[2] = {
 119	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_event), NULL},
 120	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(event.os_semaphore), "OsSemaphore"}
 121};
 122
 123static struct acpi_exdump_info acpi_ex_dump_method[9] = {
 124	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_method), NULL},
 125	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.info_flags), "Info Flags"},
 126	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.param_count),
 127	 "Parameter Count"},
 128	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.sync_level), "Sync Level"},
 129	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(method.mutex), "Mutex"},
 130	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.owner_id), "Owner Id"},
 131	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.thread_count), "Thread Count"},
 132	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(method.aml_length), "Aml Length"},
 133	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(method.aml_start), "Aml Start"}
 134};
 135
 136static struct acpi_exdump_info acpi_ex_dump_mutex[5] = {
 137	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_mutex), NULL},
 138	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(mutex.sync_level), "Sync Level"},
 
 
 139	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(mutex.owner_thread), "Owner Thread"},
 140	{ACPI_EXD_UINT16, ACPI_EXD_OFFSET(mutex.acquisition_depth),
 141	 "Acquire Depth"},
 142	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(mutex.os_mutex), "OsMutex"}
 143};
 144
 145static struct acpi_exdump_info acpi_ex_dump_region[7] = {
 146	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_region), NULL},
 147	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(region.space_id), "Space Id"},
 148	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(region.flags), "Flags"},
 
 149	{ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET(region.address), "Address"},
 150	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(region.length), "Length"},
 151	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(region.handler), "Handler"},
 152	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(region.next), "Next"}
 153};
 154
 155static struct acpi_exdump_info acpi_ex_dump_power[5] = {
 156	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_power), NULL},
 157	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(power_resource.system_level),
 158	 "System Level"},
 159	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(power_resource.resource_order),
 160	 "Resource Order"},
 161	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(power_resource.system_notify),
 162	 "System Notify"},
 163	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(power_resource.device_notify),
 164	 "Device Notify"}
 
 165};
 166
 167static struct acpi_exdump_info acpi_ex_dump_processor[7] = {
 168	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_processor), NULL},
 169	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(processor.proc_id), "Processor ID"},
 170	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(processor.length), "Length"},
 171	{ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET(processor.address), "Address"},
 172	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(processor.system_notify),
 173	 "System Notify"},
 174	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(processor.device_notify),
 175	 "Device Notify"},
 176	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(processor.handler), "Handler"}
 177};
 178
 179static struct acpi_exdump_info acpi_ex_dump_thermal[4] = {
 180	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_thermal), NULL},
 181	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(thermal_zone.system_notify),
 182	 "System Notify"},
 183	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(thermal_zone.device_notify),
 184	 "Device Notify"},
 185	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(thermal_zone.handler), "Handler"}
 186};
 187
 188static struct acpi_exdump_info acpi_ex_dump_buffer_field[3] = {
 189	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_buffer_field), NULL},
 190	{ACPI_EXD_FIELD, 0, NULL},
 191	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(buffer_field.buffer_obj),
 192	 "Buffer Object"}
 193};
 194
 195static struct acpi_exdump_info acpi_ex_dump_region_field[5] = {
 196	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_region_field), NULL},
 197	{ACPI_EXD_FIELD, 0, NULL},
 198	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(field.access_length), "AccessLength"},
 199	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(field.region_obj), "Region Object"},
 200	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(field.resource_buffer),
 201	 "ResourceBuffer"}
 202};
 203
 204static struct acpi_exdump_info acpi_ex_dump_bank_field[5] = {
 205	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_bank_field), NULL},
 206	{ACPI_EXD_FIELD, 0, NULL},
 207	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(bank_field.value), "Value"},
 208	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(bank_field.region_obj),
 209	 "Region Object"},
 210	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(bank_field.bank_obj), "Bank Object"}
 211};
 212
 213static struct acpi_exdump_info acpi_ex_dump_index_field[5] = {
 214	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_bank_field), NULL},
 215	{ACPI_EXD_FIELD, 0, NULL},
 216	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(index_field.value), "Value"},
 217	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(index_field.index_obj),
 218	 "Index Object"},
 219	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(index_field.data_obj), "Data Object"}
 220};
 221
 222static struct acpi_exdump_info acpi_ex_dump_reference[8] = {
 223	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_reference), NULL},
 224	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(reference.class), "Class"},
 225	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(reference.target_type), "Target Type"},
 226	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(reference.value), "Value"},
 227	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(reference.object), "Object Desc"},
 228	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(reference.node), "Node"},
 229	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(reference.where), "Where"},
 
 
 230	{ACPI_EXD_REFERENCE, 0, NULL}
 231};
 232
 233static struct acpi_exdump_info acpi_ex_dump_address_handler[6] = {
 234	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_address_handler),
 235	 NULL},
 236	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(address_space.space_id), "Space Id"},
 237	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(address_space.next), "Next"},
 238	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(address_space.region_list),
 239	 "Region List"},
 240	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(address_space.node), "Node"},
 241	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(address_space.context), "Context"}
 242};
 243
 244static struct acpi_exdump_info acpi_ex_dump_notify[3] = {
 245	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_notify), NULL},
 246	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(notify.node), "Node"},
 247	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(notify.context), "Context"}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 248};
 249
 250/* Miscellaneous tables */
 251
 252static struct acpi_exdump_info acpi_ex_dump_common[4] = {
 253	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_common), NULL},
 254	{ACPI_EXD_TYPE, 0, NULL},
 255	{ACPI_EXD_UINT16, ACPI_EXD_OFFSET(common.reference_count),
 256	 "Reference Count"},
 257	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common.flags), "Flags"}
 
 258};
 259
 260static struct acpi_exdump_info acpi_ex_dump_field_common[7] = {
 261	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_field_common), NULL},
 262	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common_field.field_flags),
 263	 "Field Flags"},
 264	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common_field.access_byte_width),
 265	 "Access Byte Width"},
 266	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(common_field.bit_length),
 267	 "Bit Length"},
 268	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common_field.start_field_bit_offset),
 269	 "Field Bit Offset"},
 270	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(common_field.base_byte_offset),
 271	 "Base Byte Offset"},
 272	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(common_field.node), "Parent Node"}
 273};
 274
 275static struct acpi_exdump_info acpi_ex_dump_node[5] = {
 276	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_node), NULL},
 277	{ACPI_EXD_UINT8, ACPI_EXD_NSOFFSET(flags), "Flags"},
 278	{ACPI_EXD_UINT8, ACPI_EXD_NSOFFSET(owner_id), "Owner Id"},
 279	{ACPI_EXD_POINTER, ACPI_EXD_NSOFFSET(child), "Child List"},
 280	{ACPI_EXD_POINTER, ACPI_EXD_NSOFFSET(peer), "Next Peer"}
 
 
 281};
 282
 283/* Dispatch table, indexed by object type */
 284
 285static struct acpi_exdump_info *acpi_ex_dump_info[] = {
 286	NULL,
 287	acpi_ex_dump_integer,
 288	acpi_ex_dump_string,
 289	acpi_ex_dump_buffer,
 290	acpi_ex_dump_package,
 291	NULL,
 292	acpi_ex_dump_device,
 293	acpi_ex_dump_event,
 294	acpi_ex_dump_method,
 295	acpi_ex_dump_mutex,
 296	acpi_ex_dump_region,
 297	acpi_ex_dump_power,
 298	acpi_ex_dump_processor,
 299	acpi_ex_dump_thermal,
 300	acpi_ex_dump_buffer_field,
 301	NULL,
 302	NULL,
 303	acpi_ex_dump_region_field,
 304	acpi_ex_dump_bank_field,
 305	acpi_ex_dump_index_field,
 306	acpi_ex_dump_reference,
 307	NULL,
 308	NULL,
 309	acpi_ex_dump_notify,
 310	acpi_ex_dump_address_handler,
 311	NULL,
 312	NULL,
 313	NULL
 
 
 314};
 315
 316/*******************************************************************************
 317 *
 318 * FUNCTION:    acpi_ex_dump_object
 319 *
 320 * PARAMETERS:  obj_desc            - Descriptor to dump
 321 *              Info                - Info table corresponding to this object
 322 *                                    type
 323 *
 324 * RETURN:      None
 325 *
 326 * DESCRIPTION: Walk the info table for this object
 327 *
 328 ******************************************************************************/
 329
 330static void
 331acpi_ex_dump_object(union acpi_operand_object *obj_desc,
 332		    struct acpi_exdump_info *info)
 333{
 334	u8 *target;
 335	char *name;
 336	u8 count;
 
 
 
 
 337
 338	if (!info) {
 339		acpi_os_printf
 340		    ("ExDumpObject: Display not implemented for object type %s\n",
 341		     acpi_ut_get_object_type_name(obj_desc));
 342		return;
 343	}
 344
 345	/* First table entry must contain the table length (# of table entries) */
 346
 347	count = info->offset;
 348
 349	while (count) {
 
 
 
 
 350		target = ACPI_ADD_PTR(u8, obj_desc, info->offset);
 351		name = info->name;
 352
 353		switch (info->opcode) {
 354		case ACPI_EXD_INIT:
 
 355			break;
 356
 357		case ACPI_EXD_TYPE:
 358
 359			acpi_ex_out_string("Type",
 360					   acpi_ut_get_object_type_name
 361					   (obj_desc));
 362			break;
 363
 364		case ACPI_EXD_UINT8:
 365
 366			acpi_os_printf("%20s : %2.2X\n", name, *target);
 367			break;
 368
 369		case ACPI_EXD_UINT16:
 370
 371			acpi_os_printf("%20s : %4.4X\n", name,
 372				       ACPI_GET16(target));
 373			break;
 374
 375		case ACPI_EXD_UINT32:
 376
 377			acpi_os_printf("%20s : %8.8X\n", name,
 378				       ACPI_GET32(target));
 379			break;
 380
 381		case ACPI_EXD_UINT64:
 382
 383			acpi_os_printf("%20s : %8.8X%8.8X\n", "Value",
 384				       ACPI_FORMAT_UINT64(ACPI_GET64(target)));
 385			break;
 386
 387		case ACPI_EXD_POINTER:
 388		case ACPI_EXD_ADDRESS:
 389
 390			acpi_ex_out_pointer(name,
 391					    *ACPI_CAST_PTR(void *, target));
 392			break;
 393
 394		case ACPI_EXD_STRING:
 395
 396			acpi_ut_print_string(obj_desc->string.pointer,
 397					     ACPI_UINT8_MAX);
 398			acpi_os_printf("\n");
 399			break;
 400
 401		case ACPI_EXD_BUFFER:
 402
 403			ACPI_DUMP_BUFFER(obj_desc->buffer.pointer,
 404					 obj_desc->buffer.length);
 405			break;
 406
 407		case ACPI_EXD_PACKAGE:
 408
 409			/* Dump the package contents */
 410
 411			acpi_os_printf("\nPackage Contents:\n");
 412			acpi_ex_dump_package_obj(obj_desc, 0, 0);
 413			break;
 414
 415		case ACPI_EXD_FIELD:
 416
 417			acpi_ex_dump_object(obj_desc,
 418					    acpi_ex_dump_field_common);
 419			break;
 420
 421		case ACPI_EXD_REFERENCE:
 422
 423			acpi_ex_out_string("Class Name",
 424					   ACPI_CAST_PTR(char,
 425							 acpi_ut_get_reference_name
 426							 (obj_desc)));
 427			acpi_ex_dump_reference_obj(obj_desc);
 428			break;
 429
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 430		default:
 431
 432			acpi_os_printf("**** Invalid table opcode [%X] ****\n",
 433				       info->opcode);
 434			return;
 435		}
 436
 437		info++;
 438		count--;
 439	}
 440}
 441
 442/*******************************************************************************
 443 *
 444 * FUNCTION:    acpi_ex_dump_operand
 445 *
 446 * PARAMETERS:  *obj_desc       - Pointer to entry to be dumped
 447 *              Depth           - Current nesting depth
 448 *
 449 * RETURN:      None
 450 *
 451 * DESCRIPTION: Dump an operand object
 452 *
 453 ******************************************************************************/
 454
 455void acpi_ex_dump_operand(union acpi_operand_object *obj_desc, u32 depth)
 456{
 457	u32 length;
 458	u32 index;
 459
 460	ACPI_FUNCTION_NAME(ex_dump_operand)
 461
 462	    if (!((ACPI_LV_EXEC & acpi_dbg_level)
 463		  && (_COMPONENT & acpi_dbg_layer))) {
 
 464		return;
 465	}
 466
 467	if (!obj_desc) {
 468
 469		/* This could be a null element of a package */
 470
 471		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Null Object Descriptor\n"));
 472		return;
 473	}
 474
 475	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) == ACPI_DESC_TYPE_NAMED) {
 476		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%p Namespace Node: ",
 477				  obj_desc));
 478		ACPI_DUMP_ENTRY(obj_desc, ACPI_LV_EXEC);
 479		return;
 480	}
 481
 482	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) != ACPI_DESC_TYPE_OPERAND) {
 483		ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 484				  "%p is not a node or operand object: [%s]\n",
 485				  obj_desc,
 486				  acpi_ut_get_descriptor_name(obj_desc)));
 487		ACPI_DUMP_BUFFER(obj_desc, sizeof(union acpi_operand_object));
 488		return;
 489	}
 490
 491	/* obj_desc is a valid object */
 492
 493	if (depth > 0) {
 494		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%*s[%u] %p ",
 495				  depth, " ", depth, obj_desc));
 
 496	} else {
 497		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%p ", obj_desc));
 
 498	}
 499
 500	/* Decode object type */
 501
 502	switch (obj_desc->common.type) {
 503	case ACPI_TYPE_LOCAL_REFERENCE:
 504
 505		acpi_os_printf("Reference: [%s] ",
 506			       acpi_ut_get_reference_name(obj_desc));
 507
 508		switch (obj_desc->reference.class) {
 509		case ACPI_REFCLASS_DEBUG:
 510
 511			acpi_os_printf("\n");
 512			break;
 513
 514		case ACPI_REFCLASS_INDEX:
 515
 516			acpi_os_printf("%p\n", obj_desc->reference.object);
 517			break;
 518
 519		case ACPI_REFCLASS_TABLE:
 520
 521			acpi_os_printf("Table Index %X\n",
 522				       obj_desc->reference.value);
 523			break;
 524
 525		case ACPI_REFCLASS_REFOF:
 526
 527			acpi_os_printf("%p [%s]\n", obj_desc->reference.object,
 528				       acpi_ut_get_type_name(((union
 529							       acpi_operand_object
 530							       *)
 531							      obj_desc->
 532							      reference.
 533							      object)->common.
 534							     type));
 535			break;
 536
 537		case ACPI_REFCLASS_NAME:
 538
 539			acpi_os_printf("- [%4.4s]\n",
 540				       obj_desc->reference.node->name.ascii);
 
 
 
 541			break;
 542
 543		case ACPI_REFCLASS_ARG:
 544		case ACPI_REFCLASS_LOCAL:
 545
 546			acpi_os_printf("%X\n", obj_desc->reference.value);
 547			break;
 548
 549		default:	/* Unknown reference class */
 550
 551			acpi_os_printf("%2.2X\n", obj_desc->reference.class);
 552			break;
 553		}
 554		break;
 555
 556	case ACPI_TYPE_BUFFER:
 557
 558		acpi_os_printf("Buffer length %.2X @ %p\n",
 559			       obj_desc->buffer.length,
 560			       obj_desc->buffer.pointer);
 561
 562		/* Debug only -- dump the buffer contents */
 563
 564		if (obj_desc->buffer.pointer) {
 565			length = obj_desc->buffer.length;
 566			if (length > 128) {
 567				length = 128;
 568			}
 569
 570			acpi_os_printf
 571			    ("Buffer Contents: (displaying length 0x%.2X)\n",
 572			     length);
 573			ACPI_DUMP_BUFFER(obj_desc->buffer.pointer, length);
 574		}
 575		break;
 576
 577	case ACPI_TYPE_INTEGER:
 578
 579		acpi_os_printf("Integer %8.8X%8.8X\n",
 580			       ACPI_FORMAT_UINT64(obj_desc->integer.value));
 581		break;
 582
 583	case ACPI_TYPE_PACKAGE:
 584
 585		acpi_os_printf("Package [Len %X] ElementArray %p\n",
 586			       obj_desc->package.count,
 587			       obj_desc->package.elements);
 588
 589		/*
 590		 * If elements exist, package element pointer is valid,
 591		 * and debug_level exceeds 1, dump package's elements.
 592		 */
 593		if (obj_desc->package.count &&
 594		    obj_desc->package.elements && acpi_dbg_level > 1) {
 595			for (index = 0; index < obj_desc->package.count;
 596			     index++) {
 597				acpi_ex_dump_operand(obj_desc->package.
 598						     elements[index],
 599						     depth + 1);
 600			}
 601		}
 602		break;
 603
 604	case ACPI_TYPE_REGION:
 605
 606		acpi_os_printf("Region %s (%X)",
 607			       acpi_ut_get_region_name(obj_desc->region.
 608						       space_id),
 609			       obj_desc->region.space_id);
 610
 611		/*
 612		 * If the address and length have not been evaluated,
 613		 * don't print them.
 614		 */
 615		if (!(obj_desc->region.flags & AOPOBJ_DATA_VALID)) {
 616			acpi_os_printf("\n");
 617		} else {
 618			acpi_os_printf(" base %8.8X%8.8X Length %X\n",
 619				       ACPI_FORMAT_NATIVE_UINT(obj_desc->region.
 620							       address),
 621				       obj_desc->region.length);
 622		}
 623		break;
 624
 625	case ACPI_TYPE_STRING:
 626
 627		acpi_os_printf("String length %X @ %p ",
 628			       obj_desc->string.length,
 629			       obj_desc->string.pointer);
 630
 631		acpi_ut_print_string(obj_desc->string.pointer, ACPI_UINT8_MAX);
 632		acpi_os_printf("\n");
 633		break;
 634
 635	case ACPI_TYPE_LOCAL_BANK_FIELD:
 636
 637		acpi_os_printf("BankField\n");
 638		break;
 639
 640	case ACPI_TYPE_LOCAL_REGION_FIELD:
 641
 642		acpi_os_printf
 643		    ("RegionField: Bits=%X AccWidth=%X Lock=%X Update=%X at "
 644		     "byte=%X bit=%X of below:\n", obj_desc->field.bit_length,
 645		     obj_desc->field.access_byte_width,
 646		     obj_desc->field.field_flags & AML_FIELD_LOCK_RULE_MASK,
 647		     obj_desc->field.field_flags & AML_FIELD_UPDATE_RULE_MASK,
 648		     obj_desc->field.base_byte_offset,
 649		     obj_desc->field.start_field_bit_offset);
 650
 651		acpi_ex_dump_operand(obj_desc->field.region_obj, depth + 1);
 652		break;
 653
 654	case ACPI_TYPE_LOCAL_INDEX_FIELD:
 655
 656		acpi_os_printf("IndexField\n");
 657		break;
 658
 659	case ACPI_TYPE_BUFFER_FIELD:
 660
 661		acpi_os_printf("BufferField: %X bits at byte %X bit %X of\n",
 662			       obj_desc->buffer_field.bit_length,
 663			       obj_desc->buffer_field.base_byte_offset,
 664			       obj_desc->buffer_field.start_field_bit_offset);
 665
 666		if (!obj_desc->buffer_field.buffer_obj) {
 667			ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "*NULL*\n"));
 668		} else if ((obj_desc->buffer_field.buffer_obj)->common.type !=
 669			   ACPI_TYPE_BUFFER) {
 670			acpi_os_printf("*not a Buffer*\n");
 671		} else {
 672			acpi_ex_dump_operand(obj_desc->buffer_field.buffer_obj,
 673					     depth + 1);
 674		}
 675		break;
 676
 677	case ACPI_TYPE_EVENT:
 678
 679		acpi_os_printf("Event\n");
 680		break;
 681
 682	case ACPI_TYPE_METHOD:
 683
 684		acpi_os_printf("Method(%X) @ %p:%X\n",
 685			       obj_desc->method.param_count,
 686			       obj_desc->method.aml_start,
 687			       obj_desc->method.aml_length);
 688		break;
 689
 690	case ACPI_TYPE_MUTEX:
 691
 692		acpi_os_printf("Mutex\n");
 693		break;
 694
 695	case ACPI_TYPE_DEVICE:
 696
 697		acpi_os_printf("Device\n");
 698		break;
 699
 700	case ACPI_TYPE_POWER:
 701
 702		acpi_os_printf("Power\n");
 703		break;
 704
 705	case ACPI_TYPE_PROCESSOR:
 706
 707		acpi_os_printf("Processor\n");
 708		break;
 709
 710	case ACPI_TYPE_THERMAL:
 711
 712		acpi_os_printf("Thermal\n");
 713		break;
 714
 715	default:
 
 716		/* Unknown Type */
 717
 718		acpi_os_printf("Unknown Type %X\n", obj_desc->common.type);
 719		break;
 720	}
 721
 722	return;
 723}
 724
 725/*******************************************************************************
 726 *
 727 * FUNCTION:    acpi_ex_dump_operands
 728 *
 729 * PARAMETERS:	Operands	    - A list of Operand objects
 730 *		opcode_name	    - AML opcode name
 731 *		num_operands	    - Operand count for this opcode
 732 *
 733 * DESCRIPTION: Dump the operands associated with the opcode
 734 *
 735 ******************************************************************************/
 736
 737void
 738acpi_ex_dump_operands(union acpi_operand_object **operands,
 739		      const char *opcode_name, u32 num_operands)
 740{
 741	ACPI_FUNCTION_NAME(ex_dump_operands);
 742
 743	if (!opcode_name) {
 744		opcode_name = "UNKNOWN";
 745	}
 746
 747	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 748			  "**** Start operand dump for opcode [%s], %u operands\n",
 749			  opcode_name, num_operands));
 750
 751	if (num_operands == 0) {
 752		num_operands = 1;
 753	}
 754
 755	/* Dump the individual operands */
 756
 757	while (num_operands) {
 758		acpi_ex_dump_operand(*operands, 0);
 759		operands++;
 760		num_operands--;
 761	}
 762
 763	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 764			  "**** End operand dump for [%s]\n", opcode_name));
 765	return;
 766}
 767
 768/*******************************************************************************
 769 *
 770 * FUNCTION:    acpi_ex_out* functions
 771 *
 772 * PARAMETERS:  Title               - Descriptive text
 773 *              Value               - Value to be displayed
 774 *
 775 * DESCRIPTION: Object dump output formatting functions.  These functions
 776 *              reduce the number of format strings required and keeps them
 777 *              all in one place for easy modification.
 778 *
 779 ******************************************************************************/
 780
 781static void acpi_ex_out_string(char *title, char *value)
 782{
 783	acpi_os_printf("%20s : %s\n", title, value);
 784}
 785
 786static void acpi_ex_out_pointer(char *title, void *value)
 787{
 788	acpi_os_printf("%20s : %p\n", title, value);
 789}
 790
 791/*******************************************************************************
 792 *
 793 * FUNCTION:    acpi_ex_dump_namespace_node
 794 *
 795 * PARAMETERS:  Node                - Descriptor to dump
 796 *              Flags               - Force display if TRUE
 797 *
 798 * DESCRIPTION: Dumps the members of the given.Node
 799 *
 800 ******************************************************************************/
 801
 802void acpi_ex_dump_namespace_node(struct acpi_namespace_node *node, u32 flags)
 803{
 804
 805	ACPI_FUNCTION_ENTRY();
 806
 807	if (!flags) {
 808		if (!((ACPI_LV_OBJECTS & acpi_dbg_level)
 809		      && (_COMPONENT & acpi_dbg_layer))) {
 
 
 810			return;
 811		}
 812	}
 813
 814	acpi_os_printf("%20s : %4.4s\n", "Name", acpi_ut_get_node_name(node));
 815	acpi_ex_out_string("Type", acpi_ut_get_type_name(node->type));
 816	acpi_ex_out_pointer("Attached Object",
 817			    acpi_ns_get_attached_object(node));
 818	acpi_ex_out_pointer("Parent", node->parent);
 819
 820	acpi_ex_dump_object(ACPI_CAST_PTR(union acpi_operand_object, node),
 821			    acpi_ex_dump_node);
 822}
 823
 824/*******************************************************************************
 825 *
 826 * FUNCTION:    acpi_ex_dump_reference_obj
 827 *
 828 * PARAMETERS:  Object              - Descriptor to dump
 829 *
 830 * DESCRIPTION: Dumps a reference object
 831 *
 832 ******************************************************************************/
 833
 834static void acpi_ex_dump_reference_obj(union acpi_operand_object *obj_desc)
 835{
 836	struct acpi_buffer ret_buf;
 837	acpi_status status;
 838
 839	ret_buf.length = ACPI_ALLOCATE_LOCAL_BUFFER;
 840
 841	if (obj_desc->reference.class == ACPI_REFCLASS_NAME) {
 842		acpi_os_printf(" %p ", obj_desc->reference.node);
 843
 844		status =
 845		    acpi_ns_handle_to_pathname(obj_desc->reference.node,
 846					       &ret_buf);
 847		if (ACPI_FAILURE(status)) {
 848			acpi_os_printf(" Could not convert name to pathname\n");
 
 
 849		} else {
 850			acpi_os_printf("%s\n", (char *)ret_buf.pointer);
 
 
 
 
 851			ACPI_FREE(ret_buf.pointer);
 852		}
 853	} else if (obj_desc->reference.object) {
 854		if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) ==
 855		    ACPI_DESC_TYPE_OPERAND) {
 856			acpi_os_printf(" Target: %p",
 857				       obj_desc->reference.object);
 858			if (obj_desc->reference.class == ACPI_REFCLASS_TABLE) {
 859				acpi_os_printf(" Table Index: %X\n",
 860					       obj_desc->reference.value);
 861			} else {
 862				acpi_os_printf(" Target: %p [%s]\n",
 863					       obj_desc->reference.object,
 864					       acpi_ut_get_type_name(((union
 865								       acpi_operand_object
 866								       *)
 867								      obj_desc->
 868								      reference.
 869								      object)->
 870								     common.
 871								     type));
 872			}
 873		} else {
 874			acpi_os_printf(" Target: %p\n",
 875				       obj_desc->reference.object);
 876		}
 877	}
 878}
 879
 880/*******************************************************************************
 881 *
 882 * FUNCTION:    acpi_ex_dump_package_obj
 883 *
 884 * PARAMETERS:  obj_desc            - Descriptor to dump
 885 *              Level               - Indentation Level
 886 *              Index               - Package index for this object
 887 *
 888 * DESCRIPTION: Dumps the elements of the package
 889 *
 890 ******************************************************************************/
 891
 892static void
 893acpi_ex_dump_package_obj(union acpi_operand_object *obj_desc,
 894			 u32 level, u32 index)
 895{
 896	u32 i;
 897
 898	/* Indentation and index output */
 899
 900	if (level > 0) {
 901		for (i = 0; i < level; i++) {
 902			acpi_os_printf(" ");
 903		}
 904
 905		acpi_os_printf("[%.2d] ", index);
 906	}
 907
 908	acpi_os_printf("%p ", obj_desc);
 909
 910	/* Null package elements are allowed */
 911
 912	if (!obj_desc) {
 913		acpi_os_printf("[Null Object]\n");
 914		return;
 915	}
 916
 917	/* Packages may only contain a few object types */
 918
 919	switch (obj_desc->common.type) {
 920	case ACPI_TYPE_INTEGER:
 921
 922		acpi_os_printf("[Integer] = %8.8X%8.8X\n",
 923			       ACPI_FORMAT_UINT64(obj_desc->integer.value));
 924		break;
 925
 926	case ACPI_TYPE_STRING:
 927
 928		acpi_os_printf("[String] Value: ");
 929		for (i = 0; i < obj_desc->string.length; i++) {
 930			acpi_os_printf("%c", obj_desc->string.pointer[i]);
 931		}
 932		acpi_os_printf("\n");
 933		break;
 934
 935	case ACPI_TYPE_BUFFER:
 936
 937		acpi_os_printf("[Buffer] Length %.2X = ",
 938			       obj_desc->buffer.length);
 939		if (obj_desc->buffer.length) {
 940			acpi_ut_dump_buffer(ACPI_CAST_PTR
 941					    (u8, obj_desc->buffer.pointer),
 942					    obj_desc->buffer.length,
 943					    DB_DWORD_DISPLAY, _COMPONENT);
 
 944		} else {
 945			acpi_os_printf("\n");
 946		}
 947		break;
 948
 949	case ACPI_TYPE_PACKAGE:
 950
 951		acpi_os_printf("[Package] Contains %u Elements:\n",
 952			       obj_desc->package.count);
 953
 954		for (i = 0; i < obj_desc->package.count; i++) {
 955			acpi_ex_dump_package_obj(obj_desc->package.elements[i],
 956						 level + 1, i);
 957		}
 958		break;
 959
 960	case ACPI_TYPE_LOCAL_REFERENCE:
 961
 962		acpi_os_printf("[Object Reference] Type [%s] %2.2X",
 963			       acpi_ut_get_reference_name(obj_desc),
 964			       obj_desc->reference.class);
 965		acpi_ex_dump_reference_obj(obj_desc);
 966		break;
 967
 968	default:
 969
 970		acpi_os_printf("[Unknown Type] %X\n", obj_desc->common.type);
 
 
 971		break;
 972	}
 973}
 974
 975/*******************************************************************************
 976 *
 977 * FUNCTION:    acpi_ex_dump_object_descriptor
 978 *
 979 * PARAMETERS:  obj_desc            - Descriptor to dump
 980 *              Flags               - Force display if TRUE
 981 *
 982 * DESCRIPTION: Dumps the members of the object descriptor given.
 983 *
 984 ******************************************************************************/
 985
 986void
 987acpi_ex_dump_object_descriptor(union acpi_operand_object *obj_desc, u32 flags)
 988{
 989	ACPI_FUNCTION_TRACE(ex_dump_object_descriptor);
 990
 991	if (!obj_desc) {
 992		return_VOID;
 993	}
 994
 995	if (!flags) {
 996		if (!((ACPI_LV_OBJECTS & acpi_dbg_level)
 997		      && (_COMPONENT & acpi_dbg_layer))) {
 
 
 998			return_VOID;
 999		}
1000	}
1001
1002	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) == ACPI_DESC_TYPE_NAMED) {
1003		acpi_ex_dump_namespace_node((struct acpi_namespace_node *)
1004					    obj_desc, flags);
1005
1006		acpi_os_printf("\nAttached Object (%p):\n",
1007			       ((struct acpi_namespace_node *)obj_desc)->
1008			       object);
 
 
 
 
 
 
1009
1010		acpi_ex_dump_object_descriptor(((struct acpi_namespace_node *)
1011						obj_desc)->object, flags);
1012		return_VOID;
1013	}
1014
1015	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) != ACPI_DESC_TYPE_OPERAND) {
1016		acpi_os_printf
1017		    ("ExDumpObjectDescriptor: %p is not an ACPI operand object: [%s]\n",
1018		     obj_desc, acpi_ut_get_descriptor_name(obj_desc));
1019		return_VOID;
1020	}
1021
1022	if (obj_desc->common.type > ACPI_TYPE_NS_NODE_MAX) {
 
 
 
 
 
 
 
 
 
 
1023		return_VOID;
1024	}
1025
1026	/* Common Fields */
1027
1028	acpi_ex_dump_object(obj_desc, acpi_ex_dump_common);
1029
1030	/* Object-specific fields */
1031
1032	acpi_ex_dump_object(obj_desc, acpi_ex_dump_info[obj_desc->common.type]);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1033	return_VOID;
1034}
1035
1036#endif
v5.4
   1// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
   2/******************************************************************************
   3 *
   4 * Module Name: exdump - Interpreter debug output routines
   5 *
   6 * Copyright (C) 2000 - 2019, Intel Corp.
 
 
 
 
   7 *
   8 *****************************************************************************/
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
   9
  10#include <acpi/acpi.h>
  11#include "accommon.h"
  12#include "acinterp.h"
  13#include "amlcode.h"
  14#include "acnamesp.h"
  15
  16#define _COMPONENT          ACPI_EXECUTER
  17ACPI_MODULE_NAME("exdump")
  18
  19/*
  20 * The following routines are used for debug output only
  21 */
  22#if defined(ACPI_DEBUG_OUTPUT) || defined(ACPI_DEBUGGER)
  23/* Local prototypes */
  24static void acpi_ex_out_string(const char *title, const char *value);
  25
  26static void acpi_ex_out_pointer(const char *title, const void *value);
  27
  28static void
  29acpi_ex_dump_object(union acpi_operand_object *obj_desc,
  30		    struct acpi_exdump_info *info);
  31
  32static void acpi_ex_dump_reference_obj(union acpi_operand_object *obj_desc);
  33
  34static void
  35acpi_ex_dump_package_obj(union acpi_operand_object *obj_desc,
  36			 u32 level, u32 index);
  37
  38/*******************************************************************************
  39 *
  40 * Object Descriptor info tables
  41 *
  42 * Note: The first table entry must be an INIT opcode and must contain
  43 * the table length (number of table entries)
  44 *
  45 ******************************************************************************/
  46
  47static struct acpi_exdump_info acpi_ex_dump_integer[2] = {
  48	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_integer), NULL},
  49	{ACPI_EXD_UINT64, ACPI_EXD_OFFSET(integer.value), "Value"}
  50};
  51
  52static struct acpi_exdump_info acpi_ex_dump_string[4] = {
  53	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_string), NULL},
  54	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(string.length), "Length"},
  55	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(string.pointer), "Pointer"},
  56	{ACPI_EXD_STRING, 0, NULL}
  57};
  58
  59static struct acpi_exdump_info acpi_ex_dump_buffer[5] = {
  60	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_buffer), NULL},
  61	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(buffer.length), "Length"},
  62	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(buffer.pointer), "Pointer"},
  63	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(buffer.node), "Parent Node"},
  64	{ACPI_EXD_BUFFER, 0, NULL}
  65};
  66
  67static struct acpi_exdump_info acpi_ex_dump_package[6] = {
  68	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_package), NULL},
  69	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(package.node), "Parent Node"},
  70	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(package.flags), "Flags"},
  71	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(package.count), "Element Count"},
  72	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(package.elements), "Element List"},
  73	{ACPI_EXD_PACKAGE, 0, NULL}
  74};
  75
  76static struct acpi_exdump_info acpi_ex_dump_device[4] = {
  77	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_device), NULL},
  78	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(device.notify_list[0]),
 
  79	 "System Notify"},
  80	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(device.notify_list[1]),
  81	 "Device Notify"},
  82	{ACPI_EXD_HDLR_LIST, ACPI_EXD_OFFSET(device.handler), "Handler"}
  83};
  84
  85static struct acpi_exdump_info acpi_ex_dump_event[2] = {
  86	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_event), NULL},
  87	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(event.os_semaphore), "OsSemaphore"}
  88};
  89
  90static struct acpi_exdump_info acpi_ex_dump_method[9] = {
  91	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_method), NULL},
  92	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.info_flags), "Info Flags"},
  93	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.param_count),
  94	 "Parameter Count"},
  95	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.sync_level), "Sync Level"},
  96	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(method.mutex), "Mutex"},
  97	{ACPI_EXD_UINT16, ACPI_EXD_OFFSET(method.owner_id), "Owner Id"},
  98	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(method.thread_count), "Thread Count"},
  99	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(method.aml_length), "Aml Length"},
 100	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(method.aml_start), "Aml Start"}
 101};
 102
 103static struct acpi_exdump_info acpi_ex_dump_mutex[6] = {
 104	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_mutex), NULL},
 105	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(mutex.sync_level), "Sync Level"},
 106	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(mutex.original_sync_level),
 107	 "Original Sync Level"},
 108	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(mutex.owner_thread), "Owner Thread"},
 109	{ACPI_EXD_UINT16, ACPI_EXD_OFFSET(mutex.acquisition_depth),
 110	 "Acquire Depth"},
 111	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(mutex.os_mutex), "OsMutex"}
 112};
 113
 114static struct acpi_exdump_info acpi_ex_dump_region[8] = {
 115	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_region), NULL},
 116	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(region.space_id), "Space Id"},
 117	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(region.flags), "Flags"},
 118	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(region.node), "Parent Node"},
 119	{ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET(region.address), "Address"},
 120	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(region.length), "Length"},
 121	{ACPI_EXD_HDLR_LIST, ACPI_EXD_OFFSET(region.handler), "Handler"},
 122	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(region.next), "Next"}
 123};
 124
 125static struct acpi_exdump_info acpi_ex_dump_power[6] = {
 126	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_power), NULL},
 127	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(power_resource.system_level),
 128	 "System Level"},
 129	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(power_resource.resource_order),
 130	 "Resource Order"},
 131	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(power_resource.notify_list[0]),
 132	 "System Notify"},
 133	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(power_resource.notify_list[1]),
 134	 "Device Notify"},
 135	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(power_resource.handler), "Handler"}
 136};
 137
 138static struct acpi_exdump_info acpi_ex_dump_processor[7] = {
 139	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_processor), NULL},
 140	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(processor.proc_id), "Processor ID"},
 141	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(processor.length), "Length"},
 142	{ACPI_EXD_ADDRESS, ACPI_EXD_OFFSET(processor.address), "Address"},
 143	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(processor.notify_list[0]),
 144	 "System Notify"},
 145	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(processor.notify_list[1]),
 146	 "Device Notify"},
 147	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(processor.handler), "Handler"}
 148};
 149
 150static struct acpi_exdump_info acpi_ex_dump_thermal[4] = {
 151	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_thermal), NULL},
 152	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(thermal_zone.notify_list[0]),
 153	 "System Notify"},
 154	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(thermal_zone.notify_list[1]),
 155	 "Device Notify"},
 156	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(thermal_zone.handler), "Handler"}
 157};
 158
 159static struct acpi_exdump_info acpi_ex_dump_buffer_field[3] = {
 160	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_buffer_field), NULL},
 161	{ACPI_EXD_FIELD, 0, NULL},
 162	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(buffer_field.buffer_obj),
 163	 "Buffer Object"}
 164};
 165
 166static struct acpi_exdump_info acpi_ex_dump_region_field[5] = {
 167	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_region_field), NULL},
 168	{ACPI_EXD_FIELD, 0, NULL},
 169	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(field.access_length), "AccessLength"},
 170	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(field.region_obj), "Region Object"},
 171	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(field.resource_buffer),
 172	 "ResourceBuffer"}
 173};
 174
 175static struct acpi_exdump_info acpi_ex_dump_bank_field[5] = {
 176	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_bank_field), NULL},
 177	{ACPI_EXD_FIELD, 0, NULL},
 178	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(bank_field.value), "Value"},
 179	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(bank_field.region_obj),
 180	 "Region Object"},
 181	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(bank_field.bank_obj), "Bank Object"}
 182};
 183
 184static struct acpi_exdump_info acpi_ex_dump_index_field[5] = {
 185	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_bank_field), NULL},
 186	{ACPI_EXD_FIELD, 0, NULL},
 187	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(index_field.value), "Value"},
 188	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(index_field.index_obj),
 189	 "Index Object"},
 190	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(index_field.data_obj), "Data Object"}
 191};
 192
 193static struct acpi_exdump_info acpi_ex_dump_reference[9] = {
 194	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_reference), NULL},
 195	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(reference.class), "Class"},
 196	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(reference.target_type), "Target Type"},
 197	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(reference.value), "Value"},
 198	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(reference.object), "Object Desc"},
 199	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(reference.node), "Node"},
 200	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(reference.where), "Where"},
 201	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(reference.index_pointer),
 202	 "Index Pointer"},
 203	{ACPI_EXD_REFERENCE, 0, NULL}
 204};
 205
 206static struct acpi_exdump_info acpi_ex_dump_address_handler[6] = {
 207	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_address_handler),
 208	 NULL},
 209	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(address_space.space_id), "Space Id"},
 210	{ACPI_EXD_HDLR_LIST, ACPI_EXD_OFFSET(address_space.next), "Next"},
 211	{ACPI_EXD_RGN_LIST, ACPI_EXD_OFFSET(address_space.region_list),
 212	 "Region List"},
 213	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(address_space.node), "Node"},
 214	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(address_space.context), "Context"}
 215};
 216
 217static struct acpi_exdump_info acpi_ex_dump_notify[7] = {
 218	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_notify), NULL},
 219	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(notify.node), "Node"},
 220	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(notify.handler_type), "Handler Type"},
 221	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(notify.handler), "Handler"},
 222	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(notify.context), "Context"},
 223	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(notify.next[0]),
 224	 "Next System Notify"},
 225	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(notify.next[1]), "Next Device Notify"}
 226};
 227
 228static struct acpi_exdump_info acpi_ex_dump_extra[6] = {
 229	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_extra), NULL},
 230	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(extra.method_REG), "_REG Method"},
 231	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(extra.scope_node), "Scope Node"},
 232	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(extra.region_context),
 233	 "Region Context"},
 234	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(extra.aml_start), "Aml Start"},
 235	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(extra.aml_length), "Aml Length"}
 236};
 237
 238static struct acpi_exdump_info acpi_ex_dump_data[3] = {
 239	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_data), NULL},
 240	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(data.handler), "Handler"},
 241	{ACPI_EXD_POINTER, ACPI_EXD_OFFSET(data.pointer), "Raw Data"}
 242};
 243
 244/* Miscellaneous tables */
 245
 246static struct acpi_exdump_info acpi_ex_dump_common[5] = {
 247	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_common), NULL},
 248	{ACPI_EXD_TYPE, 0, NULL},
 249	{ACPI_EXD_UINT16, ACPI_EXD_OFFSET(common.reference_count),
 250	 "Reference Count"},
 251	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common.flags), "Flags"},
 252	{ACPI_EXD_LIST, ACPI_EXD_OFFSET(common.next_object), "Object List"}
 253};
 254
 255static struct acpi_exdump_info acpi_ex_dump_field_common[7] = {
 256	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_field_common), NULL},
 257	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common_field.field_flags),
 258	 "Field Flags"},
 259	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common_field.access_byte_width),
 260	 "Access Byte Width"},
 261	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(common_field.bit_length),
 262	 "Bit Length"},
 263	{ACPI_EXD_UINT8, ACPI_EXD_OFFSET(common_field.start_field_bit_offset),
 264	 "Field Bit Offset"},
 265	{ACPI_EXD_UINT32, ACPI_EXD_OFFSET(common_field.base_byte_offset),
 266	 "Base Byte Offset"},
 267	{ACPI_EXD_NODE, ACPI_EXD_OFFSET(common_field.node), "Parent Node"}
 268};
 269
 270static struct acpi_exdump_info acpi_ex_dump_node[7] = {
 271	{ACPI_EXD_INIT, ACPI_EXD_TABLE_SIZE(acpi_ex_dump_node), NULL},
 272	{ACPI_EXD_UINT16, ACPI_EXD_NSOFFSET(flags), "Flags"},
 273	{ACPI_EXD_UINT16, ACPI_EXD_NSOFFSET(owner_id), "Owner Id"},
 274	{ACPI_EXD_LIST, ACPI_EXD_NSOFFSET(object), "Object List"},
 275	{ACPI_EXD_NODE, ACPI_EXD_NSOFFSET(parent), "Parent"},
 276	{ACPI_EXD_NODE, ACPI_EXD_NSOFFSET(child), "Child"},
 277	{ACPI_EXD_NODE, ACPI_EXD_NSOFFSET(peer), "Peer"}
 278};
 279
 280/* Dispatch table, indexed by object type */
 281
 282static struct acpi_exdump_info *acpi_ex_dump_info[] = {
 283	NULL,
 284	acpi_ex_dump_integer,
 285	acpi_ex_dump_string,
 286	acpi_ex_dump_buffer,
 287	acpi_ex_dump_package,
 288	NULL,
 289	acpi_ex_dump_device,
 290	acpi_ex_dump_event,
 291	acpi_ex_dump_method,
 292	acpi_ex_dump_mutex,
 293	acpi_ex_dump_region,
 294	acpi_ex_dump_power,
 295	acpi_ex_dump_processor,
 296	acpi_ex_dump_thermal,
 297	acpi_ex_dump_buffer_field,
 298	NULL,
 299	NULL,
 300	acpi_ex_dump_region_field,
 301	acpi_ex_dump_bank_field,
 302	acpi_ex_dump_index_field,
 303	acpi_ex_dump_reference,
 304	NULL,
 305	NULL,
 306	acpi_ex_dump_notify,
 307	acpi_ex_dump_address_handler,
 308	NULL,
 309	NULL,
 310	NULL,
 311	acpi_ex_dump_extra,
 312	acpi_ex_dump_data
 313};
 314
 315/*******************************************************************************
 316 *
 317 * FUNCTION:    acpi_ex_dump_object
 318 *
 319 * PARAMETERS:  obj_desc            - Descriptor to dump
 320 *              info                - Info table corresponding to this object
 321 *                                    type
 322 *
 323 * RETURN:      None
 324 *
 325 * DESCRIPTION: Walk the info table for this object
 326 *
 327 ******************************************************************************/
 328
 329static void
 330acpi_ex_dump_object(union acpi_operand_object *obj_desc,
 331		    struct acpi_exdump_info *info)
 332{
 333	u8 *target;
 334	const char *name;
 335	u8 count;
 336	union acpi_operand_object *start;
 337	union acpi_operand_object *data = NULL;
 338	union acpi_operand_object *next;
 339	struct acpi_namespace_node *node;
 340
 341	if (!info) {
 342		acpi_os_printf
 343		    ("ExDumpObject: Display not implemented for object type %s\n",
 344		     acpi_ut_get_object_type_name(obj_desc));
 345		return;
 346	}
 347
 348	/* First table entry must contain the table length (# of table entries) */
 349
 350	count = info->offset;
 351
 352	while (count) {
 353		if (!obj_desc) {
 354			return;
 355		}
 356
 357		target = ACPI_ADD_PTR(u8, obj_desc, info->offset);
 358		name = info->name;
 359
 360		switch (info->opcode) {
 361		case ACPI_EXD_INIT:
 362
 363			break;
 364
 365		case ACPI_EXD_TYPE:
 366
 367			acpi_os_printf("%20s : %2.2X [%s]\n", "Type",
 368				       obj_desc->common.type,
 369				       acpi_ut_get_object_type_name(obj_desc));
 370			break;
 371
 372		case ACPI_EXD_UINT8:
 373
 374			acpi_os_printf("%20s : %2.2X\n", name, *target);
 375			break;
 376
 377		case ACPI_EXD_UINT16:
 378
 379			acpi_os_printf("%20s : %4.4X\n", name,
 380				       ACPI_GET16(target));
 381			break;
 382
 383		case ACPI_EXD_UINT32:
 384
 385			acpi_os_printf("%20s : %8.8X\n", name,
 386				       ACPI_GET32(target));
 387			break;
 388
 389		case ACPI_EXD_UINT64:
 390
 391			acpi_os_printf("%20s : %8.8X%8.8X\n", "Value",
 392				       ACPI_FORMAT_UINT64(ACPI_GET64(target)));
 393			break;
 394
 395		case ACPI_EXD_POINTER:
 396		case ACPI_EXD_ADDRESS:
 397
 398			acpi_ex_out_pointer(name,
 399					    *ACPI_CAST_PTR(void *, target));
 400			break;
 401
 402		case ACPI_EXD_STRING:
 403
 404			acpi_ut_print_string(obj_desc->string.pointer,
 405					     ACPI_UINT8_MAX);
 406			acpi_os_printf("\n");
 407			break;
 408
 409		case ACPI_EXD_BUFFER:
 410
 411			ACPI_DUMP_BUFFER(obj_desc->buffer.pointer,
 412					 obj_desc->buffer.length);
 413			break;
 414
 415		case ACPI_EXD_PACKAGE:
 416
 417			/* Dump the package contents */
 418
 419			acpi_os_printf("\nPackage Contents:\n");
 420			acpi_ex_dump_package_obj(obj_desc, 0, 0);
 421			break;
 422
 423		case ACPI_EXD_FIELD:
 424
 425			acpi_ex_dump_object(obj_desc,
 426					    acpi_ex_dump_field_common);
 427			break;
 428
 429		case ACPI_EXD_REFERENCE:
 430
 431			acpi_ex_out_string("Class Name",
 432					   acpi_ut_get_reference_name
 433					   (obj_desc));
 
 434			acpi_ex_dump_reference_obj(obj_desc);
 435			break;
 436
 437		case ACPI_EXD_LIST:
 438
 439			start = *ACPI_CAST_PTR(void *, target);
 440			next = start;
 441
 442			acpi_os_printf("%20s : %p ", name, next);
 443			if (next) {
 444				acpi_os_printf("%s (Type %2.2X)",
 445					       acpi_ut_get_object_type_name
 446					       (next), next->common.type);
 447
 448				while (next->common.next_object) {
 449					if ((next->common.type ==
 450					     ACPI_TYPE_LOCAL_DATA) && !data) {
 451						data = next;
 452					}
 453
 454					next = next->common.next_object;
 455					acpi_os_printf("->%p(%s %2.2X)", next,
 456						       acpi_ut_get_object_type_name
 457						       (next),
 458						       next->common.type);
 459
 460					if ((next == start) || (next == data)) {
 461						acpi_os_printf
 462						    ("\n**** Error: Object list appears to be circular linked");
 463						break;
 464					}
 465				}
 466			} else {
 467				acpi_os_printf("- No attached objects");
 468			}
 469
 470			acpi_os_printf("\n");
 471			break;
 472
 473		case ACPI_EXD_HDLR_LIST:
 474
 475			start = *ACPI_CAST_PTR(void *, target);
 476			next = start;
 477
 478			acpi_os_printf("%20s : %p", name, next);
 479			if (next) {
 480				acpi_os_printf("(%s %2.2X)",
 481					       acpi_ut_get_object_type_name
 482					       (next),
 483					       next->address_space.space_id);
 484
 485				while (next->address_space.next) {
 486					if ((next->common.type ==
 487					     ACPI_TYPE_LOCAL_DATA) && !data) {
 488						data = next;
 489					}
 490
 491					next = next->address_space.next;
 492					acpi_os_printf("->%p(%s %2.2X)", next,
 493						       acpi_ut_get_object_type_name
 494						       (next),
 495						       next->address_space.
 496						       space_id);
 497
 498					if ((next == start) || (next == data)) {
 499						acpi_os_printf
 500						    ("\n**** Error: Handler list appears to be circular linked");
 501						break;
 502					}
 503				}
 504			}
 505
 506			acpi_os_printf("\n");
 507			break;
 508
 509		case ACPI_EXD_RGN_LIST:
 510
 511			start = *ACPI_CAST_PTR(void *, target);
 512			next = start;
 513
 514			acpi_os_printf("%20s : %p", name, next);
 515			if (next) {
 516				acpi_os_printf("(%s %2.2X)",
 517					       acpi_ut_get_object_type_name
 518					       (next), next->common.type);
 519
 520				while (next->region.next) {
 521					if ((next->common.type ==
 522					     ACPI_TYPE_LOCAL_DATA) && !data) {
 523						data = next;
 524					}
 525
 526					next = next->region.next;
 527					acpi_os_printf("->%p(%s %2.2X)", next,
 528						       acpi_ut_get_object_type_name
 529						       (next),
 530						       next->common.type);
 531
 532					if ((next == start) || (next == data)) {
 533						acpi_os_printf
 534						    ("\n**** Error: Region list appears to be circular linked");
 535						break;
 536					}
 537				}
 538			}
 539
 540			acpi_os_printf("\n");
 541			break;
 542
 543		case ACPI_EXD_NODE:
 544
 545			node =
 546			    *ACPI_CAST_PTR(struct acpi_namespace_node *,
 547					   target);
 548
 549			acpi_os_printf("%20s : %p", name, node);
 550			if (node) {
 551				acpi_os_printf(" [%4.4s]", node->name.ascii);
 552			}
 553			acpi_os_printf("\n");
 554			break;
 555
 556		default:
 557
 558			acpi_os_printf("**** Invalid table opcode [%X] ****\n",
 559				       info->opcode);
 560			return;
 561		}
 562
 563		info++;
 564		count--;
 565	}
 566}
 567
 568/*******************************************************************************
 569 *
 570 * FUNCTION:    acpi_ex_dump_operand
 571 *
 572 * PARAMETERS:  *obj_desc       - Pointer to entry to be dumped
 573 *              depth           - Current nesting depth
 574 *
 575 * RETURN:      None
 576 *
 577 * DESCRIPTION: Dump an operand object
 578 *
 579 ******************************************************************************/
 580
 581void acpi_ex_dump_operand(union acpi_operand_object *obj_desc, u32 depth)
 582{
 583	u32 length;
 584	u32 index;
 585
 586	ACPI_FUNCTION_NAME(ex_dump_operand);
 587
 588	/* Check if debug output enabled */
 589
 590	if (!ACPI_IS_DEBUG_ENABLED(ACPI_LV_EXEC, _COMPONENT)) {
 591		return;
 592	}
 593
 594	if (!obj_desc) {
 595
 596		/* This could be a null element of a package */
 597
 598		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "Null Object Descriptor\n"));
 599		return;
 600	}
 601
 602	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) == ACPI_DESC_TYPE_NAMED) {
 603		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%p Namespace Node: ",
 604				  obj_desc));
 605		ACPI_DUMP_ENTRY(obj_desc, ACPI_LV_EXEC);
 606		return;
 607	}
 608
 609	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) != ACPI_DESC_TYPE_OPERAND) {
 610		ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 611				  "%p is not a node or operand object: [%s]\n",
 612				  obj_desc,
 613				  acpi_ut_get_descriptor_name(obj_desc)));
 614		ACPI_DUMP_BUFFER(obj_desc, sizeof(union acpi_operand_object));
 615		return;
 616	}
 617
 618	/* obj_desc is a valid object */
 619
 620	if (depth > 0) {
 621		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%*s[%u] %p Refs=%u ",
 622				  depth, " ", depth, obj_desc,
 623				  obj_desc->common.reference_count));
 624	} else {
 625		ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "%p Refs=%u ",
 626				  obj_desc, obj_desc->common.reference_count));
 627	}
 628
 629	/* Decode object type */
 630
 631	switch (obj_desc->common.type) {
 632	case ACPI_TYPE_LOCAL_REFERENCE:
 633
 634		acpi_os_printf("Reference: [%s] ",
 635			       acpi_ut_get_reference_name(obj_desc));
 636
 637		switch (obj_desc->reference.class) {
 638		case ACPI_REFCLASS_DEBUG:
 639
 640			acpi_os_printf("\n");
 641			break;
 642
 643		case ACPI_REFCLASS_INDEX:
 644
 645			acpi_os_printf("%p\n", obj_desc->reference.object);
 646			break;
 647
 648		case ACPI_REFCLASS_TABLE:
 649
 650			acpi_os_printf("Table Index %X\n",
 651				       obj_desc->reference.value);
 652			break;
 653
 654		case ACPI_REFCLASS_REFOF:
 655
 656			acpi_os_printf("%p [%s]\n", obj_desc->reference.object,
 657				       acpi_ut_get_type_name(((union
 658							       acpi_operand_object
 659							       *)
 660							      obj_desc->
 661							      reference.
 662							      object)->common.
 663							     type));
 664			break;
 665
 666		case ACPI_REFCLASS_NAME:
 667
 668			acpi_ut_repair_name(obj_desc->reference.node->name.
 669					    ascii);
 670			acpi_os_printf("- [%4.4s] (Node %p)\n",
 671				       obj_desc->reference.node->name.ascii,
 672				       obj_desc->reference.node);
 673			break;
 674
 675		case ACPI_REFCLASS_ARG:
 676		case ACPI_REFCLASS_LOCAL:
 677
 678			acpi_os_printf("%X\n", obj_desc->reference.value);
 679			break;
 680
 681		default:	/* Unknown reference class */
 682
 683			acpi_os_printf("%2.2X\n", obj_desc->reference.class);
 684			break;
 685		}
 686		break;
 687
 688	case ACPI_TYPE_BUFFER:
 689
 690		acpi_os_printf("Buffer length %.2X @ %p\n",
 691			       obj_desc->buffer.length,
 692			       obj_desc->buffer.pointer);
 693
 694		/* Debug only -- dump the buffer contents */
 695
 696		if (obj_desc->buffer.pointer) {
 697			length = obj_desc->buffer.length;
 698			if (length > 128) {
 699				length = 128;
 700			}
 701
 702			acpi_os_printf
 703			    ("Buffer Contents: (displaying length 0x%.2X)\n",
 704			     length);
 705			ACPI_DUMP_BUFFER(obj_desc->buffer.pointer, length);
 706		}
 707		break;
 708
 709	case ACPI_TYPE_INTEGER:
 710
 711		acpi_os_printf("Integer %8.8X%8.8X\n",
 712			       ACPI_FORMAT_UINT64(obj_desc->integer.value));
 713		break;
 714
 715	case ACPI_TYPE_PACKAGE:
 716
 717		acpi_os_printf("Package [Len %X] ElementArray %p\n",
 718			       obj_desc->package.count,
 719			       obj_desc->package.elements);
 720
 721		/*
 722		 * If elements exist, package element pointer is valid,
 723		 * and debug_level exceeds 1, dump package's elements.
 724		 */
 725		if (obj_desc->package.count &&
 726		    obj_desc->package.elements && acpi_dbg_level > 1) {
 727			for (index = 0; index < obj_desc->package.count;
 728			     index++) {
 729				acpi_ex_dump_operand(obj_desc->package.
 730						     elements[index],
 731						     depth + 1);
 732			}
 733		}
 734		break;
 735
 736	case ACPI_TYPE_REGION:
 737
 738		acpi_os_printf("Region %s (%X)",
 739			       acpi_ut_get_region_name(obj_desc->region.
 740						       space_id),
 741			       obj_desc->region.space_id);
 742
 743		/*
 744		 * If the address and length have not been evaluated,
 745		 * don't print them.
 746		 */
 747		if (!(obj_desc->region.flags & AOPOBJ_DATA_VALID)) {
 748			acpi_os_printf("\n");
 749		} else {
 750			acpi_os_printf(" base %8.8X%8.8X Length %X\n",
 751				       ACPI_FORMAT_UINT64(obj_desc->region.
 752							  address),
 753				       obj_desc->region.length);
 754		}
 755		break;
 756
 757	case ACPI_TYPE_STRING:
 758
 759		acpi_os_printf("String length %X @ %p ",
 760			       obj_desc->string.length,
 761			       obj_desc->string.pointer);
 762
 763		acpi_ut_print_string(obj_desc->string.pointer, ACPI_UINT8_MAX);
 764		acpi_os_printf("\n");
 765		break;
 766
 767	case ACPI_TYPE_LOCAL_BANK_FIELD:
 768
 769		acpi_os_printf("BankField\n");
 770		break;
 771
 772	case ACPI_TYPE_LOCAL_REGION_FIELD:
 773
 774		acpi_os_printf
 775		    ("RegionField: Bits=%X AccWidth=%X Lock=%X Update=%X at "
 776		     "byte=%X bit=%X of below:\n", obj_desc->field.bit_length,
 777		     obj_desc->field.access_byte_width,
 778		     obj_desc->field.field_flags & AML_FIELD_LOCK_RULE_MASK,
 779		     obj_desc->field.field_flags & AML_FIELD_UPDATE_RULE_MASK,
 780		     obj_desc->field.base_byte_offset,
 781		     obj_desc->field.start_field_bit_offset);
 782
 783		acpi_ex_dump_operand(obj_desc->field.region_obj, depth + 1);
 784		break;
 785
 786	case ACPI_TYPE_LOCAL_INDEX_FIELD:
 787
 788		acpi_os_printf("IndexField\n");
 789		break;
 790
 791	case ACPI_TYPE_BUFFER_FIELD:
 792
 793		acpi_os_printf("BufferField: %X bits at byte %X bit %X of\n",
 794			       obj_desc->buffer_field.bit_length,
 795			       obj_desc->buffer_field.base_byte_offset,
 796			       obj_desc->buffer_field.start_field_bit_offset);
 797
 798		if (!obj_desc->buffer_field.buffer_obj) {
 799			ACPI_DEBUG_PRINT((ACPI_DB_EXEC, "*NULL*\n"));
 800		} else if ((obj_desc->buffer_field.buffer_obj)->common.type !=
 801			   ACPI_TYPE_BUFFER) {
 802			acpi_os_printf("*not a Buffer*\n");
 803		} else {
 804			acpi_ex_dump_operand(obj_desc->buffer_field.buffer_obj,
 805					     depth + 1);
 806		}
 807		break;
 808
 809	case ACPI_TYPE_EVENT:
 810
 811		acpi_os_printf("Event\n");
 812		break;
 813
 814	case ACPI_TYPE_METHOD:
 815
 816		acpi_os_printf("Method(%X) @ %p:%X\n",
 817			       obj_desc->method.param_count,
 818			       obj_desc->method.aml_start,
 819			       obj_desc->method.aml_length);
 820		break;
 821
 822	case ACPI_TYPE_MUTEX:
 823
 824		acpi_os_printf("Mutex\n");
 825		break;
 826
 827	case ACPI_TYPE_DEVICE:
 828
 829		acpi_os_printf("Device\n");
 830		break;
 831
 832	case ACPI_TYPE_POWER:
 833
 834		acpi_os_printf("Power\n");
 835		break;
 836
 837	case ACPI_TYPE_PROCESSOR:
 838
 839		acpi_os_printf("Processor\n");
 840		break;
 841
 842	case ACPI_TYPE_THERMAL:
 843
 844		acpi_os_printf("Thermal\n");
 845		break;
 846
 847	default:
 848
 849		/* Unknown Type */
 850
 851		acpi_os_printf("Unknown Type %X\n", obj_desc->common.type);
 852		break;
 853	}
 854
 855	return;
 856}
 857
 858/*******************************************************************************
 859 *
 860 * FUNCTION:    acpi_ex_dump_operands
 861 *
 862 * PARAMETERS:  operands            - A list of Operand objects
 863 *		opcode_name	    - AML opcode name
 864 *		num_operands	    - Operand count for this opcode
 865 *
 866 * DESCRIPTION: Dump the operands associated with the opcode
 867 *
 868 ******************************************************************************/
 869
 870void
 871acpi_ex_dump_operands(union acpi_operand_object **operands,
 872		      const char *opcode_name, u32 num_operands)
 873{
 874	ACPI_FUNCTION_TRACE(ex_dump_operands);
 875
 876	if (!opcode_name) {
 877		opcode_name = "UNKNOWN";
 878	}
 879
 880	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 881			  "**** Start operand dump for opcode [%s], %u operands\n",
 882			  opcode_name, num_operands));
 883
 884	if (num_operands == 0) {
 885		num_operands = 1;
 886	}
 887
 888	/* Dump the individual operands */
 889
 890	while (num_operands) {
 891		acpi_ex_dump_operand(*operands, 0);
 892		operands++;
 893		num_operands--;
 894	}
 895
 896	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 897			  "**** End operand dump for [%s]\n", opcode_name));
 898	return_VOID;
 899}
 900
 901/*******************************************************************************
 902 *
 903 * FUNCTION:    acpi_ex_out* functions
 904 *
 905 * PARAMETERS:  title               - Descriptive text
 906 *              value               - Value to be displayed
 907 *
 908 * DESCRIPTION: Object dump output formatting functions. These functions
 909 *              reduce the number of format strings required and keeps them
 910 *              all in one place for easy modification.
 911 *
 912 ******************************************************************************/
 913
 914static void acpi_ex_out_string(const char *title, const char *value)
 915{
 916	acpi_os_printf("%20s : %s\n", title, value);
 917}
 918
 919static void acpi_ex_out_pointer(const char *title, const void *value)
 920{
 921	acpi_os_printf("%20s : %p\n", title, value);
 922}
 923
 924/*******************************************************************************
 925 *
 926 * FUNCTION:    acpi_ex_dump_namespace_node
 927 *
 928 * PARAMETERS:  node                - Descriptor to dump
 929 *              flags               - Force display if TRUE
 930 *
 931 * DESCRIPTION: Dumps the members of the given.Node
 932 *
 933 ******************************************************************************/
 934
 935void acpi_ex_dump_namespace_node(struct acpi_namespace_node *node, u32 flags)
 936{
 937
 938	ACPI_FUNCTION_ENTRY();
 939
 940	if (!flags) {
 941
 942		/* Check if debug output enabled */
 943
 944		if (!ACPI_IS_DEBUG_ENABLED(ACPI_LV_OBJECTS, _COMPONENT)) {
 945			return;
 946		}
 947	}
 948
 949	acpi_os_printf("%20s : %4.4s\n", "Name", acpi_ut_get_node_name(node));
 950	acpi_os_printf("%20s : %2.2X [%s]\n", "Type",
 951		       node->type, acpi_ut_get_type_name(node->type));
 
 
 952
 953	acpi_ex_dump_object(ACPI_CAST_PTR(union acpi_operand_object, node),
 954			    acpi_ex_dump_node);
 955}
 956
 957/*******************************************************************************
 958 *
 959 * FUNCTION:    acpi_ex_dump_reference_obj
 960 *
 961 * PARAMETERS:  object              - Descriptor to dump
 962 *
 963 * DESCRIPTION: Dumps a reference object
 964 *
 965 ******************************************************************************/
 966
 967static void acpi_ex_dump_reference_obj(union acpi_operand_object *obj_desc)
 968{
 969	struct acpi_buffer ret_buf;
 970	acpi_status status;
 971
 972	ret_buf.length = ACPI_ALLOCATE_LOCAL_BUFFER;
 973
 974	if (obj_desc->reference.class == ACPI_REFCLASS_NAME) {
 975		acpi_os_printf(" %p ", obj_desc->reference.node);
 976
 977		status = acpi_ns_handle_to_pathname(obj_desc->reference.node,
 978						    &ret_buf, TRUE);
 
 979		if (ACPI_FAILURE(status)) {
 980			acpi_os_printf
 981			    (" Could not convert name to pathname: %s\n",
 982			     acpi_format_exception(status));
 983		} else {
 984			acpi_os_printf("%s: %s\n",
 985				       acpi_ut_get_type_name(obj_desc->
 986							     reference.node->
 987							     type),
 988				       (char *)ret_buf.pointer);
 989			ACPI_FREE(ret_buf.pointer);
 990		}
 991	} else if (obj_desc->reference.object) {
 992		if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) ==
 993		    ACPI_DESC_TYPE_OPERAND) {
 994			acpi_os_printf("%22s %p", "Target :",
 995				       obj_desc->reference.object);
 996			if (obj_desc->reference.class == ACPI_REFCLASS_TABLE) {
 997				acpi_os_printf(" Table Index: %X\n",
 998					       obj_desc->reference.value);
 999			} else {
1000				acpi_os_printf(" [%s]\n",
 
1001					       acpi_ut_get_type_name(((union
1002								       acpi_operand_object
1003								       *)
1004								      obj_desc->
1005								      reference.
1006								      object)->
1007								     common.
1008								     type));
1009			}
1010		} else {
1011			acpi_os_printf(" Target: %p\n",
1012				       obj_desc->reference.object);
1013		}
1014	}
1015}
1016
1017/*******************************************************************************
1018 *
1019 * FUNCTION:    acpi_ex_dump_package_obj
1020 *
1021 * PARAMETERS:  obj_desc            - Descriptor to dump
1022 *              level               - Indentation Level
1023 *              index               - Package index for this object
1024 *
1025 * DESCRIPTION: Dumps the elements of the package
1026 *
1027 ******************************************************************************/
1028
1029static void
1030acpi_ex_dump_package_obj(union acpi_operand_object *obj_desc,
1031			 u32 level, u32 index)
1032{
1033	u32 i;
1034
1035	/* Indentation and index output */
1036
1037	if (level > 0) {
1038		for (i = 0; i < level; i++) {
1039			acpi_os_printf(" ");
1040		}
1041
1042		acpi_os_printf("[%.2d] ", index);
1043	}
1044
1045	acpi_os_printf("%p ", obj_desc);
1046
1047	/* Null package elements are allowed */
1048
1049	if (!obj_desc) {
1050		acpi_os_printf("[Null Object]\n");
1051		return;
1052	}
1053
1054	/* Packages may only contain a few object types */
1055
1056	switch (obj_desc->common.type) {
1057	case ACPI_TYPE_INTEGER:
1058
1059		acpi_os_printf("[Integer] = %8.8X%8.8X\n",
1060			       ACPI_FORMAT_UINT64(obj_desc->integer.value));
1061		break;
1062
1063	case ACPI_TYPE_STRING:
1064
1065		acpi_os_printf("[String] Value: ");
1066		acpi_ut_print_string(obj_desc->string.pointer, ACPI_UINT8_MAX);
 
 
1067		acpi_os_printf("\n");
1068		break;
1069
1070	case ACPI_TYPE_BUFFER:
1071
1072		acpi_os_printf("[Buffer] Length %.2X = ",
1073			       obj_desc->buffer.length);
1074		if (obj_desc->buffer.length) {
1075			acpi_ut_debug_dump_buffer(ACPI_CAST_PTR
1076						  (u8,
1077						   obj_desc->buffer.pointer),
1078						  obj_desc->buffer.length,
1079						  DB_DWORD_DISPLAY, _COMPONENT);
1080		} else {
1081			acpi_os_printf("\n");
1082		}
1083		break;
1084
1085	case ACPI_TYPE_PACKAGE:
1086
1087		acpi_os_printf("[Package] Contains %u Elements:\n",
1088			       obj_desc->package.count);
1089
1090		for (i = 0; i < obj_desc->package.count; i++) {
1091			acpi_ex_dump_package_obj(obj_desc->package.elements[i],
1092						 level + 1, i);
1093		}
1094		break;
1095
1096	case ACPI_TYPE_LOCAL_REFERENCE:
1097
1098		acpi_os_printf("[Object Reference] Class [%s]",
1099			       acpi_ut_get_reference_name(obj_desc));
 
1100		acpi_ex_dump_reference_obj(obj_desc);
1101		break;
1102
1103	default:
1104
1105		acpi_os_printf("[%s] Type: %2.2X\n",
1106			       acpi_ut_get_type_name(obj_desc->common.type),
1107			       obj_desc->common.type);
1108		break;
1109	}
1110}
1111
1112/*******************************************************************************
1113 *
1114 * FUNCTION:    acpi_ex_dump_object_descriptor
1115 *
1116 * PARAMETERS:  obj_desc            - Descriptor to dump
1117 *              flags               - Force display if TRUE
1118 *
1119 * DESCRIPTION: Dumps the members of the object descriptor given.
1120 *
1121 ******************************************************************************/
1122
1123void
1124acpi_ex_dump_object_descriptor(union acpi_operand_object *obj_desc, u32 flags)
1125{
1126	ACPI_FUNCTION_TRACE(ex_dump_object_descriptor);
1127
1128	if (!obj_desc) {
1129		return_VOID;
1130	}
1131
1132	if (!flags) {
1133
1134		/* Check if debug output enabled */
1135
1136		if (!ACPI_IS_DEBUG_ENABLED(ACPI_LV_OBJECTS, _COMPONENT)) {
1137			return_VOID;
1138		}
1139	}
1140
1141	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) == ACPI_DESC_TYPE_NAMED) {
1142		acpi_ex_dump_namespace_node((struct acpi_namespace_node *)
1143					    obj_desc, flags);
1144
1145		obj_desc = ((struct acpi_namespace_node *)obj_desc)->object;
1146		if (!obj_desc) {
1147			return_VOID;
1148		}
1149
1150		acpi_os_printf("\nAttached Object %p", obj_desc);
1151		if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) == ACPI_DESC_TYPE_NAMED) {
1152			acpi_os_printf(" - Namespace Node");
1153		}
1154
1155		acpi_os_printf(":\n");
1156		goto dump_object;
 
1157	}
1158
1159	if (ACPI_GET_DESCRIPTOR_TYPE(obj_desc) != ACPI_DESC_TYPE_OPERAND) {
1160		acpi_os_printf("%p is not an ACPI operand object: [%s]\n",
1161			       obj_desc, acpi_ut_get_descriptor_name(obj_desc));
 
1162		return_VOID;
1163	}
1164
1165	/* Validate the object type */
1166
1167	if (obj_desc->common.type > ACPI_TYPE_LOCAL_MAX) {
1168		acpi_os_printf("Not a known object type: %2.2X\n",
1169			       obj_desc->common.type);
1170		return_VOID;
1171	}
1172
1173dump_object:
1174
1175	if (!obj_desc) {
1176		return_VOID;
1177	}
1178
1179	/* Common Fields */
1180
1181	acpi_ex_dump_object(obj_desc, acpi_ex_dump_common);
1182
1183	/* Object-specific fields */
1184
1185	acpi_ex_dump_object(obj_desc, acpi_ex_dump_info[obj_desc->common.type]);
1186
1187	if (obj_desc->common.type == ACPI_TYPE_REGION) {
1188		obj_desc = obj_desc->common.next_object;
1189		if (obj_desc->common.type > ACPI_TYPE_LOCAL_MAX) {
1190			acpi_os_printf
1191			    ("Secondary object is not a known object type: %2.2X\n",
1192			     obj_desc->common.type);
1193
1194			return_VOID;
1195		}
1196
1197		acpi_os_printf("\nExtra attached Object (%p):\n", obj_desc);
1198		acpi_ex_dump_object(obj_desc,
1199				    acpi_ex_dump_info[obj_desc->common.type]);
1200	}
1201
1202	return_VOID;
1203}
1204
1205#endif