fdupes is a program for identifying duplicate files residing within specified directories
C Other Makefile
Latest commit cb018b9 Jan 13, 2017 @tobiasschulz committed on GitHub Merge pull request #6 from rasa/patch-1
Add markdown to README.md to make more readable

README.md

fdupes

fdupes is a program for identifying duplicate files residing within specified directories

This modified version of fdupes includes a patch from:

http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284274

   * debian/patches/50_bts284274_hardlinkreplace.dpatch
     - added -L / --linkhard to make fdupes replace files with hardlinks. Also
       update the manual page; thanks to Rupert Levene for the report and to
       Javier Fernández-Sanguino Peña for the patch; Closes: #284274

   * -M parameter for searching with minimum size by Hesse Hämäläinen

Usage

Usage: fdupes [options] DIRECTORY...

 -r --recurse           for every directory given follow subdirectories
                        encountered within
 -R --recurse:          for each directory given after this option follow
                        subdirectories encountered within (note the ':' at
                        the end of the option, manpage for more details)
 -s --symlinks          follow symlinks
 -H --hardlinks         normally, when two or more files point to the same
                        disk area they are treated as non-duplicates; this
                        option will change this behavior
 -n --noempty           exclude zero-length files from consideration
 -A --nohidden          exclude hidden files from consideration
 -f --omitfirst         omit the first file in each set of matches
 -1 --sameline          list each set of matches on a single line
 -M --minimum           minimum size of files to consider
 -S --size              show size of duplicate files
 -m --summarize         summarize dupe information
 -q --quiet             hide progress indicator
 -d --delete            prompt user for files to preserve and delete all
                        others; important: under particular circumstances,
                        data may be lost when using this option together
                        with -s or --symlinks, or when specifying a
                        particular directory more than once; refer to the
                        fdupes documentation for additional information
 -L --linkhard          hardlink duplicate files to the first file in
                        each set of duplicates without prompting the user
 -N --noprompt          together with --delete, preserve the first file in
                        each set of duplicates and delete the rest without
                        without prompting the user
 -D --debug             enable debugging information
                        each set of duplicates without prompting the user
 -v --version           display fdupes version
 -h --help              display this help message

Unless -1 or --sameline is specified, duplicate files are listed together in groups, each file displayed on a separate line. The groups are then separated from each other by blank lines.

When -1 or --sameline is specified, spaces and backslash characters () appearing in a filename are preceded by a backslash character. For instance, "with spaces" becomes "with\ spaces".

When using -d or --delete, care should be taken to insure against accidental data loss. While no information will be immediately lost, using this option together with -s or --symlink can lead to confusing information being presented to the user when prompted for files to preserve. Specifically, a user could accidentally preserve a symlink while deleting the file it points to. A similar problem arises when specifying a particular directory more than once. All files within that directory will be listed as their own duplicates, leading to data loss should a user preserve a file without its "duplicate" (the file itself!).

-M specifies minimum size of files to consider in bytes. Files smaller than this will be disregarded from duplicate list despite if there is or isn't any duplicates. Useful for finding large duplicate files.

Legal Information

FDUPES Copyright (c) 1999 Adrian Lopez

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.