summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2018-05-29 11:25:26 +0200
committerLennart Poettering <lennart@poettering.net>2018-05-29 11:39:15 +0200
commitb294e5943f06bc96e2898e769cfe610bbf10b767 (patch)
treee6b7188d1af3b78d88a5ca6d60849cddf7bf5a93 /man
parent709f4c472cd907d0924fdf4982e4a4d49e44ec4d (diff)
downloadsystemd-b294e5943f06bc96e2898e769cfe610bbf10b767.tar.gz
systemd-b294e5943f06bc96e2898e769cfe610bbf10b767.tar.bz2
systemd-b294e5943f06bc96e2898e769cfe610bbf10b767.zip
core: introduce specifiers for /tmp and /var/tmp
This corresponds nicely with the specifiers we already pass for /var/lib, /var/cache, /run and so on. This is particular useful to update the test-path service files to operate without guessable files, thus allowing multiple parallel test-path invocations to pass without issues (the idea is to set $TMPDIR early on in the test to some private directory, and then only use the new %T or %V specifier to refer to it).
Diffstat (limited to 'man')
-rw-r--r--man/systemd.unit.xml10
-rw-r--r--man/tmpfiles.d.xml10
2 files changed, 20 insertions, 0 deletions
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 3d0f0ff87c..b6f4728b00 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -1627,6 +1627,11 @@
<entry>This is either <filename>/run</filename> (for the system manager) or the path <literal>$XDG_RUNTIME_DIR</literal> resolves to (for user managers).</entry>
</row>
<row>
+ <entry><literal>%T</literal></entry>
+ <entry>Directory for temporary files</entry>
+ <entry>This is either <filename>/tmp</filename> or the path <literal>$TMPDIR</literal>, <literal>$TEMP</literal> or <literal>$TMP</literal> are set to.</entry>
+ </row>
+ <row>
<entry><literal>%u</literal></entry>
<entry>User name</entry>
<entry>This is the name of the user running the service manager instance. In case of the system manager this resolves to <literal>root</literal>.</entry>
@@ -1642,6 +1647,11 @@
<entry>Identical to <command>uname -r</command> output</entry>
</row>
<row>
+ <entry><literal>%V</literal></entry>
+ <entry>Directory for larger and persistent temporary files</entry>
+ <entry>This is either <filename>/var/tmp</filename> or the path <literal>$TMPDIR</literal>, <literal>$TEMP</literal> or <literal>$TMP</literal> are set to.</entry>
+ </row>
+ <row>
<entry><literal>%%</literal></entry>
<entry>Single percent sign</entry>
<entry>Use <literal>%%</literal> in place of <literal>%</literal> to specify a single percent sign.</entry>
diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml
index 30809f25f0..46bec912c5 100644
--- a/man/tmpfiles.d.xml
+++ b/man/tmpfiles.d.xml
@@ -652,6 +652,11 @@ r! /tmp/.X[0-9]*-lock</programlisting>
<entry>In --user mode, this is the same <varname>$XDG_RUNTIME_DIR</varname>, and <filename>/run</filename> otherwise.</entry>
</row>
<row>
+ <entry><literal>%T</literal></entry>
+ <entry>Directory for temporary files</entry>
+ <entry>This is either <filename>/tmp</filename> or the path <literal>$TMPDIR</literal>, <literal>$TEMP</literal> or <literal>$TMP</literal> are set to.</entry>
+ </row>
+ <row>
<entry><literal>%u</literal></entry>
<entry>User name</entry>
<entry>This is the name of the user running the service manager instance. In case of the system manager this resolves to <literal>root</literal>.</entry>
@@ -667,6 +672,11 @@ r! /tmp/.X[0-9]*-lock</programlisting>
<entry>Identical to <command>uname -r</command> output.</entry>
</row>
<row>
+ <entry><literal>%V</literal></entry>
+ <entry>Directory for larger and persistent temporary files</entry>
+ <entry>This is either <filename>/var/tmp</filename> or the path <literal>$TMPDIR</literal>, <literal>$TEMP</literal> or <literal>$TMP</literal> are set to.</entry>
+ </row>
+ <row>
<entry><literal>%%</literal></entry>
<entry>Escaped <literal>%</literal></entry>
<entry>Single percent sign.</entry>