summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2013-06-10 10:22:08 -0400
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2013-06-10 10:22:08 -0400
commit7699b6eb9859ef7fecb1a0e2e156d65ed7d86b2a (patch)
treee91fb6b70248516a2da089f739c231b6120dd7b9
parentcbd671772c9ce053a7050ddd29de170eb9efac7e (diff)
man: add note that sd_journal_open_files is racy
-rw-r--r--man/sd_journal_open.xml6
1 files changed, 5 insertions, 1 deletions
diff --git a/man/sd_journal_open.xml b/man/sd_journal_open.xml
index 4ac94c4ce3..182840e1df 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