diff options
| author |   Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2016-10-15 15:24:55 -0400 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2016-10-15 18:38:20 -0400 |
| commit | a8d46a1663c80e96508ed9bbd7c3acd55c5b4252 (patch) | |
| tree | f1f809b82d19995f55519de5ed10cf5c2b26dbdd /man/sd-journal.xml | |
| parent | man: add crosslink between systemd.resource-control(5) and systemd.exec(5) (diff) | |
| download | systemd-a8d46a1663c80e96508ed9bbd7c3acd55c5b4252.tar.gz systemd-a8d46a1663c80e96508ed9bbd7c3acd55c5b4252.tar.bz2 systemd-a8d46a1663c80e96508ed9bbd7c3acd55c5b4252.zip | |
man: add notes about thread safety of sd_journal_* functions
Fixes #4056.
Diffstat (limited to 'man/sd-journal.xml')
| -rw-r--r-- | man/sd-journal.xml | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/man/sd-journal.xml b/man/sd-journal.xml index 936a83acf..0f4b3e8ee 100644 --- a/man/sd-journal.xml +++ b/man/sd-journal.xml @@ -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> |