| /****************************************************************************** |
| * |
| * Module Name: dmtables - disassembler ACPI table support |
| * |
| *****************************************************************************/ |
| |
| /* |
| * Copyright (C) 2000 - 2023, Intel Corp. |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions, and the following disclaimer, |
| * without modification. |
| * 2. Redistributions in binary form must reproduce at minimum a disclaimer |
| * substantially similar to the "NO WARRANTY" disclaimer below |
| * ("Disclaimer") and any redistribution must be conditioned upon |
| * including a substantially similar Disclaimer requirement for further |
| * binary redistribution. |
| * 3. Neither the names of the above-listed copyright holders nor the names |
| * of any contributors may be used to endorse or promote products derived |
| * from this software without specific prior written permission. |
| * |
| * Alternatively, this software may be distributed under the terms of the |
| * GNU General Public License ("GPL") version 2 as published by the Free |
| * Software Foundation. |
| * |
| * NO WARRANTY |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
| * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
| * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, |
| * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING |
| * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
| * POSSIBILITY OF SUCH DAMAGES. |
| */ |
| |
| #include "aslcompiler.h" |
| #include "acdispat.h" |
| #include "acnamesp.h" |
| #include "actables.h" |
| #include "acparser.h" |
| #include "acapps.h" |
| #include "acmacros.h" |
| #include "acconvert.h" |
| |
| |
| #define _COMPONENT ACPI_TOOLS |
| ACPI_MODULE_NAME ("dmtables") |
| |
| |
| /* Local prototypes */ |
| |
| static void |
| AdCreateTableHeader ( |
| char *Filename, |
| ACPI_TABLE_HEADER *Table); |
| |
| static ACPI_STATUS |
| AdStoreTable ( |
| ACPI_TABLE_HEADER *Table, |
| UINT32 *TableIndex); |
| |
| |
| extern ACPI_TABLE_DESC LocalTables[1]; |
| extern ACPI_PARSE_OBJECT *AcpiGbl_ParseOpRoot; |
| |
| |
| /****************************************************************************** |
| * |
| * FUNCTION: AdDisassemblerHeader |
| * |
| * PARAMETERS: Filename - Input file for the table |
| * TableType - Either AML or DataTable |
| * |
| * RETURN: None |
| * |
| * DESCRIPTION: Create the disassembler header, including ACPICA signon with |
| * current time and date. |
| * |
| *****************************************************************************/ |
| |
| void |
| AdDisassemblerHeader ( |
| char *Filename, |
| UINT8 TableType) |
| { |
| time_t Timer; |
| |
| |
| time (&Timer); |
| |
| /* Header and input table info */ |
| |
| AcpiOsPrintf ("/*\n"); |
| AcpiOsPrintf (ACPI_COMMON_HEADER (AML_DISASSEMBLER_NAME, " * ")); |
| |
| if (TableType == ACPI_IS_AML_TABLE) |
| { |
| if (AcpiGbl_CstyleDisassembly) |
| { |
| AcpiOsPrintf ( |
| " * Disassembling to symbolic ASL+ operators\n" |
| " *\n"); |
| } |
| else |
| { |
| AcpiOsPrintf ( |
| " * Disassembling to non-symbolic legacy ASL operators\n" |
| " *\n"); |
| } |
| } |
| |
| AcpiOsPrintf (" * Disassembly of %s, %s", Filename, ctime (&Timer)); |
| AcpiOsPrintf (" *\n"); |
| } |
| |
| |
| /****************************************************************************** |
| * |
| * FUNCTION: AdCreateTableHeader |
| * |
| * PARAMETERS: Filename - Input file for the table |
| * Table - Pointer to the raw table |
| * |
| * RETURN: None |
| * |
| * DESCRIPTION: Create the ASL table header, including ACPICA signon with |
| * current time and date. |
| * |
| *****************************************************************************/ |
| |
| static void |
| AdCreateTableHeader ( |
| char *Filename, |
| ACPI_TABLE_HEADER *Table) |
| { |
| UINT8 Checksum; |
| |
| |
| /* Reset globals for External statements */ |
| |
| AcpiGbl_NumExternalMethods = 0; |
| AcpiGbl_ResolvedExternalMethods = 0; |
| |
| /* |
| * Print file header and dump original table header |
| */ |
| AdDisassemblerHeader (Filename, ACPI_IS_AML_TABLE); |
| |
| AcpiOsPrintf (" * Original Table Header:\n"); |
| AcpiOsPrintf (" * Signature \"%4.4s\"\n", Table->Signature); |
| AcpiOsPrintf (" * Length 0x%8.8X (%u)\n", Table->Length, Table->Length); |
| |
| /* Print and validate the revision */ |
| |
| AcpiOsPrintf (" * Revision 0x%2.2X", Table->Revision); |
| |
| switch (Table->Revision) |
| { |
| case 0: |
| |
| AcpiOsPrintf (" **** Invalid Revision"); |
| break; |
| |
| case 1: |
| |
| /* Revision of DSDT controls the ACPI integer width */ |
| |
| if (ACPI_COMPARE_NAMESEG (Table->Signature, ACPI_SIG_DSDT)) |
| { |
| AcpiOsPrintf (" **** 32-bit table (V1), no 64-bit math support"); |
| } |
| break; |
| |
| default: |
| |
| break; |
| } |
| |
| /* Print and validate the table checksum */ |
| |
| AcpiOsPrintf ("\n * Checksum 0x%2.2X", Table->Checksum); |
| |
| Checksum = AcpiUtChecksum (ACPI_CAST_PTR (UINT8, Table), Table->Length); |
| if (Checksum) |
| { |
| AcpiOsPrintf (" **** Incorrect checksum, should be 0x%2.2X", |
| (UINT8) (Table->Checksum - Checksum)); |
| } |
| |
| AcpiOsPrintf ("\n"); |
| AcpiOsPrintf (" * OEM ID \"%.6s\"\n", Table->OemId); |
| AcpiOsPrintf (" * OEM Table ID \"%.8s\"\n", Table->OemTableId); |
| AcpiOsPrintf (" * OEM Revision 0x%8.8X (%u)\n", Table->OemRevision, Table->OemRevision); |
| AcpiOsPrintf (" * Compiler ID \"%.4s\"\n", Table->AslCompilerId); |
| AcpiOsPrintf (" * Compiler Version 0x%8.8X (%u)\n", Table->AslCompilerRevision, Table->AslCompilerRevision); |
| AcpiOsPrintf (" */\n"); |
| |
| /* |
| * Print comments that come before this definition block. |
| */ |
| if (AcpiGbl_CaptureComments) |
| { |
| ASL_CV_PRINT_ONE_COMMENT(AcpiGbl_ParseOpRoot,AML_COMMENT_STANDARD, NULL, 0); |
| } |
| |
| /* |
| * Open the ASL definition block. |
| * |
| * Note: the AMLFilename string is left zero-length in order to just let |
| * the compiler create it when the disassembled file is compiled. This |
| * makes it easier to rename the disassembled ASL file if needed. |
| */ |
| AcpiOsPrintf ( |
| "DefinitionBlock (\"\", \"%4.4s\", %u, \"%.6s\", \"%.8s\", 0x%8.8X)\n", |
| Table->Signature, Table->Revision, |
| Table->OemId, Table->OemTableId, Table->OemRevision); |
| } |
| |
| |
| /****************************************************************************** |
| * |
| * FUNCTION: AdDisplayTables |
| * |
| * PARAMETERS: Filename - Input file for the table |
| * Table - Pointer to the raw table |
| * |
| * RETURN: Status |
| * |
| * DESCRIPTION: Display (disassemble) loaded tables and dump raw tables |
| * |
| *****************************************************************************/ |
| |
| ACPI_STATUS |
| AdDisplayTables ( |
| char *Filename, |
| ACPI_TABLE_HEADER *Table) |
| { |
| |
| |
| if (!AcpiGbl_ParseOpRoot) |
| { |
| return (AE_NOT_EXIST); |
| } |
| |
| if (!AcpiGbl_DmOpt_Listing) |
| { |
| AdCreateTableHeader (Filename, Table); |
| } |
| |
| AcpiDmDisassemble (NULL, AcpiGbl_ParseOpRoot, ACPI_UINT32_MAX); |
| MpEmitMappingInfo (); |
| |
| if (AcpiGbl_DmOpt_Listing) |
| { |
| AcpiOsPrintf ("\n\nTable Header:\n"); |
| AcpiUtDebugDumpBuffer ((UINT8 *) Table, sizeof (ACPI_TABLE_HEADER), |
| DB_BYTE_DISPLAY, ACPI_UINT32_MAX); |
| |
| AcpiOsPrintf ("Table Body (Length 0x%X)\n", Table->Length); |
| AcpiUtDebugDumpBuffer (((UINT8 *) Table + sizeof (ACPI_TABLE_HEADER)), |
| Table->Length, DB_BYTE_DISPLAY, ACPI_UINT32_MAX); |
| } |
| |
| return (AE_OK); |
| } |
| |
| |
| /******************************************************************************* |
| * |
| * FUNCTION: AdStoreTable |
| * |
| * PARAMETERS: Table - Table header |
| * TableIndex - Where the table index is returned |
| * |
| * RETURN: Status and table index. |
| * |
| * DESCRIPTION: Add an ACPI table to the global table list |
| * |
| ******************************************************************************/ |
| |
| static ACPI_STATUS |
| AdStoreTable ( |
| ACPI_TABLE_HEADER *Table, |
| UINT32 *TableIndex) |
| { |
| ACPI_STATUS Status; |
| ACPI_TABLE_DESC *TableDesc; |
| |
| |
| Status = AcpiTbGetNextTableDescriptor (TableIndex, &TableDesc); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| |
| /* Initialize added table */ |
| |
| AcpiTbInitTableDescriptor (TableDesc, ACPI_PTR_TO_PHYSADDR (Table), |
| ACPI_TABLE_ORIGIN_INTERNAL_VIRTUAL, Table); |
| Status = AcpiTbValidateTable (TableDesc); |
| return (Status); |
| } |
| |
| |
| /****************************************************************************** |
| * |
| * FUNCTION: AdGetLocalTables |
| * |
| * PARAMETERS: None |
| * |
| * RETURN: Status |
| * |
| * DESCRIPTION: Get the ACPI tables from either memory or a file |
| * |
| *****************************************************************************/ |
| |
| ACPI_STATUS |
| AdGetLocalTables ( |
| void) |
| { |
| ACPI_STATUS Status; |
| ACPI_TABLE_HEADER TableHeader; |
| ACPI_TABLE_HEADER *NewTable; |
| UINT32 TableIndex; |
| |
| |
| /* Get the DSDT via table override */ |
| |
| ACPI_MOVE_32_TO_32 (TableHeader.Signature, ACPI_SIG_DSDT); |
| Status = AcpiOsTableOverride (&TableHeader, &NewTable); |
| if (ACPI_FAILURE (Status) || !NewTable) |
| { |
| fprintf (stderr, "Could not obtain DSDT\n"); |
| return (AE_NO_ACPI_TABLES); |
| } |
| |
| AdWriteTable (NewTable, NewTable->Length, |
| ACPI_SIG_DSDT, NewTable->OemTableId); |
| |
| /* Store DSDT in the Table Manager */ |
| |
| Status = AdStoreTable (NewTable, &TableIndex); |
| if (ACPI_FAILURE (Status)) |
| { |
| fprintf (stderr, "Could not store DSDT\n"); |
| return (AE_NO_ACPI_TABLES); |
| } |
| |
| return (AE_OK); |
| } |
| |
| |
| /****************************************************************************** |
| * |
| * FUNCTION: AdParseTable |
| * |
| * PARAMETERS: Table - Pointer to the raw table |
| * OwnerId - Returned OwnerId of the table |
| * LoadTable - If add table to the global table list |
| * External - If this is an external table |
| * |
| * RETURN: Status |
| * |
| * DESCRIPTION: Parse an ACPI AML table |
| * |
| *****************************************************************************/ |
| |
| ACPI_STATUS |
| AdParseTable ( |
| ACPI_TABLE_HEADER *Table, |
| ACPI_OWNER_ID *OwnerId, |
| BOOLEAN LoadTable, |
| BOOLEAN External) |
| { |
| ACPI_STATUS Status = AE_OK; |
| ACPI_WALK_STATE *WalkState; |
| UINT8 *AmlStart; |
| UINT32 AmlLength; |
| UINT32 TableIndex; |
| |
| |
| if (!Table) |
| { |
| return (AE_NOT_EXIST); |
| } |
| |
| /* Pass 1: Parse everything except control method bodies */ |
| |
| fprintf (stderr, "Pass 1 parse of [%4.4s]\n", (char *) Table->Signature); |
| |
| AmlLength = Table->Length - sizeof (ACPI_TABLE_HEADER); |
| AmlStart = ((UINT8 *) Table + sizeof (ACPI_TABLE_HEADER)); |
| |
| AcpiUtSetIntegerWidth (Table->Revision); |
| |
| /* Create the root object */ |
| |
| AcpiGbl_ParseOpRoot = AcpiPsCreateScopeOp (AmlStart); |
| if (!AcpiGbl_ParseOpRoot) |
| { |
| return (AE_NO_MEMORY); |
| } |
| |
| #ifdef ACPI_ASL_COMPILER |
| if (AcpiGbl_CaptureComments) |
| { |
| AcpiGbl_ParseOpRoot->Common.CvFilename = AcpiGbl_FileTreeRoot->Filename; |
| } |
| else |
| { |
| AcpiGbl_ParseOpRoot->Common.CvFilename = NULL; |
| } |
| #endif |
| |
| /* Create and initialize a new walk state */ |
| |
| WalkState = AcpiDsCreateWalkState (0, AcpiGbl_ParseOpRoot, NULL, NULL); |
| if (!WalkState) |
| { |
| return (AE_NO_MEMORY); |
| } |
| |
| Status = AcpiDsInitAmlWalk (WalkState, AcpiGbl_ParseOpRoot, |
| NULL, AmlStart, AmlLength, NULL, ACPI_IMODE_LOAD_PASS1); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| |
| WalkState->ParseFlags &= ~ACPI_PARSE_DELETE_TREE; |
| |
| Status = AcpiPsParseAml (WalkState); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| |
| /* If LoadTable is FALSE, we are parsing the last loaded table */ |
| |
| TableIndex = AcpiGbl_RootTableList.CurrentTableCount - 1; |
| |
| /* Pass 2 */ |
| |
| if (LoadTable) |
| { |
| Status = AdStoreTable (Table, &TableIndex); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| Status = AcpiTbAllocateOwnerId (TableIndex); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| if (OwnerId) |
| { |
| Status = AcpiTbGetOwnerId (TableIndex, OwnerId); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| } |
| } |
| |
| fprintf (stderr, "Pass 2 parse of [%4.4s]\n", (char *) Table->Signature); |
| |
| Status = AcpiNsOneCompleteParse (ACPI_IMODE_LOAD_PASS2, TableIndex, NULL); |
| if (ACPI_FAILURE (Status)) |
| { |
| return (Status); |
| } |
| |
| /* No need to parse control methods of external table */ |
| |
| if (External) |
| { |
| return (AE_OK); |
| } |
| |
| /* |
| * Pass 3: Parse control methods and link their parse trees |
| * into the main parse tree |
| */ |
| fprintf (stderr, |
| "Parsing Deferred Opcodes (Methods/Buffers/Packages/Regions)\n"); |
| |
| (void) AcpiDmParseDeferredOps (AcpiGbl_ParseOpRoot); |
| fprintf (stderr, "\n"); |
| |
| /* Process Resource Templates */ |
| |
| AcpiDmFindResources (AcpiGbl_ParseOpRoot); |
| |
| fprintf (stderr, "Parsing completed\n"); |
| return (AE_OK); |
| } |