[MAN] on_ac_power

Content-type: text/html; charset=UTF-8

ON_AC_POWER

Section: User Commands (1)
Updated: 12 March 2018
Index Return to Main Contents

---

 

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 "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.

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXIT STATUS

CAVEATS

AUTHOR

---

This document was created by man2html, using the manual pages.
Time: 04:45:22 GMT, September 16, 2022