summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2021-01-20 22:27:41 +0100
committerLennart Poettering <lennart@poettering.net>2021-01-20 22:39:33 +0100
commit09872a6e1a88d68013653d7299df96d5e542bfe6 (patch)
tree5d2586ec875496c7b6a57afde21a01587b2505cb
parent3bdc25a4cfbb8d58d81d10cf8d4362af12b90c80 (diff)
downloadsystemd-09872a6e1a88d68013653d7299df96d5e542bfe6.tar.gz
man: document how get logging to work in a RootDirectory=/RootImage= environment
Fixes: #18051
-rw-r--r--man/systemd.exec.xml14
1 files changed, 14 insertions, 0 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 663b15fa60..8f00ef555e 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -117,6 +117,20 @@
<para>The <varname>MountAPIVFS=</varname> and <varname>PrivateUsers=</varname> settings are particularly useful
in conjunction with <varname>RootDirectory=</varname>. For details, see below.</para>
+ <para>If <varname>RootDirectory=</varname>/<varname>RootImage=</varname> are used together with
+ <varname>NotifyAccess=</varname> the notification socket is automatically mounted from the host into
+ the root environment, to ensure the notification interface can work correctly.</para>
+
+ <para>Note that services using <varname>RootDirectory=</varname>/<varname>RootImage=</varname> will
+ not be able to log via the syslog or journal protocols to the host logging infrastructure, unless the
+ relevant sockets are mounted from the host, specifically:</para>
+
+ <example>
+ <title>Mounting logging sockets into root environment</title>
+
+ <programlisting>BindReadOnlyPaths=/dev/log /run/systemd/journal/socket /run/systemd/journal/stdout</programlisting>
+ </example>
+
<xi:include href="system-only.xml" xpointer="singular"/></listitem>
</varlistentry>