sd_journal_get_catalog (3) - Linux Manuals
sd_journal_get_catalog: Retrieve message catalog entry
NAME
sd_journal_get_catalog, sd_journal_get_catalog_for_message_id - Retrieve message catalog entry
SYNOPSIS
#include <systemd/sd-journal.h>
-
int sd_journal_get_catalog(sd_journal
* j, char** ret);- int sd_journal_get_catalog_for_message_id(sd_id128_t
id, char ** ret); - int sd_journal_get_catalog_for_message_id(sd_id128_t
DESCRIPTION
sd_journal_get_catalog()
sd_journal_get_catalog_for_message_id() works similar to sd_journal_get_catalog() but the entry is looked up by the specified message ID (no open journal context is necessary for this), and no field substitution is performed.
For more information about the journal message catalog please refer to the m[blue]Journal Message Catalogsm[][1] documentation page.
RETURN VALUE
sd_journal_get_catalog() and sd_journal_get_catalog_for_message_id() return 0 on success or a negative errno-style error code. If no matching message catalog entry is found, -ENOENT is returned.
On successful return, ret points to a new string, which must be freed with free(3).
NOTES
The
sd_journal_get_catalog()
and
sd_journal_get_catalog_for_message_id()
interfaces are available as a shared library, which can be compiled and linked to with the
libsystemd
systemd(1),
systemd.journal-fields(7),
sd-journal(3),
sd_journal_open(3),
sd_journal_next(3),
sd_journal_get_data(3),
malloc(3)
NOTES
SEE ALSO