DragonFly On-Line Manual Pages


BATTD(8)	       DragonFly 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> DragonFly 3.9 April 6, 2009 DragonFly 3.9