1SYSTEMD-SLEEP.CONF(5)         systemd-sleep.conf         SYSTEMD-SLEEP.CONF(5)
2
3
4

NAME

6       systemd-sleep.conf, sleep.conf.d - Suspend and hibernation
7       configuration file
8

SYNOPSIS

10       /etc/systemd/sleep.conf
11
12       /etc/systemd/sleep.conf.d/*.conf
13
14       /run/systemd/sleep.conf.d/*.conf
15
16       /usr/lib/systemd/sleep.conf.d/*.conf
17

DESCRIPTION

19       systemd supports four general power-saving modes:
20
21       suspend
22           a low-power state where execution of the OS is paused, and complete
23           power loss might result in lost data, and which is fast to enter
24           and exit. This corresponds to suspend, standby, or freeze states as
25           understood by the kernel.
26
27       hibernate
28           a low-power state where execution of the OS is paused, and complete
29           power loss does not result in lost data, and which might be slow to
30           enter and exit. This corresponds to the hibernation as understood
31           by the kernel.
32
33       hybrid-sleep
34           a low-power state where execution of the OS is paused, which might
35           be slow to enter, and on complete power loss does not result in
36           lost data but might be slower to exit in that case. This mode is
37           called suspend-to-both by the kernel.
38
39       suspend-then-hibernate
40           A low power state where the system is initially suspended (the
41           state is stored in RAM). If not interrupted within the delay
42           specified by HibernateDelaySec=, the system will be woken using an
43           RTC alarm and hibernated (the state is then stored on disk).
44
45       Settings in these files determine what strings will be written to
46       /sys/power/disk and /sys/power/state by systemd-sleep(8) when
47       systemd(1) attempts to suspend or hibernate the machine. See
48       systemd.syntax(5) for a general description of the syntax.
49

CONFIGURATION DIRECTORIES AND PRECEDENCE

51       The default configuration is defined during compilation, so a
52       configuration file is only needed when it is necessary to deviate from
53       those defaults. By default, the configuration file in /etc/systemd/
54       contains commented out entries showing the defaults as a guide to the
55       administrator. This file can be edited to create local overrides.
56
57       When packages need to customize the configuration, they can install
58       configuration snippets in /usr/lib/systemd/*.conf.d/. Files in /etc/
59       are reserved for the local administrator, who may use this logic to
60       override the configuration files installed by vendor packages. The main
61       configuration file is read before any of the configuration directories,
62       and has the lowest precedence; entries in a file in any configuration
63       directory override entries in the single configuration file. Files in
64       the *.conf.d/ configuration subdirectories are sorted by their filename
65       in lexicographic order, regardless of which of the subdirectories they
66       reside in. When multiple files specify the same option, for options
67       which accept just a single value, the entry in the file with the
68       lexicographically latest name takes precedence. For options which
69       accept a list of values, entries are collected as they occur in files
70       sorted lexicographically. It is recommended to prefix all filenames in
71       those subdirectories with a two-digit number and a dash, to simplify
72       the ordering of the files.
73
74       To disable a configuration file supplied by the vendor, the recommended
75       way is to place a symlink to /dev/null in the configuration directory
76       in /etc/, with the same filename as the vendor configuration file.
77

OPTIONS

79       The following options can be configured in the "[Sleep]" section of
80       /etc/systemd/sleep.conf or a sleep.conf.d file:
81
82       SuspendMode=, HibernateMode=, HybridSleepMode=
83           The string to be written to /sys/power/disk by, respectively,
84           systemd-suspend.service(8), systemd-hibernate.service(8), systemd-
85           hybrid-sleep.service(8), or systemd-suspend-then-
86           hibernate.service(8). More than one value can be specified by
87           separating multiple values with whitespace. They will be tried in
88           turn, until one is written without error. If neither succeeds, the
89           operation will be aborted.
90
91       SuspendState=, HibernateState=, HybridSleepState=
92           The string to be written to /sys/power/state by, respectively,
93           systemd-suspend.service(8), systemd-hibernate.service(8), systemd-
94           hybrid-sleep.service(8), or systemd-suspend-then-
95           hibernate.service(8). More than one value can be specified by
96           separating multiple values with whitespace. They will be tried in
97           turn, until one is written without error. If neither succeeds, the
98           operation will be aborted.
99
100       HibernateDelaySec=
101           The amount of time in seconds that will pass before the system is
102           automatically put into hibernate when using systemd-suspend-then-
103           hibernate.service(8).
104

EXAMPLE: FREEZE

106       Example: to exploit the “freeze” mode added in Linux 3.9, one can use
107       systemctl suspend with
108
109           [Sleep]
110           SuspendState=freeze
111

SEE ALSO

113       systemd-sleep(8), systemd-suspend.service(8), systemd-
114       hibernate.service(8), systemd-hybrid-sleep.service(8), systemd-suspend-
115       then-hibernate.service(8), systemd(1), systemd.directives(7)
116
117
118
119systemd 239                                              SYSTEMD-SLEEP.CONF(5)
Impressum