picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

man: document the new combined --vacuum*= and --rotate invocation

Browse source
This commit is contained in:
Lennart Poettering 2018-10-25 21:16:38 +02:00
parent e5b2d45c1d
commit f06ba264bc
1 changed files with 28 additions and 29 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
man/journalctl.xml
View file

@ -749,32 +749,28 @@
<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 <listitem><para>Removes the oldest archived journal files until the disk space they use falls below the
space they use falls below the specified size (specified with specified size (specified with the usual <literal>K</literal>, <literal>M</literal>, <literal>G</literal> and
the usual <literal>K</literal>, <literal>M</literal>, <literal>T</literal> suffixes), or all archived journal files contain no data older than the specified timespan
<literal>G</literal> and <literal>T</literal> suffixes), or all (specified with the usual <literal>s</literal>, <literal>m</literal>, <literal>h</literal>,
archived journal files contain no data older than the specified <literal>days</literal>, <literal>months</literal>, <literal>weeks</literal> and <literal>years</literal>
timespan (specified with the usual <literal>s</literal>, suffixes), or no more than the specified number of separate journal files remain. Note that running
<literal>m</literal>, <literal>h</literal>, <option>--vacuum-size=</option> has only an indirect effect on the output shown by
<literal>days</literal>, <literal>months</literal>, <option>--disk-usage</option>, as the latter includes active journal files, while the vacuuming operation only
<literal>weeks</literal> and <literal>years</literal> suffixes), operates on archived journal files. Similarly, <option>--vacuum-files=</option> might not actually reduce the
or no more than the specified number of separate journal files number of journal files to below the specified number, as it will not remove active journal
remain. Note that running <option>--vacuum-size=</option> has files.</para>
only an indirect effect on the output shown by
<option>--disk-usage</option>, as the latter includes active <para><option>--vacuum-size=</option>, <option>--vacuum-time=</option> and <option>--vacuum-files=</option>
journal files, while the vacuuming operation only operates may be combined in a single invocation to enforce any combination of a size, a time and a number of files limit
on archived journal files. Similarly, on the archived journal files. Specifying any of these three parameters as zero is equivalent to not enforcing
<option>--vacuum-files=</option> might not actually reduce the the specific limit, and is thus redundant.</para>
number of journal files to below the specified number, as it
will not remove active journal <para>These three switches may also be combined with <option>--rotate</option> into one command. If so, all
files. <option>--vacuum-size=</option>, active files are rotated first, and the requested vacuuming operation is executed right after. The rotation has
<option>--vacuum-time=</option> and the effect that all currently active files are archived (and potentially new, empty journal files opened as
<option>--vacuum-files=</option> may be combined in a single replacement), and hence the vacuuming operation has the greatest effect as it can take all log data written so
invocation to enforce any combination of a size, a time and a far into account.</para></listitem>
number of files limit on the archived journal
files. Specifying any of these three parameters as zero is
equivalent to not enforcing the specific limit, and is thus
redundant.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -896,9 +892,12 @@
<varlistentry> <varlistentry>
<term><option>--rotate</option></term> <term><option>--rotate</option></term>
<listitem><para>Asks the journal daemon to rotate journal <listitem><para>Asks the journal daemon to rotate journal files. This call does not return until the rotation
files. This call does not return until the rotation operation operation is complete. Journal file rotation has the effect that all currently active journal files are marked
is complete.</para></listitem> as archived and renamed, so that they are never written to in future. New (empty) journal files are then
created in their place. This operation may be combined with <option>--vacuum-size=</option>,
<option>--vacuum-time=</option> and <option>--vacuum-file=</option> into a single command, see
above.</para></listitem>
</varlistentry> </varlistentry>
<xi:include href="standard-options.xml" xpointer="help" /> <xi:include href="standard-options.xml" xpointer="help" />