summaryrefslogtreecommitdiffstats
path: root/man/sd_journal_seek_head.xml
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-30 02:22:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-30 02:22:44 +0000
commitc30e4ee961e72640cc55cbd500475a03308de1b9 (patch)
treec383770976489dbeeef85ef7bc668da64a242b14 /man/sd_journal_seek_head.xml
parentAdding upstream version 252.23. (diff)
downloadsystemd-c30e4ee961e72640cc55cbd500475a03308de1b9.tar.xz
systemd-c30e4ee961e72640cc55cbd500475a03308de1b9.zip
Adding upstream version 252.25.upstream/252.25
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/sd_journal_seek_head.xml')
-rw-r--r--man/sd_journal_seek_head.xml10
1 files changed, 8 insertions, 2 deletions
diff --git a/man/sd_journal_seek_head.xml b/man/sd_journal_seek_head.xml
index 869889a..e95b697 100644
--- a/man/sd_journal_seek_head.xml
+++ b/man/sd_journal_seek_head.xml
@@ -82,8 +82,7 @@
string. For details on cursors, see
<citerefentry><refentrytitle>sd_journal_get_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms
- of time) instead. To verify whether the newly selected entry actually matches the cursor, use
- <citerefentry><refentrytitle>sd_journal_test_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
+ of time) instead.</para>
<para>Note that these calls do not actually make any entry the new current entry, this needs to be done
in a separate step with a subsequent
@@ -97,6 +96,13 @@
used, the closest following entry will be sought to, if
<citerefentry><refentrytitle>sd_journal_previous</refentrytitle><manvolnum>3</manvolnum></citerefentry>
is used the closest preceding entry is sought to.</para>
+
+ <para>After the seek is done, and
+ <citerefentry><refentrytitle>sd_journal_next</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+ or a similar call has been made,
+ <citerefentry><refentrytitle>sd_journal_test_cursor</refentrytitle><manvolnum>3</manvolnum></citerefentry>
+ may be used to verify whether the newly selected entry actually matches the cursor.
+ </para>
</refsect1>
<refsect1>