WIP FPC-III support
[linux/fpc-iii.git] / tools / power / acpi / man / acpidump.8
blob79e2d1d435d1337dbb35d138b1e3e448a60217eb
1 .TH ACPIDUMP 8
2 .SH NAME
3 acpidump \- dump a system's ACPI tables to an ASCII file
5 .SH SYNOPSIS
6 .B acpidump
7 .RI [ options ]
8 .br
10 .SH DESCRIPTION
11 .B acpidump
12 dumps the systems ACPI tables to an ASCII file appropriate for
13 attaching to a bug report.
15 Subsequently, they can be processed by utilities in the ACPICA package.
17 .SH OPTIONS
18 acpidump options are as follow:
19 .TP
20 .B Options
21 .TP
22 .B \-b
23 Dump tables to binary files
24 .TP
25 .B \-h \-?
26 This help message
27 .TP
28 .B \-o <File>
29 Redirect output to file
30 .TP
31 .B \-r <Address>
32 Dump tables from specified RSDP
33 .TP
34 .B \-s
35 Print table summaries only
36 .TP
37 .B \-v
38 Display version information
39 .TP
40 .B \-z
41 Verbose mode
42 .TP
43 .B Table Options
44 .TP
45 .B \-a <Address>
46 Get table via a physical address
47 .TP
48 .B \-c <on|off>
49 Turning on/off customized table dumping
50 .TP
51 .B \-f <BinaryFile>
52 Get table via a binary file
53 .TP
54 .B \-n <Signature>
55 Get table via a name/signature
56 .TP
57 .B \-x
58 Do not use but dump XSDT
59 .TP
60 .B \-x \-x
61 Do not use or dump XSDT
62 .TP
63 .fi
64 Invocation without parameters dumps all available tables.
65 .TP
66 Multiple mixed instances of -a, -f, and -n are supported.
68 .SH EXAMPLES
70 .nf
71 # acpidump > acpidump.out
73 $ acpixtract -a acpidump.out
74         Acpi table [DSDT] -  15974 bytes written to DSDT.dat
75         Acpi table [FACS] -     64 bytes written to FACS.dat
76         Acpi table [FACP] -    116 bytes written to FACP.dat
77         Acpi table [APIC] -    120 bytes written to APIC.dat
78         Acpi table [MCFG] -     60 bytes written to MCFG.dat
79         Acpi table [SSDT] -    444 bytes written to SSDT1.dat
80         Acpi table [SSDT] -    439 bytes written to SSDT2.dat
81         Acpi table [SSDT] -    439 bytes written to SSDT3.dat
82         Acpi table [SSDT] -    439 bytes written to SSDT4.dat
83         Acpi table [SSDT] -    439 bytes written to SSDT5.dat
84         Acpi table [RSDT] -     76 bytes written to RSDT.dat
85         Acpi table [RSDP] -     20 bytes written to RSDP.dat
87 $ iasl -d *.dat
88 ...
89 .fi
90 creates *.dsl, a human readable form which can be edited
91 and compiled using iasl.
94 .SH NOTES
96 .B "acpidump "
97 must be run as root.
99 .SH REFERENCES
100 ACPICA: https://acpica.org/
102 .SH FILES
105 /dev/mem
106 /sys/firmware/acpi/tables/*
107 /sys/firmware/acpi/tables/dynamic/*
108 /sys/firmware/efi/systab
111 .SH AUTHOR
113 Original by:
114  Len Brown <len.brown@intel.com>
116 Written by:
117  Chao Guan <chao.guan@intel.com>
119 Updated by:
120  Bob Moore <robert.moore@intel.com>
121  Lv Zheng <lv.zheng@intel.com>
123 .SH SEE ALSO
124 \&\fIacpixtract\fR\|(8), \fIiasl\fR\|(8).
126 .SH COPYRIGHT
127 COPYRIGHT (c) 2013, Intel Corporation.