From: Lucas Werkmeister <mail@lucaswerkmeister.de>
Date: Fri, 15 Jan 2021 19:10:51 +0000 (+0100)
Subject: man: document that truncate:file happens per command line
X-Git-Tag: v248-rc1~305^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d15b1a6c225b40894953cde308b347cf99605f5f;p=thirdparty%2Fsystemd.git

man: document that truncate:file happens per command line
---

diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 7328f9b9659..a3c641e1165 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -2425,8 +2425,12 @@ SystemCallErrorNumber=EPERM</programlisting>
         </para>
 
         <para><option>truncate:<replaceable>path</replaceable></option> is similar to
-        <option>file:<replaceable>path</replaceable></option> above, but it truncates the file when opening it.
-        </para>
+        <option>file:<replaceable>path</replaceable></option> above, but it truncates the file when opening
+        it. For units with multiple command lines, e.g. <varname>Type=oneshot</varname> services with
+        multiple <varname>ExecStart=</varname>, or services with <varname>ExecCondition=</varname>,
+        <varname>ExecStartPre=</varname> or <varname>ExecStartPost=</varname>, the output file is reopened
+        and therefore re-truncated for each command line. Any <varname>ExecReload=</varname> will likewise
+        truncate the file when run.</para>
 
         <para><option>socket</option> connects standard output to a socket acquired via socket activation. The
         semantics are similar to the same option of <varname>StandardInput=</varname>, see above.</para>