GNU Linux-libre 6.9.1-gnu
[releases.git] / tools / power / acpi / man / acpidump.8
1 .TH ACPIDUMP 8
2 .SH NAME
3 acpidump \- dump a system's ACPI tables to an ASCII file
4
5 .SH SYNOPSIS
6 .B acpidump
7 .RI [ options ]
8 .br
9
10 .SH DESCRIPTION
11 .B acpidump
12 dumps the systems ACPI tables to an ASCII file appropriate for
13 attaching to a bug report.
14
15 Subsequently, they can be processed by utilities in the ACPICA package.
16
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.
67
68 .SH EXAMPLES
69
70 .nf
71 # acpidump > acpidump.out
72
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
86
87 $ iasl -d *.dat
88 ...
89 .fi
90 creates *.dsl, a human readable form which can be edited
91 and compiled using iasl.
92
93
94 .SH NOTES
95
96 .B "acpidump "
97 must be run as root.
98
99 .SH REFERENCES
100 ACPICA: https://acpica.org/
101
102 .SH FILES
103 .ta
104 .nf
105 /dev/mem
106 /sys/firmware/acpi/tables/*
107 /sys/firmware/acpi/tables/dynamic/*
108 /sys/firmware/efi/systab
109 .fi
110
111 .SH AUTHOR
112 .TP
113 Original by:
114  Len Brown <len.brown@intel.com>
115 .TP
116 Written by:
117  Chao Guan <chao.guan@intel.com>
118 .TP
119 Updated by:
120  Bob Moore <robert.moore@intel.com>
121  Lv Zheng <lv.zheng@intel.com>
122
123 .SH SEE ALSO
124 \&\fIacpixtract\fR\|(8), \fIiasl\fR\|(8).
125
126 .SH COPYRIGHT
127 COPYRIGHT (c) 2013, Intel Corporation.