xref: /illumos-gate/usr/src/man/man8/acpidump.8 (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1*bbf21555SRichard Lowe.\" This file and its contents are supplied under the terms of the
2*bbf21555SRichard Lowe.\" Common Development and Distribution License ("CDDL"), version 1.0.
3*bbf21555SRichard Lowe.\" You may only use this file in accordance with the terms of version
4*bbf21555SRichard Lowe.\" 1.0 of the CDDL.
5*bbf21555SRichard Lowe.\"
6*bbf21555SRichard Lowe.\" A full copy of the text of the CDDL should have accompanied this
7*bbf21555SRichard Lowe.\" source.  A copy of the CDDL is also available via the Internet at
8*bbf21555SRichard Lowe.\" http://www.illumos.org/license/CDDL.
9*bbf21555SRichard Lowe.\"
10*bbf21555SRichard Lowe.\"
11*bbf21555SRichard Lowe.\" Copyright (c) 2017, Joyent, Inc.
12*bbf21555SRichard Lowe.\"
13*bbf21555SRichard Lowe.Dd May 12, 2017
14*bbf21555SRichard Lowe.Dt ACPIDUMP 8
15*bbf21555SRichard Lowe.Os
16*bbf21555SRichard Lowe.Sh NAME
17*bbf21555SRichard Lowe.Nm acpidump
18*bbf21555SRichard Lowe.Nd dump ACPI tables
19*bbf21555SRichard Lowe.Sh SYNOPSIS
20*bbf21555SRichard Lowe.Nm
21*bbf21555SRichard Lowe.Op Fl bhsvxz
22*bbf21555SRichard Lowe.Op Fl a Ar address
23*bbf21555SRichard Lowe.Op Fl c Ar on|off
24*bbf21555SRichard Lowe.Op Fl f Ar file
25*bbf21555SRichard Lowe.Op Fl n Ar signature
26*bbf21555SRichard Lowe.Op Fl o Ar file
27*bbf21555SRichard Lowe.Op Fl r Ar address
28*bbf21555SRichard Lowe.Sh DESCRIPTION
29*bbf21555SRichard LoweThe
30*bbf21555SRichard Lowe.Nm
31*bbf21555SRichard Loweutility is used to dump the system's Advanced Configuration and Power Interface
32*bbf21555SRichard Lowe(ACPI) tables that are provided by system firmware.
33*bbf21555SRichard LoweThe dumped tables can be used by other utilities, such as
34*bbf21555SRichard Lowe.Xr acpixtract 8
35*bbf21555SRichard Loweor
36*bbf21555SRichard Lowe.Sy iasl .
37*bbf21555SRichard Lowe.Sh OPTIONS
38*bbf21555SRichard LoweThe following options are supported:
39*bbf21555SRichard Lowe.Bl -tag -width Ds
40*bbf21555SRichard Lowe.It Fl a Ar address
41*bbf21555SRichard LoweGet the table at the given physical address.
42*bbf21555SRichard Lowe.It Fl b
43*bbf21555SRichard LoweDump all tables to binary files.
44*bbf21555SRichard Lowe.It Fl c Ar on|off
45*bbf21555SRichard LoweEnable dumping customized tables.
46*bbf21555SRichard LoweThe default is off.
47*bbf21555SRichard Lowe.It Fl f Ar file
48*bbf21555SRichard LoweRead the table from the given binary file.
49*bbf21555SRichard Lowe.It Fl h
50*bbf21555SRichard LoweDisplay the usage message and exit.
51*bbf21555SRichard Lowe.It Fl n Ar signature
52*bbf21555SRichard LoweGet the table with the specified signature.
53*bbf21555SRichard Lowe.It Fl o Ar file
54*bbf21555SRichard LoweWrite output to the given file.
55*bbf21555SRichard Lowe.It Fl r Ar address
56*bbf21555SRichard LoweDump tables from the
57*bbf21555SRichard Lowe.Sy RSDP
58*bbf21555SRichard Loweat the given address.
59*bbf21555SRichard Lowe.It Fl s
60*bbf21555SRichard LoweOnly print table summaries.
61*bbf21555SRichard Lowe.It Fl v
62*bbf21555SRichard LowePrint the version.
63*bbf21555SRichard Lowe.It Fl x
64*bbf21555SRichard LoweDo not use the
65*bbf21555SRichard Lowe.Sy XSDT.
66*bbf21555SRichard Lowe.It Fl z
67*bbf21555SRichard LoweVerbose.
68*bbf21555SRichard Lowe.El
69*bbf21555SRichard Lowe.Sh EXAMPLES
70*bbf21555SRichard Lowe.Sy Example 1
71*bbf21555SRichard LoweDump all ACPI Tables
72*bbf21555SRichard Lowe.Pp
73*bbf21555SRichard LoweThe following example dumps all of the ACPI tables from the system.
74*bbf21555SRichard LoweThis can then be used with
75*bbf21555SRichard Lowe.Xr acpixtract 8
76*bbf21555SRichard Loweand the iasl utility to decode the ACPI tables from the system.
77*bbf21555SRichard LoweIn this example, all of the tables are written to the file
78*bbf21555SRichard Lowe.Pa acpi.out .
79*bbf21555SRichard Lowe.Bd -literal -offset width
80*bbf21555SRichard Lowe# acpidump -o acpi.dat
81*bbf21555SRichard Lowe.Ed
82*bbf21555SRichard Lowe.Sh SEE ALSO
83*bbf21555SRichard Lowe.Xr acpixtract 8
84