diff options
author | Anatoli Babenia <anatoli@rainforce.org> | 2022-10-30 15:06:38 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2023-06-13 16:14:30 +0200 |
commit | 5c193a7c3cba491a530556b7143e3a49ef704847 (patch) | |
tree | 40bdca3e0a37c7abf182985b893fca3bed491433 /man/journalctl.xml | |
parent | Merge pull request #28010 from DaanDeMeyer/vsock-type (diff) | |
download | systemd-5c193a7c3cba491a530556b7143e3a49ef704847.tar.xz systemd-5c193a7c3cba491a530556b7143e3a49ef704847.zip |
man: document "s" is default --vacuum-time= suffix
Diffstat (limited to '')
-rw-r--r-- | man/journalctl.xml | 37 |
1 files changed, 23 insertions, 14 deletions
diff --git a/man/journalctl.xml b/man/journalctl.xml index 969bcaec01..d54937a220 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -742,22 +742,31 @@ <term><option>--vacuum-time=</option></term> <term><option>--vacuum-files=</option></term> - <listitem><para>Removes the oldest archived journal files until the disk space they use falls below - the specified size (specified with the usual <literal>K</literal>, <literal>M</literal>, - <literal>G</literal> and <literal>T</literal> suffixes), or all archived journal files contain no - data older than the specified timespan (specified with the usual <literal>s</literal>, - <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 - number of separate journal files remain. 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> + <listitem><para><option>--vacuum-size=</option> removes the oldest archived journal files until the + disk space they use falls below the specified size. Accepts the usual <literal>K</literal>, + <literal>M</literal>, <literal>G</literal> and <literal>T</literal> suffixes (to the base of + 1024).</para> + + <para><option>--vacuum-time=</option> removes archived journal files older than the specified + timespan. Accepts the usual <literal>s</literal> (default), <literal>m</literal>, + <literal>h</literal>, <literal>days</literal>, <literal>months</literal>, <literal>weeks</literal> + and <literal>years</literal> suffixes, see + <citerefentry><refentrytitle>systemd.time</refentrytitle><manvolnum>7</manvolnum></citerefentry> for + 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 - <option>--vacuum-files=</option> may be combined in a single invocation to enforce any combination - of a size, a time and a 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 + <option>--vacuum-files=</option> may be combined in a single invocation to enforce any combination of + a size, a time and a 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> <para>These three switches may also be combined with <option>--rotate</option> into one command. If |