1
duff - Duplicate file finder
2
============================
7
Duff is a command-line utility for identifying duplicates in a given set of
8
files. It attempts to be usably fast and uses the SHA family of message
9
digests as a part of the comparisons.
11
The project website is here:
13
http://duff.sourceforge.net/
15
Duff resides in public Git repository on SourceForge.net:
17
git://duff.git.sourceforge.net/gitroot/duff/duff
19
The version numbering scheme for duff is as follows:
21
* The first number is the major version. This will be updated upon what the
22
author considers a round of feature completion.
24
* The second number is the minor version number. This is updated for releases
25
that include minor new features, or features that do not change the
26
functionality of the program.
28
* The third number, if present, is the bugfix release number. This indicates
29
a release which only fixes bugs present in a previous major or minor release.
32
1. License and copyright
33
========================
35
Duff is copyright (c) 2005 Camilla Berglund <elmindreda@elmindreda.org>
37
Duff is licensed under the zlib/libpng license. See the file `COPYING' for
38
license details. The license is also included at the top of each source file.
40
Duff contains shaX-asaddi.
41
Copyright (c) 2001-2003 Allan Saddi <allan@saddi.com>
42
See the files `src/sha*.c' and `src/sha*.h' for license details.
44
Duff uses the gettext.h convenience header from GNU gettext.
45
Copyright (C) 1995-1998, 2000-2002, 2004-2006, 2009 Free Software Foundation,
46
Inc. See the `lib/gettex.h' for license details.
48
Duff comes with a number of files provided by the GNU autoconf, automake and
49
gettext packages. See the individual files in question for license details.
61
If you got this source tree from a Git repository then you will need to
62
bootstrap the build environment using first `gettextize' and then `autoreconf
63
-i'. Note that this requires that GNU autoconf, automake and gettext are
64
installed. Also note that running gettextize may cause a few duplicate entries
65
in various build files. If you got the source tree using Git, you can remove
66
these with `git reset --hard' before moving on.
68
If (or once) you have a `configure' script, go ahead and run it. No additional
69
magic should be required. If it is, then that's a bug and should be reported.
71
This release of duff has been successfully built on the following systems:
77
Earlier releases have been successfully built on the following systems:
94
Mac OS X 10.6 x86_64 (with MacPorts gettext)
96
Red Hat Enterprise 4.0 x86
101
Ubuntu Maverick amd64
103
The tools used were GCC and GNU or BSD make. However, it should build on most
104
Unix systems without modifications.
110
See the file `INSTALL'.
116
See the accompanying manpage duff(1).
118
To read the manpage before installation, use the following command:
120
groff -mdoc -Tascii duff.1 | less -R
122
On GNU/Linux systems, however, the following command may suffice:
130
See the file `HACKING'.
133
7. Bugs, feedback and patches
134
=============================
136
Please send bug reports, feedback, patches and cookies to:
138
Camilla Berglund <elmindreda@elmindreda.org>
140
Or, if you prefer, you may use the trackers on SF.net to report bugs, submit
141
patches or request features:
143
http://sourceforge.net/projects/duff
145
For more involved discussions, please join the mailing list:
147
http://lists.sourceforge.net/lists/listinfo/duff-devel
150
8. Credits and thanks
151
=====================
153
The following (alphabetically listed) people have contributed to duff, either
154
by reporting bugs, suggesting new features or submitting patches:
168
Allan Saddi <allan@saddi.com>
170
...and everyone I forgot. Did I forget you? Drop me an email.
176
This is duff the Unix command-line utility, not DUFF the Windows program.
177
If you wish to find duplicate files on Windows, use DUFF.
179
DUFF also has a SourceForge.net URL:
181
http://dff.sourceforge.net/
187
Version 0.1 was named `duplicate' and was never released anywhere.
189
Version 0.2 was the first release named duff. It lacked a real checksumming
190
algorithm, and was thus only released to a few individuals, during the first
193
Version 0.3 was the first official release, on November 22, 2005, after a
194
long search for a suitably licensed implementation of SHA1.
196
Version 0.3.1 was a bugfix release, on November 27, 2005, adding a single
197
feature (-z), which just happened to get included.
199
Version 0.4 was the second feature release, on January 13, 2006, adding a
200
number of missing and/or requested features as well as bug fixes. It was the
201
first release to be considered stable and safe enough for everyday use.
203
Version 0.5 was the third feature release, on April 11, 2011, adding a number
204
of minor features and fixing a number of bugs. It was mostly intended to get
205
the ball rolling again and thus low on features.
207
Version 0.5.1 was a bugfix release, on January 17, 2012, adding a single bugfix
208
and a new default cluster header for thorough mode.
210
Version 0.5.2 was an minor release, on January 29, 2012, adding a number of
211
optimizations, prefixing error and warning messages with the program name and
212
modifying the default sampling limit.