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