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)
Check Out this Related Man Page
BATTERY-GRAPH(1) General Commands Manual BATTERY-GRAPH(1) NAME
battery-graph - Show a graph of the battery charge SYNOPSIS
battery-graph [options] [files...] DESCRIPTION
Show a graph of the battery charge over time. The files given are assumed to contain battery statistics in the battery-stats(5) format. If no files are specified, the default log files will be used. The options can be used for displaying a different interval. An interval is defined in terms of a from timestamp, a to timestamp and a duration. By specifying any two, the third will be calculated automatically. A missing duration will be defaulted to 3 hours. OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). -g geometry, --geometry geometry Sets the X Windows geometry of the graph. This disables text mode. See X(7) for how to specify the geometry. -D display, --display display Shows the graph on the given display. The same effect can be achived by setting the DISPLAY environment variable. This disables text mode. See X(7) for valid values. --title string Sets the title of the graph window. By default this will be "Battery Graph". If this is set to the empty string, gnuplot(1) will be allowed set the window title - this can be useful if you want your ~/.Xdefaults to take effect for this. -f date, --from date Specifies the start date/time for the graph. This accepts exactly the same date/time specifications as the date (1) command - see examples below or the Texinfo manual for date for details. -t date, --to date Specifies the ending date/time for the graph. This accepts exactly the same date/time specifications as the date (1) command - see examples below or the Texinfo manual for date for details. -s date, --since date Shorthand for --from date --to now -d duration, --duration duration Specifies the duration for the graph. This can be given in units of seconds, hours, days or weeks by suffixing the number with 's' (seconds), 'm' (minutes), 'h' (hours), 'd' (days) or 'w' (weeks). Units cannot be combined - e.g. '1d6h' will not be valid, whereas '30h' is OK. If no unit is specified, minutes will be assumed. --text Shows the graph in text mode on stdout. The resulting size of the graph is determined by the values of the environment variables. LINES and COLUMNS (failing that, the output from tput will be used). This is the default when the environment variable DISPLAY is not set. EXAMPLES
Show the last 2 hours: $ battery-graph --duration 2h Show the time since mid day: $ battery-graph --from 12:00 --to now or $ battery-graph --since 12:00 Show the hour before last: $ battery-graph --from '2 hours ago' --duration 1h Show the 6 hours after noon: $ battery-graph --from 12:00 --duration 6h or $ battery-graph --from 12:00 --to 18:00 Show the last 6 hours $ battery-graph --from '6 hours ago' or $ battery-graph --since '6 hours ago' Show the last 30 minutes in text mode: $ battery-graph --duration 30 --text Show statistics for Tuesday last week $ battery-graph --duration 24h --from 'tuesday last week' or $ battery-graph --duration 1d --from 'tuesday last week' Prove that the future hasn't happened yet: $ battery-graph --from yesterday --to tomorrow Another way of wasting CPU cycles: $ battery-graph /dev/null EXIT STATUS
battery-graph depends on gnuplot (1) to give the correct exit status. FILES
If no files are given on the command line, batter-graph reads from /var/log/battery-stats ENVIRONMENT
DISPLAY If this variable is not set, --text will be defaulted. LINES / COLUMNS Determines the size of the graph in text mode. DIAGNOSTICS
If there are no statistics available for the period chosen, an empty graph will result. NOTES
There is no requirement for the from time to be earlier than the to time - if so, the X axis will be reversed. Similar results can be achieved using a negative duration. Also: battery-stat is quite happy to list statistics in the future; stupid, but obedient. 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). SEE ALSO
battery-stats (5), date (1), battery-stats-collector (8) Newer versions of this program may (or may not) be available at http://karl.jorgensen.com/battery-stats September 22, 2002 BATTERY-GRAPH(1)