DragonFly On-Line Manual Pages

Search: Section:  

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 4.1			 April 6, 2009			 DragonFly 4.1

Search: Section: