X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-tmpfiles.xml;h=f4d53b31393238574db0e54d50fed830ffee19e8;hb=fc07d5d3a982e59d984d6be54342a18028faf7be;hp=5203b84a9db9450cf31341be6ef3619f1f62b01b;hpb=8f28cbcdfe55bdaaa3e8f9c68f39b1369dd0e5dd;p=elogind.git
diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index 5203b84a9..f4d53b313 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.timerCreates, deletes and cleans up volatile
- and temporary files and directories.
+ and temporary files and directories
- systemd-tmpfiles OPTIONSCONFIGURATION FILE
+ systemd-tmpfiles
+ OPTIONS
+ CONFIGFILE
+
+ systemd-tmpfiles-setup.service
+ systemd-tmpfiles-setup-dev.service
+ systemd-tmpfiles-clean.service
+ systemd-tmpfiles-clean.timerDescriptionsystemd-tmpfiles creates,
- deletes and cleans up volatile ad 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.
-
- 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
@@ -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 Alsosystemd1,
- tmpfiles.d5,
- tmpwatch8
+ tmpfiles.d5