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;ds=sidebyside
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.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 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 Alsosystemd1,
- tmpfiles.d5,
+ tmpfiles.d5