powernap

Section: powernap (8) Updated: 2 Jul 2009 Local index Up

NAME

powernap - have the system "take a power nap"; this can be a user defined ACTION_METHOD in /etc/powernap/config among [best-effort, suspend, hibernate, poweroff, powersave]

DESCRIPTION

powernap will run when powernapd(8) has determined that an action needs to be taken according to its configured parameters. The action to be taken, among [best-effort, suspend, hibernate, poweroff], is determined in /etc/powernap/config. By default, the action will be best-effort.

When the ACTION_METHOD is best-effort, and if the file /etc/powernap/action is executable, then the powernap binary will run it when called. Otherwise, powernap will run one of:
  * pm-suspend
  * pm-hibernate
  * poweroff depending on your hardware's capabilities, as determined by pm-is-supported(1).

You may do one of:
  1) Write your own custom at /etc/powernap/action and make it executable
  2) Replace /etc/powernap/action with an executable script or binary
  3) Symlink /etc/powernap/action to some other executable script or binary

When ACTION_METHOD is powersave, then powernap binary will execute pm-suspend.

When ACTION_METHOD is powersave, then powernap binary will execute pm-hibernate.

When ACTION_METHOD is powersave, then powernap binary will execute poweroff.

When ACTION_METHOD is powersave, then powernap binary will execute pm-powersave and pass an argument (true) to execute all the available scripts at /usr/lib/pm-utils/power.d/ and /etc/pm/power.d/. The latter will contain scripts shipped with powernap.

http://launchpad.net/powernap

FILES

/etc/powernap/action, /proc/acpi/sleep

AUTHOR

This manpage and the utility was written by Dustin Kirkland <kirkland@canonical.com> for Ubuntu systems (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.