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=fab8bcab70c8d8142457b218322f1d56f24cb449;hb=df99a9ef5bb7a89b92ccfb103b2f3e7046c62ef5;hpb=7e2bb92dcae6ee785ff7462aadc8c369fd93715b diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml index fab8bcab7..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,19 +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. + 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. @@ -98,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 @@ -127,14 +180,27 @@ directories are removed and created according to the configuration file: - systemctl-tmpfiles --remove --create + systemd-tmpfiles --remove --create + + 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. @@ -142,8 +208,7 @@ See Also systemd1, - tmpfiles.d5, - tmpwatch8 + tmpfiles.d5