From 78c09958535e81322d926089515d041985f62b15 Mon Sep 17 00:00:00 2001 From: Alexander Neumann Date: Sun, 21 Aug 2016 11:53:05 +0200 Subject: [PATCH] Improve documentation, add explanation and weekly --- doc/Manual.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/Manual.md b/doc/Manual.md index 684bc454a..3eba6e999 100644 --- a/doc/Manual.md +++ b/doc/Manual.md @@ -464,6 +464,8 @@ The `forget` command accepts the following parameters: only the last snapshot for each hour. * `--keep-daily n` for the last `n` days which have one or more snapshots, only keep the last one for that day. + * `--keep-weekly n` for the last `n` weeks which have one or more snapshots, only + keep the last one for that week. * `--keep-monthly n` for the last `n` months which have one or more snapshots, only keep the last one for that month. * `--keep-yearly n` for the last `n` years which have one or more snapshots, only @@ -472,6 +474,17 @@ The `forget` command accepts the following parameters: Additionally, you can restrict removing snapshots to those which have a particular hostname with the `--hostname` parameter. +All the `--keep-*` options above only count hours/days/weeks/months/years which +have a snapshot, so those without a snapshot are ignored. + +Let's explain this with an example: Suppose you have only made a backup on each +Sunday for 12 weeks. Then `forget --keep-daily 4` will keep the last four snapshots +for the last four Sundays, but remove the rest. Only counting the days which +have a backup and ignore the ones without is a safety feature: it prevents +restic from removing many snapshots when no new ones are created. If it was +implemented otherwise, running `forget --keep-daily 4` on a Friday would remove +all snapshots! + # Debugging restic The program can be built with debug support like this: