ref: f059563b9d53d3e63e2d580ed61868153f24c481
dir: /sys/man/8/apm/
.TH APM 8 .SH NAME apm \- Advanced Power Management 1.2 BIOS interface .SH SYNOPSIS .I (in plan9.ini) .B apm0= .PP bind -a '#P' /dev .PP .B aux/apm [ .B -d .I device ] [ .B -m .I mountpoint ] [ .B -s .I service ] .SH DESCRIPTION .I Aux/apm presents at .I mountpoint (default .BR /mnt/apm ) an interface to the APM 1.2 BIOS (see .IR apm (3)) .I device (the default is to try .BR /dev/apm , followed by .BR #P/apm ). If a .I service is specified, the interface will be posted at .BI /srv/ service as well. .PP The directory contains the following files. .TP .B battery Contains one line for each battery in the system. Each line lists three fields: the status (a string, one of .BR unknown , .BR high , .BR low , .BR critical , or .BR charging ), the percent charge remaining, and an estimate of the amount of time left in seconds. If either or both of the last two are unknown, the corresponding field will be zero. .TP .B ctl The .B ctl file is used to set power management modes for various parts of the system. Control messages are of the form .RI `` device " " verb ,'' where .I device is one of .BR system , .BR display , .BR storage , .BR lpt , .BR eia , .BR network , and .BR pcmcia , and .I verb is one of .BR enable , .BR disable , .BR standby , .BR off and .BR on . .B Enable and .B disable control whether power management is active for the device, while .B standby puts the device into standby mode and .B on brings it back to full power. .TP .B event Reads from this file will block until an APM event has occurred. A large enough read is guaranteed to return an integral number of textual event descriptions, one per line. .SH SOURCE .B /sys/src/cmd/aux/apm.c .br .B /acme/bin/Battery .SH BUGS The verbs .B suspend and .B off should be supported but doing so requires nontrivial help from the kernel.