2016-07-05 21:30:08 +00:00
.. IMPORTANT : this file is auto - generated from borg ' s built - in help , do not edit !
2015-11-13 15:42:16 +00:00
.. _borg_prune :
borg prune
----------
2017-06-06 22:44:53 +00:00
.. code - block :: none
2015-11-13 15:42:16 +00:00
2017-06-06 22:44:53 +00:00
borg [ common options ] prune [ options ] REPOSITORY
2016-04-09 23:28:18 +00:00
2017-06-20 13:22:24 +00:00
.. only :: html
2017-06-20 09:49:26 +00:00
2017-06-20 13:22:24 +00:00
.. class :: borg - options - table
2016-04-09 23:28:18 +00:00
2017-06-20 13:22:24 +00:00
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| ** positional arguments ** |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` REPOSITORY `` | repository to prune |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| ** optional arguments ** |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - n `` , `` -- dry - run `` | do not change repository |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` -- force `` | force pruning of corrupted archives |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - s `` , `` -- stats `` | print statistics for the deleted archive |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` -- list `` | output verbose list of archives it keeps / prunes |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` -- keep - within WITHIN `` | keep all archives within this time interval |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` -- keep - last `` , `` -- keep - secondly `` | number of secondly archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` -- keep - minutely `` | number of minutely archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - H `` , `` -- keep - hourly `` | number of hourly archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - d `` , `` -- keep - daily `` | number of daily archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - w `` , `` -- keep - weekly `` | number of weekly archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - m `` , `` -- keep - monthly `` | number of monthly archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - y `` , `` -- keep - yearly `` | number of yearly archives to keep |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` -- save - space `` | work slower , but using less space |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| .. class :: borg - common - opt - ref |
| |
| : ref : `common_options` |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| ** filters ** |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - P `` , `` -- prefix `` | only consider archive names starting with this prefix . |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| | `` - a `` , `` -- glob - archives `` | only consider archive names matching the glob . sh : rules apply , see " borg help patterns " . `` -- prefix `` and `` -- glob - archives `` are mutually exclusive . |
+-------------------------------------------------------+--------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
2017-06-20 09:49:26 +00:00
2017-06-20 13:22:24 +00:00
.. raw :: html
2016-04-09 23:28:18 +00:00
2017-06-20 13:22:24 +00:00
< script type = 'text/javascript' >
$ ( window ) . load ( function () {
$ ( '.borg-options-table colgroup' ) . remove ();
})
</ script >
2017-06-20 09:53:36 +00:00
2017-06-20 13:22:24 +00:00
.. only :: latex
2017-06-20 09:53:36 +00:00
2017-06-20 13:22:24 +00:00
REPOSITORY
repository to prune
2016-04-09 23:28:18 +00:00
2017-06-20 13:22:24 +00:00
optional arguments
- n , -- dry - run do not change repository
-- force force pruning of corrupted archives
- s , -- stats print statistics for the deleted archive
-- list output verbose list of archives it keeps / prunes
-- keep - within WITHIN keep all archives within this time interval
-- keep - last , -- keep - secondly number of secondly archives to keep
-- keep - minutely number of minutely archives to keep
- H , -- keep - hourly number of hourly archives to keep
- d , -- keep - daily number of daily archives to keep
- w , -- keep - weekly number of weekly archives to keep
- m , -- keep - monthly number of monthly archives to keep
- y , -- keep - yearly number of yearly archives to keep
-- save - space work slower , but using less space
: ref : `common_options`
|
filters
- P , -- prefix only consider archive names starting with this prefix .
- a , -- glob - archives only consider archive names matching the glob . sh : rules apply , see " borg help patterns " . `` -- prefix `` and `` -- glob - archives `` are mutually exclusive .
2017-06-20 09:49:26 +00:00
2017-06-17 10:28:42 +00:00
2015-11-13 15:42:16 +00:00
Description
~~~~~~~~~~~
2016-07-03 14:27:02 +00:00
The prune command prunes a repository by deleting all archives not matching
2015-11-13 15:42:16 +00:00
any of the specified retention options . This command is normally used by
automated backup scripts wanting to keep a certain number of historic backups .
2016-07-05 23:33:53 +00:00
Also , prune automatically removes checkpoint archives ( incomplete archives left
behind by interrupted backup runs ) except if the checkpoint is the latest
archive ( and thus still needed ) . Checkpoint archives are not considered when
2017-06-17 10:28:42 +00:00
comparing archive counts against the retention limits ( `` -- keep - X `` ) .
2016-07-05 23:33:53 +00:00
If a prefix is set with - P , then only archives that start with the prefix are
considered for deletion and only those archives count towards the totals
specified by the rules .
Otherwise , * all * archives in the repository are candidates for deletion !
2016-11-28 01:25:56 +00:00
There is no automatic distinction between archives representing different
contents . These need to be distinguished by specifying matching prefixes .
2016-07-05 23:33:53 +00:00
If you have multiple sequences of archives with different data sets ( e . g .
from different machines ) in one shared repository , use one prune call per
data set that matches only the respective archives using the - P option .
2015-11-13 15:42:16 +00:00
2017-06-17 10:28:42 +00:00
The `` -- keep - within `` option takes an argument of the form " <int><char> " ,
where char is " H " , " d " , " w " , " m " , " y " . For example , `` -- keep - within 2 d `` means
2015-11-13 15:42:16 +00:00
to keep all archives that were created within the past 48 hours .
" 1m " is taken to mean " 31d " . The archives kept with this option do not
count towards the totals specified by any other options .
2016-07-05 23:33:53 +00:00
A good procedure is to thin out more and more the older your backups get .
2017-06-17 10:28:42 +00:00
As an example , `` -- keep - daily 7 `` means to keep the latest backup on each day ,
2016-07-05 23:33:53 +00:00
up to 7 most recent days with backups ( days without backups do not count ) .
The rules are applied from secondly to yearly , and backups selected by previous
rules do not count towards those of later rules . The time that each backup
starts is used for pruning purposes . Dates and times are interpreted in
the local timezone , and weeks go from Monday to Sunday . Specifying a
negative number of archives to keep means that there is no limit .
2017-06-17 10:28:42 +00:00
The `` -- keep - last N `` option is doing the same as `` -- keep - secondly N `` ( and it will
2016-07-05 23:33:53 +00:00
keep the last N archives under the assumption that you do not create more than one
2017-03-26 23:45:45 +00:00
backup archive in the same second ) .