1994-11-01 22:46:40 +00:00
|
|
|
.\" LP (Laptop Package)
|
|
|
|
.\"
|
1998-02-20 07:17:48 +00:00
|
|
|
.\" Copyright (c) 1994 by Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>
|
1994-11-01 22:46:40 +00:00
|
|
|
.\"
|
|
|
|
.\" 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
|
1997-11-12 04:16:23 +00:00
|
|
|
.Op Fl ablstz
|
1997-01-06 06:04:42 +00:00
|
|
|
.Op Fl d Ar 1|0
|
1994-11-01 22:46:40 +00:00
|
|
|
.Pp
|
|
|
|
.Nm zzz
|
|
|
|
.Sh DESCRIPTION
|
1997-09-02 06:36:39 +00:00
|
|
|
.Nm Apm
|
1994-11-01 22:46:40 +00:00
|
|
|
controls the Intel / Microsoft APM (Advanced Power Management) BIOS and
|
|
|
|
displays the current status of APM on laptop PCs.
|
1997-09-02 06:36:39 +00:00
|
|
|
.Nm Zzz
|
1994-11-01 22:46:40 +00:00
|
|
|
suspends the system by controlling APM.
|
|
|
|
.Pp
|
|
|
|
The following options are available for
|
|
|
|
.Nm apm
|
|
|
|
(no options are available for
|
1997-09-02 06:36:39 +00:00
|
|
|
.Nm zzz
|
|
|
|
).
|
1994-11-01 22:46:40 +00:00
|
|
|
If no options are specified,
|
|
|
|
.Nm apm
|
|
|
|
displays information and current status of APM in verbose mode.
|
1997-11-12 04:16:23 +00:00
|
|
|
If multiple display options are given, the values are displayed one
|
|
|
|
per line in the order given here.
|
1994-11-01 22:46:40 +00:00
|
|
|
.Bl -tag -width indent
|
1997-01-06 06:04:42 +00:00
|
|
|
.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.
|
1994-11-01 22:46:40 +00:00
|
|
|
.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.
|
1997-01-06 06:04:42 +00:00
|
|
|
.It Fl d
|
|
|
|
Disable/enable suspending of the display separately from a normal suspend
|
1998-01-25 16:22:22 +00:00
|
|
|
using the values
|
1997-01-06 06:04:42 +00:00
|
|
|
.Ar 1
|
|
|
|
or
|
|
|
|
.Ar 0
|
|
|
|
respectively.
|
1994-11-01 22:46:40 +00:00
|
|
|
.It Fl l
|
|
|
|
Display the remaining battery percentage. If your laptop does not
|
|
|
|
support this function, 255 is displayed.
|
1996-03-13 00:48:06 +00:00
|
|
|
.It Fl s
|
|
|
|
Display the status of the APM support as an integer value. The values
|
|
|
|
0 and 1 correspond to the
|
|
|
|
.Dq disabled
|
1997-09-29 17:43:11 +00:00
|
|
|
state or
|
|
|
|
.Dq enabled
|
1997-09-02 06:36:39 +00:00
|
|
|
state respectively.
|
1997-11-12 04:16:23 +00:00
|
|
|
.It Fl t
|
|
|
|
Display the estimated remaining battery lifetime in seconds. If
|
|
|
|
it is unknown, -1 is displayed.
|
1997-01-06 06:04:42 +00:00
|
|
|
.It Fl z
|
|
|
|
Suspend the system. It is equivalent to
|
1998-01-25 16:22:22 +00:00
|
|
|
.Nm zzz .
|
|
|
|
.El
|
1994-11-01 22:46:40 +00:00
|
|
|
.Sh BUGS
|
|
|
|
Some APM implementations do not support parameters needed by
|
1998-01-25 16:22:22 +00:00
|
|
|
.Nm apm .
|
1994-11-01 22:46:40 +00:00
|
|
|
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
|
1998-01-25 16:22:22 +00:00
|
|
|
.Nm zzz .
|
1994-11-01 22:46:40 +00:00
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr apm 4 ,
|
|
|
|
.Xr apmconf 8
|
|
|
|
.Sh AUTHOR
|
1998-02-20 07:17:48 +00:00
|
|
|
Tatsumi Hosokawa <hosokawa@jp.FreeBSD.org>
|