summaryrefslogtreecommitdiffstats
path: root/man/sd_journal_stream_fd.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2018-01-23 19:06:21 +0100
committerLennart Poettering <lennart@poettering.net>2018-01-23 19:06:21 +0100
commit5b7e1d8ef0e9b0409c10fbe54d5e12ae8f7735fe (patch)
tree15ad5a4829209bc818c134324b396862d4211ebc /man/sd_journal_stream_fd.xml
parentMerge pull request #7834 from jkloetzke/disable-watchdog (diff)
downloadsystemd-5b7e1d8ef0e9b0409c10fbe54d5e12ae8f7735fe.tar.xz
systemd-5b7e1d8ef0e9b0409c10fbe54d5e12ae8f7735fe.zip
man: document explicitly that sd_journal_stream_fd() never shares fds
Also, clarify that O_NONBLOCK is turned off and that the fd is only half-open.
Diffstat (limited to 'man/sd_journal_stream_fd.xml')
-rw-r--r--man/sd_journal_stream_fd.xml4
1 files changed, 4 insertions, 0 deletions
diff --git a/man/sd_journal_stream_fd.xml b/man/sd_journal_stream_fd.xml
index b9da483713..abd4a91c15 100644
--- a/man/sd_journal_stream_fd.xml
+++ b/man/sd_journal_stream_fd.xml
@@ -94,6 +94,10 @@
<para>It is recommended that applications log UTF-8 messages only
with this API, but this is not enforced.</para>
+
+ <para>Each invocation of <function>sd_journal_stream_fd()</function> allocates a new log stream file descriptor,
+ that is not shared with prior or later invocations. The file descriptor is write-only (its reading direction is
+ shut down), and <constant>O_NONBLOCK</constant> is turned off initially.</para>
</refsect1>
<refsect1>