summaryrefslogtreecommitdiffstats
path: root/man/common-variables.xml
diff options
context:
space:
mode:
authorDaan De Meyer <daan.j.demeyer@gmail.com>2024-03-20 09:34:46 +0100
committerDaan De Meyer <daan.j.demeyer@gmail.com>2024-03-22 12:46:32 +0100
commite8815abff6444d1eed0335331447693679990b6c (patch)
tree719ddc4b3d60984e7a0602b29d15dcbbb6e8b0c1 /man/common-variables.xml
parentlog: Make warning messages more consistent (diff)
downloadsystemd-e8815abff6444d1eed0335331447693679990b6c.tar.xz
systemd-e8815abff6444d1eed0335331447693679990b6c.zip
log: Add per target log levels
For CI in mkosi, I want to configure systemd to log at debug level to the journal, but not to the console. While we already have max level settings for journald's forwarding settings, not every log line goes to the journal, specifically during early boot and when units are connected directly to the console (think systemd-firstboot), so let's extend the log level options we already have to allow specifying a comma separated list of values and lets allow prefixing values with the log target they apply to to make this possible.
Diffstat (limited to 'man/common-variables.xml')
-rw-r--r--man/common-variables.xml17
1 files changed, 11 insertions, 6 deletions
diff --git a/man/common-variables.xml b/man/common-variables.xml
index 0113d1b6bb..58a285c833 100644
--- a/man/common-variables.xml
+++ b/man/common-variables.xml
@@ -11,13 +11,18 @@
<term><varname>$SYSTEMD_LOG_LEVEL</varname></term>
<listitem><para id='log-level-body'>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) <constant>emerg</constant>, <constant>alert</constant>, <constant>crit</constant>,
- <constant>err</constant>, <constant>warning</constant>, <constant>notice</constant>,
- <constant>info</constant>, <constant>debug</constant>, or an integer in the range 0…7. See
+ log level, i.e. less important ones, will be suppressed). Takes a comma-separated list of values. A
+ value may be either one of (in order of decreasing importance) <constant>emerg</constant>,
+ <constant>alert</constant>, <constant>crit</constant>, <constant>err</constant>,
+ <constant>warning</constant>, <constant>notice</constant>, <constant>info</constant>,
+ <constant>debug</constant>, or an integer in the range 0…7. See
<citerefentry project='man-pages'><refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum></citerefentry>
- for more information.</para>
- </listitem>
+ for more information. Each value may optionally be prefixed with one of <constant>console</constant>,
+ <constant>syslog</constant>, <constant>kmsg</constant> or <constant>journal</constant> followed by a
+ colon to set the maximum log level for that specific log target (e.g.
+ <constant>SYSTEMD_LOG_LEVEL=debug,console:info</constant> specifies to log at debug level except when
+ logging to the console which should be at info level). Note that the global maximum log level takes
+ priority over any per target maximum log levels.</para></listitem>
</varlistentry>
<varlistentry id='log-color'>