Change make_build rpm macro
[platform/upstream/fdupes.git] / README
1 Introduction
2 --------------------------------------------------------------------
3 FDUPES is a program for identifying duplicate files residing
4 within specified directories. 
5
6
7 Usage
8 --------------------------------------------------------------------
9 Usage: fdupes [options] DIRECTORY...
10
11  -r --recurse           for every directory given follow subdirectories
12                         encountered within
13  -R --recurse:          for each directory given after this option follow
14                         subdirectories encountered within (note the ':' at
15                         the end of the option, manpage for more details)
16  -s --symlinks          follow symlinks
17  -H --hardlinks         normally, when two or more files point to the same
18                         disk area they are treated as non-duplicates; this
19                         option will change this behavior
20  -G --minsize=SIZE      consider only files greater than or equal to SIZE in bytes
21  -L --maxsize=SIZE      consider only files less than or equal to SIZE in bytes
22  -n --noempty           exclude zero-length files from consideration
23  -A --nohidden          exclude hidden files from consideration
24  -f --omitfirst         omit the first file in each set of matches
25  -1 --sameline          list each set of matches on a single line
26  -S --size              show size of duplicate files
27  -t --time              show modification time of duplicate files
28  -m --summarize         summarize dupe information
29  -q --quiet             hide progress indicator
30  -d --delete            prompt user for files to preserve and delete all
31                         others; important: under particular circumstances,
32                         data may be lost when using this option together
33                         with -s or --symlinks, or when specifying a
34                         particular directory more than once; refer to the
35                         fdupes documentation for additional information
36  -P --plain             with --delete, use line-based prompt (as with older
37                         versions of fdupes) instead of screen-mode interface
38  -N --noprompt          together with --delete, preserve the first file in
39                         each set of duplicates and delete the rest without
40                         prompting the user
41  -I --immediate         delete duplicates as they are encountered, without
42                         grouping into sets; implies --noprompt
43  -p --permissions       don't consider files with different owner/group or
44                         permission bits as duplicates
45  -o --order=BY          select sort order for output and deleting; by file
46                         modification time (BY='time'; default), status
47                         change time (BY='ctime'), or filename (BY='name')
48  -i --reverse           reverse order while sorting
49  -l --log=LOGFILE       log file deletion choices to LOGFILE
50  -v --version           display fdupes version
51  -h --help              display this help message
52
53 Unless -1 or --sameline is specified, duplicate files are listed 
54 together in groups, each file displayed on a separate line. The
55 groups are then separated from each other by blank lines.
56
57 When -1 or --sameline is specified, spaces and backslash characters (\) 
58 appearing in a filename are preceded by a backslash character. For
59 instance, "with spaces" becomes "with\ spaces".
60
61 When using -d or --delete, care should be taken to insure against
62 accidental data loss. While no information will be immediately
63 lost, using this option together with -s or --symlink can lead 
64 to confusing information being presented to the user when prompted
65 for files to preserve. Specifically, a user could accidentally
66 preserve a symlink while deleting the file it points to. A similar
67 problem arises when specifying a particular directory more than 
68 once. All files within that directory will be listed as their own
69 duplicates, leading to data loss should a user preserve a file 
70 without its "duplicate" (the file itself!).
71
72
73 Contact Information for Adrian Lopez
74 --------------------------------------------------------------------
75 email: adrian2@caribe.net
76
77
78 Legal Information
79 --------------------------------------------------------------------
80 FDUPES Copyright (c) 1999-2019 Adrian Lopez
81
82 Permission is hereby granted, free of charge, to any person
83 obtaining a copy of this software and associated documentation files
84 (the "Software"), to deal in the Software without restriction,
85 including without limitation the rights to use, copy, modify, merge,
86 publish, distribute, sublicense, and/or sell copies of the Software,
87 and to permit persons to whom the Software is furnished to do so,
88 subject to the following conditions:
89
90 The above copyright notice and this permission notice shall be
91 included in all copies or substantial portions of the Software.
92
93 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 
94 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
95 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
96 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 
97 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 
98 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
99 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.