mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-24 08:45:13 +00:00
88e937d0f9
Changed from 20. December to 19. December for easier comprehension (viewing the calendar.) The missing 'd' at 20. December is hardly noticeable compared to e.g. the 19. December.
93 lines
3.6 KiB
Text
93 lines
3.6 KiB
Text
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".
|