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. Jørgensen  <karl@jorgensen.com>,  for  the  Debian
       GNU/Linux system (but may be used by others).

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