+# SPDX-License-Identifier: GPL-2.0
+
[suite dss]
caption = Subcommands
However, there is one exception to this rule: The run subcommand
re-reads the configuration file when it receives the HUP signal. In
this case the options in the config file override any options that
- were previously given at the command line. This allows to change the
+ were previously given at the command line. This allows changing the
configuration of a running dss process by sending SIGHUP.
[/help]
[option loglevel]
This option is mandatory for all subcommands except kill.
[/help]
+ [option mountpoint]
+ summary = abort if destination directory is not a mountpoint
+ [help]
+ This option checks whether a file system is mounted on the directory
+ specified as the argument to --dest-dir. Operation proceeds only
+ if this is the case. Otherwise dss exits unsuccessfully without
+ performing any action. Use this option to prevent snapshot creation
+ if the snapshot file system is not mounted.
+
+ This option is silently ignored for subcommands which do not depend
+ on the destination directory.
+ [/help]
[option Rsync-options]
summary = Controlling how rsync is run
flag ignored
typestr = percent
default_val = 2
[help]
- This is like --min-free-mb but allows to specify the amount of
- free disk space as a percentage. It is not recommended to set both
+ This is like --min-free-mb but the amount of free disk space
+ is specified as a percentage. It is not recommended to set both
--min-free-mb and --min-free-percent to zero as this will cause your
file system to fill up quickly.
[/help]
It makes only sense to use the option for signals which terminate dss.
[/help]
+[subcommand configtest]
+ purpose = run a configuration file syntax test
+ [description]
+ This command checks the command line options and the configuration
+ file for syntactic correctness. It either reports "Syntax Ok" and
+ exits successfully or prints information about the first syntax error
+ detected and terminates with exit code 1.
+ [/description]
[section copyright]
Written by Andre Noll