diff options
| author | Lennart Poettering <lennart@poettering.net> | 2018-01-23 19:06:21 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2018-01-23 19:06:21 +0100 |
| commit | 5b7e1d8ef0e9b0409c10fbe54d5e12ae8f7735fe (patch) | |
| tree | 15ad5a4829209bc818c134324b396862d4211ebc /man/sd_journal_stream_fd.xml | |
| parent | 8a44b0b849a10e2ae7b2af53964cbfd058552b0f (diff) | |
| download | systemd-5b7e1d8ef0e9b0409c10fbe54d5e12ae8f7735fe.tar.gz | |
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.xml | 4 |
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> |