Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

BATTD(8)		  BSD System Manager's Manual		      BATTD(8)

NAME
     battd — Battery status monitoring daemon

SYNOPSIS
     battd [-dEhT] [-c seconds] [-e command] [-f device] [-p percent]
	   [-s status] [-t minutes]

DESCRIPTION
     The battd daemon monitors the status of the battery or batteries present
     in the system.  The daemon will alert all users on the system and may
     execute a supplied command once a particular criterion has been met.  The
     criteria are based on the percentage remaining, the time remaining and
     the status of the battery.

     The options are as follows:

     -c seconds
	     Interval in seconds for checking the battery status.  Default is
	     30 seconds.

     -d	     Start in debug mode (works when battd is compiled with -DDEBUG).

     -e command
	     Execute command once condition has been met.

     -E	     Execute command only once after a condition has been met.

     -f device
	     Specifies a different device path to be used.  Default is
	     /dev/apm.

     -h	     Print battd command line usage and exit.

     -p percent
	     Alert users when the remaining battery life has reached approxi‐
	     mately percent.  Default is 10.  A value of 0 turns this alert
	     off.

     -s status
	     Alert users when the remaining battery has reached a given sta‐
	     tus.  The status specified can either be high, low or critical.

     -t minutes
	     Alert users when the remaining battery time has reached approxi‐
	     mately minutes.

     -T	     Alert users when the system has approximately 10 minutes remain‐
	     ing battery time, but don't execute command (-e) on this alert.

EXAMPLES
	   battd -p 50 -s low
     Alert users when the battery percentage has reached 50% and once again
     when the status reaches low.

	   battd -t 15 -c 10
     Alert users when the battery has 15 minutes worth of power remaining and
     once again when battery percentage has reached 10%.  Decrease the inter‐
     val between checking the battery to 10 seconds.

	   battd -Tt4 -p0 -Ee "/sbin/shutdown -p +2 Battery_Low"
     Alert users when the battery has 10 minutes worth power remaining and
     alert again when 4 minutes is remaining and then execute the given
     shutdown(8) command once.	(User will have to kill(1) the shutdown(8)
     process, if AC power is connected to system and shutdown isn't wanted.)

SEE ALSO
     viapm(4), apm(8), apmd(8), syslogd(8), zzz(8)

HISTORY
     The battd command first appeared in DragonFly 1.1.

AUTHORS
     Liam J. Foy ⟨liamfoy@dragonflybsd.org⟩

     Man page contributions by:
     Maxime Labelle ⟨mlabelle@vt220.com⟩
     Sarunas Vancevicius ⟨svan@redbrick.dcu.ie⟩

BSD				 April 6, 2009				   BSD

Vote for polarhome