From 5b7e1d8ef0e9b0409c10fbe54d5e12ae8f7735fe Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 23 Jan 2018 19:06:21 +0100
Subject: [PATCH] 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.
---
 man/sd_journal_stream_fd.xml | 4 ++++
 1 file changed, 4 insertions(+)

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>