099f92f50d
functionality to work (however, the kernel changes were committed to current at 1998/07/05 23:29:11 PDT). o Enable setting of a timer for later wakeup. Note, not all APM BIOSes support this for all modes (mine doesn't support waking up on a timer from standby mode). o Print out the APM capabilities, as reported by the BIOS. o Report wake on ring indication. No way to enable/disable this, but it is reported. o update man page with above o The output of this command has changed, so if you have a script that parses its output, then you may need to rewrite it slightly. o The code attempts to deal with older kernels than July 5, 1998, but that part of the code isn't well tested.
117 lines
3.1 KiB
Groff
117 lines
3.1 KiB
Groff
.\" LP (Laptop Package)
|
|
.\"
|
|
.\" Copyright (c) 1994 by Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>
|
|
.\"
|
|
.\" This software may be used, modified, copied, and distributed, in
|
|
.\" both source and binary form provided that the above copyright and
|
|
.\" these terms are retained. Under no circumstances is the author
|
|
.\" responsible for the proper functioning of this software, nor does
|
|
.\" the author assume any responsibility for damages incurred with its
|
|
.\" use.
|
|
.Dd November 1, 1994
|
|
.Dt APM 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm apm, zzz
|
|
.Nd control the APM BIOS and display its information
|
|
.Sh SYNOPSIS
|
|
.Nm apm
|
|
.Op Fl ablstzZ
|
|
.Op Fl d Ar 1|0
|
|
.Op Fl r Ar delta
|
|
.Pp
|
|
.Nm zzz
|
|
.Sh DESCRIPTION
|
|
.Nm Apm
|
|
controls the Intel / Microsoft APM (Advanced Power Management) BIOS and
|
|
displays the current status of APM on laptop PCs.
|
|
.Nm Zzz
|
|
suspends the system by controlling APM.
|
|
.Pp
|
|
The following options are available for
|
|
.Nm apm
|
|
(no options are available for
|
|
.Nm zzz
|
|
).
|
|
If no options are specified,
|
|
.Nm apm
|
|
displays information and current status of APM in verbose mode.
|
|
If multiple display options are given, the values are displayed one
|
|
per line in the order given here.
|
|
.Bl -tag -width indent
|
|
.It Fl a
|
|
Display the current AC-line status as an integer value. The values
|
|
0 and 1 correspond to the
|
|
.Dq off-line
|
|
state or
|
|
.Dq on-line
|
|
state, respectively.
|
|
.It Fl b
|
|
Display an integer value reflecting the current battery status.
|
|
The values 0, 1, 2, 3, correspond to the
|
|
.Dq high
|
|
status,
|
|
.Dq low
|
|
status,
|
|
.Dq critical
|
|
status,
|
|
.Dq charging
|
|
status respectively.
|
|
.It Fl d
|
|
Disable/enable suspending of the display separately from a normal suspend
|
|
using the values
|
|
.Ar 1
|
|
or
|
|
.Ar 0
|
|
respectively. This argument seems to not work on many different
|
|
laptops, including the Libretto 30CT and 50CT.
|
|
.It Fl l
|
|
Display the remaining battery percentage. If your laptop does not
|
|
support this function, 255 is displayed.
|
|
.It Fl r
|
|
Enable the resume wakeup timer, if the laptop supports it. This
|
|
doesn't actually suspend the laptop, but if the laptop is suspended,
|
|
and it supports resume from suspend, then it will be resume after
|
|
.Ar delta
|
|
seconds (from when you run this command, not from when you suspend).
|
|
.It Fl s
|
|
Display the status of the APM support as an integer value. The values
|
|
0 and 1 correspond to the
|
|
.Dq disabled
|
|
state or
|
|
.Dq enabled
|
|
state respectively.
|
|
.It Fl t
|
|
Display the estimated remaining battery lifetime in seconds. If
|
|
it is unknown, -1 is displayed.
|
|
.It Fl Z
|
|
Transition the system into standby mode. This mode uses less power than
|
|
full power mode, but more than suspend mode. Some laptops support
|
|
resuming from this state on timer or Ring Indicator events. The
|
|
output of apm tells what your laptop claims to support.
|
|
.It Fl z
|
|
Suspend the system. It is equivalent to
|
|
.Nm zzz .
|
|
.El
|
|
.Sh BUGS
|
|
Some APM implementations do not support parameters needed by
|
|
.Nm apm .
|
|
On such systems,
|
|
.Nm apm
|
|
displays them as unknown.
|
|
.Pp
|
|
Some APM implementations cannot handle events such as pushing the
|
|
power button or closing the cover. On such implementations, the system
|
|
.Ar must
|
|
be suspended
|
|
.Ar only
|
|
by using
|
|
.Nm apm
|
|
or
|
|
.Nm zzz .
|
|
.Sh SEE ALSO
|
|
.Xr apm 4 ,
|
|
.Xr apmconf 8
|
|
.Sh AUTHORS
|
|
.An Tatsumi Hosokawa Aq hosokawa@jp.FreeBSD.org
|