phpman > man > on_ac_power(1)

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 opposed 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  "un‐
       known"; 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 AT loth.uk>, was updated by Thomas
       Hood then by Adam Borowski.



                                            12 March 2018                             ON_AC_POWER(1)