X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Fsd_journal_print.xml;h=84adab5c7b22bcfb9e66aca34a480ab19be73139;hb=6b222c4b0227f9914446ac54754aea867f742be4;hp=ad9412ed544943c112ce669a2a68b4a583099331;hpb=3a54a157605bd7d4bf1be05e28201f3d9422cecc;p=thirdparty%2Fsystemd.git
diff --git a/man/sd_journal_print.xml b/man/sd_journal_print.xml
index ad9412ed544..84adab5c7b2 100644
--- a/man/sd_journal_print.xml
+++ b/man/sd_journal_print.xml
@@ -22,6 +22,12 @@
sd_journal_sendv
sd_journal_perror
SD_JOURNAL_SUPPRESS_LOCATION
+ sd_journal_print_with_location
+ sd_journal_printv_with_location
+ sd_journal_send_with_location
+ sd_journal_sendv_with_location
+ sd_journal_perror_with_location
+
Submit log entries to the journal
@@ -60,6 +66,51 @@
const char *message
+
+ int sd_journal_print_with_location
+ const char *file
+ const char *line
+ const char *func
+ int priority
+ const char *format
+ â¦
+
+
+
+ int sd_journal_printv_with_location
+ int priority
+ const char *file
+ const char *line
+ const char *func
+ const char *format
+ va_list ap
+
+
+
+ int sd_journal_send_with_location
+ const char *file
+ const char *line
+ const char *func
+ const char *format
+ â¦
+
+
+
+ int sd_journal_sendv_with_location
+ const char *file
+ const char *line
+ const char *func
+ const struct iovec *iov
+ int n
+
+
+
+ int sd_journal_perror_with_location
+ const char *file
+ const char *line
+ const char *func
+ const char *message
+
@@ -70,6 +121,7 @@
journal. The first argument is a priority value. This is followed by a format string and its parameters, similar to
printf3 or
syslog3.
+ Note that currently the resulting message will be truncated to LINE_MAX - 8.
The priority value is one of LOG_EMERG, LOG_ALERT,
LOG_CRIT, LOG_ERR, LOG_WARNING,
LOG_NOTICE, LOG_INFO, LOG_DEBUG, as defined in
@@ -135,11 +187,20 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
"PRIORITY=%i", LOG_INFO,
NULL);
- 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 SD_JOURNAL_SUPPRESS_LOCATION before including
- sd-journal.h.
+ 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
+ SD_JOURNAL_SUPPRESS_LOCATION before including sd-journal.h.
+
+
+ sd_journal_print_with_location,
+ sd_journal_printv_with_location, sd_journal_send_with_location,
+ sd_journal_sendv_with_location, and
+ sd_journal_perror_with_location are similar to their counterparts without
+ _with_location, but accept additional parameters to explicitly set the source file
+ name, function, and line. Those arguments must contain valid journal entries including the variable name,
+ e.g. CODE_FILE=src/foo.c, CODE_LINE=666,
+ CODE_FUNC=myfunc. These variants are primarily useful when writing custom wrappers,
+ for example in bindings for a different language.
syslog3
and sd_journal_print() may
@@ -162,9 +223,9 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
Return Value
- The five calls return 0 on success or a negative errno-style error code. The errno3 variable itself is
- not altered.
+ The ten functions return 0 on success or a negative errno-style error code. The
+ errno3
+ variable itself is not altered.
If
systemd-journald8
@@ -177,15 +238,17 @@ sd_journal_send("MESSAGE=Hello World, this is PID %lu!", (unsigned long) getpid(
- sd_journal_sendv() is "async signal safe" in the meaning of signal-safety7.
+ sd_journal_sendv() and sd_journal_sendv_with_location()
+ are "async signal safe" in the meaning of
+ signal-safety7.
sd_journal_print,
sd_journal_printv,
- sd_journal_send, and
- sd_journal_perror are
- not async signal safe.
+ sd_journal_send,
+ sd_journal_perror,
+ and their counterparts with _with_location
+ are not async signal safe.