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=74dfd5ac7e710c71f1b18cbebdd8b1a89c6b7a5b;hb=df99a9ef5bb7a89b92ccfb103b2f3e7046c62ef5;hpb=062e01bbdbc3201e4c99bc0b702cb04a0ae2190c diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index 74dfd5ac7..d4c5bf26e 100644 --- a/man/systemd-tmpfiles.xml +++ b/man/systemd-tmpfiles.xml @@ -8,20 +8,21 @@ Copyright 2010 Lennart Poettering systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. systemd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Lesser General Public License for more details. - You should have received a copy of the GNU General Public License + You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> - + systemd-tmpfiles @@ -44,32 +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 - directories, based on the configuration from - /etc/tmpfiles.d/. See + deletes, and cleans up volatile and temporary files and + directories, based on the configuration file format and + location specified in + tmpfiles.d5. + + + If invoked with no arguments, it applies all + directives from all configuration files. If one or + 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.d5 - for more details on these files. - - If invoked with no arguments applies all - directives from all configuration files in - /etc/tmpfiles.d/*.conf. If one or - more absolute file names are passed on the command - line only the directives in these files are - applied. + are searched for a matching file. @@ -78,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 - 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. @@ -100,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 @@ -133,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. @@ -144,8 +208,7 @@ See Also systemd1, - tmpfiles.d5, - tmpwatch8 + tmpfiles.d5