Provided by: battery-stats_0.3.6-1_i386 bug

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
              missing.

       -F samplecount, --flush=samplecount
              Flushes data to the logfile every <samplecount> samples. A value
              of zero turns off  flushing  altogether.  If  left  unspecified,
              battery-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)