summaryrefslogtreecommitdiff
path: root/man/tmpfiles.d.xml
Commit message (Collapse)AuthorAgeFilesLines
* man: fix quickhelp listing in tmpfiles.d(5)Zbigniew Jędrzejewski-Szmek2021-04-081-2/+2
| | | | | Unlike many other small/big letter combos, this one has the recursive version attached to the lowercase letter.
* shared: add new IMAGE_VERSION=/IMAGE_ID= field to /etc/os-releaseLennart Poettering2021-03-311-0/+2
| | | | | | | | | | | | | | | | | | | | | | This specifes two new optional fields for /etc/os-release: IMAGE_VERSION= and IMAGE_ID= that are supposed to identify the image of the current booted system by name and version. This is inspired by the versioning stuff in https://github.com/systemd/mkosi/pull/683. In environments where pre-built images are installed and updated as a whole the existing os-release version/distro identifier are not sufficient to describe the system's version, as they describe only the distro an image is built from, but not the image itself, even if that image is deployed many times on many systems, and even if that image contains more resources than just the RPMs/DEBs. In particular, "mkosi" is a tool for building disk images based on distro RPMs with additional resources dropped in. The combination of all of these together with their versions should also carry an identifier and version, and that's what IMAGE_VERSION= and IMAGE_ID= is supposed to be.
* tmpfiles: document that the "argument" field doesn't do quotesLennart Poettering2021-01-121-4/+7
| | | | | | | | | | | | This adjust the documentation to match the code, addressing #17740. I actually think that not making the "argument" field accept quotes was a mistake, but I also understand why this choice was made. Given that we shipped this forever like this though I don't think it's worth changing the behaviour now. Supporting quotes for this is not that important I guess. Hence document the current behaviour. Fixes: #17740
* man: sort specifiers alphabeticallyYu Watanabe2020-11-251-10/+10
|
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man: add note that %T/%V don't have the trailing slashZbigniew Jędrzejewski-Szmek2020-10-051-10/+2
|
* man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-9/+9
|
* man: fix reference to unit fileLennart Poettering2020-09-281-1/+1
| | | | | | It' "systemd-tmpfiles-clean" not "systemd-tmpfiles-cleanup" Fixes: #17171
* tmpfiles: clarify that "!" lines are filtered before collisions are checkedLennart Poettering2020-05-101-10/+13
| | | | Fixes: #15675
* man: mention the exclamation mark and minus sign literally, to make things ↵Lennart Poettering2020-05-101-12/+8
| | | | | | | | searchable I was looking for the explanation for the exclamation mark in the text, and couldn't find it, searching for "!". Let's make this easier, and indicate the character meant.
* Add %l as specifier for the hostname without any domain componentZbigniew Jędrzejewski-Szmek2020-05-071-0/+1
| | | | | | | | | As described in #15603, it is a fairly common setup to use a fqdn as the configured hostname. But it is often convenient to use just the actual hostname, i.e. until the first dot. This adds support in tmpfiles, sysusers, and unit files for %l which expands to that. Fixes #15603.
* man: add specifiers section to directives indexZbigniew Jędrzejewski-Szmek2020-05-071-1/+1
| | | | | | The hack with getparent().txt is not very pretty, but the whole thing seems to work well enough. It is useful to figure out whihc specifiers are supported where.
* man: migrate more specifier explanations to standard-specifiers.xmlLennart Poettering2020-05-051-25/+5
| | | | | | | We probably can migrate even more, but for now let's just migrate those which have the 1:1 identical text everywhere. (Also, let's add the % entry to all specifier tables)
* man: document new specifiersLennart Poettering2020-04-281-1/+7
|
* Typo fixbemarek2020-03-091-1/+1
|
* man: tmpfiles.d: z/Z ignore the argumentTopi Miettinen2020-02-181-2/+2
| | | | | The argument is not used for any MAC context by z and Z, so drop the confusing text from the table.
* man: tmpfiles.d: list missing qFlorian Klink2020-01-261-1/+2
| | | | | Also, Q creates directories (same as v), so update the example accordingly.
* man: tmpfiles.d: only list "v" onceAnsgar Burchardt2020-01-031-1/+0
|
* man: tmpfiles.d: "b", "c" options require major and minor numbersAnsgar Burchardt2020-01-031-4/+4
|
* [man] fix URLAnita Zhang2019-12-181-1/+1
|
* man: fix a few bogus entries in directives indexZbigniew Jędrzejewski-Szmek2019-11-211-1/+1
| | | | | | When wrong element types are used, directives are sometimes placed in the wrong section. Also, strip part of text starting with "'", which is used in a few places and which is displayed improperly in the index.
* man: change noindex="true" to index="false"Zbigniew Jędrzejewski-Szmek2019-11-211-1/+1
| | | | We nowadays prefer positive options over negative.
* systemd-tmpfiles: cleanup man page program listingZach Smith2019-11-081-2/+8
|
* systemd-tmpfiles: deprecate F for f+Zach Smith2019-10-311-11/+8
|
* systemd-tmpfiles: allow appending content to fileZach Smith2019-10-031-8/+8
| | | | | | | Adds support to append to files with w+ type. w /tmp/13291.out - - - - first line\n w+ /tmp/13291.out - - - - second line\n
* man: highlight the different concepts behind h/H and t/TLennart Poettering2019-07-241-33/+34
| | | | Fixes: #13151
* Merge pull request #12750 from keszybz/tmpfiles-c-copyLennart Poettering2019-07-111-0/+31
|\ | | | | Make tmpfiles C use --root
| * man: add "quick reference" to tmpfiles.d(5)Zbigniew Jędrzejewski-Szmek2019-06-051-0/+31
| | | | | | | | | | | | The synopsis section would describe config file paths, but not their syntax. Let's add a short table that so that it's possible to quickly remind oneself what the different letter mean.
* | man: document tmpfiles.d/ user/group resolvability needsLennart Poettering2019-07-031-0/+8
|/
* tmpfiles: support the FS_PROJINHERIT_FL chattr flagLennart Poettering2019-03-281-9/+5
|
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+2
| | | | | | | 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: document the new BSD file lock logic in tmpfilesLennart Poettering2019-02-151-0/+8
|
* Fixed minor typo in man/tmpfiles.d.xmlRonnie P. Thomas2019-01-301-1/+1
|
* tmpfiles: Make C still copy if the destination directory is emptyRyan Gonzalez2019-01-081-5/+5
| | | | Fixes #11287.
* man: add a note that /var/run should not be used in tmpfilesZbigniew Jędrzejewski-Szmek2018-12-111-0/+7
|
* man: rewrite the general description of tmpfilesZbigniew Jędrzejewski-Szmek2018-12-111-16/+27
| | | | | | | | | We would describe tmpfiles.d through what systemd-tmpfiles does with them, but I think it's better to start with a geneneral statement what they are. Also, let's make the description of volatile file systems less prominent. Also, strenghten the advice to use RuntimeDirectory and mention {Cache,Logs,Configuration,State}Directory=.
* man: reword tmpfiles.d descriptions to refer less to previous descriptionsZbigniew Jędrzejewski-Szmek2018-12-111-56/+56
| | | | | | | | | | | | | | | | | I think it is OK if some option is described as "similar to ..., but in addition ...", as long as the "in addition" part is strictly additive this is unambiguous. Otherwise, we'd have to repeat a lot of text, and then we'd probably forget to adjust some of the descriptions when doing changes. But when the "in addition" part is about replacing or removing parts of functionality, it is better to avoid this pattern and describe the later option from scratch. Some paragraph breaks are added and minor changes made. UID/GID is changed to user/group, since we generally expect user/group names to be used, not numeric ids. Fixes #11115.
* man: minor fixesLennart Poettering2018-11-201-3/+3
| | | | | | As suggested here: https://github.com/systemd/systemd/pull/10538#pullrequestreview-176710207
* man: document that for removal tmpfiles.d prefix is run after suffixLennart Poettering2018-11-081-22/+14
|
* man: stop mentioning /var/run in tmpfiles.d(5)Lennart Poettering2018-11-081-6/+3
| | | | | | It's obsolete, stop mentioning it. Let's not confuse people suggests it would be OK to use that, because it really isn't anymore, and it gives us trouble with merging idenctical lines.
* 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.