usr/src/cmd/acpidump/acpidump.1
author Cyril Plisko <cyril.plisko@grigale.com>
Tue, 06 Apr 2010 16:00:14 +0300
changeset 11 87960ed158f9
parent 1 37d545eabfea
permissions -rw-r--r--
Import sfw build 137 Bugs Fixed ---------- 6926835 Wireshark cannot open files typed into the location bar 6930214 CVE-2010-0624: Heap-based buffer overflow in GNU Tar 6933424 Various sfw manual pages need to be adjusted to use the new OpenSolaris package names. 6937764 upgrade OpenSSL to 0.9.8n (and fix CVE-2010-0740)
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     1
'\" te
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     2
.\"
11
87960ed158f9 Import sfw build 137
Cyril Plisko <cyril.plisko@grigale.com>
parents: 1
diff changeset
     3
.\" Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
1
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     4
.\" Use is subject to license terms.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     5
.\"
11
87960ed158f9 Import sfw build 137
Cyril Plisko <cyril.plisko@grigale.com>
parents: 1
diff changeset
     6
.\" ident	"@(#)acpidump.1	1.2	10/03/16 SMI"
1
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     7
.\"
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     8
.TH acpidump 1 "24 Apr 2009" "SunOS 5.11" "User Commands"
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
     9
.SH NAME
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    10
acpidump - dump the raw contents of ACPI tables
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    11
.SH SYNOPSIS
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    12
.LP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    13
.nf
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    14
\fBacpidump\fB [\fB-a\fR \fIaddress\fR] [\fB-b\fR] [\fI-h\fR] 
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    15
    [\fB-l\fR \fIlength\fR] [\fB-o\fR \fIfile\fR] [\fB-s\fR \fIcount\fR] 
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    16
    [\fB-t\fR \fItable\fR]
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    17
.fi
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    18
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    19
.SH DESCRIPTION
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    20
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    21
.LP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    22
This utility will read the ACPI tables, if any, that were presented to the
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    23
kernel from the BIOS at boot and display the information.  The tables will be
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    24
printed out in hexidecimal format and can be parsed with the acpixtract(1) and
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    25
madt(1) utilities.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    26
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    27
.SH OPTIONS
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    28
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    29
.LP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    30
The following options are supported:
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    31
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    32
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    33
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    34
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    35
\fB\fB-a\fR [\fIaddress\fR]\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    36
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    37
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    38
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    39
Allows the user to specify the starting address from which to dump the tables.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    40
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    41
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    42
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    43
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    44
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    45
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    46
\fB\fB-b\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    47
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    48
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    49
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    50
Dump the ACPI tables in binary mode.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    51
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    52
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    53
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    54
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    55
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    56
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    57
\fB\fB-h\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    58
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    59
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    60
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    61
Display the help menu containing the options supported by the utility.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    62
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    63
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    64
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    65
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    66
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    67
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    68
\fB\fB-l\fR [\fIlength\fR]\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    69
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    70
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    71
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    72
Requires a starting address, specified with -a, and will dump the range of
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    73
physical address but makes no attempt to understand the contents of that memory.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    74
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    75
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    76
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    77
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    78
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    79
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    80
\fB\fB-o\fR [\fIfile\fR]\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    81
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    82
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    83
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    84
Redirect the output provided by the utility to the specified file.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    85
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    86
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    87
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    88
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    89
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    90
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    91
\fB\fB-s\fR [\fIcount\fR]\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    92
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    93
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    94
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    95
Skip \fIcount\fR tables of the given name
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    96
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    97
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    98
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
    99
.ne 2
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   100
.mk
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   101
.na
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   102
\fB\fB-t\fR [\fItable\fR]\fR
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   103
.ad
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   104
.sp .6
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   105
.RS 4n
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   106
Dump only the table with the \fItable\fR signature.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   107
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   108
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   109
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   110
.SH ATTRIBUTES
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   111
See
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   112
.BR attributes (5)
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   113
for descriptions of the following attributes:
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   114
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   115
.TS
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   116
box;
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   117
cbp-1 | cbp-1
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   118
l | l .
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   119
ATTRIBUTE TYPE	ATTRIBUTE VALUE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   120
=
11
87960ed158f9 Import sfw build 137
Cyril Plisko <cyril.plisko@grigale.com>
parents: 1
diff changeset
   121
Availability	diagnostic/acpidump
1
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   122
=
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   123
Interface Stability	Uncommitted
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   124
.TE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   125
.PP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   126
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   127
.SH SEE ALSO
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   128
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   129
.LP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   130
\fBacpixtract\fR(1), \fBmadt\fR(1)
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   131
.RE
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   132
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   133
.SH RESOURCES
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   134
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   135
.LP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   136
http://www.lesswatts.org/projects/acpi/utilities.php
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   137
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   138
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   139
.SH NOTES
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   140
.sp
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   141
.LP
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   142
Source for acpidump is avaliable at www.opensolaris.org.
37d545eabfea Import b127
Cyril Plisko <cyril.plisko@grigale.com>
parents:
diff changeset
   143
The PRIV_FILE_DAC_READ privilege is necessary to use this utility.