Add a note that APM was deprecated by the PC manufacturers in about 1996.

Mention the APM emulation layer of ACPI. In addition, some small fixes.
This commit is contained in:
jruoho 2010-03-20 07:59:44 +00:00
parent c8c2757eb3
commit 7e4def2e7d

View File

@ -1,6 +1,6 @@
.\" $NetBSD: apm.8,v 1.19 2008/09/25 22:44:51 reed Exp $ .\" $NetBSD: apm.8,v 1.20 2010/03/20 07:59:44 jruoho Exp $
.\" .\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc. .\" Copyright (c) 1996, 2010 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
.\" .\"
.\" This code is derived from software contributed to The NetBSD Foundation .\" This code is derived from software contributed to The NetBSD Foundation
@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE. .\" POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd June 18, 1996 .Dd March 20, 2010
.Dt APM 8 .Dt APM 8
.Os .Os
.Sh NAME .Sh NAME
@ -46,11 +46,14 @@
.Op Fl f Ar sockname .Op Fl f Ar sockname
.Ek .Ek
.Sh DESCRIPTION .Sh DESCRIPTION
The
.Nm .Nm
communicates with the Advanced Power Management daemon, program communicates with the Advanced Power Management
.Pq Tn APM
daemon,
.Xr apmd 8 , .Xr apmd 8 ,
making requests of it for current power status or to place the system making requests of the current power status or placing the system either
into a suspend or stand-by state. into suspend or stand-by state.
The The
.Nm .Nm
tool is only installed on supported platforms. tool is only installed on supported platforms.
@ -60,7 +63,7 @@ With no flags,
displays the current power management state in verbose form. displays the current power management state in verbose form.
.Pp .Pp
Available command-line flags are: Available command-line flags are:
.Bl -tag -width indent -compact .Bl -tag -width "-f sockname" -compact
.It Fl z .It Fl z
Put the system into suspend (deep sleep) mode. Put the system into suspend (deep sleep) mode.
.It Fl S .It Fl S
@ -70,10 +73,11 @@ Display the estimated battery lifetime in percent.
.It Fl m .It Fl m
Display the estimated battery lifetime in minutes. Display the estimated battery lifetime in minutes.
.It Fl b .It Fl b
Display the battery status. 0 means high, 1 means low, 2 means Display the battery status:
critical, 3 means charging, 4 means absent, and 255 means unknown. 0 means high, 1 means low, 2 means critical, 3 means charging,
4 means absent, and 255 means unknown.
.It Fl a .It Fl a
Display the external charger (A/C status). 0 means disconnected, 1 Display the external charger (A/C status): 0 means disconnected, 1
means connected, 2 means backup power source, and 255 means unknown. means connected, 2 means backup power source, and 255 means unknown.
.It Fl s .It Fl s
Display if power management is enabled. Display if power management is enabled.
@ -122,13 +126,37 @@ flag to work successfully.
is the status device used when the socket is not accessible; it must be is the status device used when the socket is not accessible; it must be
readable to provide current APM status. readable to provide current APM status.
.Sh SEE ALSO .Sh SEE ALSO
.Xr acpi 4 ,
.Xr apm 4 , .Xr apm 4 ,
.Xr apmd 8 .Xr apmd 8
.Sh REFERENCES .Rs
Advanced Power Management (APM) BIOS Interface Specification (revision .%A Intel Corporation
1.1), Intel Corporation and Microsoft Corporation .%A Microsoft Corporation
.%T Advanced Power Management (APM) BIOS Interface Specification
.%N Revision 1.2
.%D February 1996
.Re
.Sh HISTORY .Sh HISTORY
The The
.Nm .Nm
command appeared in command appeared in
.Nx 1.3 . .Nx 1.3 .
.Pp
The
.Tn APM
specification first appeared in 1992.
The last update to the standard was made in 1996 -
the same year when it was superceded by the
.Tn ACPI 1.0
standard.
Thereafter power management on IBM-compatible personal computers has relied on
.Tn ACPI ,
implemented in
.Nx
by the
.Xr acpi 4
subsystem.
The
.Xr acpi 4
provides an emulation layer for the legacy
.Nm .