X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=dss.ggo;h=506fbf105433fed61631ad965e5b8295068cbfe7;hb=1e77c93a4da4dae8b75fcd305552e56ccae89b90;hp=9c687f42d575606cdb852bf7b829e4def7d64edf;hpb=260d141cfa4b0f6368920762fe85093da75e3849;p=dss.git diff --git a/dss.ggo b/dss.ggo index 9c687f4..506fbf1 100644 --- a/dss.ggo +++ b/dss.ggo @@ -1,9 +1,9 @@ -# Copyright (C) 2008 Andre Noll +# Copyright (C) 2008-2009 Andre Noll # # Licensed under the GPL v2. For licencing details see COPYING. package "dss" -version "0.1.2" +version "0.1.3" purpose "the dyadic snapshot scheduler dss creates hardlink-based snapshots of a given directory on a remote @@ -110,11 +110,17 @@ groupoption "prune" P "Remove redundant and outdated snapshots" group="command" details=" - A snapshot is considered outdated if it belongs to an interval - greater than the maximum number of intervals. It is said to be - redundant if it belongs to an interval that already contains - more than the desired number of snapshots. This command gets - rid of such snapshots. + A snapshot is considered outdated if its interval number + is greater or equal than the specified number of unit + intervals. See the \"Intervals\" section below for the precise + definition of these terms. + + A snapshot is said to be redundant if it belongs to an + interval that already contains more than the desired number + of snapshots. + + The prune command gets rid of both outdated and redundant + snapshots. " groupoption "ls" L @@ -283,9 +289,11 @@ option "pre-remove-hook" - string typestr="command" optional details=" - Execute this command before removing a snapshot. If this - command returns with a non-zero exit status, no snapshot is - being removed and the operation is retried later. + Execute this command before removing a snapshot. The full + path to the snapshot about to be deleted is passed to the + command as the first argument. If the command returns with + a non-zero exit status, no snapshot is being removed and the + operation is retried later. For example, one might want to execute a script that checks whether the snapshot to be deleted is currently used by @@ -302,10 +310,10 @@ option "post-remove-hook" - string typestr="command" optional details=" - Execute this after a snapshot has successfully been - removed. The full path of the removed snapshot is - passed to the hook as the first argument. The exit code of - this hook is ignored. + Execute this after a snapshot has successfully been removed. As + for the pre-remove hook, the full path of the removed snapshot + is passed to the hook as the first argument. The exit code + of this hook is ignored. " option "exit-hook" e