X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-tmpfiles.xml;h=f4d53b31393238574db0e54d50fed830ffee19e8;hb=7d328b544621d4b1bec936dec612947ad8bfb65a;hp=0d2d65d593a6fb9f43efa3014b0b601cb6540e80;hpb=195f8e36122b83bbfef27bf63afe888e7101a320;p=elogind.git
diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index 0d2d65d59..f4d53b313 100644
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -21,7 +21,8 @@
along with systemd; If not, see .
-->
-
+systemd-tmpfiles
@@ -54,7 +55,9 @@
- systemd-tmpfiles OPTIONSCONFIGURATION FILE
+ systemd-tmpfiles
+ OPTIONS
+ CONFIGFILEsystemd-tmpfiles-setup.service
@@ -67,22 +70,20 @@
Descriptionsystemd-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.
@@ -91,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.
@@ -113,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
@@ -146,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.
@@ -157,7 +208,7 @@
See Alsosystemd1,
- tmpfiles.d5,
+ tmpfiles.d5