]> git.ipfire.org Git - thirdparty/systemd.git/blame - NEWS
update TODO
[thirdparty/systemd.git] / NEWS
CommitLineData
d657c51f 1systemd System and Service Manager
220a21d3 2
fcb97512
LP
3CHANGES WITH 240 in spe:
4
5 * A new service type has been added: Type=exec. It's very similar to
6 Type=simple and ensures the service manager will wait for both fork()
7 and execve() of the main service binary to complete before proceeding
8 with follow-up units. This is primarily useful so that the manager
9 propagates any errors in the preparation phase of service execution
10 back to the job that requested the unit to be started. For example,
11 consider a service that has ExecStart= set to a file system binary
12 that doesn't exist. With Type=simple starting the unit would
13 typically succeed instantly, as only fork() has to complete
14 successfully and execve() is not waited for, and hence its failure is
15 seen "too late". With the new Type=exec service type starting the
16 unit will fail, as the execve() will be waited for and will fail,
17 which is then propagated back to the start job.
18
19 NOTE: with the next release 241 of systemd we intend to change the
20 systemd-run tool to default to Type=exec for transient services
21 started by it. This should be mostly safe, but in specific corner
22 cases might result in problems, as the systemd-run tool will then
23 block on NSS calls (such as user name lookups due to User=) done
24 between the fork() and execve(), which under specific circumstances
25 might cause problems. It is recommended to specify "-p Type=simple"
26 explicitly in the few cases where this applies. For regular,
27 non-transient services (i.e. those defined with unit files on disk)
28 we will continue to default to Type=simple.
29
0972c1ae
LP
30 * The Linux kernel's current default RLIMIT_NOFILE resource limit for
31 userspace processes is set to 1024 (soft) and 4096
32 (hard). Previously, systemd passed this on unmodified to all
33 processes it forked off. With this systemd release the hard limit
34 systemd passes on is increased to 256K, overriding the kernel's
35 defaults and substantially increasing the number of simultaneous file
36 descriptors unprivileged userspace processes can allocate. Note that
37 the soft limit remains at 1024 for compatibility reasons: the
38 traditional UNIX select() call cannot deal with file descriptors >=
39 1024 and increasing the soft limit globally might thus result in
40 programs unexpectedly allocating a high file descriptor and thus
41 failing abnormally when attempting to use it with select() (of
42 course, programs shouldn't use select() anymore, and prefer
43 poll()/epoll, but the call unfortunately remains undeservedly popular
44 at this time). This change reflects the fact that file descriptor
45 handling in the Linux kernel has been optimized in more recent
46 kernels and allocating large numbers of them should be much cheaper
47 both in memory and in performance than it used to be. Programs that
48 want to take benefit of the increased limit have to "opt-in" into
49 high file descriptors explicitly by setting their soft limit to the
50 hard limit during initialization. Of course, when doing that they
51 must do this acknowledging the fact that they cannot use select()
52 anymore (and neither can any shared library they use — or any shared
53 library used by any shared library they use and so on).
54
a8b627aa
LP
55 * The fs.nr_open and fs.file-max sysctls are now automatically bumped
56 to the highest possible values, as separate accounting of file
57 descriptors is no longer necessary, as memcg tracks them correctly as
58 part of the memory accounting anyway. Thus, from the four limits on
59 file descriptors currently enforced (fs.file-max, fs.nr_open,
60 RLIMIT_NOFILE hard, RLIMIT_NOFILE soft) we turn off the first two,
61 and keep only the latter two. A set of build-time options
62 (-Dbump-proc-sys-fs-file-max=no and -Dbump-proc-sys-fs-nr-open=no)
63 has been added to revert this change in behaviour, which might be
64 an option for systems that turn off memcg in the kernel.
65
e8498f82 66CHANGES WITH 239:
019cb3ab
SH
67
68 * NETWORK INTERFACE DEVICE NAMING CHANGES: systemd-udevd's "net_id"
d69f5282
ZJS
69 builtin will name network interfaces differently than in previous
70 versions for virtual network interfaces created with SR-IOV and NPAR
71 and for devices where the PCI network controller device does not have
72 a slot number associated.
73
74 SR-IOV virtual devices are now named based on the name of the parent
75 interface, with a suffix of "v<N>", where <N> is the virtual device
76 number. Previously those virtual devices were named as if completely
77 independent.
78
79 The ninth and later NPAR virtual devices will be named following the
80 scheme used for the first eight NPAR partitions. Previously those
81 devices were not renamed and the kernel default (eth<n>) was used.
82
83 "net_id" will also generate names for PCI devices where the PCI
84 network controller device does not have an associated slot number
85 itself, but one of its parents does. Previously those devices were
86 not renamed and the kernel default (eth<n>) was used.
019cb3ab 87
6e2d744b
YW
88 * AF_INET and AF_INET6 are dropped from RestrictAddressFamilies= in
89 systemd-logind.service. Since v235, IPAddressDeny=any has been set to
fe903cf4
LP
90 the unit. So, it is expected that the default behavior of
91 systemd-logind is not changed. However, if distribution packagers or
92 administrators disabled or modified IPAddressDeny= setting by a
93 drop-in config file, then it may be necessary to update the file to
94 re-enable AF_INET and AF_INET6 to support network user name services,
95 e.g. NIS.
96
97 * When the RestrictNamespaces= unit property is specified multiple
98 times, then the specified types are merged now. Previously, only the
99 last assignment was used. So, if distribution packagers or
100 administrators modified the setting by a drop-in config file, then it
101 may be necessary to update the file.
e0eee477 102
1fc83d09
LP
103 * When OnFailure= is used in combination with Restart= on a service
104 unit, then the specified units will no longer be triggered on
105 failures that result in restarting. Previously, the specified units
106 would be activated each time the unit failed, even when the unit was
107 going to be restarted automatically. This behaviour contradicted the
108 documentation. With this release the code is adjusted to match the
109 documentation.
110
41a4c3ec
LP
111 * systemd-tmpfiles will now print a notice whenever it encounters
112 tmpfiles.d/ lines referencing the /var/run/ directory. It will
113 recommend reworking them to use the /run/ directory instead (for
5cadf58e
ZJS
114 which /var/run/ is simply a symlinked compatibility alias). This way
115 systemd-tmpfiles can properly detect line conflicts and merge lines
116 referencing the same file by two paths, without having to access
117 them.
41a4c3ec 118
ce55bd5e
ZJS
119 * systemctl disable/unmask/preset/preset-all cannot be used with
120 --runtime. Previously this was allowed, but resulted in unintuitive
fe903cf4
LP
121 behaviour that wasn't useful. systemctl disable/unmask will now undo
122 both runtime and persistent enablement/masking, i.e. it will remove
123 any relevant symlinks both in /run and /etc.
ce55bd5e 124
e01d9e21
LP
125 * Note that all long-running system services shipped with systemd will
126 now default to a system call whitelist (rather than a blacklist, as
127 before). In particular, systemd-udevd will now enforce one too. For
128 most cases this should be safe, however downstream distributions
129 which disabled sandboxing of systemd-udevd (specifically the
130 MountFlags= setting), might want to disable this security feature
131 too, as the default whitelisting will prohibit all mount, swap,
132 reboot and clock changing operations from udev rules.
133
5cadf58e
ZJS
134 * sd-boot acquired new loader configuration settings to optionally turn
135 off Windows and MacOS boot partition discovery as well as
136 reboot-into-firmware menu items. It is also able to pick a better
137 screen resolution for HiDPI systems, and now provides loader
41a4c3ec
LP
138 configuration settings to change the resolution explicitly.
139
c9299be2
IT
140 * systemd-resolved now supports DNS-over-TLS. It's still
141 turned off by default, use DNSOverTLS=opportunistic to turn it on in
c086ce8c
LP
142 resolved.conf. We intend to make this the default as soon as couple
143 of additional techniques for optimizing the initial latency caused by
144 establishing a TLS/TCP connection are implemented.
145
73c718a9
YW
146 * systemd-resolved.service and systemd-networkd.service now set
147 DynamicUser=yes. The users systemd-resolve and systemd-network are
abc291aa
LP
148 not created by systemd-sysusers anymore.
149
150 NOTE: This has a chance of breaking nss-ldap and similar NSS modules
151 that embedd a network facing module into any process using getpwuid()
152 or related call: the dynamic allocation of the user ID for
153 systemd-resolved.service means the service manager has to check NSS
154 if the user name is already taken when forking off the service. Since
155 the user in the common case won't be defined in /etc/passwd the
156 lookup is likely to trigger nss-ldap which in turn might use NSS to
157 ask systemd-resolved for hostname lookups. This will hence result in
158 a deadlock: a user name lookup in order to start
159 systemd-resolved.service will result in a host name lookup for which
160 systemd-resolved.service needs to be started already. There are
161 multiple ways to work around this problem: pre-allocate the
162 "systemd-resolve" user on such systems, so that nss-ldap won't be
163 triggered; or use a different NSS package that doesn't do networking
164 in-process but provides a local asynchronous name cache; or configure
165 the NSS package to avoid lookups for UIDs in the range `pkg-config
166 systemd --variable=dynamicuidmin` … `pkg-config systemd
167 --variable=dynamicuidmax`, so that it does not consider itself
168 authoritative for the same UID range systemd allocates dynamic users
169 from.
73c718a9 170
41a4c3ec
LP
171 * The systemd-resolve tool has been renamed to resolvectl (it also
172 remains available under the old name, for compatibility), and its
173 interface is now verb-based, similar in style to the other <xyz>ctl
5cadf58e
ZJS
174 tools, such as systemctl or loginctl.
175
75da262a
LP
176 * The resolvectl/systemd-resolve tool also provides 'resolvconf'
177 compatibility. It may be symlinked under the 'resolvconf' name, in
5cadf58e
ZJS
178 which case it will take arguments and input compatible with the
179 Debian and FreeBSD resolvconf tool.
41a4c3ec
LP
180
181 * Support for suspend-then-hibernate has been added, i.e. a sleep mode
182 where the system initially suspends, and after a time-out resumes and
183 hibernates again.
184
185 * networkd's ClientIdentifier= now accepts a new option "duid-only". If
186 set the client will only send a DUID as client identifier.
187
188 * The nss-systemd glibc NSS module will now enumerate dynamic users and
189 groups in effect. Previously, it could resolve UIDs/GIDs to user
190 names/groups and vice versa, but did not support enumeration.
191
192 * journald's Compress= configuration setting now optionally accepts a
193 byte threshold value. All journal objects larger than this threshold
194 will be compressed, smaller ones will not. Previously this threshold
195 was not configurable and set to 512.
196
5cadf58e
ZJS
197 * A new system.conf setting NoNewPrivileges= is now available which may
198 be used to turn off acquisition of new privileges system-wide
199 (i.e. set Linux' PR_SET_NO_NEW_PRIVS for PID 1 itself, and thus also
200 for all its children). Note that turning this option on means setuid
201 binaries and file system capabilities lose their special powers.
202 While turning on this option is a big step towards a more secure
203 system, doing so is likely to break numerous pre-existing UNIX tools,
204 in particular su and sudo.
41a4c3ec
LP
205
206 * A new service systemd-time-sync-wait.service has been added. If
207 enabled it will delay the time-sync.target unit at boot until time
bc99dac5 208 synchronization has been received from the network. This
41a4c3ec
LP
209 functionality is useful on systems lacking a local RTC or where it is
210 acceptable that the boot process shall be delayed by external network
211 services.
212
213 * When hibernating, systemd will now inform the kernel of the image
214 write offset, on kernels new enough to support this. This means swap
215 files should work for hibernation now.
216
5cadf58e
ZJS
217 * When loading unit files, systemd will now look for drop-in unit files
218 extensions in additional places. Previously, for a unit file name
41a4c3ec
LP
219 "foo-bar-baz.service" it would look for dropin files in
220 "foo-bar-baz.service.d/*.conf". Now, it will also look in
221 "foo-bar-.service.d/*.conf" and "foo-.service.d/", i.e. at the
222 service name truncated after all inner dashes. This scheme allows
223 writing drop-ins easily that apply to a whole set of unit files at
224 once. It's particularly useful for mount and slice units (as their
5cadf58e
ZJS
225 naming is prefix based), but is also useful for service and other
226 units, for packages that install multiple unit files at once,
41a4c3ec 227 following a strict naming regime of beginning the unit file name with
5cadf58e
ZJS
228 the package's name. Two new specifiers are now supported in unit
229 files to match this: %j and %J are replaced by the part of the unit
230 name following the last dash.
231
232 * Unit files and other configuration files that support specifier
88099359 233 expansion now understand another three new specifiers: %T and %V will
5cadf58e 234 resolve to /tmp and /var/tmp respectively, or whatever temporary
88099359
ZJS
235 directory has been set for the calling user. %E will expand to either
236 /etc (for system units) or $XDG_CONFIG_HOME (for user units).
41a4c3ec
LP
237
238 * The ExecStart= lines of unit files are no longer required to
239 reference absolute paths. If non-absolute paths are specified the
240 specified binary name is searched within the service manager's
5cadf58e
ZJS
241 built-in $PATH, which may be queried with 'systemd-path
242 search-binaries-default'. It's generally recommended to continue to
243 use absolute paths for all binaries specified in unit files.
41a4c3ec 244
c7f93e28
ZJS
245 * Units gained a new load state "bad-setting", which is used when a
246 unit file was loaded, but contained fatal errors which prevent it
ba1dc1a1
LP
247 from being started (for example, a service unit has been defined
248 lacking both ExecStart= and ExecStop= lines).
c7f93e28 249
41a4c3ec
LP
250 * coredumpctl's "gdb" verb has been renamed to "debug", in order to
251 support alternative debuggers, for example lldb. The old name
252 continues to be available however, for compatibility reasons. Use the
5cadf58e
ZJS
253 new --debugger= switch or the $SYSTEMD_DEBUGGER environment variable
254 to pick an alternative debugger instead of the default gdb.
41a4c3ec
LP
255
256 * systemctl and the other tools will now output escape sequences that
257 generate proper clickable hyperlinks in various terminal emulators
258 where useful (for example, in the "systemctl status" output you can
259 now click on the unit file name to quickly open it in the
260 editor/viewer of your choice). Note that not all terminal emulators
261 support this functionality yet, but many do. Unfortunately, the
262 "less" pager doesn't support this yet, hence this functionality is
263 currently automatically turned off when a pager is started (which
264 happens quite often due to auto-paging). We hope to remove this
5cadf58e
ZJS
265 limitation as soon as "less" learns these escape sequences. This new
266 behaviour may also be turned off explicitly with the $SYSTEMD_URLIFY
267 environment variable. For details on these escape sequences see:
41a4c3ec
LP
268 https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
269
270 * networkd's .network files now support a new IPv6MTUBytes= option for
271 setting the MTU used by IPv6 explicitly as well as a new MTUBytes=
272 option in the [Route] section to configure the MTU to use for
273 specific routes. It also gained support for configuration of the DHCP
274 "UserClass" option through the new UserClass= setting. It gained
275 three new options in the new [CAN] section for configuring CAN
276 networks. The MULTICAST and ALLMULTI interface flags may now be
277 controlled explicitly with the new Multicast= and AllMulticast=
278 settings.
279
280 * networkd will now automatically make use of the kernel's route
281 expiration feature, if it is available.
282
5cadf58e
ZJS
283 * udevd's .link files now support setting the number of receive and
284 transmit channels, using the RxChannels=, TxChannels=,
285 OtherChannels=, CombinedChannels= settings.
286
287 * Support for UDPSegmentationOffload= has been removed, given its
288 limited support in hardware, and waning software support.
41a4c3ec
LP
289
290 * networkd's .netdev files now support creating "netdevsim" interfaces.
291
292 * PID 1 learnt a new bus call GetUnitByControlGroup() which may be used
293 to query the unit belonging to a specific kernel control group.
294
5cadf58e 295 * systemd-analyze gained a new verb "cat-config", which may be used to
41a4c3ec
LP
296 dump the contents of any configuration file, with all its matching
297 drop-in files added in, and honouring the usual search and masking
298 logic applied to systemd configuration files. For example use
299 "systemd-analyze cat-config systemd/system.conf" to get the complete
300 system configuration file of systemd how it would be loaded by PID 1
5cadf58e
ZJS
301 itself. Similar to this, various tools such as systemd-tmpfiles or
302 systemd-sysusers, gained a new option "--cat-config", which does the
41a4c3ec
LP
303 corresponding operation for their own configuration settings. For
304 example, "systemd-tmpfiles --cat-config" will now output the full
305 list of tmpfiles.d/ lines in place.
306
704ae536
YW
307 * timedatectl gained three new verbs: "show" shows bus properties of
308 systemd-timedated, "timesync-status" shows the current NTP
309 synchronization state of systemd-timesyncd, and "show-timesync"
310 shows bus properties of systemd-timesyncd.
41a4c3ec
LP
311
312 * systemd-timesyncd gained a bus interface on which it exposes details
313 about its state.
314
73c718a9
YW
315 * A new environment variable $SYSTEMD_TIMEDATED_NTP_SERVICES is now
316 understood by systemd-timedated. It takes a colon-separated list of
317 unit names of NTP client services. The list is used by
318 "timedatectl set-ntp".
319
41a4c3ec
LP
320 * systemd-nspawn gained a new --rlimit= switch for setting initial
321 resource limits for the container payload. There's a new switch
5cadf58e 322 --hostname= to explicitly override the container's hostname. A new
41a4c3ec
LP
323 --no-new-privileges= switch may be used to control the
324 PR_SET_NO_NEW_PRIVS flag for the container payload. A new
325 --oom-score-adjust= switch controls the OOM scoring adjustment value
326 for the payload. The new --cpu-affinity= switch controls the CPU
327 affinity of the container payload. The new --resolv-conf= switch
328 allows more detailed control of /etc/resolv.conf handling of the
5cadf58e 329 container. Similarly, the new --timezone= switch allows more detailed
41a4c3ec
LP
330 control of /etc/localtime handling of the container.
331
5cadf58e 332 * systemd-detect-virt gained a new --list switch, which will print a
41a4c3ec
LP
333 list of all currently known VM and container environments.
334
5cadf58e 335 * Support for "Portable Services" has been added, see
41a4c3ec 336 doc/PORTABLE_SERVICES.md for details. Currently, the support is still
5cadf58e
ZJS
337 experimental, but this is expected to change soon. Reflecting this
338 experimental state, the "portablectl" binary is not installed into
41a4c3ec
LP
339 /usr/bin yet. The binary has to be called with the full path
340 /usr/lib/systemd/portablectl instead.
341
342 * journalctl's and systemctl's -o switch now knows a new log output
343 mode "with-unit". The output it generates is very similar to the
344 regular "short" mode, but displays the unit name instead of the
345 syslog tag for each log line. Also, the date is shown with timezone
346 information. This mode is probably more useful than the classic
347 "short" output mode for most purposes, except where pixel-perfect
348 compatibility with classic /var/log/messages formatting is required.
349
350 * A new --dump-bus-properties switch has been added to the systemd
351 binary, which may be used to dump all supported D-Bus properties.
c7f93e28
ZJS
352 (Options which are still supported, but are deprecated, are *not*
353 shown.)
41a4c3ec 354
41a4c3ec
LP
355 * sd-bus gained a set of new calls:
356 sd_bus_slot_set_floating()/sd_bus_slot_get_floating() may be used to
357 enable/disable the "floating" state of a bus slot object,
358 i.e. whether the slot object pins the bus it is allocated for into
359 memory or if the bus slot object gets disconnected when the bus goes
360 away. sd_bus_open_with_description(),
361 sd_bus_open_user_with_description(),
362 sd_bus_open_system_with_description() may be used to allocate bus
363 objects and set their description string already during allocation.
364
365 * sd-event gained support for watching inotify events from the event
366 loop, in an efficient way, sharing inotify handles between multiple
367 users. For this a new function sd_event_add_inotify() has been added.
368
369 * sd-event and sd-bus gained support for calling special user-supplied
370 destructor functions for userdata pointers associated with
c7f93e28
ZJS
371 sd_event_source, sd_bus_slot, and sd_bus_track objects. For this new
372 functions sd_bus_slot_set_destroy_callback,
373 sd_bus_slot_get_destroy_callback, sd_bus_track_set_destroy_callback,
374 sd_bus_track_get_destroy_callback,
375 sd_event_source_set_destroy_callback,
376 sd_event_source_get_destroy_callback have been added.
41a4c3ec
LP
377
378 * The "net.ipv4.tcp_ecn" sysctl will now be turned on by default.
379
380 * PID 1 will now automatically reschedule .timer units whenever the
5cadf58e 381 local timezone changes. (They previously got rescheduled
41a4c3ec
LP
382 automatically when the system clock changed.)
383
384 * New documentation has been added to document cgroups delegation,
385 portable services and the various code quality tools we have set up:
386
a8a27374
SK
387 https://github.com/systemd/systemd/blob/master/docs/CGROUP_DELEGATION.md
388 https://github.com/systemd/systemd/blob/master/docs/PORTABLE_SERVICES.md
389 https://github.com/systemd/systemd/blob/master/docs/CODE_QUALITY.md
41a4c3ec 390
d6906108
LP
391 * The Boot Loader Specification has been added to the source tree.
392
a8a27374 393 https://github.com/systemd/systemd/blob/master/docs/BOOT_LOADER_SPECIFICATION.md
d6906108
LP
394
395 While moving it into our source tree we have updated it and further
396 changes are now accepted through the usual github PR workflow.
397
41a4c3ec
LP
398 * pam_systemd will now look for PAM userdata fields systemd.memory_max,
399 systemd.tasks_max, systemd.cpu_weight, systemd.io_weight set by
400 earlier PAM modules. The data in these fields is used to initialize
401 the session scope's resource properties. Thus external PAM modules
402 may now configure per-session limits, for example sourced from
403 external user databases.
404
405 * socket units with Accept=yes will now maintain a "refused" counter in
406 addition to the existing "accepted" counter, counting connections
407 refused due to the enforced limits.
408
409 * The "systemd-path search-binaries-default" command may now be use to
410 query the default, built-in $PATH PID 1 will pass to the services it
411 manages.
412
c49a7cbd
LP
413 * A new unit file setting PrivateMounts= has been added. It's a boolean
414 option. If enabled the unit's processes are invoked in their own file
415 system namespace. Note that this behaviour is also implied if any
416 other file system namespacing options (such as PrivateTmp=,
417 PrivateDevices=, ProtectSystem=, …) are used. This option is hence
418 primarily useful for services that do not use any of the other file
419 system namespacing options. One such service is systemd-udevd.service
420 wher this is now used by default.
421
57ab451e
ZJS
422 * ConditionSecurity= gained a new value "uefi-secureboot" that is true
423 when the system is booted in UEFI "secure mode".
424
c7668c1c
LP
425 * A new unit "system-update-pre.target" is added, which defines an
426 optional synchronization point for offline system updates, as
427 implemented by the pre-existing "system-update.target" unit. It
428 allows ordering services before the service that executes the actual
429 update process in a generic way.
430
41a4c3ec 431 Contributions from: Adam Duskett, Alan Jenkins, Alessandro Casale,
ec53d48c 432 Alexander Kurtz, Alex Gartrell, Anssi Hannula, Arnaud Rebillout, Brian
bb6f071f
LP
433 J. Murrell, Bruno Vernay, Chris Lamb, Chris Lesiak, Christian Brauner,
434 Christian Hesse, Christian Rebischke, Colin Guthrie, Daniel Dao, Daniel
435 Lin, Danylo Korostil, Davide Cavalca, David Tardon, Dimitri John
436 Ledkov, Dmitriy Geels, Douglas Christman, Elia Geretto, emelenas, Emil
437 Velikov, Evgeny Vereshchagin, Felipe Sateler, Feng Sun, Filipe
438 Brandenburger, Franck Bui, futpib, Giuseppe Scrivano, Guillem Jover,
439 guixxx, Hannes Reinecke, Hans de Goede, Harald Hoyer, Henrique Dante de
440 Almeida, Hiram van Paassen, Ian Miell, Igor Gnatenko, Ivan Shapovalov,
441 Iwan Timmer, James Cowgill, Jan Janssen, Jan Synacek, Jared Kazimir,
442 Jérémy Rosen, João Paulo Rechi Vita, Joost Heitbrink, Jui-Chi Ricky
443 Liang, Jürg Billeter, Kai-Heng Feng, Karol Augustin, Kay Sievers,
444 Krzysztof Nowicki, Lauri Tirkkonen, Lennart Poettering, Leonard König,
445 Long Li, Luca Boccassi, Lucas Werkmeister, Marcel Hoppe, Marc
446 Kleine-Budde, Mario Limonciello, Martin Jansa, Martin Wilck, Mathieu
447 Malaterre, Matteo F. Vescovi, Matthew McGinn, Matthias-Christian Ott,
448 Michael Biebl, Michael Olbrich, Michael Prokop, Michal Koutný, Michal
449 Sekletar, Mike Gilbert, Mikhail Kasimov, Milan Broz, Milan Pässler,
450 Mladen Pejaković, Muhammet Kara, Nicolas Boichat, Omer Katz, Paride
451 Legovini, Paul Menzel, Paul Milliken, Pavel Hrdina, Peter A. Bigot,
452 Peter D'Hoye, Peter Hutterer, Peter Jones, Philip Sequeira, Philip
61d0025d 453 Withnall, Piotr Drąg, Radostin Stoyanov, Ricardo Salveti de Araujo,
bb6f071f
LP
454 Ronny Chevalier, Rosen Penev, Rubén Suárez Alvarez, Ryan Gonzalez,
455 Salvo Tomaselli, Sebastian Reichel, Sergey Ptashnick, Sergio Lindo
456 Mansilla, Stefan Schweter, Stephen Hemminger, Stuart Hayes, Susant
457 Sahani, Sylvain Plantefève, Thomas H. P. Andersen, Tobias Jungel,
458 Tomasz Torcz, Vito Caputo, Will Dietz, Will Thompson, Wim van Mourik,
459 Yu Watanabe, Zbigniew Jędrzejewski-Szmek
41a4c3ec 460
e8498f82 461 — Berlin, 2018-06-22
41a4c3ec 462
c657bff1 463CHANGES WITH 238:
e0c46a73
LP
464
465 * The MemoryAccounting= unit property now defaults to on. After
466 discussions with the upstream control group maintainers we learnt
467 that the negative impact of cgroup memory accounting on current
468 kernels is finally relatively minimal, so that it should be safe to
444d5863
ZJS
469 enable this by default without affecting system performance. Besides
470 memory accounting only task accounting is turned on by default, all
471 other forms of resource accounting (CPU, IO, IP) remain off for now,
472 because it's not clear yet that their impact is small enough to move
473 from opt-in to opt-out. We recommend downstreams to leave memory
07a35e84 474 accounting on by default if kernel 4.14 or higher is primarily
444d5863
ZJS
475 used. On very resource constrained systems or when support for old
476 kernels is a necessity, -Dmemory-accounting-default=false can be used
477 to revert this change.
e0c46a73 478
313c32c3
ZJS
479 * rpm scriptlets to update the udev hwdb and rules (%udev_hwdb_update,
480 %udev_rules_update) and the journal catalog (%journal_catalog_update)
481 from the upgrade scriptlets of individual packages now do nothing.
482 Transfiletriggers have been added which will perform those updates
483 once at the end of the transaction.
484
485 Similar transfiletriggers have been added to execute any sysctl.d
486 and binfmt.d rules. Thus, it should be unnecessary to provide any
487 scriptlets to execute this configuration from package installation
488 scripts.
489
490 * systemd-sysusers gained a mode where the configuration to execute is
491 specified on the command line, but this configuration is not executed
492 directly, but instead it is merged with the configuration on disk,
493 and the result is executed. This is useful for package installation
494 scripts which want to create the user before installing any files on
495 disk (in case some of those files are owned by that user), while
496 still allowing local admin overrides.
497
07a35e84 498 This functionality is exposed to rpm scriptlets through a new
313c32c3
ZJS
499 %sysusers_create_package macro. Old %sysusers_create and
500 %sysusers_create_inline macros are deprecated.
501
502 A transfiletrigger for sysusers.d configuration is now installed,
07a35e84 503 which means that it should be unnecessary to call systemd-sysusers from
313c32c3
ZJS
504 package installation scripts, unless the package installs any files
505 owned by those newly-created users, in which case
506 %sysusers_create_package should be used.
507
508 * Analogous change has been done for systemd-tmpfiles: it gained a mode
509 where the command-line configuration is merged with the configuration
510 on disk. This is exposed as the new %tmpfiles_create_package macro,
511 and %tmpfiles_create is deprecated. A transfiletrigger is installed
512 for tmpfiles.d, hence it should be unnecessary to call systemd-tmpfiles
513 from package installation scripts.
514
515 * sysusers.d configuration for a user may now also specify the group
516 number, in addition to the user number ("u username 123:456"), or
517 without the user number ("u username -:456").
518
519 * Configution items for systemd-sysusers can now be specified as
520 positional arguments when the new --inline switch is used.
521
522 * The login shell of users created through sysusers.d may now be
523 specified (previously, it was always /bin/sh for root and
524 /sbin/nologin for other users).
525
526 * systemd-analyze gained a new --global switch to look at global user
527 configuration. It also gained a unit-paths verb to list the unit load
528 paths that are compiled into systemd (which can be used with
529 --systemd, --user, or --global).
530
531 * udevadm trigger gained a new --settle/-w option to wait for any
532 triggered events to finish (but just those, and not any other events
533 which are triggered meanwhile).
534
535 * The action that systemd-logind takes when the lid is closed and the
536 machine is connected to external power can now be configured using
537 HandleLidSwitchExternalPower= in logind.conf. Previously, this action
538 was determined by HandleLidSwitch=, and, for backwards compatibility,
539 is still is, if HandleLidSwitchExternalPower= is not explicitly set.
540
541 * journalctl will periodically call sd_journal_process() to make it
542 resilient against inotify queue overruns when journal files are
543 rotated very quickly.
544
545 * Two new functions in libsystemd — sd_bus_get_n_queued_read and
546 sd_bus_get_n_queued_write — may be used to check the number of
547 pending bus messages.
548
549 * systemd gained a new
550 org.freedesktop.systemd1.Manager.AttachProcessesToUnit dbus call
551 which can be used to migrate foreign processes to scope and service
552 units. The primary user for this new API is systemd itself: the
553 systemd --user instance uses this call of the systemd --system
554 instance to migrate processes if it itself gets the request to
555 migrate processes and the kernel refuses this due to access
556 restrictions. Thanks to this "systemd-run --scope --user …" works
557 again in pure cgroups v2 environments when invoked from the user
558 session scope.
559
560 * A new TemporaryFileSystem= setting can be used to mask out part of
561 the real file system tree with tmpfs mounts. This may be combined
562 with BindPaths= and BindReadOnlyPaths= to hide files or directories
563 not relevant to the unit, while still allowing some paths lower in
564 the tree to be accessed.
565
566 ProtectHome=tmpfs may now be used to hide user home and runtime
567 directories from units, in a way that is mostly equivalent to
568 "TemporaryFileSystem=/home /run/user /root".
569
570 * Non-service units are now started with KeyringMode=shared by default.
571 This means that mount and swapon and other mount tools have access
572 to keys in the main keyring.
573
574 * /sys/fs/bpf is now mounted automatically.
575
576 * QNX virtualization is now detected by systemd-detect-virt and may
577 be used in ConditionVirtualization=.
578
579 * IPAccounting= may now be enabled also for slice units.
580
581 * A new -Dsplit-bin= build configuration switch may be used to specify
582 whether bin and sbin directories are merged, or if they should be
583 included separately in $PATH and various listings of executable
584 directories. The build configuration scripts will try to autodetect
585 the proper values of -Dsplit-usr= and -Dsplit-bin= based on build
586 system, but distributions are encouraged to configure this
587 explicitly.
588
589 * A new -Dok-color= build configuration switch may be used to change
590 the colour of "OK" status messages.
591
592 * UPGRADE ISSUE: serialization of units using JoinsNamespaceOf= with
593 PrivateNetwork=yes was buggy in previous versions of systemd. This
594 means that after the upgrade and daemon-reexec, any such units must
595 be restarted.
596
597 * INCOMPATIBILITY: as announced in the NEWS for 237, systemd-tmpfiles
598 will not exclude read-only files owned by root from cleanup.
599
c657bff1
ZJS
600 Contributions from: Alan Jenkins, Alexander F Rødseth, Alexis Jeandet,
601 Andika Triwidada, Andrei Gherzan, Ansgar Burchardt, antizealot1337,
602 Batuhan Osman Taşkaya, Beniamino Galvani, Bill Yodlowsky, Caio Marcelo
603 de Oliveira Filho, CuBiC, Daniele Medri, Daniel Mouritzen, Daniel
604 Rusek, Davide Cavalca, Dimitri John Ledkov, Douglas Christman, Evgeny
605 Vereshchagin, Faalagorn, Filipe Brandenburger, Franck Bui, futpib,
606 Giacomo Longo, Gunnar Hjalmarsson, Hans de Goede, Hermann Gausterer,
607 Iago López Galeiras, Jakub Filak, Jan Synacek, Jason A. Donenfeld,
608 Javier Martinez Canillas, Jérémy Rosen, Lennart Poettering, Lucas
609 Werkmeister, Mao Huang, Marco Gulino, Michael Biebl, Michael Vogt,
610 MilhouseVH, Neal Gompa (ニール・ゴンパ), Oleander Reis, Olof Mogren,
611 Patrick Uiterwijk, Peter Hutterer, Peter Portante, Piotr Drąg, Robert
612 Antoni Buj Gelonch, Sergey Ptashnick, Shawn Landden, Shuang Liu, Simon
613 Fowler, SjonHortensius, snorreflorre, Susant Sahani, Sylvain
614 Plantefève, Thomas Blume, Thomas Haller, Vito Caputo, Yu Watanabe,
615 Zbigniew Jędrzejewski-Szmek, Марко М. Костић (Marko M. Kostić)
616
617 — Warsaw, 2018-03-05
618
82c8e3e6 619CHANGES WITH 237:
2b0c59ba
MP
620
621 * Some keyboards come with a zoom see-saw or rocker which until now got
622 mapped to the Linux "zoomin/out" keys in hwdb. However, these
623 keycodes are not recognized by any major desktop. They now produce
624 Up/Down key events so that they can be used for scrolling.
625
49e87292
LP
626 * INCOMPATIBILITY: systemd-tmpfiles' "f" lines changed behaviour
627 slightly: previously, if an argument was specified for lines of this
628 type (i.e. the right-most column was set) this string was appended to
629 existing files each time systemd-tmpfiles was run. This behaviour was
630 different from what the documentation said, and not particularly
631 useful, as repeated systemd-tmpfiles invocations would not be
632 idempotent and grow such files without bounds. With this release
15c5594b
ZJS
633 behaviour has been altered to match what the documentation says:
634 lines of this type only have an effect if the indicated files don't
635 exist yet, and only then the argument string is written to the file.
49e87292 636
82c8e3e6
LP
637 * FUTURE INCOMPATIBILITY: In systemd v238 we intend to slightly change
638 systemd-tmpfiles behaviour: previously, read-only files owned by root
639 were always excluded from the file "aging" algorithm (i.e. the
640 automatic clean-up of directories like /tmp based on
641 atime/mtime/ctime). We intend to drop this restriction, and age files
642 by default even when owned by root and read-only. This behaviour was
643 inherited from older tools, but there have been requests to remove
644 it, and it's not obvious why this restriction was made in the first
645 place. Please speak up now, if you are aware of software that reqires
646 this behaviour, otherwise we'll remove the restriction in v238.
647
95894b91
LP
648 * A new environment variable $SYSTEMD_OFFLINE is now understood by
649 systemctl. It takes a boolean argument. If on, systemctl assumes it
650 operates on an "offline" OS tree, and will not attempt to talk to the
651 service manager. Previously, this mode was implicitly enabled if a
652 chroot() environment was detected, and this new environment variable
653 now provides explicit control.
654
1a0cd2c7
ZJS
655 * .path and .socket units may now be created transiently, too.
656 Previously only service, mount, automount and timer units were
95894b91
LP
657 supported as transient units. The systemd-run tool has been updated
658 to expose this new functionality, you may hence use it now to bind
659 arbitrary commands to path or socket activation on-the-fly from the
1a0cd2c7
ZJS
660 command line. Moreover, almost all properties are now exposed for the
661 unit types that already supported transient operation.
95894b91
LP
662
663 * The systemd-mount command gained support for a new --owner= parameter
664 which takes a user name, which is then resolved and included in uid=
665 and gid= mount options string of the file system to mount.
666
667 * A new unit condition ConditionControlGroupController= has been added
668 that checks whether a specific cgroup controller is available.
669
670 * Unit files, udev's .link files, and systemd-networkd's .netdev and
671 .network files all gained support for a new condition
672 ConditionKernelVersion= for checking against specific kernel
673 versions.
674
675 * In systemd-networkd, the [IPVLAN] section in .netdev files gained
6cddc792 676 support for configuring device flags in the Flags= setting. In the
95894b91
LP
677 same files, the [Tunnel] section gained support for configuring
678 AllowLocalRemote=. The [Route] section in .network files gained
679 support for configuring InitialCongestionWindow=,
680 InitialAdvertisedReceiveWindow= and QuickAck=. The [DHCP] section now
681 understands RapidCommit=.
682
683 * systemd-networkd's DHCPv6 support gained support for Prefix
684 Delegation.
685
686 * sd-bus gained support for a new "watch-bind" feature. When this
687 feature is enabled, an sd_bus connection may be set up to connect to
688 an AF_UNIX socket in the file system as soon as it is created. This
689 functionality is useful for writing early-boot services that
690 automatically connect to the system bus as soon as it is started,
691 without ugly time-based polling. systemd-networkd and
692 systemd-resolved have been updated to make use of this
693 functionality. busctl exposes this functionality in a new
694 --watch-bind= command line switch.
695
696 * sd-bus will now optionally synthesize a local "Connected" signal as
697 soon as a D-Bus connection is set up fully. This message mirrors the
698 already existing "Disconnected" signal which is synthesized when the
699 connection is terminated. This signal is generally useful but
700 particularly handy in combination with the "watch-bind" feature
701 described above. Synthesizing of this message has to be requested
702 explicitly through the new API call sd_bus_set_connected_signal(). In
703 addition a new call sd_bus_is_ready() has been added that checks
caf2a2d8 704 whether a connection is fully set up (i.e. between the "Connected" and
95894b91
LP
705 "Disconnected" signals).
706
707 * sd-bus gained two new calls sd_bus_request_name_async() and
708 sd_bus_release_name_async() for asynchronously registering bus
709 names. Similar, there is now sd_bus_add_match_async() for installing
710 a signal match asynchronously. All of systemd's own services have
711 been updated to make use of these calls. Doing these operations
712 asynchronously has two benefits: it reduces the risk of deadlocks in
713 case of cyclic dependencies between bus services, and it speeds up
714 service initialization since synchronization points for bus
715 round-trips are removed.
716
717 * sd-bus gained two new calls sd_bus_match_signal() and
718 sd_bus_match_signal_async(), which are similar to sd_bus_add_match()
719 and sd_bus_add_match_async() but instead of taking a D-Bus match
720 string take match fields as normal function parameters.
721
722 * sd-bus gained two new calls sd_bus_set_sender() and
723 sd_bus_message_set_sender() for setting the sender name of outgoing
724 messages (either for all outgoing messages or for just one specific
725 one). These calls are only useful in direct connections as on
726 brokered connections the broker fills in the sender anyway,
727 overwriting whatever the client filled in.
728
729 * sd-event gained a new pseudo-handle that may be specified on all API
730 calls where an "sd_event*" object is expected: SD_EVENT_DEFAULT. When
731 used this refers to the default event loop object of the calling
732 thread. Note however that this does not implicitly allocate one —
6cddc792
CR
733 which has to be done prior by using sd_event_default(). Similarly
734 sd-bus gained three new pseudo-handles SD_BUS_DEFAULT,
95894b91
LP
735 SD_BUS_DEFAULT_USER, SD_BUS_DEFAULT_SYSTEM that may be used to refer
736 to the default bus of the specified type of the calling thread. Here
737 too this does not implicitly allocate bus connection objects, this
738 has to be done prior with sd_bus_default() and friends.
739
740 * sd-event gained a new call pair
6cddc792
CR
741 sd_event_source_{get|set}_io_fd_own(). This may be used to request
742 automatic closure of the file descriptor an IO event source watches
95894b91
LP
743 when the event source is destroyed.
744
745 * systemd-networkd gained support for natively configuring WireGuard
746 connections.
747
6cddc792
CR
748 * In previous versions systemd synthesized user records both for the
749 "nobody" (UID 65534) and "root" (UID 0) users in nss-systemd and
750 internally. In order to simplify distribution-wide renames of the
95894b91
LP
751 "nobody" user (like it is planned in Fedora: nfsnobody → nobody), a
752 new transitional flag file has been added: if
753 /etc/systemd/dont-synthesize-nobody exists synthesizing of the 65534
754 user and group record within the systemd codebase is disabled.
755
756 * systemd-notify gained a new --uid= option for selecting the source
757 user/UID to use for notification messages sent to the service
758 manager.
759
31751f7e 760 * journalctl gained a new --grep= option to list only entries in which
e6501af8
ZJS
761 the message matches a certain pattern. By default matching is case
762 insensitive if the pattern is lowercase, and case sensitive
763 otherwise. Option --case-sensitive=yes|no can be used to override
764 this an specify case sensitivity or case insensitivity.
765
56a29112 766 * There's now a "systemd-analyze service-watchdogs" command for printing
508058c9 767 the current state of the service runtime watchdog, and optionally
56a29112 768 enabling or disabling the per-service watchdogs system-wide if given a
508058c9
LP
769 boolean argument (i.e. the concept you configure in WatchdogSec=), for
770 debugging purposes. There's also a kernel command line option
56a29112 771 systemd.service_watchdogs= for controlling the same.
508058c9
LP
772
773 * Two new "log-level" and "log-target" options for systemd-analyze were
bc99dac5 774 added that merge the now deprecated get-log-level, set-log-level and
508058c9
LP
775 get-log-target, set-log-target pairs. The deprecated options are still
776 understood for backwards compatibility. The two new options print the
777 current value when no arguments are given, and set them when a
56a29112 778 level/target is given as an argument.
95894b91 779
508058c9
LP
780 * sysusers.d's "u" lines now optionally accept both a UID and a GID
781 specification, separated by a ":" character, in order to create users
782 where UID and GID do not match.
783
95894b91 784 Contributions from: Adam Duskett, Alan Jenkins, Alexander Kuleshov,
508058c9
LP
785 Alexis Deruelle, Andrew Jeddeloh, Armin Widegreen, Batuhan Osman
786 Taşkaya, Björn Esser, bleep_blop, Bruce A. Johnson, Chris Down, Clinton
787 Roy, Colin Walters, Daniel Rusek, Dimitri John Ledkov, Dmitry Rozhkov,
788 Evgeny Vereshchagin, Ewout van Mansom, Felipe Sateler, Franck Bui,
789 Frantisek Sumsal, George Gaydarov, Gianluca Boiano, Hans-Christian
790 Noren Egtvedt, Hans de Goede, Henrik Grindal Bakken, Jan Alexander
791 Steffens, Jan Klötzke, Jason A. Donenfeld, jdkbx, Jérémy Rosen,
792 Jerónimo Borque, John Lin, John Paul Herold, Jonathan Rudenberg, Jörg
793 Thalheim, Ken (Bitsko) MacLeod, Larry Bernstone, Lennart Poettering,
794 Lucas Werkmeister, Maciej S. Szmigiero, Marek Čermák, Martin Pitt,
795 Mathieu Malaterre, Matthew Thode, Matthias-Christian Ott, Max Harmathy,
796 Michael Biebl, Michael Vogt, Michal Koutný, Michal Sekletar, Michał
797 Szczepański, Mike Gilbert, Nathaniel McCallum, Nicolas Chauvet, Olaf
798 Hering, Olivier Schwander, Patrik Flykt, Paul Cercueil, Peter Hutterer,
799 Piotr Drąg, Raphael Vogelgsang, Reverend Homer, Robert Kolchmeyer,
800 Samuel Dionne-Riel, Sergey Ptashnick, Shawn Landden, Susant Sahani,
801 Sylvain Plantefève, Thomas H. P. Andersen, Thomas Huth, Tomasz
802 Bachorski, Vladislav Vishnyakov, Wieland Hoffmann, Yu Watanabe, Zachary
803 Winnerman, Zbigniew Jędrzejewski-Szmek, Дамјан Георгиевски, Дилян
804 Палаузов
805
806 — Brno, 2018-01-28
2b0c59ba 807
a1b2c92d 808CHANGES WITH 236:
195b943d 809
89780840
ZJS
810 * The modprobe.d/ drop-in for the bonding.ko kernel module introduced
811 in v235 has been extended to also set the dummy.ko module option
812 numdummies=0, preventing the kernel from automatically creating
813 dummy0. All dummy interfaces must now be explicitly created.
195b943d 814
3925496a
LP
815 * Unknown '%' specifiers in configuration files are now rejected. This
816 applies to units and tmpfiles.d configuration. Any percent characters
817 that are followed by a letter or digit that are not supposed to be
818 interpreted as the beginning of a specifier should be escaped by
819 doubling ("%%"). (So "size=5%" is still accepted, as well as
820 "size=5%,foo=bar", but not "LABEL=x%y%z" since %y and %z are not
821 valid specifiers today.)
751223fe 822
e6b2d948 823 * systemd-resolved now maintains a new dynamic
89780840
ZJS
824 /run/systemd/resolve/stub-resolv.conf compatibility file. It is
825 recommended to make /etc/resolv.conf a symlink to it. This file
826 points at the systemd-resolved stub DNS 127.0.0.53 resolver and
827 includes dynamically acquired search domains, achieving more correct
828 DNS resolution by software that bypasses local DNS APIs such as NSS.
e6b2d948 829
67eb5b38
LP
830 * The "uaccess" udev tag has been dropped from /dev/kvm and
831 /dev/dri/renderD*. These devices now have the 0666 permissions by
832 default (but this may be changed at build-time). /dev/dri/renderD*
833 will now be owned by the "render" group along with /dev/kfd.
834
89780840
ZJS
835 * "DynamicUser=yes" has been enabled for systemd-timesyncd.service,
836 systemd-journal-gatewayd.service and
837 systemd-journal-upload.service. This means "nss-systemd" must be
838 enabled in /etc/nsswitch.conf to ensure the UIDs assigned to these
839 services are resolved properly.
67eb5b38 840
3925496a
LP
841 * In /etc/fstab two new mount options are now understood:
842 x-systemd.makefs and x-systemd.growfs. The former has the effect that
843 the configured file system is formatted before it is mounted, the
844 latter that the file system is resized to the full block device size
845 after it is mounted (i.e. if the file system is smaller than the
846 partition it resides on, it's grown). This is similar to the fsck
847 logic in /etc/fstab, and pulls in systemd-makefs@.service and
848 systemd-growfs@.service as necessary, similar to
849 systemd-fsck@.service. Resizing is currently only supported on ext4
850 and btrfs.
851
67eb5b38
LP
852 * In systemd-networkd, the IPv6 RA logic now optionally may announce
853 DNS server and domain information.
854
855 * Support for the LUKS2 on-disk format for encrypted partitions has
856 been added. This requires libcryptsetup2 during compilation and
857 runtime.
858
89780840 859 * The systemd --user instance will now signal "readiness" when its
67eb5b38
LP
860 basic.target unit has been reached, instead of when the run queue ran
861 empty for the first time.
862
8ea2dcb0
ZJS
863 * Tmpfiles.d with user configuration are now also supported.
864 systemd-tmpfiles gained a new --user switch, and snippets placed in
865 ~/.config/user-tmpfiles.d/ and corresponding directories will be
866 executed by systemd-tmpfiles --user running in the new
867 systemd-tmpfiles-setup.service and systemd-tmpfiles-clean.service
868 running in the user session.
869
870 * Unit files and tmpfiles.d snippets learnt three new % specifiers:
871 %S resolves to the top-level state directory (/var/lib for the system
872 instance, $XDG_CONFIG_HOME for the user instance), %C resolves to the
873 top-level cache directory (/var/cache for the system instance,
874 $XDG_CACHE_HOME for the user instance), %L resolves to the top-level
875 logs directory (/var/log for the system instance,
67eb5b38 876 $XDG_CONFIG_HOME/log/ for the user instance). This matches the
8ea2dcb0 877 existing %t specifier, that resolves to the top-level runtime
67eb5b38
LP
878 directory (/run for the system instance, and $XDG_RUNTIME_DIR for the
879 user instance).
880
881 * journalctl learnt a new parameter --output-fields= for limiting the
882 set of journal fields to output in verbose and JSON output modes.
883
884 * systemd-timesyncd's configuration file gained a new option
89780840
ZJS
885 RootDistanceMaxSec= for setting the maximum root distance of servers
886 it'll use, as well as the new options PollIntervalMinSec= and
887 PollIntervalMaxSec= to tweak the minimum and maximum poll interval.
67eb5b38
LP
888
889 * bootctl gained a new command "list" for listing all available boot
89780840 890 menu items on systems that follow the boot loader specification.
67eb5b38
LP
891
892 * systemctl gained a new --dry-run switch that shows what would be done
893 instead of doing it, and is currently supported by the shutdown and
894 sleep verbs.
895
e9ad86d5 896 * ConditionSecurity= can now detect the TOMOYO security module.
67eb5b38
LP
897
898 * Unit file [Install] sections are now also respected in unit drop-in
89780840 899 files. This is intended to be used by drop-ins under /usr/lib/.
67eb5b38 900
89780840 901 * systemd-firstboot may now also set the initial keyboard mapping.
67eb5b38 902
89780840
ZJS
903 * Udev "changed" events for devices which are exposed as systemd
904 .device units are now propagated to units specified in
905 ReloadPropagatedFrom= as reload requests.
67eb5b38 906
89780840
ZJS
907 * If a udev device has a SYSTEMD_WANTS= property containing a systemd
908 unit template name (i.e. a name in the form of 'foobar@.service',
909 without the instance component between the '@' and - the '.'), then
910 the escaped sysfs path of the device is automatically used as the
911 instance.
67eb5b38
LP
912
913 * SystemCallFilter= in unit files has been extended so that an "errno"
914 can be specified individually for each system call. Example:
915 SystemCallFilter=~uname:EILSEQ.
916
917 * The cgroup delegation logic has been substantially updated. Delegate=
918 now optionally takes a list of controllers (instead of a boolean, as
919 before), which lists the controllers to delegate at least.
920
89780840 921 * The networkd DHCPv6 client now implements the FQDN option (RFC 4704).
67eb5b38 922
89780840
ZJS
923 * A new LogLevelMax= setting configures the maximum log level any
924 process of the service may log at (i.e. anything with a lesser
925 priority than what is specified is automatically dropped). A new
926 LogExtraFields= setting allows configuration of additional journal
927 fields to attach to all log records generated by any of the unit's
928 processes.
67eb5b38 929
89780840
ZJS
930 * New StandardInputData= and StandardInputText= settings along with the
931 new option StandardInput=data may be used to configure textual or
932 binary data that shall be passed to the executed service process via
933 standard input, encoded in-line in the unit file.
67eb5b38
LP
934
935 * StandardInput=, StandardOutput= and StandardError= may now be used to
936 connect stdin/stdout/stderr of executed processes directly with a
937 file or AF_UNIX socket in the file system, using the new "file:" option.
938
89780840
ZJS
939 * A new unit file option CollectMode= has been added, that allows
940 tweaking the garbage collection logic for units. It may be used to
941 tell systemd to garbage collect units that have failed automatically
942 (normally it only GCs units that exited successfully). systemd-run
943 and systemd-mount expose this new functionality with a new -G option.
944
67eb5b38
LP
945 * "machinectl bind" may now be used to bind mount non-directories
946 (i.e. regularfiles, devices, fifos, sockets).
947
948 * systemd-analyze gained a new verb "calendar" for validating and
949 testing calendar time specifications to use for OnCalendar= in timer
950 units. Besides validating the expression it will calculate the next
951 time the specified expression would elapse.
952
953 * In addition to the pre-existing FailureAction= unit file setting
89780840
ZJS
954 there's now SuccessAction=, for configuring a shutdown action to
955 execute when a unit completes successfully. This is useful in
956 particular inside containers that shall terminate after some workload
957 has been completed. Also, both options are now supported for all unit
958 types, not just services.
67eb5b38
LP
959
960 * networkds's IP rule support gained two new options
dd014eeb 961 IncomingInterface= and OutgoingInterface= for configuring the incoming
67eb5b38
LP
962 and outgoing interfaces of configured rules. systemd-networkd also
963 gained support for "vxcan" network devices.
964
965 * networkd gained a new setting RequiredForOnline=, taking a
966 boolean. If set, systemd-wait-online will take it into consideration
967 when determining that the system is up, otherwise it will ignore the
968 interface for this purpose.
969
970 * The sd_notify() protocol gained support for a new operation: with
971 FDSTOREREMOVE=1 file descriptors may be removed from the per-service
972 store again, ahead of POLLHUP or POLLERR when they are removed
973 anyway.
974
f09eb768
LP
975 * A new document doc/UIDS-GIDS.md has been added to the source tree,
976 that documents the UID/GID range and assignment assumptions and
3925496a
LP
977 requirements of systemd.
978
979 * The watchdog device PID 1 will ping may now be configured through the
980 WatchdogDevice= configuration file setting, or by setting the
981 systemd.watchdog_service= kernel commandline option.
982
983 * systemd-resolved's gained support for registering DNS-SD services on
984 the local network using MulticastDNS. Services may either be
985 registered by dropping in a .dnssd file in /etc/systemd/dnssd/ (or
986 the same dir below /run, /usr/lib), or through its D-Bus API.
987
a327431b
DB
988 * The sd_notify() protocol can now with EXTEND_TIMEOUT_USEC=microsecond
989 extend the effective start, runtime, and stop time. The service must
990 continue to send EXTEND_TIMEOUT_USEC within the period specified to
991 prevent the service manager from making the service as timedout.
992
ea2a3c9e
LP
993 * systemd-resolved's DNSSEC support gained support for RFC 8080
994 (Ed25519 keys and signatures).
995
a1b2c92d
LP
996 * The systemd-resolve command line tool gained a new set of options
997 --set-dns=, --set-domain=, --set-llmnr=, --set-mdns=, --set-dnssec=,
998 --set-nta= and --revert to configure per-interface DNS configuration
999 dynamically during runtime. It's useful for pushing DNS information
1000 into systemd-resolved from DNS hook scripts that various interface
1001 managing software supports (such as pppd).
1002
1003 * systemd-nspawn gained a new --network-namespace-path= command line
1004 option, which may be used to make a container join an existing
1005 network namespace, by specifying a path to a "netns" file.
1006
3925496a
LP
1007 Contributions from: Alan Jenkins, Alan Robertson, Alessandro Ghedini,
1008 Andrew Jeddeloh, Antonio Rojas, Ari, asavah, bleep_blop, Carsten
1009 Strotmann, Christian Brauner, Christian Hesse, Clinton Roy, Collin
ea2a3c9e 1010 Eggert, Cong Wang, Daniel Black, Daniel Lockyer, Daniel Rusek, Dimitri
a1b2c92d
LP
1011 John Ledkov, Dmitry Rozhkov, Dongsu Park, Edward A. James, Evgeny
1012 Vereshchagin, Florian Klink, Franck Bui, Gwendal Grignou, Hans de
1013 Goede, Harald Hoyer, Hristo Venev, Iago López Galeiras, Ikey Doherty,
1014 Jakub Wilk, Jérémy Rosen, Jiahui Xie, John Lin, José Bollo, Josef
1015 Andersson, juga0, Krzysztof Nowicki, Kyle Walker, Lars Karlitski, Lars
1016 Kellogg-Stedman, Lauri Tirkkonen, Lennart Poettering, Lubomir Rintel,
1017 Luca Bruno, Lucas Werkmeister, Lukáš Nykrýn, Lukáš Říha, Lukasz
1018 Rubaszewski, Maciej S. Szmigiero, Mantas Mikulėnas, Marcus Folkesson,
1019 Martin Steuer, Mathieu Trudel-Lapierre, Matija Skala,
1020 Matthias-Christian Ott, Max Resch, Michael Biebl, Michael Vogt, Michal
1021 Koutný, Michal Sekletar, Mike Gilbert, Muhammet Kara, Neil Brown, Olaf
1022 Hering, Ondrej Kozina, Patrik Flykt, Patryk Kocielnik, Peter Hutterer,
1023 Piotr Drąg, Razvan Cojocaru, Robin McCorkell, Roland Hieber, Saran
1024 Tunyasuvunakool, Sergey Ptashnick, Shawn Landden, Shuang Liu, Simon
1025 Arlott, Simon Peeters, Stanislav Angelovič, Stefan Agner, Susant
1026 Sahani, Sylvain Plantefève, Thomas Blume, Thomas Haller, Tiago Salem
1027 Herrmann, Tinu Weber, Tom Stellard, Topi Miettinen, Torsten Hilbrich,
1028 Vito Caputo, Vladislav Vishnyakov, WaLyong Cho, Yu Watanabe, Zbigniew
1029 Jędrzejewski-Szmek, Zeal Jagannatha
67eb5b38 1030
ea2a3c9e 1031 — Berlin, 2017-12-14
3754abc5 1032
582faeb4
DJL
1033CHANGES WITH 235:
1034
2bcbffd6
LP
1035 * INCOMPATIBILITY: systemd-logind.service and other long-running
1036 services now run inside an IPv4/IPv6 sandbox, prohibiting them any IP
1037 communication with the outside. This generally improves security of
1038 the system, and is in almost all cases a safe and good choice, as
23d37367 1039 these services do not and should not provide any network-facing
2bcbffd6
LP
1040 functionality. However, systemd-logind uses the glibc NSS API to
1041 query the user database. This creates problems on systems where NSS
1042 is set up to directly consult network services for user database
1043 lookups. In particular, this creates incompatibilities with the
1044 "nss-nis" module, which attempts to directly contact the NIS/YP
1045 network servers it is configured for, and will now consistently
1046 fail. In such cases, it is possible to turn off IP sandboxing for
1047 systemd-logind.service (set IPAddressDeny= in its [Service] section
1048 to the empty string, via a .d/ unit file drop-in). Downstream
1049 distributions might want to update their nss-nis packaging to include
1050 such a drop-in snippet, accordingly, to hide this incompatibility
1051 from the user. Another option is to make use of glibc's nscd service
1052 to proxy such network requests through a privilege-separated, minimal
1053 local caching daemon, or to switch to more modern technologies such
1054 sssd, whose NSS hook-ups generally do not involve direct network
1055 access. In general, we think it's definitely time to question the
1056 implementation choices of nss-nis, i.e. whether it's a good idea
1057 today to embed a network-facing loadable module into all local
1058 processes that need to query the user database, including the most
1059 trivial and benign ones, such as "ls". For more details about
1060 IPAddressDeny= see below.
1061
fccf5419
LP
1062 * A new modprobe.d drop-in is now shipped by default that sets the
1063 bonding module option max_bonds=0. This overrides the kernel default,
1064 to avoid conflicts and ambiguity as to whether or not bond0 should be
1065 managed by systemd-networkd or not. This resolves multiple issues
1066 with bond0 properties not being applied, when bond0 is configured
1067 with systemd-networkd. Distributors may choose to not package this,
1068 however in that case users will be prevented from correctly managing
1069 bond0 interface using systemd-networkd.
582faeb4 1070
ef5a8cb1 1071 * systemd-analyze gained new verbs "get-log-level" and "get-log-target"
21723f53
ZJS
1072 which print the logging level and target of the system manager. They
1073 complement the existing "set-log-level" and "set-log-target" verbs
1074 used to change those values.
ef5a8cb1 1075
fccf5419
LP
1076 * journald.conf gained a new boolean setting ReadKMsg= which defaults
1077 to on. If turned off kernel log messages will not be read by
21723f53
ZJS
1078 systemd-journald or included in the logs. It also gained a new
1079 setting LineMax= for configuring the maximum line length in
1080 STDOUT/STDERR log streams. The new default for this value is 48K, up
1081 from the previous hardcoded 2048.
fccf5419 1082
21723f53
ZJS
1083 * A new unit setting RuntimeDirectoryPreserve= has been added, which
1084 allows more detailed control of what to do with a runtime directory
1085 configured with RuntimeDirectory= (i.e. a directory below /run or
1086 $XDG_RUNTIME_DIR) after a unit is stopped.
fccf5419
LP
1087
1088 * The RuntimeDirectory= setting for units gained support for creating
1089 deeper subdirectories below /run or $XDG_RUNTIME_DIR, instead of just
1090 one top-level directory.
1091
1092 * Units gained new options StateDirectory=, CacheDirectory=,
1093 LogsDirectory= and ConfigurationDirectory= which are closely related
1094 to RuntimeDirectory= but manage per-service directories below
21723f53 1095 /var/lib, /var/cache, /var/log and /etc. By making use of them it is
fccf5419
LP
1096 possible to write unit files which when activated automatically gain
1097 properly owned service specific directories in these locations, thus
1098 making unit files self-contained and increasing compatibility with
1099 stateless systems and factory reset where /etc or /var are
1100 unpopulated at boot. Matching these new settings there's also
1101 StateDirectoryMode=, CacheDirectoryMode=, LogsDirectoryMode=,
1102 ConfigurationDirectoryMode= for configuring the access mode of these
75dfbbac
LP
1103 directories. These settings are particularly useful in combination
1104 with DynamicUser=yes as they provide secure, properly-owned,
1105 writable, and stateful locations for storage, excluded from the
1106 sandbox that such services live in otherwise.
fccf5419
LP
1107
1108 * Automake support has been removed from this release. systemd is now
1109 Meson-only.
1110
1111 * systemd-journald will now aggressively cache client metadata during
1112 runtime, speeding up log write performance under pressure. This comes
1113 at a small price though: as much of the metadata is read
1114 asynchronously from /proc/ (and isn't implicitly attached to log
1115 datagrams by the kernel, like UID/GID/PID/SELinux are) this means the
1116 metadata stored alongside a log entry might be slightly
1117 out-of-date. Previously it could only be slightly newer than the log
1118 message. The time window is small however, and given that the kernel
1119 is unlikely to be improved anytime soon in this regard, this appears
1120 acceptable to us.
1121
1122 * nss-myhostname/systemd-resolved will now by default synthesize an
1123 A/AAAA resource record for the "_gateway" hostname, pointing to the
1124 current default IP gateway. Previously it did that for the "gateway"
1125 name, hampering adoption, as some distributions wanted to leave that
1126 host name open for local use. The old behaviour may still be
1127 requested at build time.
1128
1129 * systemd-networkd's [Address] section in .network files gained a new
1130 Scope= setting for configuring the IP address scope. The [Network]
1131 section gained a new boolean setting ConfigureWithoutCarrier= that
1132 tells systemd-networkd to ignore link sensing when configuring the
1133 device. The [DHCP] section gained a new Anonymize= boolean option for
1134 turning on a number of options suggested in RFC 7844. A new
1135 [RoutingPolicyRule] section has been added for configuring the IP
1136 routing policy. The [Route] section has gained support for a new
1137 Type= setting which permits configuring
1138 blackhole/unreachable/prohibit routes.
1139
1140 * The [VRF] section in .netdev files gained a new Table= setting for
1141 configuring the routing table to use. The [Tunnel] section gained a
1142 new Independent= boolean field for configuring tunnels independent of
1143 an underlying network interface. The [Bridge] section gained a new
1144 GroupForwardMask= option for configuration of propagation of link
1145 local frames between bridge ports.
1146
1147 * The WakeOnLan= setting in .link files gained support for a number of
1148 new modes. A new TCP6SegmentationOffload= setting has been added for
1149 configuring TCP/IPv6 hardware segmentation offload.
1150
1151 * The IPv6 RA sender implementation may now optionally send out RDNSS
21723f53 1152 and RDNSSL records to supply DNS configuration to peers.
fccf5419
LP
1153
1154 * systemd-nspawn gained support for a new --system-call-filter= command
21723f53
ZJS
1155 line option for adding and removing entries in the default system
1156 call filter it applies. Moreover systemd-nspawn has been changed to
fccf5419
LP
1157 implement a system call whitelist instead of a blacklist.
1158
1159 * systemd-run gained support for a new --pipe command line option. If
1160 used the STDIN/STDOUT/STDERR file descriptors passed to systemd-run
1161 are directly passed on to the activated transient service
21723f53
ZJS
1162 executable. This allows invoking arbitrary processes as systemd
1163 services (for example to take benefit of dependency management,
1164 accounting management, resource management or log management that is
1165 done automatically for services) — while still allowing them to be
fccf5419
LP
1166 integrated in a classic UNIX shell pipeline.
1167
1168 * When a service sends RELOAD=1 via sd_notify() and reload propagation
1169 using ReloadPropagationTo= is configured, a reload is now propagated
1170 to configured units. (Previously this was only done on explicitly
1171 requested reloads, using "systemctl reload" or an equivalent
1172 command.)
1173
1174 * For each service unit a restart counter is now kept: it is increased
1175 each time the service is restarted due to Restart=, and may be
1176 queried using "systemctl show -p NRestarts …".
1177
44898c53
LP
1178 * New system call filter groups @aio, @sync, @chown, @setuid, @memlock,
1179 @signal and @timer have been added, for usage with SystemCallFilter=
fccf5419
LP
1180 in unit files and the new --system-call-filter= command line option
1181 of systemd-nspawn (see above).
1182
1183 * ExecStart= lines in unit files gained two new modifiers: when a
1184 command line is prefixed with "!" the command will be executed as
1185 configured, except for the credentials applied by
1186 setuid()/setgid()/setgroups(). It is very similar to the pre-existing
1187 "+", but does still apply namespacing options unlike "+". There's
1188 also "!!" now, which is mostly identical, but becomes a NOP on
1189 systems that support ambient capabilities. This is useful to write
1190 unit files that work with ambient capabilities where possible but
1191 automatically fall back to traditional privilege dropping mechanisms
1192 on systems where this is not supported.
1193
1194 * ListenNetlink= settings in socket units now support RDMA netlink
1195 sockets.
1196
1197 * A new unit file setting LockPersonality= has been added which permits
1198 locking down the chosen execution domain ("personality") of a service
1199 during runtime.
1200
1201 * A new special target "getty-pre.target" has been added, which is
1202 ordered before all text logins, and may be used to order services
21723f53 1203 before textual logins acquire access to the console.
fccf5419
LP
1204
1205 * systemd will now attempt to load the virtio-rng.ko kernel module very
1206 early on if a VM environment supporting this is detected. This should
1207 improve entropy during early boot in virtualized environments.
1208
1209 * A _netdev option is now supported in /etc/crypttab that operates in a
1210 similar way as the same option in /etc/fstab: it permits configuring
21723f53
ZJS
1211 encrypted devices that need to be ordered after the network is up.
1212 Following this logic, two new special targets
fccf5419 1213 remote-cryptsetup-pre.target and remote-cryptsetup.target have been
21723f53
ZJS
1214 added that are to cryptsetup.target what remote-fs.target and
1215 remote-fs-pre.target are to local-fs.target.
fccf5419
LP
1216
1217 * Service units gained a new UnsetEnvironment= setting which permits
21723f53
ZJS
1218 unsetting specific environment variables for services that are
1219 normally passed to it (for example in order to mask out locale
fccf5419
LP
1220 settings for specific services that can't deal with it).
1221
1222 * Units acquired a new boolean option IPAccounting=. When turned on, IP
1223 traffic accounting (packet count as well as byte count) is done for
1224 the service, and shown as part of "systemctl status" or "systemd-run
1225 --wait".
1226
1227 * Service units acquired two new options IPAddressAllow= and
1228 IPAddressDeny=, taking a list of IPv4 or IPv6 addresses and masks,
1229 for configuring a simple IP access control list for all sockets of
1230 the unit. These options are available also on .slice and .socket
1231 units, permitting flexible access list configuration for individual
1232 services as well as groups of services (as defined by a slice unit),
1233 including system-wide. Note that IP ACLs configured this way are
1234 enforced on every single IPv4 and IPv6 socket created by any process
1235 of the service unit, and apply to ingress as well as egress traffic.
1236
21723f53 1237 * If CPUAccounting= or IPAccounting= is turned on for a unit a new
608f70e6 1238 structured log message is generated each time the unit is stopped,
fccf5419
LP
1239 containing information about the consumed resources of this
1240 invocation.
1241
1242 * A new setting KeyringMode= has been added to unit files, which may be
1243 used to control how the kernel keyring is set up for executed
1244 processes.
1245
e06fafb2
LP
1246 * "systemctl poweroff", "systemctl reboot", "systemctl halt",
1247 "systemctl kexec" and "systemctl exit" are now always asynchronous in
1248 behaviour (that is: these commands return immediately after the
21723f53
ZJS
1249 operation was enqueued instead of waiting for the operation to
1250 complete). Previously, "systemctl poweroff" and "systemctl reboot"
e06fafb2
LP
1251 were asynchronous on systems using systemd-logind (i.e. almost
1252 always, and like they were on sysvinit), and the other three commands
1253 were unconditionally synchronous. With this release this is cleaned
1254 up, and callers will see the same asynchronous behaviour on all
1255 systems for all five operations.
1256
1257 * systemd-logind gained new Halt() and CanHalt() bus calls for halting
1258 the system.
1259
fccf5419
LP
1260 * .timer units now accept calendar specifications in other timezones
1261 than UTC or the local timezone.
1262
f6e64b78 1263 * The tmpfiles snippet var.conf has been changed to create
21723f53
ZJS
1264 /var/log/btmp with access mode 0660 instead of 0600. It was owned by
1265 the "utmp" group already, and it appears to be generally understood
1266 that members of "utmp" can modify/flush the utmp/wtmp/lastlog/btmp
1267 databases. Previously this was implemented correctly for all these
1268 databases excepts btmp, which has been opened up like this now
1269 too. Note that while the other databases are world-readable
1270 (i.e. 0644), btmp is not and remains more restrictive.
f6e64b78 1271
d55b0463
LP
1272 * The systemd-resolve tool gained a new --reset-server-features
1273 switch. When invoked like this systemd-resolved will forget
1274 everything it learnt about the features supported by the configured
1275 upstream DNS servers, and restarts the feature probing logic on the
cf84484a
LP
1276 next resolver look-up for them at the highest feature level
1277 again.
1278
1279 * The status dump systemd-resolved sends to the logs upon receiving
1280 SIGUSR1 now also includes information about all DNS servers it is
1281 configured to use, and the features levels it probed for them.
d55b0463 1282
fccf5419
LP
1283 Contributions from: Abdó Roig-Maranges, Alan Jenkins, Alexander
1284 Kuleshov, Andreas Rammhold, Andrew Jeddeloh, Andrew Soutar, Ansgar
76451c1d
LP
1285 Burchardt, Beniamino Galvani, Benjamin Berg, Benjamin Robin, Charles
1286 Huber, Christian Hesse, Daniel Berrange, Daniel Kahn Gillmor, Daniel
1287 Mack, Daniel Rusek, Daniel Șerbănescu, Davide Cavalca, Dimitri John
1288 Ledkov, Diogo Pereira, Djalal Harouni, Dmitriy Geels, Dmitry Torokhov,
1289 ettavolt, Evgeny Vereshchagin, Fabio Kung, Felipe Sateler, Franck Bui,
1290 Hans de Goede, Harald Hoyer, Insun Pyo, Ivan Kurnosov, Ivan Shapovalov,
1291 Jakub Wilk, Jan Synacek, Jason Gunthorpe, Jeremy Bicha, Jérémy Rosen,
1292 John Lin, jonasBoss, Jonathan Lebon, Jonathan Teh, Jon Ringle, Jörg
1293 Thalheim, Jouke Witteveen, juga0, Justin Capella, Justin Michaud,
1294 Kai-Heng Feng, Lennart Poettering, Lion Yang, Luca Bruno, Lucas
1295 Werkmeister, Lukáš Nykrýn, Marcel Hollerbach, Marcus Lundblad, Martin
1296 Pitt, Michael Biebl, Michael Grzeschik, Michal Sekletar, Mike Gilbert,
1297 Neil Brown, Nicolas Iooss, Patrik Flykt, pEJipE, Piotr Drąg, Russell
1298 Stuart, S. Fan, Shengyao Xue, Stefan Pietsch, Susant Sahani, Tejun Heo,
1299 Thomas Miller, Thomas Sailer, Tobias Hunger, Tomasz Pala, Tom
1300 Gundersen, Tommi Rantala, Topi Miettinen, Torstein Husebø, userwithuid,
1301 Vasilis Liaskovitis, Vito Caputo, WaLyong Cho, William Douglas, Xiang
1302 Fan, Yu Watanabe, Zbigniew Jędrzejewski-Szmek
fccf5419 1303
c1719d8b 1304 — Berlin, 2017-10-06
fccf5419 1305
4b4da299
LP
1306CHANGES WITH 234:
1307
1308 * Meson is now supported as build system in addition to Automake. It is
1309 our plan to remove Automake in one of our next releases, so that
1310 Meson becomes our exclusive build system. Hence, please start using
1311 the Meson build system in your downstream packaging. There's plenty
1312 of documentation around how to use Meson, the extremely brief
1313 summary:
1314
1315 ./autogen.sh && ./configure && make && sudo make install
1316
1317 becomes:
1318
1319 meson build && ninja -C build && sudo ninja -C build install
1320
1321 * Unit files gained support for a new JobRunningTimeoutUSec= setting,
1322 which permits configuring a timeout on the time a job is
1323 running. This is particularly useful for setting timeouts on jobs for
1324 .device units.
1325
1326 * Unit files gained two new options ConditionUser= and ConditionGroup=
1327 for conditionalizing units based on the identity of the user/group
1328 running a systemd user instance.
1329
1330 * systemd-networkd now understands a new FlowLabel= setting in the
1331 [VXLAN] section of .network files, as well as a Priority= in
1332 [Bridge], GVRP= + MVRP= + LooseBinding= + ReorderHeader= in [VLAN]
1333 and GatewayOnlink= + IPv6Preference= + Protocol= in [Route]. It also
1334 gained support for configuration of GENEVE links, and IPv6 address
1335 labels. The [Network] section gained the new IPv6ProxyNDP= setting.
1336
9f09a95a 1337 * .link files now understand a new Port= setting.
4b4da299
LP
1338
1339 * systemd-networkd's DHCP support gained support for DHCP option 119
1340 (domain search list).
1341
1342 * systemd-networkd gained support for serving IPv6 address ranges using
bc99dac5 1343 the Router Advertisement protocol. The new .network configuration
4b4da299
LP
1344 section [IPv6Prefix] may be used to configure the ranges to
1345 serve. This is implemented based on a new, minimal, native server
1346 implementation of RA.
1347
1348 * journalctl's --output= switch gained support for a new parameter
1349 "short-iso-precise" for a mode where timestamps are shown as precise
1350 ISO date values.
1351
1352 * systemd-udevd's "net_id" builtin may now generate stable network
1353 interface names from IBM PowerVM VIO devices as well as ACPI platform
1354 devices.
1355
1356 * MulticastDNS support in systemd-resolved may now be explicitly
1357 enabled/disabled using the new MulticastDNS= configuration file
1358 option.
1359
1360 * systemd-resolved may now optionally use libidn2 instead of the libidn
7f7ab228
ZJS
1361 for processing internationalized domain names. Support for libidn2
1362 should be considered experimental and should not be enabled by
1363 default yet.
4b4da299
LP
1364
1365 * "machinectl pull-tar" and related call may now do verification of
1366 downloaded images using SUSE-style .sha256 checksum files in addition
1367 to the already existing support for validating using Ubuntu-style
1368 SHA256SUMS files.
1369
1370 * sd-bus gained support for a new sd_bus_message_appendv() call which
1371 is va_list equivalent of sd_bus_message_append().
1372
1373 * sd-boot gained support for validating images using SHIM/MOK.
1374
1375 * The SMACK code learnt support for "onlycap".
1376
1377 * systemd-mount --umount is now much smarter in figuring out how to
1378 properly unmount a device given its mount or device path.
5486a31d
ZJS
1379
1380 * The code to call libnss_dns as a fallback from libnss_resolve when
1381 the communication with systemd-resolved fails was removed. This
1382 fallback was redundant and interfered with the [!UNAVAIL=return]
1383 suffix. See nss-resolve(8) for the recommended configuration.
1384
9f09a95a
ZJS
1385 * systemd-logind may now be restarted without losing state. It stores
1386 the file descriptors for devices it manages in the system manager
38d93385 1387 using the FDSTORE= mechanism. Please note that further changes in
9f09a95a
ZJS
1388 other components may be required to make use of this (for example
1389 Xorg has code to listen for stops of systemd-logind and terminate
1390 itself when logind is stopped or restarted, in order to avoid using
1391 stale file descriptors for graphical devices, which is now
1392 counterproductive and must be reverted in order for restarts of
1393 systemd-logind to be safe. See
1394 https://cgit.freedesktop.org/xorg/xserver/commit/?id=dc48bd653c7e101.)
1395
9d8813b3
YW
1396 * All kernel install plugins are called with the environment variable
1397 KERNEL_INSTALL_MACHINE_ID which is set to the machine ID given by
1398 /etc/machine-id. If the file is missing or empty, the variable is
1399 empty and BOOT_DIR_ABS is the path of a temporary directory which is
38d93385 1400 removed after all the plugins exit. So, if KERNEL_INSTALL_MACHINE_ID
9d8813b3
YW
1401 is empty, all plugins should not put anything in BOOT_DIR_ABS.
1402
184d2c15 1403 Contributions from: Adrian Heine né Lang, Aggelos Avgerinos, Alexander
ac172e52
LP
1404 Kurtz, Alexandros Frantzis, Alexey Brodkin, Alex Lu, Amir Pakdel, Amir
1405 Yalon, Anchor Cat, Anthony Parsons, Bastien Nocera, Benjamin Gilbert,
1406 Benjamin Robin, Boucman, Charles Plessy, Chris Chiu, Chris Lamb,
1407 Christian Brauner, Christian Hesse, Colin Walters, Daniel Drake,
184d2c15
LP
1408 Danielle Church, Daniel Molkentin, Daniel Rusek, Daniel Wang, Davide
1409 Cavalca, David Herrmann, David Michael, Dax Kelson, Dimitri John
1410 Ledkov, Djalal Harouni, Dušan Kazik, Elias Probst, Evgeny Vereshchagin,
1411 Federico Di Pierro, Felipe Sateler, Felix Zhang, Franck Bui, Gary
ac172e52
LP
1412 Tierney, George McCollister, Giedrius Statkevičius, Hans de Goede,
1413 hecke, Hendrik Westerberg, Hristo Venev, Ian Wienand, Insun Pyo, Ivan
1414 Shapovalov, James Cowgill, James Hemsing, Janne Heß, Jan Synacek, Jason
1415 Reeder, João Paulo Rechi Vita, John Paul Adrian Glaubitz, Jörg
1416 Thalheim, Josef Andersson, Josef Gajdusek, Julian Mehne, Kai Krakow,
1417 Krzysztof Jackiewicz, Lars Karlitski, Lennart Poettering, Lluís Gili,
1418 Lucas Werkmeister, Lukáš Nykrýn, Łukasz Stelmach, Mantas Mikulėnas,
1419 Marcin Bachry, Marcus Cooper, Mark Stosberg, Martin Pitt, Matija Skala,
1420 Matt Clarkson, Matthew Garrett, Matthias Greiner, Matthijs van Duin,
1421 Max Resch, Michael Biebl, Michal Koutný, Michal Sekletar, Michal
1422 Soltys, Michal Suchanek, Mike Gilbert, Nate Clark, Nathaniel R. Lewis,
1423 Neil Brown, Nikolai Kondrashov, Pascal S. de Kloe, Pat Riehecky, Patrik
1424 Flykt, Paul Kocialkowski, Peter Hutterer, Philip Withnall, Piotr
1425 Szydełko, Rafael Fontenelle, Ray Strode, Richard Maw, Roelf Wichertjes,
1426 Ronny Chevalier, Sarang S. Dalal, Sjoerd Simons, slodki, Stefan
1427 Schweter, Susant Sahani, Ted Wood, Thomas Blume, Thomas Haller, Thomas
184d2c15
LP
1428 H. P. Andersen, Timothée Ravier, Tobias Jungel, Tobias Stoeckmann, Tom
1429 Gundersen, Tom Yan, Torstein Husebø, Umut Tezduyar Lindskog,
ac172e52
LP
1430 userwithuid, Vito Caputo, Waldemar Brodkorb, WaLyong Cho, Yu, Li-Yu,
1431 Yusuke Nojima, Yu Watanabe, Zbigniew Jędrzejewski-Szmek, Дамјан
1432 Георгиевски
4b4da299 1433
ac172e52 1434 — Berlin, 2017-07-12
4b4da299 1435
a2b53448 1436CHANGES WITH 233:
d08ee7cb 1437
23eb30b3
ZJS
1438 * The "hybrid" control group mode has been modified to improve
1439 compatibility with "legacy" cgroups-v1 setups. Specifically, the
1440 "hybrid" setup of /sys/fs/cgroup is now pretty much identical to
1441 "legacy" (including /sys/fs/cgroup/systemd as "name=systemd" named
1442 cgroups-v1 hierarchy), the only externally visible change being that
1443 the cgroups-v2 hierarchy is also mounted, to
1444 /sys/fs/cgroup/unified. This should provide a large degree of
1445 compatibility with "legacy" cgroups-v1, while taking benefit of the
1446 better management capabilities of cgroups-v2.
1447
1448 * The default control group setup mode may be selected both a boot-time
1449 via a set of kernel command line parameters (specifically:
1450 systemd.unified_cgroup_hierarchy= and
1451 systemd.legacy_systemd_cgroup_controller=), as well as a compile-time
1452 default selected on the configure command line
1453 (--with-default-hierarchy=). The upstream default is "hybrid"
1454 (i.e. the cgroups-v1 + cgroups-v2 mixture discussed above) now, but
1455 this will change in a future systemd version to be "unified" (pure
1456 cgroups-v2 mode). The third option for the compile time option is
1457 "legacy", to enter pure cgroups-v1 mode. We recommend downstream
1458 distributions to default to "hybrid" mode for release distributions,
1459 starting with v233. We recommend "unified" for development
1460 distributions (specifically: distributions such as Fedora's rawhide)
1461 as that's where things are headed in the long run. Use "legacy" for
1462 greatest stability and compatibility only.
1463
1464 * Note one current limitation of "unified" and "hybrid" control group
1465 setup modes: the kernel currently does not permit the systemd --user
1466 instance (i.e. unprivileged code) to migrate processes between two
1467 disconnected cgroup subtrees, even if both are managed and owned by
1468 the user. This effectively means "systemd-run --user --scope" doesn't
1469 work when invoked from outside of any "systemd --user" service or
1470 scope. Specifically, it is not supported from session scopes. We are
1471 working on fixing this in a future systemd version. (See #3388 for
1472 further details about this.)
1473
fb7c4eff
MG
1474 * DBus policy files are now installed into /usr rather than /etc. Make
1475 sure your system has dbus >= 1.9.18 running before upgrading to this
1476 version, or override the install path with --with-dbuspolicydir= .
1477
23eb30b3
ZJS
1478 * All python scripts shipped with systemd (specifically: the various
1479 tests written in Python) now require Python 3.
1480
d60c5270 1481 * systemd unit tests can now run standalone (without the source or
4dfe64f8
ZJS
1482 build directories), and can be installed into /usr/lib/systemd/tests/
1483 with 'make install-tests'.
1484
23eb30b3
ZJS
1485 * Note that from this version on, CONFIG_CRYPTO_USER_API_HASH,
1486 CONFIG_CRYPTO_HMAC and CONFIG_CRYPTO_SHA256 need to be enabled in the
1487 kernel.
1488
1489 * Support for the %c, %r, %R specifiers in unit files has been
1490 removed. Specifiers are not supposed to be dependent on configuration
1491 in the unit file itself (so that they resolve the same regardless
1492 where used in the unit files), but these specifiers were influenced
1493 by the Slice= option.
1494
5cfc0a84
LP
1495 * The shell invoked by debug-shell.service now defaults to /bin/sh in
1496 all cases. If distributions want to use a different shell for this
1497 purpose (for example Fedora's /sbin/sushell) they need to specify
1498 this explicitly at configure time using --with-debug-shell=.
1499
2bcc3309
FB
1500 * The confirmation spawn prompt has been reworked to offer the
1501 following choices:
1502
b0eb2944 1503 (c)ontinue, proceed without asking anymore
dd6f9ac0 1504 (D)ump, show the state of the unit
2bcc3309 1505 (f)ail, don't execute the command and pretend it failed
d172b175 1506 (h)elp
eedf223a 1507 (i)nfo, show a short summary of the unit
56fde33a 1508 (j)obs, show jobs that are in progress
2bcc3309
FB
1509 (s)kip, don't execute the command and pretend it succeeded
1510 (y)es, execute the command
1511
1512 The 'n' choice for the confirmation spawn prompt has been removed,
1513 because its meaning was confusing.
1514
d08ee7cb
LP
1515 The prompt may now also be redirected to an alternative console by
1516 specifying the console as parameter to systemd.confirm_spawn=.
1517
8e458bfe
JW
1518 * Services of Type=notify require a READY=1 notification to be sent
1519 during startup. If no such message is sent, the service now fails,
1520 even if the main process exited with a successful exit code.
1521
85266f9b
LP
1522 * Services that fail to start up correctly now always have their
1523 ExecStopPost= commands executed. Previously, they'd enter "failed"
1524 state directly, without executing these commands.
1525
baf32786
MP
1526 * The option MulticastDNS= of network configuration files has acquired
1527 an actual implementation. With MulticastDNS=yes a host can resolve
23eb30b3 1528 names of remote hosts and reply to mDNS A and AAAA requests.
fa8b4499 1529
631b676b
LP
1530 * When units are about to be started an additional check is now done to
1531 ensure that all dependencies of type BindsTo= (when used in
1532 combination with After=) have been started.
1533
d08ee7cb
LP
1534 * systemd-analyze gained a new verb "syscall-filter" which shows which
1535 system call groups are defined for the SystemCallFilter= unit file
23eb30b3 1536 setting, and which system calls they contain.
d08ee7cb
LP
1537
1538 * A new system call filter group "@filesystem" has been added,
23eb30b3 1539 consisting of various file system related system calls. Group
d08ee7cb 1540 "@reboot" has been added, covering reboot, kexec and shutdown related
23eb30b3 1541 calls. Finally, group "@swap" has been added covering swap
d08ee7cb
LP
1542 configuration related calls.
1543
1544 * A new unit file option RestrictNamespaces= has been added that may be
1545 used to restrict access to the various process namespace types the
1546 Linux kernel provides. Specifically, it may be used to take away the
23eb30b3
ZJS
1547 right for a service unit to create additional file system, network,
1548 user, and other namespaces. This sandboxing option is particularly
1549 relevant due to the high amount of recently discovered namespacing
1550 related vulnerabilities in the kernel.
d08ee7cb 1551
23eb30b3
ZJS
1552 * systemd-udev's .link files gained support for a new AutoNegotiation=
1553 setting for configuring Ethernet auto-negotiation.
d08ee7cb
LP
1554
1555 * systemd-networkd's .network files gained support for a new
1556 ListenPort= setting in the [DHCP] section to explicitly configure the
1557 UDP client port the DHCP client shall listen on.
1558
23eb30b3
ZJS
1559 * .network files gained a new Unmanaged= boolean setting for explicitly
1560 excluding one or more interfaces from management by systemd-networkd.
1561
1562 * The systemd-networkd ProxyARP= option has been renamed to
1563 IPV4ProxyARP=. Similarly, VXLAN-specific option ARPProxy= has been
1564 renamed to ReduceARPProxy=. The old names continue to be available
1565 for compatibility.
1566
1567 * systemd-networkd gained support for configuring IPv6 Proxy NDP
1568 addresses via the new IPv6ProxyNDPAddress= .network file setting.
1569
1570 * systemd-networkd's bonding device support gained support for two new
1571 configuration options ActiveSlave= and PrimarySlave=.
1572
1573 * The various options in the [Match] section of .network files gained
1574 support for negative matching.
1575
d08ee7cb
LP
1576 * New systemd-specific mount options are now understood in /etc/fstab:
1577
1578 x-systemd.mount-timeout= may be used to configure the maximum
1579 permitted runtime of the mount command.
1580
1581 x-systemd.device-bound may be set to bind a mount point to its
1582 backing device unit, in order to automatically remove a mount point
1583 if its backing device is unplugged. This option may also be
1584 configured through the new SYSTEMD_MOUNT_DEVICE_BOUND udev property
1585 on the block device, which is now automatically set for all CDROM
1586 drives, so that mounted CDs are automatically unmounted when they are
1587 removed from the drive.
1588
23eb30b3
ZJS
1589 x-systemd.after= and x-systemd.before= may be used to explicitly
1590 order a mount after or before another unit or mount point.
d08ee7cb
LP
1591
1592 * Enqueued start jobs for device units are now automatically garbage
1593 collected if there are no jobs waiting for them anymore.
1594
23eb30b3
ZJS
1595 * systemctl list-jobs gained two new switches: with --after, for every
1596 queued job the jobs it's waiting for are shown; with --before the
1597 jobs which it's blocking are shown.
d08ee7cb
LP
1598
1599 * systemd-nspawn gained support for ephemeral boots from disk images
1600 (or in other words: --ephemeral and --image= may now be
1601 combined). Moreover, ephemeral boots are now supported for normal
1602 directories, even if the backing file system is not btrfs. Of course,
baf32786
MP
1603 if the file system does not support file system snapshots or
1604 reflinks, the initial copy operation will be relatively expensive, but
1605 this should still be suitable for many use cases.
d08ee7cb
LP
1606
1607 * Calendar time specifications in .timer units now support
1608 specifications relative to the end of a month by using "~" instead of
1609 "-" as separator between month and day. For example, "*-02~03" means
23eb30b3 1610 "the third last day in February". In addition a new syntax for
d08ee7cb
LP
1611 repeated events has been added using the "/" character. For example,
1612 "9..17/2:00" means "every two hours from 9am to 5pm".
1613
1614 * systemd-socket-proxyd gained a new parameter --connections-max= for
1615 configuring the maximum number of concurrent connections.
1616
23eb30b3
ZJS
1617 * sd-id128 gained a new API for generating unique IDs for the host in a
1618 way that does not leak the machine ID. Specifically,
d08ee7cb 1619 sd_id128_get_machine_app_specific() derives an ID based on the
baf32786 1620 machine ID a in well-defined, non-reversible, stable way. This is
d08ee7cb
LP
1621 useful whenever an identifier for the host is needed but where the
1622 identifier shall not be useful to identify the system beyond the
1623 scope of the application itself. (Internally this uses HMAC-SHA256 as
1624 keyed hash function using the machine ID as input.)
1625
1626 * NotifyAccess= gained a new supported value "exec". When set
1627 notifications are accepted from all processes systemd itself invoked,
1628 including all control processes.
1629
1630 * .nspawn files gained support for defining overlay mounts using the
1631 Overlay= and OverlayReadOnly= options. Previously this functionality
1632 was only available on the systemd-nspawn command line.
1633
1634 * systemd-nspawn's --bind= and --overlay= options gained support for
1635 bind/overlay mounts whose source lies within the container tree by
1636 prefixing the source path with "+".
1637
1638 * systemd-nspawn's --bind= and --overlay= options gained support for
1639 automatically allocating a temporary source directory in /var/tmp
1640 that is removed when the container dies. Specifically, if the source
1641 directory is specified as empty string this mechanism is selected. An
1642 example usage is --overlay=+/var::/var, which creates an overlay
1643 mount based on the original /var contained in the image, overlayed
1644 with a temporary directory in the host's /var/tmp. This way changes
1645 to /var are automatically flushed when the container shuts down.
1646
baf32786
MP
1647 * systemd-nspawn --image= option does now permit raw file system block
1648 devices (in addition to images containing partition tables, as
1649 before).
d08ee7cb
LP
1650
1651 * The disk image dissection logic in systemd-nspawn gained support for
1652 automatically setting up LUKS encrypted as well as Verity protected
1653 partitions. When a container is booted from an encrypted image the
1654 passphrase is queried at start-up time. When a container with Verity
1655 data is started, the root hash is search in a ".roothash" file
1656 accompanying the disk image (alternatively, pass the root hash via
1657 the new --root-hash= command line option).
1658
1659 * A new tool /usr/lib/systemd/systemd-dissect has been added that may
1660 be used to dissect disk images the same way as systemd-nspawn does
1661 it, following the Bootable Partition Specification. It may even be
1662 used to mount disk images with complex partition setups (including
1663 LUKS and Verity partitions) to a local host directory, in order to
1664 inspect them. This tool is not considered public API (yet), and is
1665 thus not installed into /usr/bin. Please do not rely on its
3b31c466 1666 existence, since it might go away or be changed in later systemd
d08ee7cb
LP
1667 versions.
1668
1669 * A new generator "systemd-verity-generator" has been added, similar in
baf32786 1670 style to "systemd-cryptsetup-generator", permitting automatic setup of
d08ee7cb
LP
1671 Verity root partitions when systemd boots up. In order to make use of
1672 this your partition setup should follow the Discoverable Partitions
1673 Specification, and the GPT partition ID of the root file system
1674 partition should be identical to the upper 128bit of the Verity root
1675 hash. The GPT partition ID of the Verity partition protecting it
1676 should be the lower 128bit of the Verity root hash. If the partition
1677 image follows this model it is sufficient to specify a single
1678 "roothash=" kernel command line argument to both configure which root
1679 image and verity partition to use as well as the root hash for
1680 it. Note that systemd-nspawn's Verity support follows the same
1681 semantics, meaning that disk images with proper Verity data in place
1682 may be booted in containers with systemd-nspawn as well as on
1683 physical systems via the verity generator. Also note that the "mkosi"
1684 tool available at https://github.com/systemd/mkosi has been updated
1685 to generate Verity protected disk images following this scheme. In
1686 fact, it has been updated to generate disk images that optionally
1687 implement a complete UEFI SecureBoot trust chain, involving a signed
1688 kernel and initrd image that incorporates such a root hash as well as
1689 a Verity-enabled root partition.
1690
d08ee7cb
LP
1691 * The hardware database (hwdb) udev supports has been updated to carry
1692 accelerometer quirks.
1693
1694 * All system services are now run with a fresh kernel keyring set up
1695 for them. The invocation ID is stored by default in it, thus
1696 providing a safe, non-overridable way to determine the invocation
1697 ID of each service.
1698
1699 * Service unit files gained new BindPaths= and BindReadOnlyPaths=
1700 options for bind mounting arbitrary paths in a service-specific
1701 way. When these options are used, arbitrary host or service files and
1702 directories may be mounted to arbitrary locations in the service's
1703 view.
1704
1705 * Documentation has been added that lists all of systemd's low-level
1706 environment variables:
1707
a8a27374 1708 https://github.com/systemd/systemd/blob/master/docs/ENVIRONMENT.md
d08ee7cb
LP
1709
1710 * sd-daemon gained a new API sd_is_socket_sockaddr() for determining
1711 whether a specific socket file descriptor matches a specified socket
1712 address.
1713
1714 * systemd-firstboot has been updated to check for the
1715 systemd.firstboot= kernel command line option. It accepts a boolean
1716 and when set to false the first boot questions are skipped.
1717
d08ee7cb 1718 * systemd-fstab-generator has been updated to check for the
23eb30b3
ZJS
1719 systemd.volatile= kernel command line option, which either takes an
1720 optional boolean parameter or the special value "state". If used the
1721 system may be booted in a "volatile" boot mode. Specifically,
1722 "systemd.volatile" is used, the root directory will be mounted as
d08ee7cb 1723 tmpfs, and only /usr is mounted from the actual root file system. If
23eb30b3
ZJS
1724 "systemd.volatile=state" is used, the root directory will be mounted
1725 as usual, but /var is mounted as tmpfs. This concept provides similar
d08ee7cb
LP
1726 functionality as systemd-nspawn's --volatile= option, but provides it
1727 on physical boots. Use this option for implementing stateless
1728 systems, or testing systems with all state and/or configuration reset
1729 to the defaults. (Note though that many distributions are not
23eb30b3 1730 prepared to boot up without a populated /etc or /var, though.)
d08ee7cb
LP
1731
1732 * systemd-gpt-auto-generator gained support for LUKS encrypted root
1733 partitions. Previously it only supported LUKS encrypted partitions
1734 for all other uses, except for the root partition itself.
1735
1736 * Socket units gained support for listening on AF_VSOCK sockets for
1737 communication in virtualized QEMU environments.
1738
1739 * The "configure" script gained a new option --with-fallback-hostname=
1740 for specifying the fallback hostname to use if none is configured in
1741 /etc/hostname. For example, by specifying
1742 --with-fallback-hostname=fedora it is possible to default to a
23eb30b3 1743 hostname of "fedora" on pristine installations.
d08ee7cb
LP
1744
1745 * systemd-cgls gained support for a new --unit= switch for listing only
1746 the control groups of a specific unit. Similar --user-unit= has been
1747 added for listing only the control groups of a specific user unit.
1748
1749 * systemd-mount gained a new --umount switch for unmounting a mount or
1750 automount point (and all mount/automount points below it).
1751
1752 * systemd will now refuse full configuration reloads (via systemctl
1753 daemon-reload and related calls) unless at least 16MiB of free space
1754 are available in /run. This is a safety precaution in order to ensure
1755 that generators can safely operate after the reload completed.
1756
1757 * A new unit file option RootImage= has been added, which has a similar
1758 effect as RootDirectory= but mounts the service's root directory from
1759 a disk image instead of plain directory. This logic reuses the same
1760 image dissection and mount logic that systemd-nspawn already uses,
1761 and hence supports any disk images systemd-nspawn supports, including
1762 those following the Discoverable Partition Specification, as well as
1763 Verity enabled images. This option enables systemd to run system
1764 services directly off disk images acting as resource bundles,
1765 possibly even including full integrity data.
1766
1767 * A new MountAPIVFS= unit file option has been added, taking a boolean
baf32786 1768 argument. If enabled /proc, /sys and /dev (collectively called the
d08ee7cb
LP
1769 "API VFS") will be mounted for the service. This is only relevant if
1770 RootDirectory= or RootImage= is used for the service, as these mounts
1771 are of course in place in the host mount namespace anyway.
1772
1773 * systemd-nspawn gained support for a new --pivot-root= switch. If
1774 specified the root directory within the container image is pivoted to
1775 the specified mount point, while the original root disk is moved to a
1776 different place. This option enables booting of ostree images
1777 directly with systemd-nspawn.
1778
d08ee7cb 1779 * The systemd build scripts will no longer complain if the NTP server
23eb30b3 1780 addresses are not changed from the defaults. Google now supports
d08ee7cb
LP
1781 these NTP servers officially. We still recommend downstreams to
1782 properly register an NTP pool with the NTP pool project though.
1783
c1ec34d1 1784 * coredumpctl gained a new "--reverse" option for printing the list
d08ee7cb
LP
1785 of coredumps in reverse order.
1786
23eb30b3
ZJS
1787 * coredumpctl will now show additional information about truncated and
1788 inaccessible coredumps, as well as coredumps that are still being
1789 processed. It also gained a new --quiet switch for suppressing
1790 additional informational message in its output.
1791
1792 * coredumpctl gained support for only showing coredumps newer and/or
1793 older than specific timestamps, using the new --since= and --until=
1794 options, reminiscent of journalctl's options by the same name.
1795
d08ee7cb 1796 * The systemd-coredump logic has been improved so that it may be reused
23eb30b3 1797 to collect backtraces in non-compiled languages, for example in
d08ee7cb
LP
1798 scripting languages such as Python.
1799
1800 * machinectl will now show the UID shift of local containers, if user
1801 namespacing is enabled for them.
1802
baf32786 1803 * systemd will now optionally run "environment generator" binaries at
d08ee7cb
LP
1804 configuration load time. They may be used to add environment
1805 variables to the environment block passed to services invoked. One
baf32786 1806 user environment generator is shipped by default that sets up
23eb30b3
ZJS
1807 environment variables based on files dropped into /etc/environment.d
1808 and ~/.config/environment.d/.
d08ee7cb 1809
a2b53448
LP
1810 * systemd-resolved now includes the new, recently published 2017 DNSSEC
1811 root key (KSK).
1812
a2b53448
LP
1813 * hostnamed has been updated to report a new chassis type of
1814 "convertible" to cover "foldable" laptops that can both act as a
1815 tablet and as a laptop, such as various Lenovo Yoga devices.
1816
d08ee7cb
LP
1817 Contributions from: Adrián López, Alexander Galanin, Alexander
1818 Kochetkov, Alexandros Frantzis, Andrey Ulanov, Antoine Eiche, Baruch
1819 Siach, Bastien Nocera, Benjamin Robin, Björn, Brandon Philips, Cédric
1820 Schieli, Charles (Chas) Williams, Christian Hesse, Daniele Medri,
1821 Daniel Drake, Daniel Rusek, Daniel Wagner, Dan Streetman, Dave Reisner,
1822 David Glasser, David Herrmann, David Michael, Djalal Harouni, Dmitry
1823 Khlebnikov, Dmitry Rozhkov, Dongsu Park, Douglas Christman, Earnestly,
1824 Emil Soleyman, Eric Cook, Evgeny Vereshchagin, Felipe Sateler, Fionn
1825 Cleary, Florian Klink, Francesco Brozzu, Franck Bui, Gabriel Rauter,
a2b53448
LP
1826 Gianluca Boiano, Giedrius Statkevičius, Graeme Lawes, Hans de Goede,
1827 Harald Hoyer, Ian Kelling, Ivan Shapovalov, Jakub Wilk, Janne Heß, Jan
1828 Synacek, Jason Reeder, Jonathan Boulle, Jörg Thalheim, Jouke Witteveen,
1829 Karl Kraus, Kees Cook, Keith Busch, Kieran Colford, kilian-k, Lennart
1830 Poettering, Lubomir Rintel, Lucas Werkmeister, Lukas Rusak, Maarten de
1831 Vries, Maks Naumov, Mantas Mikulėnas, Marc-Andre Lureau, Marcin Bachry,
1832 Mark Stosberg, Martin Ejdestig, Martin Pitt, Mauricio Faria de
1833 Oliveira, micah, Michael Biebl, Michael Shields, Michal Schmidt, Michal
1834 Sekletar, Michel Kraus, Mike Gilbert, Mikko Ylinen, Mirza Krak,
1835 Namhyung Kim, nikolaof, peoronoob, Peter Hutterer, Peter Körner, Philip
1836 Withnall, Piotr Drąg, Ray Strode, Reverend Homer, Rike-Benjamin
1837 Schuppner, Robert Kreuzer, Ronny Chevalier, Ruslan Bilovol, sammynx,
1838 Sergey Ptashnick, Sergiusz Urbaniak, Stefan Berger, Stefan Hajnoczi,
1839 Stefan Schweter, Stuart McLaren, Susant Sahani, Sylvain Plantefève,
1840 Taylor Smock, Tejun Heo, Thomas Blume, Thomas H. P. Andersen, Tibor
1841 Nagy, Tobias Stoeckmann, Tom Gundersen, Torstein Husebø, Viktar
1842 Vaŭčkievič, Viktor Mihajlovski, Vitaly Sulimov, Waldemar Brodkorb,
1843 Walter Garcia-Fontes, Wim de With, Yassine Imounachen, Yi EungJun,
1844 YunQiang Su, Yu Watanabe, Zbigniew Jędrzejewski-Szmek, Александр
1845 Тихонов
1846
1847 — Berlin, 2017-03-01
d08ee7cb 1848
54b24597 1849CHANGES WITH 232:
76153ad4 1850
05f426d2
LP
1851 * udev now runs with MemoryDenyWriteExecute=, RestrictRealtime= and
1852 RestrictAddressFamilies= enabled. These sandboxing options should
1853 generally be compatible with the various external udev call-out
1854 binaries we are aware of, however there may be exceptions, in
1855 particular when exotic languages for these call-outs are used. In
1856 this case, consider turning off these settings locally.
1857
4ffe2479
ZJS
1858 * The new RemoveIPC= option can be used to remove IPC objects owned by
1859 the user or group of a service when that service exits.
1860
6fa44114 1861 * The new ProtectKernelModules= option can be used to disable explicit
4c37970d
LP
1862 load and unload operations of kernel modules by a service. In
1863 addition access to /usr/lib/modules is removed if this option is set.
6fa44114 1864
4a77c53d
ZJS
1865 * ProtectSystem= option gained a new value "strict", which causes the
1866 whole file system tree with the exception of /dev, /proc, and /sys,
1867 to be remounted read-only for a service.
1868
e49e2c25 1869 * The new ProtectKernelTunables= option can be used to disable
4a77c53d
ZJS
1870 modification of configuration files in /sys and /proc by a service.
1871 Various directories and files are remounted read-only, so access is
1872 restricted even if the file permissions would allow it.
1873
6fa44114 1874 * The new ProtectControlGroups= option can be used to disable write
4a77c53d
ZJS
1875 access by a service to /sys/fs/cgroup.
1876
1877 * Various systemd services have been hardened with
1878 ProtectKernelTunables=yes, ProtectControlGroups=yes,
1879 RestrictAddressFamilies=.
1880
4ffe2479
ZJS
1881 * Support for dynamically creating users for the lifetime of a service
1882 has been added. If DynamicUser=yes is specified, user and group IDs
1883 will be allocated from the range 61184..65519 for the lifetime of the
1884 service. They can be resolved using the new nss-systemd.so NSS
1885 module. The module must be enabled in /etc/nsswitch.conf. Services
1886 started in this way have PrivateTmp= and RemoveIPC= enabled, so that
1887 any resources allocated by the service will be cleaned up when the
4a77c53d
ZJS
1888 service exits. They also have ProtectHome=read-only and
1889 ProtectSystem=strict enabled, so they are not able to make any
1890 permanent modifications to the system.
4ffe2479 1891
171ae2cd 1892 * The nss-systemd module also always resolves root and nobody, making
4ffe2479 1893 it possible to have no /etc/passwd or /etc/group files in minimal
171ae2cd 1894 container or chroot environments.
4ffe2479
ZJS
1895
1896 * Services may be started with their own user namespace using the new
171ae2cd
LP
1897 boolean PrivateUsers= option. Only root, nobody, and the uid/gid
1898 under which the service is running are mapped. All other users are
1899 mapped to nobody.
4ffe2479
ZJS
1900
1901 * Support for the cgroup namespace has been added to systemd-nspawn. If
1902 supported by kernel, the container system started by systemd-nspawn
1903 will have its own view of the cgroup hierarchy. This new behaviour
1904 can be disabled using $SYSTEMD_NSPAWN_USE_CGNS environment variable.
1905
1906 * The new MemorySwapMax= option can be used to limit the maximum swap
1907 usage under the unified cgroup hierarchy.
1908
1909 * Support for the CPU controller in the unified cgroup hierarchy has
1910 been added, via the CPUWeight=, CPUStartupWeight=, CPUAccounting=
1911 options. This controller requires out-of-tree patches for the kernel
1912 and the support is provisional.
1913
171ae2cd
LP
1914 * Mount and automount units may now be created transiently
1915 (i.e. dynamically at runtime via the bus API, instead of requiring
1916 unit files in the file system).
1917
1918 * systemd-mount is a new tool which may mount file systems – much like
1919 mount(8), optionally pulling in additional dependencies through
1920 transient .mount and .automount units. For example, this tool
1921 automatically runs fsck on a backing block device before mounting,
1922 and allows the automount logic to be used dynamically from the
1923 command line for establishing mount points. This tool is particularly
1924 useful when dealing with removable media, as it will ensure fsck is
1925 run – if necessary – before the first access and that the file system
1926 is quickly unmounted after each access by utilizing the automount
1927 logic. This maximizes the chance that the file system on the
1928 removable media stays in a clean state, and if it isn't in a clean
1929 state is fixed automatically.
4ffe2479
ZJS
1930
1931 * LazyUnmount=yes option for mount units has been added to expose the
1932 umount --lazy option. Similarly, ForceUnmount=yes exposes the --force
1933 option.
1934
1935 * /efi will be used as the mount point of the EFI boot partition, if
1936 the directory is present, and the mount point was not configured
1937 through other means (e.g. fstab). If /efi directory does not exist,
1938 /boot will be used as before. This makes it easier to automatically
1939 mount the EFI partition on systems where /boot is used for something
1940 else.
1941
171ae2cd
LP
1942 * When operating on GPT disk images for containers, systemd-nspawn will
1943 now mount the ESP to /boot or /efi according to the same rules as PID
1944 1 running on a host. This allows tools like "bootctl" to operate
1945 correctly within such containers, in order to make container images
1946 bootable on physical systems.
1947
4a77c53d 1948 * disk/by-id and disk/by-path symlinks are now created for NVMe drives.
4ffe2479
ZJS
1949
1950 * Two new user session targets have been added to support running
1951 graphical sessions under the systemd --user instance:
1952 graphical-session.target and graphical-session-pre.target. See
1953 systemd.special(7) for a description of how those targets should be
1954 used.
1955
1956 * The vconsole initialization code has been significantly reworked to
d4c08299 1957 use KD_FONT_OP_GET/SET ioctls instead of KD_FONT_OP_COPY and better
4ffe2479
ZJS
1958 support unicode keymaps. Font and keymap configuration will now be
1959 copied to all allocated virtual consoles.
1960
05ecf467 1961 * FreeBSD's bhyve virtualization is now detected.
4ffe2479 1962
d4c08299 1963 * Information recorded in the journal for core dumps now includes the
4ffe2479
ZJS
1964 contents of /proc/mountinfo and the command line of the process at
1965 the top of the process hierarchy (which is usually the init process
1966 of the container).
1967
171ae2cd 1968 * systemd-journal-gatewayd learned the --directory= option to serve
4ffe2479
ZJS
1969 files from the specified location.
1970
1971 * journalctl --root=… can be used to peruse the journal in the
1972 /var/log/ directories inside of a container tree. This is similar to
1973 the existing --machine= option, but does not require the container to
1974 be active.
1975
1976 * The hardware database has been extended to support
1977 ID_INPUT_TRACKBALL, used in addition to ID_INPUT_MOUSE to identify
1978 trackball devices.
1979
1980 MOUSE_WHEEL_CLICK_ANGLE_HORIZONTAL hwdb property has been added to
1981 specify the click rate for mice which include a horizontal wheel with
1982 a click rate that is different than the one for the vertical wheel.
1983
1984 * systemd-run gained a new --wait option that makes service execution
171ae2cd
LP
1985 synchronous. (Specifically, the command will not return until the
1986 specified service binary exited.)
4ffe2479 1987
171ae2cd 1988 * systemctl gained a new --wait option that causes the start command to
4a77c53d
ZJS
1989 wait until the units being started have terminated again.
1990
171ae2cd 1991 * A new journal output mode "short-full" has been added which displays
4ffe2479 1992 timestamps with abbreviated English day names and adds a timezone
171ae2cd
LP
1993 suffix. Those timestamps include more information than the default
1994 "short" output mode, and can be passed directly to journalctl's
1995 --since= and --until= options.
4ffe2479
ZJS
1996
1997 * /etc/resolv.conf will be bind-mounted into containers started by
1998 systemd-nspawn, if possible, so any changes to resolv.conf contents
1999 are automatically propagated to the container.
2000
2001 * The number of instances for socket-activated services originating
171ae2cd
LP
2002 from a single IP address can be limited with
2003 MaxConnectionsPerSource=, extending the existing setting of
2004 MaxConnections=.
4ffe2479 2005
4a77c53d
ZJS
2006 * systemd-networkd gained support for vcan ("Virtual CAN") interface
2007 configuration.
2008
2009 * .netdev and .network configuration can now be extended through
2010 drop-ins.
2011
4ffe2479
ZJS
2012 * UDP Segmentation Offload, TCP Segmentation Offload, Generic
2013 Segmentation Offload, Generic Receive Offload, Large Receive Offload
2014 can be enabled and disabled using the new UDPSegmentationOffload=,
2015 TCPSegmentationOffload=, GenericSegmentationOffload=,
2016 GenericReceiveOffload=, LargeReceiveOffload= options in the
2017 [Link] section of .link files.
2018
171ae2cd
LP
2019 * The Spanning Tree Protocol, Priority, Aging Time, and the Default
2020 Port VLAN ID can be configured for bridge devices using the new STP=,
2021 Priority=, AgeingTimeSec=, and DefaultPVID= settings in the [Bridge]
2022 section of .netdev files.
4ffe2479 2023
171ae2cd 2024 * The route table to which routes received over DHCP or RA should be
4a77c53d
ZJS
2025 added can be configured with the new RouteTable= option in the [DHCP]
2026 and [IPv6AcceptRA] sections of .network files.
2027
171ae2cd 2028 * The Address Resolution Protocol can be disabled on links managed by
4ffe2479
ZJS
2029 systemd-networkd using the ARP=no setting in the [Link] section of
2030 .network files.
2031
171ae2cd
LP
2032 * New environment variables $SERVICE_RESULT, $EXIT_CODE and
2033 $EXIT_STATUS are set for ExecStop= and ExecStopPost= commands, and
2034 encode information about the result and exit codes of the current
2035 service runtime cycle.
4ffe2479 2036
4a77c53d 2037 * systemd-sysctl will now configure kernel parameters in the order
1f4f4cf7 2038 they occur in the configuration files. This matches what sysctl
4a77c53d
ZJS
2039 has been traditionally doing.
2040
2041 * kernel-install "plugins" that are executed to perform various
2042 tasks after a new kernel is added and before an old one is removed
2043 can now return a special value to terminate the procedure and
2044 prevent any later plugins from running.
2045
76153ad4 2046 * Journald's SplitMode=login setting has been deprecated. It has been
d4c08299 2047 removed from documentation, and its use is discouraged. In a future
76153ad4
ZJS
2048 release it will be completely removed, and made equivalent to current
2049 default of SplitMode=uid.
2050
4a77c53d
ZJS
2051 * Storage=both option setting in /etc/systemd/coredump.conf has been
2052 removed. With fast LZ4 compression storing the core dump twice is not
2053 useful.
2054
4ffe2479
ZJS
2055 * The --share-system systemd-nspawn option has been replaced with an
2056 (undocumented) variable $SYSTEMD_NSPAWN_SHARE_SYSTEM, but the use of
2057 this functionality is discouraged. In addition the variables
2058 $SYSTEMD_NSPAWN_SHARE_NS_IPC, $SYSTEMD_NSPAWN_SHARE_NS_PID,
2059 $SYSTEMD_NSPAWN_SHARE_NS_UTS may be used to control the unsharing of
2060 individual namespaces.
2061
171ae2cd
LP
2062 * "machinectl list" now shows the IP address of running containers in
2063 the output, as well as OS release information.
2064
2065 * "loginctl list" now shows the TTY of each session in the output.
2066
2067 * sd-bus gained new API calls sd_bus_track_set_recursive(),
2068 sd_bus_track_get_recursive(), sd_bus_track_count_name(),
2069 sd_bus_track_count_sender(). They permit usage of sd_bus_track peer
2070 tracking objects in a "recursive" mode, where a single client can be
2071 counted multiple times, if it takes multiple references.
2072
2073 * sd-bus gained new API calls sd_bus_set_exit_on_disconnect() and
bc99dac5 2074 sd_bus_get_exit_on_disconnect(). They may be used to make a
171ae2cd
LP
2075 process using sd-bus automatically exit if the bus connection is
2076 severed.
2077
2078 * Bus clients of the service manager may now "pin" loaded units into
2079 memory, by taking an explicit reference on them. This is useful to
2080 ensure the client can retrieve runtime data about the service even
2081 after the service completed execution. Taking such a reference is
2082 available only for privileged clients and should be helpful to watch
2083 running services in a race-free manner, and in particular collect
2084 information about exit statuses and results.
2085
4c37970d
LP
2086 * The nss-resolve module has been changed to strictly return UNAVAIL
2087 when communication via D-Bus with resolved failed, and NOTFOUND when
2088 a lookup completed but was negative. This means it is now possible to
2089 neatly configure fallbacks using nsswitch.conf result checking
2090 expressions. Taking benefit of this, the new recommended
2091 configuration line for the "hosts" entry in /etc/nsswitch.conf is:
2092
2093 hosts: files mymachines resolve [!UNAVAIL=return] dns myhostname
2094
2095 * A new setting CtrlAltDelBurstAction= has been added to
2096 /etc/systemd/system.conf which may be used to configure the precise
2097 behaviour if the user on the console presses Ctrl-Alt-Del more often
2098 than 7 times in 2s. Previously this would unconditionally result in
2099 an expedited, immediate reboot. With this new setting the precise
2100 operation may be configured in more detail, and also turned off
2101 entirely.
2102
2103 * In .netdev files two new settings RemoteChecksumTx= and
2104 RemoteChecksumRx= are now understood that permit configuring the
2105 remote checksumming logic for VXLAN networks.
2106
2107 * The service manager learnt a new "invocation ID" concept for invoked
2108 services. Each runtime cycle of a service will get a new invocation
2109 ID (a 128bit random UUID) assigned that identifies the current
2110 run of the service uniquely and globally. A new invocation ID
2111 is generated each time a service starts up. The journal will store
2112 the invocation ID of a service along with any logged messages, thus
2113 making the invocation ID useful for matching the online runtime of a
2114 service with the offline log data it generated in a safe way without
2115 relying on synchronized timestamps. In many ways this new service
2116 invocation ID concept is similar to the kernel's boot ID concept that
2117 uniquely and globally identifies the runtime of each boot. The
2118 invocation ID of a service is passed to the service itself via an
2119 environment variable ($INVOCATION_ID). A new bus call
2120 GetUnitByInvocationID() has been added that is similar to GetUnit()
2121 but instead of retrieving the bus path for a unit by its name
2122 retrieves it by its invocation ID. The returned path is valid only as
2123 long as the passed invocation ID is current.
2124
2125 * systemd-resolved gained a new "DNSStubListener" setting in
2126 resolved.conf. It either takes a boolean value or the special values
2127 "udp" and "tcp", and configures whether to enable the stub DNS
2128 listener on 127.0.0.53:53.
2129
2130 * IP addresses configured via networkd may now carry additional
2131 configuration settings supported by the kernel. New options include:
2132 HomeAddress=, DuplicateAddressDetection=, ManageTemporaryAddress=,
2133 PrefixRoute=, AutoJoin=.
2134
2135 * The PAM configuration fragment file for "user@.service" shipped with
2136 systemd (i.e. the --user instance of systemd) has been stripped to
2137 the minimum necessary to make the system boot. Previously, it
2138 contained Fedora-specific stanzas that did not apply to other
2139 distributions. It is expected that downstream distributions add
2140 additional configuration lines, matching their needs to this file,
2141 using it only as rough template of what systemd itself needs. Note
2142 that this reduced fragment does not even include an invocation of
2143 pam_limits which most distributions probably want to add, even though
2144 systemd itself does not need it. (There's also the new build time
2145 option --with-pamconfdir=no to disable installation of the PAM
2146 fragment entirely.)
2147
2148 * If PrivateDevices=yes is set for a service the CAP_SYS_RAWIO
2149 capability is now also dropped from its set (in addition to
2150 CAP_SYS_MKNOD as before).
2151
2152 * In service unit files it is now possible to connect a specific named
2153 file descriptor with stdin/stdout/stdout of an executed service. The
2154 name may be specified in matching .socket units using the
2155 FileDescriptorName= setting.
2156
2157 * A number of journal settings may now be configured on the kernel
2158 command line. Specifically, the following options are now understood:
2159 systemd.journald.max_level_console=,
2160 systemd.journald.max_level_store=,
2161 systemd.journald.max_level_syslog=, systemd.journald.max_level_kmsg=,
2162 systemd.journald.max_level_wall=.
2163
2164 * "systemctl is-enabled --full" will now show by which symlinks a unit
2165 file is enabled in the unit dependency tree.
2166
b4eed568
LP
2167 * Support for VeraCrypt encrypted partitions has been added to the
2168 "cryptsetup" logic and /etc/crypttab.
2169
2170 * systemd-detect-virt gained support for a new --private-users switch
2171 that checks whether the invoking processes are running inside a user
2172 namespace. Similar, a new special value "private-users" for the
2173 existing ConditionVirtualization= setting has been added, permitting
2174 skipping of specific units in user namespace environments.
2175
07393b6e
LP
2176 Contributions from: Alban Crequy, Alexander Kuleshov, Alfie John,
2177 Andreas Henriksson, Andrew Jeddeloh, Balázs Úr, Bart Rulon, Benjamin
2178 Richter, Ben Gamari, Ben Harris, Brian J. Murrell, Christian Brauner,
2179 Christian Rebischke, Clinton Roy, Colin Walters, Cristian Rodríguez,
2180 Daniel Hahler, Daniel Mack, Daniel Maixner, Daniel Rusek, Dan Dedrick,
2181 Davide Cavalca, David Herrmann, David Michael, Dennis Wassenberg,
2182 Djalal Harouni, Dongsu Park, Douglas Christman, Elias Probst, Eric
2183 Cook, Erik Karlsson, Evgeny Vereshchagin, Felipe Sateler, Felix Zhang,
2184 Franck Bui, George Hilliard, Giuseppe Scrivano, HATAYAMA Daisuke,
2185 Heikki Kemppainen, Hendrik Brueckner, hi117, Ismo Puustinen, Ivan
2186 Shapovalov, Jakub Filak, Jakub Wilk, Jan Synacek, Jason Kölker,
2187 Jean-Sébastien Bour, Jiří Pírko, Jonathan Boulle, Jorge Niedbalski,
2188 Keith Busch, kristbaum, Kyle Russell, Lans Zhang, Lennart Poettering,
2189 Leonardo Brondani Schenkel, Lucas Werkmeister, Luca Bruno, Lukáš
2190 Nykrýn, Maciek Borzecki, Mantas Mikulėnas, Marc-Antoine Perennou,
2191 Marcel Holtmann, Marcos Mello, Martin Ejdestig, Martin Pitt, Matej
2192 Habrnal, Maxime de Roucy, Michael Biebl, Michael Chapman, Michael Hoy,
2193 Michael Olbrich, Michael Pope, Michal Sekletar, Michal Soltys, Mike
2194 Gilbert, Nick Owens, Patrik Flykt, Paweł Szewczyk, Peter Hutterer,
2195 Piotr Drąg, Reid Price, Richard W.M. Jones, Roman Stingler, Ronny
2196 Chevalier, Seraphime Kirkovski, Stefan Schweter, Steve Muir, Susant
2197 Sahani, Tejun Heo, Thomas Blume, Thomas H. P. Andersen, Tiago Levit,
2198 Tobias Jungel, Tomáš Janoušek, Topi Miettinen, Torstein Husebø, Umut
2199 Tezduyar Lindskog, Vito Caputo, WaLyong Cho, Wilhelm Schuster, Yann
2200 E. MORIN, Yi EungJun, Yuki Inoguchi, Yu Watanabe, Zbigniew
2201 Jędrzejewski-Szmek, Zeal Jagannatha
2202
54b24597 2203 — Santa Fe, 2016-11-03
07393b6e 2204
5cd118ba
MP
2205CHANGES WITH 231:
2206
fcd30826
LP
2207 * In service units the various ExecXYZ= settings have been extended
2208 with an additional special character as first argument of the
43eb109a 2209 assigned value: if the character '+' is used the specified command
fcd30826
LP
2210 line it will be run with full privileges, regardless of User=,
2211 Group=, CapabilityBoundingSet= and similar options. The effect is
2212 similar to the existing PermissionsStartOnly= option, but allows
2213 configuration of this concept for each executed command line
2214 independently.
2215
2216 * Services may now alter the service watchdog timeout at runtime by
2217 sending a WATCHDOG_USEC= message via sd_notify().
2218
2219 * MemoryLimit= and related unit settings now optionally take percentage
2220 specifications. The percentage is taken relative to the amount of
2221 physical memory in the system (or in case of containers, the assigned
2222 amount of memory). This allows scaling service resources neatly with
771de3f5 2223 the amount of RAM available on the system. Similarly, systemd-logind's
fcd30826
LP
2224 RuntimeDirectorySize= option now also optionally takes percentage
2225 values.
2226
2227 * In similar fashion TasksMax= takes percentage values now, too. The
2228 value is taken relative to the configured maximum number of processes
2229 on the system. The per-service task maximum has been changed to 15%
2230 using this functionality. (Effectively this is an increase of 512 →
2231 4915 for service units, given the kernel's default pid_max setting.)
2232
2233 * Calendar time specifications in .timer units now understand a ".."
2234 syntax for time ranges. Example: "4..7:10" may now be used for
2235 defining a timer that is triggered at 4:10am, 5:10am, 6:10am and
2236 7:10am every day.
2237
2238 * The InaccessableDirectories=, ReadOnlyDirectories= and
2239 ReadWriteDirectories= unit file settings have been renamed to
2240 InaccessablePaths=, ReadOnlyPaths= and ReadWritePaths= and may now be
2241 applied to all kinds of file nodes, and not just directories, with
2242 the exception of symlinks. Specifically these settings may now be
2243 used on block and character device nodes, UNIX sockets and FIFOS as
2244 well as regular files. The old names of these settings remain
2245 available for compatibility.
2246
2247 * systemd will now log about all service processes it kills forcibly
2248 (using SIGKILL) because they remained after the clean shutdown phase
2249 of the service completed. This should help identifying services that
2250 shut down uncleanly. Moreover if KillUserProcesses= is enabled in
2251 systemd-logind's configuration a similar log message is generated for
2252 processes killed at the end of each session due to this setting.
2253
2254 * systemd will now set the $JOURNAL_STREAM environment variable for all
2255 services whose stdout/stderr are connected to the Journal (which
2256 effectively means by default: all services). The variable contains
2257 the device and inode number of the file descriptor used for
2258 stdout/stderr. This may be used by invoked programs to detect whether
2259 their stdout/stderr is connected to the Journal, in which case they
2260 can switch over to direct Journal communication, thus being able to
2261 pass extended, structured metadata along with their log messages. As
2262 one example, this is now used by glib's logging primitives.
2263
2264 * When using systemd's default tmp.mount unit for /tmp, the mount point
2265 will now be established with the "nosuid" and "nodev" options. This
2266 avoids privilege escalation attacks that put traps and exploits into
2267 /tmp. However, this might cause problems if you e. g. put container
5cd118ba
MP
2268 images or overlays into /tmp; if you need this, override tmp.mount's
2269 "Options=" with a drop-in, or mount /tmp from /etc/fstab with your
2270 desired options.
2271
fcd30826
LP
2272 * systemd now supports the "memory" cgroup controller also on
2273 cgroupsv2.
2274
2275 * The systemd-cgtop tool now optionally takes a control group path as
2276 command line argument. If specified, the control group list shown is
2277 limited to subgroups of that group.
2278
2279 * The SystemCallFilter= unit file setting gained support for
2280 pre-defined, named system call filter sets. For example
2281 SystemCallFilter=@clock is now an effective way to make all clock
771de3f5 2282 changing-related system calls unavailable to a service. A number of
fcd30826
LP
2283 similar pre-defined groups are defined. Writing system call filters
2284 for system services is simplified substantially with this new
2285 concept. Accordingly, all of systemd's own, long-running services now
2286 enable system call filtering based on this, by default.
2287
2288 * A new service setting MemoryDenyWriteExecute= has been added, taking
2289 a boolean value. If turned on, a service may no longer create memory
2290 mappings that are writable and executable at the same time. This
2291 enhances security for services where this is enabled as it becomes
2292 harder to dynamically write and then execute memory in exploited
2293 service processes. This option has been enabled for all of systemd's
2294 own long-running services.
2295
2296 * A new RestrictRealtime= service setting has been added, taking a
2297 boolean argument. If set the service's processes may no longer
2298 acquire realtime scheduling. This improves security as realtime
2299 scheduling may otherwise be used to easily freeze the system.
2300
2301 * systemd-nspawn gained a new switch --notify-ready= taking a boolean
2302 value. This may be used for requesting that the system manager inside
2303 of the container reports start-up completion to nspawn which then
2304 propagates this notification further to the service manager
2305 supervising nspawn itself. A related option NotifyReady= in .nspawn
2306 files has been added too. This functionality allows ordering of the
2307 start-up of multiple containers using the usual systemd ordering
2308 primitives.
2309
2310 * machinectl gained a new command "stop" that is an alias for
2311 "terminate".
2312
2313 * systemd-resolved gained support for contacting DNS servers on
2314 link-local IPv6 addresses.
2315
2316 * If systemd-resolved receives the SIGUSR2 signal it will now flush all
2317 its caches. A method call for requesting the same operation has been
2318 added to the bus API too, and is made available via "systemd-resolve
2319 --flush-caches".
2320
771de3f5 2321 * systemd-resolve gained a new --status switch. If passed a brief
fcd30826
LP
2322 summary of the used DNS configuration with per-interface information
2323 is shown.
2324
2325 * resolved.conf gained a new Cache= boolean option, defaulting to
2326 on. If turned off local DNS caching is disabled. This comes with a
2327 performance penalty in particular when DNSSEC is enabled. Note that
771de3f5 2328 resolved disables its internal caching implicitly anyway, when the
fcd30826
LP
2329 configured DNS server is on a host-local IP address such as ::1 or
2330 127.0.0.1, thus automatically avoiding double local caching.
2331
2332 * systemd-resolved now listens on the local IP address 127.0.0.53:53
2333 for DNS requests. This improves compatibility with local programs
2334 that do not use the libc NSS or systemd-resolved's bus APIs for name
2335 resolution. This minimal DNS service is only available to local
2336 programs and does not implement the full DNS protocol, but enough to
2337 cover local DNS clients. A new, static resolv.conf file, listing just
2338 this DNS server is now shipped in /usr/lib/systemd/resolv.conf. It is
2339 now recommended to make /etc/resolv.conf a symlink to this file in
2340 order to route all DNS lookups to systemd-resolved, regardless if
2341 done via NSS, the bus API or raw DNS packets. Note that this local
2342 DNS service is not as fully featured as the libc NSS or
2343 systemd-resolved's bus APIs. For example, as unicast DNS cannot be
2344 used to deliver link-local address information (as this implies
2345 sending a local interface index along), LLMNR/mDNS support via this
2346 interface is severely restricted. It is thus strongly recommended for
2347 all applications to use the libc NSS API or native systemd-resolved
2348 bus API instead.
2349
2350 * systemd-networkd's bridge support learned a new setting
2351 VLANFiltering= for controlling VLAN filtering. Moreover a new section
2352 in .network files has been added for configuring VLAN bridging in
2353 more detail: VLAN=, EgressUntagged=, PVID= in [BridgeVLAN].
2354
2355 * systemd-networkd's IPv6 Router Advertisement code now makes use of
2356 the DNSSL and RDNSS options. This means IPv6 DNS configuration may
2357 now be acquired without relying on DHCPv6. Two new options
2358 UseDomains= and UseDNS= have been added to configure this behaviour.
2359
2360 * systemd-networkd's IPv6AcceptRouterAdvertisements= option has been
2361 renamed IPv6AcceptRA=, without altering its behaviour. The old
2362 setting name remains available for compatibility reasons.
2363
2364 * The systemd-networkd VTI/VTI6 tunneling support gained new options
2365 Key=, InputKey= and OutputKey=.
2366
2367 * systemd-networkd gained support for VRF ("Virtual Routing Function")
2368 interface configuration.
2369
2370 * "systemctl edit" may now be used to create new unit files by
2371 specifying the --force switch.
2372
2373 * sd-event gained a new function sd_event_get_iteration() for
2374 requesting the current iteration counter of the event loop. It starts
2375 at zero and is increased by one with each event loop iteration.
2376
43a569a1
ZJS
2377 * A new rpm macro %systemd_ordering is provided by the macros.systemd
2378 file. It can be used in lieu of %systemd_requires in packages which
2379 don't use any systemd functionality and are intended to be installed
2380 in minimal containers without systemd present. This macro provides
ce830873 2381 ordering dependencies to ensure that if the package is installed in
43a569a1
ZJS
2382 the same rpm transaction as systemd, systemd will be installed before
2383 the scriptlets for the package are executed, allowing unit presets
2384 to be handled.
2385
2386 New macros %_systemdgeneratordir and %_systemdusergeneratordir have
2387 been added to simplify packaging of generators.
2388
2389 * The os-release file gained VERSION_CODENAME field for the
2390 distribution nickname (e.g. VERSION_CODENAME=woody).
2391
2392 * New udev property UDEV_DISABLE_PERSISTENT_STORAGE_RULES_FLAG=1
2393 can be set to disable parsing of metadata and the creation
2394 of persistent symlinks for that device.
2395
0f1da52b
LP
2396 * The v230 change to tag framebuffer devices (/dev/fb*) with "uaccess"
2397 to make them available to logged-in users has been reverted.
2398
2399 * Much of the common code of the various systemd components is now
2400 built into an internal shared library libsystemd-shared-231.so
2401 (incorporating the systemd version number in the name, to be updated
2402 with future releases) that the components link to. This should
2403 decrease systemd footprint both in memory during runtime and on
2404 disk. Note that the shared library is not for public use, and is
ead6bd25 2405 neither API nor ABI stable, but is likely to change with every new
1ecbf32f
ZJS
2406 released update. Packagers need to make sure that binaries
2407 linking to libsystemd-shared.so are updated in step with the
2408 library.
43a569a1 2409
fcd30826
LP
2410 * Configuration for "mkosi" is now part of the systemd
2411 repository. mkosi is a tool to easily build legacy-free OS images,
2412 and is available on github: https://github.com/systemd/mkosi. If
2413 "mkosi" is invoked in the build tree a new raw OS image is generated
2414 incorporating the systemd sources currently being worked on and a
2415 clean, fresh distribution installation. The generated OS image may be
ce830873 2416 booted up with "systemd-nspawn -b -i", qemu-kvm or on any physical
fcd30826
LP
2417 UEFI PC. This functionality is particularly useful to easily test
2418 local changes made to systemd in a pristine, defined environment. See
f09eb768 2419 doc/HACKING for details.
ceeddf79 2420
4ffe2479
ZJS
2421 * configure learned the --with-support-url= option to specify the
2422 distribution's bugtracker.
2423
38b383d9
LP
2424 Contributions from: Alban Crequy, Alessandro Puccetti, Alessio Igor
2425 Bogani, Alexander Kuleshov, Alexander Kurtz, Alex Gaynor, Andika
2426 Triwidada, Andreas Pokorny, Andreas Rammhold, Andrew Jeddeloh, Ansgar
2427 Burchardt, Atrotors, Benjamin Drung, Brian Boylston, Christian Hesse,
2428 Christian Rebischke, Daniele Medri, Daniel Mack, Dave Reisner, David
2429 Herrmann, David Michael, Djalal Harouni, Douglas Christman, Elias
2430 Probst, Evgeny Vereshchagin, Federico Mena Quintero, Felipe Sateler,
2431 Franck Bui, Harald Hoyer, Ian Lee, Ivan Shapovalov, Jakub Wilk, Jan
2432 Janssen, Jean-Sébastien Bour, John Paul Adrian Glaubitz, Jouke
2433 Witteveen, Kai Ruhnau, kpengboy, Kyle Walker, Lénaïc Huard, Lennart
2434 Poettering, Luca Bruno, Lukas Lösche, Lukáš Nykrýn, mahkoh, Marcel
2435 Holtmann, Martin Pitt, Marty Plummer, Matthieu Codron, Max Prokhorov,
2436 Michael Biebl, Michael Karcher, Michael Olbrich, Michał Bartoszkiewicz,
2437 Michal Sekletar, Michal Soltys, Minkyung, Muhammet Kara, mulkieran,
2438 Otto Wallenius, Pablo Lezaeta Reyes, Peter Hutterer, Ronny Chevalier,
2439 Rusty Bird, Stef Walter, Susant Sahani, Tejun Heo, Thomas Blume, Thomas
771de3f5
ZJS
2440 Haller, Thomas H. P. Andersen, Tobias Jungel, Tom Gundersen, Tom Yan,
2441 Topi Miettinen, Torstein Husebø, Valentin Vidić, Viktar Vaŭčkievič,
38b383d9 2442 WaLyong Cho, Weng Xuetian, Werner Fink, Zbigniew Jędrzejewski-Szmek
5cd118ba 2443
38b383d9 2444 — Berlin, 2016-07-25
5cd118ba 2445
46e40fab 2446CHANGES WITH 230:
7f6e8043 2447
61ecb465
LP
2448 * DNSSEC is now turned on by default in systemd-resolved (in
2449 "allow-downgrade" mode), but may be turned off during compile time by
2450 passing "--with-default-dnssec=no" to "configure" (and of course,
2451 during runtime with DNSSEC= in resolved.conf). We recommend
2452 downstreams to leave this on at least during development cycles and
2453 report any issues with the DNSSEC logic upstream. We are very
2454 interested in collecting feedback about the DNSSEC validator and its
2455 limitations in the wild. Note however, that DNSSEC support is
2456 probably nothing downstreams should turn on in stable distros just
96d49011 2457 yet, as it might create incompatibilities with a few DNS servers and
61ecb465
LP
2458 networks. We tried hard to make sure we downgrade to non-DNSSEC mode
2459 automatically whenever we detect such incompatible setups, but there
2460 might be systems we do not cover yet. Hence: please help us testing
2461 the DNSSEC code, leave this on where you can, report back, but then
2462 again don't consider turning this on in your stable, LTS or
e40a326c
LP
2463 production release just yet. (Note that you have to enable
2464 nss-resolve in /etc/nsswitch.conf, to actually use systemd-resolved
2465 and its DNSSEC mode for host name resolution from local
2466 applications.)
61ecb465 2467
96515dbf 2468 * systemd-resolve conveniently resolves DANE records with the --tlsa
e40a326c 2469 option and OPENPGPKEY records with the --openpgp option. It also
e75690c3 2470 supports dumping raw DNS record data via the new --raw= switch.
96515dbf 2471
97e5530c
ZJS
2472 * systemd-logind will now by default terminate user processes that are
2473 part of the user session scope unit (session-XX.scope) when the user
977f2bea 2474 logs out. This behavior is controlled by the KillUserProcesses=
e40a326c
LP
2475 setting in logind.conf, and the previous default of "no" is now
2476 changed to "yes". This means that user sessions will be properly
2477 cleaned up after, but additional steps are necessary to allow
2478 intentionally long-running processes to survive logout.
97e5530c
ZJS
2479
2480 While the user is logged in at least once, user@.service is running,
2481 and any service that should survive the end of any individual login
2482 session can be started at a user service or scope using systemd-run.
e40a326c 2483 systemd-run(1) man page has been extended with an example which shows
8951eaec 2484 how to run screen in a scope unit underneath user@.service. The same
e40a326c 2485 command works for tmux.
97e5530c
ZJS
2486
2487 After the user logs out of all sessions, user@.service will be
2488 terminated too, by default, unless the user has "lingering" enabled.
2489 To effectively allow users to run long-term tasks even if they are
152199f2
ZJS
2490 logged out, lingering must be enabled for them. See loginctl(1) for
2491 details. The default polkit policy was modified to allow users to
2492 set lingering for themselves without authentication.
7f6e8043 2493
95365a57 2494 Previous defaults can be restored at compile time by the
e40a326c 2495 --without-kill-user-processes option to "configure".
7f6e8043 2496
e75690c3
ZJS
2497 * systemd-logind gained new configuration settings SessionsMax= and
2498 InhibitorsMax=, both with a default of 8192. It will not register new
188d3082 2499 user sessions or inhibitors above this limit.
e75690c3
ZJS
2500
2501 * systemd-logind will now reload configuration on SIGHUP.
2502
96515dbf 2503 * The unified cgroup hierarchy added in Linux 4.5 is now supported.
e40a326c 2504 Use systemd.unified_cgroup_hierarchy=1 on the kernel command line to
25b0e6cb
LP
2505 enable. Also, support for the "io" cgroup controller in the unified
2506 hierarchy has been added, so that the "memory", "pids" and "io" are
2507 now the controllers that are supported on the unified hierarchy.
e40a326c 2508
96515dbf
ZJS
2509 WARNING: it is not possible to use previous systemd versions with
2510 systemd.unified_cgroup_hierarchy=1 and the new kernel. Therefore it
2511 is necessary to also update systemd in the initramfs if using the
e40a326c 2512 unified hierarchy. An updated SELinux policy is also required.
96515dbf 2513
e40a326c
LP
2514 * LLDP support has been extended, and both passive (receive-only) and
2515 active (sender) modes are supported. Passive mode ("routers-only") is
8951eaec
ZJS
2516 enabled by default in systemd-networkd. Active LLDP mode is enabled
2517 by default for containers on the internal network. The "networkctl
e40a326c
LP
2518 lldp" command may be used to list information gathered. "networkctl
2519 status" will also show basic LLDP information on connected peers now.
96515dbf 2520
e40a326c
LP
2521 * The IAID and DUID unique identifier sent in DHCP requests may now be
2522 configured for the system and each .network file managed by
e75690c3
ZJS
2523 systemd-networkd using the DUIDType=, DUIDRawData=, IAID= options.
2524
2525 * systemd-networkd gained support for configuring proxy ARP support for
2526 each interface, via the ProxyArp= setting in .network files. It also
2527 gained support for configuring the multicast querier feature of
2528 bridge devices, via the new MulticastQuerier= setting in .netdev
2529 files. Similarly, snooping on the IGMP traffic can be controlled
2530 via the new setting MulticastSnooping=.
2531
2532 A new setting PreferredLifetime= has been added for addresses
2533 configured in .network file to configure the lifetime intended for an
2534 address.
2535
2536 The systemd-networkd DHCP server gained the option EmitRouter=, which
2537 defaults to yes, to configure whether the DHCP Option 3 (Router)
2538 should be emitted.
96515dbf 2539
e40a326c 2540 * The testing tool /usr/lib/systemd/systemd-activate is renamed to
97e5530c
ZJS
2541 systemd-socket-activate and installed into /usr/bin. It is now fully
2542 supported.
2543
e40a326c
LP
2544 * systemd-journald now uses separate threads to flush changes to disk
2545 when closing journal files, thus reducing impact of slow disk I/O on
2546 logging performance.
96515dbf 2547
e75690c3
ZJS
2548 * The sd-journal API gained two new calls
2549 sd_journal_open_directory_fd() and sd_journal_open_files_fd() which
2550 can be used to open journal files using file descriptors instead of
2551 file or directory paths. sd_journal_open_container() has been
2552 deprecated, sd_journal_open_directory_fd() should be used instead
2553 with the flag SD_JOURNAL_OS_ROOT.
2554
2555 * journalctl learned a new output mode "-o short-unix" that outputs log
2556 lines prefixed by their UNIX time (i.e. seconds since Jan 1st, 1970
2557 UTC). It also gained support for a new --no-hostname setting to
2558 suppress the hostname column in the family of "short" output modes.
2559
e40a326c
LP
2560 * systemd-ask-password now optionally skips printing of the password to
2561 stdout with --no-output which can be useful in scripts.
96515dbf
ZJS
2562
2563 * Framebuffer devices (/dev/fb*) and 3D printers and scanners
2564 (devices tagged with ID_MAKER_TOOL) are now tagged with
2565 "uaccess" and are available to logged in users.
2566
e75690c3 2567 * The DeviceAllow= unit setting now supports specifiers (with "%").
e40a326c
LP
2568
2569 * "systemctl show" gained a new --value switch, which allows print a
2570 only the contents of a specific unit property, without also printing
8951eaec
ZJS
2571 the property's name. Similar support was added to "show*" verbs
2572 of loginctl and machinectl that output "key=value" lists.
e40a326c 2573
e75690c3
ZJS
2574 * A new unit type "generated" was added for files dynamically generated
2575 by generator tools. Similarly, a new unit type "transient" is used
2576 for unit files created using the runtime API. "systemctl enable" will
2577 refuse to operate on such files.
2578
e40a326c
LP
2579 * A new command "systemctl revert" has been added that may be used to
2580 revert to the vendor version of a unit file, in case local changes
2581 have been made by adding drop-ins or overriding the unit file.
2582
2583 * "machinectl clean" gained a new verb to automatically remove all or
2584 just hidden container images.
2585
e40a326c
LP
2586 * systemd-tmpfiles gained support for a new line type "e" for emptying
2587 directories, if they exist, without creating them if they don't.
2588
e40a326c
LP
2589 * systemd-nspawn gained support for automatically patching the UID/GIDs
2590 of the owners and the ACLs of all files and directories in a
2591 container tree to match the UID/GID user namespacing range selected
2592 for the container invocation. This mode is enabled via the new
24597ee0
ZJS
2593 --private-users-chown switch. It also gained support for
2594 automatically choosing a free, previously unused UID/GID range when
2595 starting a container, via the new --private-users=pick setting (which
2596 implies --private-users-chown). Together, these options for the first
2597 time make user namespacing for nspawn containers fully automatic and
2598 thus deployable. The systemd-nspawn@.service template unit file has
2599 been changed to use this functionality by default.
e40a326c 2600
25b0e6cb
LP
2601 * systemd-nspawn gained a new --network-zone= switch, that allows
2602 creating ad-hoc virtual Ethernet links between multiple containers,
2603 that only exist as long as at least one container referencing them is
2604 running. This allows easy connecting of multiple containers with a
2605 common link that implements an Ethernet broadcast domain. Each of
2606 these network "zones" may be named relatively freely by the user, and
2607 may be referenced by any number of containers, but each container may
2608 only reference one of these "zones". On the lower level, this is
2609 implemented by an automatically managed bridge network interface for
2610 each zone, that is created when the first container referencing its
2611 zone is created and removed when the last one referencing its zone
2612 terminates.
2613
e40a326c 2614 * The default start timeout may now be configured on the kernel command
8951eaec
ZJS
2615 line via systemd.default_timeout_start_sec=. It was already
2616 configurable via the DefaultTimeoutStartSec= option in
2617 /etc/systemd/system.conf.
e40a326c 2618
030bd839 2619 * Socket units gained a new TriggerLimitIntervalSec= and
e40a326c
LP
2620 TriggerLimitBurst= setting to configure a limit on the activation
2621 rate of the socket unit.
2622
2623 * The LimitNICE= setting now optionally takes normal UNIX nice values
2624 in addition to the raw integer limit value. If the specified
2625 parameter is prefixed with "+" or "-" and is in the range -20..19 the
2626 value is understood as UNIX nice value. If not prefixed like this it
2627 is understood as raw RLIMIT_NICE limit.
2628
999a43f8
LP
2629 * Note that the effect of the PrivateDevices= unit file setting changed
2630 slightly with this release: the per-device /dev file system will be
2631 mounted read-only from this version on, and will have "noexec"
188d3082 2632 set. This (minor) change of behavior might cause some (exceptional)
999a43f8
LP
2633 legacy software to break, when PrivateDevices=yes is set for its
2634 service. Please leave PrivateDevices= off if you run into problems
2635 with this.
2636
e75690c3
ZJS
2637 * systemd-bootchart has been split out to a separate repository:
2638 https://github.com/systemd/systemd-bootchart
2639
2640 * systemd-bus-proxyd has been removed, as kdbus is unlikely to still be
2641 merged into the kernel in its current form.
2642
2643 * The compatibility libraries libsystemd-daemon.so,
2644 libsystemd-journal.so, libsystemd-id128.so, and libsystemd-login.so
2645 which have been deprecated since systemd-209 have been removed along
2646 with the corresponding pkg-config files. All symbols provided by
2647 those libraries are provided by libsystemd.so.
2648
2649 * The Capabilities= unit file setting has been removed (it is ignored
2650 for backwards compatibility). AmbientCapabilities= and
2651 CapabilityBoundingSet= should be used instead.
2652
4f9020fa
DR
2653 * A new special target has been added, initrd-root-device.target,
2654 which creates a synchronization point for dependencies of the root
2655 device in early userspace. Initramfs builders must ensure that this
2656 target is now included in early userspace.
2657
e75690c3
ZJS
2658 Contributions from: Alban Crequy, Alexander Kuleshov, Alexander Shopov,
2659 Alex Crawford, Andre Klärner, Andrew Eikum, Beniamino Galvani, Benjamin
2660 Robin, Biao Lu, Bjørnar Ness, Calvin Owens, Christian Hesse, Clemens
2661 Gruber, Colin Guthrie, Daniel Drake, Daniele Medri, Daniel J Walsh,
2662 Daniel Mack, Dan Nicholson, daurnimator, David Herrmann, David
2663 R. Hedges, Elias Probst, Emmanuel Gil Peyrot, EMOziko, Evgeny
2664 Vereshchagin, Federico, Felipe Sateler, Filipe Brandenburger, Franck
2665 Bui, frankheckenbach, gdamjan, Georgia Brikis, Harald Hoyer, Hendrik
77ff6022
CG
2666 Brueckner, Hristo Venev, Iago López Galeiras, Ian Kelling, Ismo
2667 Puustinen, Jakub Wilk, Jaroslav Škarvada, Jeff Huang, Joel Holdsworth,
e75690c3
ZJS
2668 John Paul Adrian Glaubitz, Jonathan Boulle, kayrus, Klearchos
2669 Chaloulos, Kyle Russell, Lars Uebernickel, Lennart Poettering, Lubomir
2670 Rintel, Lukáš Nykrýn, Mantas Mikulėnas, Marcel Holtmann, Martin Pitt,
77ff6022
CG
2671 Michael Biebl, michaelolbrich, Michał Bartoszkiewicz, Michal Koutný,
2672 Michal Sekletar, Mike Frysinger, Mike Gilbert, Mingcong Bai, Ming Lin,
2673 mulkieran, muzena, Nalin Dahyabhai, Naohiro Aota, Nathan McSween,
e75690c3
ZJS
2674 Nicolas Braud-Santoni, Patrik Flykt, Peter Hutterer, Peter Mattern,
2675 Petr Lautrbach, Petros Angelatos, Piotr Drąg, Rabin Vincent, Robert
2676 Węcławski, Ronny Chevalier, Samuel Tardieu, Stefan Saraev, Stefan
2677 Schallenberg aka nafets227, Steven Siloti, Susant Sahani, Sylvain
2678 Plantefève, Taylor Smock, Tejun Heo, Thomas Blume, Thomas Haller,
2679 Thomas H. P. Andersen, Tobias Klauser, Tom Gundersen, topimiettinen,
46e40fab
ZJS
2680 Torstein Husebø, Umut Tezduyar Lindskog, Uwe Kleine-König, Victor Toso,
2681 Vinay Kulkarni, Vito Caputo, Vittorio G (VittGam), Vladimir Panteleev,
2682 Wieland Hoffmann, Wouter Verhelst, Yu Watanabe, Zbigniew
2683 Jędrzejewski-Szmek
e40a326c 2684
46e40fab 2685 — Fairfax, 2016-05-21
96515dbf 2686
61f32bff
MP
2687CHANGES WITH 229:
2688
d5f8b295
LP
2689 * The systemd-resolved DNS resolver service has gained a substantial
2690 set of new features, most prominently it may now act as a DNSSEC
2691 validating stub resolver. DNSSEC mode is currently turned off by
ed5f8840
ZJS
2692 default, but is expected to be turned on by default in one of the
2693 next releases. For now, we invite everybody to test the DNSSEC logic
2694 by setting DNSSEC=allow-downgrade in /etc/systemd/resolved.conf. The
2695 service also gained a full set of D-Bus interfaces, including calls
2696 to configure DNS and DNSSEC settings per link (for use by external
2697 network management software). systemd-resolved and systemd-networkd
2698 now distinguish between "search" and "routing" domains. The former
2699 are used to qualify single-label names, the latter are used purely
2700 for routing lookups within certain domains to specific links.
2701 resolved now also synthesizes RRs for all entries from /etc/hosts.
d5f8b295
LP
2702
2703 * The systemd-resolve tool (which is a client utility for
ed5f8840
ZJS
2704 systemd-resolved) has been improved considerably and is now fully
2705 supported and documented. Hence it has moved from /usr/lib/systemd to
2706 /usr/bin.
d5f8b295
LP
2707
2708 * /dev/disk/by-path/ symlink support has been (re-)added for virtio
2709 devices.
2710
a7c723c0
LP
2711 * The coredump collection logic has been reworked: when a coredump is
2712 collected it is now written to disk, compressed and processed
2713 (including stacktrace extraction) from a new instantiated service
2714 systemd-coredump@.service, instead of directly from the
2715 /proc/sys/kernel/core_pattern hook we provide. This is beneficial as
2716 processing large coredumps can take up a substantial amount of
2717 resources and time, and this previously happened entirely outside of
2718 systemd's service supervision. With the new logic the core_pattern
2719 hook only does minimal metadata collection before passing off control
2720 to the new instantiated service, which is configured with a time
2721 limit, a nice level and other settings to minimize negative impact on
2722 the rest of the system. Also note that the new logic will honour the
2723 RLIMIT_CORE setting of the crashed process, which now allows users
2724 and processes to turn off coredumping for their processes by setting
2725 this limit.
2726
2727 * The RLIMIT_CORE resource limit now defaults to "unlimited" for PID 1
2728 and all forked processes by default. Previously, PID 1 would leave
2729 the setting at "0" for all processes, as set by the kernel. Note that
2730 the resource limit traditionally has no effect on the generated
2731 coredumps on the system if the /proc/sys/kernel/core_pattern hook
2732 logic is used. Since the limit is now honoured (see above) its
2733 default has been changed so that the coredumping logic is enabled by
2734 default for all processes, while allowing specific opt-out.
2735
2736 * When the stacktrace is extracted from processes of system users, this
2737 is now done as "systemd-coredump" user, in order to sandbox this
2738 potentially security sensitive parsing operation. (Note that when
2739 processing coredumps of normal users this is done under the user ID
2740 of process that crashed, as before.) Packagers should take notice
2741 that it is now necessary to create the "systemd-coredump" system user
2742 and group at package installation time.
2743
d5f8b295
LP
2744 * The systemd-activate socket activation testing tool gained support
2745 for SOCK_DGRAM and SOCK_SEQPACKET sockets using the new --datagram
2746 and --seqpacket switches. It also has been extended to support both
2747 new-style and inetd-style file descriptor passing. Use the new
2748 --inetd switch to request inetd-style file descriptor passing.
2749
8968aea0
MP
2750 * Most systemd tools now honor a new $SYSTEMD_COLORS environment
2751 variable, which takes a boolean value. If set to false, ANSI color
d5f8b295
LP
2752 output is disabled in the tools even when run on a terminal that
2753 supports it.
2754
2755 * The VXLAN support in networkd now supports two new settings
2756 DestinationPort= and PortRange=.
2757
2758 * A new systemd.machine_id= kernel command line switch has been added,
2759 that may be used to set the machine ID in /etc/machine-id if it is
2760 not initialized yet. This command line option has no effect if the
2761 file is already initialized.
2762
2763 * systemd-nspawn gained a new --as-pid2 switch that invokes any
2764 specified command line as PID 2 rather than PID 1 in the
ed5f8840
ZJS
2765 container. In this mode PID 1 is a minimal stub init process that
2766 implements the special POSIX and Linux semantics of PID 1 regarding
2767 signal and child process management. Note that this stub init process
2768 is implemented in nspawn itself and requires no support from the
2769 container image. This new logic is useful to support running
2770 arbitrary commands in the container, as normal processes are
d5f8b295
LP
2771 generally not prepared to run as PID 1.
2772
2773 * systemd-nspawn gained a new --chdir= switch for setting the current
2774 working directory for the process started in the container.
2775
ed5f8840
ZJS
2776 * "journalctl /dev/sda" will now output all kernel log messages for
2777 specified device from the current boot, in addition to all devices
2778 that are parents of it. This should make log output about devices
2779 pretty useful, as long as kernel drivers attach enough metadata to
2780 the log messages. (The usual SATA drivers do.)
d5f8b295
LP
2781
2782 * The sd-journal API gained two new calls
2783 sd_journal_has_runtime_files() and sd_journal_has_persistent_files()
2784 that report whether log data from /run or /var has been found.
2785
2786 * journalctl gained a new switch "--fields" that prints all journal
2787 record field names currently in use in the journal. This is backed
2788 by two new sd-journal API calls sd_journal_enumerate_fields() and
2789 sd_journal_restart_fields().
2790
2791 * Most configurable timeouts in systemd now expect an argument of
8968aea0
MP
2792 "infinity" to turn them off, instead of "0" as before. The semantics
2793 from now on is that a timeout of "0" means "now", and "infinity"
2794 means "never". To maintain backwards compatibility, "0" continues to
2795 turn off previously existing timeout settings.
d5f8b295
LP
2796
2797 * "systemctl reload-or-try-restart" has been renamed to "systemctl
8968aea0
MP
2798 try-reload-or-restart" to clarify what it actually does: the "try"
2799 logic applies to both reloading and restarting, not just restarting.
2800 The old name continues to be accepted for compatibility.
2801
2802 * On boot-up, when PID 1 detects that the system clock is behind the
2803 release date of the systemd version in use, the clock is now set
2804 to the latter. Previously, this was already done in timesyncd, in order
d5f8b295
LP
2805 to avoid running with clocks set to the various clock epochs such as
2806 1902, 1938 or 1970. With this change the logic is now done in PID 1
2807 in addition to timesyncd during early boot-up, so that it is enforced
2808 before the first process is spawned by systemd. Note that the logic
2809 in timesyncd remains, as it is more comprehensive and ensures
ed5f8840 2810 clock monotonicity by maintaining a persistent timestamp file in
d5f8b295
LP
2811 /var. Since /var is generally not available in earliest boot or the
2812 initrd, this part of the logic remains in timesyncd, and is not done
2813 by PID 1.
2814
50f48ad3
DM
2815 * Support for tweaking details in net_cls.class_id through the
2816 NetClass= configuration directive has been removed, as the kernel
2817 people have decided to deprecate that controller in cgroup v2.
2818 Userspace tools such as nftables are moving over to setting rules
2819 that are specific to the full cgroup path of a task, which obsoletes
2820 these controllers anyway. The NetClass= directive is kept around for
2821 legacy compatibility reasons. For a more in-depth description of the
2822 kernel change, please refer to the respective upstream commit:
2823
2824 https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=bd1060a1d671
2825
d5f8b295 2826 * A new service setting RuntimeMaxSec= has been added that may be used
8968aea0 2827 to specify a maximum runtime for a service. If the timeout is hit, the
d5f8b295
LP
2828 service is terminated and put into a failure state.
2829
8968aea0
MP
2830 * A new service setting AmbientCapabilities= has been added. It allows
2831 configuration of additional Linux process capabilities that are
2832 passed to the activated processes. This is only available on very
d5f8b295
LP
2833 recent kernels.
2834
2835 * The process resource limit settings in service units may now be used
2836 to configure hard and soft limits individually.
2837
8968aea0 2838 * The various libsystemd APIs such as sd-bus or sd-event now publicly
ed5f8840
ZJS
2839 expose support for gcc's __attribute__((cleanup())) C extension.
2840 Specifically, for many object destructor functions alternative
2841 versions have been added that have names suffixed with "p" and take a
2842 pointer to a pointer to the object to destroy, instead of just a
2843 pointer to the object itself. This is useful because these destructor
2844 functions may be used directly as parameters to the cleanup
2845 construct. Internally, systemd has been a heavy user of this GCC
2846 extension for a long time, and with this change similar support is
2847 now available to consumers of the library outside of systemd. Note
8968aea0 2848 that by using this extension in your sources compatibility with old
ed5f8840
ZJS
2849 and strictly ANSI compatible C compilers is lost. However, all gcc or
2850 LLVM versions of recent years support this extension.
d5f8b295
LP
2851
2852 * Timer units gained support for a new setting RandomizedDelaySec= that
8968aea0
MP
2853 allows configuring some additional randomized delay to the configured
2854 time. This is useful to spread out timer events to avoid load peaks in
2855 clusters or larger setups.
d5f8b295
LP
2856
2857 * Calendar time specifications now support sub-second accuracy.
2858
2859 * Socket units now support listening on SCTP and UDP-lite protocol
2860 sockets.
2861
2862 * The sd-event API now comes with a full set of man pages.
2863
2864 * Older versions of systemd contained experimental support for
2865 compressing journal files and coredumps with the LZ4 compressor that
2866 was not compatible with the lz4 binary (due to API limitations of the
2867 lz4 library). This support has been removed; only support for files
2868 compatible with the lz4 binary remains. This LZ4 logic is now
2869 officially supported and no longer considered experimental.
2870
2871 * The dkr image import logic has been removed again from importd. dkr's
2872 micro-services focus doesn't fit into the machine image focus of
2873 importd, and quickly got out of date with the upstream dkr API.
2874
2875 * Creation of the /run/lock/lockdev/ directory was dropped from
2876 tmpfiles.d/legacy.conf. Better locking mechanisms like flock() have
61f32bff
MP
2877 been available for many years. If you still need this, you need to
2878 create your own tmpfiles.d config file with:
d5f8b295
LP
2879
2880 d /run/lock/lockdev 0775 root lock -
61f32bff 2881
dd95b381
LP
2882 * The settings StartLimitBurst=, StartLimitInterval=, StartLimitAction=
2883 and RebootArgument= have been moved from the [Service] section of
2884 unit files to [Unit], and they are now supported on all unit types,
2885 not just service units. Of course, systemd will continue to
2886 understand these settings also at the old location, in order to
2887 maintain compatibility.
2888
3545ab35
LP
2889 Contributions from: Abdo Roig-Maranges, Alban Crequy, Aleksander
2890 Adamowski, Alexander Kuleshov, Andreas Pokorny, Andrei Borzenkov,
2891 Andrew Wilcox, Arthur Clement, Beniamino Galvani, Casey Schaufler,
2892 Chris Atkinson, Chris Mayo, Christian Hesse, Damjan Georgievski, Dan
2893 Dedrick, Daniele Medri, Daniel J Walsh, Daniel Korostil, Daniel Mack,
2894 David Herrmann, Dimitri John Ledkov, Dominik Hannen, Douglas Christman,
2895 Evgeny Vereshchagin, Filipe Brandenburger, Franck Bui, Gabor Kelemen,
2896 Harald Hoyer, Hayden Walles, Helmut Grohne, Henrik Kaare Poulsen,
2897 Hristo Venev, Hui Wang, Indrajit Raychaudhuri, Ismo Puustinen, Jakub
2898 Wilk, Jan Alexander Steffens (heftig), Jan Engelhardt, Jan Synacek,
2899 Joost Bremmer, Jorgen Schaefer, Karel Zak, Klearchos Chaloulos,
2900 lc85446, Lennart Poettering, Lukas Nykryn, Mantas Mikulėnas, Marcel
2901 Holtmann, Martin Pitt, Michael Biebl, Michael Olbrich, Michael Scherer,
2902 Michał Górny, Michal Sekletar, Nicolas Cornu, Nicolas Iooss, Nils
2903 Carlson, nmartensen, nnz1024, Patrick Ohly, Peter Hutterer, Phillip Sz,
2904 Ronny Chevalier, Samu Kallio, Shawn Landden, Stef Walter, Susant
2905 Sahani, Sylvain Plantefève, Tadej Janež, Thomas Hindoe Paaboel
2906 Andersen, Tom Gundersen, Torstein Husebø, Umut Tezduyar Lindskog, Vito
2907 Caputo, WaLyong Cho, Yu Watanabe, Zbigniew Jędrzejewski-Szmek
2908
ccddd104 2909 — Berlin, 2016-02-11
61f32bff 2910
a11c7ea5
LP
2911CHANGES WITH 228:
2912
a11c7ea5
LP
2913 * A number of properties previously only settable in unit
2914 files are now also available as properties to set when
2915 creating transient units programmatically via the bus, as it
2916 is exposed with systemd-run's --property=
2917 setting. Specifically, these are: SyslogIdentifier=,
2918 SyslogLevelPrefix=, TimerSlackNSec=, OOMScoreAdjust=,
2919 EnvironmentFile=, ReadWriteDirectories=,
2920 ReadOnlyDirectories=, InaccessibleDirectories=,
2921 ProtectSystem=, ProtectHome=, RuntimeDirectory=.
2922
28c85daf
LP
2923 * When creating transient services via the bus API it is now
2924 possible to pass in a set of file descriptors to use as
2925 STDIN/STDOUT/STDERR for the invoked process.
a11c7ea5 2926
f1f8a5a5
LP
2927 * Slice units may now be created transiently via the bus APIs,
2928 similar to the way service and scope units may already be
2929 created transiently.
2930
a11c7ea5
LP
2931 * Wherever systemd expects a calendar timestamp specification
2932 (like in journalctl's --since= and --until= switches) UTC
2933 timestamps are now supported. Timestamps suffixed with "UTC"
2934 are now considered to be in Universal Time Coordinated
2935 instead of the local timezone. Also, timestamps may now
815bb5bd 2936 optionally be specified with sub-second accuracy. Both of
a11c7ea5
LP
2937 these additions also apply to recurring calendar event
2938 specification, such as OnCalendar= in timer units.
2939
28c85daf
LP
2940 * journalctl gained a new "--sync" switch that asks the
2941 journal daemon to write all so far unwritten log messages to
2942 disk and sync the files, before returning.
2943
a11c7ea5
LP
2944 * systemd-tmpfiles learned two new line types "q" and "Q" that
2945 operate like "v", but also set up a basic btrfs quota
2946 hierarchy when used on a btrfs file system with quota
2947 enabled.
2948
f1f8a5a5
LP
2949 * tmpfiles' "v", "q" and "Q" will now create a plain directory
2950 instead of a subvolume (even on a btrfs file system) if the
2951 root directory is a plain directory, and not a
2952 subvolume. This should simplify things with certain chroot()
2953 environments which are not aware of the concept of btrfs
2954 subvolumes.
2955
a11c7ea5
LP
2956 * systemd-detect-virt gained a new --chroot switch to detect
2957 whether execution takes place in a chroot() environment.
2958
28c85daf 2959 * CPUAffinity= now takes CPU index ranges in addition to
a11c7ea5
LP
2960 individual indexes.
2961
28c85daf
LP
2962 * The various memory-related resource limit settings (such as
2963 LimitAS=) now understand the usual K, M, G, ... suffixes to
2964 the base of 1024 (IEC). Similar, the time-related resource
2965 limit settings understand the usual min, h, day, ...
2966 suffixes now.
2967
f1f8a5a5
LP
2968 * There's a new system.conf setting DefaultTasksMax= to
2969 control the default TasksMax= setting for services and
2970 scopes running on the system. (TasksMax= is the primary
2971 setting that exposes the "pids" cgroup controller on systemd
2972 and was introduced in the previous systemd release.) The
2973 setting now defaults to 512, which means services that are
2974 not explicitly configured otherwise will only be able to
2975 create 512 processes or threads at maximum, from this
2976 version on. Note that this means that thread- or
2977 process-heavy services might need to be reconfigured to set
2978 TasksMax= to a higher value. It is sufficient to set
2979 TasksMax= in these specific unit files to a higher value, or
2980 even "infinity". Similar, there's now a logind.conf setting
2981 UserTasksMax= that defaults to 4096 and limits the total
2982 number of processes or tasks each user may own
2983 concurrently. nspawn containers also have the TasksMax=
2984 value set by default now, to 8192. Note that all of this
2985 only has an effect if the "pids" cgroup controller is
2986 enabled in the kernel. The general benefit of these changes
2987 should be a more robust and safer system, that provides a
2988 certain amount of per-service fork() bomb protection.
2989
28c85daf
LP
2990 * systemd-nspawn gained the new --network-veth-extra= switch
2991 to define additional and arbitrarily-named virtual Ethernet
2992 links between the host and the container.
2993
2994 * A new service execution setting PassEnvironment= has been
2995 added that allows importing select environment variables
2996 from PID1's environment block into the environment block of
2997 the service.
2998
ddb4b0d3 2999 * Timer units gained support for a new RemainAfterElapse=
595bfe7d 3000 setting which takes a boolean argument. It defaults to on,
ddb4b0d3
LP
3001 exposing behaviour unchanged to previous releases. If set to
3002 off, timer units are unloaded after they elapsed if they
3003 cannot elapse again. This is particularly useful for
3004 transient timer units, which shall not stay around longer
3005 than until they first elapse.
3006
a11c7ea5 3007 * systemd will now bump the net.unix.max_dgram_qlen to 512 by
28c85daf
LP
3008 default now (the kernel default is 16). This is beneficial
3009 for avoiding blocking on AF_UNIX/SOCK_DGRAM sockets since it
a11c7ea5
LP
3010 allows substantially larger numbers of queued
3011 datagrams. This should increase the capability of systemd to
3012 parallelize boot-up, as logging and sd_notify() are unlikely
3013 to stall execution anymore. If you need to change the value
3014 from the new defaults, use the usual sysctl.d/ snippets.
3015
28c85daf
LP
3016 * The compression framing format used by the journal or
3017 coredump processing has changed to be in line with what the
3018 official LZ4 tools generate. LZ4 compression support in
3019 systemd was considered unsupported previously, as the format
3020 was not compatible with the normal tools. With this release
3021 this has changed now, and it is hence safe for downstream
3022 distributions to turn it on. While not compressing as well
815bb5bd 3023 as the XZ, LZ4 is substantially faster, which makes
28c85daf
LP
3024 it a good default choice for the compression logic in the
3025 journal and in coredump handling.
a11c7ea5 3026
28c85daf
LP
3027 * Any reference to /etc/mtab has been dropped from
3028 systemd. The file has been obsolete since a while, but
3029 systemd refused to work on systems where it was incorrectly
815bb5bd 3030 set up (it should be a symlink or non-existent). Please make
28c85daf
LP
3031 sure to update to util-linux 2.27.1 or newer in conjunction
3032 with this systemd release, which also drops any reference to
3033 /etc/mtab. If you maintain a distribution make sure that no
3034 software you package still references it, as this is a
3035 likely source of bugs. There's also a glibc bug pending,
3036 asking for removal of any reference to this obsolete file:
3037
3038 https://sourceware.org/bugzilla/show_bug.cgi?id=19108
a11c7ea5 3039
d5bd92bb
LP
3040 Note that only util-linux versions built with
3041 --enable-libmount-force-mountinfo are supported.
3042
a11c7ea5
LP
3043 * Support for the ".snapshot" unit type has been removed. This
3044 feature turned out to be little useful and little used, and
3045 has now been removed from the core and from systemctl.
3046
b9e2f7eb
LP
3047 * The dependency types RequiresOverridable= and
3048 RequisiteOverridable= have been removed from systemd. They
3049 have been used only very sparingly to our knowledge and
3050 other options that provide a similar effect (such as
3051 systemctl --mode=ignore-dependencies) are much more useful
3052 and commonly used. Moreover, they were only half-way
3053 implemented as the option to control behaviour regarding
3054 these dependencies was never added to systemctl. By removing
3055 these dependency types the execution engine becomes a bit
3056 simpler. Unit files that use these dependencies should be
3057 changed to use the non-Overridable dependency types
3058 instead. In fact, when parsing unit files with these
3059 options, that's what systemd will automatically convert them
3060 too, but it will also warn, asking users to fix the unit
3061 files accordingly. Removal of these dependency types should
3062 only affect a negligible number of unit files in the wild.
3063
3064 * Behaviour of networkd's IPForward= option changed
3065 (again). It will no longer maintain a per-interface setting,
3066 but propagate one way from interfaces where this is enabled
3067 to the global kernel setting. The global setting will be
3068 enabled when requested by a network that is set up, but
3069 never be disabled again. This change was made to make sure
3070 IPv4 and IPv6 behaviour regarding packet forwarding is
3071 similar (as the Linux IPv6 stack does not support
3072 per-interface control of this setting) and to minimize
3073 surprises.
3074
28c85daf
LP
3075 * In unit files the behaviour of %u, %U, %h, %s has
3076 changed. These specifiers will now unconditionally resolve
3077 to the various user database fields of the user that the
3078 systemd instance is running as, instead of the user
3079 configured in the specific unit via User=. Note that this
3080 effectively doesn't change much, as resolving of these
3081 specifiers was already turned off in the --system instance
3082 of systemd, as we cannot do NSS lookups from PID 1. In the
3083 --user instance of systemd these specifiers where correctly
3084 resolved, but hardly made any sense, since the user instance
3085 lacks privileges to do user switches anyway, and User= is
ce830873 3086 hence useless. Moreover, even in the --user instance of
28c85daf
LP
3087 systemd behaviour was awkward as it would only take settings
3088 from User= assignment placed before the specifier into
3089 account. In order to unify and simplify the logic around
3090 this the specifiers will now always resolve to the
3091 credentials of the user invoking the manager (which in case
3092 of PID 1 is the root user).
3093
3094 Contributions from: Andrew Jones, Beniamino Galvani, Boyuan
3095 Yang, Daniel Machon, Daniel Mack, David Herrmann, David
3096 Reynolds, David Strauss, Dongsu Park, Evgeny Vereshchagin,
f1f8a5a5
LP
3097 Felipe Sateler, Filipe Brandenburger, Franck Bui, Hristo
3098 Venev, Iago López Galeiras, Jan Engelhardt, Jan Janssen, Jan
3099 Synacek, Jesus Ornelas Aguayo, Karel Zak, kayrus, Kay Sievers,
3100 Lennart Poettering, Liu Yuan Yuan, Mantas Mikulėnas, Marcel
3101 Holtmann, Marcin Bachry, Marcos Alano, Marcos Mello, Mark
3102 Theunissen, Martin Pitt, Michael Marineau, Michael Olbrich,
3103 Michal Schmidt, Michal Sekletar, Mirco Tischler, Nick Owens,
3104 Nicolas Cornu, Patrik Flykt, Peter Hutterer, reverendhomer,
3105 Ronny Chevalier, Sangjung Woo, Seong-ho Cho, Shawn Landden,
3106 Susant Sahani, Thomas Haller, Thomas Hindoe Paaboel Andersen,
3107 Tom Gundersen, Torstein Husebø, Vito Caputo, Zbigniew
3108 Jędrzejewski-Szmek
28c85daf 3109
ccddd104 3110 — Berlin, 2015-11-18
a11c7ea5 3111
c97e586d
DM
3112CHANGES WITH 227:
3113
3114 * systemd now depends on util-linux v2.27. More specifically,
3115 the newly added mount monitor feature in libmount now
3116 replaces systemd's former own implementation.
3117
3118 * libmount mandates /etc/mtab not to be regular file, and
3119 systemd now enforces this condition at early boot.
3120 /etc/mtab has been deprecated and warned about for a very
3121 long time, so systems running systemd should already have
3122 stopped having this file around as anything else than a
3123 symlink to /proc/self/mounts.
3124
d046fb93
LP
3125 * Support for the "pids" cgroup controller has been added. It
3126 allows accounting the number of tasks in a cgroup and
c97e586d
DM
3127 enforcing limits on it. This adds two new setting
3128 TasksAccounting= and TasksMax= to each unit, as well as a
6fd5517b 3129 global option DefaultTasksAccounting=.
c97e586d
DM
3130
3131 * Support for the "net_cls" cgroup controller has been added.
fe08a30b
LP
3132 It allows assigning a net class ID to each task in the
3133 cgroup, which can then be used in firewall rules and traffic
3134 shaping configurations. Note that the kernel netfilter net
3135 class code does not currently work reliably for ingress
3136 packets on unestablished sockets.
c97e586d
DM
3137
3138 This adds a new config directive called NetClass= to CGroup
6fd5517b 3139 enabled units. Allowed values are positive numbers for fixed
c97e586d
DM
3140 assignments and "auto" for picking a free value
3141 automatically.
3142
21d86c61
DM
3143 * 'systemctl is-system-running' now returns 'offline' if the
3144 system is not booted with systemd. This command can now be
3145 used as a substitute for 'systemd-notify --booted'.
3146
3147 * Watchdog timeouts have been increased to 3 minutes for all
3148 in-tree service files. Apparently, disk IO issues are more
3149 frequent than we hoped, and user reported >1 minute waiting
3150 for disk IO.
3151
3152 * 'machine-id-commit' functionality has been merged into
3153 'machine-id-setup --commit'. The separate binary has been
3154 removed.
3155
d046fb93
LP
3156 * The WorkingDirectory= directive in unit files may now be set
3157 to the special value '~'. In this case, the working
3158 directory is set to the home directory of the user
3159 configured in User=.
21d86c61 3160
fe08a30b
LP
3161 * "machinectl shell" will now open the shell in the home
3162 directory of the selected user by default.
3163
21d86c61 3164 * The CrashChVT= configuration file setting is renamed to
d046fb93
LP
3165 CrashChangeVT=, following our usual logic of not
3166 abbreviating unnecessarily. The old directive is still
3167 supported for compat reasons. Also, this directive now takes
3168 an integer value between 1 and 63, or a boolean value. The
3169 formerly supported '-1' value for disabling stays around for
3170 compat reasons.
21d86c61 3171
fe08a30b 3172 * The PrivateTmp=, PrivateDevices=, PrivateNetwork=,
8b5f9d15 3173 NoNewPrivileges=, TTYPath=, WorkingDirectory= and
fe08a30b
LP
3174 RootDirectory= properties can now be set for transient
3175 units.
3176
3177 * The systemd-analyze tool gained a new "set-log-target" verb
3178 to change the logging target the system manager logs to
3179 dynamically during runtime. This is similar to how
3180 "systemd-analyze set-log-level" already changes the log
3181 level.
3182
3183 * In nspawn /sys is now mounted as tmpfs, with only a selected
3184 set of subdirectories mounted in from the real sysfs. This
3185 enhances security slightly, and is useful for ensuring user
3186 namespaces work correctly.
3187
3188 * Support for USB FunctionFS activation has been added. This
3189 allows implementation of USB gadget services that are
3190 activated as soon as they are requested, so that they don't
595bfe7d 3191 have to run continuously, similar to classic socket
fe08a30b
LP
3192 activation.
3193
3194 * The "systemctl exit" command now optionally takes an
3195 additional parameter that sets the exit code to return from
3196 the systemd manager when exiting. This is only relevant when
3197 running the systemd user instance, or when running the
3198 system instance in a container.
3199
3200 * sd-bus gained the new API calls sd_bus_path_encode_many()
3201 and sd_bus_path_decode_many() that allow easy encoding and
3202 decoding of multiple identifier strings inside a D-Bus
3203 object path. Another new call sd_bus_default_flush_close()
3204 has been added to flush and close per-thread default
3205 connections.
3206
3207 * systemd-cgtop gained support for a -M/--machine= switch to
3208 show the control groups within a certain container only.
3209
3210 * "systemctl kill" gained support for an optional --fail
3211 switch. If specified the requested operation will fail of no
3212 processes have been killed, because the unit had no
3213 processes attached, or similar.
3214
bdba9227
DM
3215 * A new systemd.crash_reboot=1 kernel command line option has
3216 been added that triggers a reboot after crashing. This can
3217 also be set through CrashReboot= in systemd.conf.
3218
3219 * The RuntimeDirectory= setting now understands unit
3220 specifiers like %i or %f.
3221
ce830873 3222 * A new (still internal) library API sd-ipv4acd has been added,
fe08a30b
LP
3223 that implements address conflict detection for IPv4. It's
3224 based on code from sd-ipv4ll, and will be useful for
3225 detecting DHCP address conflicts.
3226
bdba9227
DM
3227 * File descriptors passed during socket activation may now be
3228 named. A new API sd_listen_fds_with_names() is added to
a8eaaee7 3229 access the names. The default names may be overridden,
bdba9227
DM
3230 either in the .socket file using the FileDescriptorName=
3231 parameter, or by passing FDNAME= when storing the file
3232 descriptors using sd_notify().
fe08a30b 3233
d046fb93
LP
3234 * systemd-networkd gained support for:
3235
0053598f 3236 - Setting the IPv6 Router Advertisement settings via
edf4126f 3237 IPv6AcceptRouterAdvertisements= in .network files.
d046fb93
LP
3238
3239 - Configuring the HelloTimeSec=, MaxAgeSec= and
3240 ForwardDelaySec= bridge parameters in .netdev files.
3241
3242 - Configuring PreferredSource= for static routes in
edf4126f 3243 .network files.
fe08a30b 3244
bdba9227
DM
3245 * The "ask-password" framework used to query for LUKS harddisk
3246 passwords or SSL passwords during boot gained support for
3247 caching passwords in the kernel keyring, if it is
3248 available. This makes sure that the user only has to type in
3249 a passphrase once if there are multiple objects to unlock
3250 with the same one. Previously, such password caching was
3251 available only when Plymouth was used; this moves the
3252 caching logic into the systemd codebase itself. The
3253 "systemd-ask-password" utility gained a new --keyname=
3254 switch to control which kernel keyring key to use for
3255 caching a password in. This functionality is also useful for
3256 enabling display managers such as gdm to automatically
3257 unlock the user's GNOME keyring if its passphrase, the
3258 user's password and the harddisk password are the same, if
3259 gdm-autologin is used.
fe08a30b
LP
3260
3261 * When downloading tar or raw images using "machinectl
3262 pull-tar" or "machinectl pull-raw", a matching ".nspawn"
3263 file is now also downloaded, if it is available and stored
3264 next to the image file.
c97e586d 3265
91d0d699
LP
3266 * Units of type ".socket" gained a new boolean setting
3267 Writable= which is only useful in conjunction with
3268 ListenSpecial=. If true, enables opening the specified
3269 special file in O_RDWR mode rather than O_RDONLY mode.
3270
3271 * systemd-rfkill has been reworked to become a singleton
3272 service that is activated through /dev/rfkill on each rfkill
3273 state change and saves the settings to disk. This way,
3274 systemd-rfkill is now compatible with devices that exist
3275 only intermittendly, and even restores state if the previous
3276 system shutdown was abrupt rather than clean.
3277
d046fb93
LP
3278 * The journal daemon gained support for vacuuming old journal
3279 files controlled by the number of files that shall remain,
3280 in addition to the already existing control by size and by
3281 date. This is useful as journal interleaving performance
6dd6a9c4 3282 degrades with too many separate journal files, and allows
d046fb93
LP
3283 putting an effective limit on them. The new setting defaults
3284 to 100, but this may be changed by setting SystemMaxFiles=
3285 and RuntimeMaxFiles= in journald.conf. Also, the
3286 "journalctl" tool gained the new --vacuum-files= switch to
3287 manually vacuum journal files to leave only the specified
3288 number of files in place.
c48eb61f 3289
bdba9227
DM
3290 * udev will now create /dev/disk/by-path links for ATA devices
3291 on kernels where that is supported.
c30f086f 3292
efce0ffe 3293 * Galician, Serbian, Turkish and Korean translations were added.
c97e586d 3294
61e6771c
LP
3295 Contributions from: Aaro Koskinen, Alban Crequy, Beniamino
3296 Galvani, Benjamin Robin, Branislav Blaskovic, Chen-Han Hsiao
3297 (Stanley), Daniel Buch, Daniel Machon, Daniel Mack, David
3298 Herrmann, David Milburn, doubleodoug, Evgeny Vereshchagin,
3299 Felipe Franciosi, Filipe Brandenburger, Fran Dieguez, Gabriel
3300 de Perthuis, Georg Müller, Hans de Goede, Hendrik Brueckner,
3301 Ivan Shapovalov, Jacob Keller, Jan Engelhardt, Jan Janssen,
3302 Jan Synacek, Jens Kuske, Karel Zak, Kay Sievers, Krzesimir
3303 Nowak, Krzysztof Kotlenga, Lars Uebernickel, Lennart
3304 Poettering, Lukas Nykryn, Łukasz Stelmach, Maciej Wereski,
3305 Marcel Holtmann, Marius Thesing, Martin Pitt, Michael Biebl,
3306 Michael Gebetsroither, Michal Schmidt, Michal Sekletar, Mike
3307 Gilbert, Muhammet Kara, nazgul77, Nicolas Cornu, NoXPhasma,
3308 Olof Johansson, Patrik Flykt, Pawel Szewczyk, reverendhomer,
3309 Ronny Chevalier, Sangjung Woo, Seong-ho Cho, Susant Sahani,
3310 Sylvain Plantefève, Thomas Haller, Thomas Hindoe Paaboel
3311 Andersen, Tom Gundersen, Tom Lyon, Viktar Vauchkevich,
3312 Zbigniew Jędrzejewski-Szmek, Марко М. Костић
3313
ccddd104 3314 — Berlin, 2015-10-07
c97e586d 3315
c9912c5e
DH
3316CHANGES WITH 226:
3317
5e8d4254
LP
3318 * The DHCP implementation of systemd-networkd gained a set of
3319 new features:
3320
3321 - The DHCP server now supports emitting DNS and NTP
3322 information. It may be enabled and configured via
3323 EmitDNS=, DNS=, EmitNTP=, and NTP=. If transmission of DNS
3324 and NTP information is enabled, but no servers are
3325 configured, the corresponding uplink information (if there
3326 is any) is propagated.
3327
3328 - Server and client now support transmission and reception
3329 of timezone information. It can be configured via the
3330 newly introduced network options UseTimezone=,
3331 EmitTimezone=, and Timezone=. Transmission of timezone
3332 information is enabled between host and containers by
3333 default now: the container will change its local timezone
3334 to what the host has set.
3335
3336 - Lease timeouts can now be configured via
3337 MaxLeaseTimeSec= and DefaultLeaseTimeSec=.
3338
3339 - The DHCP server improved on the stability of
3340 leases. Clients are more likely to get the same lease
3341 information back, even if the server loses state.
3342
3343 - The DHCP server supports two new configuration options to
3344 control the lease address pool metrics, PoolOffset= and
3345 PoolSize=.
3346
3347 * The encapsulation limit of tunnels in systemd-networkd may
3348 now be configured via 'EncapsulationLimit='. It allows
3349 modifying the maximum additional levels of encapsulation
3350 that are permitted to be prepended to a packet.
3351
3352 * systemd now supports the concept of user buses replacing
3353 session buses, if used with dbus-1.10 (and enabled via dbus
3354 --enable-user-session). It previously only supported this on
3355 kdbus-enabled systems, and this release expands this to
3356 'dbus-daemon' systems.
3357
3358 * systemd-networkd now supports predictable interface names
3359 for virtio devices.
3360
3361 * systemd now optionally supports the new Linux kernel
3362 "unified" control group hierarchy. If enabled via the kernel
3363 command-line option 'systemd.unified_cgroup_hierarchy=1',
3364 systemd will try to mount the unified cgroup hierarchy
3365 directly on /sys/fs/cgroup. If not enabled, or not
3366 available, systemd will fall back to the legacy cgroup
3367 hierarchy setup, as before. Host system and containers can
3368 mix and match legacy and unified hierarchies as they
856ca72b 3369 wish. nspawn understands the $UNIFIED_CGROUP_HIERARCHY
5e8d4254
LP
3370 environment variable to individually select the hierarchy to
3371 use for executed containers. By default, nspawn will use the
3372 unified hierarchy for the containers if the host uses the
3373 unified hierarchy, and the legacy hierarchy otherwise.
3374 Please note that at this point the unified hierarchy is an
3375 experimental kernel feature and is likely to change in one
3376 of the next kernel releases. Therefore, it should not be
3377 enabled by default in downstream distributions yet. The
3378 minimum required kernel version for the unified hierarchy to
3379 work is 4.2. Note that when the unified hierarchy is used
3380 for the first time delegated access to controllers is
3381 safe. Because of this systemd-nspawn containers will get
3382 access to controllers now, as will systemd user
3383 sessions. This means containers and user sessions may now
3384 manage their own resources, partitioning up what the system
3385 grants them.
3386
3387 * A new special scope unit "init.scope" has been introduced
3388 that encapsulates PID 1 of the system. It may be used to
3389 determine resource usage and enforce resource limits on PID
3390 1 itself. PID 1 hence moved out of the root of the control
3391 group tree.
3392
3393 * The cgtop tool gained support for filtering out kernel
3394 threads when counting tasks in a control group. Also, the
3395 count of processes is now recursively summed up by
3396 default. Two options -k and --recursive= have been added to
3397 revert to old behaviour. The tool has also been updated to
3398 work correctly in containers now.
3399
3400 * systemd-nspawn's --bind= and --bind-ro= options have been
3401 extended to allow creation of non-recursive bind mounts.
3402
c626bf1d
DM
3403 * libsystemd gained two new calls sd_pid_get_cgroup() and
3404 sd_peer_get_cgroup() which return the control group path of
5e8d4254
LP
3405 a process or peer of a connected AF_UNIX socket. This
3406 function call is particularly useful when implementing
3407 delegated subtrees support in the control group hierarchy.
3408
3409 * The "sd-event" event loop API of libsystemd now supports
3410 correct dequeuing of real-time signals, without losing
3411 signal events.
3412
d35f51ea
ZJS
3413 * When systemd requests a polkit decision when managing units it
3414 will now add additional fields to the request, including unit
3415 name and desired operation. This enables more powerful polkit
3416 policies, that make decisions depending on these parameters.
c9912c5e 3417
47f5a38c
LP
3418 * nspawn learnt support for .nspawn settings files, that may
3419 accompany the image files or directories of containers, and
3420 may contain additional settings for the container. This is
3421 an alternative to configuring container parameters via the
3422 nspawn command line.
3423
2f77decc
LP
3424 Contributions from: Cristian Rodríguez, Daniel Mack, David
3425 Herrmann, Eugene Yakubovich, Evgeny Vereshchagin, Filipe
3426 Brandenburger, Hans de Goede, Jan Alexander Steffens, Jan
3427 Synacek, Kay Sievers, Lennart Poettering, Mangix, Marcel
3428 Holtmann, Martin Pitt, Michael Biebl, Michael Chapman, Michal
3429 Sekletar, Peter Hutterer, Piotr Drąg, reverendhomer, Robin
3430 Hack, Susant Sahani, Sylvain Pasche, Thomas Hindoe Paaboel
23d08d1b 3431 Andersen, Tom Gundersen, Torstein Husebø
c9912c5e 3432
ccddd104 3433 — Berlin, 2015-09-08
c9912c5e 3434
ec5249a2
DM
3435CHANGES WITH 225:
3436
5e8d4254
LP
3437 * machinectl gained a new verb 'shell' which opens a fresh
3438 shell on the target container or the host. It is similar to
3439 the existing 'login' command of machinectl, but spawns the
3440 shell directly without prompting for username or
3441 password. The pseudo machine '.host' now refers to the local
3442 host and is used by default. Hence, 'machinectl shell' can
3443 be used as replacement for 'su -' which spawns a session as
3444 a fresh systemd unit in a way that is fully isolated from
3445 the originating session.
3446
3447 * systemd-networkd learned to cope with private-zone DHCP
3448 options and allows other programs to query the values.
3449
3450 * SELinux access control when enabling/disabling units is no
d35f51ea
ZJS
3451 longer enforced with this release. The previous implementation
3452 was incorrect, and a new corrected implementation is not yet
3453 available. As unit file operations are still protected via
3454 polkit and D-Bus policy this is not a security problem. Yet,
3455 distributions which care about optimal SELinux support should
3456 probably not stabilize on this release.
5e8d4254
LP
3457
3458 * sd-bus gained support for matches of type "arg0has=", that
3459 test for membership of strings in string arrays sent in bus
3460 messages.
3461
3462 * systemd-resolved now dumps the contents of its DNS and LLMNR
3463 caches to the logs on reception of the SIGUSR1 signal. This
3464 is useful to debug DNS behaviour.
3465
3466 * The coredumpctl tool gained a new --directory= option to
3467 operate on journal files in a specific directory.
3468
3469 * "systemctl reboot" and related commands gained a new
3470 "--message=" option which may be used to set a free-text
3471 wall message when shutting down or rebooting the
3472 system. This message is also logged, which is useful for
3473 figuring out the reason for a reboot or shutdown a
3474 posteriori.
3475
3476 * The "systemd-resolve-host" tool's -i switch now takes
3477 network interface numbers as alternative to interface names.
3478
3479 * A new unit file setting for services has been introduced:
3480 UtmpMode= allows configuration of how precisely systemd
3481 handles utmp and wtmp entries for the service if this is
3482 enabled. This allows writing services that appear similar to
3483 user sessions in the output of the "w", "who", "last" and
3484 "lastlog" tools.
3485
3486 * systemd-resolved will now locally synthesize DNS resource
3487 records for the "localhost" and "gateway" domains as well as
3488 the local hostname. This should ensure that clients querying
3489 RRs via resolved will get similar results as those going via
3490 NSS, if nss-myhostname is enabled.
3491
3492 Contributions from: Alastair Hughes, Alex Crawford, Daniel
3493 Mack, David Herrmann, Dimitri John Ledkov, Eric Kostrowski,
3494 Evgeny Vereshchagin, Felipe Sateler, HATAYAMA Daisuke, Jan
3495 Pokorný, Jan Synacek, Johnny Robeson, Karel Zak, Kay Sievers,
3496 Kefeng Wang, Lennart Poettering, Major Hayden, Marcel
3497 Holtmann, Markus Elfring, Martin Mikkelsen, Martin Pitt, Matt
3498 Turner, Maxim Mikityanskiy, Michael Biebl, Namhyung Kim,
3499 Nicolas Cornu, Owen W. Taylor, Patrik Flykt, Peter Hutterer,
3500 reverendhomer, Richard Maw, Ronny Chevalier, Seth Jennings,
3501 Stef Walter, Susant Sahani, Thomas Blume, Thomas Hindoe
3502 Paaboel Andersen, Thomas Meyer, Tom Gundersen, Vincent Batts,
3503 WaLyong Cho, Zbigniew Jędrzejewski-Szmek
e1439a14 3504
ccddd104 3505 — Berlin, 2015-08-27
ec5249a2 3506
11811e85
DH
3507CHANGES WITH 224:
3508
10fa421c
DH
3509 * The systemd-efi-boot-generator functionality was merged into
3510 systemd-gpt-auto-generator.
3511
5e8d4254
LP
3512 * systemd-networkd now supports Group Policy for vxlan
3513 devices. It can be enabled via the new boolean configuration
3514 option called 'GroupPolicyExtension='.
10fa421c 3515
11811e85
DH
3516 Contributions from: Andreas Kempf, Christian Hesse, Daniel Mack, David
3517 Herrmann, Herman Fries, Johannes Nixdorf, Kay Sievers, Lennart
3518 Poettering, Peter Hutterer, Susant Sahani, Tom Gundersen
3519
ccddd104 3520 — Berlin, 2015-07-31
11811e85 3521
e57eaef8
DH
3522CHANGES WITH 223:
3523
3524 * The python-systemd code has been removed from the systemd repository.
3525 A new repository has been created which accommodates the code from
3526 now on, and we kindly ask distributions to create a separate package
3527 for this: https://github.com/systemd/python-systemd
3528
01608bc8 3529 * The systemd daemon will now reload its main configuration
e57eaef8
DH
3530 (/etc/systemd/system.conf) on daemon-reload.
3531
3532 * sd-dhcp now exposes vendor specific extensions via
3533 sd_dhcp_lease_get_vendor_specific().
3534
931618d0
DM
3535 * systemd-networkd gained a number of new configuration options.
3536
3537 - A new boolean configuration option for TAP devices called
37d54b93 3538 'VNetHeader='. If set, the IFF_VNET_HDR flag is set for the
931618d0
DM
3539 device, thus allowing to send and receive GSO packets.
3540
3541 - A new tunnel configuration option called 'CopyDSCP='.
3542 If enabled, the DSCP field of ip6 tunnels is copied into the
3543 decapsulated packet.
3544
3545 - A set of boolean bridge configuration options were added.
3546 'UseBPDU=', 'HairPin=', 'FastLeave=', 'AllowPortToBeRoot=',
3547 and 'UnicastFlood=' are now parsed by networkd and applied to the
3548 respective bridge link device via the respective IFLA_BRPORT_*
3549 netlink attribute.
3550
3551 - A new string configuration option to override the hostname sent
3552 to a DHCP server, called 'Hostname='. If set and 'SendHostname='
3553 is true, networkd will use the configured hostname instead of the
3554 system hostname when sending DHCP requests.
3555
3556 - A new tunnel configuration option called 'IPv6FlowLabel='. If set,
3557 networkd will configure the IPv6 flow-label of the tunnel device
3558 according to RFC2460.
e57eaef8 3559
f5f113f6
DH
3560 - The 'macvtap' virtual network devices are now supported, similar to
3561 the already supported 'macvlan' devices.
3562
e57eaef8 3563 * systemd-resolved now implements RFC5452 to improve resilience against
01608bc8 3564 cache poisoning. Additionally, source port randomization is enabled
e57eaef8
DH
3565 by default to further protect against DNS spoofing attacks.
3566
3567 * nss-mymachines now supports translating UIDs and GIDs of running
3568 containers with user-namespaces enabled. If a container 'foo'
3569 translates a host uid 'UID' to the container uid 'TUID', then
3570 nss-mymachines will also map uid 'UID' to/from username 'vu-foo-TUID'
3571 (with 'foo' and 'TUID' replaced accordingly). Similarly, groups are
3572 mapped as 'vg-foo-TGID'.
3573
3574 Contributions from: Beniamino Galvani, cee1, Christian Hesse, Daniel
e4e66993
DH
3575 Buch, Daniel Mack, daurnimator, David Herrmann, Dimitri John Ledkov,
3576 HATAYAMA Daisuke, Ivan Shapovalov, Jan Alexander Steffens (heftig),
3577 Johan Ouwerkerk, Jose Carlos Venegas Munoz, Karel Zak, Kay Sievers,
3578 Lennart Poettering, Lidong Zhong, Martin Pitt, Michael Biebl, Michael
3579 Olbrich, Michal Schmidt, Michal Sekletar, Mike Gilbert, Namhyung Kim,
3580 Nick Owens, Peter Hutterer, Richard Maw, Steven Allen, Sungbae Yoo,
3581 Susant Sahani, Thomas Blume, Thomas Hindoe Paaboel Andersen, Tom
3582 Gundersen, Torstein Husebø, Umut Tezduyar Lindskog, Vito Caputo,
3583 Vivenzio Pagliari, Zbigniew Jędrzejewski-Szmek
3584
ccddd104 3585 — Berlin, 2015-07-29
e57eaef8 3586
0db83ad7 3587CHANGES WITH 222:
5541c889 3588
861b02eb
KS
3589 * udev does not longer support the WAIT_FOR_SYSFS= key in udev rules.
3590 There are no known issues with current sysfs, and udev does not need
3591 or should be used to work around such bugs.
3592
3593 * udev does no longer enable USB HID power management. Several reports
3594 indicate, that some devices cannot handle that setting.
0db83ad7
DH
3595
3596 * The udev accelerometer helper was removed. The functionality
3597 is now fully included in iio-sensor-proxy. But this means,
3598 older iio-sensor-proxy versions will no longer provide
3599 accelerometer/orientation data with this systemd version.
3600 Please upgrade iio-sensor-proxy to version 1.0.
3601
5541c889
DH
3602 * networkd gained a new configuration option IPv6PrivacyExtensions=
3603 which enables IPv6 privacy extensions (RFC 4941, "Privacy Extensions
3604 for Stateless Address") on selected networks.
3605
9b361114
DM
3606 * For the sake of fewer build-time dependencies and less code in the
3607 main repository, the python bindings are about to be removed in the
3608 next release. A new repository has been created which accommodates
3609 the code from now on, and we kindly ask distributions to create a
3610 separate package for this. The removal will take place in v223.
3611
3612 https://github.com/systemd/python-systemd
3613
0db83ad7
DH
3614 Contributions from: Abdo Roig-Maranges, Andrew Eikum, Bastien Nocera,
3615 Cédric Delmas, Christian Hesse, Christos Trochalakis, Daniel Mack,
3616 daurnimator, David Herrmann, Dimitri John Ledkov, Eric Biggers, Eric
3617 Cook, Felipe Sateler, Geert Jansen, Gerd Hoffmann, Gianpaolo Macario,
5541c889
DH
3618 Greg Kroah-Hartman, Iago López Galeiras, Jan Alexander Steffens
3619 (heftig), Jan Engelhardt, Jay Strict, Kay Sievers, Lennart Poettering,
0db83ad7
DH
3620 Markus Knetschke, Martin Pitt, Michael Biebl, Michael Marineau, Michal
3621 Sekletar, Miguel Bernal Marin, Peter Hutterer, Richard Maw, rinrinne,
2d1ca112
DH
3622 Susant Sahani, Thomas Hindoe Paaboel Andersen, Tom Gundersen, Torstein
3623 Husebø, Vedran Miletić, WaLyong Cho, Zbigniew Jędrzejewski-Szmek
0db83ad7 3624
ccddd104 3625 — Berlin, 2015-07-07
0db83ad7 3626
0f0467e6
MP
3627CHANGES WITH 221:
3628
470e72d4 3629 * The sd-bus.h and sd-event.h APIs have now been declared
5f92d24f 3630 stable and have been added to the official interface of
470e72d4
LP
3631 libsystemd.so. sd-bus implements an alternative D-Bus client
3632 library, that is relatively easy to use, very efficient and
3633 supports both classic D-Bus as well as kdbus as transport
3634 backend. sd-event is a generic event loop abstraction that
3635 is built around Linux epoll, but adds features such as event
0aee49d5 3636 prioritization or efficient timer handling. Both APIs are good
470e72d4
LP
3637 choices for C programs looking for a bus and/or event loop
3638 implementation that is minimal and does not have to be
5f92d24f 3639 portable to other kernels.
0f0467e6 3640
470e72d4
LP
3641 * kdbus support is no longer compile-time optional. It is now
3642 always built-in. However, it can still be disabled at
3643 runtime using the kdbus=0 kernel command line setting, and
c6551464 3644 that setting may be changed to default to off, by specifying
470e72d4
LP
3645 --disable-kdbus at build-time. Note though that the kernel
3646 command line setting has no effect if the kdbus.ko kernel
3647 module is not installed, in which case kdbus is (obviously)
3648 also disabled. We encourage all downstream distributions to
0aee49d5 3649 begin testing kdbus by adding it to the kernel images in the
470e72d4
LP
3650 development distributions, and leaving kdbus support in
3651 systemd enabled.
0f0467e6 3652
470e72d4
LP
3653 * The minimal required util-linux version has been bumped to
3654 2.26.
3655
3656 * Support for chkconfig (--enable-chkconfig) was removed in
0aee49d5 3657 favor of calling an abstraction tool
470e72d4
LP
3658 /lib/systemd/systemd-sysv-install. This needs to be
3659 implemented for your distribution. See "SYSV INIT.D SCRIPTS"
3660 in README for details.
3661
3662 * If there's a systemd unit and a SysV init script for the
3663 same service name, and the user executes "systemctl enable"
3664 for it (or a related call), then this will now enable both
3665 (or execute the related operation on both), not just the
3666 unit.
3667
3668 * The libudev API documentation has been converted from gtkdoc
3669 into man pages.
3670
3671 * gudev has been removed from the systemd tree, it is now an
3672 external project.
3673
3674 * The systemd-cgtop tool learnt a new --raw switch to generate
0aee49d5 3675 "raw" (machine parsable) output.
470e72d4
LP
3676
3677 * networkd's IPForwarding= .network file setting learnt the
3678 new setting "kernel", which ensures that networkd does not
3679 change the IP forwarding sysctl from the default kernel
3680 state.
3681
3682 * The systemd-logind bus API now exposes a new boolean
3683 property "Docked" that reports whether logind considers the
3684 system "docked", i.e. connected to a docking station or not.
3685
3686 Contributions from: Alex Crawford, Andreas Pokorny, Andrei
3687 Borzenkov, Charles Duffy, Colin Guthrie, Cristian Rodríguez,
3688 Daniele Medri, Daniel Hahler, Daniel Mack, David Herrmann,
3689 David Mohr, Dimitri John Ledkov, Djalal Harouni, dslul, Ed
3690 Swierk, Eric Cook, Filipe Brandenburger, Gianpaolo Macario,
3691 Harald Hoyer, Iago López Galeiras, Igor Vuk, Jan Synacek,
3692 Jason Pleau, Jason S. McMullan, Jean Delvare, Jeff Huang,
3693 Jonathan Boulle, Karel Zak, Kay Sievers, kloun, Lennart
3694 Poettering, Marc-Antoine Perennou, Marcel Holtmann, Mario
3695 Limonciello, Martin Pitt, Michael Biebl, Michael Olbrich,
3696 Michal Schmidt, Mike Gilbert, Nick Owens, Pablo Lezaeta Reyes,
b912e251
LP
3697 Patrick Donnelly, Pavel Odvody, Peter Hutterer, Philip
3698 Withnall, Ronny Chevalier, Simon McVittie, Susant Sahani,
3699 Thomas Hindoe Paaboel Andersen, Tom Gundersen, Torstein
3700 Husebø, Umut Tezduyar Lindskog, Viktar Vauchkevich, Werner
3701 Fink, Zbigniew Jędrzejewski-Szmek
470e72d4 3702
ccddd104 3703 — Berlin, 2015-06-19
0f0467e6 3704
481a0aa2
LP
3705CHANGES WITH 220:
3706
f7a73a25
DH
3707 * The gudev library has been extracted into a separate repository
3708 available at: https://git.gnome.org/browse/libgudev/
3709 It is now managed as part of the Gnome project. Distributions
3710 are recommended to pass --disable-gudev to systemd and use
3711 gudev from the Gnome project instead. gudev is still included
3712 in systemd, for now. It will be removed soon, though. Please
3713 also see the announcement-thread on systemd-devel:
56cadcb6 3714 https://lists.freedesktop.org/archives/systemd-devel/2015-May/032070.html
f7a73a25 3715
481a0aa2
LP
3716 * systemd now exposes a CPUUsageNSec= property for each
3717 service unit on the bus, that contains the overall consumed
3718 CPU time of a service (the sum of what each process of the
3719 service consumed). This value is only available if
3720 CPUAccounting= is turned on for a service, and is then shown
3721 in the "systemctl status" output.
3722
3723 * Support for configuring alternative mappings of the old SysV
3724 runlevels to systemd targets has been removed. They are now
29d1fcb4 3725 hardcoded in a way that runlevels 2, 3, 4 all map to
481a0aa2
LP
3726 multi-user.target and 5 to graphical.target (which
3727 previously was already the default behaviour).
3728
3729 * The auto-mounter logic gained support for mount point
3730 expiry, using a new TimeoutIdleSec= setting in .automount
3731 units. (Also available as x-systemd.idle-timeout= in /etc/fstab).
3732
3733 * The EFI System Partition (ESP) as mounted to /boot by
3734 systemd-efi-boot-generator will now be unmounted
29d1fcb4 3735 automatically after 2 minutes of not being used. This should
481a0aa2
LP
3736 minimize the risk of ESP corruptions.
3737
3738 * New /etc/fstab options x-systemd.requires= and
3739 x-systemd.requires-mounts-for= are now supported to express
3740 additional dependencies for mounts. This is useful for
3741 journalling file systems that support external journal
3742 devices or overlay file systems that require underlying file
3743 systems to be mounted.
3744
3745 * systemd does not support direct live-upgrades (via systemctl
3746 daemon-reexec) from versions older than v44 anymore. As no
3747 distribution we are aware of shipped such old versions in a
3748 stable release this should not be problematic.
3749
3750 * When systemd forks off a new per-connection service instance
3751 it will now set the $REMOTE_ADDR environment variable to the
3752 remote IP address, and $REMOTE_PORT environment variable to
3753 the remote IP port. This behaviour is similar to the
3754 corresponding environment variables defined by CGI.
3755
3756 * systemd-networkd gained support for uplink failure
3757 detection. The BindCarrier= option allows binding interface
3758 configuration dynamically to the link sense of other
3759 interfaces. This is useful to achieve behaviour like in
3760 network switches.
3761
3762 * systemd-networkd gained support for configuring the DHCP
3763 client identifier to use when requesting leases.
3764
3765 * systemd-networkd now has a per-network UseNTP= option to
3766 configure whether NTP server information acquired via DHCP
3767 is passed on to services like systemd-timesyncd.
3768
3769 * systemd-networkd gained support for vti6 tunnels.
3770
1579dd2c
LP
3771 * Note that systemd-networkd manages the sysctl variable
3772 /proc/sys/net/ipv[46]/conf/*/forwarding for each interface
3773 it is configured for since v219. The variable controls IP
3774 forwarding, and is a per-interface alternative to the global
3775 /proc/sys/net/ipv[46]/ip_forward. This setting is
3776 configurable in the IPForward= option, which defaults to
3777 "no". This means if networkd is used for an interface it is
3778 no longer sufficient to set the global sysctl option to turn
3779 on IP forwarding! Instead, the .network file option
3780 IPForward= needs to be turned on! Note that the
3781 implementation of this behaviour was broken in v219 and has
3782 been fixed in v220.
3783
481a0aa2
LP
3784 * Many bonding and vxlan options are now configurable in
3785 systemd-networkd.
3786
3787 * systemd-nspawn gained a new --property= setting to set unit
3788 properties for the container scope. This is useful for
ce830873 3789 setting resource parameters (e.g. "CPUShares=500") on
481a0aa2
LP
3790 containers started from the command line.
3791
3792 * systemd-nspawn gained a new --private-users= switch to make
3793 use of user namespacing available on recent Linux kernels.
3794
3795 * systemd-nspawn may now be called as part of a shell pipeline
3796 in which case the pipes used for stdin and stdout are passed
3797 directly to the process invoked in the container, without
3798 indirection via a pseudo tty.
3799
3800 * systemd-nspawn gained a new switch to control the UNIX
3801 signal to use when killing the init process of the container
3802 when shutting down.
3803
3804 * systemd-nspawn gained a new --overlay= switch for mounting
3805 overlay file systems into the container using the new kernel
3806 overlayfs support.
3807
3808 * When a container image is imported via systemd-importd and
3809 the host file system is not btrfs, a loopback block device
3810 file is created in /var/lib/machines.raw with a btrfs file
3811 system inside. It is then mounted to /var/lib/machines to
3812 enable btrfs features for container management. The loopback
3813 file and btrfs file system is grown as needed when container
3814 images are imported via systemd-importd.
3815
3816 * systemd-machined/systemd-importd gained support for btrfs
3817 quota, to enforce container disk space limits on disk. This
3818 is exposed in "machinectl set-limit".
3819
3820 * systemd-importd now can import containers from local .tar,
3821 .raw and .qcow2 images, and export them to .tar and .raw. It
3822 can also import dkr v2 images now from the network (on top
3823 of v1 as before).
3824
3825 * systemd-importd gained support for verifying downloaded
3826 images with gpg2 (previously only gpg1 was supported).
3827
d35f51ea
ZJS
3828 * systemd-machined, systemd-logind, systemd: most bus calls are
3829 now accessible to unprivileged processes via polkit. Also,
3830 systemd-logind will now allow users to kill their own sessions
3831 without further privileges or authorization.
481a0aa2
LP
3832
3833 * systemd-shutdownd has been removed. This service was
3834 previously responsible for implementing scheduled shutdowns
3835 as exposed in /usr/bin/shutdown's time parameter. This
3836 functionality has now been moved into systemd-logind and is
3837 accessible via a bus interface.
3838
3839 * "systemctl reboot" gained a new switch --firmware-setup that
3840 can be used to reboot into the EFI firmware setup, if that
3841 is available. systemd-logind now exposes an API on the bus
3842 to trigger such reboots, in case graphical desktop UIs want
3843 to cover this functionality.
3844
3845 * "systemctl enable", "systemctl disable" and "systemctl mask"
1579dd2c 3846 now support a new "--now" switch. If specified the units
481a0aa2
LP
3847 that are enabled will also be started, and the ones
3848 disabled/masked also stopped.
3849
3850 * The Gummiboot EFI boot loader tool has been merged into
1a2d5fbe
DH
3851 systemd, and renamed to "systemd-boot". The bootctl tool has been
3852 updated to support systemd-boot.
481a0aa2
LP
3853
3854 * An EFI kernel stub has been added that may be used to create
3855 kernel EFI binaries that contain not only the actual kernel,
3856 but also an initrd, boot splash, command line and OS release
3857 information. This combined binary can then be signed as a
3858 single image, so that the firmware can verify it all in one
1a2d5fbe 3859 step. systemd-boot has special support for EFI binaries created
481a0aa2
LP
3860 like this and can extract OS release information from them
3861 and show them in the boot menu. This functionality is useful
3862 to implement cryptographically verified boot schemes.
3863
3864 * Optional support has been added to systemd-fsck to pass
3865 fsck's progress report to an AF_UNIX socket in the file
3866 system.
3867
3868 * udev will no longer create device symlinks for all block
3869 devices by default. A blacklist for excluding special block
3870 devices from this logic has been turned into a whitelist
3871 that requires picking block devices explicitly that require
3872 device symlinks.
3873
3874 * A new (currently still internal) API sd-device.h has been
3875 added to libsystemd. This modernized API is supposed to
3876 replace libudev eventually. In fact, already much of libudev
3877 is now just a wrapper around sd-device.h.
3878
3879 * A new hwdb database for storing metadata about pointing
3880 stick devices has been added.
3881
3882 * systemd-tmpfiles gained support for setting file attributes
3883 similar to the "chattr" tool with new 'h' and 'H' lines.
3884
3885 * systemd-journald will no longer unconditionally set the
3886 btrfs NOCOW flag on new journal files. This is instead done
3887 with tmpfiles snippet using the new 'h' line type. This
3888 allows easy disabling of this logic, by masking the
3889 journal-nocow.conf tmpfiles file.
3890
3891 * systemd-journald will now translate audit message types to
3892 human readable identifiers when writing them to the
3893 journal. This should improve readability of audit messages.
3894
3895 * The LUKS logic gained support for the offset= and skip=
3896 options in /etc/crypttab, as previously implemented by
3897 Debian.
3898
3899 * /usr/lib/os-release gained a new optional field VARIANT= for
3900 distributions that support multiple variants (such as a
3901 desktop edition, a server edition, ...)
3902
3903 Contributions from: Aaro Koskinen, Adam Goode, Alban Crequy,
3904 Alberto Fanjul Alonso, Alexander Sverdlin, Alex Puchades, Alin
3905 Rauta, Alison Chaiken, Andrew Jones, Arend van Spriel,
3906 Benedikt Morbach, Benjamin Franzke, Benjamin Tissoires, Blaž
3907 Tomažič, Chris Morgan, Chris Morin, Colin Walters, Cristian
3908 Rodríguez, Daniel Buch, Daniel Drake, Daniele Medri, Daniel
3909 Mack, Daniel Mustieles, daurnimator, Davide Bettio, David
3910 Herrmann, David Strauss, Didier Roche, Dimitri John Ledkov,
3911 Eric Cook, Gavin Li, Goffredo Baroncelli, Hannes Reinecke,
3912 Hans de Goede, Hans-Peter Deifel, Harald Hoyer, Iago López
3913 Galeiras, Ivan Shapovalov, Jan Engelhardt, Jan Janssen, Jan
3914 Pazdziora, Jan Synacek, Jasper St. Pierre, Jay Faulkner, John
3915 Paul Adrian Glaubitz, Jonathon Gilbert, Karel Zak, Kay
3916 Sievers, Koen Kooi, Lennart Poettering, Lubomir Rintel, Lucas
3917 De Marchi, Lukas Nykryn, Lukas Rusak, Lukasz Skalski, Łukasz
3918 Stelmach, Mantas Mikulėnas, Marc-Antoine Perennou, Marcel
3919 Holtmann, Martin Pitt, Mathieu Chevrier, Matthew Garrett,
3920 Michael Biebl, Michael Marineau, Michael Olbrich, Michal
3921 Schmidt, Michal Sekletar, Mirco Tischler, Nir Soffer, Patrik
3922 Flykt, Pavel Odvody, Peter Hutterer, Peter Lemenkov, Peter
3923 Waller, Piotr Drąg, Raul Gutierrez S, Richard Maw, Ronny
3924 Chevalier, Ross Burton, Sebastian Rasmussen, Sergey Ptashnick,
3925 Seth Jennings, Shawn Landden, Simon Farnsworth, Stefan Junker,
3926 Stephen Gallagher, Susant Sahani, Sylvain Plantefève, Thomas
3927 Haller, Thomas Hindoe Paaboel Andersen, Tobias Hunger, Tom
3928 Gundersen, Torstein Husebø, Umut Tezduyar Lindskog, Will
3929 Woods, Zachary Cook, Zbigniew Jędrzejewski-Szmek
3930
ccddd104 3931 — Berlin, 2015-05-22
481a0aa2 3932
615aaf41
LP
3933CHANGES WITH 219:
3934
615aaf41
LP
3935 * Introduce a new API "sd-hwdb.h" for querying the hardware
3936 metadata database. With this minimal interface one can query
3937 and enumerate the udev hwdb, decoupled from the old libudev
3938 library. libudev's interface for this is now only a wrapper
3939 around sd-hwdb. A new tool systemd-hwdb has been added to
3940 interface with and update the database.
3941
3942 * When any of systemd's tools copies files (for example due to
3943 tmpfiles' C lines) a btrfs reflink will attempted first,
3944 before bytewise copying is done.
3945
3946 * systemd-nspawn gained a new --ephemeral switch. When
3947 specified a btrfs snapshot is taken of the container's root
3948 directory, and immediately removed when the container
3949 terminates again. Thus, a container can be started whose
3950 changes never alter the container's root directory, and are
3951 lost on container termination. This switch can also be used
3952 for starting a container off the root file system of the
3953 host without affecting the host OS. This switch is only
3954 available on btrfs file systems.
3955
3956 * systemd-nspawn gained a new --template= switch. It takes the
3957 path to a container tree to use as template for the tree
7edecf21 3958 specified via --directory=, should that directory be
615aaf41
LP
3959 missing. This allows instantiating containers dynamically,
3960 on first run. This switch is only available on btrfs file
3961 systems.
3962
3963 * When a .mount unit refers to a mount point on which multiple
3964 mounts are stacked, and the .mount unit is stopped all of
3965 the stacked mount points will now be unmounted until no
3966 mount point remains.
3967
3968 * systemd now has an explicit notion of supported and
3969 unsupported unit types. Jobs enqueued for unsupported unit
3970 types will now fail with an "unsupported" error code. More
3971 specifically .swap, .automount and .device units are not
3972 supported in containers, .busname units are not supported on
3973 non-kdbus systems. .swap and .automount are also not
3974 supported if their respective kernel compile time options
3975 are disabled.
3976
3977 * machinectl gained support for two new "copy-from" and
3978 "copy-to" commands for copying files from a running
3979 container to the host or vice versa.
3980
3981 * machinectl gained support for a new "bind" command to bind
3982 mount host directories into local containers. This is
3983 currently only supported for nspawn containers.
3984
3985 * networkd gained support for configuring bridge forwarding
3986 database entries (fdb) from .network files.
3987
3988 * A new tiny daemon "systemd-importd" has been added that can
3989 download container images in tar, raw, qcow2 or dkr formats,
3990 and make them available locally in /var/lib/machines, so
3991 that they can run as nspawn containers. The daemon can GPG
3992 verify the downloads (not supported for dkr, since it has no
3993 provisions for verifying downloads). It will transparently
3994 decompress bz2, xz, gzip compressed downloads if necessary,
3995 and restore sparse files on disk. The daemon uses privilege
3996 separation to ensure the actual download logic runs with
94e5ba37 3997 fewer privileges than the daemon itself. machinectl has
615aaf41
LP
3998 gained new commands "pull-tar", "pull-raw" and "pull-dkr" to
3999 make the functionality of importd available to the
4000 user. With this in place the Fedora and Ubuntu "Cloud"
4001 images can be downloaded and booted as containers unmodified
4002 (the Fedora images lack the appropriate GPG signature files
4003 currently, so they cannot be verified, but this will change
4004 soon, hopefully). Note that downloading images is currently
4005 only fully supported on btrfs.
4006
4007 * machinectl is now able to list container images found in
4008 /var/lib/machines, along with some metadata about sizes of
4009 disk and similar. If the directory is located on btrfs and
4010 quota is enabled, this includes quota display. A new command
4011 "image-status" has been added that shows additional
4012 information about images.
4013
4014 * machinectl is now able to clone container images
4015 efficiently, if the underlying file system (btrfs) supports
f59dba26 4016 it, with the new "machinectl clone" command. It also
615aaf41
LP
4017 gained commands for renaming and removing images, as well as
4018 marking them read-only or read-write (supported also on
4019 legacy file systems).
4020
4021 * networkd gained support for collecting LLDP network
4022 announcements, from hardware that supports this. This is
4023 shown in networkctl output.
4024
4025 * systemd-run gained support for a new -t (--pty) switch for
4026 invoking a binary on a pty whose input and output is
4027 connected to the invoking terminal. This allows executing
4028 processes as system services while interactively
4029 communicating with them via the terminal. Most interestingly
4030 this is supported across container boundaries. Invoking
4031 "systemd-run -t /bin/bash" is an alternative to running a
4032 full login session, the difference being that the former
4033 will not register a session, nor go through the PAM session
4034 setup.
4035
4036 * tmpfiles gained support for a new "v" line type for creating
4037 btrfs subvolumes. If the underlying file system is a legacy
4038 file system, this automatically degrades to creating a
4039 normal directory. Among others /var/lib/machines is now
4040 created like this at boot, should it be missing.
4041
4042 * The directory /var/lib/containers/ has been deprecated and
4043 been replaced by /var/lib/machines. The term "machines" has
4044 been used in the systemd context as generic term for both
4045 VMs and containers, and hence appears more appropriate for
4046 this, as the directory can also contain raw images bootable
4047 via qemu/kvm.
4048
4049 * systemd-nspawn when invoked with -M but without --directory=
4050 or --image= is now capable of searching for the container
4051 root directory, subvolume or disk image automatically, in
4052 /var/lib/machines. systemd-nspawn@.service has been updated
4053 to make use of this, thus allowing it to be used for raw
4054 disk images, too.
4055
4056 * A new machines.target unit has been introduced that is
4057 supposed to group all containers/VMs invoked as services on
4058 the system. systemd-nspawn@.service has been updated to
4059 integrate with that.
4060
4061 * machinectl gained a new "start" command, for invoking a
4062 container as a service. "machinectl start foo" is mostly
4063 equivalent to "systemctl start systemd-nspawn@foo.service",
4064 but handles escaping in a nicer way.
4065
4066 * systemd-nspawn will now mount most of the cgroupfs tree
4067 read-only into each container, with the exception of the
4068 container's own subtree in the name=systemd hierarchy.
4069
4070 * journald now sets the special FS_NOCOW file flag for its
4071 journal files. This should improve performance on btrfs, by
4072 avoiding heavy fragmentation when journald's write-pattern
4073 is used on COW file systems. It degrades btrfs' data
4074 integrity guarantees for the files to the same levels as for
4075 ext3/ext4 however. This should be OK though as journald does
4076 its own data integrity checks and all its objects are
4077 checksummed on disk. Also, journald should handle btrfs disk
4078 full events a lot more gracefully now, by processing SIGBUS
4079 errors, and not relying on fallocate() anymore.
4080
4081 * When journald detects that journal files it is writing to
4082 have been deleted it will immediately start new journal
4083 files.
4084
4085 * systemd now provides a way to store file descriptors
4c37970d 4086 per-service in PID 1. This is useful for daemons to ensure
615aaf41 4087 that fds they require are not lost during a daemon
94e5ba37 4088 restart. The fds are passed to the daemon on the next
615aaf41
LP
4089 invocation in the same way socket activation fds are
4090 passed. This is now used by journald to ensure that the
4091 various sockets connected to all the system's stdout/stderr
4092 are not lost when journald is restarted. File descriptors
4093 may be stored in PID 1 via the sd_pid_notify_with_fds() API,
4094 an extension to sd_notify(). Note that a limit is enforced
4095 on the number of fds a service can store in PID 1, and it
4096 defaults to 0, so that no fds may be stored, unless this is
4097 explicitly turned on.
4098
4099 * The default TERM variable to use for units connected to a
4100 terminal, when no other value is explicitly is set is now
4101 vt220 rather than vt102. This should be fairly safe still,
4102 but allows PgUp/PgDn work.
4103
4104 * The /etc/crypttab option header= as known from Debian is now
4105 supported.
4106
4107 * "loginctl user-status" and "loginctl session-status" will
4108 now show the last 10 lines of log messages of the
4109 user/session following the status output. Similar,
4110 "machinectl status" will show the last 10 log lines
4111 associated with a virtual machine or container
4112 service. (Note that this is usually not the log messages
4113 done in the VM/container itself, but simply what the
4114 container manager logs. For nspawn this includes all console
4115 output however.)
4116
4117 * "loginctl session-status" without further argument will now
4118 show the status of the session of the caller. Similar,
4119 "lock-session", "unlock-session", "activate",
4120 "enable-linger", "disable-linger" may now be called without
4121 session/user parameter in which case they apply to the
4122 caller's session/user.
4123
4124 * An X11 session scriptlet is now shipped that uploads
4125 $DISPLAY and $XAUTHORITY into the environment of the systemd
4126 --user daemon if a session begins. This should improve
4127 compatibility with X11 enabled applications run as systemd
4128 user services.
4129
4130 * Generators are now subject to masking via /etc and /run, the
4131 same way as unit files.
4132
4133 * networkd .network files gained support for configuring
4134 per-link IPv4/IPv6 packet forwarding as well as IPv4
4135 masquerading. This is by default turned on for veth links to
4136 containers, as registered by systemd-nspawn. This means that
4137 nspawn containers run with --network-veth will now get
4138 automatic routed access to the host's networks without any
4139 further configuration or setup, as long as networkd runs on
4140 the host.
4141
4142 * systemd-nspawn gained the --port= (-p) switch to expose TCP
4143 or UDP posts of a container on the host. With this in place
4144 it is possible to run containers with private veth links
4145 (--network-veth), and have their functionality exposed on
4146 the host as if their services were running directly on the
4147 host.
4148
dd2fd155 4149 * systemd-nspawn's --network-veth switch now gained a short
615aaf41
LP
4150 version "-n", since with the changes above it is now truly
4151 useful out-of-the-box. The systemd-nspawn@.service has been
4152 updated to make use of it too by default.
4153
4154 * systemd-nspawn will now maintain a per-image R/W lock, to
4155 ensure that the same image is not started more than once
4156 writable. (It's OK to run an image multiple times
4157 simultaneously in read-only mode.)
4158
4159 * systemd-nspawn's --image= option is now capable of
4160 dissecting and booting MBR and GPT disk images that contain
4161 only a single active Linux partition. Previously it
4162 supported only GPT disk images with proper GPT type
4163 IDs. This allows running cloud images from major
4164 distributions directly with systemd-nspawn, without
4165 modification.
4166
4167 * In addition to collecting mouse dpi data in the udev
4168 hardware database, there's now support for collecting angle
4169 information for mouse scroll wheels. The database is
7edecf21 4170 supposed to guarantee similar scrolling behavior on mice
615aaf41
LP
4171 that it knows about. There's also support for collecting
4172 information about Touchpad types.
4173
4174 * udev's input_id built-in will now also collect touch screen
4175 dimension data and attach it to probed devices.
4176
4177 * /etc/os-release gained support for a Distribution Privacy
4178 Policy link field.
4179
4180 * networkd gained support for creating "ipvlan", "gretap",
4181 "ip6gre", "ip6gretap" and "ip6tnl" network devices.
4182
4183 * systemd-tmpfiles gained support for "a" lines for setting
4184 ACLs on files.
4185
4186 * systemd-nspawn will now mount /tmp in the container to
4187 tmpfs, automatically.
4188
4189 * systemd now exposes the memory.usage_in_bytes cgroup
4190 attribute and shows it for each service in the "systemctl
4191 status" output, if available.
4192
4193 * When the user presses Ctrl-Alt-Del more than 7x within 2s an
4194 immediate reboot is triggered. This useful if shutdown is
4195 hung and is unable to complete, to expedite the
4196 operation. Note that this kind of reboot will still unmount
4197 all file systems, and hence should not result in fsck being
4198 run on next reboot.
4199
4200 * A .device unit for an optical block device will now be
4201 considered active only when a medium is in the drive. Also,
4202 mount units are now bound to their backing devices thus
4203 triggering automatic unmounting when devices become
4204 unavailable. With this in place systemd will now
4205 automatically unmount left-over mounts when a CD-ROM is
4206 ejected or an USB stick is yanked from the system.
4207
4208 * networkd-wait-online now has support for waiting for
4209 specific interfaces only (with globbing), and for giving up
4210 after a configurable timeout.
4211
4212 * networkd now exits when idle. It will be automatically
4213 restarted as soon as interfaces show up, are removed or
4214 change state. networkd will stay around as long as there is
4215 at least one DHCP state machine or similar around, that keep
4216 it non-idle.
4217
4218 * networkd may now configure IPv6 link-local addressing in
4219 addition to IPv4 link-local addressing.
4220
4221 * The IPv6 "token" for use in SLAAC may now be configured for
4222 each .network interface in networkd.
4223
4224 * Routes configured with networkd may now be assigned a scope
4225 in .network files.
4226
4227 * networkd's [Match] sections now support globbing and lists
4228 of multiple space-separated matches per item.
4229
11ea2781 4230 Contributions from: Alban Crequy, Alin Rauta, Andrey Chaser,
d2c643c6
LP
4231 Bastien Nocera, Bruno Bottazzini, Carlos Garnacho, Carlos
4232 Morata Castillo, Chris Atkinson, Chris J. Arges, Christian
4233 Kirbach, Christian Seiler, Christoph Brill, Colin Guthrie,
4234 Colin Walters, Cristian Rodríguez, Daniele Medri, Daniel Mack,
4235 Dave Reisner, David Herrmann, Djalal Harouni, Erik Auerswald,
4236 Filipe Brandenburger, Frank Theile, Gabor Kelemen, Gabriel de
4237 Perthuis, Harald Hoyer, Hui Wang, Ivan Shapovalov, Jan
4238 Engelhardt, Jan Synacek, Jay Faulkner, Johannes Hölzl, Jonas
4239 Ådahl, Jonathan Boulle, Josef Andersson, Kay Sievers, Ken
4240 Werner, Lennart Poettering, Lucas De Marchi, Lukas Märdian,
4241 Lukas Nykryn, Lukasz Skalski, Luke Shumaker, Mantas Mikulėnas,
4242 Manuel Mendez, Marcel Holtmann, Marc Schmitzer, Marko
4243 Myllynen, Martin Pitt, Maxim Mikityanskiy, Michael Biebl,
4244 Michael Marineau, Michael Olbrich, Michal Schmidt, Mindaugas
11ea2781
LP
4245 Baranauskas, Moez Bouhlel, Naveen Kumar, Patrik Flykt, Paul
4246 Martin, Peter Hutterer, Peter Mattern, Philippe De Swert,
4247 Piotr Drąg, Rafael Ferreira, Rami Rosen, Robert Milasan, Ronny
4248 Chevalier, Sangjung Woo, Sebastien Bacher, Sergey Ptashnick,
4249 Shawn Landden, Stéphane Graber, Susant Sahani, Sylvain
4250 Plantefève, Thomas Hindoe Paaboel Andersen, Tim JP, Tom
4251 Gundersen, Topi Miettinen, Torstein Husebø, Umut Tezduyar
d2c643c6
LP
4252 Lindskog, Veres Lajos, Vincent Batts, WaLyong Cho, Wieland
4253 Hoffmann, Zbigniew Jędrzejewski-Szmek
11ea2781 4254
ccddd104 4255 — Berlin, 2015-02-16
11ea2781 4256
d4f5a1f4
DH
4257CHANGES WITH 218:
4258
f9e00a9f
LP
4259 * When querying unit file enablement status (for example via
4260 "systemctl is-enabled"), a new state "indirect" is now known
4261 which indicates that a unit might not be enabled itself, but
c7683ffb 4262 another unit listed in its Also= setting might be.
f9e00a9f
LP
4263
4264 * Similar to the various existing ConditionXYZ= settings for
b938cb90 4265 units, there are now matching AssertXYZ= settings. While
f9e00a9f
LP
4266 failing conditions cause a unit to be skipped, but its job
4267 to succeed, failing assertions declared like this will cause
4268 a unit start operation and its job to fail.
4269
4270 * hostnamed now knows a new chassis type "embedded".
4271
4272 * systemctl gained a new "edit" command. When used on a unit
b938cb90 4273 file, this allows extending unit files with .d/ drop-in
f9e00a9f
LP
4274 configuration snippets or editing the full file (after
4275 copying it from /usr/lib to /etc). This will invoke the
4276 user's editor (as configured with $EDITOR), and reload the
4277 modified configuration after editing.
4278
4279 * "systemctl status" now shows the suggested enablement state
4280 for a unit, as declared in the (usually vendor-supplied)
4281 system preset files.
4282
4283 * nss-myhostname will now resolve the single-label host name
4284 "gateway" to the locally configured default IP routing
4285 gateways, ordered by their metrics. This assigns a stable
4286 name to the used gateways, regardless which ones are
4287 currently configured. Note that the name will only be
4288 resolved after all other name sources (if nss-myhostname is
4289 configured properly) and should hence not negatively impact
4290 systems that use the single-label host name "gateway" in
4291 other contexts.
4292
4293 * systemd-inhibit now allows filtering by mode when listing
4294 inhibitors.
4295
122676c9 4296 * Scope and service units gained a new "Delegate" boolean
b938cb90 4297 property, which, when set, allows processes running inside the
122676c9
LP
4298 unit to further partition resources. This is primarily
4299 useful for systemd user instances as well as container
4300 managers.
f9e00a9f
LP
4301
4302 * journald will now pick up audit messages directly from
4303 the kernel, and log them like any other log message. The
4304 audit fields are split up and fully indexed. This means that
4305 journalctl in many ways is now a (nicer!) alternative to
4306 ausearch, the traditional audit client. Note that this
b938cb90 4307 implements only a minimal audit client. If you want the
f9e00a9f
LP
4308 special audit modes like reboot-on-log-overflow, please use
4309 the traditional auditd instead, which can be used in
4310 parallel to journald.
4311
4312 * The ConditionSecurity= unit file option now understands the
4313 special string "audit" to check whether auditing is
4314 available.
4315
4316 * journalctl gained two new commands --vacuum-size= and
4317 --vacuum-time= to delete old journal files until the
a8eaaee7 4318 remaining ones take up no more than the specified size on disk,
f9e00a9f
LP
4319 or are not older than the specified time.
4320
4321 * A new, native PPPoE library has been added to sd-network,
4322 systemd's library of light-weight networking protocols. This
4323 library will be used in a future version of networkd to
4324 enable PPPoE communication without an external pppd daemon.
4325
4326 * The busctl tool now understands a new "capture" verb that
4327 works similar to "monitor", but writes a packet capture
4328 trace to STDOUT that can be redirected to a file which is
4329 compatible with libcap's capture file format. This can then
4330 be loaded in Wireshark and similar tools to inspect bus
4331 communication.
4332
4333 * The busctl tool now understands a new "tree" verb that shows
4334 the object trees of a specific service on the bus, or of all
4335 services.
4336
4337 * The busctl tool now understands a new "introspect" verb that
4338 shows all interfaces and members of objects on the bus,
4339 including their signature and values. This is particularly
4340 useful to get more information about bus objects shown by
4341 the new "busctl tree" command.
4342
4343 * The busctl tool now understands new verbs "call",
4344 "set-property" and "get-property" for invoking bus method
4345 calls, setting and getting bus object properties in a
4346 friendly way.
4347
4348 * busctl gained a new --augment-creds= argument that controls
4349 whether the tool shall augment credential information it
4350 gets from the bus with data from /proc, in a possibly
4351 race-ful way.
4352
4353 * nspawn's --link-journal= switch gained two new values
4354 "try-guest" and "try-host" that work like "guest" and
17c29493 4355 "host", but do not fail if the host has no persistent
f9e00a9f
LP
4356 journalling enabled. -j is now equivalent to
4357 --link-journal=try-guest.
4358
4359 * macvlan network devices created by nspawn will now have
4360 stable MAC addresses.
4361
4362 * A new SmackProcessLabel= unit setting has been added, which
4363 controls the SMACK security label processes forked off by
4364 the respective unit shall use.
4365
d4f5a1f4
DH
4366 * If compiled with --enable-xkbcommon, systemd-localed will
4367 verify x11 keymap settings by compiling the given keymap. It
4368 will spew out warnings if the compilation fails. This
4369 requires libxkbcommon to be installed.
4370
b938cb90 4371 * When a coredump is collected, a larger number of metadata
f9e00a9f 4372 fields is now collected and included in the journal records
b938cb90 4373 created for it. More specifically, control group membership,
f9e00a9f
LP
4374 environment variables, memory maps, working directory,
4375 chroot directory, /proc/$PID/status, and a list of open file
4376 descriptors is now stored in the log entry.
4377
17c29493 4378 * The udev hwdb now contains DPI information for mice. For
f9e00a9f
LP
4379 details see:
4380
4381 http://who-t.blogspot.de/2014/12/building-a-dpi-database-for-mice.html
4382
4383 * All systemd programs that read standalone configuration
4384 files in /etc now also support a corresponding series of
997b2b43
JT
4385 .conf.d configuration directories in /etc/, /run/,
4386 /usr/local/lib/, /usr/lib/, and (if configured with
4387 --enable-split-usr) /lib/. In particular, the following
4388 configuration files now have corresponding configuration
4389 directories: system.conf user.conf, logind.conf,
4390 journald.conf, sleep.conf, bootchart.conf, coredump.conf,
4391 resolved.conf, timesyncd.conf, journal-remote.conf, and
4392 journal-upload.conf. Note that distributions should use the
4393 configuration directories in /usr/lib/; the directories in
4394 /etc/ are reserved for the system administrator.
4395
f9e00a9f
LP
4396 * systemd-rfkill will no longer take the rfkill device name
4397 into account when storing rfkill state on disk, as the name
4398 might be dynamically assigned and not stable. Instead, the
4399 ID_PATH udev variable combined with the rfkill type (wlan,
4400 bluetooth, ...) is used.
4401
4402 * A new service systemd-machine-id-commit.service has been
4403 added. When used on systems where /etc is read-only during
4404 boot, and /etc/machine-id is not initialized (but an empty
4405 file), this service will copy the temporary machine ID
4406 created as replacement into /etc after the system is fully
4407 booted up. This is useful for systems that are freshly
4408 installed with a non-initialized machine ID, but should get
4409 a fixed machine ID for subsequent boots.
4410
4411 * networkd's .netdev files now provide a large set of
a8eaaee7 4412 configuration parameters for VXLAN devices. Similarly, the
f9e00a9f
LP
4413 bridge port cost parameter is now configurable in .network
4414 files. There's also new support for configuring IP source
4415 routing. networkd .link files gained support for a new
4416 OriginalName= match that is useful to match against the
4417 original interface name the kernel assigned. .network files
4418 may include MTU= and MACAddress= fields for altering the MTU
4419 and MAC address while being connected to a specific network
4420 interface.
4421
4422 * The LUKS logic gained supported for configuring
4423 UUID-specific key files. There's also new support for naming
4424 LUKS device from the kernel command line, using the new
4425 luks.name= argument.
4426
4427 * Timer units may now be transiently created via the bus API
4428 (this was previously already available for scope and service
4429 units). In addition it is now possible to create multiple
4430 transient units at the same time with a single bus call. The
4431 "systemd-run" tool has been updated to make use of this for
4432 running commands on a specified time, in at(1)-style.
4433
4434 * tmpfiles gained support for "t" lines, for assigning
4435 extended attributes to files. Among other uses this may be
4436 used to assign SMACK labels to files.
4437
13e92f39
LP
4438 Contributions from: Alin Rauta, Alison Chaiken, Andrej
4439 Manduch, Bastien Nocera, Chris Atkinson, Chris Leech, Chris
4440 Mayo, Colin Guthrie, Colin Walters, Cristian Rodríguez,
4441 Daniele Medri, Daniel Mack, Dan Williams, Dan Winship, Dave
4442 Reisner, David Herrmann, Didier Roche, Felipe Sateler, Gavin
4443 Li, Hans de Goede, Harald Hoyer, Iago López Galeiras, Ivan
4444 Shapovalov, Jakub Filak, Jan Janssen, Jan Synacek, Joe
4445 Lawrence, Josh Triplett, Kay Sievers, Lennart Poettering,
4446 Lukas Nykryn, Łukasz Stelmach, Maciej Wereski, Mantas
4447 Mikulėnas, Marcel Holtmann, Martin Pitt, Maurizio Lombardi,
4448 Michael Biebl, Michael Chapman, Michael Marineau, Michal
7da81d33
LP
4449 Schmidt, Michal Sekletar, Olivier Brunel, Patrik Flykt, Peter
4450 Hutterer, Przemyslaw Kedzierski, Rami Rosen, Ray Strode,
4451 Richard Schütz, Richard W.M. Jones, Ronny Chevalier, Ross
4452 Lagerwall, Sean Young, Stanisław Pitucha, Susant Sahani,
4453 Thomas Haller, Thomas Hindoe Paaboel Andersen, Tom Gundersen,
4454 Torstein Husebø, Umut Tezduyar Lindskog, Vicente Olivert
4455 Riera, WaLyong Cho, Wesley Dawson, Zbigniew Jędrzejewski-Szmek
13e92f39 4456
ccddd104 4457 — Berlin, 2014-12-10
f9e00a9f 4458
b62a309a
ZJS
4459CHANGES WITH 217:
4460
78b6b7ce
LP
4461 * journalctl gained the new options -t/--identifier= to match
4462 on the syslog identifier (aka "tag"), as well as --utc to
4463 show log timestamps in the UTC timezone. journalctl now also
4464 accepts -n/--lines=all to disable line capping in a pager.
b62a309a 4465
a65b8245
ZJS
4466 * journalctl gained a new switch, --flush, that synchronously
4467 flushes logs from /run/log/journal to /var/log/journal if
4468 persistent storage is enabled. systemd-journal-flush.service
4469 now waits until the operation is complete.
2a97b03b 4470
b62a309a
ZJS
4471 * Services can notify the manager before they start a reload
4472 (by sending RELOADING=1) or shutdown (by sending
4bdc60cb
LP
4473 STOPPING=1). This allows the manager to track and show the
4474 internal state of daemons and closes a race condition when
78b6b7ce 4475 the process is still running but has closed its D-Bus
4bdc60cb 4476 connection.
b62a309a 4477
78b6b7ce
LP
4478 * Services with Type=oneshot do not have to have any ExecStart
4479 commands anymore.
b62a309a
ZJS
4480
4481 * User units are now loaded also from
4482 $XDG_RUNTIME_DIR/systemd/user/. This is similar to the
4483 /run/systemd/user directory that was already previously
4484 supported, but is under the control of the user.
4485
4ffd29fd
LP
4486 * Job timeouts (i.e. time-outs on the time a job that is
4487 queued stays in the run queue) can now optionally result in
4488 immediate reboot or power-off actions (JobTimeoutAction= and
4489 JobTimeoutRebootArgument=). This is useful on ".target"
4490 units, to limit the maximum time a target remains
4491 undispatched in the run queue, and to trigger an emergency
4492 operation in such a case. This is now used by default to
4493 turn off the system if boot-up (as defined by everything in
4494 basic.target) hangs and does not complete for at least
4495 15min. Also, if power-off or reboot hang for at least 30min
4496 an immediate power-off/reboot operation is triggered. This
4497 functionality is particularly useful to increase reliability
4498 on embedded devices, but also on laptops which might
4499 accidentally get powered on when carried in a backpack and
4500 whose boot stays stuck in a hard disk encryption passphrase
4501 question.
4502
b62a309a
ZJS
4503 * systemd-logind can be configured to also handle lid switch
4504 events even when the machine is docked or multiple displays
4505 are attached (HandleLidSwitchDocked= option).
4506
4507 * A helper binary and a service have been added which can be
4508 used to resume from hibernation in the initramfs. A
4509 generator will parse the resume= option on the kernel
81c7dd89 4510 command line to trigger resume.
b62a309a 4511
78b6b7ce
LP
4512 * A user console daemon systemd-consoled has been
4513 added. Currently, it is a preview, and will so far open a
4514 single terminal on each session of the user marked as
09077149 4515 Desktop=systemd-console.
b62a309a
ZJS
4516
4517 * Route metrics can be specified for DHCP routes added by
4518 systemd-networkd.
4519
ba8df74b 4520 * The SELinux context of socket-activated services can be set
78b6b7ce 4521 from the information provided by the networking stack
b62a309a
ZJS
4522 (SELinuxContextFromNet= option).
4523
4524 * Userspace firmware loading support has been removed and
4525 the minimum supported kernel version is thus bumped to 3.7.
4526
4527 * Timeout for udev workers has been increased from 1 to 3
4528 minutes, but a warning will be printed after 1 minute to
4529 help diagnose kernel modules that take a long time to load.
4530
78b6b7ce 4531 * Udev rules can now remove tags on devices with TAG-="foobar".
b62a309a 4532
4bdc60cb 4533 * systemd's readahead implementation has been removed. In many
f6d1de85 4534 circumstances it didn't give expected benefits even for
b62a309a 4535 rotational disk drives and was becoming less relevant in the
78b6b7ce
LP
4536 age of SSDs. As none of the developers has been using
4537 rotating media anymore, and nobody stepped up to actively
4538 maintain this component of systemd it has now been removed.
b62a309a 4539
c4ac9900 4540 * Swap units can use Options= to specify discard options.
b62a309a
ZJS
4541 Discard options specified for swaps in /etc/fstab are now
4542 respected.
4543
4544 * Docker containers are now detected as a separate type of
4545 virtualization.
4546
4547 * The Password Agent protocol gained support for queries where
ba8df74b 4548 the user input is shown, useful e.g. for user names.
78b6b7ce
LP
4549 systemd-ask-password gained a new --echo option to turn that
4550 on.
b62a309a 4551
e6c253e3
MS
4552 * The default sysctl.d/ snippets will now set:
4553
4554 net.core.default_qdisc = fq_codel
4555
ba8df74b
KS
4556 This selects Fair Queuing Controlled Delay as the default
4557 queuing discipline for network interfaces. fq_codel helps
e6c253e3
MS
4558 fight the network bufferbloat problem. It is believed to be
4559 a good default with no tuning required for most workloads.
4560 Downstream distributions may override this choice. On 10Gbit
4561 servers that do not do forwarding, "fq" may perform better.
4562 Systems without a good clocksource should use "pfifo_fast".
4563
4bdc60cb
LP
4564 * If kdbus is enabled during build a new option BusPolicy= is
4565 available for service units, that allows locking all service
4566 processes into a stricter bus policy, in order to limit
4567 access to various bus services, or even hide most of them
4568 from the service's view entirely.
4569
4570 * networkctl will now show the .network and .link file
4571 networkd has applied to a specific interface.
4572
4573 * sd-login gained a new API call sd_session_get_desktop() to
4574 query which desktop environment has been selected for a
4575 session.
4576
4577 * UNIX utmp support is now compile-time optional to support
4578 legacy-free systems.
4579
78b6b7ce
LP
4580 * systemctl gained two new commands "add-wants" and
4581 "add-requires" for pulling in units from specific targets
4582 easily.
4583
4584 * If the word "rescue" is specified on the kernel command line
4585 the system will now boot into rescue mode (aka
4586 rescue.target), which was previously available only by
4587 specifying "1" or "systemd.unit=rescue.target" on the kernel
4588 command line. This new kernel command line option nicely
4589 mirrors the already existing "emergency" kernel command line
4590 option.
4591
4592 * New kernel command line options mount.usr=, mount.usrflags=,
d4474c41 4593 mount.usrfstype= have been added that match root=, rootflags=,
78b6b7ce
LP
4594 rootfstype= but allow mounting a specific file system to
4595 /usr.
4596
f6d1de85 4597 * The $NOTIFY_SOCKET is now also passed to control processes of
78b6b7ce
LP
4598 services, not only the main process.
4599
4600 * This version reenables support for fsck's -l switch. This
4601 means at least version v2.25 of util-linux is required for
4602 operation, otherwise dead-locks on device nodes may
4603 occur. Again: you need to update util-linux to at least
4604 v2.25 when updating systemd to v217.
4605
3769415e
TT
4606 * The "multi-seat-x" tool has been removed from systemd, as
4607 its functionality has been integrated into X servers 1.16,
4608 and the tool is hence redundant. It is recommended to update
4609 display managers invoking this tool to simply invoke X
4610 directly from now on, again.
4611
fae9332b 4612 * Support for the new ALLOW_INTERACTIVE_AUTHORIZATION D-Bus
d35f51ea
ZJS
4613 message flag has been added for all of systemd's polkit
4614 authenticated method calls has been added. In particular this
4615 now allows optional interactive authorization via polkit for
4616 many of PID1's privileged operations such as unit file
4617 enabling and disabling.
fae9332b 4618
cfa1571b
LP
4619 * "udevadm hwdb --update" learnt a new switch "--usr" for
4620 placing the rebuilt hardware database in /usr instead of
4621 /etc. When used only hardware database entries stored in
4622 /usr will be used, and any user database entries in /etc are
4623 ignored. This functionality is useful for vendors to ship a
4624 pre-built database on systems where local configuration is
4625 unnecessary or unlikely.
4626
7e63dd10
LP
4627 * Calendar time specifications in .timer units now also
4628 understand the strings "semi-annually", "quarterly" and
ba8df74b 4629 "minutely" as shortcuts (in addition to the preexisting
7e63dd10
LP
4630 "anually", "hourly", ...).
4631
d4474c41
TG
4632 * systemd-tmpfiles will now correctly create files in /dev
4633 at boot which are marked for creation only at boot. It is
4634 recommended to always create static device nodes with 'c!'
4635 and 'b!', so that they are created only at boot and not
4636 overwritten at runtime.
4637
3b187c5c
LP
4638 * When the watchdog logic is used for a service (WatchdogSec=)
4639 and the watchdog timeout is hit the service will now be
4640 terminated with SIGABRT (instead of just SIGTERM), in order
4641 to make sure a proper coredump and backtrace is
4642 generated. This ensures that hanging services will result in
4643 similar coredump/backtrace behaviour as services that hit a
4644 segmentation fault.
4645
4b08dd87
LP
4646 Contributions from: Andreas Henriksson, Andrei Borzenkov,
4647 Angus Gibson, Ansgar Burchardt, Ben Wolsieffer, Brandon L.
4648 Black, Christian Hesse, Cristian Rodríguez, Daniel Buch,
4649 Daniele Medri, Daniel Mack, Dan Williams, Dave Reisner, David
4650 Herrmann, David Sommerseth, David Strauss, Emil Renner
4651 Berthing, Eric Cook, Evangelos Foutras, Filipe Brandenburger,
4652 Gustavo Sverzut Barbieri, Hans de Goede, Harald Hoyer, Hristo
4653 Venev, Hugo Grostabussiat, Ivan Shapovalov, Jan Janssen, Jan
4654 Synacek, Jonathan Liu, Juho Son, Karel Zak, Kay Sievers, Klaus
4655 Purer, Koen Kooi, Lennart Poettering, Lukas Nykryn, Lukasz
4656 Skalski, Łukasz Stelmach, Mantas Mikulėnas, Marcel Holtmann,
4657 Marius Tessmann, Marko Myllynen, Martin Pitt, Michael Biebl,
4658 Michael Marineau, Michael Olbrich, Michael Scherer, Michal
4659 Schmidt, Michal Sekletar, Miroslav Lichvar, Patrik Flykt,
4660 Philippe De Swert, Piotr Drąg, Rahul Sundaram, Richard
4661 Weinberger, Robert Milasan, Ronny Chevalier, Ruben Kerkhof,
4662 Santiago Vila, Sergey Ptashnick, Simon McVittie, Sjoerd
4663 Simons, Stefan Brüns, Steven Allen, Steven Noonan, Susant
4664 Sahani, Sylvain Plantefève, Thomas Hindoe Paaboel Andersen,
4665 Timofey Titovets, Tobias Hunger, Tom Gundersen, Torstein
4666 Husebø, Umut Tezduyar Lindskog, WaLyong Cho, Zbigniew
13e92f39 4667 Jędrzejewski-Szmek
4b08dd87 4668
ccddd104 4669 — Berlin, 2014-10-28
4b08dd87 4670
b72ddf0f 4671CHANGES WITH 216:
b2ca0d63
LP
4672
4673 * timedated no longer reads NTP implementation unit names from
b72ddf0f 4674 /usr/lib/systemd/ntp-units.d/*.list. Alternative NTP
b2ca0d63
LP
4675 implementations should add a
4676
b72ddf0f 4677 Conflicts=systemd-timesyncd.service
b2ca0d63
LP
4678
4679 to their unit files to take over and replace systemd's NTP
4680 default functionality.
4681
4682 * systemd-sysusers gained a new line type "r" for configuring
4683 which UID/GID ranges to allocate system users/groups
4684 from. Lines of type "u" may now add an additional column
4685 that specifies the home directory for the system user to be
4686 created. Also, systemd-sysusers may now optionally read user
4687 information from STDIN instead of a file. This is useful for
4688 invoking it from RPM preinst scriptlets that need to create
4689 users before the first RPM file is installed since these
4690 files might need to be owned by them. A new
4691 %sysusers_create_inline RPM macro has been introduced to do
4692 just that. systemd-sysusers now updates the shadow files as
4693 well as the user/group databases, which should enhance
4694 compatibility with certain tools like grpck.
4695
d35f51ea
ZJS
4696 * A number of bus APIs of PID 1 now optionally consult polkit to
4697 permit access for otherwise unprivileged clients under certain
4698 conditions. Note that this currently doesn't support
4699 interactive authentication yet, but this is expected to be
4700 added eventually, too.
b2ca0d63
LP
4701
4702 * /etc/machine-info now has new fields for configuring the
4703 deployment environment of the machine, as well as the
4704 location of the machine. hostnamectl has been updated with
4705 new command to update these fields.
4706
4707 * systemd-timesyncd has been updated to automatically acquire
4708 NTP server information from systemd-networkd, which might
4709 have been discovered via DHCP.
4710
4711 * systemd-resolved now includes a caching DNS stub resolver
4712 and a complete LLMNR name resolution implementation. A new
daa05349
AB
4713 NSS module "nss-resolve" has been added which can be used
4714 instead of glibc's own "nss-dns" to resolve hostnames via
b2ca0d63
LP
4715 systemd-resolved. Hostnames, addresses and arbitrary RRs may
4716 be resolved via systemd-resolved D-Bus APIs. In contrast to
4717 the glibc internal resolver systemd-resolved is aware of
4718 multi-homed system, and keeps DNS server and caches separate
5f02e26c 4719 and per-interface. Queries are sent simultaneously on all
b2ca0d63
LP
4720 interfaces that have DNS servers configured, in order to
4721 properly handle VPNs and local LANs which might resolve
4722 separate sets of domain names. systemd-resolved may acquire
a1a4a25e 4723 DNS server information from systemd-networkd automatically,
b2ca0d63
LP
4724 which in turn might have discovered them via DHCP. A tool
4725 "systemd-resolve-host" has been added that may be used to
4726 query the DNS logic in resolved. systemd-resolved implements
4727 IDNA and automatically uses IDNA or UTF-8 encoding depending
4728 on whether classic DNS or LLMNR is used as transport. In the
4729 next releases we intend to add a DNSSEC and mDNS/DNS-SD
4730 implementation to systemd-resolved.
4731
4732 * A new NSS module nss-mymachines has been added, that
4733 automatically resolves the names of all local registered
4734 containers to their respective IP addresses.
4735
4736 * A new client tool "networkctl" for systemd-networkd has been
4737 added. It currently is entirely passive and will query
4738 networking configuration from udev, rtnetlink and networkd,
5f02e26c 4739 and present it to the user in a very friendly
b2ca0d63
LP
4740 way. Eventually, we hope to extend it to become a full
4741 control utility for networkd.
4742
4743 * .socket units gained a new DeferAcceptSec= setting that
4744 controls the kernels' TCP_DEFER_ACCEPT sockopt for
a8eaaee7 4745 TCP. Similarly, support for controlling TCP keep-alive
b2ca0d63
LP
4746 settings has been added (KeepAliveTimeSec=,
4747 KeepAliveIntervalSec=, KeepAliveProbes=). Also, support for
4748 turning off Nagle's algorithm on TCP has been added
4749 (NoDelay=).
4750
a1a4a25e 4751 * logind learned a new session type "web", for use in projects
b2ca0d63
LP
4752 like Cockpit which register web clients as PAM sessions.
4753
4754 * timer units with at least one OnCalendar= setting will now
46ae28d8 4755 be started only after time-sync.target has been
b2ca0d63
LP
4756 reached. This way they will not elapse before the system
4757 clock has been corrected by a local NTP client or
4758 similar. This is particular useful on RTC-less embedded
4759 machines, that come up with an invalid system clock.
4760
4761 * systemd-nspawn's --network-veth= switch should now result in
4762 stable MAC addresses for both the outer and the inner side
4763 of the link.
4764
4765 * systemd-nspawn gained a new --volatile= switch for running
4766 container instances with /etc or /var unpopulated.
4767
4768 * The kdbus client code has been updated to use the new Linux
4769 3.17 memfd subsystem instead of the old kdbus-specific one.
4770
4771 * systemd-networkd's DHCP client and server now support
01da80b1
LP
4772 FORCERENEW. There are also new configuration options to
4773 configure the vendor client identifier and broadcast mode
4774 for DHCP.
b2ca0d63
LP
4775
4776 * systemd will no longer inform the kernel about the current
4777 timezone, as this is necessarily incorrect and racy as the
4778 kernel has no understanding of DST and similar
4779 concepts. This hence means FAT timestamps will be always
4780 considered UTC, similar to what Android is already
4781 doing. Also, when the RTC is configured to the local time
4782 (rather than UTC) systemd will never synchronize back to it,
4783 as this might confuse Windows at a later boot.
4784
4785 * systemd-analyze gained a new command "verify" for offline
4786 validation of unit files.
4787
4788 * systemd-networkd gained support for a couple of additional
4789 settings for bonding networking setups. Also, the metric for
4790 statically configured routes may now be configured. For
4791 network interfaces where this is appropriate the peer IP
4792 address may now be configured.
4793
26568403
TG
4794 * systemd-networkd's DHCP client will no longer request
4795 broadcasting by default, as this tripped up some networks.
4796 For hardware where broadcast is required the feature should
4797 be switched back on using RequestBroadcast=yes.
4798
4799 * systemd-networkd will now set up IPv4LL addresses (when
4800 enabled) even if DHCP is configured successfully.
4801
4802 * udev will now default to respect network device names given
4803 by the kernel when the kernel indicates that these are
4804 predictable. This behavior can be tweaked by changing
4805 NamePolicy= in the relevant .link file.
4806
b2ca0d63
LP
4807 * A new library systemd-terminal has been added that
4808 implements full TTY stream parsing and rendering. This
4809 library is supposed to be used later on for implementing a
4810 full userspace VT subsystem, replacing the current kernel
4811 implementation.
4812
4813 * A new tool systemd-journal-upload has been added to push
4814 journal data to a remote system running
4815 systemd-journal-remote.
4816
4817 * journald will no longer forward all local data to another
4818 running syslog daemon. This change has been made because
4819 rsyslog (which appears to be the most commonly used syslog
4820 implementation these days) no longer makes use of this, and
4821 instead pulls the data out of the journal on its own. Since
5f02e26c 4822 forwarding the messages to a non-existent syslog server is
b2ca0d63
LP
4823 more expensive than we assumed we have now turned this
4824 off. If you run a syslog server that is not a recent rsyslog
4825 version, you have to turn this option on again
4826 (ForwardToSyslog= in journald.conf).
4827
4828 * journald now optionally supports the LZ4 compressor for
4829 larger journal fields. This compressor should perform much
4830 better than XZ which was the previous default.
4831
4832 * machinectl now shows the IP addresses of local containers,
4833 if it knows them, plus the interface name of the container.
4834
4835 * A new tool "systemd-escape" has been added that makes it
4836 easy to escape strings to build unit names and similar.
4837
4838 * sd_notify() messages may now include a new ERRNO= field
4839 which is parsed and collected by systemd and shown among the
4840 "systemctl status" output for a service.
4841
4842 * A new component "systemd-firstboot" has been added that
4843 queries the most basic systemd information (timezone,
a1a4a25e 4844 hostname, root password) interactively on first
b2ca0d63
LP
4845 boot. Alternatively it may also be used to provision these
4846 things offline on OS images installed into directories.
4847
01da80b1
LP
4848 * The default sysctl.d/ snippets will now set
4849
4850 net.ipv4.conf.default.promote_secondaries=1
4851
4852 This has the benefit of no flushing secondary IP addresses
4853 when primary addresses are removed.
4854
b2ca0d63
LP
4855 Contributions from: Ansgar Burchardt, Bastien Nocera, Colin
4856 Walters, Dan Dedrick, Daniel Buch, Daniel Korostil, Daniel
4857 Mack, Dan Williams, Dave Reisner, David Herrmann, Denis
4858 Kenzior, Eelco Dolstra, Eric Cook, Hannes Reinecke, Harald
4859 Hoyer, Hong Shick Pak, Hui Wang, Jean-André Santoni, Jóhann
4860 B. Guðmundsson, Jon Severinsson, Karel Zak, Kay Sievers, Kevin
4861 Wells, Lennart Poettering, Lukas Nykryn, Mantas Mikulėnas,
4862 Marc-Antoine Perennou, Martin Pitt, Michael Biebl, Michael
4863 Marineau, Michael Olbrich, Michal Schmidt, Michal Sekletar,
4864 Miguel Angel Ajo, Mike Gilbert, Olivier Brunel, Robert
4865 Schiele, Ronny Chevalier, Simon McVittie, Sjoerd Simons, Stef
4866 Walter, Steven Noonan, Susant Sahani, Tanu Kaskinen, Thomas
4867 Blume, Thomas Hindoe Paaboel Andersen, Timofey Titovets,
4868 Tobias Geerinckx-Rice, Tomasz Torcz, Tom Gundersen, Umut
4869 Tezduyar Lindskog, Zbigniew Jędrzejewski-Szmek
4870
ccddd104 4871 — Berlin, 2014-08-19
b72ddf0f 4872
3dff3e00 4873CHANGES WITH 215:
24a2bf4c
LP
4874
4875 * A new tool systemd-sysusers has been added. This tool
4876 creates system users and groups in /etc/passwd and
4877 /etc/group, based on static declarative system user/group
4878 definitions in /usr/lib/sysusers.d/. This is useful to
4879 enable factory resets and volatile systems that boot up with
4880 an empty /etc directory, and thus need system users and
4881 groups created during early boot. systemd now also ships
4882 with two default sysusers.d/ files for the most basic
4883 users and groups systemd and the core operating system
4884 require.
4885
4886 * A new tmpfiles snippet has been added that rebuilds the
4887 essential files in /etc on boot, should they be missing.
4888
4889 * A directive for ensuring automatic clean-up of
4890 /var/cache/man/ has been removed from the default
4891 configuration. This line should now be shipped by the man
4892 implementation. The necessary change has been made to the
4893 man-db implementation. Note that you need to update your man
4894 implementation to one that ships this line, otherwise no
4895 automatic clean-up of /var/cache/man will take place.
4896
4897 * A new condition ConditionNeedsUpdate= has been added that
4898 may conditionalize services to only run when /etc or /var
4899 are "older" than the vendor operating system resources in
4900 /usr. This is useful for reconstructing or updating /etc
4901 after an offline update of /usr or a factory reset, on the
4902 next reboot. Services that want to run once after such an
4903 update or reset should use this condition and order
4904 themselves before the new systemd-update-done.service, which
4905 will mark the two directories as fully updated. A number of
4906 service files have been added making use of this, to rebuild
4907 the udev hardware database, the journald message catalog and
4908 dynamic loader cache (ldconfig). The systemd-sysusers tool
4909 described above also makes use of this now. With this in
4910 place it is now possible to start up a minimal operating
ce1dde29 4911 system with /etc empty cleanly. For more information on the
24a2bf4c
LP
4912 concepts involved see this recent blog story:
4913
4914 http://0pointer.de/blog/projects/stateless.html
4915
4916 * A new system group "input" has been introduced, and all
4917 input device nodes get this group assigned. This is useful
4918 for system-level software to get access to input devices. It
3dff3e00
KS
4919 complements what is already done for "audio" and "video".
4920
24a2bf4c
LP
4921 * systemd-networkd learnt minimal DHCPv4 server support in
4922 addition to the existing DHCPv4 client support. It also
4923 learnt DHCPv6 client and IPv6 Router Solicitation client
4924 support. The DHCPv4 client gained support for static routes
4925 passed in from the server. Note that the [DHCPv4] section
4926 known in older systemd-networkd versions has been renamed to
4927 [DHCP] and is now also used by the DHCPv6 client. Existing
c7435cc9
LP
4928 .network files using settings of this section should be
4929 updated, though compatibility is maintained. Optionally, the
4930 client hostname may now be sent to the DHCP server.
24a2bf4c 4931
c7435cc9
LP
4932 * networkd gained support for vxlan virtual networks as well
4933 as tun/tap and dummy devices.
24a2bf4c
LP
4934
4935 * networkd gained support for automatic allocation of address
4936 ranges for interfaces from a system-wide pool of
4937 addresses. This is useful for dynamically managing a large
4938 number of interfaces with a single network configuration
4939 file. In particular this is useful to easily assign
4940 appropriate IP addresses to the veth links of a large number
4941 of nspawn instances.
4942
4943 * RPM macros for processing sysusers, sysctl and binfmt
4944 drop-in snippets at package installation time have been
4945 added.
4946
4947 * The /etc/os-release file should now be placed in
4948 /usr/lib/os-release. The old location is automatically
4949 created as symlink. /usr/lib is the more appropriate
4950 location of this file, since it shall actually describe the
4951 vendor operating system shipped in /usr, and not the
4952 configuration stored in /etc.
4953
4954 * .mount units gained a new boolean SloppyOptions= setting
4955 that maps to mount(8)'s -s option which enables permissive
4956 parsing of unknown mount options.
4957
4958 * tmpfiles learnt a new "L+" directive which creates a symlink
4959 but (unlike "L") deletes a pre-existing file first, should
4960 it already exist and not already be the correct
a8eaaee7 4961 symlink. Similarly, "b+", "c+" and "p+" directives have been
24a2bf4c
LP
4962 added as well, which create block and character devices, as
4963 well as fifos in the filesystem, possibly removing any
4964 pre-existing files of different types.
4965
4966 * For tmpfiles' "L", "L+", "C" and "C+" directives the final
4967 'argument' field (which so far specified the source to
ce1dde29 4968 symlink/copy the files from) is now optional. If omitted the
24a2bf4c
LP
4969 same file os copied from /usr/share/factory/ suffixed by the
4970 full destination path. This is useful for populating /etc
4971 with essential files, by copying them from vendor defaults
4972 shipped in /usr/share/factory/etc.
4973
4974 * A new command "systemctl preset-all" has been added that
4975 applies the service preset settings to all installed unit
4976 files. A new switch --preset-mode= has been added that
4977 controls whether only enable or only disable operations
4978 shall be executed.
4979
4980 * A new command "systemctl is-system-running" has been added
4981 that allows checking the overall state of the system, for
ce1dde29 4982 example whether it is fully up and running.
24a2bf4c
LP
4983
4984 * When the system boots up with an empty /etc, the equivalent
4985 to "systemctl preset-all" is executed during early boot, to
4986 make sure all default services are enabled after a factory
4987 reset.
4988
4989 * systemd now contains a minimal preset file that enables the
4990 most basic services systemd ships by default.
4991
4992 * Unit files' [Install] section gained a new DefaultInstance=
4993 field for defining the default instance to create if a
4994 template unit is enabled with no instance specified.
4995
4996 * A new passive target cryptsetup-pre.target has been added
4997 that may be used by services that need to make they run and
4998 finish before the first LUKS cryptographic device is set up.
4999
5000 * The /dev/loop-control and /dev/btrfs-control device nodes
5001 are now owned by the "disk" group by default, opening up
5002 access to this group.
5003
5004 * systemd-coredump will now automatically generate a
5005 stack trace of all core dumps taking place on the system,
5006 based on elfutils' libdw library. This stack trace is logged
5007 to the journal.
5008
5009 * systemd-coredump may now optionally store coredumps directly
5010 on disk (in /var/lib/systemd/coredump, possibly compressed),
5011 instead of storing them unconditionally in the journal. This
5012 mode is the new default. A new configuration file
5013 /etc/systemd/coredump.conf has been added to configure this
5014 and other parameters of systemd-coredump.
5015
5016 * coredumpctl gained a new "info" verb to show details about a
5017 specific coredump. A new switch "-1" has also been added
5018 that makes sure to only show information about the most
5019 recent entry instead of all entries. Also, as the tool is
5020 generally useful now the "systemd-" prefix of the binary
5021 name has been removed. Distributions that want to maintain
5022 compatibility with the old name should add a symlink from
5023 the old name to the new name.
5024
5025 * journald's SplitMode= now defaults to "uid". This makes sure
ce1dde29 5026 that unprivileged users can access their own coredumps with
24a2bf4c
LP
5027 coredumpctl without restrictions.
5028
5029 * New kernel command line options "systemd.wants=" (for
5030 pulling an additional unit during boot), "systemd.mask="
5031 (for masking a specific unit for the boot), and
5032 "systemd.debug-shell" (for enabling the debug shell on tty9)
5033 have been added. This is implemented in the new generator
5034 "systemd-debug-generator".
5035
5036 * systemd-nspawn will now by default filter a couple of
5037 syscalls for containers, among them those required for
5038 kernel module loading, direct x86 IO port access, swap
5039 management, and kexec. Most importantly though
5040 open_by_handle_at() is now prohibited for containers,
5041 closing a hole similar to a recently discussed vulnerability
5042 in docker regarding access to files on file hierarchies the
b938cb90
JE
5043 container should normally not have access to. Note that, for
5044 nspawn, we generally make no security claims anyway (and
24a2bf4c
LP
5045 this is explicitly documented in the man page), so this is
5046 just a fix for one of the most obvious problems.
5047
5048 * A new man page file-hierarchy(7) has been added that
5049 contains a minimized, modernized version of the file system
5050 layout systemd expects, similar in style to the FHS
c7435cc9
LP
5051 specification or hier(5). A new tool systemd-path(1) has
5052 been added to query many of these paths for the local
5053 machine and user.
24a2bf4c
LP
5054
5055 * Automatic time-based clean-up of $XDG_RUNTIME_DIR is no
5056 longer done. Since the directory now has a per-user size
5057 limit, and is cleaned on logout this appears unnecessary,
5058 in particular since this now brings the lifecycle of this
5059 directory closer in line with how IPC objects are handled.
5060
5061 * systemd.pc now exports a number of additional directories,
5062 including $libdir (which is useful to identify the library
5063 path for the primary architecture of the system), and a
5064 couple of drop-in directories.
5065
3058e017
TLSC
5066 * udev's predictable network interface names now use the dev_port
5067 sysfs attribute, introduced in linux 3.15 instead of dev_id to
5068 distinguish between ports of the same PCI function. dev_id should
5069 only be used for ports using the same HW address, hence the need
5070 for dev_port.
5071
c7435cc9
LP
5072 * machined has been updated to export the OS version of a
5073 container (read from /etc/os-release and
5074 /usr/lib/os-release) on the bus. This is now shown in
5075 "machinectl status" for a machine.
5076
5077 * A new service setting RestartForceExitStatus= has been
5078 added. If configured to a set of exit signals or process
5079 return values, the service will be restarted when the main
5080 daemon process exits with any of them, regardless of the
5081 Restart= setting.
5082
5083 * systemctl's -H switch for connecting to remote systemd
5084 machines has been extended so that it may be used to
5085 directly connect to a specific container on the
5086 host. "systemctl -H root@foobar:waldi" will now connect as
5087 user "root" to host "foobar", and then proceed directly to
5088 the container named "waldi". Note that currently you have to
5089 authenticate as user "root" for this to work, as entering
5090 containers is a privileged operation.
5091
5092 Contributions from: Andreas Henriksson, Benjamin Steinwender,
5093 Carl Schaefer, Christian Hesse, Colin Ian King, Cristian
5094 Rodríguez, Daniel Mack, Dave Reisner, David Herrmann, Eugene
5095 Yakubovich, Filipe Brandenburger, Frederic Crozat, Hristo
5096 Venev, Jan Engelhardt, Jonathan Boulle, Kay Sievers, Lennart
5097 Poettering, Luke Shumaker, Mantas Mikulėnas, Marc-Antoine
5098 Perennou, Marcel Holtmann, Michael Marineau, Michael Olbrich,
5099 Michał Bartoszkiewicz, Michal Sekletar, Patrik Flykt, Ronan Le
5100 Martret, Ronny Chevalier, Ruediger Oertel, Steven Noonan,
5101 Susant Sahani, Thadeu Lima de Souza Cascardo, Thomas Hindoe
5102 Paaboel Andersen, Tom Gundersen, Tom Hirst, Umut Tezduyar
5103 Lindskog, Uoti Urpala, Zbigniew Jędrzejewski-Szmek
5104
ccddd104 5105 — Berlin, 2014-07-03
c7435cc9 5106
4196a3ea
KS
5107CHANGES WITH 214:
5108
5109 * As an experimental feature, udev now tries to lock the
5110 disk device node (flock(LOCK_SH|LOCK_NB)) while it
5111 executes events for the disk or any of its partitions.
5112 Applications like partitioning programs can lock the
5113 disk device node (flock(LOCK_EX)) and claim temporary
5114 device ownership that way; udev will entirely skip all event
5115 handling for this disk and its partitions. If the disk
5116 was opened for writing, the close will trigger a partition
5117 table rescan in udev's "watch" facility, and if needed
71449caf 5118 synthesize "change" events for the disk and all its partitions.
8d0e0ddd 5119 This is now unconditionally enabled, and if it turns out to
4196a3ea 5120 cause major problems, we might turn it on only for specific
45df8656 5121 devices, or might need to disable it entirely. Device Mapper
4196a3ea
KS
5122 devices are excluded from this logic.
5123
04e91da2
LP
5124 * We temporarily dropped the "-l" switch for fsck invocations,
5125 since they collide with the flock() logic above. util-linux
5126 upstream has been changed already to avoid this conflict,
5127 and we will readd "-l" as soon as util-linux with this
5128 change has been released.
5129
5130 * The dependency on libattr has been removed. Since a long
8d0e0ddd 5131 time, the extended attribute calls have moved to glibc, and
04e91da2
LP
5132 libattr is thus unnecessary.
5133
ce830873 5134 * Virtualization detection works without privileges now. This
04e91da2
LP
5135 means the systemd-detect-virt binary no longer requires
5136 CAP_SYS_PTRACE file capabilities, and our daemons can run
71449caf 5137 with fewer privileges.
04e91da2
LP
5138
5139 * systemd-networkd now runs under its own "systemd-network"
5140 user. It retains the CAP_NET_ADMIN, CAP_NET_BIND_SERVICE,
5141 CAP_NET_BROADCAST, CAP_NET_RAW capabilities though, but
5142 loses the ability to write to files owned by root this way.
5143
a8eaaee7 5144 * Similarly, systemd-resolved now runs under its own
04e91da2
LP
5145 "systemd-resolve" user with no capabilities remaining.
5146
a8eaaee7 5147 * Similarly, systemd-bus-proxyd now runs under its own
04e91da2
LP
5148 "systemd-bus-proxy" user with only CAP_IPC_OWNER remaining.
5149
5150 * systemd-networkd gained support for setting up "veth"
a8eaaee7 5151 virtual Ethernet devices for container connectivity, as well
04e91da2
LP
5152 as GRE and VTI tunnels.
5153
5154 * systemd-networkd will no longer automatically attempt to
5155 manually load kernel modules necessary for certain tunnel
8d0e0ddd 5156 transports. Instead, it is assumed the kernel loads them
04e91da2
LP
5157 automatically when required. This only works correctly on
5158 very new kernels. On older kernels, please consider adding
c54bed5d 5159 the kernel modules to /etc/modules-load.d/ as a work-around.
04e91da2 5160
cd14eda3 5161 * The resolv.conf file systemd-resolved generates has been
8d0e0ddd
JE
5162 moved to /run/systemd/resolve/. If you have a symlink from
5163 /etc/resolv.conf, it might be necessary to correct it.
cd14eda3 5164
ef392da6 5165 * Two new service settings, ProtectHome= and ProtectSystem=,
8d0e0ddd 5166 have been added. When enabled, they will make the user data
04e91da2
LP
5167 (such as /home) inaccessible or read-only and the system
5168 (such as /usr) read-only, for specific services. This allows
5169 very light-weight per-service sandboxing to avoid
5170 modifications of user data or system files from
5171 services. These two new switches have been enabled for all
5172 of systemd's long-running services, where appropriate.
5173
5174 * Socket units gained new SocketUser= and SocketGroup=
5175 settings to set the owner user and group of AF_UNIX sockets
5176 and FIFOs in the file system.
5177
8d0e0ddd 5178 * Socket units gained a new RemoveOnStop= setting. If enabled,
04e91da2
LP
5179 all FIFOS and sockets in the file system will be removed
5180 when the specific socket unit is stopped.
5181
5182 * Socket units gained a new Symlinks= setting. It takes a list
5183 of symlinks to create to file system sockets or FIFOs
45df8656 5184 created by the specific Unix sockets. This is useful to
71449caf 5185 manage symlinks to socket nodes with the same life-cycle as
04e91da2
LP
5186 the socket itself.
5187
5188 * The /dev/log socket and /dev/initctl FIFO have been moved to
5189 /run, and have been replaced by symlinks. This allows
5190 connecting to these facilities even if PrivateDevices=yes is
5191 used for a service (which makes /dev/log itself unavailable,
5192 but /run is left). This also has the benefit of ensuring
5193 that /dev only contains device nodes, directories and
5194 symlinks, and nothing else.
5195
5196 * sd-daemon gained two new calls sd_pid_notify() and
5197 sd_pid_notifyf(). They are similar to sd_notify() and
5198 sd_notifyf(), but allow overriding of the source PID of
5199 notification messages if permissions permit this. This is
5200 useful to send notify messages on behalf of a different
5201 process (for example, the parent process). The
5202 systemd-notify tool has been updated to make use of this
5203 when sending messages (so that notification messages now
5204 originate from the shell script invoking systemd-notify and
5205 not the systemd-notify process itself. This should minimize
5206 a race where systemd fails to associate notification
5207 messages to services when the originating process already
5208 vanished.
5209
5210 * A new "on-abnormal" setting for Restart= has been added. If
8d0e0ddd 5211 set, it will result in automatic restarts on all "abnormal"
04e91da2
LP
5212 reasons for a process to exit, which includes unclean
5213 signals, core dumps, timeouts and watchdog timeouts, but
5214 does not include clean and unclean exit codes or clean
5215 signals. Restart=on-abnormal is an alternative for
5216 Restart=on-failure for services that shall be able to
5217 terminate and avoid restarts on certain errors, by
5218 indicating so with an unclean exit code. Restart=on-failure
5219 or Restart=on-abnormal is now the recommended setting for
5220 all long-running services.
5221
5222 * If the InaccessibleDirectories= service setting points to a
5223 mount point (or if there are any submounts contained within
5224 it), it is now attempted to completely unmount it, to make
5225 the file systems truly unavailable for the respective
5226 service.
5227
5228 * The ReadOnlyDirectories= service setting and
5229 systemd-nspawn's --read-only parameter are now recursively
5230 applied to all submounts, too.
5231
5232 * Mount units may now be created transiently via the bus APIs.
5233
5234 * The support for SysV and LSB init scripts has been removed
5235 from the systemd daemon itself. Instead, it is now
5236 implemented as a generator that creates native systemd units
5237 from these scripts when needed. This enables us to remove a
5238 substantial amount of legacy code from PID 1, following the
5239 fact that many distributions only ship a very small number
5240 of LSB/SysV init scripts nowadays.
5241
cc98b302 5242 * Privileged Xen (dom0) domains are not considered
04e91da2
LP
5243 virtualization anymore by the virtualization detection
5244 logic. After all, they generally have unrestricted access to
71449caf 5245 the hardware and usually are used to manage the unprivileged
04e91da2
LP
5246 (domU) domains.
5247
5248 * systemd-tmpfiles gained a new "C" line type, for copying
5249 files or entire directories.
5250
5251 * systemd-tmpfiles "m" lines are now fully equivalent to "z"
8d0e0ddd
JE
5252 lines. So far, they have been non-globbing versions of the
5253 latter, and have thus been redundant. In future, it is
5254 recommended to only use "z". "m" has hence been removed
04e91da2
LP
5255 from the documentation, even though it stays supported.
5256
5257 * A tmpfiles snippet to recreate the most basic structure in
5258 /var has been added. This is enough to create the /var/run →
5259 /run symlink and create a couple of structural
5260 directories. This allows systems to boot up with an empty or
8d0e0ddd
JE
5261 volatile /var. Of course, while with this change, the core OS
5262 now is capable with dealing with a volatile /var, not all
04e91da2 5263 user services are ready for it. However, we hope that sooner
8d0e0ddd 5264 or later, many service daemons will be changed upstream so
04e91da2
LP
5265 that they are able to automatically create their necessary
5266 directories in /var at boot, should they be missing. This is
5267 the first step to allow state-less systems that only require
5268 the vendor image for /usr to boot.
5269
5270 * systemd-nspawn has gained a new --tmpfs= switch to mount an
5271 empty tmpfs instance to a specific directory. This is
5272 particularly useful for making use of the automatic
5273 reconstruction of /var (see above), by passing --tmpfs=/var.
5274
5275 * Access modes specified in tmpfiles snippets may now be
5276 prefixed with "~", which indicates that they shall be masked
daa05349 5277 by whether the existing file or directory is currently
8d0e0ddd 5278 writable, readable or executable at all. Also, if specified,
04e91da2
LP
5279 the sgid/suid/sticky bits will be masked for all
5280 non-directories.
5281
5282 * A new passive target unit "network-pre.target" has been
5283 added which is useful for services that shall run before any
5284 network is configured, for example firewall scripts.
5285
4c0d13bd
LP
5286 * The "floppy" group that previously owned the /dev/fd*
5287 devices is no longer used. The "disk" group is now used
5288 instead. Distributions should probably deprecate usage of
5289 this group.
5290
dc1d6c02
LP
5291 Contributions from: Camilo Aguilar, Christian Hesse, Colin Ian
5292 King, Cristian Rodríguez, Daniel Buch, Dave Reisner, David
5293 Strauss, Denis Tikhomirov, John, Jonathan Liu, Kay Sievers,
5294 Lennart Poettering, Mantas Mikulėnas, Mark Eichin, Ronny
5295 Chevalier, Susant Sahani, Thomas Blume, Thomas Hindoe Paaboel
5296 Andersen, Tom Gundersen, Umut Tezduyar Lindskog, Zbigniew
5297 Jędrzejewski-Szmek
5298
ccddd104 5299 — Berlin, 2014-06-11
dc1d6c02 5300
6936cd89
LP
5301CHANGES WITH 213:
5302
5303 * A new "systemd-timesyncd" daemon has been added for
69beda1f 5304 synchronizing the system clock across the network. It
6936cd89 5305 implements an SNTP client. In contrast to NTP
8d0e0ddd 5306 implementations such as chrony or the NTP reference server,
6936cd89 5307 this only implements a client side, and does not bother with
c9679c65
LP
5308 the full NTP complexity, focusing only on querying time from
5309 one remote server and synchronizing the local clock to
6936cd89 5310 it. Unless you intend to serve NTP to networked clients or
8d0e0ddd 5311 want to connect to local hardware clocks, this simple NTP
6936cd89
LP
5312 client should be more than appropriate for most
5313 installations. The daemon runs with minimal privileges, and
5314 has been hooked up with networkd to only operate when
5315 network connectivity is available. The daemon saves the
5316 current clock to disk every time a new NTP sync has been
5317 acquired, and uses this to possibly correct the system clock
69beda1f 5318 early at bootup, in order to accommodate for systems that
6936cd89 5319 lack an RTC such as the Raspberry Pi and embedded devices,
8d0e0ddd 5320 and to make sure that time monotonically progresses on these
c9679c65 5321 systems, even if it is not always correct. To make use of
8d0e0ddd 5322 this daemon, a new system user and group "systemd-timesync"
c9679c65 5323 needs to be created on installation of systemd.
6936cd89 5324
69beda1f
KS
5325 * The queue "seqnum" interface of libudev has been disabled, as
5326 it was generally incompatible with device namespacing as
6936cd89
LP
5327 sequence numbers of devices go "missing" if the devices are
5328 part of a different namespace.
5329
5330 * "systemctl list-timers" and "systemctl list-sockets" gained
5331 a --recursive switch for showing units of these types also
499b604b
ZJS
5332 for all local containers, similar in style to the already
5333 supported --recursive switch for "systemctl list-units".
6936cd89
LP
5334
5335 * A new RebootArgument= setting has been added for service
5336 units, which may be used to specify a kernel reboot argument
499b604b 5337 to use when triggering reboots with StartLimitAction=.
6936cd89
LP
5338
5339 * A new FailureAction= setting has been added for service
5340 units which may be used to specify an operation to trigger
499b604b 5341 when a service fails. This works similarly to
8d0e0ddd 5342 StartLimitAction=, but unlike it, controls what is done
6936cd89
LP
5343 immediately rather than only after several attempts to
5344 restart the service in question.
5345
5346 * hostnamed got updated to also expose the kernel name,
499b604b
ZJS
5347 release, and version on the bus. This is useful for
5348 executing commands like hostnamectl with the -H switch.
5349 systemd-analyze makes use of this to properly display
5350 details when running non-locally.
6936cd89
LP
5351
5352 * The bootchart tool can now show cgroup information in the
5353 graphs it generates.
5354
5355 * The CFS CPU quota cgroup attribute is now exposed for
5356 services. The new CPUQuota= switch has been added for this
5357 which takes a percentage value. Setting this will have the
5358 result that a service may never get more CPU time than the
5359 specified percentage, even if the machine is otherwise idle.
5360
5361 * systemd-networkd learned IPIP and SIT tunnel support.
5362
5363 * LSB init scripts exposing a dependency on $network will now
5364 get a dependency on network-online.target rather than simply
5365 network.target. This should bring LSB handling closer to
5366 what it was on SysV systems.
5367
5368 * A new fsck.repair= kernel option has been added to control
5369 how fsck shall deal with unclean file systems at boot.
5370
5371 * The (.ini) configuration file parser will now silently
5372 ignore sections whose name begins with "X-". This may be
5373 used to maintain application-specific extension sections in unit
5374 files.
5375
5376 * machined gained a new API to query the IP addresses of
5377 registered containers. "machinectl status" has been updated
5378 to show these addresses in its output.
5379
5380 * A new call sd_uid_get_display() has been added to the
5381 sd-login APIs for querying the "primary" session of a
5382 user. The "primary" session of the user is elected from the
5383 user's sessions and generally a graphical session is
5384 preferred over a text one.
5385
5386 * A minimal systemd-resolved daemon has been added. It
5387 currently simply acts as a companion to systemd-networkd and
5388 manages resolv.conf based on per-interface DNS
5389 configuration, possibly supplied via DHCP. In the long run
5390 we hope to extend this into a local DNSSEC enabled DNS and
5391 mDNS cache.
5392
68dd0956
TG
5393 * The systemd-networkd-wait-online tool is now enabled by
5394 default. It will delay network-online.target until a network
5395 connection has been configured. The tool primarily integrates
5396 with networkd, but will also make a best effort to make sense
5397 of network configuration performed in some other way.
5398
6936cd89 5399 * Two new service options StartupCPUShares= and
499b604b 5400 StartupBlockIOWeight= have been added that work similarly to
6936cd89 5401 CPUShares= and BlockIOWeight= however only apply during
69beda1f 5402 system startup. This is useful to prioritize certain services
6936cd89
LP
5403 differently during bootup than during normal runtime.
5404
8e7acf67
LP
5405 * hostnamed has been changed to prefer the statically
5406 configured hostname in /etc/hostname (unless set to
5407 'localhost' or empty) over any dynamic one supplied by
8d0e0ddd 5408 dhcp. With this change, the rules for picking the hostname
8e7acf67
LP
5409 match more closely the rules of other configuration settings
5410 where the local administrator's configuration in /etc always
5411 overrides any other settings.
5412
5413 Contributions fron: Ali H. Caliskan, Alison Chaiken, Bas van
6936cd89
LP
5414 den Berg, Brandon Philips, Cristian Rodríguez, Daniel Buch,
5415 Dan Kilman, Dave Reisner, David Härdeman, David Herrmann,
5416 David Strauss, Dimitris Spingos, Djalal Harouni, Eelco
5417 Dolstra, Evan Nemerson, Florian Albrechtskirchinger, Greg
5418 Kroah-Hartman, Harald Hoyer, Holger Hans Peter Freyther, Jan
5419 Engelhardt, Jani Nikula, Jason St. John, Jeffrey Clark,
5420 Jonathan Boulle, Kay Sievers, Lennart Poettering, Lukas
5421 Nykryn, Lukasz Skalski, Łukasz Stelmach, Mantas Mikulėnas,
8e7acf67
LP
5422 Marcel Holtmann, Martin Pitt, Matthew Monaco, Michael
5423 Marineau, Michael Olbrich, Michal Sekletar, Mike Gilbert, Nis
5424 Martensen, Patrik Flykt, Philip Lorenz, poma, Ray Strode,
5425 Reyad Attiyat, Robert Milasan, Scott Thrasher, Stef Walter,
5426 Steven Siloti, Susant Sahani, Tanu Kaskinen, Thomas Bächler,
5427 Thomas Hindoe Paaboel Andersen, Tom Gundersen, Umut Tezduyar
5428 Lindskog, WaLyong Cho, Will Woods, Zbigniew
6936cd89
LP
5429 Jędrzejewski-Szmek
5430
ccddd104 5431 — Beijing, 2014-05-28
6936cd89 5432
51c61cda
LP
5433CHANGES WITH 212:
5434
5435 * When restoring the screen brightness at boot, stay away from
5436 the darkest setting or from the lowest 5% of the available
5437 range, depending on which is the larger value of both. This
5438 should effectively protect the user from rebooting into a
5439 black screen, should the brightness have been set to minimum
5440 by accident.
5441
5442 * sd-login gained a new sd_machine_get_class() call to
5443 determine the class ("vm" or "container") of a machine
5444 registered with machined.
5445
5446 * sd-login gained new calls
5447 sd_peer_get_{session,owner_uid,unit,user_unit,slice,machine_name}(),
5448 to query the identity of the peer of a local AF_UNIX
499b604b 5449 connection. They operate similarly to their sd_pid_get_xyz()
51c61cda
LP
5450 counterparts.
5451
5452 * PID 1 will now maintain a system-wide system state engine
5453 with the states "starting", "running", "degraded",
5454 "maintenance", "stopping". These states are bound to system
5455 startup, normal runtime, runtime with at least one failed
5456 service, rescue/emergency mode and system shutdown. This
5457 state is shown in the "systemctl status" output when no unit
5458 name is passed. It is useful to determine system state, in
5459 particularly when doing so for many systems or containers at
5460 once.
5461
5462 * A new command "list-machines" has been added to "systemctl"
5463 that lists all local OS containers and shows their system
5464 state (see above), if systemd runs inside of them.
5465
5466 * systemctl gained a new "-r" switch to recursively enumerate
5467 units on all local containers, when used with the
5468 "list-unit" command (which is the default one that is
5469 executed when no parameters are specified).
5470
5471 * The GPT automatic partition discovery logic will now honour
5472 two GPT partition flags: one may be set on a partition to
5473 cause it to be mounted read-only, and the other may be set
5474 on a partition to ignore it during automatic discovery.
5475
5476 * Two new GPT type UUIDs have been added for automatic root
70a44afe 5477 partition discovery, for 32-bit and 64-bit ARM. This is not
51c61cda
LP
5478 particularly useful for discovering the root directory on
5479 these architectures during bare-metal boots (since UEFI is
5480 not common there), but still very useful to allow booting of
5481 ARM disk images in nspawn with the -i option.
5482
5483 * MAC addresses of interfaces created with nspawn's
5484 --network-interface= switch will now be generated from the
5485 machine name, and thus be stable between multiple invocations
5486 of the container.
5487
5488 * logind will now automatically remove all IPC objects owned
5489 by a user if she or he fully logs out. This makes sure that
5490 users who are logged out cannot continue to consume IPC
5491 resources. This covers SysV memory, semaphores and message
5492 queues as well as POSIX shared memory and message
b8bde116
JE
5493 queues. Traditionally, SysV and POSIX IPC had no life-cycle
5494 limits. With this functionality, that is corrected. This may
5495 be turned off by using the RemoveIPC= switch of logind.conf.
51c61cda
LP
5496
5497 * The systemd-machine-id-setup and tmpfiles tools gained a
5498 --root= switch to operate on a specific root directory,
5499 instead of /.
5500
5501 * journald can now forward logged messages to the TTYs of all
5502 logged in users ("wall"). This is the default for all
5503 emergency messages now.
5504
5505 * A new tool systemd-journal-remote has been added to stream
5506 journal log messages across the network.
5507
5508 * /sys/fs/cgroup/ is now mounted read-only after all cgroup
5509 controller trees are mounted into it. Note that the
5510 directories mounted beneath it are not read-only. This is a
5511 security measure and is particularly useful because glibc
5512 actually includes a search logic to pick any tmpfs it can
5513 find to implement shm_open() if /dev/shm is not available
5514 (which it might very well be in namespaced setups).
5515
5516 * machinectl gained a new "poweroff" command to cleanly power
5517 down a local OS container.
5518
5519 * The PrivateDevices= unit file setting will now also drop the
5520 CAP_MKNOD capability from the capability bound set, and
5521 imply DevicePolicy=closed.
5522
5523 * PrivateDevices=, PrivateNetwork= and PrivateTmp= is now used
5524 comprehensively on all long-running systemd services where
5525 this is appropriate.
5526
5527 * systemd-udevd will now run in a disassociated mount
b8bde116 5528 namespace. To mount directories from udev rules, make sure to
51c61cda
LP
5529 pull in mount units via SYSTEMD_WANTS properties.
5530
5531 * The kdbus support gained support for uploading policy into
5532 the kernel. sd-bus gained support for creating "monitoring"
5533 connections that can eavesdrop into all bus communication
5534 for debugging purposes.
5535
5536 * Timestamps may now be specified in seconds since the UNIX
5537 epoch Jan 1st, 1970 by specifying "@" followed by the value
5538 in seconds.
5539
5540 * Native tcpwrap support in systemd has been removed. tcpwrap
5541 is old code, not really maintained anymore and has serious
5542 shortcomings, and better options such as firewalls
5543 exist. For setups that require tcpwrap usage, please
5544 consider invoking your socket-activated service via tcpd,
5545 like on traditional inetd.
5546
5547 * A new system.conf configuration option
5548 DefaultTimerAccuracySec= has been added that controls the
5549 default AccuracySec= setting of .timer units.
5550
b8bde116 5551 * Timer units gained a new WakeSystem= switch. If enabled,
51c61cda
LP
5552 timers configured this way will cause the system to resume
5553 from system suspend (if the system supports that, which most
5554 do these days).
5555
b8bde116 5556 * Timer units gained a new Persistent= switch. If enabled,
51c61cda
LP
5557 timers configured this way will save to disk when they have
5558 been last triggered. This information is then used on next
5559 reboot to possible execute overdue timer events, that
d28315e4
JE
5560 could not take place because the system was powered off.
5561 This enables simple anacron-like behaviour for timer units.
51c61cda
LP
5562
5563 * systemctl's "list-timers" will now also list the time a
5564 timer unit was last triggered in addition to the next time
5565 it will be triggered.
5566
5567 * systemd-networkd will now assign predictable IPv4LL
5568 addresses to its local interfaces.
5569
5570 Contributions from: Brandon Philips, Daniel Buch, Daniel Mack,
5571 Dave Reisner, David Herrmann, Gerd Hoffmann, Greg
5572 Kroah-Hartman, Hendrik Brueckner, Jason St. John, Josh
5573 Triplett, Kay Sievers, Lennart Poettering, Marc-Antoine
5574 Perennou, Michael Marineau, Michael Olbrich, Miklos Vajna,
5575 Patrik Flykt, poma, Sebastian Thorarensen, Thomas Bächler,
5576 Thomas Hindoe Paaboel Andersen, Tomasz Torcz, Tom Gundersen,
5577 Umut Tezduyar Lindskog, Wieland Hoffmann, Zbigniew
5578 Jędrzejewski-Szmek
5579
ccddd104 5580 — Berlin, 2014-03-25
51c61cda 5581
699b6b34
LP
5582CHANGES WITH 211:
5583
5584 * A new unit file setting RestrictAddressFamilies= has been
5585 added to restrict which socket address families unit
5586 processes gain access to. This takes address family names
5587 like "AF_INET" or "AF_UNIX", and is useful to minimize the
5588 attack surface of services via exotic protocol stacks. This
5589 is built on seccomp system call filters.
5590
5591 * Two new unit file settings RuntimeDirectory= and
5592 RuntimeDirectoryMode= have been added that may be used to
5593 manage a per-daemon runtime directories below /run. This is
5594 an alternative for setting up directory permissions with
5595 tmpfiles snippets, and has the advantage that the runtime
5596 directory's lifetime is bound to the daemon runtime and that
5597 the daemon starts up with an empty directory each time. This
5598 is particularly useful when writing services that drop
f1721625 5599 privileges using the User= or Group= setting.
699b6b34
LP
5600
5601 * The DeviceAllow= unit setting now supports globbing for
5602 matching against device group names.
5603
5604 * The systemd configuration file system.conf gained new
5605 settings DefaultCPUAccounting=, DefaultBlockIOAccounting=,
5606 DefaultMemoryAccounting= to globally turn on/off accounting
5607 for specific resources (cgroups) for all units. These
22e7062d 5608 settings may still be overridden individually in each unit
699b6b34
LP
5609 though.
5610
5611 * systemd-gpt-auto-generator is now able to discover /srv and
5612 root partitions in addition to /home and swap partitions. It
5613 also supports LUKS-encrypted partitions now. With this in
b8bde116 5614 place, automatic discovery of partitions to mount following
699b6b34 5615 the Discoverable Partitions Specification
56cadcb6 5616 (https://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec)
699b6b34
LP
5617 is now a lot more complete. This allows booting without
5618 /etc/fstab and without root= on the kernel command line on
b8bde116 5619 systems prepared appropriately.
699b6b34
LP
5620
5621 * systemd-nspawn gained a new --image= switch which allows
5622 booting up disk images and Linux installations on any block
5623 device that follow the Discoverable Partitions Specification
5624 (see above). This means that installations made with
5625 appropriately updated installers may now be started and
5626 deployed using container managers, completely
5627 unmodified. (We hope that libvirt-lxc will add support for
5628 this feature soon, too.)
5629
5630 * systemd-nspawn gained a new --network-macvlan= setting to
5631 set up a private macvlan interface for the
499b604b 5632 container. Similarly, systemd-networkd gained a new
699b6b34
LP
5633 Kind=macvlan setting in .netdev files.
5634
5635 * systemd-networkd now supports configuring local addresses
5636 using IPv4LL.
5637
5638 * A new tool systemd-network-wait-online has been added to
5639 synchronously wait for network connectivity using
5640 systemd-networkd.
5641
5642 * The sd-bus.h bus API gained a new sd_bus_track object for
5643 tracking the life-cycle of bus peers. Note that sd-bus.h is
5644 still not a public API though (unless you specify
5645 --enable-kdbus on the configure command line, which however
5646 voids your warranty and you get no API stability guarantee).
5647
5648 * The $XDG_RUNTIME_DIR runtime directories for each user are
5649 now individual tmpfs instances, which has the benefit of
5650 introducing separate pools for each user, with individual
4ef6e535 5651 size limits, and thus making sure that unprivileged clients
699b6b34
LP
5652 can no longer negatively impact the system or other users by
5653 filling up their $XDG_RUNTIME_DIR. A new logind.conf setting
5654 RuntimeDirectorySize= has been introduced that allows
5655 controlling the default size limit for all users. It
5656 defaults to 10% of the available physical memory. This is no
5657 replacement for quotas on tmpfs though (which the kernel
5658 still does not support), as /dev/shm and /tmp are still
4ef6e535 5659 shared resources used by both the system and unprivileged
699b6b34
LP
5660 users.
5661
5662 * logind will now automatically turn off automatic suspending
5663 on laptop lid close when more than one display is
5664 connected. This was previously expected to be implemented
5665 individually in desktop environments (such as GNOME),
5666 however has been added to logind now, in order to fix a
5667 boot-time race where a desktop environment might not have
5668 been started yet and thus not been able to take an inhibitor
5669 lock at the time where logind already suspends the system
5670 due to a closed lid.
5671
5672 * logind will now wait at least 30s after each system
5673 suspend/resume cycle, and 3min after system boot before
5674 suspending the system due to a closed laptop lid. This
5675 should give USB docking stations and similar enough time to
4ef6e535 5676 be probed and configured after system resume and boot in
699b6b34
LP
5677 order to then act as suspend blocker.
5678
5679 * systemd-run gained a new --property= setting which allows
5680 initialization of resource control properties (and others)
5681 for the created scope or service unit. Example: "systemd-run
5682 --property=BlockIOWeight=10 updatedb" may be used to run
5683 updatedb at a low block IO scheduling weight.
5684
5685 * systemd-run's --uid=, --gid=, --setenv=, --setenv= switches
5686 now also work in --scope mode.
5687
5688 * When systemd is compiled with kdbus support, basic support
5689 for enforced policies is now in place. (Note that enabling
5690 kdbus still voids your warranty and no API compatibility
5691 promises are made.)
5692
5693 Contributions from: Andrey Borzenkov, Ansgar Burchardt, Armin
5694 K., Daniel Mack, Dave Reisner, David Herrmann, Djalal Harouni,
5695 Harald Hoyer, Henrik Grindal Bakken, Jasper St. Pierre, Kay
5696 Sievers, Kieran Clancy, Lennart Poettering, Lukas Nykryn,
5697 Mantas Mikulėnas, Marcel Holtmann, Mark Oteiza, Martin Pitt,
5698 Mike Gilbert, Peter Rajnoha, poma, Samuli Suominen, Stef
5699 Walter, Susant Sahani, Tero Roponen, Thomas Andersen, Thomas
5700 Bächler, Thomas Hindoe Paaboel Andersen, Tomasz Torcz, Tom
5701 Gundersen, Umut Tezduyar Lindskog, Uoti Urpala, Zachary Cook,
5702 Zbigniew Jędrzejewski-Szmek
5703
ccddd104 5704 — Berlin, 2014-03-12
699b6b34 5705
43c71255
LP
5706CHANGES WITH 210:
5707
5708 * systemd will now relabel /dev after loading the SMACK policy
5709 according to SMACK rules.
5710
67dd87c5 5711 * A new unit file option AppArmorProfile= has been added to
43c71255
LP
5712 set the AppArmor profile for the processes of a unit.
5713
5714 * A new condition check ConditionArchitecture= has been added
5715 to conditionalize units based on the system architecture, as
5716 reported by uname()'s "machine" field.
5717
5718 * systemd-networkd now supports matching on the system
5719 virtualization, architecture, kernel command line, host name
5720 and machine ID.
5721
ed28905e 5722 * logind is now a lot more aggressive when suspending the
43c71255 5723 machine due to a closed laptop lid. Instead of acting only
b8bde116 5724 on the lid close action, it will continuously watch the lid
43c71255
LP
5725 status and act on it. This is useful for laptops where the
5726 power button is on the outside of the chassis so that it can
ed28905e 5727 be reached without opening the lid (such as the Lenovo
b8bde116 5728 Yoga). On those machines, logind will now immediately
ed28905e 5729 re-suspend the machine if the power button has been
43c71255
LP
5730 accidentally pressed while the laptop was suspended and in a
5731 backpack or similar.
5732
5733 * logind will now watch SW_DOCK switches and inhibit reaction
5734 to the lid switch if it is pressed. This means that logind
d27893ef 5735 will not suspend the machine anymore if the lid is closed
949138cc 5736 and the system is docked, if the laptop supports SW_DOCK
43c71255
LP
5737 notifications via the input layer. Note that ACPI docking
5738 stations do not generate this currently. Also note that this
5739 logic is usually not fully sufficient and Desktop
5740 Environments should take a lid switch inhibitor lock when an
5741 external display is connected, as systemd will not watch
5742 this on its own.
5743
5744 * nspawn will now make use of the devices cgroup controller by
5745 default, and only permit creation of and access to the usual
5746 API device nodes like /dev/null or /dev/random, as well as
5747 access to (but not creation of) the pty devices.
5748
5749 * We will now ship a default .network file for
5750 systemd-networkd that automatically configures DHCP for
5751 network interfaces created by nspawn's --network-veth or
5752 --network-bridge= switches.
5753
5754 * systemd will now understand the usual M, K, G, T suffixes
5755 according to SI conventions (i.e. to the base 1000) when
5756 referring to throughput and hardware metrics. It will stay
5757 with IEC conventions (i.e. to the base 1024) for software
5758 metrics, according to what is customary according to
5759 Wikipedia. We explicitly document which base applies for
5760 each configuration option.
5761
5762 * The DeviceAllow= setting in unit files now supports a syntax
ed28905e 5763 to whitelist an entire group of devices node majors at once,
43c71255 5764 based on the /proc/devices listing. For example, with the
b8bde116 5765 string "char-pts", it is now possible to whitelist all
43c71255
LP
5766 current and future pseudo-TTYs at once.
5767
5768 * sd-event learned a new "post" event source. Event sources of
5769 this type are triggered by the dispatching of any event
5770 source of a type that is not "post". This is useful for
5771 implementing clean-up and check event sources that are
5772 triggered by other work being done in the program.
5773
5774 * systemd-networkd is no longer statically enabled, but uses
5775 the usual [Install] sections so that it can be
5776 enabled/disabled using systemctl. It still is enabled by
5777 default however.
5778
b8bde116 5779 * When creating a veth interface pair with systemd-nspawn, the
43c71255
LP
5780 host side will now be prefixed with "vb-" if
5781 --network-bridge= is used, and with "ve-" if --network-veth
b8bde116 5782 is used. This way, it is easy to distinguish these cases on
43c71255
LP
5783 the host, for example to apply different configuration to
5784 them with systemd-networkd.
5785
d27893ef
LP
5786 * The compatibility libraries for libsystemd-journal.so,
5787 libsystem-id128.so, libsystemd-login.so and
5788 libsystemd-daemon.so do not make use of IFUNC
b8bde116 5789 anymore. Instead, we now build libsystemd.so multiple times
d27893ef
LP
5790 under these alternative names. This means that the footprint
5791 is drastically increased, but given that these are
b8bde116 5792 transitional compatibility libraries, this should not matter
d27893ef
LP
5793 much. This change has been made necessary to support the ARM
5794 platform for these compatibility libraries, as the ARM
d28315e4 5795 toolchain is not really at the same level as the toolchain
ed28905e 5796 for other architectures like x86 and does not support
d27893ef
LP
5797 IFUNC. Please make sure to use --enable-compat-libs only
5798 during a transitional period!
5799
13b28d82 5800 Contributions from: Andreas Fuchs, Armin K., Colin Walters,
43c71255
LP
5801 Daniel Mack, Dave Reisner, David Herrmann, Djalal Harouni,
5802 Holger Schurig, Jason A. Donenfeld, Jason St. John, Jasper
5803 St. Pierre, Kay Sievers, Lennart Poettering, Łukasz Stelmach,
5804 Marcel Holtmann, Michael Scherer, Michal Sekletar, Mike
5805 Gilbert, Samuli Suominen, Thomas Bächler, Thomas Hindoe
5806 Paaboel Andersen, Tom Gundersen, Umut Tezduyar Lindskog,
5807 Zbigniew Jędrzejewski-Szmek
5808
ccddd104 5809 — Berlin, 2014-02-24
43c71255 5810
e49b5aad
LP
5811CHANGES WITH 209:
5812
5813 * A new component "systemd-networkd" has been added that can
5814 be used to configure local network interfaces statically or
8b7d0494
JSJ
5815 via DHCP. It is capable of bringing up bridges, VLANs, and
5816 bonding. Currently, no hook-ups for interactive network
4670e9d5 5817 configuration are provided. Use this for your initrd,
8b7d0494
JSJ
5818 container, embedded, or server setup if you need a simple,
5819 yet powerful, network configuration solution. This
4670e9d5 5820 configuration subsystem is quite nifty, as it allows wildcard
1e190502 5821 hotplug matching in interfaces. For example, with a single
4670e9d5 5822 configuration snippet, you can configure that all Ethernet
1e190502
ZJS
5823 interfaces showing up are automatically added to a bridge,
5824 or similar. It supports link-sensing and more.
e49b5aad
LP
5825
5826 * A new tool "systemd-socket-proxyd" has been added which can
4c2413bf 5827 act as a bidirectional proxy for TCP sockets. This is
e49b5aad
LP
5828 useful for adding socket activation support to services that
5829 do not actually support socket activation, including virtual
4c2413bf 5830 machines and the like.
e49b5aad
LP
5831
5832 * Add a new tool to save/restore rfkill state on
5833 shutdown/boot.
5834
8b7d0494
JSJ
5835 * Save/restore state of keyboard backlights in addition to
5836 display backlights on shutdown/boot.
e49b5aad
LP
5837
5838 * udev learned a new SECLABEL{} construct to label device
5839 nodes with a specific security label when they appear. For
4c2413bf 5840 now, only SECLABEL{selinux} is supported, but the syntax is
e49b5aad
LP
5841 prepared for additional security frameworks.
5842
5843 * udev gained a new scheme to configure link-level attributes
5844 from files in /etc/systemd/network/*.link. These files can
8b7d0494 5845 match against MAC address, device path, driver name and type,
4c2413bf 5846 and will apply attributes like the naming policy, link speed,
8b7d0494 5847 MTU, duplex settings, Wake-on-LAN settings, MAC address, MAC
e49b5aad
LP
5848 address assignment policy (randomized, ...).
5849
dfb08b05
ZJS
5850 * The configuration of network interface naming rules for
5851 "permanent interface names" has changed: a new NamePolicy=
5852 setting in the [Link] section of .link files determines the
a8eaaee7 5853 priority of possible naming schemes (onboard, slot, MAC,
dfb08b05
ZJS
5854 path). The default value of this setting is determined by
5855 /usr/lib/net/links/99-default.link. Old
5856 80-net-name-slot.rules udev configuration file has been
5857 removed, so local configuration overriding this file should
ce830873 5858 be adapted to override 99-default.link instead.
dfb08b05 5859
e49b5aad 5860 * When the User= switch is used in a unit file, also
4c2413bf 5861 initialize $SHELL= based on the user database entry.
e49b5aad
LP
5862
5863 * systemd no longer depends on libdbus. All communication is
5864 now done with sd-bus, systemd's low-level bus library
5865 implementation.
5866
5867 * kdbus support has been added to PID 1 itself. When kdbus is
4c2413bf 5868 enabled, this causes PID 1 to set up the system bus and
e49b5aad
LP
5869 enable support for a new ".busname" unit type that
5870 encapsulates bus name activation on kdbus. It works a little
5871 bit like ".socket" units, except for bus names. A new
5872 generator has been added that converts classic dbus1 service
5873 activation files automatically into native systemd .busname
5874 and .service units.
5875
5876 * sd-bus: add a light-weight vtable implementation that allows
5877 defining objects on the bus with a simple static const
5878 vtable array of its methods, signals and properties.
5879
8b7d0494 5880 * systemd will not generate or install static dbus
e49b5aad 5881 introspection data anymore to /usr/share/dbus-1/interfaces,
1e190502 5882 as the precise format of these files is unclear, and
e49b5aad
LP
5883 nothing makes use of it.
5884
5885 * A proxy daemon is now provided to proxy clients connecting
5886 via classic D-Bus AF_UNIX sockets to kdbus, to provide full
5887 compatibility with classic D-Bus.
5888
5889 * A bus driver implementation has been added that supports the
5890 classic D-Bus bus driver calls on kdbus, also for
5891 compatibility purposes.
5892
5893 * A new API "sd-event.h" has been added that implements a
5894 minimal event loop API built around epoll. It provides a
5895 couple of features that direct epoll usage is lacking:
b9761003 5896 prioritization of events, scales to large numbers of timer
e49b5aad
LP
5897 events, per-event timer slack (accuracy), system-wide
5898 coalescing of timer events, exit handlers, watchdog
5899 supervision support using systemd's sd_notify() API, child
5900 process handling.
5901
5902 * A new API "sd-rntl.h" has been added that provides an API
5903 around the route netlink interface of the kernel, similar in
5904 style to "sd-bus.h".
5905
7e95eda5
PF
5906 * A new API "sd-dhcp-client.h" has been added that provides a
5907 small DHCPv4 client-side implementation. This is used by
e49b5aad
LP
5908 "systemd-networkd".
5909
4c2413bf 5910 * There is a new kernel command line option
8b7d0494
JSJ
5911 "systemd.restore_state=0|1". When set to "0", none of the
5912 systemd tools will restore saved runtime state to hardware
5913 devices. More specifically, the rfkill and backlight states
5914 are not restored.
e49b5aad
LP
5915
5916 * The FsckPassNo= compatibility option in mount/service units
5917 has been removed. The fstab generator will now add the
5918 necessary dependencies automatically, and does not require
5919 PID1's support for that anymore.
5920
8b7d0494 5921 * journalctl gained a new switch, --list-boots, that lists
e49b5aad
LP
5922 recent boots with their times and boot IDs.
5923
5924 * The various tools like systemctl, loginctl, timedatectl,
5925 busctl, systemd-run, ... have gained a new switch "-M" to
5926 connect to a specific, local OS container (as direct
5927 connection, without requiring SSH). This works on any
5928 container that is registered with machined, such as those
5929 created by libvirt-lxc or nspawn.
5930
5931 * systemd-run and systemd-analyze also gained support for "-H"
4c2413bf 5932 to connect to remote hosts via SSH. This is particularly
8b7d0494
JSJ
5933 useful for systemd-run because it enables queuing of jobs
5934 onto remote systems.
e49b5aad
LP
5935
5936 * machinectl gained a new command "login" to open a getty
5937 login in any local container. This works with any container
5938 that is registered with machined (such as those created by
8e420494 5939 libvirt-lxc or nspawn), and which runs systemd inside.
e49b5aad
LP
5940
5941 * machinectl gained a new "reboot" command that may be used to
5942 trigger a reboot on a specific container that is registered
5943 with machined. This works on any container that runs an init
5944 system of some kind.
5945
5946 * systemctl gained a new "list-timers" command to print a nice
5947 listing of installed timer units with the times they elapse
5948 next.
5949
5950 * Alternative reboot() parameters may now be specified on the
5951 "systemctl reboot" command line and are passed to the
5952 reboot() system call.
5953
5954 * systemctl gained a new --job-mode= switch to configure the
5955 mode to queue a job with. This is a more generic version of
8b7d0494 5956 --fail, --irreversible, and --ignore-dependencies, which are
e49b5aad
LP
5957 still available but not advertised anymore.
5958
e49b5aad
LP
5959 * /etc/systemd/system.conf gained new settings to configure
5960 various default timeouts of units, as well as the default
b9761003 5961 start limit interval and burst. These may still be overridden
e49b5aad
LP
5962 within each Unit.
5963
270f1624
LP
5964 * PID1 will now export on the bus profile data of the security
5965 policy upload process (such as the SELinux policy upload to
8e420494 5966 the kernel).
e49b5aad 5967
4670e9d5 5968 * journald: when forwarding logs to the console, include
1e190502
ZJS
5969 timestamps (following the setting in
5970 /sys/module/printk/parameters/time).
e49b5aad
LP
5971
5972 * OnCalendar= in timer units now understands the special
5973 strings "yearly" and "annually". (Both are equivalent)
5974
5975 * The accuracy of timer units is now configurable with the new
5976 AccuracySec= setting. It defaults to 1min.
5977
5978 * A new dependency type JoinsNamespaceOf= has been added that
5979 allows running two services within the same /tmp and network
5980 namespace, if PrivateNetwork= or PrivateTmp= are used.
5981
5982 * A new command "cat" has been added to systemctl. It outputs
5983 the original unit file of a unit, and concatenates the
1e190502
ZJS
5984 contents of additional "drop-in" unit file snippets, so that
5985 the full configuration is shown.
e49b5aad
LP
5986
5987 * systemctl now supports globbing on the various "list-xyz"
5988 commands, like "list-units" or "list-sockets", as well as on
1e190502
ZJS
5989 those commands which take multiple unit names.
5990
5991 * journalctl's --unit= switch gained support for globbing.
e49b5aad
LP
5992
5993 * All systemd daemons now make use of the watchdog logic so
5994 that systemd automatically notices when they hang.
5995
4c2413bf 5996 * If the $container_ttys environment variable is set,
e49b5aad
LP
5997 getty-generator will automatically spawn a getty for each
5998 listed tty. This is useful for container managers to request
5999 login gettys to be spawned on as many ttys as needed.
6000
6001 * %h, %s, %U specifier support is not available anymore when
6002 used in unit files for PID 1. This is because NSS calls are
6003 not safe from PID 1. They stay available for --user
6004 instances of systemd, and as special case for the root user.
6005
e49b5aad
LP
6006 * loginctl gained a new "--no-legend" switch to turn off output
6007 of the legend text.
6008
6009 * The "sd-login.h" API gained three new calls:
6010 sd_session_is_remote(), sd_session_get_remote_user(),
6011 sd_session_get_remote_host() to query information about
6012 remote sessions.
6013
8e420494
LP
6014 * The udev hardware database now also carries vendor/product
6015 information of SDIO devices.
e49b5aad
LP
6016
6017 * The "sd-daemon.h" API gained a new sd_watchdog_enabled() to
6018 determine whether watchdog notifications are requested by
6019 the system manager.
6020
1e190502 6021 * Socket-activated per-connection services now include a
e49b5aad
LP
6022 short description of the connection parameters in the
6023 description.
6024
4c2413bf 6025 * tmpfiles gained a new "--boot" option. When this is not used,
e49b5aad 6026 only lines where the command character is not suffixed with
4670e9d5 6027 "!" are executed. When this option is specified, those
1e190502
ZJS
6028 options are executed too. This partitions tmpfiles
6029 directives into those that can be safely executed at any
6030 time, and those which should be run only at boot (for
6031 example, a line that creates /run/nologin).
e49b5aad 6032
c0c5af00 6033 * A new API "sd-resolve.h" has been added which provides a simple
4c2413bf 6034 asynchronous wrapper around glibc NSS host name resolution
e49b5aad 6035 calls, such as getaddrinfo(). In contrast to glibc's
4c2413bf
JE
6036 getaddrinfo_a(), it does not use signals. In contrast to most
6037 other asynchronous name resolution libraries, this one does
6038 not reimplement DNS, but reuses NSS, so that alternate
e49b5aad 6039 host name resolution systems continue to work, such as mDNS,
8b7d0494 6040 LDAP, etc. This API is based on libasyncns, but it has been
e49b5aad
LP
6041 cleaned up for inclusion in systemd.
6042
6300b3ec
LP
6043 * The APIs "sd-journal.h", "sd-login.h", "sd-id128.h",
6044 "sd-daemon.h" are no longer found in individual libraries
6045 libsystemd-journal.so, libsystemd-login.so,
6046 libsystemd-id128.so, libsystemd-daemon.so. Instead, we have
8b7d0494
JSJ
6047 merged them into a single library, libsystemd.so, which
6048 provides all symbols. The reason for this is cyclic
e49b5aad 6049 dependencies, as these libraries tend to use each other's
d28315e4 6050 symbols. So far, we have managed to workaround that by linking
6300b3ec
LP
6051 a copy of a good part of our code into each of these
6052 libraries again and again, which, however, makes certain
6053 things hard to do, like sharing static variables. Also, it
6054 substantially increases footprint. With this change, there
6055 is only one library for the basic APIs systemd
6056 provides. Also, "sd-bus.h", "sd-memfd.h", "sd-event.h",
6057 "sd-rtnl.h", "sd-resolve.h", "sd-utf8.h" are found in this
6058 library as well, however are subject to the --enable-kdbus
6059 switch (see below). Note that "sd-dhcp-client.h" is not part
6060 of this library (this is because it only consumes, never
6061 provides, services of/to other APIs). To make the transition
8b7d0494 6062 easy from the separate libraries to the unified one, we
4c2413bf 6063 provide the --enable-compat-libs compile-time switch which
e49b5aad
LP
6064 will generate stub libraries that are compatible with the
6065 old ones but redirect all calls to the new one.
6066
8b7d0494 6067 * All of the kdbus logic and the new APIs "sd-bus.h",
e49b5aad 6068 "sd-memfd.h", "sd-event.h", "sd-rtnl.h", "sd-resolve.h",
8b7d0494
JSJ
6069 and "sd-utf8.h" are compile-time optional via the
6070 "--enable-kdbus" switch, and they are not compiled in by
6071 default. To make use of kdbus, you have to explicitly enable
4c2413bf 6072 the switch. Note however, that neither the kernel nor the
e49b5aad
LP
6073 userspace API for all of this is considered stable yet. We
6074 want to maintain the freedom to still change the APIs for
4c2413bf 6075 now. By specifying this build-time switch, you acknowledge
e49b5aad 6076 that you are aware of the instability of the current
ad42cf73
KS
6077 APIs.
6078
6079 * Also, note that while kdbus is pretty much complete,
e49b5aad 6080 it lacks one thing: proper policy support. This means you
8b7d0494 6081 can build a fully working system with all features; however,
4c2413bf
JE
6082 it will be highly insecure. Policy support will be added in
6083 one of the next releases, at the same time that we will
6084 declare the APIs stable.
e49b5aad 6085
81c7dd89 6086 * When the kernel command line argument "kdbus" is specified,
ad42cf73 6087 systemd will automatically load the kdbus.ko kernel module. At
8b7d0494 6088 this stage of development, it is only useful for testing kdbus
ad42cf73 6089 and should not be used in production. Note: if "--enable-kdbus"
8b7d0494 6090 is specified, and the kdbus.ko kernel module is available, and
ad42cf73
KS
6091 "kdbus" is added to the kernel command line, the entire system
6092 runs with kdbus instead of dbus-daemon, with the above mentioned
6093 problem of missing the system policy enforcement. Also a future
6094 version of kdbus.ko or a newer systemd will not be compatible with
6095 each other, and will unlikely be able to boot the machine if only
6096 one of them is updated.
6097
e49b5aad 6098 * systemctl gained a new "import-environment" command which
4c2413bf 6099 uploads the caller's environment (or parts thereof) into the
e49b5aad
LP
6100 service manager so that it is inherited by services started
6101 by the manager. This is useful to upload variables like
6102 $DISPLAY into the user service manager.
6103
6104 * A new PrivateDevices= switch has been added to service units
6105 which allows running a service with a namespaced /dev
6106 directory that does not contain any device nodes for
4c2413bf 6107 physical devices. More specifically, it only includes devices
8b7d0494 6108 such as /dev/null, /dev/urandom, and /dev/zero which are API
e49b5aad
LP
6109 entry points.
6110
6111 * logind has been extended to support behaviour like VT
6112 switching on seats that do not support a VT. This makes
6113 multi-session available on seats that are not the first seat
6114 (seat0), and on systems where kernel support for VTs has
8b7d0494 6115 been disabled at compile-time.
e49b5aad
LP
6116
6117 * If a process holds a delay lock for system sleep or shutdown
1e190502 6118 and fails to release it in time, we will now log its
e49b5aad
LP
6119 identity. This makes it easier to identify processes that
6120 cause slow suspends or power-offs.
6121
1e190502
ZJS
6122 * When parsing /etc/crypttab, support for a new key-slot=
6123 option as supported by Debian is added. It allows indicating
6124 which LUKS slot to use on disk, speeding up key loading.
e49b5aad 6125
000b1ba5 6126 * The sd_journal_sendv() API call has been checked and
1e190502
ZJS
6127 officially declared to be async-signal-safe so that it may
6128 be invoked from signal handlers for logging purposes.
e49b5aad
LP
6129
6130 * Boot-time status output is now enabled automatically after a
6131 short timeout if boot does not progress, in order to give
8e420494 6132 the user an indication what she or he is waiting for.
1e190502
ZJS
6133
6134 * The boot-time output has been improved to show how much time
6135 remains until jobs expire.
e49b5aad
LP
6136
6137 * The KillMode= switch in service units gained a new possible
8b7d0494 6138 value "mixed". If set, and the unit is shut down, then the
e49b5aad 6139 initial SIGTERM signal is sent only to the main daemon
8e420494 6140 process, while the following SIGKILL signal is sent to
e49b5aad
LP
6141 all remaining processes of the service.
6142
4c2413bf
JE
6143 * When a scope unit is registered, a new property "Controller"
6144 may be set. If set to a valid bus name, systemd will send a
e49b5aad
LP
6145 RequestStop() signal to this name when it would like to shut
6146 down the scope. This may be used to hook manager logic into
6147 the shutdown logic of scope units. Also, scope units may now
8b7d0494 6148 be put in a special "abandoned" state, in which case the
e49b5aad
LP
6149 manager process which created them takes no further
6150 responsibilities for it.
6151
1e190502 6152 * When reading unit files, systemd will now verify
e49b5aad
LP
6153 the access mode of these files, and warn about certain
6154 suspicious combinations. This has been added to make it
6155 easier to track down packaging bugs where unit files are
6156 marked executable or world-writable.
6157
6158 * systemd-nspawn gained a new "--setenv=" switch to set
8b7d0494 6159 container-wide environment variables. The similar option in
1e190502
ZJS
6160 systemd-activate was renamed from "--environment=" to
6161 "--setenv=" for consistency.
e49b5aad
LP
6162
6163 * systemd-nspawn has been updated to create a new kdbus domain
6164 for each container that is invoked, thus allowing each
b9761003 6165 container to have its own set of system and user buses,
8b7d0494 6166 independent of the host.
e49b5aad
LP
6167
6168 * systemd-nspawn gained a new --drop-capability= switch to run
6169 the container with less capabilities than the default. Both
b9761003 6170 --drop-capability= and --capability= now take the special
e49b5aad
LP
6171 string "all" for dropping or keeping all capabilities.
6172
6173 * systemd-nspawn gained new switches for executing containers
6174 with specific SELinux labels set.
6175
6176 * systemd-nspawn gained a new --quiet switch to not generate
6177 any additional output but the container's own console
6178 output.
6179
6180 * systemd-nspawn gained a new --share-system switch to run a
6181 container without PID namespacing enabled.
6182
6183 * systemd-nspawn gained a new --register= switch to control
1e190502 6184 whether the container is registered with systemd-machined or
8e420494 6185 not. This is useful for containers that do not run full
e49b5aad
LP
6186 OS images, but only specific apps.
6187
6188 * systemd-nspawn gained a new --keep-unit which may be used
8b7d0494 6189 when invoked as the only program from a service unit, and
e49b5aad 6190 results in registration of the unit service itself in
1e190502 6191 systemd-machined, instead of a newly opened scope unit.
e49b5aad
LP
6192
6193 * systemd-nspawn gained a new --network-interface= switch for
6194 moving arbitrary interfaces to the container. The new
4c2413bf 6195 --network-veth switch creates a virtual Ethernet connection
8b7d0494
JSJ
6196 between host and container. The new --network-bridge=
6197 switch then allows assigning the host side of this virtual
6198 Ethernet connection to a bridge device.
e49b5aad 6199
6afc95b7
LP
6200 * systemd-nspawn gained a new --personality= switch for
6201 setting the kernel personality for the container. This is
70a44afe 6202 useful when running a 32-bit container on a 64-bit host. A
b8bde116
JE
6203 similar option Personality= is now also available for service
6204 units to use.
6afc95b7 6205
e49b5aad
LP
6206 * logind will now also track a "Desktop" identifier for each
6207 session which encodes the desktop environment of it. This is
6208 useful for desktop environments that want to identify
6209 multiple running sessions of itself easily.
6210
6211 * A new SELinuxContext= setting for service units has been
6212 added that allows setting a specific SELinux execution
6213 context for a service.
6214
6215 * Most systemd client tools will now honour $SYSTEMD_LESS for
6216 settings of the "less" pager. By default, these tools will
8b7d0494
JSJ
6217 override $LESS to allow certain operations to work, such as
6218 jump-to-the-end. With $SYSTEMD_LESS, it is possible to
e49b5aad
LP
6219 influence this logic.
6220
6221 * systemd's "seccomp" hook-up has been changed to make use of
6222 the libseccomp library instead of using its own
6223 implementation. This has benefits for portability among
6224 other things.
6225
4c2413bf 6226 * For usage together with SystemCallFilter=, a new
8b7d0494 6227 SystemCallErrorNumber= setting has been introduced that
b8bde116
JE
6228 allows configuration of a system error number to be returned
6229 on filtered system calls, instead of immediately killing the
e49b5aad
LP
6230 process. Also, SystemCallArchitectures= has been added to
6231 limit access to system calls of a particular architecture
6232 (in order to turn off support for unused secondary
4c2413bf 6233 architectures). There is also a global
8b7d0494 6234 SystemCallArchitectures= setting in system.conf now to turn
e49b5aad
LP
6235 off support for non-native system calls system-wide.
6236
210054d7
KS
6237 * systemd requires a kernel with a working name_to_handle_at(),
6238 please see the kernel config requirements in the README file.
6239
e49b5aad
LP
6240 Contributions from: Adam Williamson, Alex Jia, Anatol Pomozov,
6241 Ansgar Burchardt, AppleBloom, Auke Kok, Bastien Nocera,
6242 Chengwei Yang, Christian Seiler, Colin Guthrie, Colin Walters,
6243 Cristian Rodríguez, Daniel Buch, Daniele Medri, Daniel J
6244 Walsh, Daniel Mack, Dan McGee, Dave Reisner, David Coppa,
6245 David Herrmann, David Strauss, Djalal Harouni, Dmitry Pisklov,
6246 Elia Pinto, Florian Weimer, George McCollister, Goffredo
6247 Baroncelli, Greg Kroah-Hartman, Hendrik Brueckner, Igor
6248 Zhbanov, Jan Engelhardt, Jan Janssen, Jason A. Donenfeld,
6249 Jason St. John, Jasper St. Pierre, Jóhann B. Guðmundsson, Jose
6250 Ignacio Naranjo, Karel Zak, Kay Sievers, Kristian Høgsberg,
6251 Lennart Poettering, Lubomir Rintel, Lukas Nykryn, Lukasz
6252 Skalski, Łukasz Stelmach, Luke Shumaker, Mantas Mikulėnas,
6253 Marc-Antoine Perennou, Marcel Holtmann, Marcos Felipe Rasia de
6254 Mello, Marko Myllynen, Martin Pitt, Matthew Monaco, Michael
6255 Marineau, Michael Scherer, Michał Górny, Michal Sekletar,
6256 Michele Curti, Oleksii Shevchuk, Olivier Brunel, Patrik Flykt,
6257 Pavel Holica, Raudi, Richard Marko, Ronny Chevalier, Sébastien
6258 Luttringer, Sergey Ptashnick, Shawn Landden, Simon Peeters,
6259 Stefan Beller, Susant Sahani, Sylvain Plantefeve, Sylvia Else,
6260 Tero Roponen, Thomas Bächler, Thomas Hindoe Paaboel Andersen,
6261 Tom Gundersen, Umut Tezduyar Lindskog, Unai Uribarri, Václav
6262 Pavlín, Vincent Batts, WaLyong Cho, William Giokas, Yang
6263 Zhiyong, Yin Kangkai, Yuxuan Shui, Zbigniew Jędrzejewski-Szmek
6264
ccddd104 6265 — Berlin, 2014-02-20
e49b5aad 6266
cd4010b3
LP
6267CHANGES WITH 208:
6268
6269 * logind has gained support for facilitating privileged input
6270 and drm device access for unprivileged clients. This work is
6271 useful to allow Wayland display servers (and similar
6272 programs, such as kmscon) to run under the user's ID and
6273 access input and drm devices which are normally
6274 protected. When this is used (and the kernel is new enough)
6275 logind will "mute" IO on the file descriptors passed to
6276 Wayland as long as it is in the background and "unmute" it
6277 if it returns into the foreground. This allows secure
6278 session switching without allowing background sessions to
6279 eavesdrop on input and display data. This also introduces
6280 session switching support if VT support is turned off in the
6281 kernel, and on seats that are not seat0.
6282
6283 * A new kernel command line option luks.options= is understood
06b643e7 6284 now which allows specifying LUKS options for usage for LUKS
cd4010b3
LP
6285 encrypted partitions specified with luks.uuid=.
6286
6287 * tmpfiles.d(5) snippets may now use specifier expansion in
6288 path names. More specifically %m, %b, %H, %v, are now
6289 replaced by the local machine id, boot id, hostname, and
6290 kernel version number.
6291
6292 * A new tmpfiles.d(5) command "m" has been introduced which
6293 may be used to change the owner/group/access mode of a file
d28315e4 6294 or directory if it exists, but do nothing if it does not.
cd4010b3
LP
6295
6296 * This release removes high-level support for the
6297 MemorySoftLimit= cgroup setting. The underlying kernel
6298 cgroup attribute memory.soft_limit= is currently badly
6299 designed and likely to be removed from the kernel API in its
d28315e4 6300 current form, hence we should not expose it for now.
cd4010b3
LP
6301
6302 * The memory.use_hierarchy cgroup attribute is now enabled for
6303 all cgroups systemd creates in the memory cgroup
6304 hierarchy. This option is likely to be come the built-in
cc98b302
TH
6305 default in the kernel anyway, and the non-hierarchical mode
6306 never made much sense in the intrinsically hierarchical
cd4010b3
LP
6307 cgroup system.
6308
6309 * A new field _SYSTEMD_SLICE= is logged along with all journal
6310 messages containing the slice a message was generated
6311 from. This is useful to allow easy per-customer filtering of
6312 logs among other things.
6313
6314 * systemd-journald will no longer adjust the group of journal
6315 files it creates to the "systemd-journal" group. Instead we
6316 rely on the journal directory to be owned by the
6317 "systemd-journal" group, and its setgid bit set, so that the
6318 kernel file system layer will automatically enforce that
6319 journal files inherit this group assignment. The reason for
6320 this change is that we cannot allow NSS look-ups from
6321 journald which would be necessary to resolve
6322 "systemd-journal" to a numeric GID, because this might
6323 create deadlocks if NSS involves synchronous queries to
6324 other daemons (such as nscd, or sssd) which in turn are
6325 logging clients of journald and might block on it, which
6326 would then dead lock. A tmpfiles.d(5) snippet included in
6327 systemd will make sure the setgid bit and group are
6328 properly set on the journal directory if it exists on every
6329 boot. However, we recommend adjusting it manually after
6330 upgrades too (or from RPM scriptlets), so that the change is
6331 not delayed until next reboot.
6332
6333 * Backlight and random seed files in /var/lib/ have moved into
6334 the /var/lib/systemd/ directory, in order to centralize all
6335 systemd generated files in one directory.
6336
6337 * Boot time performance measurements (as displayed by
6338 "systemd-analyze" for example) will now read ACPI 5.0 FPDT
6339 performance information if that's available to determine how
6340 much time BIOS and boot loader initialization required. With
6341 a sufficiently new BIOS you hence no longer need to boot
6342 with Gummiboot to get access to such information.
6343
6344 Contributions from: Andrey Borzenkov, Chen Jie, Colin Walters,
6345 Cristian Rodríguez, Dave Reisner, David Herrmann, David
6346 Mackey, David Strauss, Eelco Dolstra, Evan Callicoat, Gao
6347 feng, Harald Hoyer, Jimmie Tauriainen, Kay Sievers, Lennart
6348 Poettering, Lukas Nykryn, Mantas Mikulėnas, Martin Pitt,
6349 Michael Scherer, Michał Górny, Mike Gilbert, Patrick McCarty,
6350 Sebastian Ott, Tom Gundersen, Zbigniew Jędrzejewski-Szmek
6351
ccddd104 6352 — Berlin, 2013-10-02
cd4010b3 6353
4f0be680
LP
6354CHANGES WITH 207:
6355
6356 * The Restart= option for services now understands a new
f3a165b0 6357 on-watchdog setting, which will restart the service
4f0be680
LP
6358 automatically if the service stops sending out watchdog keep
6359 alive messages (as configured with WatchdogSec=).
6360
6361 * The getty generator (which is responsible for bringing up a
6362 getty on configured serial consoles) will no longer only
6363 start a getty on the primary kernel console but on all
6364 others, too. This makes the order in which console= is
6365 specified on the kernel command line less important.
6366
6367 * libsystemd-logind gained a new sd_session_get_vt() call to
6368 retrieve the VT number of a session.
6369
6370 * If the option "tries=0" is set for an entry of /etc/crypttab
6371 its passphrase is queried indefinitely instead of any
6372 maximum number of tries.
6373
6374 * If a service with a configure PID file terminates its PID
6375 file will now be removed automatically if it still exists
6376 afterwards. This should put an end to stale PID files.
6377
6378 * systemd-run will now also take relative binary path names
6379 for execution and no longer insists on absolute paths.
6380
6381 * InaccessibleDirectories= and ReadOnlyDirectories= now take
6382 paths that are optionally prefixed with "-" to indicate that
d28315e4 6383 it should not be considered a failure if they do not exist.
4f0be680 6384
f3a165b0
KS
6385 * journalctl -o (and similar commands) now understands a new
6386 output mode "short-precise", it is similar to "short" but
4f0be680
LP
6387 shows timestamps with usec accuracy.
6388
6389 * The option "discard" (as known from Debian) is now
6390 synonymous to "allow-discards" in /etc/crypttab. In fact,
387abf80 6391 "discard" is preferred now (since it is easier to remember
4f0be680
LP
6392 and type).
6393
f3a165b0 6394 * Some licensing clean-ups were made, so that more code is now
4f0be680
LP
6395 LGPL-2.1 licensed than before.
6396
6397 * A minimal tool to save/restore the display backlight
6398 brightness across reboots has been added. It will store the
f3a165b0 6399 backlight setting as late as possible at shutdown, and
4f0be680
LP
6400 restore it as early as possible during reboot.
6401
6402 * A logic to automatically discover and enable home and swap
6403 partitions on GPT disks has been added. With this in place
6404 /etc/fstab becomes optional for many setups as systemd can
6405 discover certain partitions located on the root disk
6406 automatically. Home partitions are recognized under their
6407 GPT type ID 933ac7e12eb44f13b8440e14e2aef915. Swap
6408 partitions are recognized under their GPT type ID
6409 0657fd6da4ab43c484e50933c84b4f4f.
6410
6411 * systemd will no longer pass any environment from the kernel
6412 or initrd to system services. If you want to set an
6413 environment for all services, do so via the kernel command
6414 line systemd.setenv= assignment.
6415
387abf80
LP
6416 * The systemd-sysctl tool no longer natively reads the file
6417 /etc/sysctl.conf. If desired, the file should be symlinked
6418 from /etc/sysctl.d/99-sysctl.conf. Apart from providing
6419 legacy support by a symlink rather than built-in code, it
6420 also makes the otherwise hidden order of application of the
6421 different files visible. (Note that this partly reverts to a
6422 pre-198 application order of sysctl knobs!)
04bf3c1a 6423
4f0be680
LP
6424 * The "systemctl set-log-level" and "systemctl dump" commands
6425 have been moved to systemd-analyze.
6426
6427 * systemd-run learned the new --remain-after-exit switch,
6428 which causes the scope unit not to be cleaned up
6429 automatically after the process terminated.
6430
6431 * tmpfiles learned a new --exclude-prefix= switch to exclude
6432 certain paths from operation.
6433
6434 * journald will now automatically flush all messages to disk
f47ad593
ZJS
6435 as soon as a message at the log level CRIT, ALERT or EMERG
6436 is received.
4f0be680
LP
6437
6438 Contributions from: Andrew Cook, Brandon Philips, Christian
6439 Hesse, Christoph Junghans, Colin Walters, Daniel Schaal,
6440 Daniel Wallace, Dave Reisner, David Herrmann, Gao feng, George
6441 McCollister, Giovanni Campagna, Hannes Reinecke, Harald Hoyer,
6442 Herczeg Zsolt, Holger Hans Peter Freyther, Jan Engelhardt,
6443 Jesper Larsen, Kay Sievers, Khem Raj, Lennart Poettering,
6444 Lukas Nykryn, Maciej Wereski, Mantas Mikulėnas, Marcel
6445 Holtmann, Martin Pitt, Michael Biebl, Michael Marineau,
6446 Michael Scherer, Michael Stapelberg, Michal Sekletar, Michał
6447 Górny, Olivier Brunel, Ondrej Balaz, Ronny Chevalier, Shawn
6448 Landden, Steven Hiscocks, Thomas Bächler, Thomas Hindoe
6449 Paaboel Andersen, Tom Gundersen, Umut Tezduyar, WANG Chao,
6450 William Giokas, Zbigniew Jędrzejewski-Szmek
6451
ccddd104 6452 — Berlin, 2013-09-13
4f0be680 6453
408f281b
LP
6454CHANGES WITH 206:
6455
6456 * The documentation has been updated to cover the various new
6457 concepts introduced with 205.
6458
6459 * Unit files now understand the new %v specifier which
6460 resolves to the kernel version string as returned by "uname
6461 -r".
6462
6463 * systemctl now supports filtering the unit list output by
6464 load state, active state and sub state, using the new
33b521be 6465 --state= parameter.
408f281b
LP
6466
6467 * "systemctl status" will now show the results of the
6468 condition checks (like ConditionPathExists= and similar) of
6469 the last start attempts of the unit. They are also logged to
6470 the journal.
6471
6472 * "journalctl -b" may now be used to look for boot output of a
6473 specific boot. Try "journalctl -b -1" for the previous boot,
6474 but the syntax is substantially more powerful.
6475
6476 * "journalctl --show-cursor" has been added which prints the
6477 cursor string the last shown log line. This may then be used
6478 with the new "journalctl --after-cursor=" switch to continue
6479 browsing logs from that point on.
6480
6481 * "journalctl --force" may now be used to force regeneration
6482 of an FSS key.
6483
251cc819
LP
6484 * Creation of "dead" device nodes has been moved from udev
6485 into kmod and tmpfiles. Previously, udev would read the kmod
6486 databases to pre-generate dead device nodes based on meta
6487 information contained in kernel modules, so that these would
6488 be auto-loaded on access rather then at boot. As this
d28315e4 6489 does not really have much to do with the exposing actual
251cc819
LP
6490 kernel devices to userspace this has always been slightly
6491 alien in the udev codebase. Following the new scheme kmod
6492 will now generate a runtime snippet for tmpfiles from the
6493 module meta information and it now is tmpfiles' job to the
6494 create the nodes. This also allows overriding access and
6495 other parameters for the nodes using the usual tmpfiles
6496 facilities. As side effect this allows us to remove the
6497 CAP_SYS_MKNOD capability bit from udevd entirely.
6498
6499 * logind's device ACLs may now be applied to these "dead"
6500 devices nodes too, thus finally allowing managed access to
ce830873 6501 devices such as /dev/snd/sequencer without loading the
251cc819 6502 backing module right-away.
408f281b
LP
6503
6504 * A new RPM macro has been added that may be used to apply
6505 tmpfiles configuration during package installation.
6506
6507 * systemd-detect-virt and ConditionVirtualization= now can
6508 detect User-Mode-Linux machines (UML).
6509
251cc819
LP
6510 * journald will now implicitly log the effective capabilities
6511 set of processes in the message metadata.
408f281b
LP
6512
6513 * systemd-cryptsetup has gained support for TrueCrypt volumes.
6514
6515 * The initrd interface has been simplified (more specifically,
6516 support for passing performance data via environment
6517 variables and fsck results via files in /run has been
6518 removed). These features were non-essential, and are
6519 nowadays available in a much nicer way by having systemd in
6520 the initrd serialize its state and have the hosts systemd
6521 deserialize it again.
6522
28f5c779
KS
6523 * The udev "keymap" data files and tools to apply keyboard
6524 specific mappings of scan to key codes, and force-release
6525 scan code lists have been entirely replaced by a udev
6526 "keyboard" builtin and a hwdb data file.
408f281b 6527
251cc819
LP
6528 * systemd will now honour the kernel's "quiet" command line
6529 argument also during late shutdown, resulting in a
6530 completely silent shutdown when used.
6531
6532 * There's now an option to control the SO_REUSEPORT socket
6533 option in .socket units.
6534
6535 * Instance units will now automatically get a per-template
6536 subslice of system.slice unless something else is explicitly
6537 configured. For example, instances of sshd@.service will now
6538 implicitly be placed in system-sshd.slice rather than
6539 system.slice as before.
6540
6541 * Test coverage support may now be enabled at build time.
6542
6543 Contributions from: Dave Reisner, Frederic Crozat, Harald
6544 Hoyer, Holger Hans Peter Freyther, Jan Engelhardt, Jan
6545 Janssen, Jason St. John, Jesper Larsen, Kay Sievers, Lennart
6546 Poettering, Lukas Nykryn, Maciej Wereski, Martin Pitt, Michael
6547 Olbrich, Ramkumar Ramachandra, Ross Lagerwall, Shawn Landden,
6548 Thomas H.P. Andersen, Tom Gundersen, Tomasz Torcz, William
6549 Giokas, Zbigniew Jędrzejewski-Szmek
6550
ccddd104 6551 — Berlin, 2013-07-23
4f0be680 6552
00aa832b
LP
6553CHANGES WITH 205:
6554
6555 * Two new unit types have been introduced:
6556
6557 Scope units are very similar to service units, however, are
ccddd104 6558 created out of pre-existing processes — instead of PID 1
00aa832b
LP
6559 forking off the processes. By using scope units it is
6560 possible for system services and applications to group their
6561 own child processes (worker processes) in a powerful way
6562 which then maybe used to organize them, or kill them
6563 together, or apply resource limits on them.
6564
6565 Slice units may be used to partition system resources in an
cc98b302 6566 hierarchical fashion and then assign other units to them. By
00aa832b
LP
6567 default there are now three slices: system.slice (for all
6568 system services), user.slice (for all user sessions),
6569 machine.slice (for VMs and containers).
6570
6571 Slices and scopes have been introduced primarily in
6572 context of the work to move cgroup handling to a
6573 single-writer scheme, where only PID 1
6574 creates/removes/manages cgroups.
6575
6576 * There's a new concept of "transient" units. In contrast to
6577 normal units these units are created via an API at runtime,
6578 not from configuration from disk. More specifically this
6579 means it is now possible to run arbitrary programs as
6580 independent services, with all execution parameters passed
6581 in via bus APIs rather than read from disk. Transient units
6582 make systemd substantially more dynamic then it ever was,
6583 and useful as a general batch manager.
6584
6585 * logind has been updated to make use of scope and slice units
6586 for managing user sessions. As a user logs in he will get
6587 his own private slice unit, to which all sessions are added
6588 as scope units. We also added support for automatically
6589 adding an instance of user@.service for the user into the
6590 slice. Effectively logind will no longer create cgroup
6591 hierarchies on its own now, it will defer entirely to PID 1
6592 for this by means of scope, service and slice units. Since
6593 user sessions this way become entities managed by PID 1
6594 the output of "systemctl" is now a lot more comprehensive.
6595
6596 * A new mini-daemon "systemd-machined" has been added which
6597 may be used by virtualization managers to register local
6598 VMs/containers. nspawn has been updated accordingly, and
6599 libvirt will be updated shortly. machined will collect a bit
6600 of meta information about the VMs/containers, and assign
6601 them their own scope unit (see above). The collected
6602 meta-data is then made available via the "machinectl" tool,
6603 and exposed in "ps" and similar tools. machined/machinectl
6604 is compile-time optional.
6605
6606 * As discussed earlier, the low-level cgroup configuration
6607 options ControlGroup=, ControlGroupModify=,
6608 ControlGroupPersistent=, ControlGroupAttribute= have been
6609 removed. Please use high-level attribute settings instead as
6610 well as slice units.
6611
6612 * A new bus call SetUnitProperties() has been added to alter
6613 various runtime parameters of a unit. This is primarily
6614 useful to alter cgroup parameters dynamically in a nice way,
6615 but will be extended later on to make more properties
6616 modifiable at runtime. systemctl gained a new set-properties
6617 command that wraps this call.
6618
6619 * A new tool "systemd-run" has been added which can be used to
6620 run arbitrary command lines as transient services or scopes,
6621 while configuring a number of settings via the command
6622 line. This tool is currently very basic, however already
6623 very useful. We plan to extend this tool to even allow
6624 queuing of execution jobs with time triggers from the
6625 command line, similar in fashion to "at".
6626
6627 * nspawn will now inform the user explicitly that kernels with
6628 audit enabled break containers, and suggest the user to turn
6629 off audit.
6630
6631 * Support for detecting the IMA and AppArmor security
6632 frameworks with ConditionSecurity= has been added.
6633
6634 * journalctl gained a new "-k" switch for showing only kernel
1fda0ab5
ZJS
6635 messages, mimicking dmesg output; in addition to "--user"
6636 and "--system" switches for showing only user's own logs
6637 and system logs.
00aa832b
LP
6638
6639 * systemd-delta can now show information about drop-in
6640 snippets extending unit files.
6641
6642 * libsystemd-bus has been substantially updated but is still
6643 not available as public API.
6644
6645 * systemd will now look for the "debug" argument on the kernel
499b604b 6646 command line and enable debug logging, similar to what
00aa832b
LP
6647 "systemd.log_level=debug" already did before.
6648
6649 * "systemctl set-default", "systemctl get-default" has been
6650 added to configure the default.target symlink, which
6651 controls what to boot into by default.
6652
1fda0ab5
ZJS
6653 * "systemctl set-log-level" has been added as a convenient
6654 way to raise and lower systemd logging threshold.
6655
00aa832b
LP
6656 * "systemd-analyze plot" will now show the time the various
6657 generators needed for execution, as well as information
6658 about the unit file loading.
6659
00aa832b
LP
6660 * libsystemd-journal gained a new sd_journal_open_files() call
6661 for opening specific journal files. journactl also gained a
6662 new switch to expose this new functionality. Previously we
6663 only supported opening all files from a directory, or all
6664 files from the system, as opening individual files only is
6665 racy due to journal file rotation.
6666
6667 * systemd gained the new DefaultEnvironment= setting in
6668 /etc/systemd/system.conf to set environment variables for
6669 all services.
6670
6671 * If a privileged process logs a journal message with the
6672 OBJECT_PID= field set, then journald will automatically
6673 augment this with additional OBJECT_UID=, OBJECT_GID=,
6674 OBJECT_COMM=, OBJECT_EXE=, ... fields. This is useful if
6675 system services want to log events about specific client
6676 processes. journactl/systemctl has been updated to make use
6677 of this information if all log messages regarding a specific
6678 unit is requested.
6679
6680 Contributions from: Auke Kok, Chengwei Yang, Colin Walters,
6681 Cristian Rodríguez, Daniel Albers, Daniel Wallace, Dave
6682 Reisner, David Coppa, David King, David Strauss, Eelco
6683 Dolstra, Gabriel de Perthuis, Harald Hoyer, Jan Alexander
6684 Steffens, Jan Engelhardt, Jan Janssen, Jason St. John, Johan
6685 Heikkilä, Karel Zak, Karol Lewandowski, Kay Sievers, Lennart
6686 Poettering, Lukas Nykryn, Mantas Mikulėnas, Marius Vollmer,
6687 Martin Pitt, Michael Biebl, Michael Olbrich, Michael Tremer,
6688 Michal Schmidt, Michał Bartoszkiewicz, Nirbheek Chauhan,
6689 Pierre Neidhardt, Ross Burton, Ross Lagerwall, Sean McGovern,
6690 Thomas Hindoe Paaboel Andersen, Tom Gundersen, Umut Tezduyar,
6691 Václav Pavlín, Zachary Cook, Zbigniew Jędrzejewski-Szmek,
6692 Łukasz Stelmach, 장동준
6693
606c24e3
LP
6694CHANGES WITH 204:
6695
6696 * The Python bindings gained some minimal support for the APIs
6697 exposed by libsystemd-logind.
6698
6699 * ConditionSecurity= gained support for detecting SMACK. Since
6700 this condition already supports SELinux and AppArmor we only
6701 miss IMA for this. Patches welcome!
6702
6703 Contributions from: Karol Lewandowski, Lennart Poettering,
6704 Zbigniew Jędrzejewski-Szmek
6705
2f3fcf85
LP
6706CHANGES WITH 203:
6707
6708 * systemd-nspawn will now create /etc/resolv.conf if
6709 necessary, before bind-mounting the host's file onto it.
6710
6711 * systemd-nspawn will now store meta information about a
6712 container on the container's cgroup as extended attribute
6713 fields, including the root directory.
6714
6715 * The cgroup hierarchy has been reworked in many ways. All
6716 objects any of the components systemd creates in the cgroup
b82eed9a 6717 tree are now suffixed. More specifically, user sessions are
2f3fcf85
LP
6718 now placed in cgroups suffixed with ".session", users in
6719 cgroups suffixed with ".user", and nspawn containers in
6720 cgroups suffixed with ".nspawn". Furthermore, all cgroup
6721 names are now escaped in a simple scheme to avoid collision
6722 of userspace object names with kernel filenames. This work
6723 is preparation for making these objects relocatable in the
6724 cgroup tree, in order to allow easy resource partitioning of
6725 these objects without causing naming conflicts.
6726
6727 * systemctl list-dependencies gained the new switches
6728 --plain, --reverse, --after and --before.
6729
6730 * systemd-inhibit now shows the process name of processes that
6731 have taken an inhibitor lock.
6732
6733 * nss-myhostname will now also resolve "localhost"
6734 implicitly. This makes /etc/hosts an optional file and
6735 nicely handles that on IPv6 ::1 maps to both "localhost" and
6736 the local hostname.
6737
6738 * libsystemd-logind.so gained a new call
6739 sd_get_machine_names() to enumerate running containers and
6740 VMs (currently only supported by very new libvirt and
6741 nspawn). sd_login_monitor can now be used to watch
6742 VMs/containers coming and going.
6743
6744 * .include is not allowed recursively anymore, and only in
6745 unit files. Usually it is better to use drop-in snippets in
6746 .d/*.conf anyway, as introduced with systemd 198.
6747
6748 * systemd-analyze gained a new "critical-chain" command that
6749 determines the slowest chain of units run during system
6750 boot-up. It is very useful for tracking down where
6751 optimizing boot time is the most beneficial.
6752
6753 * systemd will no longer allow manipulating service paths in
6754 the name=systemd:/system cgroup tree using ControlGroup= in
6755 units. (But is still fine with it in all other dirs.)
6756
6757 * There's a new systemd-nspawn@.service service file that may
6758 be used to easily run nspawn containers as system
6759 services. With the container's root directory in
6760 /var/lib/container/foobar it is now sufficient to run
6761 "systemctl start systemd-nspawn@foobar.service" to boot it.
6762
6763 * systemd-cgls gained a new parameter "--machine" to list only
6764 the processes within a certain container.
6765
6766 * ConditionSecurity= now can check for "apparmor". We still
6767 are lacking checks for SMACK and IMA for this condition
6768 check though. Patches welcome!
6769
6770 * A new configuration file /etc/systemd/sleep.conf has been
6771 added that may be used to configure which kernel operation
6772 systemd is supposed to execute when "suspend", "hibernate"
6773 or "hybrid-sleep" is requested. This makes the new kernel
6774 "freeze" state accessible to the user.
6775
6776 * ENV{SYSTEMD_WANTS} in udev rules will now implicitly escape
6777 the passed argument if applicable.
6778
6779 Contributions from: Auke Kok, Colin Guthrie, Colin Walters,
6780 Cristian Rodríguez, Daniel Buch, Daniel Wallace, Dave Reisner,
6781 Evangelos Foutras, Greg Kroah-Hartman, Harald Hoyer, Josh
6782 Triplett, Kay Sievers, Lennart Poettering, Lukas Nykryn,
6783 MUNEDA Takahiro, Mantas Mikulėnas, Mirco Tischler, Nathaniel
6784 Chen, Nirbheek Chauhan, Ronny Chevalier, Ross Lagerwall, Tom
6785 Gundersen, Umut Tezduyar, Ville Skyttä, Zbigniew
6786 Jędrzejewski-Szmek
6787
ef3b5246
LP
6788CHANGES WITH 202:
6789
6790 * The output of 'systemctl list-jobs' got some polishing. The
6791 '--type=' argument may now be passed more than once. A new
6792 command 'systemctl list-sockets' has been added which shows
6793 a list of kernel sockets systemd is listening on with the
6794 socket units they belong to, plus the units these socket
6795 units activate.
6796
6797 * The experimental libsystemd-bus library got substantial
6798 updates to work in conjunction with the (also experimental)
6799 kdbus kernel project. It works well enough to exchange
6800 messages with some sophistication. Note that kdbus is not
6801 ready yet, and the library is mostly an elaborate test case
6802 for now, and not installable.
6803
6804 * systemd gained a new unit 'systemd-static-nodes.service'
6805 that generates static device nodes earlier during boot, and
6806 can run in conjunction with udev.
6807
6808 * libsystemd-login gained a new call sd_pid_get_user_unit()
6809 to retrieve the user systemd unit a process is running
6810 in. This is useful for systems where systemd is used as
6811 session manager.
6812
6813 * systemd-nspawn now places all containers in the new /machine
6814 top-level cgroup directory in the name=systemd
6815 hierarchy. libvirt will soon do the same, so that we get a
6816 uniform separation of /system, /user and /machine for system
6817 services, user processes and containers/virtual
6818 machines. This new cgroup hierarchy is also useful to stick
6819 stable names to specific container instances, which can be
7c04ad2d 6820 recognized later this way (this name may be controlled
ef3b5246
LP
6821 via systemd-nspawn's new -M switch). libsystemd-login also
6822 gained a new call sd_pid_get_machine_name() to retrieve the
6823 name of the container/VM a specific process belongs to.
6824
6825 * bootchart can now store its data in the journal.
6826
6827 * libsystemd-journal gained a new call
6828 sd_journal_add_conjunction() for AND expressions to the
6829 matching logic. This can be used to express more complex
6830 logical expressions.
6831
6832 * journactl can now take multiple --unit= and --user-unit=
6833 switches.
6834
6835 * The cryptsetup logic now understands the "luks.key=" kernel
6836 command line switch for specifying a file to read the
7c04ad2d 6837 decryption key from. Also, if a configured key file is not
ef3b5246
LP
6838 found the tool will now automatically fall back to prompting
6839 the user.
6840
cbeabcfb
ZJS
6841 * Python systemd.journal module was updated to wrap recently
6842 added functions from libsystemd-journal. The interface was
6843 changed to bring the low level interface in s.j._Reader
6844 closer to the C API, and the high level interface in
6845 s.j.Reader was updated to wrap and convert all data about
6846 an entry.
6847
ef3b5246
LP
6848 Contributions from: Anatol Pomozov, Auke Kok, Harald Hoyer,
6849 Henrik Grindal Bakken, Josh Triplett, Kay Sievers, Lennart
6850 Poettering, Lukas Nykryn, Mantas Mikulėnas Marius Vollmer,
6851 Martin Jansa, Martin Pitt, Michael Biebl, Michal Schmidt,
6852 Mirco Tischler, Pali Rohar, Simon Peeters, Steven Hiscocks,
6853 Tom Gundersen, Zbigniew Jędrzejewski-Szmek
6854
d3a86981
LP
6855CHANGES WITH 201:
6856
6857 * journalctl --update-catalog now understands a new --root=
6858 option to operate on catalogs found in a different root
6859 directory.
6860
6861 * During shutdown after systemd has terminated all running
6862 services a final killing loop kills all remaining left-over
6863 processes. We will now print the name of these processes
6864 when we send SIGKILL to them, since this usually indicates a
6865 problem.
6866
6867 * If /etc/crypttab refers to password files stored on
6868 configured mount points automatic dependencies will now be
6869 generated to ensure the specific mount is established first
6870 before the key file is attempted to be read.
6871
6872 * 'systemctl status' will now show information about the
6873 network sockets a socket unit is listening on.
6874
6875 * 'systemctl status' will also shown information about any
6876 drop-in configuration file for units. (Drop-In configuration
6877 files in this context are files such as
6878 /etc/systemd/systemd/foobar.service.d/*.conf)
6879
6880 * systemd-cgtop now optionally shows summed up CPU times of
6881 cgroups. Press '%' while running cgtop to switch between
6882 percentage and absolute mode. This is useful to determine
6883 which cgroups use up the most CPU time over the entire
6884 runtime of the system. systemd-cgtop has also been updated
6885 to be 'pipeable' for processing with further shell tools.
6886
6887 * 'hostnamectl set-hostname' will now allow setting of FQDN
6888 hostnames.
6889
6890 * The formatting and parsing of time span values has been
6891 changed. The parser now understands fractional expressions
6892 such as "5.5h". The formatter will now output fractional
6893 expressions for all time spans under 1min, i.e. "5.123456s"
6894 rather than "5s 123ms 456us". For time spans under 1s
6895 millisecond values are shown, for those under 1ms
6896 microsecond values are shown. This should greatly improve
6897 all time-related output of systemd.
6898
6899 * libsystemd-login and libsystemd-journal gained new
6900 functions for querying the poll() events mask and poll()
6901 timeout value for integration into arbitrary event
6902 loops.
6903
6904 * localectl gained the ability to list available X11 keymaps
6905 (models, layouts, variants, options).
6906
6907 * 'systemd-analyze dot' gained the ability to filter for
6908 specific units via shell-style globs, to create smaller,
d28315e4 6909 more useful graphs. I.e. it is now possible to create simple
d3a86981
LP
6910 graphs of all the dependencies between only target units, or
6911 of all units that Avahi has dependencies with.
6912
6913 Contributions from: Cristian Rodríguez, Dr. Tilmann Bubeck,
6914 Harald Hoyer, Holger Hans Peter Freyther, Kay Sievers, Kelly
6915 Anderson, Koen Kooi, Lennart Poettering, Maksim Melnikau,
6916 Marc-Antoine Perennou, Marius Vollmer, Martin Pitt, Michal
6917 Schmidt, Oleksii Shevchuk, Ronny Chevalier, Simon McVittie,
6918 Steven Hiscocks, Thomas Weißschuh, Umut Tezduyar, Václav
6919 Pavlín, Zbigniew Jędrzejewski-Szmek, Łukasz Stelmach
6920
9ca3c17f
LP
6921CHANGES WITH 200:
6922
6923 * The boot-time readahead implementation for rotating media
6924 will now read the read-ahead data in multiple passes which
6925 consist of all read requests made in equidistant time
6926 intervals. This means instead of strictly reading read-ahead
6927 data in its physical order on disk we now try to find a
6928 middle ground between physical and access time order.
6929
6930 * /etc/os-release files gained a new BUILD_ID= field for usage
6931 on operating systems that provide continuous builds of OS
6932 images.
6933
6934 Contributions from: Auke Kok, Eelco Dolstra, Kay Sievers,
6935 Lennart Poettering, Lukas Nykryn, Martin Pitt, Václav Pavlín
6936 William Douglas, Zbigniew Jędrzejewski-Szmek
6937
35911459
LP
6938CHANGES WITH 199:
6939
6940 * systemd-python gained an API exposing libsystemd-daemon.
6941
6942 * The SMACK setup logic gained support for uploading CIPSO
6943 security policy.
6944
6945 * Behaviour of PrivateTmp=, ReadWriteDirectories=,
6946 ReadOnlyDirectories= and InaccessibleDirectories= has
6947 changed. The private /tmp and /var/tmp directories are now
6948 shared by all processes of a service (which means
6949 ExecStartPre= may now leave data in /tmp that ExecStart= of
6950 the same service can still access). When a service is
6951 stopped its temporary directories are immediately deleted
a87197f5 6952 (normal clean-up with tmpfiles is still done in addition to
35911459
LP
6953 this though).
6954
6955 * By default, systemd will now set a couple of sysctl
6956 variables in the kernel: the safe sysrq options are turned
6957 on, IP route verification is turned on, and source routing
6958 disabled. The recently added hardlink and softlink
6959 protection of the kernel is turned on. These settings should
6960 be reasonably safe, and good defaults for all new systems.
6961
6962 * The predictable network naming logic may now be turned off
a87197f5 6963 with a new kernel command line switch: net.ifnames=0.
35911459
LP
6964
6965 * A new libsystemd-bus module has been added that implements a
6966 pretty complete D-Bus client library. For details see:
6967
56cadcb6 6968 https://lists.freedesktop.org/archives/systemd-devel/2013-March/009797.html
35911459 6969
c20d8298 6970 * journald will now explicitly flush the journal files to disk
a87197f5
ZJS
6971 at the latest 5min after each write. The file will then also
6972 be marked offline until the next write. This should increase
6973 reliability in case of a crash. The synchronization delay
6974 can be configured via SyncIntervalSec= in journald.conf.
35911459
LP
6975
6976 * There's a new remote-fs-setup.target unit that can be used
6977 to pull in specific services when at least one remote file
6978 system is to be mounted.
6979
6980 * There are new targets timers.target and paths.target as
6981 canonical targets to pull user timer and path units in
6982 from. This complements sockets.target with a similar
6983 purpose for socket units.
6984
6a7d3d68
LP
6985 * libudev gained a new call udev_device_set_attribute_value()
6986 to set sysfs attributes of a device.
6987
a87197f5
ZJS
6988 * The udev daemon now sets the default number of worker
6989 processes executed in parallel based on the number of available
c20d8298 6990 CPUs instead of the amount of available RAM. This is supposed
ab06eef8 6991 to provide a more reliable default and limit a too aggressive
ce830873 6992 parallelism for setups with 1000s of devices connected.
c20d8298 6993
35911459
LP
6994 Contributions from: Auke Kok, Colin Walters, Cristian
6995 Rodríguez, Daniel Buch, Dave Reisner, Frederic Crozat, Hannes
6996 Reinecke, Harald Hoyer, Jan Alexander Steffens, Jan
6997 Engelhardt, Josh Triplett, Kay Sievers, Lennart Poettering,
6998 Mantas Mikulėnas, Martin Pitt, Mathieu Bridon, Michael Biebl,
6999 Michal Schmidt, Michal Sekletar, Miklos Vajna, Nathaniel Chen,
7000 Oleksii Shevchuk, Ozan Çağlayan, Thomas Hindoe Paaboel
7001 Andersen, Tollef Fog Heen, Tom Gundersen, Umut Tezduyar,
7002 Zbigniew Jędrzejewski-Szmek
7003
85d68397
LP
7004CHANGES WITH 198:
7005
7006 * Configuration of unit files may now be extended via drop-in
7007 files without having to edit/override the unit files
7008 themselves. More specifically, if the administrator wants to
7009 change one value for a service file foobar.service he can
7010 now do so by dropping in a configuration snippet into
ad88e758 7011 /etc/systemd/system/foobar.service.d/*.conf. The unit logic
85d68397
LP
7012 will load all these snippets and apply them on top of the
7013 main unit configuration file, possibly extending or
7014 overriding its settings. Using these drop-in snippets is
40e21da8
KS
7015 generally nicer than the two earlier options for changing
7016 unit files locally: copying the files from
85d68397
LP
7017 /usr/lib/systemd/system/ to /etc/systemd/system/ and editing
7018 them there; or creating a new file in /etc/systemd/system/
7019 that incorporates the original one via ".include". Drop-in
7020 snippets into these .d/ directories can be placed in any
fd868975 7021 directory systemd looks for units in, and the usual
85d68397
LP
7022 overriding semantics between /usr/lib, /etc and /run apply
7023 for them too.
7024
7025 * Most unit file settings which take lists of items can now be
6aa8d43a 7026 reset by assigning the empty string to them. For example,
85d68397
LP
7027 normally, settings such as Environment=FOO=BAR append a new
7028 environment variable assignment to the environment block,
7029 each time they are used. By assigning Environment= the empty
7030 string the environment block can be reset to empty. This is
7031 particularly useful with the .d/*.conf drop-in snippets
156f7d09
KS
7032 mentioned above, since this adds the ability to reset list
7033 settings from vendor unit files via these drop-ins.
85d68397
LP
7034
7035 * systemctl gained a new "list-dependencies" command for
7036 listing the dependencies of a unit recursively.
7037
40e21da8 7038 * Inhibitors are now honored and listed by "systemctl
85d68397
LP
7039 suspend", "systemctl poweroff" (and similar) too, not only
7040 GNOME. These commands will also list active sessions by
7041 other users.
7042
7043 * Resource limits (as exposed by the various control group
7044 controllers) can now be controlled dynamically at runtime
7045 for all units. More specifically, you can now use a command
7046 like "systemctl set-cgroup-attr foobar.service cpu.shares
7047 2000" to alter the CPU shares a specific service gets. These
6aa8d43a 7048 settings are stored persistently on disk, and thus allow the
85d68397
LP
7049 administrator to easily adjust the resource usage of
7050 services with a few simple commands. This dynamic resource
6aa8d43a 7051 management logic is also available to other programs via the
85d68397
LP
7052 bus. Almost any kernel cgroup attribute and controller is
7053 supported.
7054
7055 * systemd-vconsole-setup will now copy all font settings to
6aa8d43a
LP
7056 all allocated VTs, where it previously applied them only to
7057 the foreground VT.
85d68397
LP
7058
7059 * libsystemd-login gained the new sd_session_get_tty() API
7060 call.
7061
6aa8d43a
LP
7062 * This release drops support for a few legacy or
7063 distribution-specific LSB facility names when parsing init
7064 scripts: $x-display-manager, $mail-transfer-agent,
85d68397
LP
7065 $mail-transport-agent, $mail-transfer-agent, $smtp,
7066 $null. Also, the mail-transfer-agent.target unit backing
7067 this has been removed. Distributions which want to retain
6aa8d43a
LP
7068 compatibility with this should carry the burden for
7069 supporting this themselves and patch support for these back
7070 in, if they really need to. Also, the facilities $syslog and
7071 $local_fs are now ignored, since systemd does not support
7072 early-boot LSB init scripts anymore, and these facilities
7073 are implied anyway for normal services. syslog.target has
7074 also been removed.
85d68397 7075
40e21da8 7076 * There are new bus calls on PID1's Manager object for
6aa8d43a 7077 cancelling jobs, and removing snapshot units. Previously,
85d68397
LP
7078 both calls were only available on the Job and Snapshot
7079 objects themselves.
7080
7081 * systemd-journal-gatewayd gained SSL support.
7082
7083 * The various "environment" files, such as /etc/locale.conf
7084 now support continuation lines with a backslash ("\") as
499b604b 7085 last character in the line, similarly in style (but different)
85d68397
LP
7086 to how this is supported in shells.
7087
7088 * For normal user processes the _SYSTEMD_USER_UNIT= field is
7089 now implicitly appended to every log entry logged. systemctl
7090 has been updated to filter by this field when operating on a
7091 user systemd instance.
7092
7093 * nspawn will now implicitly add the CAP_AUDIT_WRITE and
7094 CAP_AUDIT_CONTROL capabilities to the capabilities set for
7095 the container. This makes it easier to boot unmodified
7096 Fedora systems in a container, which however still requires
7097 audit=0 to be passed on the kernel command line. Auditing in
7098 kernel and userspace is unfortunately still too broken in
7099 context of containers, hence we recommend compiling it out
7100 of the kernel or using audit=0. Hopefully this will be fixed
7101 one day for good in the kernel.
7102
7103 * nspawn gained the new --bind= and --bind-ro= parameters to
7104 bind mount specific directories from the host into the
7105 container.
7106
40e21da8 7107 * nspawn will now mount its own devpts file system instance
6aa8d43a 7108 into the container, in order not to leak pty devices from
85d68397
LP
7109 the host into the container.
7110
7111 * systemd will now read the firmware boot time performance
6aa8d43a
LP
7112 information from the EFI variables, if the used boot loader
7113 supports this, and takes it into account for boot performance
7114 analysis via "systemd-analyze". This is currently supported
7115 only in conjunction with Gummiboot, but could be supported
7116 by other boot loaders too. For details see:
85d68397 7117
56cadcb6 7118 https://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface
85d68397
LP
7119
7120 * A new generator has been added that automatically mounts the
7121 EFI System Partition (ESP) to /boot, if that directory
6aa8d43a
LP
7122 exists, is empty, and no other file system has been
7123 configured to be mounted there.
85d68397
LP
7124
7125 * logind will now send out PrepareForSleep(false) out
7126 unconditionally, after coming back from suspend. This may be
7127 used by applications as asynchronous notification for
7128 system resume events.
7129
7130 * "systemctl unlock-sessions" has been added, that allows
7131 unlocking the screens of all user sessions at once, similar
499b604b 7132 to how "systemctl lock-sessions" already locked all users
40e21da8 7133 sessions. This is backed by a new D-Bus call UnlockSessions().
85d68397
LP
7134
7135 * "loginctl seat-status" will now show the master device of a
7136 seat. (i.e. the device of a seat that needs to be around for
7137 the seat to be considered available, usually the graphics
7138 card).
7139
7140 * tmpfiles gained a new "X" line type, that allows
7141 configuration of files and directories (with wildcards) that
7142 shall be excluded from automatic cleanup ("aging").
7143
bf933560
KS
7144 * udev default rules set the device node permissions now only
7145 at "add" events, and do not change them any longer with a
7146 later "change" event.
85d68397
LP
7147
7148 * The log messages for lid events and power/sleep keypresses
7149 now carry a message ID.
7150
7151 * We now have a substantially larger unit test suite, but this
7152 continues to be work in progress.
7153
7154 * udevadm hwdb gained a new --root= parameter to change the
7155 root directory to operate relative to.
7156
40e21da8
KS
7157 * logind will now issue a background sync() request to the kernel
7158 early at shutdown, so that dirty buffers are flushed to disk early
85d68397
LP
7159 instead of at the last moment, in order to optimize shutdown
7160 times a little.
7161
7162 * A new bootctl tool has been added that is an interface for
7163 certain boot loader operations. This is currently a preview
7164 and is likely to be extended into a small mechanism daemon
7165 like timedated, localed, hostnamed, and can be used by
7166 graphical UIs to enumerate available boot options, and
7167 request boot into firmware operations.
7168
7169 * systemd-bootchart has been relicensed to LGPLv2.1+ to match
7170 the rest of the package. It also has been updated to work
7171 correctly in initrds.
7172
d35f51ea
ZJS
7173 * polkit previously has been runtime optional, and is now also
7174 compile time optional via a configure switch.
85d68397
LP
7175
7176 * systemd-analyze has been reimplemented in C. Also "systemctl
7177 dot" has moved into systemd-analyze.
7178
7179 * "systemctl status" with no further parameters will now print
7180 the status of all active or failed units.
7181
7182 * Operations such as "systemctl start" can now be executed
7183 with a new mode "--irreversible" which may be used to queue
7184 operations that cannot accidentally be reversed by a later
6aa8d43a 7185 job queuing. This is by default used to make shutdown
85d68397
LP
7186 requests more robust.
7187
7188 * The Python API of systemd now gained a new module for
7189 reading journal files.
7190
7191 * A new tool kernel-install has been added that can install
7192 kernel images according to the Boot Loader Specification:
7193
56cadcb6 7194 https://www.freedesktop.org/wiki/Specifications/BootLoaderSpec
85d68397
LP
7195
7196 * Boot time console output has been improved to provide
6aa8d43a 7197 animated boot time output for hanging jobs.
85d68397
LP
7198
7199 * A new tool systemd-activate has been added which can be used
7200 to test socket activation with, directly from the command
7201 line. This should make it much easier to test and debug
7202 socket activation in daemons.
7203
7204 * journalctl gained a new "--reverse" (or -r) option to show
7205 journal output in reverse order (i.e. newest line first).
7206
43447fb7
LP
7207 * journalctl gained a new "--pager-end" (or -e) option to jump
7208 to immediately jump to the end of the journal in the
7209 pager. This is only supported in conjunction with "less".
7210
85d68397 7211 * journalctl gained a new "--user-unit=" option, that works
499b604b 7212 similarly to "--unit=" but filters for user units rather than
85d68397
LP
7213 system units.
7214
7215 * A number of unit files to ease adoption of systemd in
7216 initrds has been added. This moves some minimal logic from
7217 the various initrd implementations into systemd proper.
7218
7219 * The journal files are now owned by a new group
7220 "systemd-journal", which exists specifically to allow access
7221 to the journal, and nothing else. Previously, we used the
6aa8d43a 7222 "adm" group for that, which however possibly covers more
85d68397
LP
7223 than just journal/log file access. This new group is now
7224 already used by systemd-journal-gatewayd to ensure this
7225 daemon gets access to the journal files and as little else
7226 as possible. Note that "make install" will also set FS ACLs
7227 up for /var/log/journal to give "adm" and "wheel" read
7228 access to it, in addition to "systemd-journal" which owns
7229 the journal files. We recommend that packaging scripts also
6aa8d43a 7230 add read access to "adm" + "wheel" to /var/log/journal, and
85d68397
LP
7231 all existing/future journal files. To normal users and
7232 administrators little changes, however packagers need to
7233 ensure to create the "systemd-journal" system group at
7234 package installation time.
7235
7236 * The systemd-journal-gatewayd now runs as unprivileged user
7237 systemd-journal-gateway:systemd-journal-gateway. Packaging
7238 scripts need to create these system user/group at
7239 installation time.
7240
7241 * timedated now exposes a new boolean property CanNTP that
7242 indicates whether a local NTP service is available or not.
7243
7244 * systemd-detect-virt will now also detect xen PVs
7245
40e21da8
KS
7246 * The pstore file system is now mounted by default, if it is
7247 available.
85d68397 7248
1aed4590
LP
7249 * In addition to the SELinux and IMA policies we will now also
7250 load SMACK policies at early boot.
7251
85d68397
LP
7252 Contributions from: Adel Gadllah, Aleksander Morgado, Auke
7253 Kok, Ayan George, Bastien Nocera, Colin Walters, Daniel Buch,
7254 Daniel Wallace, Dave Reisner, David Herrmann, David Strauss,
7255 Eelco Dolstra, Enrico Scholz, Frederic Crozat, Harald Hoyer,
7256 Jan Janssen, Jonathan Callen, Kay Sievers, Lennart Poettering,
7257 Lukas Nykryn, Mantas Mikulėnas, Marc-Antoine Perennou, Martin
7258 Pitt, Mauro Dreissig, Max F. Albrecht, Michael Biebl, Michael
7259 Olbrich, Michal Schmidt, Michal Sekletar, Michal Vyskocil,
7260 Michał Bartoszkiewicz, Mirco Tischler, Nathaniel Chen, Nestor
7261 Ovroy, Oleksii Shevchuk, Paul W. Frields, Piotr Drąg, Rob
7262 Clark, Ryan Lortie, Simon McVittie, Simon Peeters, Steven
7263 Hiscocks, Thomas Hindoe Paaboel Andersen, Tollef Fog Heen, Tom
7264 Gundersen, Umut Tezduyar, William Giokas, Zbigniew
7265 Jędrzejewski-Szmek, Zeeshan Ali (Khattak)
7266
8ad26859
LP
7267CHANGES WITH 197:
7268
7269 * Timer units now support calendar time events in addition to
7270 monotonic time events. That means you can now trigger a unit
7271 based on a calendar time specification such as "Thu,Fri
7272 2013-*-1,5 11:12:13" which refers to 11:12:13 of the first
7273 or fifth day of any month of the year 2013, given that it is
7274 a thursday or friday. This brings timer event support
7275 considerably closer to cron's capabilities. For details on
7276 the supported calendar time specification language see
7277 systemd.time(7).
7278
7279 * udev now supports a number of different naming policies for
7280 network interfaces for predictable names, and a combination
7281 of these policies is now the default. Please see this wiki
7282 document for details:
7283
56cadcb6 7284 https://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames
8ad26859
LP
7285
7286 * Auke Kok's bootchart implementation has been added to the
d28315e4
JE
7287 systemd tree. It is an optional component that can graph the
7288 boot in quite some detail. It is one of the best bootchart
8ad26859
LP
7289 implementations around and minimal in its code and
7290 dependencies.
7291
7292 * nss-myhostname has been integrated into the systemd source
7293 tree. nss-myhostname guarantees that the local hostname
7294 always stays resolvable via NSS. It has been a weak
7295 requirement of systemd-hostnamed since a long time, and
7296 since its code is actually trivial we decided to just
7297 include it in systemd's source tree. It can be turned off
7298 with a configure switch.
7299
7300 * The read-ahead logic is now capable of properly detecting
7301 whether a btrfs file system is on SSD or rotating media, in
7302 order to optimize the read-ahead scheme. Previously, it was
7303 only capable of detecting this on traditional file systems
7304 such as ext4.
7305
7306 * In udev, additional device properties are now read from the
7307 IAB in addition to the OUI database. Also, Bluetooth company
7308 identities are attached to the devices as well.
7309
7310 * In service files %U may be used as specifier that is
7311 replaced by the configured user name of the service.
7312
7313 * nspawn may now be invoked without a controlling TTY. This
7314 makes it suitable for invocation as its own service. This
7315 may be used to set up a simple containerized server system
7316 using only core OS tools.
7317
7318 * systemd and nspawn can now accept socket file descriptors
7319 when they are started for socket activation. This enables
7320 implementation of socket activated nspawn
7321 containers. i.e. think about autospawning an entire OS image
7322 when the first SSH or HTTP connection is received. We expect
7323 that similar functionality will also be added to libvirt-lxc
7324 eventually.
7325
7326 * journalctl will now suppress ANSI color codes when
7327 presenting log data.
7328
7329 * systemctl will no longer show control group information for
ce830873 7330 a unit if the control group is empty anyway.
8ad26859
LP
7331
7332 * logind can now automatically suspend/hibernate/shutdown the
7333 system on idle.
7334
7335 * /etc/machine-info and hostnamed now also expose the chassis
7336 type of the system. This can be used to determine whether
7337 the local system is a laptop, desktop, handset or
7338 tablet. This information may either be configured by the
7339 user/vendor or is automatically determined from ACPI and DMI
7340 information if possible.
7341
d35f51ea
ZJS
7342 * A number of polkit actions are now bound together with "imply"
7343 rules. This should simplify creating UIs because many actions
7344 will now authenticate similar ones as well.
8ad26859
LP
7345
7346 * Unit files learnt a new condition ConditionACPower= which
7347 may be used to conditionalize a unit depending on whether an
7348 AC power source is connected or not, of whether the system
7349 is running on battery power.
7350
7351 * systemctl gained a new "is-failed" verb that may be used in
7352 shell scripts and suchlike to check whether a specific unit
7353 is in the "failed" state.
7354
7355 * The EnvironmentFile= setting in unit files now supports file
7356 globbing, and can hence be used to easily read a number of
7357 environment files at once.
7358
7359 * systemd will no longer detect and recognize specific
7360 distributions. All distribution-specific #ifdeffery has been
7361 removed, systemd is now fully generic and
7362 distribution-agnostic. Effectively, not too much is lost as
7363 a lot of the code is still accessible via explicit configure
7364 switches. However, support for some distribution specific
7365 legacy configuration file formats has been dropped. We
7366 recommend distributions to simply adopt the configuration
7367 files everybody else uses now and convert the old
7368 configuration from packaging scripts. Most distributions
7369 already did that. If that's not possible or desirable,
7370 distributions are welcome to forward port the specific
7371 pieces of code locally from the git history.
7372
7373 * When logging a message about a unit systemd will now always
7374 log the unit name in the message meta data.
7375
7376 * localectl will now also discover system locale data that is
7377 not stored in locale archives, but directly unpacked.
7378
7379 * logind will no longer unconditionally use framebuffer
7380 devices as seat masters, i.e. as devices that are required
7381 to be existing before a seat is considered preset. Instead,
7382 it will now look for all devices that are tagged as
b938cb90
JE
7383 "seat-master" in udev. By default, framebuffer devices will
7384 be marked as such, but depending on local systems, other
8ad26859
LP
7385 devices might be marked as well. This may be used to
7386 integrate graphics cards using closed source drivers (such
7387 as NVidia ones) more nicely into logind. Note however, that
7388 we recommend using the open source NVidia drivers instead,
7389 and no udev rules for the closed-source drivers will be
7390 shipped from us upstream.
7391
7392 Contributions from: Adam Williamson, Alessandro Crismani, Auke
7393 Kok, Colin Walters, Daniel Wallace, Dave Reisner, David
7394 Herrmann, David Strauss, Dimitrios Apostolou, Eelco Dolstra,
7395 Eric Benoit, Giovanni Campagna, Hannes Reinecke, Henrik
7396 Grindal Bakken, Hermann Gausterer, Kay Sievers, Lennart
7397 Poettering, Lukas Nykryn, Mantas Mikulėnas, Marcel Holtmann,
7398 Martin Pitt, Matthew Monaco, Michael Biebl, Michael Terry,
7399 Michal Schmidt, Michal Sekletar, Michał Bartoszkiewicz, Oleg
7400 Samarin, Pekka Lundstrom, Philip Nilsson, Ramkumar
7401 Ramachandra, Richard Yao, Robert Millan, Sami Kerola, Shawn
7402 Landden, Thomas Hindoe Paaboel Andersen, Thomas Jarosch,
7403 Tollef Fog Heen, Tom Gundersen, Umut Tezduyar, Zbigniew
7404 Jędrzejewski-Szmek
7405
0428ddb7
LP
7406CHANGES WITH 196:
7407
7408 * udev gained support for loading additional device properties
7409 from an indexed database that is keyed by vendor/product IDs
7410 and similar device identifiers. For the beginning this
7411 "hwdb" is populated with data from the well-known PCI and
7412 USB database, but also includes PNP, ACPI and OID data. In
7413 the longer run this indexed database shall grow into
7414 becoming the one central database for non-essential
7415 userspace device metadata. Previously, data from the PCI/USB
96ec33c0 7416 database was only attached to select devices, since the
0428ddb7 7417 lookup was a relatively expensive operation due to O(n) time
96ec33c0
LP
7418 complexity (with n being the number of entries in the
7419 database). Since this is now O(1), we decided to add in this
7420 data for all devices where this is available, by
0428ddb7
LP
7421 default. Note that the indexed database needs to be rebuilt
7422 when new data files are installed. To achieve this you need
7423 to update your packaging scripts to invoke "udevadm hwdb
7424 --update" after installation of hwdb data files. For
7425 RPM-based distributions we introduced the new
7426 %udev_hwdb_update macro for this purpose.
7427
7428 * The Journal gained support for the "Message Catalog", an
7429 indexed database to link up additional information with
7430 journal entries. For further details please check:
7431
56cadcb6 7432 https://www.freedesktop.org/wiki/Software/systemd/catalog
0428ddb7
LP
7433
7434 The indexed message catalog database also needs to be
7435 rebuilt after installation of message catalog files. Use
7436 "journalctl --update-catalog" for this. For RPM-based
7437 distributions we introduced the %journal_catalog_update
7438 macro for this purpose.
7439
7440 * The Python Journal bindings gained support for the standard
7441 Python logging framework.
7442
7443 * The Journal API gained new functions for checking whether
7444 the underlying file system of a journal file is capable of
7445 properly reporting file change notifications, or whether
7446 applications that want to reflect journal changes "live"
ab06eef8 7447 need to recheck journal files continuously in appropriate
0428ddb7
LP
7448 time intervals.
7449
7450 * It is now possible to set the "age" field for tmpfiles
7451 entries to 0, indicating that files matching this entry
7452 shall always be removed when the directories are cleaned up.
7453
7454 * coredumpctl gained a new "gdb" verb which invokes gdb
7455 right-away on the selected coredump.
7456
7457 * There's now support for "hybrid sleep" on kernels that
7458 support this, in addition to "suspend" and "hibernate". Use
7459 "systemctl hybrid-sleep" to make use of this.
7460
7461 * logind's HandleSuspendKey= setting (and related settings)
7462 now gained support for a new "lock" setting to simply
7463 request the screen lock on all local sessions, instead of
7464 actually executing a suspend or hibernation.
7465
7466 * systemd will now mount the EFI variables file system by
7467 default.
7468
7469 * Socket units now gained support for configuration of the
7470 SMACK security label.
7471
7472 * timedatectl will now output the time of the last and next
7473 daylight saving change.
7474
7475 * We dropped support for various legacy and distro-specific
7476 concepts, such as insserv, early-boot SysV services
7477 (i.e. those for non-standard runlevels such as 'b' or 'S')
7478 or ArchLinux /etc/rc.conf support. We recommend the
7479 distributions who still need support this to either continue
7480 to maintain the necessary patches downstream, or find a
7481 different solution. (Talk to us if you have questions!)
7482
d35f51ea
ZJS
7483 * Various systemd components will now bypass polkit checks for
7484 root and otherwise handle properly if polkit is not found to
7485 be around. This should fix most issues for polkit-less
7486 systems. Quite frankly this should have been this way since
7487 day one. It is absolutely our intention to make systemd work
7488 fine on polkit-less systems, and we consider it a bug if
7489 something does not work as it should if polkit is not around.
0428ddb7
LP
7490
7491 * For embedded systems it is now possible to build udev and
7492 systemd without blkid and/or kmod support.
7493
7494 * "systemctl switch-root" is now capable of switching root
7495 more than once. I.e. in addition to transitions from the
7496 initrd to the host OS it is now possible to transition to
7497 further OS images from the host. This is useful to implement
7498 offline updating tools.
7499
7500 * Various other additions have been made to the RPM macros
7501 shipped with systemd. Use %udev_rules_update() after
7502 installing new udev rules files. %_udevhwdbdir,
7503 %_udevrulesdir, %_journalcatalogdir, %_tmpfilesdir,
7504 %_sysctldir are now available which resolve to the right
7505 directories for packages to place various data files in.
7506
7507 * journalctl gained the new --full switch (in addition to
7508 --all, to disable ellipsation for long messages.
7509
7510 Contributions from: Anders Olofsson, Auke Kok, Ben Boeckel,
7511 Colin Walters, Cosimo Cecchi, Daniel Wallace, Dave Reisner,
7512 Eelco Dolstra, Holger Hans Peter Freyther, Kay Sievers,
7513 Chun-Yi Lee, Lekensteyn, Lennart Poettering, Mantas Mikulėnas,
7514 Marti Raudsepp, Martin Pitt, Mauro Dreissig, Michael Biebl,
7515 Michal Schmidt, Michal Sekletar, Miklos Vajna, Nis Martensen,
7516 Oleksii Shevchuk, Olivier Brunel, Ramkumar Ramachandra, Thomas
7517 Bächler, Thomas Hindoe Paaboel Andersen, Tom Gundersen, Tony
7518 Camuso, Umut Tezduyar, Zbigniew Jędrzejewski-Szmek
7519
139ee8cc
LP
7520CHANGES WITH 195:
7521
6827101a 7522 * journalctl gained new --since= and --until= switches to
139ee8cc
LP
7523 filter by time. It also now supports nice filtering for
7524 units via --unit=/-u.
7525
6827101a 7526 * Type=oneshot services may use ExecReload= and do the
139ee8cc
LP
7527 right thing.
7528
7529 * The journal daemon now supports time-based rotation and
7530 vacuuming, in addition to the usual disk-space based
7531 rotation.
7532
7533 * The journal will now index the available field values for
7534 each field name. This enables clients to show pretty drop
7535 downs of available match values when filtering. The bash
7536 completion of journalctl has been updated
7537 accordingly. journalctl gained a new switch -F to list all
7538 values a certain field takes in the journal database.
7539
7540 * More service events are now written as structured messages
7541 to the journal, and made recognizable via message IDs.
7542
7543 * The timedated, localed and hostnamed mini-services which
7544 previously only provided support for changing time, locale
7545 and hostname settings from graphical DEs such as GNOME now
7546 also have a minimal (but very useful) text-based client
7547 utility each. This is probably the nicest way to changing
7548 these settings from the command line now, especially since
7549 it lists available options and is fully integrated with bash
7550 completion.
7551
7552 * There's now a new tool "systemd-coredumpctl" to list and
7553 extract coredumps from the journal.
7554
7555 * We now install a README each in /var/log/ and
7556 /etc/rc.d/init.d explaining where the system logs and init
7557 scripts went. This hopefully should help folks who go to
7558 that dirs and look into the otherwise now empty void and
7559 scratch their heads.
7560
7561 * When user-services are invoked (by systemd --user) the
7562 $MANAGERPID env var is set to the PID of systemd.
7563
7564 * SIGRTMIN+24 when sent to a --user instance will now result
7565 in immediate termination of systemd.
7566
7567 * gatewayd received numerous feature additions such as a
7568 "follow" mode, for live syncing and filtering.
7569
7570 * browse.html now allows filtering and showing detailed
7571 information on specific entries. Keyboard navigation and
7572 mouse screen support has been added.
7573
7574 * gatewayd/journalctl now supports HTML5/JSON
7575 Server-Sent-Events as output.
7576
1cb88f2c 7577 * The SysV init script compatibility logic will now
139ee8cc
LP
7578 heuristically determine whether a script supports the
7579 "reload" verb, and only then make this available as
7580 "systemctl reload".
7581
15f47220 7582 * "systemctl status --follow" has been removed, use "journalctl
139ee8cc
LP
7583 -u" instead.
7584
7585 * journald.conf's RuntimeMinSize=, PersistentMinSize= settings
7586 have been removed since they are hardly useful to be
7587 configured.
7588
7589 * And I'd like to take the opportunity to specifically mention
7590 Zbigniew for his great contributions. Zbigniew, you rock!
7591
7592 Contributions from: Andrew Eikum, Christian Hesse, Colin
7593 Guthrie, Daniel J Walsh, Dave Reisner, Eelco Dolstra, Ferenc
4d92e078
LP
7594 Wágner, Kay Sievers, Lennart Poettering, Lukas Nykryn, Mantas
7595 Mikulėnas, Martin Mikkelsen, Martin Pitt, Michael Olbrich,
7596 Michael Stapelberg, Michal Schmidt, Sebastian Ott, Thomas
7597 Bächler, Umut Tezduyar, Will Woods, Wulf C. Krueger, Zbigniew
7598 Jędrzejewski-Szmek, Сковорода Никита Андреевич
139ee8cc 7599
f9b55720
LP
7600CHANGES WITH 194:
7601
7602 * If /etc/vconsole.conf is non-existent or empty we will no
7603 longer load any console font or key map at boot by
7604 default. Instead the kernel defaults will be left
7605 intact. This is definitely the right thing to do, as no
7606 configuration should mean no configuration, and hard-coding
7607 font names that are different on all archs is probably a bad
7608 idea. Also, the kernel default key map and font should be
7609 good enough for most cases anyway, and mostly identical to
7610 the userspace fonts/key maps we previously overloaded them
7611 with. If distributions want to continue to default to a
7612 non-kernel font or key map they should ship a default
7613 /etc/vconsole.conf with the appropriate contents.
7614
7615 Contributions from: Colin Walters, Daniel J Walsh, Dave
7616 Reisner, Kay Sievers, Lennart Poettering, Lukas Nykryn, Tollef
7617 Fog Heen, Tom Gundersen, Zbigniew Jędrzejewski-Szmek
7618
597c52cf
LP
7619CHANGES WITH 193:
7620
7621 * journalctl gained a new --cursor= switch to show entries
7622 starting from the specified location in the journal.
7623
7624 * We now enforce a size limit on journal entry fields exported
7625 with "-o json" in journalctl. Fields larger than 4K will be
7626 assigned null. This can be turned off with --all.
7627
7628 * An (optional) journal gateway daemon is now available as
7629 "systemd-journal-gatewayd.service". This service provides
7630 access to the journal via HTTP and JSON. This functionality
7631 will be used to implement live log synchronization in both
7632 pull and push modes, but has various other users too, such
7633 as easy log access for debugging of embedded devices. Right
7634 now it is already useful to retrieve the journal via HTTP:
7635
7636 # systemctl start systemd-journal-gatewayd.service
7637 # wget http://localhost:19531/entries
7638
7639 This will download the journal contents in a
7640 /var/log/messages compatible format. The same as JSON:
7641
7642 # curl -H"Accept: application/json" http://localhost:19531/entries
7643
7644 This service is also accessible via a web browser where a
7645 single static HTML5 app is served that uses the JSON logic
7646 to enable the user to do some basic browsing of the
7647 journal. This will be extended later on. Here's an example
7648 screenshot of this app in its current state:
7649
7650 http://0pointer.de/public/journal-gatewayd
7651
7652 Contributions from: Kay Sievers, Lennart Poettering, Robert
7653 Milasan, Tom Gundersen
7654
075d4ecb
LP
7655CHANGES WITH 192:
7656
7657 * The bash completion logic is now available for journalctl
7658 too.
7659
d28315e4 7660 * We do not mount the "cpuset" controller anymore together with
075d4ecb
LP
7661 "cpu" and "cpuacct", as "cpuset" groups generally cannot be
7662 started if no parameters are assigned to it. "cpuset" hence
61233823 7663 broke code that assumed it could create "cpu" groups and
075d4ecb
LP
7664 just start them.
7665
7666 * journalctl -f will now subscribe to terminal size changes,
7667 and line break accordingly.
7668
597c52cf
LP
7669 Contributions from: Dave Reisner, Kay Sievers, Lennart
7670 Poettering, Lukas Nykrynm, Mirco Tischler, Václav Pavlín
075d4ecb 7671
b6a86739
LP
7672CHANGES WITH 191:
7673
7674 * nspawn will now create a symlink /etc/localtime in the
7675 container environment, copying the host's timezone
7676 setting. Previously this has been done via a bind mount, but
7677 since symlinks cannot be bind mounted this has now been
7678 changed to create/update the appropriate symlink.
7679
7680 * journalctl -n's line number argument is now optional, and
7681 will default to 10 if omitted.
7682
7683 * journald will now log the maximum size the journal files may
7684 take up on disk. This is particularly useful if the default
7685 built-in logic of determining this parameter from the file
7686 system size is used. Use "systemctl status
6563b535 7687 systemd-journald.service" to see this information.
b6a86739
LP
7688
7689 * The multi-seat X wrapper tool has been stripped down. As X
7690 is now capable of enumerating graphics devices via udev in a
7691 seat-aware way the wrapper is not strictly necessary
7692 anymore. A stripped down temporary stop-gap is still shipped
7693 until the upstream display managers have been updated to
7694 fully support the new X logic. Expect this wrapper to be
6563b535 7695 removed entirely in one of the next releases.
b6a86739
LP
7696
7697 * HandleSleepKey= in logind.conf has been split up into
7698 HandleSuspendKey= and HandleHibernateKey=. The old setting
6563b535 7699 is not available anymore. X11 and the kernel are
45afd519 7700 distinguishing between these keys and we should too. This
b6a86739
LP
7701 also means the inhibition lock for these keys has been split
7702 into two.
7703
597c52cf
LP
7704 Contributions from: Dave Airlie, Eelco Dolstra, Lennart
7705 Poettering, Lukas Nykryn, Václav Pavlín
b6a86739 7706
0c11f949
LP
7707CHANGES WITH 190:
7708
d28315e4 7709 * Whenever a unit changes state we will now log this to the
0c11f949
LP
7710 journal and show along the unit's own log output in
7711 "systemctl status".
7712
7713 * ConditionPathIsMountPoint= can now properly detect bind
7714 mount points too. (Previously, a bind mount of one file
8d0256b7 7715 system to another place in the same file system could not be
0c11f949
LP
7716 detected as mount, since they shared struct stat's st_dev
7717 field.)
7718
7719 * We will now mount the cgroup controllers cpu, cpuacct,
7720 cpuset and the controllers net_cls, net_prio together by
7721 default.
7722
7723 * nspawn containers will now have a virtualized boot
7724 ID. (i.e. /proc/sys/kernel/random/boot_id is now mounted
7725 over with a randomized ID at container initialization). This
7726 has the effect of making "journalctl -b" do the right thing
7727 in a container.
7728
7729 * The JSON output journal serialization has been updated not
7730 to generate "endless" list objects anymore, but rather one
7731 JSON object per line. This is more in line how most JSON
7732 parsers expect JSON objects. The new output mode
7733 "json-pretty" has been added to provide similar output, but
7734 neatly aligned for readability by humans.
7735
7736 * We dropped all explicit sync() invocations in the shutdown
7737 code. The kernel does this implicitly anyway in the kernel
7738 reboot() syscall. halt(8)'s -n option is now a compatibility
7739 no-op.
7740
7741 * We now support virtualized reboot() in containers, as
7742 supported by newer kernels. We will fall back to exit() if
7743 CAP_SYS_REBOOT is not available to the container. Also,
7744 nspawn makes use of this now and will actually reboot the
7745 container if the containerized OS asks for that.
7746
7747 * journalctl will only show local log output by default
7748 now. Use --merge (-m) to show remote log output, too.
7749
7750 * libsystemd-journal gained the new sd_journal_get_usage()
7751 call to determine the current disk usage of all journal
7752 files. This is exposed in the new "journalctl --disk-usage"
7753 command.
7754
7755 * journald gained a new configuration setting SplitMode= in
7756 journald.conf which may be used to control how user journals
7757 are split off. See journald.conf(5) for details.
7758
7759 * A new condition type ConditionFileNotEmpty= has been added.
7760
7761 * tmpfiles' "w" lines now support file globbing, to write
7762 multiple files at once.
7763
7764 * We added Python bindings for the journal submission
7765 APIs. More Python APIs for a number of selected APIs will
7766 likely follow. Note that we intend to add native bindings
7767 only for the Python language, as we consider it common
7768 enough to deserve bindings shipped within systemd. There are
7769 various projects outside of systemd that provide bindings
7770 for languages such as PHP or Lua.
7771
a98d5d64
LP
7772 * Many conditions will now resolve specifiers such as %i. In
7773 addition, PathChanged= and related directives of .path units
7774 now support specifiers as well.
0c11f949
LP
7775
7776 * There's now a new RPM macro definition for the system preset
7777 dir: %_presetdir.
7778
d28315e4 7779 * journald will now warn if it ca not forward a message to the
dca348bc 7780 syslog daemon because its socket is full.
0c11f949
LP
7781
7782 * timedated will no longer write or process /etc/timezone,
7783 except on Debian. As we do not support late mounted /usr
7784 anymore /etc/localtime always being a symlink is now safe,
7785 and hence the information in /etc/timezone is not necessary
7786 anymore.
7787
aaccc32c 7788 * logind will now always reserve one VT for a text getty (VT6
0c11f949
LP
7789 by default). Previously if more than 6 X sessions where
7790 started they took up all the VTs with auto-spawned gettys,
7791 so that no text gettys were available anymore.
7792
7793 * udev will now automatically inform the btrfs kernel logic
7794 about btrfs RAID components showing up. This should make
7795 simple hotplug based btrfs RAID assembly work.
7796
7797 * PID 1 will now increase its RLIMIT_NOFILE to 64K by default
7798 (but not for its children which will stay at the kernel
7799 default). This should allow setups with a lot more listening
7800 sockets.
7801
7802 * systemd will now always pass the configured timezone to the
7803 kernel at boot. timedated will do the same when the timezone
7804 is changed.
7805
7806 * logind's inhibition logic has been updated. By default,
7807 logind will now handle the lid switch, the power and sleep
7808 keys all the time, even in graphical sessions. If DEs want
7809 to handle these events on their own they should take the new
7810 handle-power-key, handle-sleep-key and handle-lid-switch
f131770b 7811 inhibitors during their runtime. A simple way to achieve
0c11f949
LP
7812 that is to invoke the DE wrapped in an invocation of:
7813
7814 systemd-inhibit --what=handle-power-key:handle-sleep-key:handle-lid-switch ...
7815
7816 * Access to unit operations is now checked via SELinux taking
7817 the unit file label and client process label into account.
7818
aad803af
LP
7819 * systemd will now notify the administrator in the journal
7820 when he over-mounts a non-empty directory.
7821
7822 * There are new specifiers that are resolved in unit files,
7823 for the host name (%H), the machine ID (%m) and the boot ID
7824 (%b).
7825
b6a86739 7826 Contributions from: Allin Cottrell, Auke Kok, Brandon Philips,
0c11f949
LP
7827 Colin Guthrie, Colin Walters, Daniel J Walsh, Dave Reisner,
7828 Eelco Dolstra, Jan Engelhardt, Kay Sievers, Lennart
7829 Poettering, Lucas De Marchi, Lukas Nykryn, Mantas Mikulėnas,
7830 Martin Pitt, Matthias Clasen, Michael Olbrich, Pierre Schmitz,
7831 Shawn Landden, Thomas Hindoe Paaboel Andersen, Tom Gundersen,
7832 Václav Pavlín, Yin Kangkai, Zbigniew Jędrzejewski-Szmek
7833
38a60d71
LP
7834CHANGES WITH 189:
7835
7836 * Support for reading structured kernel messages from
7837 /dev/kmsg has now been added and is enabled by default.
7838
7839 * Support for reading kernel messages from /proc/kmsg has now
7840 been removed. If you want kernel messages in the journal
7841 make sure to run a recent kernel (>= 3.5) that supports
7842 reading structured messages from /dev/kmsg (see
7843 above). /proc/kmsg is now exclusive property of classic
7844 syslog daemons again.
7845
7846 * The libudev API gained the new
7847 udev_device_new_from_device_id() call.
7848
7849 * The logic for file system namespace (ReadOnlyDirectory=,
7850 ReadWriteDirectoy=, PrivateTmp=) has been reworked not to
7851 require pivot_root() anymore. This means fewer temporary
7852 directories are created below /tmp for this feature.
7853
7854 * nspawn containers will now see and receive all submounts
7855 made on the host OS below the root file system of the
7856 container.
7857
7858 * Forward Secure Sealing is now supported for Journal files,
7859 which provide cryptographical sealing of journal files so
7860 that attackers cannot alter log history anymore without this
7861 being detectable. Lennart will soon post a blog story about
7862 this explaining it in more detail.
7863
7864 * There are two new service settings RestartPreventExitStatus=
7865 and SuccessExitStatus= which allow configuration of exit
7866 status (exit code or signal) which will be excepted from the
7867 restart logic, resp. consider successful.
7868
7869 * journalctl gained the new --verify switch that can be used
7870 to check the integrity of the structure of journal files and
7871 (if Forward Secure Sealing is enabled) the contents of
7872 journal files.
7873
7874 * nspawn containers will now be run with /dev/stdin, /dev/fd/
7875 and similar symlinks pre-created. This makes running shells
7876 as container init process a lot more fun.
7877
7878 * The fstab support can now handle PARTUUID= and PARTLABEL=
7879 entries.
7880
7881 * A new ConditionHost= condition has been added to match
7882 against the hostname (with globs) and machine ID. This is
7883 useful for clusters where a single OS image is used to
7884 provision a large number of hosts which shall run slightly
7885 different sets of services.
7886
7887 * Services which hit the restart limit will now be placed in a
7888 failure state.
7889
b6a86739 7890 Contributions from: Bertram Poettering, Dave Reisner, Huang
38a60d71
LP
7891 Hang, Kay Sievers, Lennart Poettering, Lukas Nykryn, Martin
7892 Pitt, Simon Peeters, Zbigniew Jędrzejewski-Szmek
7893
c269cec3
LP
7894CHANGES WITH 188:
7895
7896 * When running in --user mode systemd will now become a
7897 subreaper (PR_SET_CHILD_SUBREAPER). This should make the ps
7898 tree a lot more organized.
7899
7900 * A new PartOf= unit dependency type has been introduced that
7901 may be used to group services in a natural way.
7902
7903 * "systemctl enable" may now be used to enable instances of
7904 services.
7905
7906 * journalctl now prints error log levels in red, and
7907 warning/notice log levels in bright white. It also supports
7908 filtering by log level now.
7909
7910 * cgtop gained a new -n switch (similar to top), to configure
7911 the maximum number of iterations to run for. It also gained
7912 -b, to run in batch mode (accepting no input).
7913
ab06eef8 7914 * The suffix ".service" may now be omitted on most systemctl
c269cec3
LP
7915 command lines involving service unit names.
7916
7917 * There's a new bus call in logind to lock all sessions, as
7918 well as a loginctl verb for it "lock-sessions".
7919
7920 * libsystemd-logind.so gained a new call sd_journal_perror()
7921 that works similar to libc perror() but logs to the journal
7922 and encodes structured information about the error number.
7923
7924 * /etc/crypttab entries now understand the new keyfile-size=
7925 option.
7926
7927 * shutdown(8) now can send a (configurable) wall message when
7928 a shutdown is cancelled.
7929
7930 * The mount propagation mode for the root file system will now
7931 default to "shared", which is useful to make containers work
7932 nicely out-of-the-box so that they receive new mounts from
7933 the host. This can be undone locally by running "mount
7934 --make-rprivate /" if needed.
7935
7936 * The prefdm.service file has been removed. Distributions
7937 should maintain this unit downstream if they intend to keep
7938 it around. However, we recommend writing normal unit files
7939 for display managers instead.
7940
7941 * Since systemd is a crucial part of the OS we will now
7942 default to a number of compiler switches that improve
7943 security (hardening) such as read-only relocations, stack
7944 protection, and suchlike.
7945
7946 * The TimeoutSec= setting for services is now split into
7947 TimeoutStartSec= and TimeoutStopSec= to allow configuration
7948 of individual time outs for the start and the stop phase of
7949 the service.
7950
7951 Contributions from: Artur Zaprzala, Arvydas Sidorenko, Auke
7952 Kok, Bryan Kadzban, Dave Reisner, David Strauss, Harald Hoyer,
7953 Jim Meyering, Kay Sievers, Lennart Poettering, Mantas
7954 Mikulėnas, Martin Pitt, Michal Schmidt, Michal Sekletar, Peter
7955 Alfredsen, Shawn Landden, Simon Peeters, Terence Honles, Tom
7956 Gundersen, Zbigniew Jędrzejewski-Szmek
7957
c4f1b862
LP
7958CHANGES WITH 187:
7959
7960 * The journal and id128 C APIs are now fully documented as man
7961 pages.
7962
7963 * Extra safety checks have been added when transitioning from
7964 the initial RAM disk to the main system to avoid accidental
7965 data loss.
7966
c269cec3 7967 * /etc/crypttab entries now understand the new keyfile-offset=
c4f1b862
LP
7968 option.
7969
7970 * systemctl -t can now be used to filter by unit load state.
7971
7972 * The journal C API gained the new sd_journal_wait() call to
7973 make writing synchronous journal clients easier.
7974
7975 * journalctl gained the new -D switch to show journals from a
7976 specific directory.
7977
7978 * journalctl now displays a special marker between log
7979 messages of two different boots.
7980
7981 * The journal is now explicitly flushed to /var via a service
7982 systemd-journal-flush.service, rather than implicitly simply
7983 by seeing /var/log/journal to be writable.
7984
7985 * journalctl (and the journal C APIs) can now match for much
7986 more complex expressions, with alternatives and
7987 disjunctions.
7988
7989 * When transitioning from the initial RAM disk to the main
7990 system we will now kill all processes in a killing spree to
7991 ensure no processes stay around by accident.
7992
7993 * Three new specifiers may be used in unit files: %u, %h, %s
7994 resolve to the user name, user home directory resp. user
7995 shell. This is useful for running systemd user instances.
7996
7997 * We now automatically rotate journal files if their data
7998 object hash table gets a fill level > 75%. We also size the
7999 hash table based on the configured maximum file size. This
8000 together should lower hash collisions drastically and thus
8001 speed things up a bit.
8002
8003 * journalctl gained the new "--header" switch to introspect
8004 header data of journal files.
8005
8006 * A new setting SystemCallFilters= has been added to services
8007 which may be used to apply blacklists or whitelists to
8008 system calls. This is based on SECCOMP Mode 2 of Linux 3.5.
8009
8010 * nspawn gained a new --link-journal= switch (and quicker: -j)
8011 to link the container journal with the host. This makes it
8012 very easy to centralize log viewing on the host for all
8013 guests while still keeping the journal files separated.
8014
8015 * Many bugfixes and optimizations
8016
8017 Contributions from: Auke Kok, Eelco Dolstra, Harald Hoyer, Kay
8018 Sievers, Lennart Poettering, Malte Starostik, Paul Menzel, Rex
8019 Tsai, Shawn Landden, Tom Gundersen, Ville Skyttä, Zbigniew
8020 Jędrzejewski-Szmek
8021
b5b4c94a
LP
8022CHANGES WITH 186:
8023
8024 * Several tools now understand kernel command line arguments,
8025 which are only read when run in an initial RAM disk. They
8026 usually follow closely their normal counterparts, but are
8027 prefixed with rd.
8028
8029 * There's a new tool to analyze the readahead files that are
8030 automatically generated at boot. Use:
8031
8032 /usr/lib/systemd/systemd-readahead analyze /.readahead
8033
8034 * We now provide an early debug shell on tty9 if this enabled. Use:
8035
d1f9edaf 8036 systemctl enable debug-shell.service
b5b4c94a
LP
8037
8038 * All plymouth related units have been moved into the Plymouth
8039 package. Please make sure to upgrade your Plymouth version
8040 as well.
8041
8042 * systemd-tmpfiles now supports getting passed the basename of
8043 a configuration file only, in which case it will look for it
8044 in all appropriate directories automatically.
8045
8046 * udevadm info now takes a /dev or /sys path as argument, and
8047 does the right thing. Example:
8048
8049 udevadm info /dev/sda
8050 udevadm info /sys/class/block/sda
8051
8052 * systemctl now prints a warning if a unit is stopped but a
8053 unit that might trigger it continues to run. Example: a
8054 service is stopped but the socket that activates it is left
8055 running.
8056
8057 * "systemctl status" will now mention if the log output was
8058 shortened due to rotation since a service has been started.
8059
8060 * The journal API now exposes functions to determine the
8061 "cutoff" times due to rotation.
8062
8063 * journald now understands SIGUSR1 and SIGUSR2 for triggering
8064 immediately flushing of runtime logs to /var if possible,
8065 resp. for triggering immediate rotation of the journal
8066 files.
8067
8068 * It is now considered an error if a service is attempted to
8069 be stopped that is not loaded.
8070
8071 * XDG_RUNTIME_DIR now uses numeric UIDs instead of usernames.
8072
8073 * systemd-analyze now supports Python 3
8074
8075 * tmpfiles now supports cleaning up directories via aging
8076 where the first level dirs are always kept around but
8077 directories beneath it automatically aged. This is enabled
8078 by prefixing the age field with '~'.
8079
8080 * Seat objects now expose CanGraphical, CanTTY properties
8081 which is required to deal with very fast bootups where the
8082 display manager might be running before the graphics drivers
8083 completed initialization.
8084
8085 * Seat objects now expose a State property.
8086
8087 * We now include RPM macros for service enabling/disabling
8088 based on the preset logic. We recommend RPM based
8089 distributions to make use of these macros if possible. This
8090 makes it simpler to reuse RPM spec files across
8091 distributions.
8092
8093 * We now make sure that the collected systemd unit name is
8094 always valid when services log to the journal via
8095 STDOUT/STDERR.
8096
8097 * There's a new man page kernel-command-line(7) detailing all
8098 command line options we understand.
8099
8100 * The fstab generator may now be disabled at boot by passing
8101 fstab=0 on the kernel command line.
8102
91ac7425 8103 * A new kernel command line option modules-load= is now understood
b5b4c94a
LP
8104 to load a specific kernel module statically, early at boot.
8105
8106 * Unit names specified on the systemctl command line are now
8107 automatically escaped as needed. Also, if file system or
8108 device paths are specified they are automatically turned
8109 into the appropriate mount or device unit names. Example:
8110
8111 systemctl status /home
8112 systemctl status /dev/sda
8113
8114 * The SysVConsole= configuration option has been removed from
8115 system.conf parsing.
8116
8117 * The SysV search path is no longer exported on the D-Bus
8118 Manager object.
8119
ce830873 8120 * The Names= option has been removed from unit file parsing.
b5b4c94a
LP
8121
8122 * There's a new man page bootup(7) detailing the boot process.
8123
8124 * Every unit and every generator we ship with systemd now
8125 comes with full documentation. The self-explanatory boot is
8126 complete.
8127
8128 * A couple of services gained "systemd-" prefixes in their
8129 name if they wrap systemd code, rather than only external
8130 code. Among them fsck@.service which is now
8131 systemd-fsck@.service.
8132
8133 * The HaveWatchdog property has been removed from the D-Bus
8134 Manager object.
8135
8136 * systemd.confirm_spawn= on the kernel command line should now
8137 work sensibly.
8138
8139 * There's a new man page crypttab(5) which details all options
8140 we actually understand.
8141
8142 * systemd-nspawn gained a new --capability= switch to pass
8143 additional capabilities to the container.
8144
8145 * timedated will now read known NTP implementation unit names
5b00c016 8146 from /usr/lib/systemd/ntp-units.d/*.list,
b5b4c94a
LP
8147 systemd-timedated-ntp.target has been removed.
8148
8149 * journalctl gained a new switch "-b" that lists log data of
8150 the current boot only.
8151
8152 * The notify socket is in the abstract namespace again, in
8153 order to support daemons which chroot() at start-up.
8154
8155 * There is a new Storage= configuration option for journald
8156 which allows configuration of where log data should go. This
8157 also provides a way to disable journal logging entirely, so
8158 that data collected is only forwarded to the console, the
8159 kernel log buffer or another syslog implementation.
8160
c4f1b862 8161 * Many bugfixes and optimizations
b5b4c94a 8162
2d938ac7
LP
8163 Contributions from: Auke Kok, Colin Guthrie, Dave Reisner,
8164 David Strauss, Eelco Dolstra, Kay Sievers, Lennart Poettering,
8165 Lukas Nykryn, Michal Schmidt, Michal Sekletar, Paul Menzel,
8166 Shawn Landden, Tom Gundersen
b5b4c94a 8167
2d197285 8168CHANGES WITH 185:
b6a86739 8169
2d197285
KS
8170 * "systemctl help <unit>" now shows the man page if one is
8171 available.
8172
8173 * Several new man pages have been added.
8174
b5b4c94a
LP
8175 * MaxLevelStore=, MaxLevelSyslog=, MaxLevelKMsg=,
8176 MaxLevelConsole= can now be specified in
8177 journald.conf. These options allow reducing the amount of
8178 data stored on disk or forwarded by the log level.
2d197285 8179
b5b4c94a
LP
8180 * TimerSlackNSec= can now be specified in system.conf for
8181 PID1. This allows system-wide power savings.
2d197285
KS
8182
8183 Contributions from: Dave Reisner, Kay Sievers, Lauri Kasanen,
8184 Lennart Poettering, Malte Starostik, Marc-Antoine Perennou,
8185 Matthias Clasen
8186
4c8cd173 8187CHANGES WITH 184:
b6a86739 8188
4c8cd173
LP
8189 * logind is now capable of (optionally) handling power and
8190 sleep keys as well as the lid switch.
8191
8192 * journalctl now understands the syntax "journalctl
8193 /usr/bin/avahi-daemon" to get all log output of a specific
8194 daemon.
8195
8196 * CapabilityBoundingSet= in system.conf now also influences
8197 the capability bound set of usermode helpers of the kernel.
8198
8199 Contributions from: Daniel Drake, Daniel J. Walsh, Gert
8200 Michael Kulyk, Harald Hoyer, Jean Delvare, Kay Sievers,
8201 Lennart Poettering, Matthew Garrett, Matthias Clasen, Paul
8202 Menzel, Shawn Landden, Tero Roponen, Tom Gundersen
8203
ea5943d3 8204CHANGES WITH 183:
b6a86739 8205
187076d4
LP
8206 * Note that we skipped 139 releases here in order to set the
8207 new version to something that is greater than both udev's
8208 and systemd's most recent version number.
8209
194bbe33
KS
8210 * udev: all udev sources are merged into the systemd source tree now.
8211 All future udev development will happen in the systemd tree. It
8212 is still fully supported to use the udev daemon and tools without
8213 systemd running, like in initramfs or other init systems. Building
8214 udev though, will require the *build* of the systemd tree, but
ea5943d3 8215 udev can be properly *run* without systemd.
07cd4fc1 8216
91cf7e5c 8217 * udev: /lib/udev/devices/ are not read anymore; systemd-tmpfiles
f13b388f
KS
8218 should be used to create dead device nodes as workarounds for broken
8219 subsystems.
64661ee7 8220
2d13da88
KS
8221 * udev: RUN+="socket:..." and udev_monitor_new_from_socket() is
8222 no longer supported. udev_monitor_new_from_netlink() needs to be
8223 used to subscribe to events.
8224
194bbe33
KS
8225 * udev: when udevd is started by systemd, processes which are left
8226 behind by forking them off of udev rules, are unconditionally cleaned
8227 up and killed now after the event handling has finished. Services or
8228 daemons must be started as systemd services. Services can be
ea5943d3 8229 pulled-in by udev to get started, but they can no longer be directly
194bbe33
KS
8230 forked by udev rules.
8231
f13b388f
KS
8232 * udev: the daemon binary is called systemd-udevd now and installed
8233 in /usr/lib/systemd/. Standalone builds or non-systemd systems need
8234 to adapt to that, create symlink, or rename the binary after building
8235 it.
8236
ea5943d3 8237 * libudev no longer provides these symbols:
c1959569
KS
8238 udev_monitor_from_socket()
8239 udev_queue_get_failed_list_entry()
8240 udev_get_{dev,sys,run}_path()
ea5943d3 8241 The versions number was bumped and symbol versioning introduced.
c1959569 8242
ea5943d3 8243 * systemd-loginctl and systemd-journalctl have been renamed
9ae9afce 8244 to loginctl and journalctl to match systemctl.
18b754d3
KS
8245
8246 * The config files: /etc/systemd/systemd-logind.conf and
8247 /etc/systemd/systemd-journald.conf have been renamed to
8248 logind.conf and journald.conf. Package updates should rename
8249 the files to the new names on upgrade.
8250
ea5943d3
LP
8251 * For almost all files the license is now LGPL2.1+, changed
8252 from the previous GPL2.0+. Exceptions are some minor stuff
8253 of udev (which will be changed to LGPL2.1 eventually, too),
8254 and the MIT licensed sd-daemon.[ch] library that is suitable
8255 to be used as drop-in files.
8256
8257 * systemd and logind now handle system sleep states, in
49f43d5f 8258 particular suspending and hibernating.
ea5943d3
LP
8259
8260 * logind now implements a sleep/shutdown/idle inhibiting logic
8261 suitable for a variety of uses. Soonishly Lennart will blog
8262 about this in more detail.
8263
8264 * var-run.mount and var-lock.mount are no longer provided
ce830873 8265 (which previously bind mounted these directories to their new
ea5943d3
LP
8266 places). Distributions which have not converted these
8267 directories to symlinks should consider stealing these files
8268 from git history and add them downstream.
8269
8270 * We introduced the Documentation= field for units and added
8271 this to all our shipped units. This is useful to make it
3943231c 8272 easier to explore the boot and the purpose of the various
ea5943d3
LP
8273 units.
8274
8275 * All smaller setup units (such as
8276 systemd-vconsole-setup.service) now detect properly if they
8277 are run in a container and are skipped when
8278 appropriate. This guarantees an entirely noise-free boot in
8279 Linux container environments such as systemd-nspawn.
8280
8281 * A framework for implementing offline system updates is now
8282 integrated, for details see:
c6749ba5 8283 https://www.freedesktop.org/wiki/Software/systemd/SystemUpdates
ea5943d3
LP
8284
8285 * A new service type Type=idle is available now which helps us
8286 avoiding ugly interleaving of getty output and boot status
8287 messages.
8288
439d6dfd
LP
8289 * There's now a system-wide CapabilityBoundingSet= option to
8290 globally reduce the set of capabilities for the
ea5943d3
LP
8291 system. This is useful to drop CAP_SYS_MKNOD, CAP_SYS_RAWIO,
8292 CAP_NET_RAW, CAP_SYS_MODULE, CAP_SYS_TIME, CAP_SYS_PTRACE or
8293 even CAP_NET_ADMIN system-wide for secure systems.
8294
8295 * There are now system-wide DefaultLimitXXX= options to
8296 globally change the defaults of the various resource limits
8297 for all units started by PID 1.
8298
8299 * Harald Hoyer's systemd test suite has been integrated into
8300 systemd which allows easy testing of systemd builds in qemu
8301 and nspawn. (This is really awesome! Ask us for details!)
8302
3943231c
LP
8303 * The fstab parser is now implemented as generator, not inside
8304 of PID 1 anymore.
ea5943d3
LP
8305
8306 * systemctl will now warn you if .mount units generated from
8307 /etc/fstab are out of date due to changes in fstab that
d28315e4 8308 have not been read by systemd yet.
ea5943d3
LP
8309
8310 * systemd is now suitable for usage in initrds. Dracut has
8311 already been updated to make use of this. With this in place
8312 initrds get a slight bit faster but primarily are much
8313 easier to introspect and debug since "systemctl status" in
8314 the host system can be used to introspect initrd services,
8315 and the journal from the initrd is kept around too.
8316
8317 * systemd-delta has been added, a tool to explore differences
8318 between user/admin configuration and vendor defaults.
8319
8320 * PrivateTmp= now affects both /tmp and /var/tmp.
8321
8322 * Boot time status messages are now much prettier and feature
8323 proper english language. Booting up systemd has never been
8324 so sexy.
8325
8326 * Read-ahead pack files now include the inode number of all
8327 files to pre-cache. When the inode changes the pre-caching
8328 is not attempted. This should be nicer to deal with updated
8329 packages which might result in changes of read-ahead
8330 patterns.
8331
8332 * We now temporaritly lower the kernel's read_ahead_kb variable
8333 when collecting read-ahead data to ensure the kernel's
8334 built-in read-ahead does not add noise to our measurements
8335 of necessary blocks to pre-cache.
8336
8337 * There's now RequiresMountsFor= to add automatic dependencies
8338 for all mounts necessary for a specific file system path.
8339
8340 * MountAuto= and SwapAuto= have been removed from
8341 system.conf. Mounting file systems at boot has to take place
8342 in systemd now.
8343
8344 * nspawn now learned a new switch --uuid= to set the machine
8345 ID on the command line.
8346
f8c0a2cb 8347 * nspawn now learned the -b switch to automatically search
ea5943d3
LP
8348 for an init system.
8349
8350 * vt102 is now the default TERM for serial TTYs, upgraded from
8351 vt100.
8352
8353 * systemd-logind now works on VT-less systems.
8354
8355 * The build tree has been reorganized. The individual
3943231c 8356 components now have directories of their own.
ea5943d3
LP
8357
8358 * A new condition type ConditionPathIsReadWrite= is now available.
8359
8360 * nspawn learned the new -C switch to create cgroups for the
8361 container in other hierarchies.
8362
8363 * We now have support for hardware watchdogs, configurable in
8364 system.conf.
8365
8366 * The scheduled shutdown logic now has a public API.
8367
8368 * We now mount /tmp as tmpfs by default, but this can be
8369 masked and /etc/fstab can override it.
8370
d28315e4 8371 * Since udisks does not make use of /media anymore we are not
ea5943d3
LP
8372 mounting a tmpfs on it anymore.
8373
8374 * journalctl gained a new --local switch to only interleave
8375 locally generated journal files.
8376
8377 * We can now load the IMA policy at boot automatically.
8378
8379 * The GTK tools have been split off into a systemd-ui.
8380
79849bf9
LP
8381 Contributions from: Andreas Schwab, Auke Kok, Ayan George,
8382 Colin Guthrie, Daniel Mack, Dave Reisner, David Ward, Elan
8383 Ruusamäe, Frederic Crozat, Gergely Nagy, Guillermo Vidal,
8384 Hannes Reinecke, Harald Hoyer, Javier Jardón, Kay Sievers,
8385 Lennart Poettering, Lucas De Marchi, Léo Gillot-Lamure,
8386 Marc-Antoine Perennou, Martin Pitt, Matthew Monaco, Maxim
8387 A. Mikityanskiy, Michael Biebl, Michael Olbrich, Michal
8388 Schmidt, Nis Martensen, Patrick McCarty, Roberto Sassu, Shawn
8389 Landden, Sjoerd Simons, Sven Anders, Tollef Fog Heen, Tom
8390 Gundersen
8391
16f1239e 8392CHANGES WITH 44:
b6a86739 8393
16f1239e
LP
8394 * This is mostly a bugfix release
8395
8396 * Support optional initialization of the machine ID from the
8397 KVM or container configured UUID.
8398
8399 * Support immediate reboots with "systemctl reboot -ff"
8400
8401 * Show /etc/os-release data in systemd-analyze output
8402
ab06eef8 8403 * Many bugfixes for the journal, including endianness fixes and
16f1239e
LP
8404 ensuring that disk space enforcement works
8405
ce830873 8406 * sd-login.h is C++ compatible again
16f1239e
LP
8407
8408 * Extend the /etc/os-release format on request of the Debian
8409 folks
8410
8411 * We now refuse non-UTF8 strings used in various configuration
d28315e4 8412 and unit files. This is done to ensure we do not pass invalid
16f1239e
LP
8413 data over D-Bus or expose it elsewhere.
8414
8415 * Register Mimo USB Screens as suitable for automatic seat
8416 configuration
8417
8418 * Read SELinux client context from journal clients in a race
8419 free fashion
8420
8421 * Reorder configuration file lookup order. /etc now always
8422 overrides /run in order to allow the administrator to always
b938cb90 8423 and unconditionally override vendor-supplied or
16f1239e
LP
8424 automatically generated data.
8425
8426 * The various user visible bits of the journal now have man
8427 pages. We still lack man pages for the journal API calls
8428 however.
8429
8430 * We now ship all man pages in HTML format again in the
8431 tarball.
8432
8433 Contributions from: Dave Reisner, Dirk Eibach, Frederic
8434 Crozat, Harald Hoyer, Kay Sievers, Lennart Poettering, Marti
8435 Raudsepp, Michal Schmidt, Shawn Landden, Tero Roponen, Thierry
8436 Reding
8437
437b7dee 8438CHANGES WITH 43:
b6a86739 8439
437b7dee
LP
8440 * This is mostly a bugfix release
8441
8442 * systems lacking /etc/os-release are no longer supported.
8443
8444 * Various functionality updates to libsystemd-login.so
8445
45afd519 8446 * Track class of PAM logins to distinguish greeters from
437b7dee
LP
8447 normal user logins.
8448
8449 Contributions from: Kay Sievers, Lennart Poettering, Michael
8450 Biebl
8451
204fa33c 8452CHANGES WITH 42:
b6a86739 8453
204fa33c
LP
8454 * This is an important bugfix release for v41.
8455
8456 * Building man pages is now optional which should be useful
8457 for those building systemd from git but unwilling to install
8458 xsltproc.
8459
8460 * Watchdog support for supervising services is now usable. In
8461 a future release support for hardware watchdogs
8462 (i.e. /dev/watchdog) will be added building on this.
8463
8464 * Service start rate limiting is now configurable and can be
8465 turned off per service. When a start rate limit is hit a
8466 reboot can automatically be triggered.
8467
8468 * New CanReboot(), CanPowerOff() bus calls in systemd-logind.
8469
8470 Contributions from: Benjamin Franzke, Bill Nottingham,
8471 Frederic Crozat, Lennart Poettering, Michael Olbrich, Michal
8472 Schmidt, Michał Górny, Piotr Drąg
8473
e0d25329 8474CHANGES WITH 41:
b6a86739 8475
e0d25329
KS
8476 * The systemd binary is installed /usr/lib/systemd/systemd now;
8477 An existing /sbin/init symlink needs to be adapted with the
8478 package update.
8479
b13df964
LP
8480 * The code that loads kernel modules has been ported to invoke
8481 libkmod directly, instead of modprobe. This means we do not
8482 support systems with module-init-tools anymore.
8483
8484 * Watchdog support is now already useful, but still not
8485 complete.
8486
8487 * A new kernel command line option systemd.setenv= is
8488 understood to set system wide environment variables
8489 dynamically at boot.
8490
e9c1ea9d 8491 * We now limit the set of capabilities of systemd-journald.
ccd07a08 8492
353e12c2
LP
8493 * We now set SIGPIPE to ignore by default, since it only is
8494 useful in shell pipelines, and has little use in general
8495 code. This can be disabled with IgnoreSIPIPE=no in unit
8496 files.
8497
b13df964
LP
8498 Contributions from: Benjamin Franzke, Kay Sievers, Lennart
8499 Poettering, Michael Olbrich, Michal Schmidt, Tom Gundersen,
8500 William Douglas
8501
d26e4270 8502CHANGES WITH 40:
b6a86739 8503
d26e4270
LP
8504 * This is mostly a bugfix release
8505
8506 * We now expose the reason why a service failed in the
8507 "Result" D-Bus property.
8508
8509 * Rudimentary service watchdog support (will be completed over
8510 the next few releases.)
8511
8512 * When systemd forks off in order execute some service we will
8513 now immediately changes its argv[0] to reflect which process
8514 it will execute. This is useful to minimize the time window
8515 with a generic argv[0], which makes bootcharts more useful
8516
b13df964
LP
8517 Contributions from: Alvaro Soliverez, Chris Paulson-Ellis, Kay
8518 Sievers, Lennart Poettering, Michael Olbrich, Michal Schmidt,
8519 Mike Kazantsev, Ray Strode
8520
220a21d3 8521CHANGES WITH 39:
b6a86739 8522
220a21d3
LP
8523 * This is mostly a test release, but incorporates many
8524 bugfixes.
8525
8526 * New systemd-cgtop tool to show control groups by their
8527 resource usage.
8528
8529 * Linking against libacl for ACLs is optional again. If
8530 disabled, support tracking device access for active logins
8531 goes becomes unavailable, and so does access to the user
8532 journals by the respective users.
8533
8534 * If a group "adm" exists, journal files are automatically
8535 owned by them, thus allow members of this group full access
8536 to the system journal as well as all user journals.
8537
8538 * The journal now stores the SELinux context of the logging
8539 client for all entries.
8540
8541 * Add C++ inclusion guards to all public headers
8542
8543 * New output mode "cat" in the journal to print only text
8544 messages, without any meta data like date or time.
8545
8546 * Include tiny X server wrapper as a temporary stop-gap to
8547 teach XOrg udev display enumeration. This is used by display
8548 managers such as gdm, and will go away as soon as XOrg
8549 learned native udev hotplugging for display devices.
8550
8551 * Add new systemd-cat tool for executing arbitrary programs
8552 with STDERR/STDOUT connected to the journal. Can also act as
8553 BSD logger replacement, and does so by default.
8554
8555 * Optionally store all locally generated coredumps in the
8556 journal along with meta data.
8557
8558 * systemd-tmpfiles learnt four new commands: n, L, c, b, for
8559 writing short strings to files (for usage for /sys), and for
8560 creating symlinks, character and block device nodes.
8561
8562 * New unit file option ControlGroupPersistent= to make cgroups
8563 persistent, following the mechanisms outlined in
56cadcb6 8564 https://www.freedesktop.org/wiki/Software/systemd/PaxControlGroups
220a21d3
LP
8565
8566 * Support multiple local RTCs in a sane way
8567
8568 * No longer monopolize IO when replaying readahead data on
8569 rotating disks, since we might starve non-file-system IO to
8570 death, since fanotify() will not see accesses done by blkid,
8571 or fsck.
8572
d28315e4 8573 * Do not show kernel threads in systemd-cgls anymore, unless
220a21d3
LP
8574 requested with new -k switch.
8575
8576 Contributions from: Dan Horák, Kay Sievers, Lennart
8577 Poettering, Michal Schmidt
8578
8579CHANGES WITH 38:
b6a86739 8580
220a21d3
LP
8581 * This is mostly a test release, but incorporates many
8582 bugfixes.
8583
8584 * The git repository moved to:
8585 git://anongit.freedesktop.org/systemd/systemd
8586 ssh://git.freedesktop.org/git/systemd/systemd
8587
8588 * First release with the journal
8589 http://0pointer.de/blog/projects/the-journal.html
8590
8591 * The journal replaces both systemd-kmsg-syslogd and
8592 systemd-stdout-bridge.
8593
8594 * New sd_pid_get_unit() API call in libsystemd-logind
8595
8596 * Many systemadm clean-ups
8597
8598 * Introduce remote-fs-pre.target which is ordered before all
8599 remote mounts and may be used to start services before all
8600 remote mounts.
8601
8602 * Added Mageia support
8603
8604 * Add bash completion for systemd-loginctl
8605
8606 * Actively monitor PID file creation for daemons which exit in
8607 the parent process before having finished writing the PID
8608 file in the daemon process. Daemons which do this need to be
8609 fixed (i.e. PID file creation must have finished before the
8610 parent exits), but we now react a bit more gracefully to them.
8611
8612 * Add colourful boot output, mimicking the well-known output
8613 of existing distributions.
8614
8615 * New option PassCredentials= for socket units, for
8616 compatibility with a recent kernel ABI breakage.
8617
8618 * /etc/rc.local is now hooked in via a generator binary, and
8619 thus will no longer act as synchronization point during
8620 boot.
8621
8622 * systemctl list-unit-files now supports --root=.
8623
8624 * systemd-tmpfiles now understands two new commands: z, Z for
8625 relabelling files according to the SELinux database. This is
8626 useful to apply SELinux labels to specific files in /sys,
8627 among other things.
8628
8629 * Output of SysV services is now forwarded to both the console
8630 and the journal by default, not only just the console.
8631
8632 * New man pages for all APIs from libsystemd-login.
8633
ce830873 8634 * The build tree got reorganized and the build system is a
220a21d3
LP
8635 lot more modular allowing embedded setups to specifically
8636 select the components of systemd they are interested in.
8637
8638 * Support for Linux systems lacking the kernel VT subsystem is
8639 restored.
8640
8641 * configure's --with-rootdir= got renamed to
8642 --with-rootprefix= to follow the naming used by udev and
8643 kmod
8644
d28315e4 8645 * Unless specified otherwise we will now install to /usr instead
220a21d3
LP
8646 of /usr/local by default.
8647
8648 * Processes with '@' in argv[0][0] are now excluded from the
8649 final shut-down killing spree, following the logic explained
8650 in:
56cadcb6 8651 https://www.freedesktop.org/wiki/Software/systemd/RootStorageDaemons
220a21d3
LP
8652
8653 * All processes remaining in a service cgroup when we enter
8654 the START or START_PRE states are now killed with
8655 SIGKILL. That means it is no longer possible to spawn
8656 background processes from ExecStart= lines (which was never
8657 supported anyway, and bad style).
8658
8659 * New PropagateReloadTo=/PropagateReloadFrom= options to bind
8660 reloading of units together.
8661
4c8cd173 8662 Contributions from: Bill Nottingham, Daniel J. Walsh, Dave
220a21d3
LP
8663 Reisner, Dexter Morgan, Gregs Gregs, Jonathan Nieder, Kay
8664 Sievers, Lennart Poettering, Michael Biebl, Michal Schmidt,
8665 Michał Górny, Ran Benita, Thomas Jarosch, Tim Waugh, Tollef
8666 Fog Heen, Tom Gundersen, Zbigniew Jędrzejewski-Szmek