man: systemd-tmpfiles requires absolute filenames `systemd-tmpfiles --clean ./some.conf` doesn't work: Failed to open './some.conf', ignoring: No such file or directory `systemd-tmpfiles --clean $(realpath ./some.conf)` works fine.

man: revert dynamic paths for split-usr setups This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.

man: generate configured paths in manpages In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.

Reindent man pages to 2ch

tmpfiles: fix help text The help text, apart from being too long, did not describe what the options really do.

tmpfiles: do not bump access times of directories we are cleaning up Both plain opendir() and glob() will bump access time. Privileged option O_NOATIME can be used to prevent the access time from being updated. We already used it for subdirectories of the directories which we were cleaning up. But for the directories specified directly in the config files, we wouldn't do that. This means that, paradoxically, our own temporary directories for PrivateTmp would stay around forever, as long as one let systemd-tmpfiles-clean.service run regularly, because they had their own glob patterns specified. https://bugzilla.redhat.com/show_bug.cgi?id=1183684

man: bring tmpfiles.d(5) in line with code

tmpfiles: add --root option to operate on an alternate fs tree This makes it possible to initialize or cleanup an arbitrary filesystem hierarchy in the same way that it would be during system boot.

man: xinclude --help/--version/--no-pager

tmpfiles: rename --unsafe to --boot As suggested by Kay, it is better to describe what is done, not what might happen.

man: improvements to comma placement This is a recurring submission and includes corrections to: comma placement.

tmpfiles: introduce the concept of unsafe operations Various operations done by systemd-tmpfiles may only be safely done at boot (e.g. removal of X lockfiles in /tmp, creation of /run/nologin). Other operations may be done at any point in time (e.g. setting the ownership on /{run,var}/log/journal). This distinction is largely orthogonal to the type of operation. A new switch --unsafe is added, and operations which should only be executed during bootup are marked with an exclamation mark in the configuration files. systemd-tmpfiles.service is modified to use this switch, and guards are added so it is hard to re-start it by mistake. If we install a new version of systemd, we actually want to enforce some changes to tmpfiles configuration immediately. This should now be possible to do safely, so distribution packages can be modified to execute the "safe" subset at package installation time. /run/nologin creation is split out into a separate service, to make it easy to override. https://bugzilla.redhat.com/show_bug.cgi?id=1043212 https://bugzilla.redhat.com/show_bug.cgi?id=1045849

man,units: tmpfiles.d(5) cleanup Condition for /lib (necessary for split /usr) was missing from the unit. Some changes which were done in tmpfiles.d(5) were not carried over to systemd-tmpfiles(1). Also use markup where possible.

clients: unify how we invoke getopt_long() Among other things this makes sure we always expose a --version command and show it in the help texts.

tmpfiles: add a new "m" line type that adjusts user/group/mode of a file if it exists

man: wording and grammar updates This is a recurring submission and includes corrections to various issue spotted. I guess I can just skip over reporting ubiquitous comma placement fixes… Highligts in this particular commit: - the "unsigned" type qualifier is completed to form a full type "unsigned int" - alphabetic -> lexicographic (that way we automatically define how numbers get sorted)

tmpfiles: introduce --exclude-prefix The opposite of --prefix, allows specifying path prefixes which should be skipped when processing rules.

tmpfiles: support passing --prefix multiple times

man: improve grammar and word formatting in numerous man pages Use proper grammar, word usage, adjective hyphenation, commas, capitalization, spelling, etc. To improve readability, some run-on sentences or sentence fragments were revised. [zj: remove the space from 'file name', 'host name', and 'time zone'.]

man: link systemd-tmpfiles-setup-dev.service

man: reword man page titles Make sure the man page titles are similar in style and capitalization so that our man page index looks pretty.

man: document unit names in systemd-tmpfiles(8)

tmpfiles: print error if basename lookup fails; document it in manpage

man: systemd-tmpfiles - document proper config-file-stack order

relicense to LGPLv2.1 (with exceptions) We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.

tmpfiles: add 'z', like 'Z' but not recursive

tmpfiles: apply chown, chmod for 'Z' entries too If changing ownership or permissions is not desired, they can be configured to '-' or omitted entirely.

man: document 'Z' in tmpfiles

man: Fix command name in systemd-tmpfiles example.

man: un-reverse IgnoreOnSnapshot description I think that snapshots & devices are actually _not_ captured in snapshots.

man: Spelling fixes

systemd: document systemd-tmpfiles