Provided by: pm-utils_0.99.2-3ubuntu9_all
pm-action - suspend or hibernate your computer
This manual page documents briefly the pm-action, pm-hibernate,
pm-suspend and pm-suspend-hybrid commands. This manual page was written
for the Debian(TM) distribution because the original program does not
have a manual page.
These commands can be used to put the machine in a sleep state. The
precise way how this is done can be influenced by installing executabes
and configuration snipplets. For some options external programs are
These commands will usually be called by hald when triggered to do so
by a program in a desktop session such as gnome-power-manager. Calling
them from the command line is also possible, but it is not guaranteed
that all programs in your desktop session keep working as expected.
Suspend is a state where most devices are shutdown, except for RAM.
This state still draws power.
During hibernate the state of the system is saved to disk, the
system is fully powered off. Except maybe for a very low power
state on - for example - an ethernet card to enable wake-on-lan.
Hybrid-suspend is the process where first the state of the system
is saved to disk - just like with hibernate - but instead of
poweroff, the system goes in suspend state, which means it can
wakeup quicker than for normal hibernation. The advantage over
suspend is that you can resume even if you run out of power.
s2both(8) is an hybrid-suspend implementation.
Om most hardware putting the video card in the suspend state and
recovering from it needs some hacks. With the --quirk-* options of the
pm-suspend and pm-suspend-hybrid commands you can select which should
Turn off the backlight on radeons before suspending.
Set ACPI parameter to s3bios
Set ACPI parameter to s3mode
VBE POST the graphics card after resume.
Get VBE mode before suspend and set it after resume.
Save VBE state before suspending and restore after resume.
Save the PCI config space for the VGA card.
The files in this directory are evaluated in C sort order. These
files can be provided by individual packages outside of pm-utils.
If a global configuration variable is set, the value set to will be
appended to the previous value. If any other variable is set, it
will be ignored. The syntax is simply: VAR_NAME = value. See the
CONFIGURATION VARIABLES section for valid variables defined by
pm-utils. External packages can define others, see their respective
documentation for more information.
Programs in these directories (we call them hooks) are combined and
executed in C sort order before suspend and hibernate with as
argument ´suspend´ or ´hibernate´. Afterwards they are called in
reverse order with argument ´resume´ and ´thaw´ respectively. If
both directories contain a similar named file, the one in
/etc/pm/sleep.d will get preference. It is possible to disable a
hook in the distribution directory by putting a non-executable file
The log file showing what is done on suspend/hibernate and
Configuration variables defined by pm-utils. These can be set in any
file in /etc/pm-utils/config.d
If video should be posted after hibernate, just like after suspend
File to use as lock-file
File where pm-utils will log to.
Modules to unload before suspend
If you installed s2ram you can tell pm-utils which command line
options to use. This overrides any options given on the command
line to pm-utils.
If you installed s2disk you can tell pm-utils which configuration
file it should use for it.
s2ram(8), s2disk(8), s2both(8), pm-is-supported(1), pm-powersave(8),
Tim Dijkstra <firstname.lastname@example.org>
Copyright © 2007 Tim Dijkstra
This manual page was written for the Debian(TM) system (but may be used
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 2 or (at
your option) any later version published by the Free Software
On Debian systems, the complete text of the GNU General Public License
can be found in file:///usr/share/common-licenses/GPL.