diff options
author | Lennart Poettering <lennart@poettering.net> | 2021-01-12 21:34:50 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2021-01-12 22:00:35 +0100 |
commit | 29271da500e7bbd818843036a05229c42cf7b640 (patch) | |
tree | 71a828de73c86a39916cdfff84dce9945605e82c /man | |
parent | 4bb322f58ccf2b87be7318d8caebcd6024c266fd (diff) | |
download | systemd-29271da500e7bbd818843036a05229c42cf7b640.tar.gz |
tmpfiles: document that the "argument" field doesn't do quotes
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
Diffstat (limited to 'man')
-rw-r--r-- | man/tmpfiles.d.xml | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 49ce8375a4..4adbf6bb0a 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -145,14 +145,17 @@ A+ /path-or-glob/to/append/acls/recursively - - - - POSIX <refsect1> <title>Configuration File Format</title> - <para>The configuration format is one line per path containing - type, path, mode, ownership, age, and argument fields:</para> + <para>The configuration format is one line per path, containing type, path, mode, ownership, age, and + argument fields. The lines are separated by newlines, the fields by whitespace:</para> - <programlisting>#Type Path Mode User Group Age Argument + <programlisting>#Type Path Mode User Group Age Argument… d /run/user 0755 root root 10d - L /tmp/foobar - - - - /dev/null</programlisting> - <para>Fields may be enclosed within quotes and contain C-style escapes.</para> + <para>Fields may contain C-style escapes. With the exception of the seventh field (the "argument") all + fields may be enclosed in quotes. Note that any whitespace found in the line after the beginning of the + argument field will be considered part of the argument field. To begin the argument field with a + whitespace character, use C-style escapes (e.g. <literal>\x20</literal>).</para> <refsect2> <title>Type</title> |