summaryrefslogtreecommitdiffstats
path: root/man/tmpfiles.d.xml (follow)
Commit message (Collapse)AuthorAgeFilesLines
* shared: add %g, %G specifiers for group / gid (#10368)Davide Cavalca2018-10-131-0/+10
|
* man: fix explanation about UID/GID field in tmpfiles.d(5)Yu Watanabe2018-10-051-10/+5
| | | | Fixes #9495.
* RFC tmpfiles: Allow configuration to ignore execution errorsWilliam Douglas2018-09-251-1/+10
| | | | | | | | This is an implementation that covers making errors encountered when writing file content optionally fatal. If this is something that folks would want I'll add handling of this for all the other directives. I'd appreciate suggestions on how this might better be structured as well (use of a goto fail or such) as I'm not super happy with the approach.
* tmpfiles: don't adjust qgroups on existing subvolumesFranck Bui2018-08-081-58/+37
| | | | | | | | | | The qgroup logic (types 'q' and 'Q') only has an effect if there's no previous setup at all, and any explicitly configured subvolumes with their qgroups are left entirely unmodified. The idea is that if users want a different logic than the one we set up by default, then by all means they should do that before hand, and tmpfiles won't override their logic.
* Merge pull request #9489 from keszybz/copyright-removal-3Lennart Poettering2018-07-031-1/+1
|\ | | | | Copyright header removal, part 3 (or 4?)
| * man: drop mode line in file headersZbigniew Jędrzejewski-Szmek2018-07-031-1/+1
| | | | | | | | | | This is already included in .dir-locals, so we don't need it in the files themselves.
* | man: add missing <option> tagLucas Werkmeister2018-07-031-1/+1
|/ | | | | | | One mention of --user was missing the surrounding <option> tag, making the table look inconsistent (though the inconsistency is less obvious after the reordering in 709f4c472c, since the four specifiers mentioning the --user option are no longer immediately adjacent).
* 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: beautify remaining copyright statementsLennart Poettering2018-06-141-1/+1
| | | | | | Let's unify an beautify our remaining copyright statements, with a unicode ©. This means our copyright statements are now always formatted the same way. Yay.
* 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.
* man: don't refer to "service manager" in tmpfiles.d(5)Lennart Poettering2018-05-291-3/+3
| | | | system-tmpfiles is not a "service manager" hence say "command" instead.
* core: introduce specifiers for /tmp and /var/tmpLennart Poettering2018-05-291-0/+10
| | | | | | | | | | | This corresponds nicely with the specifiers we already pass for /var/lib, /var/cache, /run and so on. This is particular useful to update the test-path service files to operate without guessable files, thus allowing multiple parallel test-path invocations to pass without issues (the idea is to set $TMPDIR early on in the test to some private directory, and then only use the new %T or %V specifier to refer to it).
* man: sort specifier list in systemd.unit(5) alphabeticallyLennart Poettering2018-05-291-28/+28
| | | | | | | | | | | | | | | Usually, we order our settings in our unit files in a logical order, grouping related settings together, and putting more relevant stuff first, instead of following a strictly alphabetical order. For specifiers I think it makes sense to follow an alphabetical order however, since they literally are just characters, and hence I think the concept of alphabetical ordering is much more commanding for them. Also, since specifiers are usually not used in combination, but mostly used indepdently of each other I think it's not that important to group similar ones together. No other changes except the reordering.
* 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.
* man: document meaning of age in tmpfiles.d (#8092)Lucas Werkmeister2018-02-051-0/+7
| | | | | | | | | | | This documents how the age of a file is determined, which previously was only alluded to in other parts of the documentation. Fixes #8091. The phrasings of “last modification timestamp” etc. are taken from man:inode(7) (as of man-pages 4.14). The debug messages in tmpfiles.c use different messages (“modify time”), which according to a code comment follow man:stat(1); however, my copy of that manpage (from GNU coreutils 8.29) documents %y as “time of last data modification” instead.
* tmpfiles: make "f" lines behaviour match what the documentation saysLennart Poettering2018-01-241-18/+10
| | | | | | | | | | | | | | | | | | | | CHANGE OF BEHAVIOUR — with this commit "f" line's behaviour is altered to match what the documentation says: if an "argument" string is specified it is written to the file only when the file didn't exist before. Previously, it would be appended to the file each time systemd-tmpfiles was invoked — which is not a particularly useful behaviour as the tool is not idempotent then and the indicated files grow without bounds each time the tool is invoked. I did some spelunking whether this change in behaviour would break things, but afaics nothing relies on the previous O_APPEND behaviour of this line type, hence I think it's relatively safe to make "f" lines work the way the docs say, rather than adding a new modifier for it or so. Triggered by: https://lists.freedesktop.org/archives/systemd-devel/2018-January/040171.html
* tmpfiles: create parent directories if they are missing for more line typesLennart Poettering2018-01-231-0/+7
| | | | | | | | | | | | | | | Currently, we create leading directories implicitly for all lines that create directory or directory-like nodes. With this, we also do the same for a number of other lines: f/F, C, p, L, c/b (that is regular files, pipes, symlinks, device nodes as well as file trees we copy). The leading directories are created with te default access mode of 0755. If something else is desired, users should simply declare appropriate "d" lines. Fixes: #7853
* man: fix example formatting in systemd.presetZbigniew Jędrzejewski-Szmek2018-01-201-1/+1
| | | | | Repeating "example" everywhere was not useful, so remove that and improve the formatting a bit.
* tmpfiles: also add %t/%S/%C/%L specifiersZbigniew Jędrzejewski-Szmek2017-12-061-1/+21
| | | | | | | | | sd_path_home() returns ENXIO when a variable (such as $XDG_RUNTIME_DIR) is not defined. Previously we used ENOKEY for unresolvable specifiers. To avoid having two codes, or translating ENXIO to ENOKEY, I replaced ENOKEY use with ENXIO. v2: - use sd_path_home and change to ENXIO everywhere
* tmpfiles: add --user switchZbigniew Jędrzejewski-Szmek2017-12-061-3/+11
|
* tmpfiles: Add specifiers to allow running as user instanceayekat2017-12-061-0/+15
| | | | | | | | | This commit adds specifiers %U, %u and %h for the user UID, name and home directory, respectively. [zj: drop untrue copy-pasted comments and move the next text to the new "Specifiers" section. Now that #7444 has been merged, also drop the specifier functions.]
* Fail on unknown (alphanumerical) specifiersZbigniew Jędrzejewski-Szmek2017-12-061-0/+1
| | | | | | | | | | | | | | | | | | | | | | | The code intentionally ignored unknown specifiers, treating them as text. This needs to change because otherwise we can never add a new specifier in a backwards compatible way. So just treat an unknown (potential) specifier as an error. In principle this is a break of backwards compatibility, but the previous behaviour was pretty much useless, since the expanded value could change every time we add new specifiers, which we do all the time. As a compromise for backwards compatibility, only fail on alphanumerical characters. This should cover the most cases where an unescaped percent character is used, like size=5% and such, which behave the same as before with this patch. OTOH, this means that we will not be able to use non-alphanumerical specifiers without breaking backwards compatibility again. I think that's an acceptable compromise. v2: - add NEWS entry v3: - only fail on alphanumerical
* man: specifiers are allow for argument field in tmpfilesZbigniew Jędrzejewski-Szmek2017-12-011-45/+52
|
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* typo: chache → cache (#6864)Ansgar Burchardt2017-09-191-2/+2
|
* man: unify titling, fix description of precedence in sysusers.d(5)Zbigniew Jędrzejewski-Szmek2017-09-141-1/+5
| | | | | | | | | Fixes #6639. (This behaviour of systemd-sysusers is long established, so it's better to adjust the documentation rather than change the code. If there are any situations out there where it matters, users must have adjusted to the current behaviour.)
* man: fix example indentation in tmpfiles.d(5) (#6578)Lennart Poettering2017-08-261-3/+3
| | | | docboc actually copies the indentation 1:1 into the final man page and that makes the example really weirdly aligned. Let's fix that.
* tmpfiles: Allow create symlink on directories (#6039)William Douglas2017-08-091-7/+8
| | | | | | Currently if tmpfiles is run with force on symlink creation but there already exists a directory at that location, the creation will fail. This change updates the behavior to remove the directory with rm_fr and then attempts to create the symlink again.
* man: fix typo (#4615)Yu Watanabe2016-11-081-1/+1
|
* man: add an example how to unconditionally empty a directory (#4570)Zbigniew Jędrzejewski-Szmek2016-11-081-6/+22
| | | | | | It was logical, but not entirely obvious, that 'e' with no arguments does nothing. Expand the explanation a bit and add an example. Fixes #4564.
* man: fix typos (#4527)Jakub Wilk2016-10-311-1/+1
|
* man: provide html links to a bunch of external man pagesZbigniew Jędrzejewski-Szmek2016-08-061-2/+2
|
* tmpfiles: add new 'e' action which cleans up a dir without creating itZbigniew Jędrzejewski-Szmek2016-04-201-1/+21
| | | | | | | | I wanted to add a config line that would empty a directory without creating it if doesn't exist. Existing actions don't allow this. v2: properly add 'e' to needs_glob() and takes_ownership()
* man: try to explain different actions in tmpfiles a bit betterZbigniew Jędrzejewski-Szmek2016-04-201-14/+45
| | | | | | | | | | | | | | - do not suggest that vendor configuration files should be in /etc, use /usr/lib/tmpfiles.d instead - split the first example, because the text talked about "needing two directories", but then a smack attribute was also set, and on a different path, which looked like a typo. Replace that with the example from original patch [1] which added 't'. - fix the example for /var/tmp/abrt. The 'x' line was redundant, because /var/tmp/abrt/* is already filtered because "d /var/tmp/abrt" overrides "d /var/tmp". [1] http://permalink.gmane.org/gmane.comp.sysutils.systemd.devel/25051
* man/tmpfiles.d: add note about permissions and ownership of symlinksJan Synacek2016-01-131-1/+2
| | | | ...because this is might not be obvious.
* man: fix typosJakub Wilk2015-12-261-1/+1
|
* tmpfiles: create subvolumes for "v", "q", and "Q" only if / is a subvolumeLennart Poettering2015-11-161-7/+9
| | | | | | | | | | | | | | | | It's not a good idea to create subvolumes for parts of the OS tree (such as /home, or /var) if the root directory is not a subvolume too. We shouldn't assume control of "heavier" objects such as subvolumes, if the originating object (the root directory) is a "light-weight" object, i.e. a plain directory. Effectively this means that chroot() environments that are run on a plain directory do not have to deal with problems around systemd creating subvolumes that cannot be removed with a simple "rm" anymore. However, if the chroot manager creates a proper subvolume for such an environment it will also get further subvolumes placed in there, under the assumption that the manager understands the concept of subvolumes in that case.
* doc: correct orthography, word forms and missing/extraneous wordsJan Engelhardt2015-11-061-13/+13
|
* doc: correct punctuation and improve typography in documentationJan Engelhardt2015-11-061-13/+13
|
* Fixed link to chattr man pagekayrus2015-11-031-1/+1
|
* tmpfiles: introduce "q" and "Q" for creating quota-enabled btrfs subvolumesLennart Poettering2015-10-221-11/+81
| | | | | This allows us to set up the quota group hierarchy in a reasonable way on btrfs file systems.
* man: tmpfiles.d: add info about age fieldEvgeny Vereshchagin2015-10-191-2/+3
| | | | | The age field applies to lines starting with `v`, `C`, `X` too. See the function `clean_item` in the file `src/tmpfiles/tmpfiles.c`
* 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.
* man: elaborate on the order by which tmpfiles operations are executedLennart Poettering2015-04-221-3/+6
|
* man: slightly fewer paragraphs can help readabilityLennart Poettering2015-04-131-14/+12
|
* man: fix examples indentation in tmpfiles.d(5)Lennart Poettering2015-04-131-3/+3
|
* man: add information about more lines to explanation of argument fieldLennart Poettering2015-04-131-3/+6
|
* man: document which tmpfiles line types follow symlinksLennart Poettering2015-04-131-18/+20
| | | | | | | Generally, we will not follow symlinks, except for "w". Avoid documentation for now for fifo, device node, directory lines, which currently follow symlinks but better shouldn't.
* man: add h/H to tmpfiles.d(5)Goffredo Baroncelli2015-03-201-1/+37
|