X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_print.xml;h=0b78502c5fef33993413ded4bdefa0ccd6ebfb80;hb=c779a44222161155c039a7fd2fd304c006590ac7;hp=e61a648703cdcb1825253f1894ef299d384dfd88;hpb=79640424059328268b9fb6c5fa8eb777b27a177e;p=elogind.git
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index e61a64870..0b78502c5 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
@@ -153,8 +153,8 @@
for details) instead of the format string. Each
structure should reference one field of the entry to
submit. The second argument specifies the number of
- structures in the
- array. sd_journal_sendv() is
+ structures in the array.
+ sd_journal_sendv() is
particularly useful to submit binary objects to the
journal where that is necessary.
@@ -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
@@ -218,6 +218,24 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
errno-style error code. The
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.
+
+
+
+ Async signal safety
+ sd_journal_sendv() is "async signal
+ safe" in the meaning of signal7.
+
+
+ sd_journal_print,
+ sd_journal_printv,
+ sd_journal_send, and
+ sd_journal_perror are
+ not async signal safe.
@@ -227,9 +245,9 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
sd_journal_printv(),
sd_journal_send() and
sd_journal_sendv() interfaces
- are available as shared library, which can be compiled
+ are available as a shared library, which can be compiled
and linked to with the
- libsystemd-journal pkg-config1
+ libsystemd pkg-config1
file.
@@ -243,7 +261,9 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
syslog3,
perror3,
errno3,
- systemd.journal-fields7
+ systemd.journal-fields7,
+ signal7,
+ socket7