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=71551f779a04843620e5bd307dffe5e360b39f17;hpb=cb07866b1b7c11e687a322d70dd9f9d73bbbe488;p=elogind.git
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index 71551f779..7eac6c819 100644
--- a/man/sd_journal_print.xml
+++ b/man/sd_journal_print.xml
@@ -47,6 +47,8 @@
sd_journal_printv
sd_journal_send
sd_journal_sendv
+ sd_journal_perror
+ SD_JOURNAL_SUPPRESS_LOCATION
Submit log entries to the journal
@@ -80,6 +82,11 @@
int n
+
+ int sd_journal_perror
+ const char* message
+
+
@@ -122,7 +129,7 @@
used to submit structured log entries to the system
journal. It takes a series of format strings, each
immediately followed by their associated parameters,
- terminated by a NULL. The strings passed should be of
+ terminated by NULL. The strings passed should be of
the format VARIABLE=value. The
variable name must be in uppercase and consist only
of characters, numbers and underscores, and may not
@@ -149,8 +156,23 @@
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 wapper around
+ is a wrapper around
sd_journal_sendv() to make it
easier to use when only text strings shall be
submitted. Also, the following two calls are
@@ -171,7 +193,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
syslog3
and and sd_journal_print() may
- mostly 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
@@ -190,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.
@@ -216,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