kernel/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.