NEWS

   1 systemd System and Service Manager
   2
   3 CHANGES WITH 186:
   4
   5         * Several tools now understand kernel command line arguments,
   6           which are only read when run in an initial RAM disk. They
   7           usually follow closely their normal counterparts, but are
   8           prefixed with rd.
   9
  10         * There's a new tool to analyze the readahead files that are
  11           automatically generated at boot. Use:
  12
  13           /usr/lib/systemd/systemd-readahead analyze /.readahead
  14
  15         * We now provide an early debug shell on tty9 if this enabled. Use:
  16
  17           systemctl enable debug-shell.service
  18
  19         * All plymouth related units have been moved into the Plymouth
  20           package. Please make sure to upgrade your Plymouth version
  21           as well.
  22
  23         * systemd-tmpfiles now supports getting passed the basename of
  24           a configuration file only, in which case it will look for it
  25           in all appropriate directories automatically.
  26
  27         * udevadm info now takes a /dev or /sys path as argument, and
  28           does the right thing. Example:
  29
  30           udevadm info /dev/sda
  31           udevadm info /sys/class/block/sda
  32
  33         * systemctl now prints a warning if a unit is stopped but a
  34           unit that might trigger it continues to run. Example: a
  35           service is stopped but the socket that activates it is left
  36           running.
  37
  38         * "systemctl status" will now mention if the log output was
  39           shortened due to rotation since a service has been started.
  40
  41         * The journal API now exposes functions to determine the
  42           "cutoff" times due to rotation.
  43
  44         * journald now understands SIGUSR1 and SIGUSR2 for triggering
  45           immediately flushing of runtime logs to /var if possible,
  46           resp. for triggering immediate rotation of the journal
  47           files.
  48
  49         * It is now considered an error if a service is attempted to
  50           be stopped that is not loaded.
  51
  52         * XDG_RUNTIME_DIR now uses numeric UIDs instead of usernames.
  53
  54         * systemd-analyze now supports Python 3
  55
  56         * tmpfiles now supports cleaning up directories via aging
  57           where the first level dirs are always kept around but
  58           directories beneath it automatically aged. This is enabled
  59           by prefixing the age field with '~'.
  60
  61         * Seat objects now expose CanGraphical, CanTTY properties
  62           which is required to deal with very fast bootups where the
  63           display manager might be running before the graphics drivers
  64           completed initialization.
  65
  66         * Seat objects now expose a State property.
  67
  68         * We now include RPM macros for service enabling/disabling
  69           based on the preset logic. We recommend RPM based
  70           distributions to make use of these macros if possible. This
  71           makes it simpler to reuse RPM spec files across
  72           distributions.
  73
  74         * We now make sure that the collected systemd unit name is
  75           always valid when services log to the journal via
  76           STDOUT/STDERR.
  77
  78         * There's a new man page kernel-command-line(7) detailing all
  79           command line options we understand.
  80
  81         * The fstab generator may now be disabled at boot by passing
  82           fstab=0 on the kernel command line.
  83
  84         * A new kernel command line option modules-load= is now understood
  85           to load a specific kernel module statically, early at boot.
  86
  87         * Unit names specified on the systemctl command line are now
  88           automatically escaped as needed. Also, if file system or
  89           device paths are specified they are automatically turned
  90           into the appropriate mount or device unit names. Example:
  91
  92           systemctl status /home
  93           systemctl status /dev/sda
  94
  95         * The SysVConsole= configuration option has been removed from
  96           system.conf parsing.
  97
  98         * The SysV search path is no longer exported on the D-Bus
  99           Manager object.
 100
 101         * The Names= option is been removed from unit file parsing.
 102
 103         * There's a new man page bootup(7) detailing the boot process.
 104
 105         * Every unit and every generator we ship with systemd now
 106           comes with full documentation. The self-explanatory boot is
 107           complete.
 108
 109         * A couple of services gained "systemd-" prefixes in their
 110           name if they wrap systemd code, rather than only external
 111           code. Among them fsck@.service which is now
 112           systemd-fsck@.service.
 113
 114         * The HaveWatchdog property has been removed from the D-Bus
 115           Manager object.
 116
 117         * systemd.confirm_spawn= on the kernel command line should now
 118           work sensibly.
 119
 120         * There's a new man page crypttab(5) which details all options
 121           we actually understand.
 122
 123         * systemd-nspawn gained a new --capability= switch to pass
 124           additional capabilities to the container.
 125
 126         * timedated will now read known NTP implementation unit names
 127           from /usr/share/systemd/ntp-units.d/*.list,
 128           systemd-timedated-ntp.target has been removed.
 129
 130         * journalctl gained a new switch "-b" that lists log data of
 131           the current boot only.
 132
 133         * The notify socket is in the abstract namespace again, in
 134           order to support daemons which chroot() at start-up.
 135
 136         * There is a new Storage= configuration option for journald
 137           which allows configuration of where log data should go. This
 138           also provides a way to disable journal logging entirely, so
 139           that data collected is only forwarded to the console, the
 140           kernel log buffer or another syslog implementation.
 141
 142         * Many bugfixes and optimizations.
 143
 144         Contributions from: Auke Kok, Colin Guthrie, Dave Reisner,
 145         David Strauss, Eelco Dolstra, Kay Sievers, Lennart Poettering,
 146         Lukas Nykryn, Michal Schmidt, Michal Sekletar, Paul Menzel,
 147         Shawn Landden, Tom Gundersen
 148
 149 CHANGES WITH 185:
 150         * "systemctl help <unit>" now shows the man page if one is
 151           available.
 152
 153         * Several new man pages have been added.
 154
 155         * MaxLevelStore=, MaxLevelSyslog=, MaxLevelKMsg=,
 156           MaxLevelConsole= can now be specified in
 157           journald.conf. These options allow reducing the amount of
 158           data stored on disk or forwarded by the log level.
 159
 160         * TimerSlackNSec= can now be specified in system.conf for
 161           PID1. This allows system-wide power savings.
 162
 163         Contributions from: Dave Reisner, Kay Sievers, Lauri Kasanen,
 164         Lennart Poettering, Malte Starostik, Marc-Antoine Perennou,
 165         Matthias Clasen
 166
 167 CHANGES WITH 184:
 168         * logind is now capable of (optionally) handling power and
 169           sleep keys as well as the lid switch.
 170
 171         * journalctl now understands the syntax "journalctl
 172           /usr/bin/avahi-daemon" to get all log output of a specific
 173           daemon.
 174
 175         * CapabilityBoundingSet= in system.conf now also influences
 176           the capability bound set of usermode helpers of the kernel.
 177
 178         Contributions from: Daniel Drake, Daniel J. Walsh, Gert
 179         Michael Kulyk, Harald Hoyer, Jean Delvare, Kay Sievers,
 180         Lennart Poettering, Matthew Garrett, Matthias Clasen, Paul
 181         Menzel, Shawn Landden, Tero Roponen, Tom Gundersen
 182
 183 CHANGES WITH 183:
 184         * Note that we skipped 139 releases here in order to set the
 185           new version to something that is greater than both udev's
 186           and systemd's most recent version number.
 187
 188         * udev: all udev sources are merged into the systemd source tree now.
 189           All future udev development will happen in the systemd tree. It
 190           is still fully supported to use the udev daemon and tools without
 191           systemd running, like in initramfs or other init systems. Building
 192           udev though, will require the *build* of the systemd tree, but
 193           udev can be properly *run* without systemd.
 194
 195         * udev: /lib/udev/devices/ are not read anymore; systemd-tmpfiles
 196           should be used to create dead device nodes as workarounds for broken
 197           subsystems.
 198
 199         * udev: RUN+="socket:..."  and udev_monitor_new_from_socket() is
 200           no longer supported. udev_monitor_new_from_netlink() needs to be
 201           used to subscribe to events.
 202
 203         * udev: when udevd is started by systemd, processes which are left
 204           behind by forking them off of udev rules, are unconditionally cleaned
 205           up and killed now after the event handling has finished. Services or
 206           daemons must be started as systemd services. Services can be
 207           pulled-in by udev to get started, but they can no longer be directly
 208           forked by udev rules.
 209
 210         * udev: the daemon binary is called systemd-udevd now and installed
 211           in /usr/lib/systemd/. Standalone builds or non-systemd systems need
 212           to adapt to that, create symlink, or rename the binary after building
 213           it.
 214
 215         * libudev no longer provides these symbols:
 216             udev_monitor_from_socket()
 217             udev_queue_get_failed_list_entry()
 218             udev_get_{dev,sys,run}_path()
 219           The versions number was bumped and symbol versioning introduced.
 220
 221         * systemd-loginctl and systemd-journalctl have been renamed
 222           to loginctl and journalctl to match systemctl.
 223
 224         * The config files: /etc/systemd/systemd-logind.conf and
 225           /etc/systemd/systemd-journald.conf have been renamed to
 226           logind.conf and journald.conf. Package updates should rename
 227           the files to the new names on upgrade.
 228
 229         * For almost all files the license is now LGPL2.1+, changed
 230           from the previous GPL2.0+. Exceptions are some minor stuff
 231           of udev (which will be changed to LGPL2.1 eventually, too),
 232           and the MIT licensed sd-daemon.[ch] library that is suitable
 233           to be used as drop-in files.
 234
 235         * systemd and logind now handle system sleep states, in
 236           particulary suspending and hibernating.
 237
 238         * logind now implements a sleep/shutdown/idle inhibiting logic
 239           suitable for a variety of uses. Soonishly Lennart will blog
 240           about this in more detail.
 241
 242         * var-run.mount and var-lock.mount are no longer provided
 243           (which prevously bind mounted these directories to their new
 244           places). Distributions which have not converted these
 245           directories to symlinks should consider stealing these files
 246           from git history and add them downstream.
 247
 248         * We introduced the Documentation= field for units and added
 249           this to all our shipped units. This is useful to make it
 250           easier to explore the boot and the purpose of the various
 251           units.
 252
 253         * All smaller setup units (such as
 254           systemd-vconsole-setup.service) now detect properly if they
 255           are run in a container and are skipped when
 256           appropriate. This guarantees an entirely noise-free boot in
 257           Linux container environments such as systemd-nspawn.
 258
 259         * A framework for implementing offline system updates is now
 260           integrated, for details see:
 261           http://freedesktop.org/wiki/Software/systemd/SystemUpdates
 262
 263         * A new service type Type=idle is available now which helps us
 264           avoiding ugly interleaving of getty output and boot status
 265           messages.
 266
 267         * There's now a system-wide CapabilityBoundingSet= option to
 268           globally reduce the set of capabilities for the
 269           system. This is useful to drop CAP_SYS_MKNOD, CAP_SYS_RAWIO,
 270           CAP_NET_RAW, CAP_SYS_MODULE, CAP_SYS_TIME, CAP_SYS_PTRACE or
 271           even CAP_NET_ADMIN system-wide for secure systems.
 272
 273         * There are now system-wide DefaultLimitXXX= options to
 274           globally change the defaults of the various resource limits
 275           for all units started by PID 1.
 276
 277         * Harald Hoyer's systemd test suite has been integrated into
 278           systemd which allows easy testing of systemd builds in qemu
 279           and nspawn. (This is really awesome! Ask us for details!)
 280
 281         * The fstab parser is now implemented as generator, not inside
 282           of PID 1 anymore.
 283
 284         * systemctl will now warn you if .mount units generated from
 285           /etc/fstab are out of date due to changes in fstab that
 286           haven't been read by systemd yet.
 287
 288         * systemd is now suitable for usage in initrds. Dracut has
 289           already been updated to make use of this. With this in place
 290           initrds get a slight bit faster but primarily are much
 291           easier to introspect and debug since "systemctl status" in
 292           the host system can be used to introspect initrd services,
 293           and the journal from the initrd is kept around too.
 294
 295         * systemd-delta has been added, a tool to explore differences
 296           between user/admin configuration and vendor defaults.
 297
 298         * PrivateTmp= now affects both /tmp and /var/tmp.
 299
 300         * Boot time status messages are now much prettier and feature
 301           proper english language. Booting up systemd has never been
 302           so sexy.
 303
 304         * Read-ahead pack files now include the inode number of all
 305           files to pre-cache. When the inode changes the pre-caching
 306           is not attempted. This should be nicer to deal with updated
 307           packages which might result in changes of read-ahead
 308           patterns.
 309
 310         * We now temporaritly lower the kernel's read_ahead_kb variable
 311           when collecting read-ahead data to ensure the kernel's
 312           built-in read-ahead does not add noise to our measurements
 313           of necessary blocks to pre-cache.
 314
 315         * There's now RequiresMountsFor= to add automatic dependencies
 316           for all mounts necessary for a specific file system path.
 317
 318         * MountAuto= and SwapAuto= have been removed from
 319           system.conf. Mounting file systems at boot has to take place
 320           in systemd now.
 321
 322         * nspawn now learned a new switch --uuid= to set the machine
 323           ID on the command line.
 324
 325         * nspawn now learned the -b switch to automatically search
 326           for an init system.
 327
 328         * vt102 is now the default TERM for serial TTYs, upgraded from
 329           vt100.
 330
 331         * systemd-logind now works on VT-less systems.
 332
 333         * The build tree has been reorganized. The individual
 334           components now have directories of their own.
 335
 336         * A new condition type ConditionPathIsReadWrite= is now available.
 337
 338         * nspawn learned the new -C switch to create cgroups for the
 339           container in other hierarchies.
 340
 341         * We now have support for hardware watchdogs, configurable in
 342           system.conf.
 343
 344         * The scheduled shutdown logic now has a public API.
 345
 346         * We now mount /tmp as tmpfs by default, but this can be
 347           masked and /etc/fstab can override it.
 348
 349         * Since udisks doesn't make use of /media anymore we are not
 350           mounting a tmpfs on it anymore.
 351
 352         * journalctl gained a new --local switch to only interleave
 353           locally generated journal files.
 354
 355         * We can now load the IMA policy at boot automatically.
 356
 357         * The GTK tools have been split off into a systemd-ui.
 358
 359         Contributions from: Andreas Schwab, Auke Kok, Ayan George,
 360         Colin Guthrie, Daniel Mack, Dave Reisner, David Ward, Elan
 361         Ruusamäe, Frederic Crozat, Gergely Nagy, Guillermo Vidal,
 362         Hannes Reinecke, Harald Hoyer, Javier Jardón, Kay Sievers,
 363         Lennart Poettering, Lucas De Marchi, Léo Gillot-Lamure,
 364         Marc-Antoine Perennou, Martin Pitt, Matthew Monaco, Maxim
 365         A. Mikityanskiy, Michael Biebl, Michael Olbrich, Michal
 366         Schmidt, Nis Martensen, Patrick McCarty, Roberto Sassu, Shawn
 367         Landden, Sjoerd Simons, Sven Anders, Tollef Fog Heen, Tom
 368         Gundersen
 369
 370 CHANGES WITH 44:
 371         * This is mostly a bugfix release
 372
 373         * Support optional initialization of the machine ID from the
 374           KVM or container configured UUID.
 375
 376         * Support immediate reboots with "systemctl reboot -ff"
 377
 378         * Show /etc/os-release data in systemd-analyze output
 379
 380         * Many bugfixes for the journal, including endianess fixes and
 381           ensuring that disk space enforcement works
 382
 383         * sd-login.h is C++ comptaible again
 384
 385         * Extend the /etc/os-release format on request of the Debian
 386           folks
 387
 388         * We now refuse non-UTF8 strings used in various configuration
 389           and unit files. This is done to ensure we don't pass invalid
 390           data over D-Bus or expose it elsewhere.
 391
 392         * Register Mimo USB Screens as suitable for automatic seat
 393           configuration
 394
 395         * Read SELinux client context from journal clients in a race
 396           free fashion
 397
 398         * Reorder configuration file lookup order. /etc now always
 399           overrides /run in order to allow the administrator to always
 400           and unconditionally override vendor supplied or
 401           automatically generated data.
 402
 403         * The various user visible bits of the journal now have man
 404           pages. We still lack man pages for the journal API calls
 405           however.
 406
 407         * We now ship all man pages in HTML format again in the
 408           tarball.
 409
 410         Contributions from: Dave Reisner, Dirk Eibach, Frederic
 411         Crozat, Harald Hoyer, Kay Sievers, Lennart Poettering, Marti
 412         Raudsepp, Michal Schmidt, Shawn Landden, Tero Roponen, Thierry
 413         Reding
 414
 415 CHANGES WITH 43:
 416         * This is mostly a bugfix release
 417
 418         * systems lacking /etc/os-release  are no longer supported.
 419
 420         * Various functionality updates to libsystemd-login.so
 421
 422         * Track class of PAM logins to distuingish greeters from
 423           normal user logins.
 424
 425         Contributions from: Kay Sievers, Lennart Poettering, Michael
 426         Biebl
 427
 428 CHANGES WITH 42:
 429         * This is an important bugfix release for v41.
 430
 431         * Building man pages is now optional which should be useful
 432           for those building systemd from git but unwilling to install
 433           xsltproc.
 434
 435         * Watchdog support for supervising services is now usable. In
 436           a future release support for hardware watchdogs
 437           (i.e. /dev/watchdog) will be added building on this.
 438
 439         * Service start rate limiting is now configurable and can be
 440           turned off per service. When a start rate limit is hit a
 441           reboot can automatically be triggered.
 442
 443         * New CanReboot(), CanPowerOff() bus calls in systemd-logind.
 444
 445         Contributions from: Benjamin Franzke, Bill Nottingham,
 446         Frederic Crozat, Lennart Poettering, Michael Olbrich, Michal
 447         Schmidt, Michał Górny, Piotr Drąg
 448
 449 CHANGES WITH 41:
 450         * The systemd binary is installed /usr/lib/systemd/systemd now;
 451           An existing /sbin/init symlink needs to be adapted with the
 452           package update.
 453
 454         * The code that loads kernel modules has been ported to invoke
 455           libkmod directly, instead of modprobe. This means we do not
 456           support systems with module-init-tools anymore.
 457
 458         * Watchdog support is now already useful, but still not
 459           complete.
 460
 461         * A new kernel command line option systemd.setenv= is
 462           understood to set system wide environment variables
 463           dynamically at boot.
 464
 465         * We now limit the set of capabilities of systemd-journald.
 466
 467         * We now set SIGPIPE to ignore by default, since it only is
 468           useful in shell pipelines, and has little use in general
 469           code. This can be disabled with IgnoreSIPIPE=no in unit
 470           files.
 471
 472         Contributions from: Benjamin Franzke, Kay Sievers, Lennart
 473         Poettering, Michael Olbrich, Michal Schmidt, Tom Gundersen,
 474         William Douglas
 475
 476 CHANGES WITH 40:
 477         * This is mostly a bugfix release
 478
 479         * We now expose the reason why a service failed in the
 480           "Result" D-Bus property.
 481
 482         * Rudimentary service watchdog support (will be completed over
 483           the next few releases.)
 484
 485         * When systemd forks off in order execute some service we will
 486           now immediately changes its argv[0] to reflect which process
 487           it will execute. This is useful to minimize the time window
 488           with a generic argv[0], which makes bootcharts more useful
 489
 490         Contributions from: Alvaro Soliverez, Chris Paulson-Ellis, Kay
 491         Sievers, Lennart Poettering, Michael Olbrich, Michal Schmidt,
 492         Mike Kazantsev, Ray Strode
 493
 494 CHANGES WITH 39:
 495         * This is mostly a test release, but incorporates many
 496           bugfixes.
 497
 498         * New systemd-cgtop tool to show control groups by their
 499           resource usage.
 500
 501         * Linking against libacl for ACLs is optional again. If
 502           disabled, support tracking device access for active logins
 503           goes becomes unavailable, and so does access to the user
 504           journals by the respective users.
 505
 506         * If a group "adm" exists, journal files are automatically
 507           owned by them, thus allow members of this group full access
 508           to the system journal as well as all user journals.
 509
 510         * The journal now stores the SELinux context of the logging
 511           client for all entries.
 512
 513         * Add C++ inclusion guards to all public headers
 514
 515         * New output mode "cat" in the journal to print only text
 516           messages, without any meta data like date or time.
 517
 518         * Include tiny X server wrapper as a temporary stop-gap to
 519           teach XOrg udev display enumeration. This is used by display
 520           managers such as gdm, and will go away as soon as XOrg
 521           learned native udev hotplugging for display devices.
 522
 523         * Add new systemd-cat tool for executing arbitrary programs
 524           with STDERR/STDOUT connected to the journal. Can also act as
 525           BSD logger replacement, and does so by default.
 526
 527         * Optionally store all locally generated coredumps in the
 528           journal along with meta data.
 529
 530         * systemd-tmpfiles learnt four new commands: n, L, c, b, for
 531           writing short strings to files (for usage for /sys), and for
 532           creating symlinks, character and block device nodes.
 533
 534         * New unit file option ControlGroupPersistent= to make cgroups
 535           persistent, following the mechanisms outlined in
 536           http://www.freedesktop.org/wiki/Software/systemd/PaxControlGroups
 537
 538         * Support multiple local RTCs in a sane way
 539
 540         * No longer monopolize IO when replaying readahead data on
 541           rotating disks, since we might starve non-file-system IO to
 542           death, since fanotify() will not see accesses done by blkid,
 543           or fsck.
 544
 545         * Don't show kernel threads in systemd-cgls anymore, unless
 546           requested with new -k switch.
 547
 548         Contributions from: Dan Horák, Kay Sievers, Lennart
 549         Poettering, Michal Schmidt
 550
 551 CHANGES WITH 38:
 552         * This is mostly a test release, but incorporates many
 553           bugfixes.
 554
 555         * The git repository moved to:
 556           git://anongit.freedesktop.org/systemd/systemd
 557           ssh://git.freedesktop.org/git/systemd/systemd
 558
 559         * First release with the journal
 560           http://0pointer.de/blog/projects/the-journal.html
 561
 562         * The journal replaces both systemd-kmsg-syslogd and
 563           systemd-stdout-bridge.
 564
 565         * New sd_pid_get_unit() API call in libsystemd-logind
 566
 567         * Many systemadm clean-ups
 568
 569         * Introduce remote-fs-pre.target which is ordered before all
 570           remote mounts and may be used to start services before all
 571           remote mounts.
 572
 573         * Added Mageia support
 574
 575         * Add bash completion for systemd-loginctl
 576
 577         * Actively monitor PID file creation for daemons which exit in
 578           the parent process before having finished writing the PID
 579           file in the daemon process. Daemons which do this need to be
 580           fixed (i.e. PID file creation must have finished before the
 581           parent exits), but we now react a bit more gracefully to them.
 582
 583         * Add colourful boot output, mimicking the well-known output
 584           of existing distributions.
 585
 586         * New option PassCredentials= for socket units, for
 587           compatibility with a recent kernel ABI breakage.
 588
 589         * /etc/rc.local is now hooked in via a generator binary, and
 590           thus will no longer act as synchronization point during
 591           boot.
 592
 593         * systemctl list-unit-files now supports --root=.
 594
 595         * systemd-tmpfiles now understands two new commands: z, Z for
 596           relabelling files according to the SELinux database. This is
 597           useful to apply SELinux labels to specific files in /sys,
 598           among other things.
 599
 600         * Output of SysV services is now forwarded to both the console
 601           and the journal by default, not only just the console.
 602
 603         * New man pages for all APIs from libsystemd-login.
 604
 605         * The build tree got reorganized and a the build system is a
 606           lot more modular allowing embedded setups to specifically
 607           select the components of systemd they are interested in.
 608
 609         * Support for Linux systems lacking the kernel VT subsystem is
 610           restored.
 611
 612         * configure's --with-rootdir= got renamed to
 613           --with-rootprefix= to follow the naming used by udev and
 614           kmod
 615
 616         * Unless specified otherwise we'll now install to /usr instead
 617           of /usr/local by default.
 618
 619         * Processes with '@' in argv[0][0] are now excluded from the
 620           final shut-down killing spree, following the logic explained
 621           in:
 622           http://www.freedesktop.org/wiki/Software/systemd/RootStorageDaemons
 623
 624         * All processes remaining in a service cgroup when we enter
 625           the START or START_PRE states are now killed with
 626           SIGKILL. That means it is no longer possible to spawn
 627           background processes from ExecStart= lines (which was never
 628           supported anyway, and bad style).
 629
 630         * New PropagateReloadTo=/PropagateReloadFrom= options to bind
 631           reloading of units together.
 632
 633         Contributions from: Bill Nottingham, Daniel J. Walsh, Dave
 634         Reisner, Dexter Morgan, Gregs Gregs, Jonathan Nieder, Kay
 635         Sievers, Lennart Poettering, Michael Biebl, Michal Schmidt,
 636         Michał Górny, Ran Benita, Thomas Jarosch, Tim Waugh, Tollef
 637         Fog Heen, Tom Gundersen, Zbigniew Jędrzejewski-Szmek