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 \-c
  26 Dump customized tables
  27 .TP
  28 .B \-h \-?
  29 This help message
  30 .TP
  31 .B \-o <File>
  32 Redirect output to file
  33 .TP
  34 .B \-r <Address>
  35 Dump tables from specified RSDP
  36 .TP
  37 .B \-s
  38 Print table summaries only
  39 .TP
  40 .B \-v
  41 Display version information
  42 .TP
  43 .B \-z
  44 Verbose mode
  45 .TP
  46 .B Table Options
  47 .TP
  48 .B \-a <Address>
  49 Get table via a physical address
  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 Invocation without parameters dumps all available tables
  58 .TP
  59 Multiple mixed instances of -a, -f, and -n are supported
  60
  61 .SH EXAMPLES
  62
  63 .nf
  64 # acpidump > acpidump.out
  65
  66 $ acpixtract -a acpidump.out
  67         Acpi table [DSDT] -  15974 bytes written to DSDT.dat
  68         Acpi table [FACS] -     64 bytes written to FACS.dat
  69         Acpi table [FACP] -    116 bytes written to FACP.dat
  70         Acpi table [APIC] -    120 bytes written to APIC.dat
  71         Acpi table [MCFG] -     60 bytes written to MCFG.dat
  72         Acpi table [SSDT] -    444 bytes written to SSDT1.dat
  73         Acpi table [SSDT] -    439 bytes written to SSDT2.dat
  74         Acpi table [SSDT] -    439 bytes written to SSDT3.dat
  75         Acpi table [SSDT] -    439 bytes written to SSDT4.dat
  76         Acpi table [SSDT] -    439 bytes written to SSDT5.dat
  77         Acpi table [RSDT] -     76 bytes written to RSDT.dat
  78         Acpi table [RSDP] -     20 bytes written to RSDP.dat
  79
  80 $ iasl -d *.dat
  81 ...
  82 .fi
  83 creates *.dsl, a human readable form which can be edited
  84 and compiled using iasl.
  85
  86
  87 .SH NOTES
  88
  89 .B "acpidump "
  90 must be run as root.
  91
  92 .SH REFERENCES
  93 ACPICA: https://acpica.org/
  94
  95 .SH FILES
  96 .ta
  97 .nf
  98 /dev/mem
  99 /sys/firmware/acpi/tables/*
 100 /sys/firmware/acpi/tables/dynamic/*
 101 /sys/firmware/efi/systab
 102 .fi
 103
 104 .SH AUTHOR
 105 .TP
 106 Original by:
 107  Len Brown <len.brown@intel.com>
 108 .TP
 109 Written by:
 110  Chao Guan <chao.guan@intel.com>
 111 .TP
 112 Updated by:
 113  Bob Moore <robert.moore@intel.com>
 114  Lv Zheng <lv.zheng@intel.com>
 115
 116 .SH SEE ALSO
 117 \&\fIacpixtract\fR\|(8), \fIiasl\fR\|(8).
 118
 119 .SH COPYRIGHT
 120 COPYRIGHT (c) 2013, Intel Corporation.