on_ac_power

on_ac_power

on_ac_power tests whether the system is running on AC (mains) power. It returns an exit code indicating power status.The tool is designed for scripting. Exit code 0 means AC power is connected. Exit code 1 means running on battery. Any other exit code indicates the power status cannot be determined.Common uses include scheduling heavy tasks only when plugged in, adjusting backup frequency based on power source, and power-aware cron jobs.The command checks various power subsystems including ACPI, APM, and sysfs to determine status. It works on laptops and systems with battery backup.On systems without batteries or power status information, the result may be unreliable.

0

System is on AC power.

System is on battery.

Cannot determine power status.

May not work on all systems. Desktop systems without UPS typically return "AC". Result depends on kernel power reporting. Some virtual machines report unknown.

on_ac_power is part of the powermgmt-base package on Debian-based systems. It provides a simple interface for power-aware scripting without parsing ACPI or sysfs directly.

acpi(1), upower(1), tlp(8), pm-utils(8)