X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-tmpfiles.xml;h=f4d53b31393238574db0e54d50fed830ffee19e8;hb=7d328b544621d4b1bec936dec612947ad8bfb65a;hp=0d2d65d593a6fb9f43efa3014b0b601cb6540e80;hpb=195f8e36122b83bbfef27bf63afe888e7101a320;p=elogind.git diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index 0d2d65d59..f4d53b313 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + systemd-tmpfiles @@ -54,7 +55,9 @@ - systemd-tmpfiles OPTIONS CONFIGURATION FILE + systemd-tmpfiles + OPTIONS + CONFIGFILE systemd-tmpfiles-setup.service @@ -67,22 +70,20 @@ Description systemd-tmpfiles creates, - deletes and cleans up volatile and temporary files and + deletes, and cleans up volatile and temporary files and directories, based on the configuration file format and - location specified in - tmpfiles.d - 5 - . + location specified in + tmpfiles.d5. + If invoked with no arguments, it applies all directives from all configuration files. If one or - more file names are passed on the command line, only + more filenames are passed on the command line, only the directives in these files are applied. If only the basename of a configuration file is specified, - all configuration directories as specified in - tmpfiles.d - 5 - are searched for a matching file. + all configuration directories as specified in + tmpfiles.d5 + are searched for a matching file. @@ -91,21 +92,37 @@ The following options are understood: - - If this option is passed all - files and directories marked with f, - F, d, D in the configuration files are - created. Files and directories marked with z, - Z have their ownership, access mode and security - labels set. + If this option is + passed, all files and directories + marked with f, + F, + w, + d, + D, + v, + p, + L, + c, + b, + m in the + configuration files are created or + written to. Files and directories + marked with z, + Z, + t, + T, + a, and + A have their + ownership, access mode and security + labels set. If this option is - passed all files and directories with + passed, all files and directories with an age parameter configured will be cleaned up. @@ -113,25 +130,46 @@ If this option is - passed all files and directories marked - with r, R in the configuration files - are removed. + passed, the contents of + directories marked with + D or + R, and files or + directories themselves marked with + r or + R are + removed. - - Only apply rules that - apply to paths with the specified - prefix. + + Also execute lines + with an exclamation mark. + - - - - - Prints a short help - text and exits. + + Only apply rules with + paths that start with the specified + prefix. This option can be specified + multiple times. + + + + Ignore rules with + paths that start with the specified + prefix. This option can be specified + multiple times. + + + + Takes a directory path + as an argument. All paths will be + prefixed with the given alternate root + path, including config search paths. + + + It is possible to combine @@ -146,10 +184,23 @@ + + Unprivileged --cleanup operation + + systemd-tmpfiles tries to + avoid changing the access and modification times on + the directories it accesses, which requires + CAP_ADMIN privileges. When + running as non-root, directories which are checked for + files to clean up will have their access time bumped, + which might prevent their cleanup. + + + Exit status - On success 0 is returned, a non-zero failure + On success, 0 is returned, a non-zero failure code otherwise. @@ -157,7 +208,7 @@ See Also systemd1, - tmpfiles.d5, + tmpfiles.d5