X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-suspend.service.xml;h=4abc2781912b534ed64caf0a3267fdf5c9d33f3d;hb=07504d6b152084040e48f7657b0f56f364003334;hp=dea778fbec661afa5e074de6c157f11287e65bf8;hpb=e2b696ee9bffad34daaafc99d3a5d8ee13504288;p=elogind.git
diff --git a/man/systemd-suspend.service.xml b/man/systemd-suspend.service.xml
index dea778fbe..4abc27819 100644
--- a/man/systemd-suspend.service.xml
+++ b/man/systemd-suspend.service.xml
@@ -6,6 +6,7 @@
This file is part of systemd.
Copyright 2012 Lennart Poettering
+ Copyright 2013 Zbigniew JÄdrzejewski-Szmek
systemd is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
@@ -45,13 +46,15 @@
systemd-suspend.servicesystemd-hibernate.service
+ systemd-hybrid-sleep.servicesystemd-sleep
- systemd System Suspend/Hibernate Logic
+ System sleep state logicsystemd-suspend.servicesystemd-hibernate.service
+ systemd-hybrid-sleep.service/usr/lib/systemd/systemd-sleep
@@ -61,41 +64,99 @@
systemd-suspend.service is
a system service that is pulled in by
suspend.target and is responsible
- for the actual system suspend. Similar,
+ for the actual system suspend. Similarly,
systemd-hibernate.service is
pulled in by hibernate.target to
- executed the actual hibernation.
-
- Immediately before entering system suspend and
- hibernation
- systemd-suspend.service will run
- all executables in
+ execute the actual hibernation. Finally,
+ systemd-hybrid-sleep.service is
+ pulled in by hybrid-sleep.target
+ to execute hybrid hibernation with system
+ suspend.
+
+ Immediately before entering system suspend
+ and/or hibernation
+ systemd-suspend.service (and the
+ other mentioned units, respectively) will run all
+ executables in
/usr/lib/systemd/system-sleep/
and pass two arguments to them. The first argument
- will be "pre", the second either
- "suspend" or
- "hibernate", depending on the chosen
- action. Immediately after leaving system suspend and
- hibernation the same executables are run, but the
- first argument is now "post". All
- executables in this directory are executed in
- parallel, and execution of the action is not continued
- before all executables finished.
+ will be pre, the second either
+ suspend,
+ hibernate, or
+ hybrid-sleep depending on the
+ chosen action. Immediately after leaving system
+ suspend and/or hibernation the same executables are run,
+ but the first argument is now
+ post. All executables in this
+ directory are executed in parallel, and execution of
+ the action is not continued until all executables
+ have finished.
Note that scripts or binaries dropped in
/usr/lib/systemd/system-sleep/
are intended for local use only and should be
considered hacks. If applications want to be notified
- of system suspend and resume there are much nicer
- interfaces available.
+ of system suspend/hibernation and resume, there are
+ much nicer interfaces available.
+
+ Note that
+ systemd-suspend.service,
+ systemd-hibernate.service, and
+ systemd-hybrid-sleep.service
+ should never be executed directly. Instead, trigger
+ system sleep states with a command such as
+ systemctl suspend or
+ similar.
+
+ Internally, this service will echo a string like
+ mem into
+ /sys/power/state, to trigger the
+ actual system suspend. What exactly is written
+ where can be configured in the [Sleep]
+ section of /etc/systemd/sleep.conf.
+ See systemd-sleep.conf5.
+
+
+
+ Options
+
+ systemd-sleep understands the
+ following commands:
+
+
+
+
+
+
+ Print a short help
+ text and exit.
+
+
+
+
+ Print the systemd version
+ identifier and exit.
+
+
+
+
+
+
+ Suspend, hibernate, or
+ put the system to hybrid sleep.
+
+
+ See Also
+ systemd-sleep.conf5,
systemd1,
- systemd.special7
+ systemctl1,
+ systemd.special7,
systemd-halt.service8