X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_journal_print.xml;h=c6f204b8c6cf455490c9a501b765cf01ed45dd6d;hb=67608cad2301f9ab5c92336992c176505640f2ba;hp=7292d33456ea049ca2f514b62a7676d737c29b1a;hpb=74d005783e355acc784d123024e33bbb66ef9ef1;p=elogind.git
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index 7292d3345..c6f204b8c 100644
--- a/man/sd_journal_print.xml
+++ b/man/sd_journal_print.xml
@@ -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.
@@ -166,7 +166,7 @@
readable representation of the current error code
stored in
errno3. If
- the message string is passed as NULL or empty string
+ 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
@@ -189,7 +189,7 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
Note that these calls implicitly add fields for
the source file, function name and code line where
invoked. This is implemented with macros. If this is
- not desired it can be turned off by defining
+ not desired, it can be turned off by defining
SD_JOURNAL_SUPPRESS_LOCATION before including
sd-journal.h.
@@ -202,8 +202,8 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
chronological ordering between the two streams cannot
be guaranteed. Using
sd_journal_print() has the
- benefit of logging source code line, file names, and
- functions as meta data along all entries, and
+ benefit of logging source code line, filenames, and
+ functions as metadata along all entries, and
guaranteeing chronological ordering with structured
log entries that are generated via
sd_journal_send(). Using
@@ -220,6 +220,19 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
variable itself is not altered.
+
+ 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.
+
+
Notes
@@ -227,10 +240,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.
@@ -244,7 +256,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