X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_print.xml;h=7eac6c8192567749af637c1d8b5cd3aaedc24daf;hb=81311bbd124d95b05676c21c98a0350f1db2a547;hp=05c1ebea772fc1cef411a79569f8dfa013bddc71;hpb=976c46f84f896782fa1e839904ab74cc4460c7b0;p=elogind.git
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index 05c1ebea7..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
@@ -172,7 +193,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
syslog3
and and sd_journal_print() may
- largely be used interchangably
+ largely be used interchangeably
functionality-wise. However, note that log messages
logged via the former take a different path to the
journal server than the later, and hence global
@@ -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