1
0

apm 1.6 KB

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