X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_journal_print.xml;fp=man%2Fsd_journal_print.xml;h=7eac6c8192567749af637c1d8b5cd3aaedc24daf;hp=dfe99192e7e7a28e5fd7b61532a8d4cd4aabf702;hb=18c7ed186be28800a2eeb37ad31c9c44480d3d9c;hpb=4d9909c93e9c58789c71b34555a1908307c6849e
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index dfe99192e..7eac6c819 100644
--- a/man/sd_journal_print.xml
+++ b/man/sd_journal_print.xml
@@ -47,6 +47,7 @@
sd_journal_printv
sd_journal_send
sd_journal_sendv
+ sd_journal_perror
SD_JOURNAL_SUPPRESS_LOCATION
Submit log entries to the journal
@@ -81,6 +82,11 @@
int n
+
+ int sd_journal_perror
+ const char* message
+
+
@@ -150,6 +156,21 @@
particularly useful to submit binary objects to the
journal where that is necessary.
+ sd_journal_perror() is a
+ similar to
+ perror3
+ and writes a message to the journal that consists of
+ the passed string, suffixed with ": " and a human
+ readable representation of the current error code
+ stored in
+ errno3. If
+ the message string is passed as NULL or empty string
+ only the error string representation will be written,
+ prefixed with nothing. An additional journal field
+ ERRNO= is included in the entry containing the numeric
+ error code formatted as decimal string. The log
+ priority used is LOG_ERR (3).
+
Note that sd_journal_send()
is a wrapper around
sd_journal_sendv() to make it
@@ -191,8 +212,10 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
Return Value
- The four calls return 0 on success or a
- negative errno-style error code.
+ The four calls return 0 on success or a negative
+ errno-style error code. The
+ errno3
+ variable itself is not altered.
@@ -217,6 +240,8 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
sd-journal3,
sd_journal_stream_fd3,
syslog3,
+ perror3,
+ errno3,
systemd.journal-fields7