X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;ds=sidebyside;f=dss.ggo;h=a6644ee3954222db0ed21a568e0ce8e0717e7763;hb=20afe2a3b5467c42610a5587ad6914c035930fc8;hp=15c15a48ad7d9e69536e1be5e28260a031afe1d4;hpb=cf071bc345919c98c3c0e8737d731bd95411bd67;p=dss.git diff --git a/dss.ggo b/dss.ggo index 15c15a4..a6644ee 100644 --- a/dss.ggo +++ b/dss.ggo @@ -1,6 +1,9 @@ +# Copyright (C) 2008 Andre Noll # +# Licensed under the GPL v2. For licencing details see COPYING. + package "dss" -version "0.0.3" +version "0.0.5" purpose "the dyadic snapshot scheduler dss creates hardlink-based snapshots of a given directory on a remote @@ -79,12 +82,17 @@ details=" is also given. " +################## +section "Commands" +################## + defgroup "command" #================= groupdesc=" dss supports a couple of commands each of which corresponds to a different command line option. Exactly one of these options must be given. + " required @@ -188,12 +196,6 @@ details=" to that option are passed verbatim to the rsync command. " -option "exclude-patterns" e -#~~~~~~~~~~~~~~~~~~~~~~~~~~ -"Rsync exclude patterns" -string typestr="path" -optional - ################### section "Intervals" ################### @@ -258,13 +260,13 @@ string typestr="command" optional details=" Execute this after a snapshot has successfully been - created. The full path of the newly created snapshot is passed - to the hook as the first argument. The return value of that - hook is ignored. + created. The full path of the newly created snapshot is + passed to the hook as the first argument. The exit code of + this hook is ignored. For instance this hook can be used to count the number of files per user and/or the disk usage patterns in order to - store them in a database for further treatment. + store them in a database for further analysis. " ############################### @@ -304,13 +306,18 @@ option "min-free-percent-inodes" i #~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ "Minimal percent of free inodes" int typestr="percent" -default="2" +default="0" optional details=" Specify the minimum amount of free inodes on the file system containing the destination dir. If less than that many inodes - are free, snatshot removal kicks in just as in case of low + are free, snapshot removal kicks in just as in case of low disk space. - A value of zero deactivates this check. + Note that not every file system supports the concept of inodes. + Moreover it is not possible to reliably detect whether this is + the case. Therefore this feature is disabled by default. It's + safe to enable it for ext3 file systems on linux though. + + A value of zero (the default) deactivates this check. "