apm

APM(1)			  Linux Programmer’s Manual		       APM(1)



NAME
       apm - query Advanced Power Management (APM) BIOS

SYNOPSIS
       apm [ -vVmsS ]

DESCRIPTION
       apm  reads  /proc/apm and presents the output in a human-readable for-
       mat.  Since primarily battery status  information  is  provided,	 this
       command is most useful on laptops with a compliant APM BIOS.  apm also
       allows the machine to be put into standby or suspend mode.

OPTIONS
       -V, --version
	      Print the apm program version and exit immediately.

       -v, --verbose
	      Print information about the APM  BIOS  version  and  Linux  APM
	      driver version.

       -m, --minutes
	      Print total minutes remaining instead of using an hh:mm format.

       -s, --suspend
	      Put the machine into suspend mode if possible.

       -S, --standby
	      Put the machine into standby mode if possible.

       -i, --ignore
	      Tell the system to  ignore  system-generated  APM	 suspend  and
	      standby  events  when on AC power.  This may be useful to users
	      who have laptops and want APM events when on battery power, but
	      not when on AC power.

       -n, --noignore
	      Tell  the system not to ignore system-generated APM suspend and
	      standby events when on AC power.	This  is  the  default	mode;
	      this option is provided as a way to undo a prior "apm -i" call.


       BUGS   This program requires a post-1.3.57 kernel.  This program	 will
	      not  work with older kernels or with the APM patches, since the
	      format for /proc/apm has changed radically.

FILES
       /proc/apm
       linux/drivers/char/apm_bios.c

AUTHOR
       This program was written by Rik Faith (faith@cs.unc.edu)	 and  may  be
       freely  distributed under the terms of the GNU General Public License.
       There is ABSOLUTELY NO WARRANTY for this program.  The  current	main-
       tainer is Avery Pennarun (apenwarr@worldvisions.ca).

SEE ALSO
       xapm(1), apmd(8)



				 10 Jan 1996			       APM(1)