Provided by: pm-utils_0.99.2-3ubuntu9_all bug

NAME
       pm-action - suspend or hibernate your computer


SYNOPSIS
       pm-hibernate

       pm-suspend [{--quirk-*}]

       pm-suspend-hybrid [{--quirk-*}]


DESCRIPTION
       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
       needed.

       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.

       pm-suspend
           Suspend is a state where most devices are shutdown, except for RAM.
           This state still draws power.

       pm-hibernate
           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.

       pm-suspend-hybrid
           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.


OPTIONS
       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
       be used.

       --quirk-dpms-on

       --quirk-dpms-suspend

       --quirk-radeon-off
           Turn off the backlight on radeons before suspending.

       --quirk-s3-bios
           Set ACPI parameter to s3bios

       --quirk-s3-mode
           Set ACPI parameter to s3mode

       --quirk-vbe-post
           VBE POST the graphics card after resume.

       --quirk-vbemode-restore
           Get VBE mode before suspend and set it after resume.

       --quirk-vbestate-restore
           Save VBE state before suspending and restore after resume.

       --quirk-vga-mode3

       --quirk-save-pci
           Save the PCI config space for the VGA card.


FILES
       /etc/pm/config.d
           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.

       /etc/pm/sleep.d, /usr/lib/pm-utils/sleep.d
           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
           in /etc/pm/sleep.d.

       /var/log/pm-suspend.log
           The log file showing what is done on suspend/hibernate and
           resume/thaw.


CONFIGURATION VARIABLES
       Configuration variables defined by pm-utils. These can be set in any
       file in /etc/pm-utils/config.d

       HIBERNATE_RESUME_POST_VIDEO [=no]
           If video should be posted after hibernate, just like after suspend

       INHIBIT
           File to use as lock-file

       PM_LOGFILE
           File where pm-utils will log to.

       SUSPEND_MODULES
           Modules to unload before suspend

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

       S2DISK_CONF
           If you installed s2disk you can tell pm-utils which configuration
           file it should use for it.


SEE ALSO
       s2ram(8), s2disk(8), s2both(8), pm-is-supported(1), pm-powersave(8),
       vbetool(8), radeontool(8)


AUTHOR
       Tim Dijkstra <tim@famdijkstra.org>
           Manpage author.


COPYRIGHT
       Copyright © 2007 Tim Dijkstra

       This manual page was written for the Debian(TM) system (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 2 or (at
       your option) any later version published by the Free Software
       Foundation.

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