battery-stats (5)

Leading comments

                                     Hey, EMACS: 
First parameter, NAME, should be all caps
Second parameter, SECTION, should be 1-8, maybe w/ subsection
other parameters are allowed: see man(7), man(1)

(The comments found at the beginning of the groff file "man5/battery-stats.5".)

NAME

battery-stats - collected battery statistics

DESCRIPTION

The battery-stats contains statistics about battery charge over time, as collected by the battery-stats-collector (8) daemon.

FORMAT

Each line in the file represents one sample and is of the form: separated by spaces and terminated by a newline.

Where:

seconds

is the number of seconds since 1st Jan 1970 00:00:00 UTC

charge%

is the battery charge a number between 0 and 100

powermode

indicates the power mode:

0 A/C off
1 On battery
2 On backup power

UTC-date

a human-readable date in the format YYYY/MM/DD. Note that this is in UTC, not the local or system timezone.

UTC-time

a human-readable time in the format HH:MM:SS (using a 24-hour clock). Note that this is in UTC, not the local or system timezone.

minutes-left

is the BIOS estimate of how many minutes of running time the battery would provide. This may be unreliable, depending on the BIOS through which it was collected.

EXAMPLE

A battery under charge might result in the following samples:

1032651245 27 1 2002/09/21 23:34:05 94
1032651275 28 1 2002/09/21 23:34:35 97
1032651305 29 1 2002/09/21 23:35:05 100
1032651335 30 1 2002/09/21 23:35:35 103
1032651365 30 1 2002/09/21 23:36:05 106

FILES

The default set-up is to save battery statistics in /var/log and rotate the logs weekly, which results in this set of files:
/var/log/battery-stats - current (most recent) statistics
/var/log/battery-stats.[0-9]+ - less recent statistics
/var/log/battery-stats.[0-9]+.gz - ancient statistics

SEE ALSO

battery-graph(1), battery-stats-collector(8).

AUTHOR

Karl E. Jorgensen <karl@jorgensen.com>