44a778
.\" First parameter, NAME, should be all caps
44a778
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
44a778
.\" other parameters are allowed: see man(7), man(1)
44a778
.TH ACPIDUMP 1 "July 24, 2013"
44a778
.\" Please adjust this date whenever revising the manpage.
44a778
.\"
44a778
.\" Some roff macros, for reference:
44a778
.\" .nh        disable hyphenation
44a778
.\" .hy        enable hyphenation
44a778
.\" .ad l      left justify
44a778
.\" .ad b      justify to both left and right margins
44a778
.\" .nf        disable filling
44a778
.\" .fi        enable filling
44a778
.\" .br        insert line break
44a778
.\" .sp <n>    insert n+1 empty lines
44a778
.\" for manpage-specific macros, see man(7)
44a778
.SH NAME
44a778
acpidump \- ACPI table dump utility
44a778
.SH SYNOPSIS
44a778
.B acpidump
44a778
.RI [ <option> ... ]
44a778
44a778
.SH DESCRIPTION
44a778
This manual page briefly documents the
44a778
.B acpidump
44a778
command.  The option list is taken from the interactive help.
44a778
.PP
44a778
The
44a778
.B acpidump
44a778
command extracts the ACPI tables currently in use from the running
44a778
kernel in a form usable for later processing by the
44a778
.B acpixtract
44a778
command.
44a778
.PP
44a778
Invocation of
44a778
.B acpidump
44a778
without parameters will dump all available ACPI tables.  Multiple mixed
44a778
instances of the
44a778
.B \-a
44a778
,
44a778
.B \-f
44a778
, and
44a778
.B \-n
44a778
parameters can be used.
44a778
44a778
.SH OPTIONS
44a778
.PP
44a778
.TP
44a778
.B \-b
44a778
Dump tables in binary format (versus the default human-readable form).
44a778
44a778
.PP
44a778
.TP
44a778
.B \-h | \-?
44a778
Display this help message.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-o <file>
44a778
Redirect output to a file.  This file can be used later by
44a778
.B acpixtract
44a778
to examine the contents of the ACPI tables.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-r <address>
44a778
Dump tables from specified RSDP.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-s
44a778
Print table summaries only.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-v
44a778
Print the version of this utility.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-z
44a778
Verbose mode.
44a778
44a778
.SH TABLE OPTIONS
44a778
.PP
44a778
.TP
44a778
.B \-a <address>
44a778
Get a table from a physical address (must be superuser and you must be
44a778
careful which address you use -- dmesg will typically report the addresses
44a778
for the various tables).
44a778
44a778
.PP
44a778
.TP
44a778
.B \-c <on|off>
44a778
Turn on/off customized table dumping. If turned on, tables are dumped
44a778
from /sys/firmware/acpi/tables. If turned off, tables are dumped
44a778
from /dev/mem. The default is on.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-f <binary-file>
44a778
Get a table from a binary file (see the
44a778
.B \-b
44a778
option).
44a778
44a778
.PP
44a778
.TP
44a778
.B \-n <signature>
44a778
Get a table via it's name or signature (e.g., MADT or SSDT).
44a778
44a778
.PP
44a778
.TP
44a778
.B \-x
44a778
Do not use but dump XSDT.
44a778
44a778
.PP
44a778
.TP
44a778
.B \-x \-x
44a778
Do not use or dump XSDT.
44a778
44a778
.SH SEE ALSO
44a778
.B acpixtract(1)
44a778
44a778
.SH AUTHOR
44a778
acpidump was written by Robert Moore <robert.moore@intel.com> and
44a778
Chao Guan <chao.guan@intel.com>.
44a778
.PP
44a778
This manual page was written by Al Stone <ahs3@redhat.com> for the
44a778
Fedora project (but may be used by others).