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)