xref: /illumos-gate/usr/src/cmd/acpi/acpidump/apdump.c (revision 35786f68)
17b1019a6SJerry Jelinek /******************************************************************************
27b1019a6SJerry Jelinek  *
37b1019a6SJerry Jelinek  * Module Name: apdump - Dump routines for ACPI tables (acpidump)
47b1019a6SJerry Jelinek  *
57b1019a6SJerry Jelinek  *****************************************************************************/
67b1019a6SJerry Jelinek 
7*35786f68SRobert Mustacchi /******************************************************************************
8*35786f68SRobert Mustacchi  *
9*35786f68SRobert Mustacchi  * 1. Copyright Notice
10*35786f68SRobert Mustacchi  *
11*35786f68SRobert Mustacchi  * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
127b1019a6SJerry Jelinek  * All rights reserved.
137b1019a6SJerry Jelinek  *
14*35786f68SRobert Mustacchi  * 2. License
15*35786f68SRobert Mustacchi  *
16*35786f68SRobert Mustacchi  * 2.1. This is your license from Intel Corp. under its intellectual property
17*35786f68SRobert Mustacchi  * rights. You may have additional license terms from the party that provided
18*35786f68SRobert Mustacchi  * you this software, covering your right to use that party's intellectual
19*35786f68SRobert Mustacchi  * property rights.
20*35786f68SRobert Mustacchi  *
21*35786f68SRobert Mustacchi  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22*35786f68SRobert Mustacchi  * copy of the source code appearing in this file ("Covered Code") an
23*35786f68SRobert Mustacchi  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24*35786f68SRobert Mustacchi  * base code distributed originally by Intel ("Original Intel Code") to copy,
25*35786f68SRobert Mustacchi  * make derivatives, distribute, use and display any portion of the Covered
26*35786f68SRobert Mustacchi  * Code in any form, with the right to sublicense such rights; and
27*35786f68SRobert Mustacchi  *
28*35786f68SRobert Mustacchi  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29*35786f68SRobert Mustacchi  * license (with the right to sublicense), under only those claims of Intel
30*35786f68SRobert Mustacchi  * patents that are infringed by the Original Intel Code, to make, use, sell,
31*35786f68SRobert Mustacchi  * offer to sell, and import the Covered Code and derivative works thereof
32*35786f68SRobert Mustacchi  * solely to the minimum extent necessary to exercise the above copyright
33*35786f68SRobert Mustacchi  * license, and in no event shall the patent license extend to any additions
34*35786f68SRobert Mustacchi  * to or modifications of the Original Intel Code. No other license or right
35*35786f68SRobert Mustacchi  * is granted directly or by implication, estoppel or otherwise;
36*35786f68SRobert Mustacchi  *
37*35786f68SRobert Mustacchi  * The above copyright and patent license is granted only if the following
38*35786f68SRobert Mustacchi  * conditions are met:
39*35786f68SRobert Mustacchi  *
40*35786f68SRobert Mustacchi  * 3. Conditions
41*35786f68SRobert Mustacchi  *
42*35786f68SRobert Mustacchi  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43*35786f68SRobert Mustacchi  * Redistribution of source code of any substantial portion of the Covered
44*35786f68SRobert Mustacchi  * Code or modification with rights to further distribute source must include
45*35786f68SRobert Mustacchi  * the above Copyright Notice, the above License, this list of Conditions,
46*35786f68SRobert Mustacchi  * and the following Disclaimer and Export Compliance provision. In addition,
47*35786f68SRobert Mustacchi  * Licensee must cause all Covered Code to which Licensee contributes to
48*35786f68SRobert Mustacchi  * contain a file documenting the changes Licensee made to create that Covered
49*35786f68SRobert Mustacchi  * Code and the date of any change. Licensee must include in that file the
50*35786f68SRobert Mustacchi  * documentation of any changes made by any predecessor Licensee. Licensee
51*35786f68SRobert Mustacchi  * must include a prominent statement that the modification is derived,
52*35786f68SRobert Mustacchi  * directly or indirectly, from Original Intel Code.
53*35786f68SRobert Mustacchi  *
54*35786f68SRobert Mustacchi  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55*35786f68SRobert Mustacchi  * Redistribution of source code of any substantial portion of the Covered
56*35786f68SRobert Mustacchi  * Code or modification without rights to further distribute source must
57*35786f68SRobert Mustacchi  * include the following Disclaimer and Export Compliance provision in the
58*35786f68SRobert Mustacchi  * documentation and/or other materials provided with distribution. In
59*35786f68SRobert Mustacchi  * addition, Licensee may not authorize further sublicense of source of any
60*35786f68SRobert Mustacchi  * portion of the Covered Code, and must include terms to the effect that the
61*35786f68SRobert Mustacchi  * license from Licensee to its licensee is limited to the intellectual
62*35786f68SRobert Mustacchi  * property embodied in the software Licensee provides to its licensee, and
63*35786f68SRobert Mustacchi  * not to intellectual property embodied in modifications its licensee may
64*35786f68SRobert Mustacchi  * make.
65*35786f68SRobert Mustacchi  *
66*35786f68SRobert Mustacchi  * 3.3. Redistribution of Executable. Redistribution in executable form of any
67*35786f68SRobert Mustacchi  * substantial portion of the Covered Code or modification must reproduce the
68*35786f68SRobert Mustacchi  * above Copyright Notice, and the following Disclaimer and Export Compliance
69*35786f68SRobert Mustacchi  * provision in the documentation and/or other materials provided with the
70*35786f68SRobert Mustacchi  * distribution.
71*35786f68SRobert Mustacchi  *
72*35786f68SRobert Mustacchi  * 3.4. Intel retains all right, title, and interest in and to the Original
73*35786f68SRobert Mustacchi  * Intel Code.
74*35786f68SRobert Mustacchi  *
75*35786f68SRobert Mustacchi  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76*35786f68SRobert Mustacchi  * Intel shall be used in advertising or otherwise to promote the sale, use or
77*35786f68SRobert Mustacchi  * other dealings in products derived from or relating to the Covered Code
78*35786f68SRobert Mustacchi  * without prior written authorization from Intel.
79*35786f68SRobert Mustacchi  *
80*35786f68SRobert Mustacchi  * 4. Disclaimer and Export Compliance
81*35786f68SRobert Mustacchi  *
82*35786f68SRobert Mustacchi  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83*35786f68SRobert Mustacchi  * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84*35786f68SRobert Mustacchi  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85*35786f68SRobert Mustacchi  * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86*35786f68SRobert Mustacchi  * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87*35786f68SRobert Mustacchi  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88*35786f68SRobert Mustacchi  * PARTICULAR PURPOSE.
89*35786f68SRobert Mustacchi  *
90*35786f68SRobert Mustacchi  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91*35786f68SRobert Mustacchi  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92*35786f68SRobert Mustacchi  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93*35786f68SRobert Mustacchi  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94*35786f68SRobert Mustacchi  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95*35786f68SRobert Mustacchi  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96*35786f68SRobert Mustacchi  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97*35786f68SRobert Mustacchi  * LIMITED REMEDY.
98*35786f68SRobert Mustacchi  *
99*35786f68SRobert Mustacchi  * 4.3. Licensee shall not export, either directly or indirectly, any of this
100*35786f68SRobert Mustacchi  * software or system incorporating such software without first obtaining any
101*35786f68SRobert Mustacchi  * required license or other approval from the U. S. Department of Commerce or
102*35786f68SRobert Mustacchi  * any other agency or department of the United States Government. In the
103*35786f68SRobert Mustacchi  * event Licensee exports any such software from the United States or
104*35786f68SRobert Mustacchi  * re-exports any such software from a foreign destination, Licensee shall
105*35786f68SRobert Mustacchi  * ensure that the distribution and export/re-export of the software is in
106*35786f68SRobert Mustacchi  * compliance with all laws, regulations, orders, or other restrictions of the
107*35786f68SRobert Mustacchi  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108*35786f68SRobert Mustacchi  * any of its subsidiaries will export/re-export any technical data, process,
109*35786f68SRobert Mustacchi  * software, or service, directly or indirectly, to any country for which the
110*35786f68SRobert Mustacchi  * United States government or any agency thereof requires an export license,
111*35786f68SRobert Mustacchi  * other governmental approval, or letter of assurance, without first obtaining
112*35786f68SRobert Mustacchi  * such license, approval or letter.
113*35786f68SRobert Mustacchi  *
114*35786f68SRobert Mustacchi  *****************************************************************************
115*35786f68SRobert Mustacchi  *
116*35786f68SRobert Mustacchi  * Alternatively, you may choose to be licensed under the terms of the
117*35786f68SRobert Mustacchi  * following license:
118*35786f68SRobert Mustacchi  *
1197b1019a6SJerry Jelinek  * Redistribution and use in source and binary forms, with or without
1207b1019a6SJerry Jelinek  * modification, are permitted provided that the following conditions
1217b1019a6SJerry Jelinek  * are met:
1227b1019a6SJerry Jelinek  * 1. Redistributions of source code must retain the above copyright
1237b1019a6SJerry Jelinek  *    notice, this list of conditions, and the following disclaimer,
1247b1019a6SJerry Jelinek  *    without modification.
1257b1019a6SJerry Jelinek  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
1267b1019a6SJerry Jelinek  *    substantially similar to the "NO WARRANTY" disclaimer below
1277b1019a6SJerry Jelinek  *    ("Disclaimer") and any redistribution must be conditioned upon
1287b1019a6SJerry Jelinek  *    including a substantially similar Disclaimer requirement for further
1297b1019a6SJerry Jelinek  *    binary redistribution.
1307b1019a6SJerry Jelinek  * 3. Neither the names of the above-listed copyright holders nor the names
1317b1019a6SJerry Jelinek  *    of any contributors may be used to endorse or promote products derived
1327b1019a6SJerry Jelinek  *    from this software without specific prior written permission.
1337b1019a6SJerry Jelinek  *
1347b1019a6SJerry Jelinek  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
1357b1019a6SJerry Jelinek  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136*35786f68SRobert Mustacchi  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
1377b1019a6SJerry Jelinek  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138*35786f68SRobert Mustacchi  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139*35786f68SRobert Mustacchi  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140*35786f68SRobert Mustacchi  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141*35786f68SRobert Mustacchi  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142*35786f68SRobert Mustacchi  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143*35786f68SRobert Mustacchi  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144*35786f68SRobert Mustacchi  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145*35786f68SRobert Mustacchi  *
146*35786f68SRobert Mustacchi  * Alternatively, you may choose to be licensed under the terms of the
147*35786f68SRobert Mustacchi  * GNU General Public License ("GPL") version 2 as published by the Free
148*35786f68SRobert Mustacchi  * Software Foundation.
149*35786f68SRobert Mustacchi  *
150*35786f68SRobert Mustacchi  *****************************************************************************/
1517b1019a6SJerry Jelinek 
1527b1019a6SJerry Jelinek #include "acpidump.h"
1537b1019a6SJerry Jelinek 
1547b1019a6SJerry Jelinek 
1557b1019a6SJerry Jelinek /* Local prototypes */
1567b1019a6SJerry Jelinek 
1577b1019a6SJerry Jelinek static int
1587b1019a6SJerry Jelinek ApDumpTableBuffer (
1597b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table,
1607b1019a6SJerry Jelinek     UINT32                  Instance,
1617b1019a6SJerry Jelinek     ACPI_PHYSICAL_ADDRESS   Address);
1627b1019a6SJerry Jelinek 
1637b1019a6SJerry Jelinek 
1647b1019a6SJerry Jelinek /******************************************************************************
1657b1019a6SJerry Jelinek  *
1667b1019a6SJerry Jelinek  * FUNCTION:    ApIsValidHeader
1677b1019a6SJerry Jelinek  *
1687b1019a6SJerry Jelinek  * PARAMETERS:  Table               - Pointer to table to be validated
1697b1019a6SJerry Jelinek  *
1707b1019a6SJerry Jelinek  * RETURN:      TRUE if the header appears to be valid. FALSE otherwise
1717b1019a6SJerry Jelinek  *
1727b1019a6SJerry Jelinek  * DESCRIPTION: Check for a valid ACPI table header
1737b1019a6SJerry Jelinek  *
1747b1019a6SJerry Jelinek  ******************************************************************************/
1757b1019a6SJerry Jelinek 
1767b1019a6SJerry Jelinek BOOLEAN
ApIsValidHeader(ACPI_TABLE_HEADER * Table)1777b1019a6SJerry Jelinek ApIsValidHeader (
1787b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table)
1797b1019a6SJerry Jelinek {
1807b1019a6SJerry Jelinek 
1817b1019a6SJerry Jelinek     if (!ACPI_VALIDATE_RSDP_SIG (Table->Signature))
1827b1019a6SJerry Jelinek     {
1837b1019a6SJerry Jelinek         /* Make sure signature is all ASCII and a valid ACPI name */
1847b1019a6SJerry Jelinek 
1857b1019a6SJerry Jelinek         if (!AcpiUtValidNameseg (Table->Signature))
1867b1019a6SJerry Jelinek         {
187*35786f68SRobert Mustacchi             fprintf (stderr, "Table signature (0x%8.8X) is invalid\n",
1887b1019a6SJerry Jelinek                 *(UINT32 *) Table->Signature);
1897b1019a6SJerry Jelinek             return (FALSE);
1907b1019a6SJerry Jelinek         }
1917b1019a6SJerry Jelinek 
1927b1019a6SJerry Jelinek         /* Check for minimum table length */
1937b1019a6SJerry Jelinek 
1947b1019a6SJerry Jelinek         if (Table->Length < sizeof (ACPI_TABLE_HEADER))
1957b1019a6SJerry Jelinek         {
196*35786f68SRobert Mustacchi             fprintf (stderr, "Table length (0x%8.8X) is invalid\n",
1977b1019a6SJerry Jelinek                 Table->Length);
1987b1019a6SJerry Jelinek             return (FALSE);
1997b1019a6SJerry Jelinek         }
2007b1019a6SJerry Jelinek     }
2017b1019a6SJerry Jelinek 
2027b1019a6SJerry Jelinek     return (TRUE);
2037b1019a6SJerry Jelinek }
2047b1019a6SJerry Jelinek 
2057b1019a6SJerry Jelinek 
2067b1019a6SJerry Jelinek /******************************************************************************
2077b1019a6SJerry Jelinek  *
2087b1019a6SJerry Jelinek  * FUNCTION:    ApIsValidChecksum
2097b1019a6SJerry Jelinek  *
2107b1019a6SJerry Jelinek  * PARAMETERS:  Table               - Pointer to table to be validated
2117b1019a6SJerry Jelinek  *
2127b1019a6SJerry Jelinek  * RETURN:      TRUE if the checksum appears to be valid. FALSE otherwise.
2137b1019a6SJerry Jelinek  *
2147b1019a6SJerry Jelinek  * DESCRIPTION: Check for a valid ACPI table checksum.
2157b1019a6SJerry Jelinek  *
2167b1019a6SJerry Jelinek  ******************************************************************************/
2177b1019a6SJerry Jelinek 
2187b1019a6SJerry Jelinek BOOLEAN
ApIsValidChecksum(ACPI_TABLE_HEADER * Table)2197b1019a6SJerry Jelinek ApIsValidChecksum (
2207b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table)
2217b1019a6SJerry Jelinek {
2227b1019a6SJerry Jelinek     ACPI_STATUS             Status;
2237b1019a6SJerry Jelinek     ACPI_TABLE_RSDP         *Rsdp;
2247b1019a6SJerry Jelinek 
2257b1019a6SJerry Jelinek 
2267b1019a6SJerry Jelinek     if (ACPI_VALIDATE_RSDP_SIG (Table->Signature))
2277b1019a6SJerry Jelinek     {
2287b1019a6SJerry Jelinek         /*
2297b1019a6SJerry Jelinek          * Checksum for RSDP.
2307b1019a6SJerry Jelinek          * Note: Other checksums are computed during the table dump.
2317b1019a6SJerry Jelinek          */
2327b1019a6SJerry Jelinek         Rsdp = ACPI_CAST_PTR (ACPI_TABLE_RSDP, Table);
2337b1019a6SJerry Jelinek         Status = AcpiTbValidateRsdp (Rsdp);
2347b1019a6SJerry Jelinek     }
2357b1019a6SJerry Jelinek     else
2367b1019a6SJerry Jelinek     {
2377b1019a6SJerry Jelinek         Status = AcpiTbVerifyChecksum (Table, Table->Length);
2387b1019a6SJerry Jelinek     }
2397b1019a6SJerry Jelinek 
2407b1019a6SJerry Jelinek     if (ACPI_FAILURE (Status))
2417b1019a6SJerry Jelinek     {
242*35786f68SRobert Mustacchi         fprintf (stderr, "%4.4s: Warning: wrong checksum in table\n",
2437b1019a6SJerry Jelinek             Table->Signature);
2447b1019a6SJerry Jelinek     }
2457b1019a6SJerry Jelinek 
2467b1019a6SJerry Jelinek     return (AE_OK);
2477b1019a6SJerry Jelinek }
2487b1019a6SJerry Jelinek 
2497b1019a6SJerry Jelinek 
2507b1019a6SJerry Jelinek /******************************************************************************
2517b1019a6SJerry Jelinek  *
2527b1019a6SJerry Jelinek  * FUNCTION:    ApGetTableLength
2537b1019a6SJerry Jelinek  *
2547b1019a6SJerry Jelinek  * PARAMETERS:  Table               - Pointer to the table
2557b1019a6SJerry Jelinek  *
2567b1019a6SJerry Jelinek  * RETURN:      Table length
2577b1019a6SJerry Jelinek  *
2587b1019a6SJerry Jelinek  * DESCRIPTION: Obtain table length according to table signature.
2597b1019a6SJerry Jelinek  *
2607b1019a6SJerry Jelinek  ******************************************************************************/
2617b1019a6SJerry Jelinek 
2627b1019a6SJerry Jelinek UINT32
ApGetTableLength(ACPI_TABLE_HEADER * Table)2637b1019a6SJerry Jelinek ApGetTableLength (
2647b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table)
2657b1019a6SJerry Jelinek {
2667b1019a6SJerry Jelinek     ACPI_TABLE_RSDP         *Rsdp;
2677b1019a6SJerry Jelinek 
2687b1019a6SJerry Jelinek 
2697b1019a6SJerry Jelinek     /* Check if table is valid */
2707b1019a6SJerry Jelinek 
2717b1019a6SJerry Jelinek     if (!ApIsValidHeader (Table))
2727b1019a6SJerry Jelinek     {
2737b1019a6SJerry Jelinek         return (0);
2747b1019a6SJerry Jelinek     }
2757b1019a6SJerry Jelinek 
2767b1019a6SJerry Jelinek     if (ACPI_VALIDATE_RSDP_SIG (Table->Signature))
2777b1019a6SJerry Jelinek     {
2787b1019a6SJerry Jelinek         Rsdp = ACPI_CAST_PTR (ACPI_TABLE_RSDP, Table);
2797b1019a6SJerry Jelinek         return (AcpiTbGetRsdpLength (Rsdp));
2807b1019a6SJerry Jelinek     }
2817b1019a6SJerry Jelinek 
2827b1019a6SJerry Jelinek     /* Normal ACPI table */
2837b1019a6SJerry Jelinek 
2847b1019a6SJerry Jelinek     return (Table->Length);
2857b1019a6SJerry Jelinek }
2867b1019a6SJerry Jelinek 
2877b1019a6SJerry Jelinek 
2887b1019a6SJerry Jelinek /******************************************************************************
2897b1019a6SJerry Jelinek  *
2907b1019a6SJerry Jelinek  * FUNCTION:    ApDumpTableBuffer
2917b1019a6SJerry Jelinek  *
2927b1019a6SJerry Jelinek  * PARAMETERS:  Table               - ACPI table to be dumped
2937b1019a6SJerry Jelinek  *              Instance            - ACPI table instance no. to be dumped
2947b1019a6SJerry Jelinek  *              Address             - Physical address of the table
2957b1019a6SJerry Jelinek  *
2967b1019a6SJerry Jelinek  * RETURN:      None
2977b1019a6SJerry Jelinek  *
2987b1019a6SJerry Jelinek  * DESCRIPTION: Dump an ACPI table in standard ASCII hex format, with a
2997b1019a6SJerry Jelinek  *              header that is compatible with the AcpiXtract utility.
3007b1019a6SJerry Jelinek  *
3017b1019a6SJerry Jelinek  ******************************************************************************/
3027b1019a6SJerry Jelinek 
3037b1019a6SJerry Jelinek static int
ApDumpTableBuffer(ACPI_TABLE_HEADER * Table,UINT32 Instance,ACPI_PHYSICAL_ADDRESS Address)3047b1019a6SJerry Jelinek ApDumpTableBuffer (
3057b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table,
3067b1019a6SJerry Jelinek     UINT32                  Instance,
3077b1019a6SJerry Jelinek     ACPI_PHYSICAL_ADDRESS   Address)
3087b1019a6SJerry Jelinek {
3097b1019a6SJerry Jelinek     UINT32                  TableLength;
3107b1019a6SJerry Jelinek 
3117b1019a6SJerry Jelinek 
3127b1019a6SJerry Jelinek     TableLength = ApGetTableLength (Table);
3137b1019a6SJerry Jelinek 
3147b1019a6SJerry Jelinek     /* Print only the header if requested */
3157b1019a6SJerry Jelinek 
3167b1019a6SJerry Jelinek     if (Gbl_SummaryMode)
3177b1019a6SJerry Jelinek     {
3187b1019a6SJerry Jelinek         AcpiTbPrintTableHeader (Address, Table);
3197b1019a6SJerry Jelinek         return (0);
3207b1019a6SJerry Jelinek     }
3217b1019a6SJerry Jelinek 
3227b1019a6SJerry Jelinek     /* Dump to binary file if requested */
3237b1019a6SJerry Jelinek 
3247b1019a6SJerry Jelinek     if (Gbl_BinaryMode)
3257b1019a6SJerry Jelinek     {
3267b1019a6SJerry Jelinek         return (ApWriteToBinaryFile (Table, Instance));
3277b1019a6SJerry Jelinek     }
3287b1019a6SJerry Jelinek 
3297b1019a6SJerry Jelinek     /*
3307b1019a6SJerry Jelinek      * Dump the table with header for use with acpixtract utility.
3317b1019a6SJerry Jelinek      * Note: simplest to just always emit a 64-bit address. AcpiXtract
3327b1019a6SJerry Jelinek      * utility can handle this.
3337b1019a6SJerry Jelinek      */
334*35786f68SRobert Mustacchi     fprintf (Gbl_OutputFile, "%4.4s @ 0x%8.8X%8.8X\n",
3357b1019a6SJerry Jelinek         Table->Signature, ACPI_FORMAT_UINT64 (Address));
3367b1019a6SJerry Jelinek 
3377b1019a6SJerry Jelinek     AcpiUtDumpBufferToFile (Gbl_OutputFile,
3387b1019a6SJerry Jelinek         ACPI_CAST_PTR (UINT8, Table), TableLength,
3397b1019a6SJerry Jelinek         DB_BYTE_DISPLAY, 0);
340*35786f68SRobert Mustacchi     fprintf (Gbl_OutputFile, "\n");
3417b1019a6SJerry Jelinek     return (0);
3427b1019a6SJerry Jelinek }
3437b1019a6SJerry Jelinek 
3447b1019a6SJerry Jelinek 
3457b1019a6SJerry Jelinek /******************************************************************************
3467b1019a6SJerry Jelinek  *
3477b1019a6SJerry Jelinek  * FUNCTION:    ApDumpAllTables
3487b1019a6SJerry Jelinek  *
3497b1019a6SJerry Jelinek  * PARAMETERS:  None
3507b1019a6SJerry Jelinek  *
3517b1019a6SJerry Jelinek  * RETURN:      Status
3527b1019a6SJerry Jelinek  *
3537b1019a6SJerry Jelinek  * DESCRIPTION: Get all tables from the RSDT/XSDT (or at least all of the
3547b1019a6SJerry Jelinek  *              tables that we can possibly get).
3557b1019a6SJerry Jelinek  *
3567b1019a6SJerry Jelinek  ******************************************************************************/
3577b1019a6SJerry Jelinek 
3587b1019a6SJerry Jelinek int
ApDumpAllTables(void)3597b1019a6SJerry Jelinek ApDumpAllTables (
3607b1019a6SJerry Jelinek     void)
3617b1019a6SJerry Jelinek {
3627b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table;
3637b1019a6SJerry Jelinek     UINT32                  Instance = 0;
3647b1019a6SJerry Jelinek     ACPI_PHYSICAL_ADDRESS   Address;
3657b1019a6SJerry Jelinek     ACPI_STATUS             Status;
3667b1019a6SJerry Jelinek     int                     TableStatus;
3677b1019a6SJerry Jelinek     UINT32                  i;
3687b1019a6SJerry Jelinek 
3697b1019a6SJerry Jelinek 
3707b1019a6SJerry Jelinek     /* Get and dump all available ACPI tables */
3717b1019a6SJerry Jelinek 
3727b1019a6SJerry Jelinek     for (i = 0; i < AP_MAX_ACPI_FILES; i++)
3737b1019a6SJerry Jelinek     {
3747b1019a6SJerry Jelinek         Status = AcpiOsGetTableByIndex (i, &Table, &Instance, &Address);
3757b1019a6SJerry Jelinek         if (ACPI_FAILURE (Status))
3767b1019a6SJerry Jelinek         {
3777b1019a6SJerry Jelinek             /* AE_LIMIT means that no more tables are available */
3787b1019a6SJerry Jelinek 
3797b1019a6SJerry Jelinek             if (Status == AE_LIMIT)
3807b1019a6SJerry Jelinek             {
3817b1019a6SJerry Jelinek                 return (0);
3827b1019a6SJerry Jelinek             }
3837b1019a6SJerry Jelinek             else if (i == 0)
3847b1019a6SJerry Jelinek             {
385*35786f68SRobert Mustacchi                 fprintf (stderr, "Could not get ACPI tables, %s\n",
3867b1019a6SJerry Jelinek                     AcpiFormatException (Status));
3877b1019a6SJerry Jelinek                 return (-1);
3887b1019a6SJerry Jelinek             }
3897b1019a6SJerry Jelinek             else
3907b1019a6SJerry Jelinek             {
391*35786f68SRobert Mustacchi                 fprintf (stderr, "Could not get ACPI table at index %u, %s\n",
3927b1019a6SJerry Jelinek                     i, AcpiFormatException (Status));
3937b1019a6SJerry Jelinek                 continue;
3947b1019a6SJerry Jelinek             }
3957b1019a6SJerry Jelinek         }
3967b1019a6SJerry Jelinek 
3977b1019a6SJerry Jelinek         TableStatus = ApDumpTableBuffer (Table, Instance, Address);
3987b1019a6SJerry Jelinek         ACPI_FREE (Table);
3997b1019a6SJerry Jelinek 
4007b1019a6SJerry Jelinek         if (TableStatus)
4017b1019a6SJerry Jelinek         {
4027b1019a6SJerry Jelinek             break;
4037b1019a6SJerry Jelinek         }
4047b1019a6SJerry Jelinek     }
4057b1019a6SJerry Jelinek 
4067b1019a6SJerry Jelinek     /* Something seriously bad happened if the loop terminates here */
4077b1019a6SJerry Jelinek 
4087b1019a6SJerry Jelinek     return (-1);
4097b1019a6SJerry Jelinek }
4107b1019a6SJerry Jelinek 
4117b1019a6SJerry Jelinek 
4127b1019a6SJerry Jelinek /******************************************************************************
4137b1019a6SJerry Jelinek  *
4147b1019a6SJerry Jelinek  * FUNCTION:    ApDumpTableByAddress
4157b1019a6SJerry Jelinek  *
4167b1019a6SJerry Jelinek  * PARAMETERS:  AsciiAddress        - Address for requested ACPI table
4177b1019a6SJerry Jelinek  *
4187b1019a6SJerry Jelinek  * RETURN:      Status
4197b1019a6SJerry Jelinek  *
4207b1019a6SJerry Jelinek  * DESCRIPTION: Get an ACPI table via a physical address and dump it.
4217b1019a6SJerry Jelinek  *
4227b1019a6SJerry Jelinek  ******************************************************************************/
4237b1019a6SJerry Jelinek 
4247b1019a6SJerry Jelinek int
ApDumpTableByAddress(char * AsciiAddress)4257b1019a6SJerry Jelinek ApDumpTableByAddress (
4267b1019a6SJerry Jelinek     char                    *AsciiAddress)
4277b1019a6SJerry Jelinek {
4287b1019a6SJerry Jelinek     ACPI_PHYSICAL_ADDRESS   Address;
4297b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table;
4307b1019a6SJerry Jelinek     ACPI_STATUS             Status;
4317b1019a6SJerry Jelinek     int                     TableStatus;
4327b1019a6SJerry Jelinek     UINT64                  LongAddress;
4337b1019a6SJerry Jelinek 
4347b1019a6SJerry Jelinek 
4357b1019a6SJerry Jelinek     /* Convert argument to an integer physical address */
4367b1019a6SJerry Jelinek 
437*35786f68SRobert Mustacchi     Status = AcpiUtStrtoul64 (AsciiAddress, &LongAddress);
4387b1019a6SJerry Jelinek     if (ACPI_FAILURE (Status))
4397b1019a6SJerry Jelinek     {
440*35786f68SRobert Mustacchi         fprintf (stderr, "%s: Could not convert to a physical address\n",
4417b1019a6SJerry Jelinek             AsciiAddress);
4427b1019a6SJerry Jelinek         return (-1);
4437b1019a6SJerry Jelinek     }
4447b1019a6SJerry Jelinek 
4457b1019a6SJerry Jelinek     Address = (ACPI_PHYSICAL_ADDRESS) LongAddress;
4467b1019a6SJerry Jelinek     Status = AcpiOsGetTableByAddress (Address, &Table);
4477b1019a6SJerry Jelinek     if (ACPI_FAILURE (Status))
4487b1019a6SJerry Jelinek     {
449*35786f68SRobert Mustacchi         fprintf (stderr, "Could not get table at 0x%8.8X%8.8X, %s\n",
4507b1019a6SJerry Jelinek             ACPI_FORMAT_UINT64 (Address),
4517b1019a6SJerry Jelinek             AcpiFormatException (Status));
4527b1019a6SJerry Jelinek         return (-1);
4537b1019a6SJerry Jelinek     }
4547b1019a6SJerry Jelinek 
4557b1019a6SJerry Jelinek     TableStatus = ApDumpTableBuffer (Table, 0, Address);
4567b1019a6SJerry Jelinek     ACPI_FREE (Table);
4577b1019a6SJerry Jelinek     return (TableStatus);
4587b1019a6SJerry Jelinek }
4597b1019a6SJerry Jelinek 
4607b1019a6SJerry Jelinek 
4617b1019a6SJerry Jelinek /******************************************************************************
4627b1019a6SJerry Jelinek  *
4637b1019a6SJerry Jelinek  * FUNCTION:    ApDumpTableByName
4647b1019a6SJerry Jelinek  *
4657b1019a6SJerry Jelinek  * PARAMETERS:  Signature           - Requested ACPI table signature
4667b1019a6SJerry Jelinek  *
4677b1019a6SJerry Jelinek  * RETURN:      Status
4687b1019a6SJerry Jelinek  *
4697b1019a6SJerry Jelinek  * DESCRIPTION: Get an ACPI table via a signature and dump it. Handles
4707b1019a6SJerry Jelinek  *              multiple tables with the same signature (SSDTs).
4717b1019a6SJerry Jelinek  *
4727b1019a6SJerry Jelinek  ******************************************************************************/
4737b1019a6SJerry Jelinek 
4747b1019a6SJerry Jelinek int
ApDumpTableByName(char * Signature)4757b1019a6SJerry Jelinek ApDumpTableByName (
4767b1019a6SJerry Jelinek     char                    *Signature)
4777b1019a6SJerry Jelinek {
4787b1019a6SJerry Jelinek     char                    LocalSignature [ACPI_NAME_SIZE + 1];
4797b1019a6SJerry Jelinek     UINT32                  Instance;
4807b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table;
4817b1019a6SJerry Jelinek     ACPI_PHYSICAL_ADDRESS   Address;
4827b1019a6SJerry Jelinek     ACPI_STATUS             Status;
4837b1019a6SJerry Jelinek     int                     TableStatus;
4847b1019a6SJerry Jelinek 
4857b1019a6SJerry Jelinek 
4867b1019a6SJerry Jelinek     if (strlen (Signature) != ACPI_NAME_SIZE)
4877b1019a6SJerry Jelinek     {
488*35786f68SRobert Mustacchi         fprintf (stderr,
4897b1019a6SJerry Jelinek             "Invalid table signature [%s]: must be exactly 4 characters\n",
4907b1019a6SJerry Jelinek             Signature);
4917b1019a6SJerry Jelinek         return (-1);
4927b1019a6SJerry Jelinek     }
4937b1019a6SJerry Jelinek 
4947b1019a6SJerry Jelinek     /* Table signatures are expected to be uppercase */
4957b1019a6SJerry Jelinek 
4967b1019a6SJerry Jelinek     strcpy (LocalSignature, Signature);
4977b1019a6SJerry Jelinek     AcpiUtStrupr (LocalSignature);
4987b1019a6SJerry Jelinek 
4997b1019a6SJerry Jelinek     /* To be friendly, handle tables whose signatures do not match the name */
5007b1019a6SJerry Jelinek 
5017b1019a6SJerry Jelinek     if (ACPI_COMPARE_NAME (LocalSignature, "FADT"))
5027b1019a6SJerry Jelinek     {
5037b1019a6SJerry Jelinek         strcpy (LocalSignature, ACPI_SIG_FADT);
5047b1019a6SJerry Jelinek     }
5057b1019a6SJerry Jelinek     else if (ACPI_COMPARE_NAME (LocalSignature, "MADT"))
5067b1019a6SJerry Jelinek     {
5077b1019a6SJerry Jelinek         strcpy (LocalSignature, ACPI_SIG_MADT);
5087b1019a6SJerry Jelinek     }
5097b1019a6SJerry Jelinek 
5107b1019a6SJerry Jelinek     /* Dump all instances of this signature (to handle multiple SSDTs) */
5117b1019a6SJerry Jelinek 
5127b1019a6SJerry Jelinek     for (Instance = 0; Instance < AP_MAX_ACPI_FILES; Instance++)
5137b1019a6SJerry Jelinek     {
5147b1019a6SJerry Jelinek         Status = AcpiOsGetTableByName (LocalSignature, Instance,
5157b1019a6SJerry Jelinek             &Table, &Address);
5167b1019a6SJerry Jelinek         if (ACPI_FAILURE (Status))
5177b1019a6SJerry Jelinek         {
5187b1019a6SJerry Jelinek             /* AE_LIMIT means that no more tables are available */
5197b1019a6SJerry Jelinek 
5207b1019a6SJerry Jelinek             if (Status == AE_LIMIT)
5217b1019a6SJerry Jelinek             {
5227b1019a6SJerry Jelinek                 return (0);
5237b1019a6SJerry Jelinek             }
5247b1019a6SJerry Jelinek 
525*35786f68SRobert Mustacchi             fprintf (stderr,
5267b1019a6SJerry Jelinek                 "Could not get ACPI table with signature [%s], %s\n",
5277b1019a6SJerry Jelinek                 LocalSignature, AcpiFormatException (Status));
5287b1019a6SJerry Jelinek             return (-1);
5297b1019a6SJerry Jelinek         }
5307b1019a6SJerry Jelinek 
5317b1019a6SJerry Jelinek         TableStatus = ApDumpTableBuffer (Table, Instance, Address);
5327b1019a6SJerry Jelinek         ACPI_FREE (Table);
5337b1019a6SJerry Jelinek 
5347b1019a6SJerry Jelinek         if (TableStatus)
5357b1019a6SJerry Jelinek         {
5367b1019a6SJerry Jelinek             break;
5377b1019a6SJerry Jelinek         }
5387b1019a6SJerry Jelinek     }
5397b1019a6SJerry Jelinek 
5407b1019a6SJerry Jelinek     /* Something seriously bad happened if the loop terminates here */
5417b1019a6SJerry Jelinek 
5427b1019a6SJerry Jelinek     return (-1);
5437b1019a6SJerry Jelinek }
5447b1019a6SJerry Jelinek 
5457b1019a6SJerry Jelinek 
5467b1019a6SJerry Jelinek /******************************************************************************
5477b1019a6SJerry Jelinek  *
5487b1019a6SJerry Jelinek  * FUNCTION:    ApDumpTableFromFile
5497b1019a6SJerry Jelinek  *
5507b1019a6SJerry Jelinek  * PARAMETERS:  Pathname            - File containing the binary ACPI table
5517b1019a6SJerry Jelinek  *
5527b1019a6SJerry Jelinek  * RETURN:      Status
5537b1019a6SJerry Jelinek  *
5547b1019a6SJerry Jelinek  * DESCRIPTION: Dump an ACPI table from a binary file
5557b1019a6SJerry Jelinek  *
5567b1019a6SJerry Jelinek  ******************************************************************************/
5577b1019a6SJerry Jelinek 
5587b1019a6SJerry Jelinek int
ApDumpTableFromFile(char * Pathname)5597b1019a6SJerry Jelinek ApDumpTableFromFile (
5607b1019a6SJerry Jelinek     char                    *Pathname)
5617b1019a6SJerry Jelinek {
5627b1019a6SJerry Jelinek     ACPI_TABLE_HEADER       *Table;
5637b1019a6SJerry Jelinek     UINT32                  FileSize = 0;
5647b1019a6SJerry Jelinek     int                     TableStatus = -1;
5657b1019a6SJerry Jelinek 
5667b1019a6SJerry Jelinek 
5677b1019a6SJerry Jelinek     /* Get the entire ACPI table from the file */
5687b1019a6SJerry Jelinek 
5697b1019a6SJerry Jelinek     Table = ApGetTableFromFile (Pathname, &FileSize);
5707b1019a6SJerry Jelinek     if (!Table)
5717b1019a6SJerry Jelinek     {
5727b1019a6SJerry Jelinek         return (-1);
5737b1019a6SJerry Jelinek     }
5747b1019a6SJerry Jelinek 
5757b1019a6SJerry Jelinek     if (!AcpiUtValidNameseg (Table->Signature))
5767b1019a6SJerry Jelinek     {
577*35786f68SRobert Mustacchi         fprintf (stderr,
5787b1019a6SJerry Jelinek             "No valid ACPI signature was found in input file %s\n",
5797b1019a6SJerry Jelinek             Pathname);
5807b1019a6SJerry Jelinek     }
5817b1019a6SJerry Jelinek 
5827b1019a6SJerry Jelinek     /* File must be at least as long as the table length */
5837b1019a6SJerry Jelinek 
5847b1019a6SJerry Jelinek     if (Table->Length > FileSize)
5857b1019a6SJerry Jelinek     {
586*35786f68SRobert Mustacchi         fprintf (stderr,
5877b1019a6SJerry Jelinek             "Table length (0x%X) is too large for input file (0x%X) %s\n",
5887b1019a6SJerry Jelinek             Table->Length, FileSize, Pathname);
5897b1019a6SJerry Jelinek         goto Exit;
5907b1019a6SJerry Jelinek     }
5917b1019a6SJerry Jelinek 
5927b1019a6SJerry Jelinek     if (Gbl_VerboseMode)
5937b1019a6SJerry Jelinek     {
594*35786f68SRobert Mustacchi         fprintf (stderr,
5957b1019a6SJerry Jelinek             "Input file:  %s contains table [%4.4s], 0x%X (%u) bytes\n",
5967b1019a6SJerry Jelinek             Pathname, Table->Signature, FileSize, FileSize);
5977b1019a6SJerry Jelinek     }
5987b1019a6SJerry Jelinek 
5997b1019a6SJerry Jelinek     TableStatus = ApDumpTableBuffer (Table, 0, 0);
6007b1019a6SJerry Jelinek 
6017b1019a6SJerry Jelinek Exit:
6027b1019a6SJerry Jelinek     ACPI_FREE (Table);
6037b1019a6SJerry Jelinek     return (TableStatus);
6047b1019a6SJerry Jelinek }
605