on_ac_power(1)
test whether computer is running on AC power
Description
ON_AC_POWER
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 opposed to battery power.
OPTIONS
None.
EXIT STATUS
|
System is on mains power |
||||
|
System is not on mains power |
||||
|
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 <steved@loth.demon.co.uk>, was updated by Thomas Hood then by Adam Borowski.