X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-tmpfiles.xml;h=d4c5bf26e4c6473cf0aecf82b77226bcee5b5718;hp=623b420560b1d898372aac041db4bfff2be18532;hb=df99a9ef5bb7a89b92ccfb103b2f3e7046c62ef5;hpb=ca2e894bdbd06b43800b57074be0e499a3539b0d diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index 623b42056..d4c5bf26e 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -21,7 +21,8 @@ along with systemd; If not, see . --> - + systemd-tmpfiles @@ -44,36 +45,45 @@ systemd-tmpfiles + systemd-tmpfiles-setup.service + systemd-tmpfiles-setup-dev.service + systemd-tmpfiles-clean.service + systemd-tmpfiles-clean.timer Creates, deletes and cleans up volatile - and temporary files and directories. + and temporary files and directories - systemd-tmpfiles OPTIONS CONFIGURATION FILE + systemd-tmpfiles + OPTIONS + CONFIGFILE + + systemd-tmpfiles-setup.service + systemd-tmpfiles-setup-dev.service + systemd-tmpfiles-clean.service + systemd-tmpfiles-clean.timer 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. @@ -82,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. @@ -104,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. - + + Also execute lines + with an exclamation mark. + + + + Only apply rules that apply to paths with the specified - prefix. + prefix. This option can be specified + multiple times. - - - - - Prints a short help - text and exits. + + Ignore rules that + apply to paths 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 @@ -137,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. @@ -148,7 +208,7 @@ See Also systemd1, - tmpfiles.d5, + tmpfiles.d5