Manual: on_ac_power
ON_AC_POWER(1) General Commands Manual ON_AC_POWER(1)
NAME
on_ac_power - test whether computer is running on AC power
SYNOPSIS
on_ac_power
DESCRIPTION
on_ac_power checks whether the system is running on abundant power (such as AC mains, an USB charger, etc), as op‐
posed to battery power.
OPTIONS
None.
EXIT STATUS
0 (true) System is on mains power
1 (false) System is not on mains power
255 (false) Power status could not be determined
CAVEATS
The vast majority of desktops and servers have no power sensors, thus they return 255 "unknown"; for most purposes
you'd want to consider this answer to imply mains power — note that 255 evaluates as false for the shell.
This program currently provides only information known to the kernel; it doesn't (yet?) query userspace daemons such
as nut which may provide further information.
AUTHOR
This manual page was written by Steve Dodd , was updated by Thomas Hood then by Adam
Borowski.
12 March 2018 ON_AC_POWER(1)