summaryrefslogtreecommitdiff
path: root/man/systemd.exec.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2023-01-06 11:00:48 +0100
committerDaan De Meyer <daan.j.demeyer@gmail.com>2023-01-06 14:13:09 +0100
commit578033356d10f135a1fd146c929d68f41c658378 (patch)
tree828405aa6ac03455fb67cae88bbd7723a8723fde /man/systemd.exec.xml
parente0ff0ee8f9c1aaa642ca90e74ebda795ea265e8b (diff)
downloadsystemd-578033356d10f135a1fd146c929d68f41c658378.tar.gz
man: document explicitly that LogRateLimit= has no effect on StandardOutput=file:…
Fixes: #25951
Diffstat (limited to 'man/systemd.exec.xml')
-rw-r--r--man/systemd.exec.xml25
1 files changed, 15 insertions, 10 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 78cede439c..567a0fad32 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -2909,16 +2909,21 @@ StandardInputData=V2XigLJyZSBubyBzdHJhbmdlcnMgdG8gbG92ZQpZb3Uga25vdyB0aGUgcnVsZX
<term><varname>LogRateLimitIntervalSec=</varname></term>
<term><varname>LogRateLimitBurst=</varname></term>
- <listitem><para>Configures the rate limiting that is applied to messages generated by this unit. If, in the
- time interval defined by <varname>LogRateLimitIntervalSec=</varname>, more messages than specified in
- <varname>LogRateLimitBurst=</varname> are logged by a service, all further messages within the interval are
- dropped until the interval is over. A message about the number of dropped messages is generated. The time
- specification for <varname>LogRateLimitIntervalSec=</varname> may be specified in the following units: "s",
- "min", "h", "ms", "us" (see
- <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> for details).
- The default settings are set by <varname>RateLimitIntervalSec=</varname> and <varname>RateLimitBurst=</varname>
- configured in <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
- </para></listitem>
+ <listitem><para>Configures the rate limiting that is applied to log messages generated by this
+ unit. If, in the time interval defined by <varname>LogRateLimitIntervalSec=</varname>, more messages
+ than specified in <varname>LogRateLimitBurst=</varname> are logged by a service, all further messages
+ within the interval are dropped until the interval is over. A message about the number of dropped
+ messages is generated. The time specification for <varname>LogRateLimitIntervalSec=</varname> may be
+ specified in the following units: "s", "min", "h", "ms", "us" (see
+ <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> for
+ details). The default settings are set by <varname>RateLimitIntervalSec=</varname> and
+ <varname>RateLimitBurst=</varname> configured in
+ <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>. Note
+ that this only applies to log messages that are processed by the logging subsystem, i.e. by
+ <filename>systemd-journald.service</filename>. This means, if you connect a service's stderr directly
+ to a file via <varname>StandardOutput=file:…</varname> or a similar setting the rate limiting will
+ not be applied to messages written that way (but they will be enforced for messages generated via
+ <function>syslog()</function> or similar).</para></listitem>
</varlistentry>
<varlistentry>