acpidump

Revision 1 as of 2011-07-27 16:42:06

Clear message

Firmware Test Suite - acpidump utility

This utility loads the ACPI tables and will annotate the tables where possible. This is useful way of inspecting the configuration settings in each table. Tables that are not described in the ACPI specification are dumped out in a hex dump format.

The annotation format is as follows:

TTTT @ xxxxxxxx (ddd bytes)
---------------------------
[0xaaa bbbb  nn]              Text name of field: contents

where:

TTTT is the name of a table,
xxxxxxxx is the address of the table in memory,
aaa is the offset of the field in the table (in hex),
bbbb is the offset of the field in the table (in decimal),
nn is the size of the field in bytes (in decimal)

Note that some fields are bitfields, so these are dumped out as the integer value followed by an annotated dump of the individual bit field values.

for example:

...
00152 acpidump        APIC @ bf6dfcc6 (104 bytes)
00153 acpidump        ---------------
00154 acpidump        [0x000 0000  4]                                Signature: APIC
00155 acpidump        [0x004 0004  4]                                   Length: 0x00000068
00156 acpidump        [0x008 0008  1]                                 Revision: 0x01
00157 acpidump        [0x009 0009  1]                                 Checksum: 0xcc
00158 acpidump        [0x00a 0010  6]                                   OEM ID: INTEL 
00159 acpidump        [0x010 0016  8]                             OEM Table ID: CRESTLNE
00160 acpidump        [0x018 0024  4]                             OEM Revision: 0x06040000
00161 acpidump        [0x01c 0028  4]                               Creator ID: LOHR
00162 acpidump        [0x020 0032  4]                         Creator Revision: 0x0000005a
00163 acpidump        [0x024 0036  4]                       Local APIC Address: 0xfee00000
00164 acpidump        [0x028 0040  4]                                    Flags: 0x00000001
00165 acpidump                                                     PCAT_COMPAT: 0x1
...

The default mode of this utility is to try and use the host machine's ACPI tables which requires root permissions to be able to load this data from firmware. However, one can load in ACPI tables from other machines using the --dumpfile option. The ACPI tables can be loaded in from the output from acpidump or from using "sudo fwts --dump".

Examples:

sudo fwts acpidump - 

..runs the acpidump on your machine and dumps the output to stdout.

fwts acpidump --dumpfile=apcidump.dat -

..runs the tool using ACPI tables in the dump file acpidump.dat as the input and dumps the test results to stdout.

sudo acpidump > acpidump.dat
fwts acpidump --dumpfile=acpidump.dat

..dumps the tables using acpidump and loads them in and runs the tool with results appended to results.log

sudo fwts --dump
fwts acpidump --dumpfile=acpidump.log -

..dumps the tables using fwts and loads them in and runs the tool with results going to stdout.