X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-suspend.service.xml;h=690f961a21caff59870af0f24a9bea9d17eb6b02;hp=dea778fbec661afa5e074de6c157f11287e65bf8;hb=8f18f550e7023948f199616fdfbb0f09711fd615;hpb=e2b696ee9bffad34daaafc99d3a5d8ee13504288 diff --git a/man/systemd-suspend.service.xml b/man/systemd-suspend.service.xml index dea778fbe..690f961a2 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 @@ -21,7 +22,8 @@ along with systemd; If not, see . --> - + systemd-suspend.service @@ -45,13 +47,15 @@ systemd-suspend.service systemd-hibernate.service + systemd-hybrid-sleep.service systemd-sleep - systemd System Suspend/Hibernate Logic + System sleep state logic systemd-suspend.service systemd-hibernate.service + systemd-hybrid-sleep.service /usr/lib/systemd/systemd-sleep @@ -61,41 +65,89 @@ 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: + + + + + + + + + + Suspend, hibernate, or + put the system to hybrid sleep. + + + See Also + systemd-sleep.conf5, systemd1, - systemd.special7 + systemctl1, + systemd.special7, systemd-halt.service8