shithub: plan9front

ref: 1e773c97e79d74983edd9b46694956f76b0c7fd5
dir: /sys/man/3/apm/

View raw version
.TH APM 3
.SH NAME
apm \- Advanced Power Management 1.2 BIOS interface
.SH SYNOPSIS
.nf
.B bind -a #P /dev

.B /dev/apm
.SH DESCRIPTION
.PP
This device presents a low-level interface to
the APM 1.2 bios calls.
It is enabled by adding the line
.RB `` apm0= ''
to 
.IR plan9.ini .
(The value after the equals sign is ignored; the presence of
the line at all enables the driver.)
It is only available on uniprocessor PCs.
Writing a 386
.B Ureg
structure and then reading it back executes an APM call:
the written registers are passed to the call,
and the read registers are those returned by the call.
.\" .PP
.\" In addition, the following strings may be
.\" written to
.\" .B /dev/apm
.\" to negotiate with other kernel devices about
.\" suspension of the system.
.\" .TP
.\" .B "vote suspend
.\" Poll kernel devices for objections to suspending the system.
.\" The write succeeds only when no device objected.
.\" .TP
.\" .B "abort suspend
.\" Notify kernel devices that the vote failed and the
.\" suspension will not happen.
.\" .TP
.\" .B "commit suspend
.\" Notify kernel devices that the vote succeeded and
.\" suspension will happen.  The devices
.\" may take measures such as disabling PCMCIA cards.
.\" .TP
.\" .B "resume suspend
.\" Notify kernel devices that the system has come back
.\" after a suspension.
.\" The devices may take measures such as reenabling PCMCIA cards.
.\" .PD
.\" A similar set of messages governs entrance into
.\" .B standby
.\" mode.
.PP
This device is intended to enable more user-friendly
interfaces such as 
.IR apm (8).
.SH SOURCE
.B /sys/src/9/pc/apm.c
.br
.B /sys/src/9/pc/apmjump.s