shaba/systemd-stable
1
1
Fork 0
mirror of https://github.com/systemd/systemd-stable.git synced 2025-01-24 02:03:54 +03:00
Code

man: document "s" is default --vacuum-time= suffix

Browse Source 
(cherry picked from commit 5c193a7c3cba491a530556b7143e3a49ef704847)
This commit is contained in:
Anatoli Babenia 2022-10-30 17:06:38 +03:00 committed by Luca Boccassi
parent ce529ddd44
commit 0d82670b1c
1 changed files with 23 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
man/journalctl.xml
View File

@ -736,22 +736,31 @@
<term><option>--vacuum-time=</option></term> <term><option>--vacuum-time=</option></term>
<term><option>--vacuum-files=</option></term> <term><option>--vacuum-files=</option></term>
<listitem><para>Removes the oldest archived journal files until the disk space they use falls below <listitem><para><option>--vacuum-size=</option> removes the oldest archived journal files until the
the specified size (specified with the usual <literal>K</literal>, <literal>M</literal>, disk space they use falls below the specified size. Accepts the usual <literal>K</literal>,
<literal>G</literal> and <literal>T</literal> suffixes), or all archived journal files contain no <literal>M</literal>, <literal>G</literal> and <literal>T</literal> suffixes (to the base of
data older than the specified timespan (specified with the usual <literal>s</literal>, 1024).</para>
<literal>m</literal>, <literal>h</literal>, <literal>days</literal>, <literal>months</literal>,
<literal>weeks</literal> and <literal>years</literal> suffixes), or no more than the specified <para><option>--vacuum-time=</option> removes archived journal files older than the specified
number of separate journal files remain. Note that running <option>--vacuum-size=</option> has only timespan. Accepts the usual <literal>s</literal> (default), <literal>m</literal>,
an indirect effect on the output shown by <option>--disk-usage</option>, as the latter includes <literal>h</literal>, <literal>days</literal>, <literal>months</literal>, <literal>weeks</literal>
active journal files, while the vacuuming operation only operates on archived journal and <literal>years</literal> suffixes, see
files. Similarly, <option>--vacuum-files=</option> might not actually reduce the number of journal <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> for
files to below the specified number, as it will not remove active journal files.</para> details.</para>
<para><option>--vacuum-files=</option> leaves only the specified number of separate journal
files.</para>
<para>Note that running <option>--vacuum-size=</option> has only an indirect effect on the output
shown by <option>--disk-usage</option>, as the latter includes active journal files, while the
vacuuming operation only operates on archived journal files. Similarly,
<option>--vacuum-files=</option> might not actually reduce the number of journal files to below the
specified number, as it will not remove active journal files.</para>
<para><option>--vacuum-size=</option>, <option>--vacuum-time=</option> and <para><option>--vacuum-size=</option>, <option>--vacuum-time=</option> and
<option>--vacuum-files=</option> may be combined in a single invocation to enforce any combination <option>--vacuum-files=</option> may be combined in a single invocation to enforce any combination of
of a size, a time and a number of files limit on the archived journal files. Specifying any of a size, a time and a number of files limit on the archived journal files. Specifying any of these
these three parameters as zero is equivalent to not enforcing the specific limit, and is thus three parameters as zero is equivalent to not enforcing the specific limit, and is thus
redundant.</para> redundant.</para>
<para>These three switches may also be combined with <option>--rotate</option> into one command. If <para>These three switches may also be combined with <option>--rotate</option> into one command. If