battery-stats-collector(8) [debian man page]

BATTERY-STATS-COLLECTOR(8)				      System Manager's Manual					BATTERY-STATS-COLLECTOR(8)

NAME

       battery-stats-collector - Collect statistics about battery charge

SYNOPSIS

       battery-stats-collector [option] ...

DESCRIPTION

       Does exactly as it says on the tin - it will collect information from the APM subsystem and write it to a log file.

       Normally battery-stats-collector will be invoked by the system startup scripts.

OPTIONS

       battery-stats follow the usual GNU command line syntax, with long options starting with two dashes (`-').

       -V, --version
	      Show version of battery-stats-collector and exit.

       -h, --help
	      Show summary of options and exit.

       -s, --syslog
	      Log  error  messages  to	syslog,  rather than stderr. Note that messages regarding invalid command line parameters will still go to
	      stderr.

       -o filename, --output filename
	      Append statistics to the given file. The default filename is /var/log/battery-stats

       -1, --once
	      Only collect a single sample and exit. The default is to loop continiously.

       -i seconds, --interval=seconds
	      Sampling intervals in seconds. If not specified, stats will be collected every 30 seconds.

       -I, --ignore-missing-battery
	      Keeps quiet about missing batteries. This stops the warnings on stderr/syslog that would otherwise occur when the battery  is  miss-
	      ing.

       -F samplecount, --flush=samplecount
	      Flushes  data  to  the logfile every <samplecount> samples. A value of zero turns off flushing altogether. If left unspecified, bat-
	      tery-stats-collector will assume a value of 1, i.e. flush at every write.  Setting the value too low will  tend  to  keep  the  disk
	      spinning (and use battery needlessly).  Setting the value too high will loose statistics in case of an improper shutdown.
	      Note  that  since  battery-stats-collector  uses the standard Ansi C library, data will still be flushed periodically (regardless of
	      this setting) once the buffer fills up. The size of the buffer is platform dependent, but 4Kb and 8Kb seem pretty normal.

FILES

       /var/log/battery-stats
	      Default file for writing battery charge samples to.

SEE ALSO

       battery-graph(1)
       Newer versions of this program may (or may not) be available at http://karl.jorgensen.com/battery-stats

AUTHOR

       This manual page was written by Karl E. Jorgensen <karl@jorgensen.com>, for the Debian GNU/Linux system (but may be used by others).

								September 18, 2002					BATTERY-STATS-COLLECTOR(8)

WMACPI(1)						      General Commands Manual							 WMACPI(1)

NAME

       wmacpi - Battery status monitor for systems supporting ACPI

SYNOPSIS

       wmacpi [ -c value ] [ -d display ] [ -m battery no ] [ -s sample rate ] [ -f ] [ -v ] [ -n ] [ -x ] [ -a samples ] [ -v ] [ -h ]

DESCRIPTION

       This manual page documents briefly the wmacpi command.

       wmacpi is a program that displays the current battery status in a WindowMaker dock app, on systems that support Intel's Advanced Configura-
       tion and Power Interface specification (ACPI).

       The program monitors a battery, displaying its current percentage charge via a bar and a numeric value. It also displays the current  power
       status  for  the system, the time remaining (calculated based on the remaining battery capacity and the current rate of power usage), and a
       scrolling message with some hopefully useful information.

       Clicking on the window cycles through the batteries that the ACPI system knows about.

OPTIONS

       -c, --critical=percentage
	      Set critical low alarm at <percentage>% (default: 10%).

       -d, --display=display
	      Set the X display to open the window on.

       -m, --battery=battery number
	      Set the battery to monitor initially.

       -s, --sample-rate=sample rate
	      Set the rate at which to sample the ACPI data, in number of times per minute. Minimum is 1, ie once a minute, default is 20, maximum
	      is 600.

       -n, --no-blink
	      Disable blinking power glyph when charging. Note that it still blinks when the battery reports its capacity state as critical.

       -f, --force-capacity-mode
	      Force  the  use of capacity mode for calculating time remaining. By defalt wmacpi will use the reported values of remaining capacity
	      and present rate to calculate the time remaining on battery. This flag will force the use of the remaining capacity and time samples
	      to calculate the present rate of drain, and from there the time remaining. Note that this mode of calculation generally underreports
	      the time remaining. This mode works around certain buggy ACPI BIOSes that fail to report the current rate.

       -x, --cmdline
	      Run wmacpi in command line mode.

       -a, --samples=samples
	      Average the time remaining over num samples. This greatly improves the accuracy of the reported time remaining.

       -V, --verbosity=num
	      Increase the verbosity of the program. Setting this to 1 will print extra error information; 2 will produce informational output;  3
	      will produce copious debugging output.

       -v, --version
	      Print the version information.

       -r, --no-scroll
	      Disable scrolling message.

       -h, --help
	      Display help.

AUTHOR

       wmacpi  was  originally	written  by  Tim  Copperfield  <timecop@japan.co.jp>,  then  completely  rewritten  after  1.34  by  Simon  Fowler
       <simon@himi.org>.

       This manual page was originally written by Simon Richter <sjr@debian.org> for the Debian  GNU/Linux  system,  and  then	updated  by  Simon
       Fowler.
       Last modification by Simon Fowler <simon@himi.org>, 2007-07-13.

								   July 13 2007 							 WMACPI(1)