powerd(8)

powerd8

System power control utility

Usage

powerd [-a mode] [-b mode] [-i percent] [-M freq] [-m freq] [-N] [-n mode] [-P pidfile] [-p ival] [-r percent] [-s source] [-v]

Overview

The powerd utility monitors the system state and sets various power control options accordingly. It offers power-saving modes that can be individually selected for operation on AC power or batteries.

maximum

Choose the highest performance values. May be abbreviated as max.

minimum

Choose the lowest performance values to get the most power savings. May be abbreviated as min.

adaptive

Attempt to strike a balance by degrading performance when the system appears idle and increasing it when the system is busy. It offers a good balance between a small performance loss for greatly increased power savings. May be abbreviated as adp.

hiadaptive

Like adaptive mode, but tuned for systems where performance and interactivity are more important than power consumption. It increases frequency faster, reduces frequency less aggressively, and will maintain full frequency for longer. May be abbreviated as hadp.

The default mode is adaptive for battery power and hiadaptive for the rest.

powerd recognizes these runtime options:

-a mode

Selects the mode to use while on AC power.

Not on Linux.
-b mode

Selects the mode to use while on battery power.

Not on Linux.
-i percent

Specifies the CPU load percent level when adaptive mode should begin to degrade performance to save power. The default is 50% or lower.

Not on Linux.
-M freq

Specifies the maximum frequency to throttle up to.

Not on Linux.
-m freq

Specifies the minimum frequency to throttle down to.

Not on Linux.
-N

Treat "nice" time as idle for the purpose of load calculation; i.e., do not increase the CPU frequency if the CPU is only busy with "nice" processes.

Not on Linux.
-n mode

Selects the mode to use normally when the AC line state is unknown.

Not on Linux.
-P pidfile

Specifies an alternative file in which the process ID should be stored.

Not on Linux.
-p ival

Specifies a different polling interval (in milliseconds) for AC line state and system idle levels. The default is 250 ms.

Not on Linux.
-r percent

Specifies the CPU load percent level where adaptive mode should consider the CPU running and increase performance. The default is 75% or higher.

Not on Linux.
-s source

Enforces method for AC line state refresh; by default, it is chosen automatically. The set of valid methods is sysctl, devd and apm (i386 only).

Not on Linux.
-v

Verbose mode. Messages about power changes will be printed to stdout and powerd will operate in the foreground.

Not on Linux.

Files

/var/run/powerd.pid

The default PID file.

Releases

50 releases since FreeBSD 5.5-RELEASE; the text changed 35 times.

  1. 5.5
  2. 6.0
  3. 6.1–6.3
  4. 6.4
  5. 7.0
  6. 7.1
  7. 7.2
  8. 7.3
  9. 7.4
  10. 8.0
  11. 8.1
  12. 8.2
  13. 8.3
  14. 8.4
  15. 9.0
  16. 9.1
  17. 9.2
  18. 9.3
  19. 10.0
  20. 10.1
  21. 10.2
  22. 10.3
  23. 10.4
  24. 11.0
  25. 11.1
  26. 11.2
  27. 11.3
  28. 11.4
  29. 12.0
  30. 12.1
  31. 12.2
  32. 12.3
  33. 12.4
  34. 13.0
  35. 13.1–13.2
  36. 13.3–16.0

-M since FreeBSD 8.2-RELEASE; -N since FreeBSD 12.2-RELEASE; -P since FreeBSD 6.1-RELEASE; -m since FreeBSD 8.2-RELEASE; -s since FreeBSD 12.1-RELEASE.

History

The powerd utility first appeared in FreeBSD 6.0.

Authors

Colin Percival first wrote estctrl, the utility that powerd is based on. Nate Lawson then updated it for cpufreq(4), added features, and wrote this manual page.

Bugs

The powerd utility should also power down idle disks and other components besides the CPU.

If powerd is used with /etc/rc.d/power_profile, they may override each other.

The powerd utility should probably use the devctl(4) interface instead of polling for AC line state.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.