X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=dss.ggo;h=9587dd24c7b11a439b2c63335ba922361e1cf988;hb=7a76b2d90f4a4908bd4d15adef5b24ee083ab8a2;hp=3a97568b2dab69b89e7ca9e22de4c9710cd7f9af;hpb=4f52e2f2f0387e5b8ee20cc2d93bea61aa144f2d;p=dss.git diff --git a/dss.ggo b/dss.ggo index 3a97568..9587dd2 100644 --- a/dss.ggo +++ b/dss.ggo @@ -1,9 +1,9 @@ -# Copyright (C) 2008-2010 Andre Noll +# Copyright (C) 2008-2010 Andre Noll # # Licensed under the GPL v2. For licencing details see COPYING. package "dss" -version "0.1.4" +version "0.1.5" purpose "the dyadic snapshot scheduler dss creates hardlink-based snapshots of a given directory on a remote @@ -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. " ################## @@ -144,6 +145,25 @@ details=" received. See also the --exit-hook option. " +groupoption "kill" K +#~~~~~~~~~~~~~~~~~~~ +"Kill a running dss process" +group="command" +details=" + This sends SIGTERM to the dss process that corresponds to the + given config file. If --dry-run is given, the PID of the dss + process is written to stdout, but no signal is sent. +" + +groupoption "reload" - +#~~~~~~~~~~~~~~~~~~~~~ +"force a running dss process to reload its config file" +group="command" +details=" + This differs from --kill only in that SIGHUP rather than SIGTERM + is sent to the dss process. +" + ############################### section "Rsync-related options" ############################### @@ -419,3 +439,23 @@ details=" becomes low. Use this flag if the file system containing the destination directory is used for snapshots only. " + +option "min-complete" - +#~~~~~~~~~~~~~~~~~~~~~~ +"Minimal number of complete snapshots to keep" +int typestr = "num" +default = "1" +optional +details = " + This option is only relevant if snapshots must be deleted + because disk space gets low. + + dss refuses to remove old snapshots if there are fewer complete + snapshots left than the given number. The default value of one + guarantees that at least one complete snapshot is available + at all times. + + If only complete snapshot are left, and there is not + enough disk space available for another snapshot, the program + terminates with a \"No space left on device\" error. +"