NEWS

   1 ------------------
   2 1.0.0 (2017-11-19)
   3 ------------------
   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.
   8
   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.
  16
  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.
  20
  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
  23 bug fixes.
  24
  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.
  29
  30  - New subcommand "configtest" to check the command line options and
  31  the configuration file for syntactic correctness.
  32
  33  - New option: --mountpoint. If this option is given, dss aborts if
  34  no file system is mounted on the destination directory.
  35
  36  - New option --checksum to let rsync compute checksums occasionally.
  37
  38  - The kill subcommand gained the new --wait option which instructs dss
  39  to wait until the signalled process has terminated.
  40
  41  - The --no-resume option has been removed.
  42
  43  - On exit, the run subcommand now waits for any previously spawned
  44  rsync or rm processes to terminate.
  45
  46  - The ls subcommand now shows the age of incomplete snapshots rather
  47  than 0:00.
  48
  49  - In run mode, dss no longer exits successfully if another instance
  50  is already running.
  51
  52  - The command specified as the argument to --exit-hook is now subject
  53  to word splitting. Previously, the string was executed as-is.
  54
  55  - Improved error diagnostics for the kill subcommand.
  56
  57  - For all subcommands other than "run", timestamps and function names
  58  are omitted from the log output.
  59
  60  - "make install" will install the executable and the man page.
  61
  62  - CFLAGS, CPPFLAGS and LDFLAGS can now be used to override the flags
  63  of the build system.
  64
  65  - Source code files are now annotated with the SPDX GPL-2.0 license
  66  identifier.
  67
  68  - The dss logo is now created with ImageMagick rather than dia.
  69
  70 ------------------
  71 0.1.7 (2017-04-17)
  72 ------------------
  73
  74  - Documentation improvements.
  75
  76  - Improved error diagnostics.
  77
  78  - dss no longer refuses to run in daemon mode without a log file.
  79
  80  - Minor tweaks to the snapshot pruning algorithm.
  81
  82  - A fix for create mode when rsync exists unsuccessfully.
  83
  84  - NEWS and README have been converted to markdown format.
  85
  86  - We now compile with -Wunused-parameter and -Wshadow.
  87
  88 ------------------
  89 0.1.6 (2015-08-05)
  90 ------------------
  91
  92  - New option --min-complete to specify the minimal number of snapshots
  93    to keep.
  94
  95  - Improved handling of rsync errors. The new --max-rsync-errors option
  96  tells dss to terminate after the given number of rsync failures.
  97
  98  - New home page URL and email address.
  99
 100  - Reworked rsync restart logic, new --max-rsync-errors option.
 101
 102  - Avoidance of "Errors with program diagnostics" error from rsync.
 103
 104  - Improved signal handling.
 105
 106 ------------------
 107 0.1.5 (2014-01-14)
 108 ------------------
 109
 110  - snapshot recycling: outdated, redundant and orphaned snapshots are
 111  reused as the basis for new snapshots.
 112
 113  - New subcommands: --kill, --reload.
 114
 115  - The semaphore-based locking system prevents to start multiple
 116  instances of dss.
 117
 118  - When dss receives SIGHUP it now writes the internal state and the
 119  configuration to the log file
 120
 121  - First steps to make the source code ANSI C conform (thanks to
 122  Daniel Richard G).
 123
 124  - dss writes log messages to stderr rather than to the logfile unless
 125  running in daemon mode.
 126
 127  - Default hooks work also on systems where "/bin/true" does not exist,
 128  e.g. Mac OS.
 129
 130 ------------------
 131 0.1.4 (2010-11-08)
 132 ------------------
 133 This version of dss contains some new features, many improvements of
 134 existing features and several bug fixes.
 135
 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.
 141
 142 ------------------
 143 0.1.3 (2009-06-06)
 144 ------------------
 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
 148 rsync process.
 149
 150 ------------------
 151 0.1.2 (2009-03-05)
 152 ------------------
 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.
 157
 158 ------------------
 159 0.1.1 (2008-11-13)
 160 ------------------
 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.
 166
 167 ------------------
 168 0.1.0 (2008-10-10)
 169 ------------------
 170 Initial public release.