man: add a bit of a warning to systemd-tmpfiles --purge
authorNick Rosbrook <enr0n@ubuntu.com>
Fri, 14 Jun 2024 21:31:22 +0000 (17:31 -0400)
committerLuca Boccassi <luca.boccassi@gmail.com>
Fri, 14 Jun 2024 23:00:53 +0000 (00:00 +0100)
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.

man/systemd-tmpfiles.xml

index 008bff62daad0fcda93fdfeb9402f87f301eaaed..6f3ec66611ff3c9440a173434104ddf5d83d3a3d 100644 (file)
       <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>