SYSTEMD-AC-POWER(1)

๐Ÿ’– systemd-ac-power(1) ๐Ÿ’–

okay bestie, welcome to the systemd-ac-power manual page โ€” yes it's a real one, yes it's tiny, and yes it's lowkey iconic for how much it does with so little. sit down, grab a snack ๐Ÿ“


โœจ NAME โœจ

systemd-ac-power โ€” it tells you whether we're plugged into an external power source or not. that's the whole job. main character energy, minimal dialogue. ๐Ÿ‘‘


๐Ÿฆ‹ SYNOPSIS ๐Ÿฆ‹

systemd-ac-power [OPTIONS...]

that's it. that's the vibe. no positional args, no drama, just options. ๐Ÿ’…


๐ŸŒธ DESCRIPTION ๐ŸŒธ

so like, systemd-ac-power is the little tool you run when you wanna know if the system is chillin' on AC power or not.

by default it's so quiet about it โ€” it literally just returns success (if it can detect that we're running on AC power) or failure, with zero output. no text, no emoji, nothing. just a silent little yes or no. ๐Ÿ™ˆ

and bestie, that silence is the point โ€” it's genuinely useful for stuff like debugging ConditionACPower= (peep systemd.unit(5) if you wanna go deeper, iykyk). ๐Ÿซถ


๐ŸŽ€ OPTIONS ๐ŸŽ€

here's everything it understands, and ngl the list is short but every single one eats:

  • -v, --verbose โ€” shows the result as actual text instead of just quietly returning success or failure. so if you were like "girl what did it say" โ€” now it says it. ๐Ÿ’ฌ

Added in version 253.

  • --low โ€” plot twist! instead of showing the AC power state, it shows the low battery state. in this case it returns zero if all batteries are currently discharging and are below 5% of maximum charge. returns non-zero otherwise. it's giving "are we cooked" energy. ๐Ÿชซ

Added in version 254.

  • -h, --help โ€” prints a short help text and dips. โœŒ๏ธ
  • --version โ€” prints a short version string and dips. โœŒ๏ธ

๐Ÿ’€ EXIT STATUS ๐Ÿ’€

on success โ€” meaning yes bestie, you're running on AC power โ€” 0 is returned. ๐ŸŒˆ

anything else? a non-zero failure code. periodt. ๐Ÿ’…


๐Ÿงš SEE ALSO ๐Ÿงš


heads up queen: that default behaviour of no output at all is not a bug, it's a feature. it's meant to be used as a silent check, not a chatty little report. if you want words, pass --verbose. ๐Ÿ’–

okay that's the whole page, and honestly? she's perfect. short, sweet, does exactly one thing and does it flawlessly. obsessed. ๐Ÿ’œ

this has been systemd-ac-power, part of systemd 262.1. love u, go check your power cable, 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