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