From: Lennart Poettering Date: Tue, 12 Jan 2021 20:34:50 +0000 (+0100) Subject: tmpfiles: document that the "argument" field doesn't do quotes X-Git-Tag: v248-rc1~357^2~3 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=29271da500e7bbd818843036a05229c42cf7b640;p=thirdparty%2Fsystemd.git 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 --- diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 49ce8375a40..4adbf6bb0a6 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -145,14 +145,17 @@ A+ /path-or-glob/to/append/acls/recursively - - - - POSIX Configuration File Format - The configuration format is one line per path containing - type, path, mode, ownership, age, and argument fields: + 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: - #Type Path Mode User Group Age Argument + #Type Path Mode User Group Age Argument… d /run/user 0755 root root 10d - L /tmp/foobar - - - - /dev/null - Fields may be enclosed within quotes and contain C-style escapes. + 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. \x20). Type