From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Mon, 10 Jun 2013 14:22:08 +0000 (-0400)
Subject: man: add note that sd_journal_open_files is racy
X-Git-Tag: v205~134
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=7699b6eb9859ef7fecb1a0e2e156d65ed7d86b2a

man: add note that sd_journal_open_files is racy
---

diff --git a/man/sd_journal_open.xml b/man/sd_journal_open.xml
index 4ac94c4ce..182840e1d 100644
--- a/man/sd_journal_open.xml
+++ b/man/sd_journal_open.xml
@@ -125,7 +125,11 @@
                 of file paths to open. All files will be opened and
                 interleaved automatically. This call also takes a
                 flags argument, but it must be passed as 0 as no flags
-                are currently understood for this call.</para>
+                are currently understood for this call. Please note
+                that in case of a live journal, this function is only
+                useful for debugging, because individual journal files
+                can be rotated at any moment, and the opening of
+                specific files in inherently racy.</para>
 
                 <para><function>sd_journal_close()</function> will
                 close the journal context allocated with