forked from elmindreda/duff
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
201 lines (134 loc) · 5.49 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
duff - Duplicate file finder
============================
0. Introduction
===============
Duff is a command-line utility for identifying duplicates in a given set of
files. It attempts to be usably fast and uses the SHA family of message
digests as a part of the comparisons.
The project website is here:
http://duff.dreda.org/
Duff resides in public Git repository on GitHub:
https://github.com/elmindreda/duff
The version numbering scheme for duff is as follows:
* The first number is the major version. This will be updated upon what the
author considers a round of feature completion.
* The second number is the minor version number. This is updated for releases
that include minor new features, or features that do not change the
functionality of the program.
* The third number, if present, is the bugfix release number. This indicates
a release which only fixes bugs present in a previous major or minor release.
1. License and copyright
========================
Duff is copyright (c) 2005 Camilla Berglund <dreda@dreda.org>
Duff is licensed under the zlib/libpng license. See the file `COPYING' for
license details. The license is also included at the top of each source file.
Duff contains shaX-asaddi.
Copyright (c) 2001-2003 Allan Saddi <allan@saddi.com>
See the files `src/sha*.c' and `src/sha*.h' for license details.
Duff uses the gettext.h convenience header from GNU gettext.
Copyright (C) 1995-1998, 2000-2002, 2004-2006, 2009 Free Software Foundation,
Inc. See the `lib/gettex.h' for license details.
Duff comes with a number of files provided by the GNU autoconf, automake and
gettext packages. See the individual files in question for license details.
2. Project news
===============
See the file `NEWS'.
3. Building Duff
================
If you got this source tree from a Git repository then you will need to
bootstrap the build environment using first `gettextize --no-changelog' and then
`autoreconf -i'. Note that this requires that GNU autoconf, automake and
the gettext development tools are installed.
If (or once) you have a `configure' script, go ahead and run it. No additional
magic should be required. If it is, then that's a bug and should be reported.
This release of duff has been successfully built on the following systems:
Ubuntu Natty x86_64
Earlier releases have been successfully built on the following systems:
Arch Linux x86
Cygwin 1.7 i686
Darwin 7.9.0 powerpc
Debian Etch powerpc
Debian Etch x86
Debian Lenny x86
Debian Sarge alpha
Debian Wheezy amd64
FreeBSD 4.11 x86
FreeBSD 5.4 x86
FreeBSD 8.2 i386
Mac OS X 10.3 powerpc
Mac OS X 10.4 powerpc
Mac OS X 10.6 i386
Mac OS X 10.6 x86_64
Mac OS X 10.6 x86_64 (with MacPorts gettext)
Mac OS X 10.7 x86_64
NetBSD 1.6.1 sparc
Red Hat Enterprise 4.0 x86
SunOS 5.9 sparc64
Ubuntu Breezy x86
Ubuntu Jaunty x86
Ubuntu Lucid amd64
Ubuntu Maverick amd64
The tools used were GCC and GNU or BSD make. However, it should build on most
Unix systems without modifications.
4. Installing Duff
==================
See the file `INSTALL'.
5. Using Duff
=============
See the accompanying man page duff(1).
To read the man page before installation, use the following command:
groff -mdoc -Tascii man/duff.1 | less -R
On GNU/Linux systems, however, the following command may suffice:
man -l man/duff.1
6. Hacking Duff
===============
See the file `HACKING'.
7. Bugs, feedback and patches
=============================
Please send bug reports, feedback, patches and cookies to:
Camilla Berglund <dreda@dreda.org>
8. Credits and thanks
=====================
The following (alphabetically listed) people have contributed to duff, either
by reporting bugs, suggesting new features or submitting patches:
Harald Barth
Alexander Bostrom
Magnus Danielsson
Stephan Hegel
Patrik Jarnefelt
Rasmus Kaj
Mika Kuoppala
Richard Levitte
Fernando Lopez
Clemens Lucas Fries
Kamal Mostafa
Ross Newell
Allan Saddi <allan@saddi.com>
...and everyone I forgot. Did I forget you? Drop me an email.
9. Disambiguation
=================
This is duff the Unix command-line utility, not DUFF the Windows program.
If you wish to find duplicate files on Windows, use DUFF.
DUFF also has a SourceForge.net URL:
http://dff.sourceforge.net/
10. Release history
===================
Version 0.1 was named `duplicate' and was never released anywhere.
Version 0.2 was the first release named duff. It lacked a real checksumming
algorithm, and was thus only released to a few individuals, during the first
half of 2005.
Version 0.3 was the first official release, on November 22, 2005, after a
long search for a suitably licensed implementation of SHA1.
Version 0.3.1 was a bugfix release, on November 27, 2005, adding a single
feature (-z), which just happened to get included.
Version 0.4 was the second feature release, on January 13, 2006, adding a
number of missing and/or requested features as well as bug fixes. It was the
first release to be considered stable and safe enough for everyday use.
Version 0.5 was the third feature release, on April 11, 2011, adding a number
of minor features and fixing a number of bugs. It was mostly intended to get
the ball rolling again and thus low on features.
Version 0.5.1 was a bugfix release, on January 17, 2012, adding a single bugfix
and a new default cluster header for thorough mode.
Version 0.5.2 was an minor release, on January 29, 2012, adding a number of
optimizations, prefixing error and warning messages with the program name and
modifying the default sampling limit.