man: add notes about thread safety of sd_journal_* functions

Fixes #4056.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek
2016-10-15 15:24:55 -04:00
parent 74b47bbd5d
commit a8d46a1663
14 changed files with 66 additions and 3 deletions

View File

@@ -98,6 +98,21 @@
tool.</para>
</refsect1>
<refsect1>
<title>Thread safety</title>
<para>Functions that operate on the <structname>sd_journal</structname> object are thread
agnostic — given <structname>sd_journal</structname> pointer may only be used from one thread at
a time, but multiple threads may use multiple such objects safely. Other functions —
those that are used to send entries to the journal, like
<citerefentry><refentrytitle>sd_journal_print</refentrytitle><manvolnum>3</manvolnum></citerefentry>
and similar, or those that are used to retrieve global information like
<citerefentry><refentrytitle>sd_journal_stream_fd</refentrytitle><manvolnum>3</manvolnum></citerefentry>
and
<citerefentry><refentrytitle>sd_journal_get_catalog_for_message_id</refentrytitle><manvolnum>3</manvolnum></citerefentry>
— are thread-safe and may be called from multiple threads in parallel.</para>
</refsect1>
<xi:include href="libsystemd-pkgconfig.xml" />
<refsect1>