sys/man/3/apm

   1 .TH APM 3
   2 .SH NAME
   3 apm \- Advanced Power Management 1.2 BIOS interface
   4 .SH SYNOPSIS
   5 .nf
   6 .B bind -a #P /dev
   7
   8 .B /dev/apm
   9 .SH DESCRIPTION
  10 .PP
  11 This device presents a low-level interface to
  12 the APM 1.2 bios calls.
  13 It is enabled by adding the line
  14 .RB `` apm0= ''
  15 to
  16 .IR plan9.ini .
  17 (The value after the equals sign is ignored; the presence of
  18 the line at all enables the driver.)
  19 It is only available on uniprocessor PCs.
  20 Writing a 386
  21 .B Ureg
  22 structure and then reading it back executes an APM call:
  23 the written registers are passed to the call,
  24 and the read registers are those returned by the call.
  25 .\" .PP
  26 .\" In addition, the following strings may be
  27 .\" written to
  28 .\" .B /dev/apm
  29 .\" to negotiate with other kernel devices about
  30 .\" suspension of the system.
  31 .\" .TP
  32 .\" .B "vote suspend
  33 .\" Poll kernel devices for objections to suspending the system.
  34 .\" The write succeeds only when no device objected.
  35 .\" .TP
  36 .\" .B "abort suspend
  37 .\" Notify kernel devices that the vote failed and the
  38 .\" suspension will not happen.
  39 .\" .TP
  40 .\" .B "commit suspend
  41 .\" Notify kernel devices that the vote succeeded and
  42 .\" suspension will happen.  The devices
  43 .\" may take measures such as disabling PCMCIA cards.
  44 .\" .TP
  45 .\" .B "resume suspend
  46 .\" Notify kernel devices that the system has come back
  47 .\" after a suspension.
  48 .\" The devices may take measures such as reenabling PCMCIA cards.
  49 .\" .PD
  50 .\" A similar set of messages governs entrance into
  51 .\" .B standby
  52 .\" mode.
  53 .PP
  54 This device is intended to enable more user-friendly
  55 interfaces such as
  56 .IR apm (8).
  57 .SH SOURCE
  58 .B /sys/src/9/pc/apm.c
  59 .br
  60 .B /sys/src/9/pc/apmjump.s