X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-suspend.service.xml;h=4abc2781912b534ed64caf0a3267fdf5c9d33f3d;hb=9a7adc9a0ed53d6e422321e9196eb83d18afcba5;hp=d3e08a8f1dacdf0df6df349e49405c6dc3ffb2d9;hpb=34511ca7b166b0e89d08ff9870b0cf2624a7815f;p=elogind.git
diff --git a/man/systemd-suspend.service.xml b/man/systemd-suspend.service.xml
index d3e08a8f1..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,6 +46,7 @@
systemd-suspend.servicesystemd-hibernate.service
+ systemd-hybrid-sleep.servicesystemd-sleepSystem sleep state logic
@@ -52,6 +54,7 @@
systemd-suspend.servicesystemd-hibernate.service
+ systemd-hybrid-sleep.service/usr/lib/systemd/systemd-sleep
@@ -61,46 +64,96 @@
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
+ will be pre, the second either
+ suspend,
+ hibernate, or
+ hybrid-sleep depending on the
chosen action. Immediately after leaving system
- suspend and hibernation the same executables are run,
+ suspend and/or hibernation the same executables are run,
but the first argument is now
- "post". All executables in this
+ post. All executables in this
directory are executed in parallel, and execution of
- the action is not continued before all executables
- finished.
+ 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 and
- systemd-hibernate.service should
- never be executed directly. Instead, trigger system
- sleep states with a command such as "systemctl
- suspend" or suchlike.
+ 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,
systemctl1,
systemd.special7,