Added an option to see progress.
[finddup.git] / finddup.1
1 .TH "FINDDUP" 1 "Mar 2010" "Francois Fleuret" "User Commands"
2
3 \" This man page was written by Francois Fleuret <francois@fleuret.org>
4 \" and is distributed under a Creative Commons Attribution-Share Alike
5 \" 3.0 License.
6
7 .SH "NAME"
8
9 finddup \- Find files common to two directories (or not)
10
11 .SH "SYNOPSIS"
12
13 \fBfinddup\fP [OPTION]... DIR1 [[not:]DIR2]
14
15 .SH "DESCRIPTION"
16
17 With a single directory argument, \fBfinddup\fP prints the duplicated
18 files found in it. With two directories, it prints either the files
19 common to both DIR1 and DIR2, or with the `not:' prefix, the ones
20 present in DIR1 and not in DIR2.
21
22 .SH "OPTIONS"
23 .TP
24 \fB-h\fR
25 display help and exit
26 .TP
27 \fB-d\fR
28 ignore files and directories starting with a dot
29 .TP
30 \fB-c\fR
31 do not show which files from DIR2 corresponds to files from DIR1
32 .TP
33 \fB-g\fR
34 do not show the file group IDs (one group for each content)
35 .TP
36 \fB-p\fR
37 show progress information in stderr
38 .TP
39 \fB-r\fR
40 shows the real path of the files
41
42 .SH "BUGS"
43
44 The display is not sorted by groups.
45
46 .SH "EXAMPLES"
47 .nf
48 .B finddup -cg blah something
49
50 .fi
51 List files found in
52 .B ./blah/
53 which have a matching file with exact same content in
54 .B ./something/
55 without the group IDs
56
57 .P
58 .B finddup ./sources not:./backup
59
60 .fi
61 List all files found in
62 .B ./sources/
63 which do not have content-matching equivalent in
64 .B ./backup.sources
65
66 .P
67 .B finddup ./tralala ./cuicui | sort -n
68
69 .fi
70 List groups of files with same content which exist both in
71 .B ./tralala/
72 and
73 .B ./cuicui/
74
75 .SH "AUTHOR"
76
77 Written by Francois Fleuret <francois@fleuret.org> and distributed
78 under the terms of the GNU General Public License version 3 as
79 published by the Free Software Foundation. This is free software: you
80 are free to change and redistribute it. There is NO WARRANTY, to the
81 extent permitted by law.