diff --git a/man/journalctl.xml b/man/journalctl.xml index 5102dcdd39..d7e99d4251 100644 --- a/man/journalctl.xml +++ b/man/journalctl.xml @@ -749,32 +749,28 @@ - Removes the oldest archived journal files until the disk - space they use falls below the specified size (specified with - the usual K, M, - G and T suffixes), or all - archived journal files contain no data older than the specified - timespan (specified with the usual s, - m, h, - days, months, - weeks and years suffixes), - or no more than the specified number of separate journal files - remain. Note that running has - only an indirect effect on the output shown by - , as the latter includes active - journal files, while the vacuuming operation only operates - on archived journal files. Similarly, - might not actually reduce the - number of journal files to below the specified number, as it - will not remove active journal - files. , - and - 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. + Removes the oldest archived journal files until the disk space they use falls below the + specified size (specified with the usual K, M, G and + T suffixes), or all archived journal files contain no data older than the specified timespan + (specified with the usual s, m, h, + days, months, weeks and years + suffixes), or no more than the specified number of separate journal files remain. Note that running + has only an indirect effect on the output shown by + , as the latter includes active journal files, while the vacuuming operation only + operates on archived journal files. Similarly, might not actually reduce the + number of journal files to below the specified number, as it will not remove active journal + files. + + , and + 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. + + These three switches may also be combined with into one command. If so, all + active files are rotated first, and the requested vacuuming operation is executed right after. The rotation has + the effect that all currently active files are archived (and potentially new, empty journal files opened as + replacement), and hence the vacuuming operation has the greatest effect as it can take all log data written so + far into account. @@ -896,9 +892,12 @@ - Asks the journal daemon to rotate journal - files. This call does not return until the rotation operation - is complete. + Asks the journal daemon to rotate journal files. This call does not return until the rotation + operation is complete. Journal file rotation has the effect that all currently active journal files are marked + 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 , + and into a single command, see + above.