From b4c87f7d381ad492cd8edfcc550bc85d03cc65ca Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Sun, 28 Feb 2021 13:41:58 +0100 Subject: man: reuse common-variables in systemd(1) This requires a bit of gimnastics, but I think it's still better than status quo ante, and better than duplicating the text. --- man/common-variables.xml | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) (limited to 'man/common-variables.xml') diff --git a/man/common-variables.xml b/man/common-variables.xml index b875e38d39..7798d97714 100644 --- a/man/common-variables.xml +++ b/man/common-variables.xml @@ -10,9 +10,9 @@ $SYSTEMD_LOG_LEVEL - The maximum log level of emitted messages (messages with a higher log level, i.e. less - important ones, will be suppressed). Either one of (in order of decreasing importance) - emerg, alert, crit, + The maximum log level of emitted messages (messages with a higher + log level, i.e. less important ones, will be suppressed). Either one of (in order of decreasing + importance) emerg, alert, crit, err, warning, notice, info, debug, or an integer in the range 0…7. See syslog3 @@ -23,8 +23,8 @@ $SYSTEMD_LOG_COLOR - A boolean. If true, messages written to the tty will be colored according to - priority. + A boolean. If true, messages written to the tty will be colored + according to priority. This setting is only useful when messages are written directly to the terminal, because journalctl1 and @@ -35,7 +35,8 @@ $SYSTEMD_LOG_TIME - A boolean. If true, log messages will be prefixed with a timestamp. + A boolean. If true, log messages will be prefixed with a + timestamp. This setting is only useful when messages are written directly to the terminal or a file, because journalctl1 and @@ -46,8 +47,8 @@ $SYSTEMD_LOG_LOCATION - A boolean. If true, messages will be prefixed with a filename and line number - in the source code where the message originates. + A boolean. If true, messages will be prefixed with a filename + and line number in the source code where the message originates. Note that the log location is often attached as metadata to journal entries anyway. Including it directly in the message text can nevertheless be convenient when debugging programs. @@ -57,8 +58,8 @@ $SYSTEMD_LOG_TID - A boolean. If true, messages will be prefixed with the current numerical thread ID - (TID). + A boolean. If true, messages will be prefixed with the current + numerical thread ID (TID). Note that the this information is attached as metadata to journal entries anyway. Including it directly in the message text can nevertheless be convenient when debugging programs. @@ -68,9 +69,9 @@ $SYSTEMD_LOG_TARGET - The destination for log messages. One of console (log to the - attached tty), console-prefixed (log to the attached tty but with prefixes - encoding the log level and "facility", see The destination for log messages. One of + console (log to the attached tty), console-prefixed (log to + the attached tty but with prefixes encoding the log level and "facility", see syslog3, kmsg (log to the kernel circular log buffer), journal (log to the journal), journal-or-kmsg (log to the journal if available, and to kmsg -- cgit v1.2.1