xref: /dflybsd-src/usr.sbin/acpi/acpiconf/acpiconf.8 (revision 6a3cbbc2f58ad88d84cd75a46172f308759e5fc3)
1967ae586SMatthew Dillon.\"-
2f6e8a0a1SImre Vadasz.\" Copyright (c) 2000 Dag-Erling Coïdan Smørgrav
3967ae586SMatthew Dillon.\" All rights reserved.
4967ae586SMatthew Dillon.\"
5967ae586SMatthew Dillon.\" Redistribution and use in source and binary forms, with or without
6967ae586SMatthew Dillon.\" modification, are permitted provided that the following conditions
7967ae586SMatthew Dillon.\" are met:
8967ae586SMatthew Dillon.\" 1. Redistributions of source code must retain the above copyright
9967ae586SMatthew Dillon.\"    notice, this list of conditions and the following disclaimer
10967ae586SMatthew Dillon.\"    in this position and unchanged.
11967ae586SMatthew Dillon.\" 2. Redistributions in binary form must reproduce the above copyright
12967ae586SMatthew Dillon.\"    notice, this list of conditions and the following disclaimer in the
13967ae586SMatthew Dillon.\"    documentation and/or other materials provided with the distribution.
14967ae586SMatthew Dillon.\" 3. The name of the author may not be used to endorse or promote products
15967ae586SMatthew Dillon.\"    derived from this software without specific prior written permission.
16967ae586SMatthew Dillon.\"
17967ae586SMatthew Dillon.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18967ae586SMatthew Dillon.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19967ae586SMatthew Dillon.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20967ae586SMatthew Dillon.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21967ae586SMatthew Dillon.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22967ae586SMatthew Dillon.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23967ae586SMatthew Dillon.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24967ae586SMatthew Dillon.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25967ae586SMatthew Dillon.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26967ae586SMatthew Dillon.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27967ae586SMatthew Dillon.\"
2820cc1873SSascha Wildner.\" $FreeBSD: head/usr.sbin/acpi/acpiconf/acpiconf.8 267668 2014-06-20 09:57:27Z bapt $
29967ae586SMatthew Dillon.\"
30*6a3cbbc2SSascha Wildner.Dd May 29, 2020
31967ae586SMatthew Dillon.Dt ACPICONF 8
32967ae586SMatthew Dillon.Os
33967ae586SMatthew Dillon.Sh NAME
342352f0a1SSascha Wildner.Nm acpiconf ,
352352f0a1SSascha Wildner.Nm apm
36967ae586SMatthew Dillon.Nd control ACPI power management
37967ae586SMatthew Dillon.Sh SYNOPSIS
38967ae586SMatthew Dillon.Nm
3977c1a34eSAlexander Polakov.Op Fl h
40967ae586SMatthew Dillon.Op Fl i Ar batt
4120cc1873SSascha Wildner.Op Fl k Ar ack
42967ae586SMatthew Dillon.Op Fl s Ar type
432352f0a1SSascha Wildner.Pp
442352f0a1SSascha Wildner.Nm apm
45967ae586SMatthew Dillon.Sh DESCRIPTION
46967ae586SMatthew DillonThe
47967ae586SMatthew Dillon.Nm
48967ae586SMatthew Dillonutility allows the user control of the ACPI power management
49967ae586SMatthew Dillonfunctions.
50967ae586SMatthew DillonThe following command-line options are recognized:
51967ae586SMatthew Dillon.Bl -tag -width ".Fl s Ar type"
52967ae586SMatthew Dillon.It Fl h
53967ae586SMatthew DillonDisplays a summary of available options.
54967ae586SMatthew Dillon.It Fl i Ar batt
55967ae586SMatthew DillonGet design information about the specified battery.
56dc9157a7SSascha WildnerA value of 0 means the first battery.
5720cc1873SSascha Wildner.It Fl k Ar ack
5820cc1873SSascha WildnerAck or abort a pending suspend request using the argument provided.
5920cc1873SSascha Wildner.Sy Most users should not use this option directly.
60967ae586SMatthew Dillon.It Fl s Ar type
61967ae586SMatthew DillonEnters the specified sleep mode.
62967ae586SMatthew DillonRecognized types are
63967ae586SMatthew Dillon.Cm 1
64967ae586SMatthew Dillon(only the CPU clock is stopped),
65967ae586SMatthew Dillon.Cm 2
66967ae586SMatthew Dillon(not implemented on most systems but similar to S1),
67967ae586SMatthew Dillon.Cm 3
68967ae586SMatthew Dillon(the CPU context is lost and memory context is preserved),
69967ae586SMatthew Dillon.Cm 4
70967ae586SMatthew Dillon(the CPU context is lost and memory context is stored to disk)
71967ae586SMatthew Dillonand
72967ae586SMatthew Dillon.Cm 5
73967ae586SMatthew Dillon(soft off).
74967ae586SMatthew DillonSleep states may also be given as S1, S2, etc.
75967ae586SMatthew DillonThe supported states depend on BIOS implementation, including ACPI
76967ae586SMatthew Dillonbyte code (AML).
77967ae586SMatthew DillonIf the
78967ae586SMatthew Dillon.Pa /etc/rc.suspend
79967ae586SMatthew Dillonand
80967ae586SMatthew Dillon.Pa /etc/rc.resume
81967ae586SMatthew Dillonscripts are executable, they will be run before and after entering
82967ae586SMatthew Dillonthe given sleep state.
83967ae586SMatthew Dillon.El
842352f0a1SSascha Wildner.Pp
852352f0a1SSascha Wildner.Nm apm
862352f0a1SSascha Wildneris a shortcut for
872352f0a1SSascha Wildner.Nm Fl i Ar 0 .
88967ae586SMatthew Dillon.Sh SEE ALSO
89967ae586SMatthew Dillon.Xr acpi 4 ,
9061c0377fSSascha Wildner.Xr acpibin 8 ,
91279dd846SSascha Wildner.Xr acpicall 8 ,
92967ae586SMatthew Dillon.Xr acpidump 8 ,
9361c0377fSSascha Wildner.Xr acpiexec 8 ,
9461c0377fSSascha Wildner.Xr acpihelp 8 ,
9561c0377fSSascha Wildner.Xr acpixtract 8 ,
9661c0377fSSascha Wildner.Xr iasl 8
97967ae586SMatthew Dillon.Sh HISTORY
98967ae586SMatthew DillonThe
99967ae586SMatthew Dillon.Nm
100967ae586SMatthew Dillonutility appeared in
101967ae586SMatthew Dillon.Fx 5.0 .
102967ae586SMatthew Dillon.Sh AUTHORS
103967ae586SMatthew Dillon.An -nosplit
104967ae586SMatthew DillonThe
105967ae586SMatthew Dillon.Nm
106967ae586SMatthew Dillonutility was written by
107e65bc1c3SFranco Fichtner.An Mitsuru Iwasaki Aq Mt iwasaki@FreeBSD.org .
108967ae586SMatthew DillonThis manual page was written by
109e65bc1c3SFranco Fichtner.An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org .
110