git: 9front

ref: a30f99a4e64b55d80e9bd0d4485972a20bfa2a95
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