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.
This commit is contained in:
Lennart Poettering 2018-01-23 19:06:21 +01:00
parent 8a44b0b849
commit 5b7e1d8ef0
1 changed files with 4 additions and 0 deletions

View File

@ -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>