mirror of https://github.com/borgbackup/borg.git
94 lines
3.6 KiB
Plaintext
94 lines
3.6 KiB
Plaintext
borg prune visualized
|
|
=====================
|
|
|
|
Assume it is 2016-01-01, today's backup has not yet been made and you have
|
|
created at least one backup on each day in 2015 except on 2015-12-19 (no
|
|
backup made on that day).
|
|
|
|
This is what borg prune --keep-daily 14 --keep-monthly 6 would keep.
|
|
|
|
Backups kept by the --keep-daily rule are marked by a "d" to the right,
|
|
backups kept by the --keep-monthly rule are marked by a "m" to the right.
|
|
|
|
Calendar view
|
|
-------------
|
|
|
|
2015
|
|
January February March
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 1 1
|
|
5 6 7 8 9 10 11 2 3 4 5 6 7 8 2 3 4 5 6 7 8
|
|
12 13 14 15 16 17 18 9 10 11 12 13 14 15 9 10 11 12 13 14 15
|
|
19 20 21 22 23 24 25 16 17 18 19 20 21 22 16 17 18 19 20 21 22
|
|
26 27 28 29 30 31 23 24 25 26 27 28 23 24 25 26 27 28 29
|
|
30 31
|
|
|
|
April May June
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 5 1 2 3 1 2 3 4 5 6 7
|
|
6 7 8 9 10 11 12 4 5 6 7 8 9 10 8 9 10 11 12 13 14
|
|
13 14 15 16 17 18 19 11 12 13 14 15 16 17 15 16 17 18 19 20 21
|
|
20 21 22 23 24 25 26 18 19 20 21 22 23 24 22 23 24 25 26 27 28
|
|
27 28 29 30 25 26 27 28 29 30 31 29 30m
|
|
|
|
|
|
July August September
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 5 1 2 1 2 3 4 5 6
|
|
6 7 8 9 10 11 12 3 4 5 6 7 8 9 7 8 9 10 11 12 13
|
|
13 14 15 16 17 18 19 10 11 12 13 14 15 16 14 15 16 17 18 19 20
|
|
20 21 22 23 24 25 26 17 18 19 20 21 22 23 21 22 23 24 25 26 27
|
|
27 28 29 30 31m 24 25 26 27 28 29 30 28 29 30m
|
|
31m
|
|
|
|
October November December
|
|
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
|
|
1 2 3 4 1 1 2 3 4 5 6
|
|
5 6 7 8 9 10 11 2 3 4 5 6 7 8 7 8 9 10 11 12 13
|
|
12 13 14 15 16 17 18 9 10 11 12 13 14 15 14 15 16 17d18d19 20d
|
|
19 20 21 22 23 24 25 16 17 18 19 20 21 22 21d22d23d24d25d26d27d
|
|
26 27 28 29 30 31m 23 24 25 26 27 28 29 28d29d30d31d
|
|
30m
|
|
|
|
List view
|
|
---------
|
|
|
|
--keep-daily 14 --keep-monthly 6
|
|
-------------------------------------------------
|
|
1. 2015-12-31 (2015-12-31 kept by daily rule)
|
|
2. 2015-12-30 1. 2015-11-30
|
|
3. 2015-12-29 2. 2015-10-31
|
|
4. 2015-12-28 3. 2015-09-30
|
|
5. 2015-12-27 4. 2015-08-31
|
|
6. 2015-12-26 5. 2015-07-31
|
|
7. 2015-12-25 6. 2015-06-30
|
|
8. 2015-12-24
|
|
9. 2015-12-23
|
|
10. 2015-12-22
|
|
11. 2015-12-21
|
|
12. 2015-12-20
|
|
(no backup made on 2015-12-19)
|
|
13. 2015-12-18
|
|
14. 2015-12-17
|
|
|
|
|
|
Notes
|
|
-----
|
|
|
|
2015-12-31 is kept due to the --keep-daily 14 rule (because it is applied
|
|
first), not due to the --keep-monthly rule.
|
|
|
|
Because of that, the --keep-monthly 6 rule keeps Nov, Oct, Sep, Aug, Jul and
|
|
Jun. December is not considered for this rule, because that backup was already
|
|
kept because of the daily rule.
|
|
|
|
2015-12-17 is kept to satisfy the --keep-daily 14 rule - because no backup was
|
|
made on 2015-12-19. If a backup had been made on that day, it would not keep
|
|
the one from 2015-12-17.
|
|
|
|
We did not include yearly, weekly, hourly, minutely or secondly rules to keep
|
|
this example simple. They all work in basically the same way.
|
|
|
|
The weekly rule is easy to understand roughly, but hard to understand in all
|
|
details. If interested, read "ISO 8601:2000 standard week-based year".
|