X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;ds=inline;f=dss.ggo;h=8f1ec5cf8d3ce50194a81f569b8195eb6562a618;hb=c279f1a5bd474f002f8486aafbfd0b7f0d4e15c3;hp=23f268580313a6d3437ef75f1ab8a4cf9fa6c839;hpb=04bcb8e95d4afd843bcbb98cb01eb6c19a990446;p=dss.git diff --git a/dss.ggo b/dss.ggo index 23f2685..8f1ec5c 100644 --- a/dss.ggo +++ b/dss.ggo @@ -77,9 +77,10 @@ option "logfile" - "Logfile for the dss daemon process" string typestr="filename" optional -details=" - This option is mostly useful for the run command if --daemon - is also given. +details = " + This option is only honored if both --run and --daemon are + given. Otherwise it is silently ignored and log output is + written to stderr. " ################## @@ -110,11 +111,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 @@ -188,6 +195,21 @@ details=" dss. " +option "no-resume" - +#~~~~~~~~~~~~~~~~~~~ +"Do not try to resume from previous runs" +flag off +details = " + Starting from version 0.1.4, dss tries to resume from a + previously cancelled dss instance by default. It does so by + looking at the status of the most recently created snapshot. If + this snapshot status is incomplete, its directory is reused + as the destination directory for a subsequent rsync run. + + The --no-resume option deactivates this feature so that a new + directory is always used as the rsync destination directory. +" + option "rsync-option" O #~~~~~~~~~~~~~~~~~~~~~~ "Further rsync options" @@ -247,6 +269,7 @@ option "pre-create-hook" r #~~~~~~~~~~~~~~~~~~~~~~~~~~ "Executed before snapshot creation" string typestr="command" +default = "/bin/true" optional details=" Execute this command before trying to create a new snapshot. @@ -265,6 +288,7 @@ option "post-create-hook" o #~~~~~~~~~~~~~~~~~~~~~~~~~~ "Executed after snapshot creation" string typestr="command" +default = "/bin/true" optional details=" Execute this after a snapshot has successfully been @@ -281,6 +305,7 @@ option "pre-remove-hook" - #~~~~~~~~~~~~~~~~~~~~~~~~~~ "Executed before snapshot removal" string typestr="command" +default = "/bin/true" optional details=" Execute this command before removing a snapshot. The full @@ -302,6 +327,7 @@ option "post-remove-hook" - #~~~~~~~~~~~~~~~~~~~~~~~~~~ "Executed after snapshot removal" string typestr="command" +default = "/bin/true" optional details=" Execute this after a snapshot has successfully been removed. As @@ -314,6 +340,7 @@ option "exit-hook" e #~~~~~~~~~~~~~~~~~~~ "Executed if run command exits" string typestr="command" +default = "/bin/true" optional details=" This hook is only used if the --run command was given which