summaryrefslogtreecommitdiffstats
path: root/upstream/archlinux/man3/sd_journal_seek_head.3
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 10:52:33 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 10:52:33 +0000
commit2c3307fb903f427be3d021c5780b75cac9af2ce8 (patch)
tree65cf431f40b7481d81ae2dfce9576342686448f7 /upstream/archlinux/man3/sd_journal_seek_head.3
parentReleasing progress-linux version 4.22.0-1~progress7.99u1. (diff)
downloadmanpages-l10n-2c3307fb903f427be3d021c5780b75cac9af2ce8.tar.xz
manpages-l10n-2c3307fb903f427be3d021c5780b75cac9af2ce8.zip
Merging upstream version 4.23.0.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/archlinux/man3/sd_journal_seek_head.3')
-rw-r--r--upstream/archlinux/man3/sd_journal_seek_head.39
1 files changed, 7 insertions, 2 deletions
diff --git a/upstream/archlinux/man3/sd_journal_seek_head.3 b/upstream/archlinux/man3/sd_journal_seek_head.3
index 08c83b87..90958be7 100644
--- a/upstream/archlinux/man3/sd_journal_seek_head.3
+++ b/upstream/archlinux/man3/sd_journal_seek_head.3
@@ -57,8 +57,7 @@ seeks to a position with the specified realtime (wallclock) timestamp, i\&.e\&.
.PP
\fBsd_journal_seek_cursor()\fR
seeks to the position at the specified cursor string\&. For details on cursors, see
-\fBsd_journal_get_cursor\fR(3)\&. 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
-\fBsd_journal_test_cursor\fR(3)\&.
+\fBsd_journal_get_cursor\fR(3)\&. If no entry matching the specified cursor is found the call will seek to the next closest entry (in terms of time) instead\&.
.PP
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
\fBsd_journal_next\fR(3)
@@ -70,6 +69,12 @@ or an entry cursor be retrieved via
is used, the closest following entry will be sought to, if
\fBsd_journal_previous\fR(3)
is used the closest preceding entry is sought to\&.
+.PP
+After the seek is done, and
+\fBsd_journal_next\fR(3)
+or a similar call has been made,
+\fBsd_journal_test_cursor\fR(3)
+may be used to verify whether the newly selected entry actually matches the cursor\&.
.SH "RETURN VALUE"
.PP
The functions return 0 on success or a negative errno\-style error code\&.