components/acpidump/acpidump.1
changeset 197 fd801ec0737c
equal deleted inserted replaced
196:816e398e992c 197:fd801ec0737c
       
     1 '\" te
       
     2 .\"
       
     3 .\" Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.
       
     4 .\"
       
     5 .TH acpidump 1 "24 Apr 2009" "SunOS 5.11" "User Commands"
       
     6 .SH NAME
       
     7 acpidump - dump the raw contents of ACPI tables
       
     8 .SH SYNOPSIS
       
     9 .LP
       
    10 .nf
       
    11 \fBacpidump\fB [\fB-a\fR \fIaddress\fR] [\fB-b\fR] [\fI-h\fR] 
       
    12     [\fB-l\fR \fIlength\fR] [\fB-o\fR \fIfile\fR] [\fB-s\fR \fIcount\fR] 
       
    13     [\fB-t\fR \fItable\fR]
       
    14 .fi
       
    15 
       
    16 .SH DESCRIPTION
       
    17 .sp
       
    18 .LP
       
    19 This utility will read the ACPI tables, if any, that were presented to the
       
    20 kernel from the BIOS at boot and display the information.  The tables will be
       
    21 printed out in hexidecimal format and can be parsed with the acpixtract(1) and
       
    22 madt(1) utilities.
       
    23 
       
    24 .SH OPTIONS
       
    25 .sp
       
    26 .LP
       
    27 The following options are supported:
       
    28 .sp
       
    29 .ne 2
       
    30 .mk
       
    31 .na
       
    32 \fB\fB-a\fR [\fIaddress\fR]\fR
       
    33 .ad
       
    34 .sp .6
       
    35 .RS 4n
       
    36 Allows the user to specify the starting address from which to dump the tables.
       
    37 .RE
       
    38 
       
    39 .sp
       
    40 .ne 2
       
    41 .mk
       
    42 .na
       
    43 \fB\fB-b\fR
       
    44 .ad
       
    45 .sp .6
       
    46 .RS 4n
       
    47 Dump the ACPI tables in binary mode.
       
    48 .RE
       
    49 
       
    50 .sp
       
    51 .ne 2
       
    52 .mk
       
    53 .na
       
    54 \fB\fB-h\fR
       
    55 .ad
       
    56 .sp .6
       
    57 .RS 4n
       
    58 Display the help menu containing the options supported by the utility.
       
    59 .RE
       
    60 
       
    61 .sp
       
    62 .ne 2
       
    63 .mk
       
    64 .na
       
    65 \fB\fB-l\fR [\fIlength\fR]\fR
       
    66 .ad
       
    67 .sp .6
       
    68 .RS 4n
       
    69 Requires a starting address, specified with -a, and will dump the range of
       
    70 physical address but makes no attempt to understand the contents of that memory.
       
    71 .RE
       
    72 
       
    73 .sp
       
    74 .ne 2
       
    75 .mk
       
    76 .na
       
    77 \fB\fB-o\fR [\fIfile\fR]\fR
       
    78 .ad
       
    79 .sp .6
       
    80 .RS 4n
       
    81 Redirect the output provided by the utility to the specified file.
       
    82 .RE
       
    83 
       
    84 .sp
       
    85 .ne 2
       
    86 .mk
       
    87 .na
       
    88 \fB\fB-s\fR [\fIcount\fR]\fR
       
    89 .ad
       
    90 .sp .6
       
    91 .RS 4n
       
    92 Skip \fIcount\fR tables of the given name
       
    93 .RE
       
    94 
       
    95 .sp
       
    96 .ne 2
       
    97 .mk
       
    98 .na
       
    99 \fB\fB-t\fR [\fItable\fR]\fR
       
   100 .ad
       
   101 .sp .6
       
   102 .RS 4n
       
   103 Dump only the table with the \fItable\fR signature.
       
   104 .RE
       
   105 
       
   106 
       
   107 .SH SEE ALSO
       
   108 .sp
       
   109 .LP
       
   110 \fBacpixtract\fR(1), \fBmadt\fR(1)
       
   111 .RE
       
   112 
       
   113 .SH RESOURCES
       
   114 .sp
       
   115 .LP
       
   116 http://www.lesswatts.org/projects/acpi/utilities.php
       
   117 .sp
       
   118 
       
   119 .SH NOTES
       
   120 .sp
       
   121 .LP
       
   122 The PRIV_FILE_DAC_READ privilege is necessary to use this utility.