summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2021-02-28 18:08:53 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2021-03-01 13:40:52 +0100
commit36f57e02d768d006c7b610e1f99cda87e115f6a8 (patch)
tree402bd4886ad6b18268a087db8edb8b2a0243091a
parent5929b6b52281c9c89d62fba525cda54b8958625d (diff)
downloadsystemd-36f57e02d768d006c7b610e1f99cda87e115f6a8.tar.gz
man: explain how to invoke tmpfiles for debugging
Fixes #11914.
-rw-r--r--TODO1
-rw-r--r--man/systemd-tmpfiles.xml21
2 files changed, 22 insertions, 0 deletions
diff --git a/TODO b/TODO
index f82ca75231..926c3c8ae7 100644
--- a/TODO
+++ b/TODO
@@ -1272,6 +1272,7 @@ Features:
- creating new directories/subvolumes/fifos/device nodes
should not follow symlinks. None of the other adjustment or creation
calls follow symlinks.
+ - add --test mode
* make sure systemd-ask-password-wall does not shutdown systemd-ask-password-console too early
diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index 90c2626685..bd93474d40 100644
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -81,6 +81,9 @@
system instance, such as the one typically configured for <filename>/tmp/</filename>, will thus also
affect files created by the user instance if they are placed in <filename>/tmp/</filename>, even if the
user instance's time-based cleanup is turned off.</para>
+
+ <para>To debug <command>systemd-tmpfiles</command>, it may be useful to invoke it directly from the
+ command line with increased log level (see <varname>$SYSTEMD_LOG_LEVEL</varname> below).</para>
</refsect1>
<refsect1>
@@ -228,6 +231,24 @@
</refsect1>
<refsect1>
+ <title>Environment</title>
+
+ <variablelist class='environment-variables'>
+ <xi:include href="common-variables.xml" xpointer="log-level" />
+ <xi:include href="common-variables.xml" xpointer="log-color" />
+ <xi:include href="common-variables.xml" xpointer="log-time" />
+ <xi:include href="common-variables.xml" xpointer="log-location" />
+ <xi:include href="common-variables.xml" xpointer="log-target" />
+ <xi:include href="common-variables.xml" xpointer="pager" />
+ <xi:include href="common-variables.xml" xpointer="less" />
+ <xi:include href="common-variables.xml" xpointer="lesscharset" />
+ <xi:include href="common-variables.xml" xpointer="lesssecure" />
+ <xi:include href="common-variables.xml" xpointer="colors" />
+ <xi:include href="common-variables.xml" xpointer="urlify" />
+ </variablelist>
+ </refsect1>
+
+ <refsect1>
<title>Unprivileged --cleanup operation</title>
<para><command>systemd-tmpfiles</command> tries to avoid changing