BATTERY-STATS-COLLECTOR(8)

📦 version 0.5.6, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 BATTERY-STATS-COLLECTOR(8) 💖

okay bestie, so this is a page from the System Manager's Manual, and it's all about a lil tool called battery-stats-collector — yes that's section 8, the big-girl admin section, we love that for her 👑

✨ NAME ✨

battery-stats-collector — literally just collects stats about battery charge 🍓

🌸 SYNOPSIS 🌸

battery-stats-collector [option] ...

🦋 DESCRIPTION 🦋

She does exactly what it says on the tin, no cap. It pulls info from the APM subsystem and writes it into a log file. That's the whole vibe. 💅

Normally? battery-stats-collector gets invoked by the system startup scripts, like she's got places to be at boot time. main character energy fr fr.

👑 OPTIONS 👑

battery-stats follow the usual GNU command line syntax, with long options starting with two dashes (-).

  • -o FILE, --output FILE — appends the statistics to FILE. The default filename is /var/log/battery-stats 💾
  • -i SECS, --interval=SECS — sampling interval, in seconds. If you don't say anything, stats get collected every 30 seconds ⏰
  • -F COUNT, --flush=COUNT — flushes data to the log file every COUNT samples. A value of zero turns flushing off entirely. If you leave it unspecified, battery-stats-collector assumes a value of 1, aka flush at every single write. 🚽
real talk: set it too low and you'll keep the disk spinning (and burn battery for absolutely no reason 😭). Set it too high and you'll lose statistics if the shutdown is improper. it's giving ✨tradeoffs✨

Also note: 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.

  • -b NUM, --battery-num=NUM — read information about battery number NUM. for when you've got multiple batteries installed, look at you, so fancy 🔋🔋
  • -1, --once — only collect a single sample and then exit. The default is to loop continiously. 🔁
  • -I, --ignore-missing-battery — keeps quiet about missing batteries. This stops the warnings on stderr/syslog that would otherwise show up when the battery is missing. 🤫
  • -s, --syslog — log error messages to syslog, rather than to stderr. Heads up tho: messages about invalid command line parameters will still go to stderr. 🙈
  • -V, --version — show version of battery-stats-collector and exit. ✌️
  • -h, --help — show summary of options and exit. the girl loves to explain herself 💖

🎀 FILES 🎀

  • /var/log/battery-stats — the default file for writing battery charge samples to. 🗂️

🌈 SEE ALSO 🌈

Newer versions of this program may (or may not) be available at http://karl.jorgensen.com/battery-stats — lowkey iconic that they said "or may not" 😭

💜 AUTHOR 💜

This manual page was written initially written by Karl E. Jorgensen <karl@jorgensen.com>, for the Debian GNU/Linux system (but may be used by others).

Adapted by Antonio Radici <antonio@dyne.org> to include libacpi and autotools support, see History for details.

Kevin Funk <kevin@kfunk.org> took over maintainership in 2012. 👑

so yeah, that's the whole page, we ate and left no crumbs. this was battery-stats-collector(8) from the System Manager's Manual, dated October 30, 2012 — hope your battery stats are immaculate, bestie, ily 🫶💖✨

📦 where this page comes from