# Licensed under the GPL v2. For licencing details see COPYING.
package "dss"
-version "0.1.6"
+version "0.1.7"
purpose "the dyadic snapshot scheduler
dss creates hardlink-based snapshots of a given directory on a remote
#~~~~~~~~~~~~~~~~
"Run as background daemon"
flag off
-dependon="logfile"
details="
- Note that dss refuses to start in daemon mode if no logfile
- was specified. This option is mostly useful in conjunction
- with the -R option described below.
+ This option is mostly useful in conjunction with the -R option
+ described below.
- Note that it is not possible to change whether dss runs as
- background daemon by sending SIGHUP.
+ Note that it is not possible to change whether dss runs as background
+ daemon by sending SIGHUP.
"
option "dry-run" D
"Logfile for the dss daemon process"
string typestr="filename"
optional
+default="/dev/null"
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.
+ given. Otherwise it is silently ignored and log output is written
+ to stderr.
+
+ The default value means that nothing will be logged in daemon mode
+ unless this option is given.
"
##################
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"
"Prune by disk space only"
flag off
details="
- If this flag is not given dss removes redundant and outdated
- snapshots automatically.
-
- Otherwise, this feature is deactivated so that snapshots are
- only being removed in case disk space or number of free inodes
- becomes low. Use this flag if the file system containing the
- destination directory is used for snapshots only.
+ By default, redundant and outdated snapshots are removed automatically
+ to keep the number of snapshots in harmony with the configured
+ policy. If this flag is given, dss removes such snapshots only if
+ disk space or number of free inodes becomes low.
"
option "min-complete" -