BATTERY-STATS(5)

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

🦋 battery-stats(5) 🦋

okay so bestie, welcome to the File Formats Manual, this one's all about battery-stats — the collected battery statistics 💖

✨ NAME ✨

battery-stats — collected battery statistics 🍓

🌸 DESCRIPTION 🌸

So like. battery-stats is the file that holds all the statistics about battery charge over time, bestie. And who's out here collecting them? The battery-stats-collector(8) daemon. That's the one doing the work, we're just reading its diary. 📓✨

💅 FORMAT 💅

Every single line in the file = one sample. That's it. One line, one sample, no cap.

And each line looks like this:

<seconds> <charge%> <powermode> <UTC-date> <UTC-time>

They're separated by spaces and terminated by a newline. Periodt. 💁♀️

Where:

  • seconds — the number of seconds since 1st Jan 1970 00:00:00 UTC ⏰
  • charge% — the battery charge, a number between 0 and 100 🔋
  • powermode — tells you 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. And listen, this is in UTC, not the local or system timezone. Do not come for me about timezones bestie, it says UTC and it means UTC 🌍
  • UTC-time — a human-readable time in the format HH:MM:SS (using a 24-hour clock). Also UTC, also not the local or system timezone. Same deal 🕰️
  • minutes-left — this one is the BIOS estimate of how many minutes of running time the battery would provide. It may be unreliable, depending on the BIOS through which it was collected. So like... take it with a grain of salt 🙈

🌈 EXAMPLE 🌈

A battery under charge might give you samples that look like this:

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

look at her go, charging up like a main character 🔥👑

🎀 FILES 🎀

The default set-up is to save battery statistics in /var/log and rotate the logs weekly, which results in this little family 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 💀 (the archives, the elders, the ancestors)

💜 SEE ALSO 💜

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

⭐ AUTHOR ⭐

Karl E. Jorgensen <karl@jorgensen.com> — ty for your service king 🫶

and that's the whole page bestie, you ate that 💅✨

okay so this version is dated September 23, 2002, iykyk — vintage, iconic, still slaying 💖🦋🎀

📦 where this page comes from