1.\" This file and its contents are supplied under the terms of the 2.\" Common Development and Distribution License ("CDDL"), version 1.0. 3.\" You may only use this file in accordance with the terms of version 4.\" 1.0 of the CDDL. 5.\" 6.\" A full copy of the text of the CDDL should have accompanied this 7.\" source. A copy of the CDDL is also available via the Internet at 8.\" http://www.illumos.org/license/CDDL. 9.\" 10.\" 11.\" Copyright (c) 2017, Joyent, Inc. 12.\" 13.Dd May 12, 2017 14.Dt ACPIXTRACT 8 15.Os 16.Sh NAME 17.Nm acpixtract 18.Nd extract binary ACPI tables from a dump file 19.Sh SYNOPSIS 20.Nm 21.Op Fl ahlmv 22.Op Fl s Ar signature 23.Ar file 24.Sh DESCRIPTION 25The 26.Nm 27utility extracts the binary data from a dump of the system's Advanced 28Configuration and Power Interface (ACPI) tables. 29The dump is usually obtained via the 30.Xr acpidump 8 31command. 32The resulting binary file(s) are represented in the ACPI 33.Sy ASL 34assembly language. 35For each table extracted, a corresponding 36.Em table.dat 37file will be created. 38.Sh OPTIONS 39The following options are supported: 40.Bl -tag -width Ds 41.It Fl a 42Extract all of the tables found. 43By default only the 44.Sy DSDT 45and 46.Sy SSDT 47tables will be extracted. 48.It Fl h 49Display the usage message and exit. 50.It Fl l 51List tables only, do not extract. 52.It Fl m 53Make a single file for all of the 54.Sy DSDT 55and 56.Sy SSDT 57tables. 58.It Fl s Ar signature 59Get the table with the specified signature. 60.It Fl v 61Print the version. 62.El 63.Sh EXAMPLES 64.Sy Example 1 65Extract all ACPI tables 66.Pp 67The following example extracts all of the individual ACPI tables from a 68previously created dump of the ACPI tables from a running system. 69Such a dump can be created with the 70.Xr acpidump 8 71utility. 72Extracted tables can then be inspected or disassembled by the 73iasl utility on any platform. 74.Bd -literal -offset width 75# acpixtract -a acpi.dat 76 77Intel ACPI Component Architecture 78ACPI Binary Table Extraction Utility version 20160527-32 79Copyright (c) 2000 - 2016 Intel Corporation 80 81Acpi table [RSDP] - 36 bytes written to rsdp.dat 82Acpi table [RSDT] - 128 bytes written to rsdt.dat 83Acpi table [XSDT] - 220 bytes written to xsdt.dat 84Acpi table [DSDT] - 213221 bytes written to dsdt.dat 85Acpi table [FACS] - 64 bytes written to facs.dat 86Acpi table [FACP] - 268 bytes written to facp.dat 87Acpi table [APIC] - 884 bytes written to apic.dat 88Acpi table [FPDT] - 68 bytes written to fpdt.dat 89Acpi table [FIDT] - 156 bytes written to fidt.dat 90Acpi table [SPMI] - 65 bytes written to spmi.dat 91Acpi table [MCFG] - 60 bytes written to mcfg.dat 92Acpi table [UEFI] - 66 bytes written to uefi.dat 93Acpi table [MCEJ] - 304 bytes written to mcej.dat 94Acpi table [HPET] - 56 bytes written to hpet.dat 95Acpi table [MSCT] - 144 bytes written to msct.dat 96Acpi table [SLIT] - 48 bytes written to slit.dat 97Acpi table [SRAT] - 4440 bytes written to srat.dat 98Acpi table [WDDT] - 64 bytes written to wddt.dat 99Acpi table [SSDT] - 94529 bytes written to ssdt1.dat 100Acpi table [NITR] - 113 bytes written to nitr.dat 101Acpi table [SSDT] - 9802 bytes written to ssdt2.dat 102Acpi table [SSDT] - 100 bytes written to ssdt3.dat 103Acpi table [PRAD] - 191 bytes written to prad.dat 104Acpi table [DMAR] - 328 bytes written to dmar.dat 105Acpi table [HEST] - 168 bytes written to hest.dat 106Acpi table [BERT] - 48 bytes written to bert.dat 107Acpi table [ERST] - 560 bytes written to erst.dat 108Acpi table [EINJ] - 336 bytes written to einj.dat 109 11028 binary ACPI tables extracted 111.Ed 112.Sh SEE ALSO 113.Xr acpidump 8 114