FreeBSD Manual Pages

APM(8) FreeBSD System Manager's Manual APM(8)
NAMEapm, zzz -- control the APM BIOS and display its information
SYNOPSISapm [-ablstzZ] [-denable] [-eenable] [-henable] [-rdelta]
zzzDESCRIPTIONApm controls the Intel / Microsoft APM (Advanced Power Management) BIOS
and displays the current status of APM on laptop PCs. Zzz suspends the
system by controlling APM.
The following options are available for apm (no options are available for
zzz). If no options are specified, 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.
-a Display the current AC-line status as an integer value. The val-
ues 0 and 1 correspond to the ``off-line'' state or ``on-line''
state, respectively.
-b Display an integer value reflecting the current battery status.
The values 0, 1, 2, 3, correspond to the ``high'' status, ``low''
status, ``critical'' status, ``charging'' status respectively.
-denable
Disable/enable suspending of the display separately from a normal
suspend using the boolean value for enable. This feature seems
to not work on many different laptops, including the Libretto
30CT and 50CT.
-eenable
Enable or disable APM functions of the computer, depending on the
boolean enable argument.
-henable
Depending on the boolean value of enable, enable or disable the
HLT instruction in the kernel context switch routine. These
options are not necessary for almost all APM implementations, but
for some implementations whose ``IdleCPU'' call executes both
CPU clock slowdown and HLT instruction, -t is necessary to pre-
vent the system from reducing its peak performance. See apm(4)
for details.
-l Display the remaining battery percentage. If your laptop does
not support this function, 255 is displayed.
-rdelta
Enable the resume wakeup timer, if the laptop supports it. This
doesn't actually suspend the laptop, but if the laptop is sus-
pended, and it supports resume from suspend, then it will be
resumed after delta seconds (from when you run this command, not
from when you suspend).
-s Display the status of the APM support as an integer value. The
values 0 and 1 correspond to the ``disabled'' state or
``enabled'' state respectively.
-t Display the estimated remaining battery lifetime in seconds. If
it is unknown, -1 is displayed.
-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 Indica-
tor events. The output of apm tells what your laptop claims to
support.
-z Suspend the system. It is equivalent to zzz.
BUGS
Some APM implementations do not support parameters needed by apm. On
such systems, apm displays them as unknown.
Some APM implementations cannot handle events such as pushing the power
button or closing the cover. On such implementations, the system must be
suspended only by using apm or zzz.
NOTESapmconf(8) has been merged in apm(8) and thus apm(8) replaces all of its
functionality.
SEE ALSOapm(4)AUTHORS
Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>
FreeBSD 11.1 November 1, 1994 FreeBSD 11.1