X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_journal_print.xml;h=638657721f7c0c8a86baccf031bba90921854765;hp=a716cc35e6cf35fb78e46989a84e285f4137d2ff;hb=deb480d1a7c3f3178c44f0aa73765181c0e2317f;hpb=494a66821815e8109afa136bd42818b85da38c09 diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml index a716cc35e..638657721 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. @@ -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 @@ -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 @@ -243,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