3cdb83
.TH "hardlink" "1"
3cdb83
.SH "NAME"
3cdb83
hardlink \- Consolidate duplicate files via hardlinks
3cdb83
.SH "SYNOPSIS"
3cdb83
.PP
3cdb83
\fBhardlink\fP [\fB-c\fP] [\fB-n\fP] [\fB-v\fP] [\fB-vv\fP] [\fB-h\fP] directory1 [ directory2 ... ]
3cdb83
.SH "DESCRIPTION"
3cdb83
.PP
3cdb83
This manual page documents \fBhardlink\fP, a
3cdb83
program which consolidates duplicate files in one or more directories
3cdb83
using hardlinks.
3cdb83
.PP
3cdb83
\fBhardlink\fP traverses one
3cdb83
or more directories searching for duplicate files.  When it finds duplicate
3cdb83
files, it uses one of them as the master.  It then removes all other
3cdb83
duplicates and places a hardlink for each one pointing to the master file.
3cdb83
This allows for conservation of disk space where multiple directories
3cdb83
on a single filesystem contain many duplicate files.
3cdb83
.PP
3cdb83
Since hard links can only span a single filesystem, \fBhardlink\fP
3cdb83
is only useful when all directories specified are on the same filesystem.
3cdb83
.SH "OPTIONS"
3cdb83
.PP
3cdb83
.IP "\fB-c\fP" 10
3cdb83
Compare only the contents of the files being considered for consolidation.
3cdb83
Disregards permission, ownership and other differences.
3cdb83
.IP "\fB-f\fP" 10
3cdb83
Force hardlinking across file systems.
3cdb83
.IP "\fB-n\fP" 10
3cdb83
Do not perform the consolidation; only print what would be changed.
3cdb83
.IP "\fB-v\fP" 10
3cdb83
Print summary after hardlinking.
3cdb83
.IP "\fB-vv\fP" 10
3cdb83
Print every hardlinked file and bytes saved. Also print summary after hardlinking.
3cdb83
.IP "\fB-h\fP" 10
3cdb83
Show help.
3cdb83
.SH "AUTHOR"
3cdb83
.PP
3cdb83
\fBhardlink\fP was written by Jakub Jelinek <jakub@redhat.com>.
3cdb83
.PP
3cdb83
Man page written by Brian Long.
3cdb83
.PP
3cdb83
Man page updated by Jindrich Novy <jnovy@redhat.com>
3cdb83
.SH "BUGS"
3cdb83
.PP
3cdb83
\fBhardlink\fP assumes that its target directory trees do not change from under
3cdb83
it.  If a directory tree does change, this may result in \fBhardlink\fP
3cdb83
accessing files and/or directories outside of the intended directory tree.
3cdb83
Thus, you must avoid running \fBhardlink\fP on potentially changing directory
3cdb83
trees, and especially on directory trees under control of another user.