path: root/README
diff options
authorRichard Hughes <>2006-04-26 22:00:21 +0000
committerRichard Hughes <>2006-04-26 22:00:21 +0000
commitf541984ba988aae495aac2044e56bdb400410bd2 (patch)
tree9d43167bff2bd66728fa058695865836f9e40cc2 /README
parent8e2395b91c02b0c028d7dd0cadbdfbce9c85faac (diff)
2006-04-26 Richard Hughes <>
Diffstat (limited to 'README')
1 files changed, 25 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..c18a3a4
--- /dev/null
+++ b/README
@@ -0,0 +1,25 @@
+=== pm-utils ===
+What is pm-utils?
+* Provides simple shell command line tools to suspend and hibernate computer
+that can be used to run vendor or distro supplied scripts on suspend and resume.
+Why do we need it?
+* As all the main distros are re-implimenting the same thing, over and over, to
+do something that's really quite trivial.
+Having the common locations for stuff means that software and hardware vendors
+can just install one file to do the clever stuff.
+* Distros can easily add/remove functionality by installing/removing one
+file into the hooks directory, for example:
+- enabling and disabling standby LED's on laptop hardware
+- enabling suspend GUI's like suspend2
+- re-enabling video
+- starting and stopping services that can't cope with suspending
+- re-syncing the time with ntp
+- removing and modprobing modules when needed
+- setting grub to be the default target for a hibernate-resume
+- other wacky things that need doing on specific systems