X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_print.xml;h=055094c9a2d8070ba2d6e69195e644e45fc1ea62;hb=0fa9e53d12a64981e071e0adb24698f4735e2599;hp=7b08733171751262f71ef5f740f4f174c4cf192a;hpb=38180c856898d352fca38ce85d55f2d89cf8be97;p=elogind.git
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index 7b0873317..055094c9a 100644
--- a/man/sd_journal_print.xml
+++ b/man/sd_journal_print.xml
@@ -59,20 +59,20 @@
int sd_journal_print
int priority
- const char* format
+ const char *format
...
int sd_journal_printv
int priority
- const char* format
+ const char *format
va_list ap
int sd_journal_send
- const char* format
+ const char *format
...
@@ -84,7 +84,7 @@
int sd_journal_perror
- const char* message
+ const char *message
@@ -98,9 +98,9 @@
system journal. The first argument is a priority
value. This is followed by a format string and its
parameters, similar to
- printf3
+ printf3
or
- syslog3. The
+ syslog3. The
priority value is one of
LOG_EMERG,
LOG_ALERT,
@@ -111,7 +111,7 @@
LOG_INFO,
LOG_DEBUG, as defined in
syslog.h, see
- syslog3
+ syslog3
for details. It is recommended to use this call to
submit log messages in the application locale or system
locale and in UTF-8 format, but no such restrictions
@@ -165,7 +165,7 @@
the passed string, suffixed with ": " and a human
readable representation of the current error code
stored in
- errno3. If
+ 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
@@ -193,7 +193,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
SD_JOURNAL_SUPPRESS_LOCATION before including
sd-journal.h.
- syslog3
+ syslog3
and sd_journal_print() may
largely be used interchangeably
functionality-wise. However, note that log messages
@@ -203,7 +203,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
be guaranteed. Using
sd_journal_print() has the
benefit of logging source code line, filenames, and
- functions as meta data along all entries, and
+ functions as metadata along all entries, and
guaranteeing chronological ordering with structured
log entries that are generated via
sd_journal_send(). Using
@@ -216,8 +216,13 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
The four calls return 0 on success or a negative
errno-style error code. The
- errno3
+ errno3
variable itself is not altered.
+
+ If
+ systemd-journald8
+ is not running (the socket is not present), those
+ functions do nothing, and also return 0.
@@ -242,7 +247,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
sd_journal_sendv() interfaces
are available as a shared library, which can be compiled
and linked to with the
- libsystemd-journal pkg-config1
+ libsystemd pkg-config1
file.
@@ -253,9 +258,9 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
systemd1,
sd-journal3,
sd_journal_stream_fd3,
- syslog3,
+ syslog3,
perror3,
- errno3,
+ errno3,
systemd.journal-fields7,
signal7,
socket7