From 71a4ccea7123faade912eb8ae2f971182364ac72 Mon Sep 17 00:00:00 2001 From: "Leo R. Lundgren" Date: Wed, 14 Feb 2018 00:20:09 +0100 Subject: [PATCH] Document refusal to process empty forget policy. --- doc/060_forget.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/060_forget.rst b/doc/060_forget.rst index 0ca804d81..5e439081f 100644 --- a/doc/060_forget.rst +++ b/doc/060_forget.rst @@ -188,6 +188,12 @@ All the ``--keep-*`` options above only count hours/days/weeks/months/years which have a snapshot, so those without a snapshot are ignored. +For safety reasons, restic refuses to act on an "empty" policy. For example, +if one were to specify ``--keep-last 0`` to forget *all* snapshots in the +repository, restic will respond that no snapshots will be removed. To delete +all snapshots, use ``--keep-last 1`` and then finally remove the last +snapshot ID manually (by passing the ID to ``forget``). + All snapshots are evaluated counted against all matching keep-* counts. A single snapshot on 2017-09-30 (Sun) will count as a daily, weekly and monthly.