mischief/openbsd-src
1
0
Fork 0
mirror of https://github.com/openbsd/src.git synced 2024-12-22 16:42:56 -08:00
Code
b0c10c99a4
openbsd-src/usr.sbin/acpidump/acpidump.8

93 lines
2.9 KiB
Groff
Raw Normal View History

add a comma;
2020-11-22 09:10:06 -08:00
.\" $OpenBSD: acpidump.8,v 1.19 2020/11/22 17:10:06 jmc Exp $
Start on a basic ACPI framework -- does not do much more than read out the ACPI tables into kernel memory and attach ACPI and HPET timers currently. In order to test this code, enabling the devices in GENERIC as well as the ACPI_ENABLE option is needed. This code does not do any thermal control yet, so this should be done with care depending on the platform. In the tree so more people can contribute to making this more fully featured. Ok niklas@ grange@ tedu@
2005-06-02 13:09:38 -07:00
.\"
.\" Copyright (c) 1999 Doug Rabson <dfr@FreeBSD.org>
.\" Copyright (c) 2000 Mitsuru IWASAKI <iwasaki@FreeBSD.org>
.\" Copyright (c) 2000 Yasuo YOKOYAMA <yokoyama@jp.FreeBSD.org>
.\" Copyright (c) 2000 Hiroki Sato <hrs@FreeBSD.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD: src/usr.sbin/acpi/acpidump/acpidump.8,v 1.9 2001/09/05 19:21:25 dd Exp $
.\"
add a comma;
2020-11-22 09:10:06 -08:00
.Dd $Mdocdate: November 22 2020 $
Start on a basic ACPI framework -- does not do much more than read out the ACPI tables into kernel memory and attach ACPI and HPET timers currently. In order to test this code, enabling the devices in GENERIC as well as the ACPI_ENABLE option is needed. This code does not do any thermal control yet, so this should be done with care depending on the platform. In the tree so more people can contribute to making this more fully featured. Ok niklas@ grange@ tedu@
2005-06-02 13:09:38 -07:00
.Dt ACPIDUMP 8
.Os
.Sh NAME
.Nm acpidump
.Nd dump ACPI tables
.Sh SYNOPSIS
.Nm
If the argument of -o specifies a directory, dump the files without using a prefix. ok deraadt@
2016-09-26 12:58:26 -07:00
.Fl o Ar prefix
Start on a basic ACPI framework -- does not do much more than read out the ACPI tables into kernel memory and attach ACPI and HPET timers currently. In order to test this code, enabling the devices in GENERIC as well as the ACPI_ENABLE option is needed. This code does not do any thermal control yet, so this should be done with care depending on the platform. In the tree so more people can contribute to making this more fully featured. Ok niklas@ grange@ tedu@
2005-06-02 13:09:38 -07:00
.Sh DESCRIPTION
tweak previous; specifically, -o is no longer optional; ok marco
2010-08-08 07:40:19 -07:00
The
.Nm
command stores ACPI tables from physical memory into files specified by
If the argument of -o specifies a directory, dump the files without using a prefix. ok deraadt@
2016-09-26 12:58:26 -07:00
.Ar prefix .
If
.Ar prefix
specifies a directory, the generated files will be of the form
<prefix>/<sig>.<id>.
Otherwise, they will be named <prefix>.<sig>.<id>.
move the list of options to the right place on the manual page; while here, remove an obsolete url. diff tweaked by jmc@; sent upstream to FreeBSD people. ok jmc@
2008-10-30 15:08:57 -07:00
.Dq sig
is the signature of the ACPI Table;
.Dq id
is unique for each table.
tweak previous; specifically, -o is no longer optional; ok marco
2010-08-08 07:40:19 -07:00
.Pp
If the argument of -o specifies a directory, dump the files without using a prefix. ok deraadt@
2016-09-26 12:58:26 -07:00
Additionally a file called <prefix>/headers or <prefix>.headers will
be created that contains additional human readable information
pertaining to this specific dump.
Add a reference to the ACPICA utilities, with examples. ok deraadt@
2014-03-13 11:41:18 -07:00
.Pp
The ACPICA disassembler is available through the
.Ox
ports tree or package system:
.Bd -literal -offset indent
# pkg_add acpica
Don't suggest running the AML parser as root. :-) kindly pointed out by jmc@
2014-03-13 14:14:08 -07:00
$ iasl -d <prefix>.<sig>.<id>
Add a reference to the ACPICA utilities, with examples. ok deraadt@
2014-03-13 11:41:18 -07:00
.Ed
Make a move towards ending 4 decades of kernel snooping. Add sysctl kern.allowkmem (default 0) which controls the ability to open /dev/mem or /dev/kmem at securelevel > 0. Over 15 years we converted 99% of utilities in the tree to operate on sysctl-nodes (either by themselves or via code hiding in the guts of -lkvm). pstat -d and -v & procmap are affected and continued use of them will require kern.allowkmem=1 in /etc/sysctl.conf. acpidump (and it's buddy sendbug) are affected, but we'll work out a solution soon. There will be some impact in ports. ok kettenis guenther
2016-09-25 08:23:36 -07:00
.Pp
.Nm
requires the ability to open
add a comma;
2020-11-22 09:10:06 -08:00
.Pa /dev/kmem ,
Make a move towards ending 4 decades of kernel snooping. Add sysctl kern.allowkmem (default 0) which controls the ability to open /dev/mem or /dev/kmem at securelevel > 0. Over 15 years we converted 99% of utilities in the tree to operate on sysctl-nodes (either by themselves or via code hiding in the guts of -lkvm). pstat -d and -v & procmap are affected and continued use of them will require kern.allowkmem=1 in /etc/sysctl.conf. acpidump (and it's buddy sendbug) are affected, but we'll work out a solution soon. There will be some impact in ports. ok kettenis guenther
2016-09-25 08:23:36 -07:00
which may be restricted based upon the value of the
.Ar kern.allowkmem
.Xr sysctl 8 .
mention /var/db/acpi; diff from Jan Stary <hans at stare dot cz>; OK deraadt@
2017-06-01 05:26:14 -07:00
.Pp
.Nm
is run at startup and stores the results in
.Pa /var/db/acpi .
Start on a basic ACPI framework -- does not do much more than read out the ACPI tables into kernel memory and attach ACPI and HPET timers currently. In order to test this code, enabling the devices in GENERIC as well as the ACPI_ENABLE option is needed. This code does not do any thermal control yet, so this should be done with care depending on the platform. In the tree so more people can contribute to making this more fully featured. Ok niklas@ grange@ tedu@
2005-06-02 13:09:38 -07:00
.Sh FILES
.Bl -tag -width /dev/mem
.It Pa /dev/mem
mention /var/db/acpi; diff from Jan Stary <hans at stare dot cz>; OK deraadt@
2017-06-01 05:26:14 -07:00
.It Pa /var/db/acpi
Start on a basic ACPI framework -- does not do much more than read out the ACPI tables into kernel memory and attach ACPI and HPET timers currently. In order to test this code, enabling the devices in GENERIC as well as the ACPI_ENABLE option is needed. This code does not do any thermal control yet, so this should be done with care depending on the platform. In the tree so more people can contribute to making this more fully featured. Ok niklas@ grange@ tedu@
2005-06-02 13:09:38 -07:00
.El
.Sh SEE ALSO
oops! none of us spotted that pkg_add is section 1, not 8;
2014-03-13 12:35:08 -07:00
.Xr pkg_add 1 ,
Add a reference to the ACPICA utilities, with examples. ok deraadt@
2014-03-13 11:41:18 -07:00
.Xr mem 4 ,
.Xr packages 7 ,
oops! none of us spotted that pkg_add is section 1, not 8;
2014-03-13 12:35:08 -07:00
.Xr ports 7
various tweaks; ok tholo@
2005-06-03 15:29:48 -07:00
.Sh HISTORY
The
.Nm
command first appeared in
.Ox 3.8 .
Copy Permalink