From: Nick Rosbrook <enr0n@ubuntu.com>
Date: Fri, 14 Jun 2024 21:31:22 +0000 (-0400)
Subject: man: add a bit of a warning to systemd-tmpfiles --purge
X-Git-Tag: v256.1~22
X-Git-Url: http://git-history.diyao.me/?a=commitdiff_plain;h=aedeaf745028a463150fd6d2b1aca778797735ac;p=systemd%2F.git

man: add a bit of a warning to systemd-tmpfiles --purge

Mention that by default, /home is managed by tmpfiles.d/home.conf, and
recommend that users run systemd-tmpfiles --dry-run --purge first to
see exactly what will be removed.

(cherry picked from commit 9ebcac3b5125a8b0b11f371731ea167cd4684adc)
---

diff --git a/man/systemd-tmpfiles.xml b/man/systemd-tmpfiles.xml
index 008bff62da..6f3ec66611 100644
--- a/man/systemd-tmpfiles.xml
+++ b/man/systemd-tmpfiles.xml
@@ -150,7 +150,11 @@
       <varlistentry>
         <term><option>--purge</option></term>
         <listitem><para>If this option is passed, all files and directories created by a
-        <filename>tmpfiles.d/</filename> entry will be deleted.</para>
+        <filename>tmpfiles.d/</filename> entry will be deleted. Keep in mind that by default,
+        <filename>/home</filename> is created by <command>systemd-tmpfiles</command>
+        (see <filename>/usr/lib/tmpfiles.d/home.conf</filename>). Therefore it is recommended
+        to first run <command>systemd-tmpfiles --dry-run --purge</command> to be certain which files
+        and directories will be deleted.</para>
 
         <xi:include href="version-info.xml" xpointer="v256"/></listitem>
       </varlistentry>