summaryrefslogtreecommitdiff
path: root/man/systemd-tmpfiles.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: document image policy syntax and semantics, and the hooks in the ↵Lennart Poettering2023-04-051-0/+2
| | | | various components
* tmpfiles: Try to take a BSD lock on files as wellDaan De Meyer2023-03-301-1/+3
| | | | | | Similar to what we do for directories, just before we remove a file, let's try to take a BSD lock on it. If that fails, skip removing the file.
* tree-wide: BLS and DPS are now on uapi-group websiteZbigniew Jędrzejewski-Szmek2022-11-211-1/+1
|
* tmpfiles: accept additional tmpfiles lines via credentialLennart Poettering2022-07-201-0/+25
|
* Typos found by codespellDimitri Papadopoulos2021-10-201-1/+1
|
* tmpfiles: make handling of existing-but-different targets more consistentZbigniew Jędrzejewski-Szmek2021-04-081-10/+12
| | | | | | | | | | | | | | | | | | | | | create_fifo() was added in a2fc2f8dd30c17ad1e23a31fc6ff2aeba4c6fa27, and would always ignore failure. The test was trying to fail in this case, but we actually don't fail, which seems to be correct. We didn't notice before because the test was ineffective. To make things consistent, generally log at warning level, but don't propagate the error. For symlinks, log at debug level, as before. For 'e', failure is not propagated now. The test is adjusted to match. I think warning is appropriate in most cases: we do not expect a device node to be replaced by a different device node or even a non-device file. This would most likely be an error somewhere. An exception is made for symlinks, which are mismatched on purpose, for example /etc/resolv.conf. With this patch, we don't get any warnings with the any of the 74 tmpfiles.d files, which suggests that increasing the warning levels will not cause too many unexpected warnings. If it turns out that there are valid cases where people have expected mismatches for non-symlink types, we can always decrease the log levels again.
* man: tweak descriptions of how tmpfiles should be startedZbigniew Jędrzejewski-Szmek2021-03-011-19/+19
| | | | | | | We shouldn't imply that invocation without any parameters is OK. Also, mention that the service can be restarted. Fixes #8684.
* man: explain how to invoke tmpfiles for debuggingZbigniew Jędrzejewski-Szmek2021-03-011-0/+21
| | | | Fixes #11914.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-2/+2
|
* man: Fix typo in systemd-tmpfilesPhaedrus Leeds2020-08-191-1/+1
|
* man: document the new --image= switches in journalctl/sysusers/tmpfilesLennart Poettering2020-08-051-0/+15
|
* tmpfiles: add new switch -E for quickly excluding /proc, /dev, /sys and /runLennart Poettering2020-08-051-1/+16
|
* man: document the new tmpfiles --root= behaviour regarding usersLennart Poettering2020-05-071-4/+4
|
* man: add note which tmpfiles services read which filesZbigniew Jędrzejewski-Szmek2019-05-221-1/+17
| | | | Fixes #12596.
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
* man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* man: document that removal/clean-up is done before creation in systemd-tmpfilesLennart Poettering2018-11-081-5/+3
|
* man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* tree-wide: remove Lennart's copyright linesLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | These lines are generally out-of-date, incomplete and unnecessary. With SPDX and git repository much more accurate and fine grained information about licensing and authorship is available, hence let's drop the per-file copyright notice. Of course, removing copyright lines of others is problematic, hence this commit only removes my own lines and leaves all others untouched. It might be nicer if sooner or later those could go away too, making git the only and accurate source of authorship information.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* binfmt,sysctl,sysuers,tmpfiles: add auto-paging for --cat-config commandsLennart Poettering2018-06-131-0/+1
| | | | | The output of these commands is really long, and already enriched with color. Let's add auto-paging to make this easier to digest.
* tmpfiles: fix documented constant for exit code 73Will Thompson2018-05-221-1/+1
| | | | | | | | | sysexits.h has: #define EX_CANTCREAT 73 /* can't create (user) output file */ EX_DATAERR is a copy-paste error from the previous sentence, which is correct.
* tmpfiles: add --cat-configZbigniew Jędrzejewski-Szmek2018-04-271-0/+1
| | | | | | This implements similar logic as conf_files_cat(), but with slightly different file gathering logic. I also want to add support for replacement files later on, so it seems better to keep those two file-gathering functions separate.
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* tmpfiles: add a new return code for "operational failure" when processingZbigniew Jędrzejewski-Szmek2018-04-051-4/+8
| | | | | | | | Things can fail, and we have no control over it: - file system issues (immutable bits, file system errors, MAC refusals, etc) - kernel refusing certain arguments when writing to /proc/sys or /sys Let's add a new code for the case where we parsed configuration but failed to execute it because of external errors.
* man: fix capability name in man:systemd-tmpfiles(8) (#8139)Lucas Werkmeister2018-02-091-1/+1
| | | | | CAP_ADMIN does not exist (the closest existing capability name would be CAP_SYS_ADMIN), and according to man:open(2) and man:capabilities(7), the capability required to specify O_NOATIME is actually CAP_FOWNER.
* tmpfiles: allow admin/runtime overrides to runtime configZbigniew Jędrzejewski-Szmek2018-02-051-5/+25
| | | | | This is very similar to d16a1c1bb6. For tmpfiles this is much less useful compared to sysusers, but let's add this anyway for consistency.
* Hook up systemd-tmpfiles as user unitsZbigniew Jędrzejewski-Szmek2017-12-061-4/+10
| | | | | | | | | | | | | An explicit --user switch is necessary because for the user@0.service instance systemd-tmpfiles is running as root, and we need to distinguish that from systemd-tmpfiles running in systemd-tmpfiles*.service. Fixes #2208. v2: - restore "systemd-" prefix - add systemd-tmpfiles-clean.{service,timer}, systemd-setup.service to systemd-tmpfiles(8)
* tmpfiles: add --user switchZbigniew Jędrzejewski-Szmek2017-12-061-1/+7
|
* tmpfiles: add a special return code for syntax failuresZbigniew Jędrzejewski-Szmek2017-12-011-2/+8
| | | | | | | | | In this way, individual errors in files can be treated differently than a failure of the whole service. A test is added to check that the expected value is returned. Some parts are commented out, because it is not. This will be fixed in a subsequent commit.
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* man: document interaction of --root= and the user/group databases (#7344)Lennart Poettering2017-11-161-4/+8
| | | Fixes: #7032
* tmpfiles: interpret "-" as stdinZbigniew Jędrzejewski-Szmek2016-04-201-5/+5
|
* man: systemd-tmpfiles requires absolute filenamesEvgeny Vereshchagin2015-10-191-1/+1
| | | | | | | `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 setupsTom Gundersen2015-06-181-4/+1
| | | | | | | | | | | | | | | | | | | | | | | 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 manpagesFilipe Brandenburger2015-05-281-1/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 2chZbigniew Jędrzejewski-Szmek2015-02-031-190/+175
|
* tmpfiles: fix help textZbigniew Jędrzejewski-Szmek2015-01-271-4/+4
| | | | | 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 upZbigniew Jędrzejewski-Szmek2015-01-241-0/+13
| | | | | | | | | | | | | 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 codeZbigniew Jędrzejewski-Szmek2015-01-231-5/+12
|
* tmpfiles: add --root option to operate on an alternate fs treeMichael Marineau2014-03-141-2/+10
| | | | | 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-pagerZbigniew Jędrzejewski-Szmek2014-02-201-16/+5
|
* tmpfiles: rename --unsafe to --bootZbigniew Jędrzejewski-Szmek2013-12-301-1/+1
| | | | | As suggested by Kay, it is better to describe what is done, not what might happen.
* man: improvements to comma placementJan Engelhardt2013-12-251-1/+1
| | | | | This is a recurring submission and includes corrections to: comma placement.
* tmpfiles: introduce the concept of unsafe operationsZbigniew Jędrzejewski-Szmek2013-12-241-0/+6
| | | | | | | | | | | | | | | | | | | | | | | | 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) cleanupZbigniew Jędrzejewski-Szmek2013-12-241-19/+34
| | | | | | | | | 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()Lennart Poettering2013-11-061-9/+14
| | | | | 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 ↵Lennart Poettering2013-09-171-1/+1
| | | | it exists
* man: wording and grammar updatesJan Engelhardt2013-09-121-3/+3
| | | | | | | | | | | | 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)
View Lorry Controller Status