summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man3/sd_journal_seek_head.3
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 10:52:03 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 10:52:03 +0000
commit932e4432596447eb9331cc2a2bb74a26a35b4efc (patch)
tree95161711ea07fd64f0c82d6e7943024c033dd5a8 /upstream/debian-unstable/man3/sd_journal_seek_head.3
parentAdding debian version 4.22.0-1. (diff)
downloadmanpages-l10n-932e4432596447eb9331cc2a2bb74a26a35b4efc.tar.xz
manpages-l10n-932e4432596447eb9331cc2a2bb74a26a35b4efc.zip
Merging upstream version 4.23.0.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/debian-unstable/man3/sd_journal_seek_head.3')
-rw-r--r--upstream/debian-unstable/man3/sd_journal_seek_head.319
1 files changed, 9 insertions, 10 deletions
diff --git a/upstream/debian-unstable/man3/sd_journal_seek_head.3 b/upstream/debian-unstable/man3/sd_journal_seek_head.3
index 08c83b87..c4fe4fc9 100644
--- a/upstream/debian-unstable/man3/sd_journal_seek_head.3
+++ b/upstream/debian-unstable/man3/sd_journal_seek_head.3
@@ -1,5 +1,5 @@
'\" t
-.TH "SD_JOURNAL_SEEK_HEAD" "3" "" "systemd 255" "sd_journal_seek_head"
+.TH "SD_JOURNAL_SEEK_HEAD" "3" "" "systemd 256~rc3" "sd_journal_seek_head"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -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\&.
@@ -90,10 +95,4 @@ file\&.
were added in version 187\&.
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsd-journal\fR(3),
-\fBsd_journal_open\fR(3),
-\fBsd_journal_next\fR(3),
-\fBsd_journal_get_data\fR(3),
-\fBsd_journal_get_cursor\fR(3),
-\fBsd_journal_get_realtime_usec\fR(3)
+\fBsystemd\fR(1), \fBsd-journal\fR(3), \fBsd_journal_open\fR(3), \fBsd_journal_next\fR(3), \fBsd_journal_get_data\fR(3), \fBsd_journal_get_cursor\fR(3), \fBsd_journal_get_realtime_usec\fR(3)