From 29271da500e7bbd818843036a05229c42cf7b640 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Tue, 12 Jan 2021 21:34:50 +0100 Subject: 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 --- man/tmpfiles.d.xml | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) (limited to 'man/tmpfiles.d.xml') 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 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 -- cgit v1.2.1