diff options
| author | Charles (Chas) Williams <ciwillia@vyatta.att-mail.com> | 2019-11-21 10:26:24 -0500 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-12-04 10:58:15 +0100 |
| commit | c0dd3269535b346f7d803d6816631af0784bd5bd (patch) | |
| tree | 427f91fa61aa16c5f9069dfb2902754046e232aa /man/journald.conf.xml | |
| parent | 26601a2a17716ec55ae1e619e5bcfaf460ccf1a2 (diff) | |
| download | systemd-c0dd3269535b346f7d803d6816631af0784bd5bd.tar.gz | |
man: document journal rate limit burst multiplier
The actual burst limit is modified by the remaining disk space. This
isn't mentioned anywhere in the available documentation and might be a
source of surprise for an end user expecting certain behaviors.
Diffstat (limited to 'man/journald.conf.xml')
| -rw-r--r-- | man/journald.conf.xml | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/man/journald.conf.xml b/man/journald.conf.xml index 44fd0d2f3d..6c9268f4dc 100644 --- a/man/journald.conf.xml +++ b/man/journald.conf.xml @@ -139,6 +139,51 @@ <literal>us</literal>. To turn off any kind of rate limiting, set either value to 0.</para> + <para>Note that the effective rate limit is multiplied with a + factor derived from the available free disk space for the journal. + Currently, this factor is calculated using the base 2 logarithm.</para> + + <table> + <title>Example <varname>RateLimitBurst=</varname> rate + modifications by the available disk space</title> + <tgroup cols='2'> + <colspec colname='freespace' /> + <colspec colname='multiplier' /> + <thead> + <row> + <entry>Available Disk Space</entry> + <entry>Burst Multiplier</entry> + </row> + </thead> + <tbody> + <row> + <entry><= 1MB</entry> + <entry>1</entry> + </row> + <row> + <entry><= 16MB</entry> + <entry>2</entry> + </row> + <row> + <entry><= 256MB</entry> + <entry>3</entry> + </row> + <row> + <entry><= 4GB</entry> + <entry>4</entry> + </row> + <row> + <entry><= 64GB</entry> + <entry>5</entry> + </row> + <row> + <entry><= 1TB</entry> + <entry>6</entry> + </row> + </tbody> + </tgroup> + </table> + <para>If a service provides rate limits for itself through <varname>LogRateLimitIntervalSec=</varname> and/or <varname>LogRateLimitBurst=</varname> in <citerefentry><refentrytitle>systemd.exec</refentrytitle><manvolnum>5</manvolnum></citerefentry>, |