Extracted from hibernate-1.12/debian/control:
=============================================
hibernate - activates your computer's suspend functionality
This package provides a way to activate the suspend functionality in
the kernel. Currently it supports anything using the /sys/power/state
interface (including ACPI suspend and the in-kernel software
suspend), as well as Software Suspend 2 (which is available as a
separate kernel patch).
Hibernate can take care of loading and unloading modules, various
hacks needed to get some video cards to resume properly under X,
restarting networking and system services. It can be extended by
writing new "scriplets" which run at different parts of the suspend
process.
Extracted from hibernate-1.12/debian/changelog:
===============================================
hibernate (1.12-1) unstable; urgency=low
* New upstream release (closes: #332240).
- Supports swsusp 2.2-rc8 which renamed the /proc entries again.
* Remove empty /usr/local/share/hibernate when purged (closes: #328296).
* Fix lock scriptlet to work with mawk (closes: #326695).
* Update address of FSF in copyright file.
-- Cameron Patrick <cameron@NOSPAM> Fri, 21 Oct 2005 14:17:00 +0800
hibernate (1.10-1) unstable; urgency=low
* New upstream release.
* Don't break when people use mawk, not gawk, as /usr/bin/awk
(closes: #317410).
* Correct the location of grub menu file backups to /var/backups, not
/var/backup (closes: #310759).
-- Cameron Patrick <cameron@NOSPAM> Tue, 26 Jul 2005 19:12:29 +0800
hibernate-1.12/debian/copyright:
================================
This is Bernard Blackham's Software Suspend Script, a script for
activating the software suspend functionality present in some
kernels. It was downloaded from:
http://dagobah.ucc.asn.au/swsusp/script2/
Copyright (C) 2004 Bernard Blackham <bernard@NOSPAM>
The hibernate-script package is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
On Debian GNU/Linux systems, the complete text of the GNU General
Public License can be found in `/usr/share/common-licenses/GPL'.
# arch-tag: 94bced7c-a9ff-4ced-bffd-dade31cb6af5
# -*- text -*-
hibernate-1.12/debian/README.Debian:
====================================
Debian-specific notes about Hibernate and Software Suspend 2
============================================================
Patches for Suspend2 which apply to vanilla (non-Debian) kernels can be
obtained from the upstream web site at http://www.suspend2.net/
Those who prefer to run Debian kernels (compiled from the sources in the
kernel-source-2.6.x packages) won't be able to use these patches, due to
the extensive changes in the Debian kernels and the invasiveness of the
suspend2 patch. However, the kernel-patch-suspend2 package contains the
suspend patch ported so that it will to Debian kernels, and integrated
into the standard Debian make-kpkg --added-patches system - at the price
of being slightly less up-to-date than the ones from suspend2.
-- Cameron Patrick <cameron@NOSPAM>, Sat Apr 30 20:31:33 2005
hibernate-1.12/README:
======================
The hibernate-script package offers a utility that performs all the preparatory
steps to suspending your machine, invoking the desired suspend method (either
one of the suspend-to-disk variants, or suspend-to-RAM), and restoring your
machine on resume.
(This README has been slightly altered so that it accurately reflects
the changes made in the Debian-packaged version of the script.)
PREREQUISITES
-------------
A kernel with suspend support of some variety. The currently supported options
are:
- Software Suspend 2 - kernel patches are available from
http://www.suspend2.net/
- swsusp support in vanilla 2.6 kernels (through the UseSysfsPowerState disk
option).
- S3 (suspend-to-RAM) support in 2.6 kernels (through the
UseSysfsPowerState mem option).
INSTALLATION
------------
This Debian package installs the following files and directories:
/usr/sbin/hibernate <--- main executable script
/etc/hibernate/
/etc/hibernate/hibernate.conf <--- main configuration file
/etc/hibernate/scriptlets.d/ <--- for custom scriptlets
/usr/share/hibernate/scriptlets.d/ <--- contains "scriptlets" (or plugins)
various scriptlets live in /usr/share/hibernate/scriptlets.d/
The Debian version of the suspend script installs the standard
scriptlets in /usr/share/hibernate/scriptlets.d, but also looks in
/etc/hibernate/scriptlets.d and /usr/local/share/hibernate/scriptlets.d
for any custom scriptlets that you may want to write. Documentation
on writing scriptlets can be found in /usr/share/doc/hibernate/SCRIPTLET-API.gz.
AVOIDING DATA LOSS
------------------
This Debian package includes an init script /etc/init.d/hibernate
which will invalidate any suspend image on a clean boot so that the
image cannot be later resumed from (leading to corruption of your
filesystems).
Additionally, the hibernate script will look for a particular file before
suspending (/var/run/suspend2-new-kernel) and if it is detected, will refuse to
suspend. The idea is that your installation scripts for new kernels create
this file, which prevents you from hibernating until you have booted your new
kernel (or you remove the file manually if you know what you are doing). For
example, kernel packages compiled with the Debian kernel-patch-suspend2 patches
do this upon installation.
CONFIGURATION
-------------
The default configuration does nothing but save and restore your clock, and
unload some modules that will potentially cause suspending to fail. If you have
other kernel modules that need to be unloaded, filesystems unmounted, network
interfaces brought down, etc, you will want to customise the configuration file
in /etc/hibernate/hibernate.conf. Run hibernate -h for help on the possible
options. There is also a man page for hibernate.conf as well as hibernate
itself.
RUNNING
-------
Simply calling "hibernate" as root will do everything mentioned in the
configuration file to hibernate, and activate your suspend method. Upon
resuming, any tasks for resuming the machine are run and the script exits.
If you want users other than root to be able to run the script, check out the
sudo package.
CALLING FROM ACPID
------------------
You may wish to call this script from acpid to allow you to press a button on
your machine to hibernate, or to activate it on lid closure. For example, you
could modify /etc/acpi/events/powerbtn to run hibernate when you press the
power button, as follows:
event=button[ /]power PWRF
action=/usr/local/sbin/hibernate
You can watch ACPI events as they occur by running acpi_listen. If you find that
your machine is hibernating twice, you are probably receiving two events for
each button press. To only trigger on one, you may need to use the line
event=button[ /]power PWRF.*[02468ace]$
to match only every second event. However, for non-button events (such as
triggering on lid closure), it may be more reliable to check the state of the
lid before suspending. For example, a small script called /etc/acpi/lid.sh :
#!/bin/sh
#
# Initiate suspend when lid is closed
if grep -q closed /proc/acpi/button/lid/$2/state ; then
/usr/local/sbin/hibernate
fi
and in /etc/acpi/events/lid
event=button[ /]lid
action=/etc/acpi/lid.sh %e
will trigger only when the lid is closed.
For more details, man acpid. For debugging look into /var/log/acpid.
MORE SCRIPTLETS
---------------
As the hibernate script is very extensible , some users have written their own
scriptlets to control certain applications or hardware at suspend and resume
time. These scriptlets can be found on the Software Suspend 2 Wiki at
http://wiki.suspend2.net/HibernateScript . These are not supported by the
hibernate script author, but you should be able to find help either from their
respective authors or the suspend2-users list.
HELP
----
If you have problems with the hibernate script or Software Suspend, the best
place to ask is on the mailing list - suspend2-users@NOSPAM. You
will need to subscribe to post. See http://www.suspend2.net/lists for details.
If the suspend process itself crashes (while "Writing caches", "Reading
caches", or "Copying original kernel back", etc), then the problem lies with
Software Suspend 2 itself. See the FAQ at http://www.suspend2.net/ for help on
debugging.
AUTHOR
------
This script was written by Bernard Blackham, with contributions from:
- Carsten Rietzschel (modules, devices, bootsplash, lock and grub scriptlets.
many ideas and bugfixes)
- Cameron Patrick (sysfs_power_state, xscreensaver support for lock, many
bugfixes and ideas, man pages and Debian packaging)
- Kevin Fenzi (rpm packaging, ideas)
- Fedor Karpelevitch (lilo scriptlet idea)
- Henrik Brix Andersen (gentoo packaging, hardware_tweaks scriptlet and doing
lots of debugging)
- And many others! (see changelog for full credits)
LICENSE
-------
Copyright (C) 2004-2005 Bernard Blackham <bernard@NOSPAM>
The hibernate-script package is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program. If not, write to the Free Software Foundation, Inc., 59 Temple
Place - Suite 330, Boston, MA 02111-1307, USA.
$Id: README 975 2005-10-02 05:54:27Z bernard $
Name Last modified Size
![[DIR]](/icons/back.gif)
Parent Directory -
![[ ]](/icons/unknown.gif)
Contents-i386 09-Oct-2008 07:08 3.0K
Contents-i386.bz2 09-Oct-2008 07:08 514
![[ ]](/icons/compressed.gif)
Contents-i386.gz 09-Oct-2008 07:08 439
hibernate_1.12-1.diff.gz 01-Feb-2006 23:05 7.5K
hibernate_1.12-1.dsc 09-Oct-2008 05:44 628
hibernate_1.12-1_all.deb 01-Feb-2006 23:05 67K
hibernate_1.12.orig.tar.gz 22-Oct-2005 06:32 63K
override 01-Feb-2006 23:05 22
Packages 09-Oct-2008 07:08 1.0K
Packages.bz2 09-Oct-2008 07:08 700
Packages.gz 09-Oct-2008 07:08 648
Release 09-Oct-2008 07:08 843
Release.gpg 09-Oct-2008 18:41 189
Sources 09-Oct-2008 07:08 465
Sources.bz2 09-Oct-2008 07:08 380
Sources.gz 09-Oct-2008 07:08 344