X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_get_catalog.xml;h=485bbba143e393d7de555e6bb7f0033b3bbcf108;hb=a4390b6be8869172ccdd16fef208803fc6c7a114;hp=fa9bbc9b2d7e2015317636fa65f204b0af14b1c7;hpb=f2cf0403c99e8fa44c14b0ef70af90801f8681f0;p=elogind.git
diff --git a/man/sd_journal_get_catalog.xml b/man/sd_journal_get_catalog.xml
index fa9bbc9b2..485bbba14 100644
--- a/man/sd_journal_get_catalog.xml
+++ b/man/sd_journal_get_catalog.xml
@@ -54,14 +54,14 @@
int sd_journal_get_catalog
- sd_journal* j
- const char** ret
+ sd_journal *j
+ char **ret
int sd_journal_get_catalog_for_message_id
sd_id128_t id
- const char** ret
+ char **ret
@@ -80,8 +80,8 @@
field names in the catalog entry text enclosed in "@"
will be replaced by the respective field values of the
current entry. If a field name referenced in the
- message catalog entry does not exist it the current
- journal entry the "@" will be removed but the field
+ message catalog entry does not exist, in the current
+ journal entry, the "@" will be removed, but the field
name otherwise left untouched.
sd_journal_get_catalog_for_message_id()
@@ -89,7 +89,7 @@
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 done.
+ field substitution is performed.
For more information about the journal message
catalog please refer to the sd_journal_get_catalog()
and
sd_journal_get_catalog_for_message_id()
- returns 0 on success or a negative errno-style error
- code. If no matching message catalog entry is found
+ 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
+ free3.
+
@@ -113,10 +118,9 @@
The sd_journal_get_catalog() and
sd_journal_get_catalog_for_message_id()
- interfaces are available as shared library, which can
+ interfaces are available as a shared library, which can
be compiled and linked to with the
- libsystemd-journal
- pkg-config1
+ libsystemd pkg-config1
file.
@@ -130,6 +134,7 @@
sd_journal_open3,
sd_journal_next3,
sd_journal_get_data3
+ malloc3