From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 7 Jun 2023 14:23:45 +0000 (+0200)
Subject: man: document that journalctl --user requires Storage=persistent
X-Git-Tag: v254-rc1~253^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=cad8fa471b9133f38fbd6ddb6ee143f361525e5d;p=thirdparty%2Fsystemd.git

man: document that journalctl --user requires Storage=persistent

Fixes: #25061
---

diff --git a/man/journalctl.xml b/man/journalctl.xml
index 683cb612498..969bcaec016 100644
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -119,7 +119,11 @@
         </para>
 
         <para>The <option>--user</option> option affects how <option>--unit=</option> arguments are
-        treated. See <option>--unit=</option>.</para></listitem>
+        treated. See <option>--unit=</option>.</para>
+
+        <para>Note that <option>--user</option> only works if persistent logging is enabled, via the
+        <varname>Storage=</varname> setting in
+        <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para></listitem>
       </varlistentry>
 
       <varlistentry>
diff --git a/man/journald.conf.xml b/man/journald.conf.xml
index 50c33e47929..2642872407a 100644
--- a/man/journald.conf.xml
+++ b/man/journald.conf.xml
@@ -95,6 +95,9 @@
         <filename>/var/log/journal/</filename>, as the <filename>systemd-journald@.service</filename> service
         file by default carries <varname>LogsDirectory=</varname>. To turn that off, add a unit file drop-in
         file that sets <varname>LogsDirectory=</varname> to an empty string.</para>
+
+        <para>Note that per-user journal files are not supported unless persistent storage is enabled, thus
+        making <command>journalctl --user</command> unavailable.</para>
         </listitem>
       </varlistentry>