X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_seek_head.xml;fp=man%2Fsd_journal_seek_head.xml;h=0000000000000000000000000000000000000000;hb=d3ad6bf3a64b4f13cb9a780c833e763afcff6085;hp=d74c2d5bbc6ea26be066ac3ca591f74469ecc52c;hpb=140b399e33a9995b8bdb7afadf6aa08b632cb91b;p=elogind.git diff --git a/man/sd_journal_seek_head.xml b/man/sd_journal_seek_head.xml deleted file mode 100644 index d74c2d5bb..000000000 --- a/man/sd_journal_seek_head.xml +++ /dev/null @@ -1,172 +0,0 @@ - - - - - - - - - sd_journal_seek_head - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - sd_journal_seek_head - 3 - - - - sd_journal_seek_head - sd_journal_seek_tail - sd_journal_seek_monotonic_usec - sd_journal_seek_realtime_usec - sd_journal_seek_cursor - Seek to a position in the - journal - - - - - #include <systemd/sd-journal.h> - - - int sd_journal_seek_head - sd_journal *j - - - - int sd_journal_seek_tail - sd_journal *j - - - - int sd_journal_seek_monotonic_usec - sd_journal *j - sd_id128_t boot_id - uint64_t usec - - - - int sd_journal_seek_realtime_usec - sd_journal *j - uint64_t usec - - - - int sd_journal_seek_cursor - sd_journal *j - const char *cursor - - - - - - Description - - sd_journal_seek_head() seeks to the - beginning of the journal, i.e. the oldest available entry. - - Similarly, sd_journal_seek_tail() may - be used to seek to the end of the journal, i.e. the most recent - available entry. - - sd_journal_seek_monotonic_usec() seeks - to the entry with the specified monotonic timestamp, i.e. - CLOCK_MONOTONIC. Since monotonic time - restarts on every reboot a boot ID needs to be specified as - well. - - sd_journal_seek_realtime_usec() seeks - to the entry with the specified realtime (wallclock) timestamp, - i.e. CLOCK_REALTIME. Note that the realtime - clock is not necessarily monotonic. If a realtime timestamp is - ambiguous, it is not defined which position is sought to. - - sd_journal_seek_cursor() seeks to the - entry located at the specified cursor string. For details on - cursors, see - sd_journal_get_cursor3. - 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 - sd_journal_test_cursor3. - - 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 - sd_journal_next3 - invocation (or a similar call). Only then, entry data may be - retrieved via - sd_journal_get_data3. - If no entry exists that matches exactly the specified seek - address, the next closest is sought to. If - sd_journal_next3 - is used, the closest following entry will be sought to, if - sd_journal_previous3 - is used the closest preceding entry is sought to. - - - - Return Value - - The functions return 0 on success or a negative errno-style - error code. - - - - Notes - - The sd_journal_seek_head(), - sd_journal_seek_tail(), - sd_journal_seek_monotonic_usec(), - sd_journal_seek_realtime_usec(), - and sd_journal_seek_cursor() - interfaces are available as a shared library, which can - be compiled and linked to with the - libsystemd pkg-config1 - file. - - - - See Also - - - systemd1, - sd-journal3, - sd_journal_open3, - sd_journal_next3, - sd_journal_get_data3, - sd_journal_get_cursor3, - sd_journal_get_realtime_usec3 - - - -