1 /******************************************************************************
3 * Module Name: dmtable - Support for ACPI tables that contain no AML code
5 *****************************************************************************/
7 /******************************************************************************
11 * Some or all of this work - Copyright (c) 1999 - 2017, Intel Corp.
12 * All rights reserved.
16 * 2.1. This is your license from Intel Corp. under its intellectual property
17 * rights. You may have additional license terms from the party that provided
18 * you this software, covering your right to use that party's intellectual
21 * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22 * copy of the source code appearing in this file ("Covered Code") an
23 * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24 * base code distributed originally by Intel ("Original Intel Code") to copy,
25 * make derivatives, distribute, use and display any portion of the Covered
26 * Code in any form, with the right to sublicense such rights; and
28 * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29 * license (with the right to sublicense), under only those claims of Intel
30 * patents that are infringed by the Original Intel Code, to make, use, sell,
31 * offer to sell, and import the Covered Code and derivative works thereof
32 * solely to the minimum extent necessary to exercise the above copyright
33 * license, and in no event shall the patent license extend to any additions
34 * to or modifications of the Original Intel Code. No other license or right
35 * is granted directly or by implication, estoppel or otherwise;
37 * The above copyright and patent license is granted only if the following
42 * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43 * Redistribution of source code of any substantial portion of the Covered
44 * Code or modification with rights to further distribute source must include
45 * the above Copyright Notice, the above License, this list of Conditions,
46 * and the following Disclaimer and Export Compliance provision. In addition,
47 * Licensee must cause all Covered Code to which Licensee contributes to
48 * contain a file documenting the changes Licensee made to create that Covered
49 * Code and the date of any change. Licensee must include in that file the
50 * documentation of any changes made by any predecessor Licensee. Licensee
51 * must include a prominent statement that the modification is derived,
52 * directly or indirectly, from Original Intel Code.
54 * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55 * Redistribution of source code of any substantial portion of the Covered
56 * Code or modification without rights to further distribute source must
57 * include the following Disclaimer and Export Compliance provision in the
58 * documentation and/or other materials provided with distribution. In
59 * addition, Licensee may not authorize further sublicense of source of any
60 * portion of the Covered Code, and must include terms to the effect that the
61 * license from Licensee to its licensee is limited to the intellectual
62 * property embodied in the software Licensee provides to its licensee, and
63 * not to intellectual property embodied in modifications its licensee may
66 * 3.3. Redistribution of Executable. Redistribution in executable form of any
67 * substantial portion of the Covered Code or modification must reproduce the
68 * above Copyright Notice, and the following Disclaimer and Export Compliance
69 * provision in the documentation and/or other materials provided with the
72 * 3.4. Intel retains all right, title, and interest in and to the Original
75 * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76 * Intel shall be used in advertising or otherwise to promote the sale, use or
77 * other dealings in products derived from or relating to the Covered Code
78 * without prior written authorization from Intel.
80 * 4. Disclaimer and Export Compliance
82 * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83 * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84 * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85 * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86 * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87 * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
90 * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91 * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92 * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93 * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94 * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95 * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96 * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
99 * 4.3. Licensee shall not export, either directly or indirectly, any of this
100 * software or system incorporating such software without first obtaining any
101 * required license or other approval from the U. S. Department of Commerce or
102 * any other agency or department of the United States Government. In the
103 * event Licensee exports any such software from the United States or
104 * re-exports any such software from a foreign destination, Licensee shall
105 * ensure that the distribution and export/re-export of the software is in
106 * compliance with all laws, regulations, orders, or other restrictions of the
107 * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108 * any of its subsidiaries will export/re-export any technical data, process,
109 * software, or service, directly or indirectly, to any country for which the
110 * United States government or any agency thereof requires an export license,
111 * other governmental approval, or letter of assurance, without first obtaining
112 * such license, approval or letter.
114 *****************************************************************************
116 * Alternatively, you may choose to be licensed under the terms of the
119 * Redistribution and use in source and binary forms, with or without
120 * modification, are permitted provided that the following conditions
122 * 1. Redistributions of source code must retain the above copyright
123 * notice, this list of conditions, and the following disclaimer,
124 * without modification.
125 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126 * substantially similar to the "NO WARRANTY" disclaimer below
127 * ("Disclaimer") and any redistribution must be conditioned upon
128 * including a substantially similar Disclaimer requirement for further
129 * binary redistribution.
130 * 3. Neither the names of the above-listed copyright holders nor the names
131 * of any contributors may be used to endorse or promote products derived
132 * from this software without specific prior written permission.
134 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
146 * Alternatively, you may choose to be licensed under the terms of the
147 * GNU General Public License ("GPL") version 2 as published by the Free
148 * Software Foundation.
150 *****************************************************************************/
152 #include <contrib/dev/acpica/include/acpi.h>
153 #include <contrib/dev/acpica/include/accommon.h>
154 #include <contrib/dev/acpica/include/acdisasm.h>
155 #include <contrib/dev/acpica/include/actables.h>
156 #include <contrib/dev/acpica/compiler/aslcompiler.h>
157 #include <contrib/dev/acpica/compiler/dtcompiler.h>
159 /* This module used for application-level code only */
161 #define _COMPONENT ACPI_CA_DISASSEMBLER
162 ACPI_MODULE_NAME ("dmtable")
169 /* Common format strings for commented values */
171 #define UINT8_FORMAT "%2.2X [%s]\n"
172 #define UINT16_FORMAT "%4.4X [%s]\n"
173 #define UINT32_FORMAT "%8.8X [%s]\n"
174 #define STRING_FORMAT "[%s]\n"
176 /* These tables map a subtable type to a description string */
178 static const char *AcpiDmAsfSubnames[] =
182 "ASF Remote Control",
183 "ASF RMCP Boot Options",
185 "Unknown Subtable Type" /* Reserved */
188 static const char *AcpiDmDmarSubnames[] =
190 "Hardware Unit Definition",
191 "Reserved Memory Region",
192 "Root Port ATS Capability",
193 "Remapping Hardware Static Affinity",
194 "ACPI Namespace Device Declaration",
195 "Unknown Subtable Type" /* Reserved */
198 static const char *AcpiDmDmarScope[] =
201 "PCI Endpoint Device",
204 "Message-capable HPET Device",
206 "Unknown Scope Type" /* Reserved */
209 static const char *AcpiDmEinjActions[] =
218 "Get Command Status",
219 "Set Error Type With Address",
220 "Get Execute Timings",
224 static const char *AcpiDmEinjInstructions[] =
227 "Read Register Value",
229 "Write Register Value",
232 "Unknown Instruction"
235 static const char *AcpiDmErstActions[] =
237 "Begin Write Operation",
238 "Begin Read Operation",
239 "Begin Clear Operation",
244 "Get Command Status",
245 "Get Record Identifier",
246 "Set Record Identifier",
249 "Unused/Unknown Action",
250 "Get Error Address Range",
251 "Get Error Address Length",
252 "Get Error Attributes",
257 static const char *AcpiDmErstInstructions[] =
260 "Read Register Value",
262 "Write Register Value",
275 "Set Source Address",
276 "Set Destination Address",
278 "Unknown Instruction"
281 static const char *AcpiDmGtdtSubnames[] =
283 "Generic Timer Block",
284 "Generic Watchdog Timer",
285 "Unknown Subtable Type" /* Reserved */
288 static const char *AcpiDmHestSubnames[] =
290 "IA-32 Machine Check Exception",
291 "IA-32 Corrected Machine Check",
292 "IA-32 Non-Maskable Interrupt",
293 "Unknown SubTable Type", /* 3 - Reserved */
294 "Unknown SubTable Type", /* 4 - Reserved */
295 "Unknown SubTable Type", /* 5 - Reserved */
296 "PCI Express Root Port AER",
297 "PCI Express AER (AER Endpoint)",
298 "PCI Express/PCI-X Bridge AER",
299 "Generic Hardware Error Source",
300 "Generic Hardware Error Source V2",
301 "Unknown Subtable Type" /* Reserved */
304 static const char *AcpiDmHestNotifySubnames[] =
307 "External Interrupt",
311 "CMCI", /* ACPI 5.0 */
312 "MCE", /* ACPI 5.0 */
313 "GPIO", /* ACPI 6.0 */
314 "SEA", /* ACPI 6.1 */
315 "SEI", /* ACPI 6.1 */
316 "GSIV", /* ACPI 6.1 */
317 "Unknown Notify Type" /* Reserved */
320 static const char *AcpiDmMadtSubnames[] =
322 "Processor Local APIC", /* ACPI_MADT_TYPE_LOCAL_APIC */
323 "I/O APIC", /* ACPI_MADT_TYPE_IO_APIC */
324 "Interrupt Source Override", /* ACPI_MADT_TYPE_INTERRUPT_OVERRIDE */
325 "NMI Source", /* ACPI_MADT_TYPE_NMI_SOURCE */
326 "Local APIC NMI", /* ACPI_MADT_TYPE_LOCAL_APIC_NMI */
327 "Local APIC Address Override", /* ACPI_MADT_TYPE_LOCAL_APIC_OVERRIDE */
328 "I/O SAPIC", /* ACPI_MADT_TYPE_IO_SAPIC */
329 "Local SAPIC", /* ACPI_MADT_TYPE_LOCAL_SAPIC */
330 "Platform Interrupt Sources", /* ACPI_MADT_TYPE_INTERRUPT_SOURCE */
331 "Processor Local x2APIC", /* ACPI_MADT_TYPE_LOCAL_X2APIC */
332 "Local x2APIC NMI", /* ACPI_MADT_TYPE_LOCAL_X2APIC_NMI */
333 "Generic Interrupt Controller", /* ACPI_MADT_GENERIC_INTERRUPT */
334 "Generic Interrupt Distributor", /* ACPI_MADT_GENERIC_DISTRIBUTOR */
335 "Generic MSI Frame", /* ACPI_MADT_GENERIC_MSI_FRAME */
336 "Generic Interrupt Redistributor", /* ACPI_MADT_GENERIC_REDISTRIBUTOR */
337 "Generic Interrupt Translator", /* ACPI_MADT_GENERIC_TRANSLATOR */
338 "Unknown Subtable Type" /* Reserved */
341 static const char *AcpiDmNfitSubnames[] =
343 "System Physical Address Range", /* ACPI_NFIT_TYPE_SYSTEM_ADDRESS */
344 "Memory Range Map", /* ACPI_NFIT_TYPE_MEMORY_MAP */
345 "Interleave Info", /* ACPI_NFIT_TYPE_INTERLEAVE */
346 "SMBIOS Information", /* ACPI_NFIT_TYPE_SMBIOS */
347 "NVDIMM Control Region", /* ACPI_NFIT_TYPE_CONTROL_REGION */
348 "NVDIMM Block Data Window Region", /* ACPI_NFIT_TYPE_DATA_REGION */
349 "Flush Hint Address", /* ACPI_NFIT_TYPE_FLUSH_ADDRESS */
350 "Unknown Subtable Type" /* Reserved */
353 static const char *AcpiDmPcctSubnames[] =
355 "Generic Communications Subspace", /* ACPI_PCCT_TYPE_GENERIC_SUBSPACE */
356 "HW-Reduced Comm Subspace", /* ACPI_PCCT_TYPE_HW_REDUCED_SUBSPACE */
357 "HW-Reduced Comm Subspace Type2", /* ACPI_PCCT_TYPE_HW_REDUCED_SUBSPACE_TYPE2 */
358 "Unknown Subtable Type" /* Reserved */
361 static const char *AcpiDmPmttSubnames[] =
363 "Socket", /* ACPI_PMTT_TYPE_SOCKET */
364 "Memory Controller", /* ACPI_PMTT_TYPE_CONTROLLER */
365 "Physical Component (DIMM)", /* ACPI_PMTT_TYPE_DIMM */
366 "Unknown Subtable Type" /* Reserved */
369 static const char *AcpiDmSratSubnames[] =
371 "Processor Local APIC/SAPIC Affinity",
373 "Processor Local x2APIC Affinity",
375 "Unknown Subtable Type" /* Reserved */
378 static const char *AcpiDmIvrsSubnames[] =
380 "Hardware Definition Block",
381 "Memory Definition Block",
382 "Unknown Subtable Type" /* Reserved */
385 static const char *AcpiDmLpitSubnames[] =
387 "Native C-state Idle Structure",
388 "Unknown Subtable Type" /* Reserved */
391 #define ACPI_FADT_PM_RESERVED 9
393 static const char *AcpiDmFadtProfiles[] =
402 "Performance Server",
404 "Unknown Profile Type"
407 #define ACPI_GAS_WIDTH_RESERVED 5
409 static const char *AcpiDmGasAccessWidth[] =
416 "Unknown Width Encoding"
420 /*******************************************************************************
422 * ACPI Table Data, indexed by signature.
424 * Each entry contains: Signature, Table Info, Handler, DtHandler,
425 * Template, Description
427 * Simple tables have only a TableInfo structure, complex tables have a
428 * handler. This table must be NULL terminated. RSDP and FACS are
429 * special-cased elsewhere.
431 * Note: Any tables added here should be duplicated within AcpiSupportedTables
432 * in the file common/ahtable.c
434 ******************************************************************************/
436 const ACPI_DMTABLE_DATA AcpiDmTableData[] =
438 {ACPI_SIG_ASF, NULL, AcpiDmDumpAsf, DtCompileAsf, TemplateAsf},
439 {ACPI_SIG_BERT, AcpiDmTableInfoBert, NULL, NULL, TemplateBert},
440 {ACPI_SIG_BGRT, AcpiDmTableInfoBgrt, NULL, NULL, TemplateBgrt},
441 {ACPI_SIG_BOOT, AcpiDmTableInfoBoot, NULL, NULL, TemplateBoot},
442 {ACPI_SIG_CPEP, NULL, AcpiDmDumpCpep, DtCompileCpep, TemplateCpep},
443 {ACPI_SIG_CSRT, NULL, AcpiDmDumpCsrt, DtCompileCsrt, TemplateCsrt},
444 {ACPI_SIG_DBG2, AcpiDmTableInfoDbg2, AcpiDmDumpDbg2, DtCompileDbg2, TemplateDbg2},
445 {ACPI_SIG_DBGP, AcpiDmTableInfoDbgp, NULL, NULL, TemplateDbgp},
446 {ACPI_SIG_DMAR, NULL, AcpiDmDumpDmar, DtCompileDmar, TemplateDmar},
447 {ACPI_SIG_DRTM, NULL, AcpiDmDumpDrtm, DtCompileDrtm, TemplateDrtm},
448 {ACPI_SIG_ECDT, AcpiDmTableInfoEcdt, NULL, NULL, TemplateEcdt},
449 {ACPI_SIG_EINJ, NULL, AcpiDmDumpEinj, DtCompileEinj, TemplateEinj},
450 {ACPI_SIG_ERST, NULL, AcpiDmDumpErst, DtCompileErst, TemplateErst},
451 {ACPI_SIG_FADT, NULL, AcpiDmDumpFadt, DtCompileFadt, TemplateFadt},
452 {ACPI_SIG_FPDT, NULL, AcpiDmDumpFpdt, DtCompileFpdt, TemplateFpdt},
453 {ACPI_SIG_GTDT, NULL, AcpiDmDumpGtdt, DtCompileGtdt, TemplateGtdt},
454 {ACPI_SIG_HEST, NULL, AcpiDmDumpHest, DtCompileHest, TemplateHest},
455 {ACPI_SIG_HPET, AcpiDmTableInfoHpet, NULL, NULL, TemplateHpet},
456 {ACPI_SIG_IORT, NULL, AcpiDmDumpIort, DtCompileIort, TemplateIort},
457 {ACPI_SIG_IVRS, NULL, AcpiDmDumpIvrs, DtCompileIvrs, TemplateIvrs},
458 {ACPI_SIG_LPIT, NULL, AcpiDmDumpLpit, DtCompileLpit, TemplateLpit},
459 {ACPI_SIG_MADT, NULL, AcpiDmDumpMadt, DtCompileMadt, TemplateMadt},
460 {ACPI_SIG_MCFG, NULL, AcpiDmDumpMcfg, DtCompileMcfg, TemplateMcfg},
461 {ACPI_SIG_MCHI, AcpiDmTableInfoMchi, NULL, NULL, TemplateMchi},
462 {ACPI_SIG_MPST, AcpiDmTableInfoMpst, AcpiDmDumpMpst, DtCompileMpst, TemplateMpst},
463 {ACPI_SIG_MSCT, NULL, AcpiDmDumpMsct, DtCompileMsct, TemplateMsct},
464 {ACPI_SIG_MSDM, NULL, AcpiDmDumpSlic, DtCompileSlic, TemplateMsdm},
465 {ACPI_SIG_MTMR, NULL, AcpiDmDumpMtmr, DtCompileMtmr, TemplateMtmr},
466 {ACPI_SIG_NFIT, AcpiDmTableInfoNfit, AcpiDmDumpNfit, DtCompileNfit, TemplateNfit},
467 {ACPI_SIG_PCCT, AcpiDmTableInfoPcct, AcpiDmDumpPcct, DtCompilePcct, TemplatePcct},
468 {ACPI_SIG_PMTT, NULL, AcpiDmDumpPmtt, DtCompilePmtt, TemplatePmtt},
469 {ACPI_SIG_RASF, AcpiDmTableInfoRasf, NULL, NULL, TemplateRasf},
470 {ACPI_SIG_RSDT, NULL, AcpiDmDumpRsdt, DtCompileRsdt, TemplateRsdt},
471 {ACPI_SIG_S3PT, NULL, NULL, NULL, TemplateS3pt},
472 {ACPI_SIG_SBST, AcpiDmTableInfoSbst, NULL, NULL, TemplateSbst},
473 {ACPI_SIG_SLIC, NULL, AcpiDmDumpSlic, DtCompileSlic, TemplateSlic},
474 {ACPI_SIG_SLIT, NULL, AcpiDmDumpSlit, DtCompileSlit, TemplateSlit},
475 {ACPI_SIG_SPCR, AcpiDmTableInfoSpcr, NULL, NULL, TemplateSpcr},
476 {ACPI_SIG_SPMI, AcpiDmTableInfoSpmi, NULL, NULL, TemplateSpmi},
477 {ACPI_SIG_SRAT, NULL, AcpiDmDumpSrat, DtCompileSrat, TemplateSrat},
478 {ACPI_SIG_STAO, NULL, AcpiDmDumpStao, DtCompileStao, TemplateStao},
479 {ACPI_SIG_TCPA, NULL, AcpiDmDumpTcpa, DtCompileTcpa, TemplateTcpa},
480 {ACPI_SIG_TPM2, AcpiDmTableInfoTpm2, NULL, NULL, TemplateTpm2},
481 {ACPI_SIG_UEFI, AcpiDmTableInfoUefi, NULL, DtCompileUefi, TemplateUefi},
482 {ACPI_SIG_VRTC, AcpiDmTableInfoVrtc, AcpiDmDumpVrtc, DtCompileVrtc, TemplateVrtc},
483 {ACPI_SIG_WAET, AcpiDmTableInfoWaet, NULL, NULL, TemplateWaet},
484 {ACPI_SIG_WDAT, NULL, AcpiDmDumpWdat, DtCompileWdat, TemplateWdat},
485 {ACPI_SIG_WDDT, AcpiDmTableInfoWddt, NULL, NULL, TemplateWddt},
486 {ACPI_SIG_WDRT, AcpiDmTableInfoWdrt, NULL, NULL, TemplateWdrt},
487 {ACPI_SIG_WPBT, NULL, AcpiDmDumpWpbt, DtCompileWpbt, TemplateWpbt},
488 {ACPI_SIG_XENV, AcpiDmTableInfoXenv, NULL, NULL, TemplateXenv},
489 {ACPI_SIG_XSDT, NULL, AcpiDmDumpXsdt, DtCompileXsdt, TemplateXsdt},
490 {NULL, NULL, NULL, NULL, NULL}
494 /*******************************************************************************
496 * FUNCTION: AcpiDmGenerateChecksum
498 * PARAMETERS: Table - Pointer to table to be checksummed
499 * Length - Length of the table
500 * OriginalChecksum - Value of the checksum field
502 * RETURN: 8 bit checksum of buffer
504 * DESCRIPTION: Computes an 8 bit checksum of the table.
506 ******************************************************************************/
509 AcpiDmGenerateChecksum (
512 UINT8 OriginalChecksum)
517 /* Sum the entire table as-is */
519 Checksum = AcpiTbChecksum ((UINT8 *) Table, Length);
521 /* Subtract off the existing checksum value in the table */
523 Checksum = (UINT8) (Checksum - OriginalChecksum);
525 /* Compute the final checksum */
527 Checksum = (UINT8) (0 - Checksum);
532 /*******************************************************************************
534 * FUNCTION: AcpiDmGetTableData
536 * PARAMETERS: Signature - ACPI signature (4 chars) to match
538 * RETURN: Pointer to a valid ACPI_DMTABLE_DATA. Null if no match found.
540 * DESCRIPTION: Find a match in the global table of supported ACPI tables
542 ******************************************************************************/
544 const ACPI_DMTABLE_DATA *
548 const ACPI_DMTABLE_DATA *Info;
551 for (Info = AcpiDmTableData; Info->Signature; Info++)
553 if (ACPI_COMPARE_NAME (Signature, Info->Signature))
563 /*******************************************************************************
565 * FUNCTION: AcpiDmDumpDataTable
567 * PARAMETERS: Table - An ACPI table
571 * DESCRIPTION: Format the contents of an ACPI data table (any table other
572 * than an SSDT or DSDT that does not contain executable AML code)
574 ******************************************************************************/
577 AcpiDmDumpDataTable (
578 ACPI_TABLE_HEADER *Table)
581 const ACPI_DMTABLE_DATA *TableData;
585 /* Ignore tables that contain AML */
587 if (AcpiUtIsAmlTable (Table))
589 if (Gbl_VerboseTemplates)
591 /* Dump the raw table data */
593 Length = Table->Length;
595 AcpiOsPrintf ("\n/*\n%s: Length %d (0x%X)\n\n",
596 ACPI_RAW_TABLE_DATA_HEADER, Length, Length);
597 AcpiUtDumpBuffer (ACPI_CAST_PTR (UINT8, Table),
598 Length, DB_BYTE_DISPLAY, 0);
599 AcpiOsPrintf (" */\n");
605 * Handle tables that don't use the common ACPI table header structure.
606 * Currently, these are the FACS, RSDP, and S3PT.
608 if (ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_FACS))
610 Length = Table->Length;
611 Status = AcpiDmDumpTable (Length, 0, Table, 0, AcpiDmTableInfoFacs);
612 if (ACPI_FAILURE (Status))
617 else if (ACPI_VALIDATE_RSDP_SIG (Table->Signature))
619 Length = AcpiDmDumpRsdp (Table);
621 else if (ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_S3PT))
623 Length = AcpiDmDumpS3pt (Table);
628 * All other tables must use the common ACPI table header, dump it now
630 Length = Table->Length;
631 Status = AcpiDmDumpTable (Length, 0, Table, 0, AcpiDmTableInfoHeader);
632 if (ACPI_FAILURE (Status))
638 /* Match signature and dispatch appropriately */
640 TableData = AcpiDmGetTableData (Table->Signature);
643 if (!strncmp (Table->Signature, "OEM", 3))
645 AcpiOsPrintf ("\n**** OEM-defined ACPI table [%4.4s], unknown contents\n\n",
650 AcpiOsPrintf ("\n**** Unknown ACPI table signature [%4.4s]\n\n",
653 fprintf (stderr, "Unknown ACPI table signature [%4.4s], ",
656 if (!AcpiGbl_ForceAmlDisassembly)
658 fprintf (stderr, "decoding ACPI table header only\n");
662 fprintf (stderr, "assuming table contains valid AML code\n");
666 else if (TableData->TableHandler)
668 /* Complex table, has a handler */
670 TableData->TableHandler (Table);
672 else if (TableData->TableInfo)
674 /* Simple table, just walk the info table */
676 Status = AcpiDmDumpTable (Length, 0, Table, 0, TableData->TableInfo);
677 if (ACPI_FAILURE (Status))
684 if (!Gbl_DoTemplates || Gbl_VerboseTemplates)
686 /* Dump the raw table data */
688 AcpiOsPrintf ("\n%s: Length %d (0x%X)\n\n",
689 ACPI_RAW_TABLE_DATA_HEADER, Length, Length);
690 AcpiUtDumpBuffer (ACPI_CAST_PTR (UINT8, Table),
691 Length, DB_BYTE_DISPLAY, 0);
696 /*******************************************************************************
698 * FUNCTION: AcpiDmLineHeader
700 * PARAMETERS: Offset - Current byte offset, from table start
701 * ByteLength - Length of the field in bytes, 0 for flags
702 * Name - Name of this field
706 * DESCRIPTION: Utility routines for formatting output lines. Displays the
707 * current table offset in hex and decimal, the field length,
708 * and the field name.
710 ******************************************************************************/
719 /* Allow a null name for fields that span multiple lines (large buffers) */
726 if (Gbl_DoTemplates && !Gbl_VerboseTemplates) /* Terse template */
730 AcpiOsPrintf ("[%.4d] %34s : ", ByteLength, Name);
736 AcpiOsPrintf ("%41s : ", Name);
740 AcpiOsPrintf ("%41s ", Name);
744 else /* Normal disassembler or verbose template */
748 AcpiOsPrintf ("[%3.3Xh %4.4d% 4d] %28s : ",
749 Offset, Offset, ByteLength, Name);
755 AcpiOsPrintf ("%44s : ", Name);
759 AcpiOsPrintf ("%44s ", Name);
773 if (Gbl_DoTemplates && !Gbl_VerboseTemplates) /* Terse template */
777 AcpiOsPrintf ("[%.4d] %30s %3d : ",
778 ByteLength, Name, Value);
782 AcpiOsPrintf ("%36s % 3d : ",
786 else /* Normal disassembler or verbose template */
790 AcpiOsPrintf ("[%3.3Xh %4.4d %3d] %24s %3d : ",
791 Offset, Offset, ByteLength, Name, Value);
795 AcpiOsPrintf ("[%3.3Xh %4.4d ] %24s %3d : ",
796 Offset, Offset, Name, Value);
802 /*******************************************************************************
804 * FUNCTION: AcpiDmDumpTable
806 * PARAMETERS: TableLength - Length of the entire ACPI table
807 * TableOffset - Starting offset within the table for this
808 * sub-descriptor (0 if main table)
809 * Table - The ACPI table
810 * SubtableLength - Length of this sub-descriptor
811 * Info - Info table for this ACPI table
815 * DESCRIPTION: Display ACPI table contents by walking the Info table.
817 * Note: This function must remain in sync with DtGetFieldLength.
819 ******************************************************************************/
826 UINT32 SubtableLength,
827 ACPI_DMTABLE_INFO *Info)
830 UINT32 CurrentOffset;
836 const AH_TABLE *TableData;
838 BOOLEAN LastOutputBlankLine = FALSE;
840 char RepairedName[8];
845 AcpiOsPrintf ("Display not implemented\n");
846 return (AE_NOT_IMPLEMENTED);
849 /* Walk entire Info table; Null name terminates */
851 for (; Info->Name; Info++)
854 * Target points to the field within the ACPI Table. CurrentOffset is
855 * the offset of the field from the start of the main table.
857 Target = ACPI_ADD_PTR (UINT8, Table, Info->Offset);
858 CurrentOffset = TableOffset + Info->Offset;
860 /* Check for beyond subtable end or (worse) beyond EOT */
862 if (SubtableLength && (Info->Offset >= SubtableLength))
865 "/**** ACPI subtable terminates early - "
866 "may be older version (dump table) */\n");
868 /* Move on to next subtable */
873 if (CurrentOffset >= TableLength)
876 "/**** ACPI table terminates "
877 "in the middle of a data structure! (dump table) */\n");
878 return (AE_BAD_DATA);
881 /* Generate the byte length for this field */
883 switch (Info->Opcode)
886 case ACPI_DMT_CHKSUM:
887 case ACPI_DMT_SPACEID:
888 case ACPI_DMT_ACCWIDTH:
896 case ACPI_DMT_HESTNTYP:
897 case ACPI_DMT_FADTPM:
898 case ACPI_DMT_EINJACT:
899 case ACPI_DMT_EINJINST:
900 case ACPI_DMT_ERSTACT:
901 case ACPI_DMT_ERSTINST:
902 case ACPI_DMT_DMAR_SCOPE:
907 case ACPI_DMT_UINT16:
915 case ACPI_DMT_UINT24:
920 case ACPI_DMT_UINT32:
928 case ACPI_DMT_UINT40:
933 case ACPI_DMT_UINT48:
939 case ACPI_DMT_UINT56:
945 case ACPI_DMT_UINT64:
967 case ACPI_DMT_BUF128:
972 case ACPI_DMT_UNICODE:
973 case ACPI_DMT_BUFFER:
974 case ACPI_DMT_RAW_BUFFER:
976 ByteLength = SubtableLength;
979 case ACPI_DMT_STRING:
981 ByteLength = strlen (ACPI_CAST_PTR (char, Target)) + 1;
986 if (!LastOutputBlankLine)
989 LastOutputBlankLine = TRUE;
992 ByteLength = sizeof (ACPI_GENERIC_ADDRESS);
995 case ACPI_DMT_HESTNTFY:
997 if (!LastOutputBlankLine)
1000 LastOutputBlankLine = TRUE;
1003 ByteLength = sizeof (ACPI_HEST_NOTIFY);
1006 case ACPI_DMT_IORTMEM:
1008 if (!LastOutputBlankLine)
1010 LastOutputBlankLine = FALSE;
1013 ByteLength = sizeof (ACPI_IORT_MEMORY_ACCESS);
1022 /* Check if we are beyond a subtable, or (worse) beyond EOT */
1024 if (CurrentOffset + ByteLength > TableLength)
1029 "/**** ACPI subtable terminates early - "
1030 "may be older version (dump table) */\n");
1032 /* Move on to next subtable */
1038 "/**** ACPI table terminates "
1039 "in the middle of a data structure! */\n");
1040 return (AE_BAD_DATA);
1043 if (Info->Opcode == ACPI_DMT_EXTRA_TEXT)
1045 AcpiOsPrintf ("%s", Info->Name);
1049 /* Start a new line and decode the opcode */
1051 AcpiDmLineHeader (CurrentOffset, ByteLength, Info->Name);
1053 switch (Info->Opcode)
1055 /* Single-bit Flag fields. Note: Opcode is the bit position */
1057 case ACPI_DMT_FLAG0:
1058 case ACPI_DMT_FLAG1:
1059 case ACPI_DMT_FLAG2:
1060 case ACPI_DMT_FLAG3:
1061 case ACPI_DMT_FLAG4:
1062 case ACPI_DMT_FLAG5:
1063 case ACPI_DMT_FLAG6:
1064 case ACPI_DMT_FLAG7:
1066 AcpiOsPrintf ("%1.1X\n", (*Target >> Info->Opcode) & 0x01);
1069 /* 2-bit Flag fields */
1071 case ACPI_DMT_FLAGS0:
1073 AcpiOsPrintf ("%1.1X\n", *Target & 0x03);
1076 case ACPI_DMT_FLAGS1:
1078 AcpiOsPrintf ("%1.1X\n", (*Target >> 1) & 0x03);
1081 case ACPI_DMT_FLAGS2:
1083 AcpiOsPrintf ("%1.1X\n", (*Target >> 2) & 0x03);
1086 case ACPI_DMT_FLAGS4:
1088 AcpiOsPrintf ("%1.1X\n", (*Target >> 4) & 0x03);
1091 /* Integer Data Types */
1093 case ACPI_DMT_UINT8:
1094 case ACPI_DMT_UINT16:
1095 case ACPI_DMT_UINT24:
1096 case ACPI_DMT_UINT32:
1097 case ACPI_DMT_UINT40:
1098 case ACPI_DMT_UINT48:
1099 case ACPI_DMT_UINT56:
1100 case ACPI_DMT_UINT64:
1102 * Dump bytes - high byte first, low byte last.
1103 * Note: All ACPI tables are little-endian.
1106 for (Temp8 = (UINT8) ByteLength; Temp8 > 0; Temp8--)
1108 AcpiOsPrintf ("%2.2X", Target[Temp8 - 1]);
1109 Value |= Target[Temp8 - 1];
1113 if (!Value && (Info->Flags & DT_DESCRIBES_OPTIONAL))
1115 AcpiOsPrintf (" [Optional field not present]");
1118 AcpiOsPrintf ("\n");
1122 case ACPI_DMT_BUF10:
1123 case ACPI_DMT_BUF12:
1124 case ACPI_DMT_BUF16:
1125 case ACPI_DMT_BUF128:
1127 * Buffer: Size depends on the opcode and was set above.
1128 * Each hex byte is separated with a space.
1129 * Multiple lines are separated by line continuation char.
1131 for (Temp16 = 0; Temp16 < ByteLength; Temp16++)
1133 AcpiOsPrintf ("%2.2X", Target[Temp16]);
1134 if ((UINT32) (Temp16 + 1) < ByteLength)
1136 if ((Temp16 > 0) && (!((Temp16+1) % 16)))
1138 AcpiOsPrintf (" \\\n"); /* Line continuation */
1139 AcpiDmLineHeader (0, 0, NULL);
1148 AcpiOsPrintf ("\n");
1153 /* Convert 16-byte UUID buffer to 36-byte formatted UUID string */
1155 (void) AuConvertUuidToString ((char *) Target, MsgBuffer);
1157 AcpiOsPrintf ("%s\n", MsgBuffer);
1160 case ACPI_DMT_STRING:
1162 AcpiOsPrintf ("\"%s\"\n", ACPI_CAST_PTR (char, Target));
1165 /* Fixed length ASCII name fields */
1169 AcpiUtCheckAndRepairAscii (Target, RepairedName, 4);
1170 AcpiOsPrintf ("\"%.4s\" ", RepairedName);
1172 TableData = AcpiAhGetTableInfo (ACPI_CAST_PTR (char, Target));
1175 AcpiOsPrintf (STRING_FORMAT, TableData->Description);
1179 AcpiOsPrintf ("\n");
1183 case ACPI_DMT_NAME4:
1185 AcpiUtCheckAndRepairAscii (Target, RepairedName, 4);
1186 AcpiOsPrintf ("\"%.4s\"\n", RepairedName);
1189 case ACPI_DMT_NAME6:
1191 AcpiUtCheckAndRepairAscii (Target, RepairedName, 6);
1192 AcpiOsPrintf ("\"%.6s\"\n", RepairedName);
1195 case ACPI_DMT_NAME8:
1197 AcpiUtCheckAndRepairAscii (Target, RepairedName, 8);
1198 AcpiOsPrintf ("\"%.8s\"\n", RepairedName);
1201 /* Special Data Types */
1203 case ACPI_DMT_CHKSUM:
1205 /* Checksum, display and validate */
1207 AcpiOsPrintf ("%2.2X", *Target);
1208 Temp8 = AcpiDmGenerateChecksum (Table,
1209 ACPI_CAST_PTR (ACPI_TABLE_HEADER, Table)->Length,
1210 ACPI_CAST_PTR (ACPI_TABLE_HEADER, Table)->Checksum);
1212 if (Temp8 != ACPI_CAST_PTR (ACPI_TABLE_HEADER, Table)->Checksum)
1215 " /* Incorrect checksum, should be %2.2X */", Temp8);
1218 AcpiOsPrintf ("\n");
1221 case ACPI_DMT_SPACEID:
1223 /* Address Space ID */
1225 AcpiOsPrintf (UINT8_FORMAT, *Target, AcpiUtGetRegionName (*Target));
1228 case ACPI_DMT_ACCWIDTH:
1230 /* Encoded Access Width */
1233 if (Temp8 > ACPI_GAS_WIDTH_RESERVED)
1235 Temp8 = ACPI_GAS_WIDTH_RESERVED;
1238 AcpiOsPrintf (UINT8_FORMAT, *Target, AcpiDmGasAccessWidth[Temp8]);
1243 /* Generic Address Structure */
1245 AcpiOsPrintf (STRING_FORMAT, "Generic Address Structure");
1246 Status = AcpiDmDumpTable (TableLength, CurrentOffset, Target,
1247 sizeof (ACPI_GENERIC_ADDRESS), AcpiDmTableInfoGas);
1248 if (ACPI_FAILURE (Status))
1253 AcpiOsPrintf ("\n");
1254 LastOutputBlankLine = TRUE;
1259 /* ASF subtable types */
1261 Temp16 = (UINT16) ((*Target) & 0x7F); /* Top bit can be zero or one */
1262 if (Temp16 > ACPI_ASF_TYPE_RESERVED)
1264 Temp16 = ACPI_ASF_TYPE_RESERVED;
1267 AcpiOsPrintf (UINT8_FORMAT, *Target, AcpiDmAsfSubnames[Temp16]);
1272 /* DMAR subtable types */
1274 Temp16 = ACPI_GET16 (Target);
1275 if (Temp16 > ACPI_DMAR_TYPE_RESERVED)
1277 Temp16 = ACPI_DMAR_TYPE_RESERVED;
1280 AcpiOsPrintf (UINT16_FORMAT, ACPI_GET16 (Target),
1281 AcpiDmDmarSubnames[Temp16]);
1284 case ACPI_DMT_DMAR_SCOPE:
1286 /* DMAR device scope types */
1289 if (Temp8 > ACPI_DMAR_SCOPE_TYPE_RESERVED)
1291 Temp8 = ACPI_DMAR_SCOPE_TYPE_RESERVED;
1294 AcpiOsPrintf (UINT8_FORMAT, *Target,
1295 AcpiDmDmarScope[Temp8]);
1298 case ACPI_DMT_EINJACT:
1300 /* EINJ Action types */
1303 if (Temp8 > ACPI_EINJ_ACTION_RESERVED)
1305 Temp8 = ACPI_EINJ_ACTION_RESERVED;
1308 AcpiOsPrintf (UINT8_FORMAT, *Target,
1309 AcpiDmEinjActions[Temp8]);
1312 case ACPI_DMT_EINJINST:
1314 /* EINJ Instruction types */
1317 if (Temp8 > ACPI_EINJ_INSTRUCTION_RESERVED)
1319 Temp8 = ACPI_EINJ_INSTRUCTION_RESERVED;
1322 AcpiOsPrintf (UINT8_FORMAT, *Target,
1323 AcpiDmEinjInstructions[Temp8]);
1326 case ACPI_DMT_ERSTACT:
1328 /* ERST Action types */
1331 if (Temp8 > ACPI_ERST_ACTION_RESERVED)
1333 Temp8 = ACPI_ERST_ACTION_RESERVED;
1336 AcpiOsPrintf (UINT8_FORMAT, *Target,
1337 AcpiDmErstActions[Temp8]);
1340 case ACPI_DMT_ERSTINST:
1342 /* ERST Instruction types */
1345 if (Temp8 > ACPI_ERST_INSTRUCTION_RESERVED)
1347 Temp8 = ACPI_ERST_INSTRUCTION_RESERVED;
1350 AcpiOsPrintf (UINT8_FORMAT, *Target,
1351 AcpiDmErstInstructions[Temp8]);
1356 /* GTDT subtable types */
1359 if (Temp8 > ACPI_GTDT_TYPE_RESERVED)
1361 Temp8 = ACPI_GTDT_TYPE_RESERVED;
1364 AcpiOsPrintf (UINT8_FORMAT, *Target,
1365 AcpiDmGtdtSubnames[Temp8]);
1370 /* HEST subtable types */
1372 Temp16 = ACPI_GET16 (Target);
1373 if (Temp16 > ACPI_HEST_TYPE_RESERVED)
1375 Temp16 = ACPI_HEST_TYPE_RESERVED;
1378 AcpiOsPrintf (UINT16_FORMAT, ACPI_GET16 (Target),
1379 AcpiDmHestSubnames[Temp16]);
1382 case ACPI_DMT_HESTNTFY:
1384 AcpiOsPrintf (STRING_FORMAT,
1385 "Hardware Error Notification Structure");
1387 Status = AcpiDmDumpTable (TableLength, CurrentOffset, Target,
1388 sizeof (ACPI_HEST_NOTIFY), AcpiDmTableInfoHestNotify);
1389 if (ACPI_FAILURE (Status))
1394 AcpiOsPrintf ("\n");
1395 LastOutputBlankLine = TRUE;
1398 case ACPI_DMT_HESTNTYP:
1400 /* HEST Notify types */
1403 if (Temp8 > ACPI_HEST_NOTIFY_RESERVED)
1405 Temp8 = ACPI_HEST_NOTIFY_RESERVED;
1408 AcpiOsPrintf (UINT8_FORMAT, *Target,
1409 AcpiDmHestNotifySubnames[Temp8]);
1412 case ACPI_DMT_IORTMEM:
1414 AcpiOsPrintf (STRING_FORMAT,
1415 "IORT Memory Access Properties");
1417 Status = AcpiDmDumpTable (TableLength, CurrentOffset, Target,
1418 sizeof (ACPI_IORT_MEMORY_ACCESS), AcpiDmTableInfoIortAcc);
1419 if (ACPI_FAILURE (Status))
1424 LastOutputBlankLine = TRUE;
1429 /* MADT subtable types */
1432 if (Temp8 > ACPI_MADT_TYPE_RESERVED)
1434 Temp8 = ACPI_MADT_TYPE_RESERVED;
1437 AcpiOsPrintf (UINT8_FORMAT, *Target,
1438 AcpiDmMadtSubnames[Temp8]);
1443 /* NFIT subtable types */
1445 Temp16 = ACPI_GET16 (Target);
1446 if (Temp16 > ACPI_NFIT_TYPE_RESERVED)
1448 Temp16 = ACPI_NFIT_TYPE_RESERVED;
1451 AcpiOsPrintf (UINT16_FORMAT, ACPI_GET16 (Target),
1452 AcpiDmNfitSubnames[Temp16]);
1457 /* PCCT subtable types */
1460 if (Temp8 > ACPI_PCCT_TYPE_RESERVED)
1462 Temp8 = ACPI_PCCT_TYPE_RESERVED;
1465 AcpiOsPrintf (UINT8_FORMAT, *Target,
1466 AcpiDmPcctSubnames[Temp8]);
1471 /* PMTT subtable types */
1474 if (Temp8 > ACPI_PMTT_TYPE_RESERVED)
1476 Temp8 = ACPI_PMTT_TYPE_RESERVED;
1479 AcpiOsPrintf (UINT8_FORMAT, *Target,
1480 AcpiDmPmttSubnames[Temp8]);
1483 case ACPI_DMT_UNICODE:
1485 if (ByteLength == 0)
1487 AcpiOsPrintf ("/* Zero-length Data */\n");
1491 AcpiDmDumpUnicode (Table, CurrentOffset, ByteLength);
1494 case ACPI_DMT_RAW_BUFFER:
1496 if (ByteLength == 0)
1498 AcpiOsPrintf ("/* Zero-length Data */\n");
1502 AcpiDmDumpBuffer (Table, CurrentOffset, ByteLength,
1503 CurrentOffset, NULL);
1508 /* SRAT subtable types */
1511 if (Temp8 > ACPI_SRAT_TYPE_RESERVED)
1513 Temp8 = ACPI_SRAT_TYPE_RESERVED;
1516 AcpiOsPrintf (UINT8_FORMAT, *Target,
1517 AcpiDmSratSubnames[Temp8]);
1520 case ACPI_DMT_FADTPM:
1522 /* FADT Preferred PM Profile names */
1525 if (Temp8 > ACPI_FADT_PM_RESERVED)
1527 Temp8 = ACPI_FADT_PM_RESERVED;
1530 AcpiOsPrintf (UINT8_FORMAT, *Target,
1531 AcpiDmFadtProfiles[Temp8]);
1536 /* IVRS subtable types */
1541 case ACPI_IVRS_TYPE_HARDWARE:
1543 Name = AcpiDmIvrsSubnames[0];
1546 case ACPI_IVRS_TYPE_MEMORY1:
1547 case ACPI_IVRS_TYPE_MEMORY2:
1548 case ACPI_IVRS_TYPE_MEMORY3:
1550 Name = AcpiDmIvrsSubnames[1];
1555 Name = AcpiDmIvrsSubnames[2];
1559 AcpiOsPrintf (UINT8_FORMAT, *Target, Name);
1564 /* LPIT subtable types */
1566 Temp32 = ACPI_GET32 (Target);
1567 if (Temp32 > ACPI_LPIT_TYPE_RESERVED)
1569 Temp32 = ACPI_LPIT_TYPE_RESERVED;
1572 AcpiOsPrintf (UINT32_FORMAT, ACPI_GET32 (Target),
1573 AcpiDmLpitSubnames[Temp32]);
1582 ACPI_ERROR ((AE_INFO,
1583 "**** Invalid table opcode [0x%X] ****\n", Info->Opcode));
1584 return (AE_SUPPORT);
1588 if (TableOffset && !SubtableLength)
1591 * If this table is not the main table, the subtable must have a
1594 AcpiOsPrintf ("Invalid zero length subtable\n");
1595 return (AE_BAD_DATA);