4 After almost ten years of development, dss has finally reached version
5 1.0.0. Many new features have been implemented for this release. The
6 list below contains the user-visible changes since the previous
7 0.1.7 release. For the complete changelog consult the git log.
9 The biggest user-visible change is that the former modes of operation
10 have been replaced by subcommands. For example, the former -R option
11 to start dss in "run" mode corresponds to the "run" subcommand of
12 version 1.0.0. Each subcommand has its own set of options. Global
13 options and options for subcommands are split with the usual "--"
14 separator. For example, to specify the global --loglevel option and
15 the run-specific --daemon option, use dss --loglevel 2 -- run --daemon.
17 Although the new version has different syntax rules, the on-disk
18 snapshot format remains the same. No conversion is required to continue
19 existing snapshot directories created with older dss versions.
21 The 0.1.x series will still be maintained for a while as the "maint"
22 branch of the git repository, but this branch will only receive
25 - The gengetopt option parser has been replaced by the
26 [lopsub](http://people.tuebingen.mpg.de/maan/lopsub) library. Hence
27 lopsub must be installed to compile this package. help2man is
28 no longer required since lopsub has built-in roff support.
30 - New subcommand "configtest" to check the command line options and
31 the configuration file for syntactic correctness.
33 - New option: --mountpoint. If this option is given, dss aborts if
34 no file system is mounted on the destination directory.
36 - New option --checksum to let rsync compute checksums occasionally.
38 - The kill subcommand gained the new --wait option which instructs dss
39 to wait until the signalled process has terminated.
41 - The --no-resume option has been removed.
43 - On exit, the run subcommand now waits for any previously spawned
44 rsync or rm processes to terminate.
46 - The ls subcommand now shows the age of incomplete snapshots rather
49 - In run mode, dss no longer exits successfully if another instance
52 - The command specified as the argument to --exit-hook is now subject
53 to word splitting. Previously, the string was executed as-is.
55 - Improved error diagnostics for the kill subcommand.
57 - For all subcommands other than "run", timestamps and function names
58 are omitted from the log output.
60 - "make install" will install the executable and the man page.
62 - CFLAGS, CPPFLAGS and LDFLAGS can now be used to override the flags
65 - Source code files are now annotated with the SPDX GPL-2.0 license
68 - The dss logo is now created with ImageMagick rather than dia.
74 - Documentation improvements.
76 - Improved error diagnostics.
78 - dss no longer refuses to run in daemon mode without a log file.
80 - Minor tweaks to the snapshot pruning algorithm.
82 - A fix for create mode when rsync exists unsuccessfully.
84 - NEWS and README have been converted to markdown format.
86 - We now compile with -Wunused-parameter and -Wshadow.
92 - New option --min-complete to specify the minimal number of snapshots
95 - Improved handling of rsync errors. The new --max-rsync-errors option
96 tells dss to terminate after the given number of rsync failures.
98 - New home page URL and email address.
100 - Reworked rsync restart logic, new --max-rsync-errors option.
102 - Avoidance of "Errors with program diagnostics" error from rsync.
104 - Improved signal handling.
110 - snapshot recycling: outdated, redundant and orphaned snapshots are
111 reused as the basis for new snapshots.
113 - New subcommands: --kill, --reload.
115 - The semaphore-based locking system prevents to start multiple
118 - When dss receives SIGHUP it now writes the internal state and the
119 configuration to the log file
121 - First steps to make the source code ANSI C conform (thanks to
124 - dss writes log messages to stderr rather than to the logfile unless
125 running in daemon mode.
127 - Default hooks work also on systems where "/bin/true" does not exist,
133 This version of dss contains some new features, many improvements of
134 existing features and several bug fixes.
136 Support for resuming snapshot creation after restart has been added
137 and snapshot removal is deferred until at least one current snapshot
138 exists. The internal handling of the various hooks has been simplified
139 and many error messages have been clarified. On SIGHUP, dss now writes
140 its configuration and internal state to the log file.
145 You can now specify pre-rm/post-rm-hooks that are executed whenever
146 a snapshot is deleted. This release adds better compatibility with
147 rsync 3.0, and avoids busy loops when automatically restarting the
153 This release includes the reason why a snapshot gets removed in the
154 log message. It will never remove the snapshot that is currently
155 being created. It will really pass the full path to the last complete
156 snapshot in the post_create_hook.
161 This release prevents busy loops on rsync exit code 13. It ignores
162 any snapshot directory with creation time >= completion time. It
163 opens /dev/null for reading and writing when executing rsync. It shows
164 human readable snapshot creation duration when listing snapshots. It
165 restarts the rsync process if it returned with exit code 13.
170 Initial public release.