From: Luca Boccassi <bluca@debian.org>
Date: Sun, 31 Mar 2024 13:22:54 +0000 (+0100)
Subject: man: document that using sd_journal APIs might cause dlopen to happen
X-Git-Tag: v256-rc1~340^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5aa818039230a08e0af1c6351de4794de8ebb778;p=thirdparty%2Fsystemd.git

man: document that using sd_journal APIs might cause dlopen to happen
---

diff --git a/man/sd-journal.xml b/man/sd-journal.xml
index d143cb4a0f7..5908f98e68a 100644
--- a/man/sd-journal.xml
+++ b/man/sd-journal.xml
@@ -86,6 +86,17 @@
     — are fully thread-safe and may be called from multiple threads in parallel.</para>
   </refsect1>
 
+  <refsect1>
+    <title>Optional dependencies</title>
+
+    <para>Depending on which build-time options are enabled, functions that operate on
+    <structname>sd_journal</structname> objects might cause optional shared libraries to be dynamically
+    loaded via
+    <citerefentry project='man7'><refentrytitle>dlopen</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
+    such as decompression libraries (xz, lz4, zstd) or cryptographic libraries (gcrypt).
+    </para>
+  </refsect1>
+
   <xi:include href="libsystemd-pkgconfig.xml" />
 
   <refsect1>