SYSTEMD-BAT...CK.SERVICE(8)

๐ŸŽ€ NAME ๐ŸŽ€

okay bestie, so this is the manual page for SYSTEMD-BAT...CK.SERVICE(8) โ€” that's the systemd-battery-check manual, from the systemd-battery-check package, and it's covering two lil besties that work together:

  • systemd-battery-check.service โ€” the service unit ๐Ÿ’–
  • systemd-battery-check โ€” the actual binary it runs โœจ

and what do they do?? they check whether your battery level is enough to keep going, and they power off if it's not. no cap, it's the "girl are you SURE you have enough charge for this" of early boot. ๐Ÿ’…


๐ŸŒธ SYNOPSIS ๐ŸŒธ

systemd-battery-check.service

/usr/lib/systemd/systemd-battery-check [OPTIONS...]

๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

so during the early boot stage, this service does two little vibe checks:

  1. is there an external power supply plugged in? ๐Ÿ”Œ
  2. how much battery level is left? ๐Ÿ”‹

and based on that, it decides whether there's sufficient power to carry on with the booting process. literally the bouncer at the club of startup. ๐Ÿ‘‘

systemd-battery-check returns success if either:

  • the device is connected to an AC power source, or
  • the battery charge is greater than 5%

and it returns failure otherwise. that's it. that's the whole plot. periodt. ๐Ÿ’€


โœจ OPTIONS โœจ

here's everything systemd-battery-check understands, and yes, it's a short list, she's lowkey a minimalist:

  • -h, --help โ€” prints a short help text and dips out. ๐Ÿซถ
  • --version โ€” prints a short version string and dips out. โญ

๐Ÿ’€ EXIT STATUS ๐Ÿ’€

on success (running on AC power or battery capacity greater than 5%), 0 is returned. otherwise you get a non-zero failure code. no in-between, she's not ambiguous, she knows what she wants. ๐Ÿ™ˆ


๐Ÿ”ฅ KERNEL COMMAND LINE ๐Ÿ”ฅ

these are the variables she understands, iykyk:

  • systemd.battery_check=BOOL โ€” takes a boolean. if you specify it with false, then the systemd-battery-check command will return immediately with exit status 0 without checking battery capacity and AC power existence, and the service systemd-battery-check.service will succeed. this may be useful when the command wrongly detects and reports battery capacity percentage or AC power existence, or when you want to boot the system forcibly. ๐Ÿซก
bestie this is your "girl just ignore it" button. added in version 254. ๐ŸŽ€

๐ŸŒˆ SEE ALSO ๐ŸŒˆ

  • systemd(1) โ€” go read the mothership, she knows everything. ๐Ÿ‘‘

okay that's the whole page, you ate that ๐Ÿ’–. this was systemd 262.1, SYSTEMD-BAT...CK.SERVICE(8), and that's the tea โ€” go forth and boot responsibly, mwah ๐ŸŽ€โœจ๐Ÿฆ‹

๐Ÿ“ฆ where this page comes from
  • arch rolling: systemd 262.1-1 ยท LGPL-2.1-or-later AND CC0-1.0 AND GPL-2.0-or-later AND MIT-0
  • ๐Ÿ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms