X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_get_catalog.xml;h=ecd329f013c723b66e4b7997c0fdba0cca30731d;hb=a42c8b54b1619078c02f5e439bd2564c6d0f901f;hp=fa9bbc9b2d7e2015317636fa65f204b0af14b1c7;hpb=f274ece0f76b5709408821e317e87aef76123db6;p=elogind.git
diff --git a/man/sd_journal_get_catalog.xml b/man/sd_journal_get_catalog.xml
index fa9bbc9b2..ecd329f01 100644
--- a/man/sd_journal_get_catalog.xml
+++ b/man/sd_journal_get_catalog.xml
@@ -55,13 +55,13 @@
int sd_journal_get_catalog
sd_journal* j
- const char** ret
+ 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-journal pkg-config1
file.
@@ -130,6 +134,7 @@
sd_journal_open3,
sd_journal_next3,
sd_journal_get_data3
+ malloc3