From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Sun, 28 Feb 2021 17:08:53 +0000 (+0100)
Subject: man: explain how to invoke tmpfiles for debugging
X-Git-Tag: v248-rc3~92^2~4
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=36f57e02d768d006c7b610e1f99cda87e115f6a8;p=thirdparty%2Fsystemd.git

man: explain how to invoke tmpfiles for debugging

Fixes #11914.
---

diff --git a/TODO b/TODO
index f82ca75231d..926c3c8ae7f 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 90c2626685e..bd93474d407 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>
@@ -227,6 +230,24 @@
     <programlisting>systemd-tmpfiles --remove --create</programlisting>
   </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>