Provided by: uswsusp_1.0+20120915-6.1_i386 bug

NAME

       uswsusp.conf - Config file for the s2disk program

DESCRIPTION

       This manual page documents briefly the uswsusp.conf file used by the
       s2disk, s2both and resume commands.

       s2disk is a program that will save the the state of the whole system to
       disk and power off your system. After restarting your system it will be
       put back in the exact system state you left it (this is sometimes
       called hibernation).

S2RAM / S2BOTH OPTIONS

       s2ram_force
           If the "s2ram_force" parameter is set to 'y', the s2ram tool will
           force the suspend process, even the machine is not known,
           parameters (quirks) are not set nor KMS is not supported.

       s2ram_quirks
           Specifies the options (quirks) to suspend the machine. Possible
           options are vbe_post, vbe_save, vbe_mode, radeon_off, pci_save,
           s3_bios, s3_mode and fb_nosuspend. More information about these
           options are included in s2ram(8) manpage and the README.s2ram-
           whitelist file.

S2DISK / S2BOTH OPTIONS

       snapshot device [=/dev/snapshot]
           Device via which s2disk should talk to the kernel.

       resume device
           Specifies the device to write the image to. This is a swap
           partition or the partition that contains the swap file (see next
           parameter).

       resume offset
           Necessary if a swap file is used for suspending. In such a case the
           device identified by the "resume device" parameter is regarded as
           the partition that contains the swap file, and "resume offset" must
           be equal to the offset from the beginning of this partition at
           which the swap file's header is located, in <PAGE_SIZE> units. The
           value of this parameter for given swap file can be determined by
           the swap-offset program (has to be run as root) included in this
           package. [For this feature to work, you will need an \-mm kernel,
           2.6.18-mm3 or newer.]

       image size
           Limit the size of the system snapshot image created by the s2disk
           tool, but it's not mandatory. Namely, the s2disk tool will do its
           best to limit the image size as required by this parameter, but if
           that's not possible, it will suspend the system anyway, with a
           bigger image. If "image size" is set to 0, the snapshot image will
           be as small as possible.

       suspend loglevel
           You can specify the kernel console loglevel which the s2disk/s2both
           and resume utilities will use to report progress. On a stock kernel
           messages with level higher then 7 are usually not shown.

       shutdown method
           This parameter defines the operation that will be carried out after
           the suspend image has been created and the machine is ready to be
           powered off. If it is set to "reboot", the machine will be rebooted
           immediately. If it is set to "platform", the machine will be shut
           down using special power management operations available from the
           kernel that may be necessary for the hardware to be properly
           reinitialized after the resume, and may cause the system to resume
           faster (this is the recommended shutdown method on the majority of
           systems and hence the defaul). If set to "shutdown" the machine
           will be powered off.

       compute checksum
           If the "compute checksum" parameter is set to 'y', the s2disk and
           resume tools will use the MD5 algorithm to verify the image
           integrity.

       compress
           If the "compress" parameter is set to 'y', the s2disk and resume
           tools will use the LZF compression algorithm to compress/decompress
           the image.

       encrypt
           If the "encrypt" parameter is set to 'y', the s2disk and resume
           tools will use the Blowfish encryption algorithm to encrypt/decrypt
           the image. On resume and suspend you will have to supply a
           passphrase. By using a pregenerated RSA key, you can avoid having
           to type a passphrase on suspend. See the "RSA key file" option for
           more information.

       RSA key file
           If this option points to a valid RSA key, which can be created with
           suspend-keygen, the s2disk tool will generate a random key for the
           Blowfish encryption that will be passed to the resume tool within
           the image header with the help of the RSA cipher. Consequently you
           only need to type a passphrase on resume.

       early writeout
           If the "early writeout" parameter is set to 'y', the s2disk utility
           will start syncing the resume device early in the process of
           writing the image to it. [This has been reported to speed up the
           s2disk on some boxes and eliminates the "fast progress meter and
           long fsync wait" effect.]

       splash
           The "splash" parameter is used to make s2disk and/or resume use a
           splash system (when set to 'y'). Currently the bootsplash.org and
           splashy systems are supported. For the former you need a kernel
           patch, the latter is a userspace solution, but you'll need to
           install a splashy theme.

           If you use initramfs-tools on your favorite Linux distribution to
           generate your initramfs, usually the necessary files will be copied
           to it.

SEE ALSO

       s2disk (8). suspend-keygen(8)

       For more information see the README file.

AUTHOR

       This manual page was written by Tim Dijkstra <tim@famdijkstra>.org for
       the Debian(TM) system (but may be used by others). Was updated by
       Rodolfo García <kix@kix.es>. Permission is granted to copy, distribute
       and/or modify this document under the terms of the GNU General Public
       License, Version 2 any later version published by the Free Software
       Foundation.

COPYRIGHT

       Copyright © 2006 Tim Dijkstra Copyright © 2012 Rodolfo García (kix)