use File::Compare;
use File::Temp;
-my $links_input = 0;
-my $files_input = 0;
-my $bogons_input = 0;
-my $files_hashed = 0;
+# Copyright (C) 2003-2010 Zygo Blaxell <faster-dupemerge@mailtoo.hungrycats.org>
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+my $input_links = 0;
+my $input_files = 0;
+my $input_bogons = 0;
+my $hash_bytes = 0;
+my $hash_files = 0;
my $hash_errors = 0;
+my $compare_bytes = 0;
my $compare_count = 0;
my $compare_errors = 0;
my $compare_differences = 0;
my $hard_links = 0;
my $link_errors = 0;
my $link_retries = 0;
-my $bytes_recovered = 0;
-my $files_recovered = 0;
-my $files_lost = 0;
-my $bytes_lost = 0;
+my $recovered_bytes = 0;
+my $recovered_files = 0;
+my $lost_files = 0;
+my $lost_bytes = 0;
my $surprises = 0;
eval '
warn "Digest::SHA1: $@\nUsing external md5sum program to generate hashes.\nPlease install Digest::SHA1 (libdigest-sha1-perl)";
eval <<'DIGEST';
- sub digest {
+ sub really_digest {
my ($filename) = (@_);
my $fv = open(MD5SUM, "-|");
die "fork: $!" unless defined($fv);
DIGEST
} else {
eval <<'DIGEST';
- sub digest {
+ sub really_digest {
my ($filename) = (@_);
die "'$filename' is not a plain file" if (-l $filename) || ! (-f _);
my $ctx = Digest::SHA1->new;
my $collapse_access = 0;
my $collapse_timestamp = 0;
my $collapse_zero = 0;
-my $trust_hashes = 0;
+my $skip_compares = 0;
+my $skip_hashes = 0;
my $verbose = 0;
my $debug = 0;
+my $dry_run = 0;
+my $humane = 0;
my @extra_find_opts = ();
my @extra_sort_opts = ();
my $lock_file;
my $lock_rm = 0;
my $lock_obtained = 0;
+sub digest {
+ my ($filename) = (@_);
+ if ($skip_hashes) {
+ return "SKIPPING HASHES";
+ } else {
+ my $digest = &really_digest($filename);
+ $hash_bytes += -s $filename;
+ $hash_files++;
+ return $digest
+ }
+}
+
my @directories;
sub usage {
--debug show all steps in duplication discovery process
(implies --verbose)
+ --dry-run do not lock files or make changes to filesystem
+
--find pass next options (up to --) to find command
+ --humane human-readable statistics (e.g. 1 048 576)
+
--lock FILE exit immediately (status 10) if unable to obtain a
flock(LOCK_EX|LOCK_NB) on FILE
--timestamps mtime may be different for identical files
- --trust skip byte-by-byte file comparisons
+ --skip-compare skip byte-by-byte file comparisons
+
+ --skip-hash skip calculation of hash function on files
+
+ --trust old name for --skip-compare
(trust the hash function)
--verbose report files as they are considered
$collapse_timestamp = 1;
} elsif ($arg eq '--zeros') {
$collapse_zero = 1;
- } elsif ($arg eq '--trust') {
- $trust_hashes = 1;
+ } elsif ($arg eq '--trust' || $arg eq '--skip-compare') {
+ $skip_compares = 1;
+ } elsif ($arg eq '--skip-hash') {
+ $skip_hashes = 1;
} elsif ($arg eq '--verbose') {
$verbose = 1;
} elsif ($arg eq '--lock-rm') {
}
} elsif ($arg eq '--debug') {
$debug = $verbose = 1;
+ } elsif ($arg eq '--dry-run') {
+ $dry_run = 1;
+ } elsif ($arg eq '--humane') {
+ $humane = 1;
} elsif ($arg eq '--find') {
while ($#ARGV >= 0) {
my $extra_arg = shift(@ARGV);
}
}
-if (defined($lock_file)) {
+if ($skip_hashes && $skip_compares) {
+ die "Cannot skip both hashes and compares.\n";
+}
+
+@directories or usage;
+
+if (defined($lock_file) && !$dry_run) {
sysopen(LOCK_FILE, $lock_file, O_CREAT|O_RDONLY, 0666) or die "open: $lock_file: $!";
flock(LOCK_FILE, LOCK_EX|LOCK_NB) or die "flock: $lock_file: LOCK_EX|LOCK_NB: $!";
print STDERR "Locked '$lock_file' in LOCK_EX mode.\n" if $verbose;
}
END {
- if ($lock_obtained) {
+ if ($lock_obtained && !$dry_run) {
print STDERR "Removing '$lock_file'.\n" if $verbose;
unlink($lock_file) or warn "unlink: $lock_file: $!";
}
sub tick_quote {
my ($text) = (@_);
- $text =~ s/'/'\''/go;
+ $text =~ s/'/'\\''/go;
return "'$text'";
}
my $printf_string = '%s ' .
($collapse_access ? '0 0 0 ' : '%U %G %m ') .
($collapse_timestamp ? '0 ' : '%T@ ') .
- '%i %p\0';
+ '%D:%i %p\0';
push(@find_command, '!', '-empty') unless $collapse_zero;
push(@find_command, '-printf', $printf_string);
# Link files
sub link_files {
my ($from, $to) = (@_);
+
+ my $quoted_from = tick_quote($from);
+ my $quoted_to = tick_quote($to);
+ print STDERR "ln -f $quoted_from $quoted_to\n";
+
+ return if $dry_run;
+
my $inode_dir = $to;
my $inode_base = $to;
$inode_dir =~ s:[^/]*$::o;
$inode_base =~ s:^.*/::os;
my $tmp_to = File::Temp::tempnam($inode_dir, ".$inode_base.");
- my $quoted_from = tick_quote($from);
- my $quoted_to = tick_quote($to);
- print STDERR "ln -f $quoted_from $quoted_to\n";
print STDERR "\tlink: $from -> $tmp_to\n" if $debug;
link($from, $tmp_to) or die "link: $from -> $tmp_to: $!";
print STDERR "\trename: $tmp_to -> $to\n" if $debug;
my %stop_loop;
my @candidate_list = keys(%inode_to_file_name);
- $files_input += @candidate_list;
+ $input_files += @candidate_list;
if (@candidate_list < 2) {
print STDERR "Merging...only one candidate to merge..." if $debug;
$trivially_unique++;
}
print STDERR "Merging...\n" if $debug;
- foreach my $candidate (@candidate_list) {
+ foreach my $candidate (sort @candidate_list) {
print STDERR "\tDigesting candidate $candidate\n" if $debug;
my $ok = 0;
my $digest;
hash_file:
- foreach my $filename (keys(%{$inode_to_file_name{$candidate}})) {
+ foreach my $filename (sort keys(%{$inode_to_file_name{$candidate}})) {
print STDERR "\t\tDigesting file $filename\n" if $debug;
if ((-l $filename) || ! -f _) {
warn "Bogon file " . tick_quote($filename);
$surprises++;
next;
}
- eval { $digest = digest($filename); };
+ eval {
+ $digest = digest($filename);
+ };
if ($@) {
warn "Digest($filename)(#$candidate) failed: $@";
$hash_errors++;
} else {
$ok = 1;
- $files_hashed++;
last hash_file;
}
}
if ($ok) {
print STDERR "\t\tDigest is $digest\n" if $debug;
- my $incumbent = $hash_to_inode{$digest};
- if (defined($incumbent)) {
+ my $incumbent_list = ($hash_to_inode{$digest} ||= []);
+ my $incumbent_matched = 0;
+ for my $incumbent (sort @$incumbent_list) {
print STDERR "\t\tInodes $incumbent and $candidate have same hash\n" if $debug;
my $finished = 0;
link_start:
until ($finished) {
- my @incumbent_names = keys(%{$inode_to_file_name{$incumbent}});
- my @candidate_names = keys(%{$inode_to_file_name{$candidate}});
- print STDERR "\t\tLinks to $incumbent:", join("\n\t\t\t", '', @incumbent_names), "\n" if $debug;
+ my @incumbent_names = sort keys(%{$inode_to_file_name{$incumbent}});
+ my @candidate_names = sort keys(%{$inode_to_file_name{$candidate}});
+ print STDERR "\t\tLinks to $incumbent:", join("\n\t\t\t", '', @incumbent_names), "\n" if $debug;
print STDERR "\t\tLinks to $candidate:", join("\n\t\t\t", '', @candidate_names), "\n" if $debug;
- incumbent_file:
+incumbent_file:
foreach my $incumbent_file (@incumbent_names) {
my ($incumbent_dev,$incumbent_ino,$incumbent_mode,$incumbent_nlink,$incumbent_uid,$incumbent_gid,$incumbent_rdev,$incumbent_size,$incumbent_atime,$incumbent_mtime,$incumbent_ctime,$incumbent_blksize,$incumbent_blocks) = lstat($incumbent_file);
next incumbent_file;
}
- candidate_file:
-
my $at_least_one_link_done = 0;
+candidate_file:
+
foreach my $candidate_file (@candidate_names) {
my ($candidate_dev,$candidate_ino,$candidate_mode,$candidate_nlink,$candidate_uid,$candidate_gid,$candidate_rdev,$candidate_size,$candidate_atime,$candidate_mtime,$candidate_ctime,$candidate_blksize,$candidate_blocks) = lstat($candidate_file);
print STDERR "\t\t\tCANDIDATE dev=$candidate_dev ino=$candidate_ino mode=$candidate_mode nlink=$candidate_nlink uid=$candidate_uid gid=$candidate_gid rdev=$candidate_rdev size=$candidate_size atime=$candidate_atime mtime=$candidate_mtime ctime=$candidate_ctime blksize=$candidate_blksize blocks=$candidate_blocks _=$candidate_file\n" if $debug;
my $identical;
eval {
- if ($trust_hashes) {
- print STDERR "\t\t\t\tTrusting hashes!\n" if $debug;
+ if ($skip_compares) {
+ print STDERR "\t\t\t\tSkipping compare!\n" if $debug;
$identical = 1;
} else {
my $quoted_incumbent_file = tick_quote($incumbent_file);
my $quoted_candidate_file = tick_quote($candidate_file);
- print STDERR "cmp $quoted_incumbent_file $quoted_candidate_file\n";
+ print STDERR "cmp $quoted_incumbent_file $quoted_candidate_file\n" if $debug;
if (compare($incumbent_file, $candidate_file)) {
$compare_differences++;
$identical = 0;
- print STDERR "$quoted_incumbent_file and $quoted_candidate_file have same hash but do not compare equal!\n"
+ # It is significant for two non-identical files to have identical SHA1 or MD5 hashes.
+ # Some kind of I/O error is more likely, so this message cannot be turned off.
+ # On the other hand, if we're skipping hashes, _all_ files will have the same hash,
+ # so the warning in that case is quite silly. Hmmm.
+ print STDERR "$quoted_incumbent_file and $quoted_candidate_file have same hash but do not compare equal!\n" unless $skip_hashes;
} else {
$identical = 1;
+ $incumbent_matched = 1;
}
$compare_count++;
+ $compare_bytes += $incumbent_size;
}
};
if ($@) {
my $link_done = 0;
my ($from_file, $to_file, $from_inode, $to_inode, $from_nlink, $to_nlink);
+
+ # If the candidate has more links than incumbent, replace incumbent with candidate.
+ # If the incumbent has more links than candidate, replace candidate with incumbent.
+ # If the link counts are equal, we saw incumbent first, so keep the incumbent.
+ # "We saw incumbent first" is significant because we explicitly sort the inodes.
+ # Thank Johannes Niess for this idea.
if ($candidate_nlink > $incumbent_nlink) {
$from_file = $candidate_file;
$to_file = $incumbent_file;
if ($link_done) {
delete $inode_to_file_name{$to_inode}->{$to_file};
$inode_to_file_name{$from_inode}->{$to_file} = undef;
- $hash_to_inode{$digest} = $from_inode;
+ $hash_to_inode{$digest} = [ $from_inode ];
$hard_links++;
if ($to_nlink == 1) {
- $files_recovered++;
- $bytes_recovered += $incumbent_size;
+ $recovered_files++;
+ $recovered_bytes += $incumbent_size;
}
# FIXME: Now we're really confused for some reason.
# tried all possible ways to hardlink the file out of existence first;
# however, that is complex and only benefits a silly statistic.
if ($to_nlink == 1 || $from_nlink == 1) {
- $files_lost++;
- $bytes_lost += $incumbent_size;
+ $lost_files++;
+ $lost_bytes += $incumbent_size;
}
}
}
}
$finished = 1;
}
- } else {
+ }
+ unless ($incumbent_matched) {
print STDERR "\t\tNew hash entered\n" if $debug;
- $hash_to_inode{$digest} = $candidate;
+ push(@$incumbent_list, $candidate);
}
} else {
warn "No digests found for inode $candidate\n";
}
while (<FIND>) {
- my ($weak_key, $inode, $name) = m/^(\d+ \d+ \d+ \d+ -?\d+) (\d+) (.+)\0$/so;
+ my ($weak_key, $dev, $ino, $name) = m/^(\d+ \d+ \d+ \d+ -?[\d.]+) (\d+):(\d+) (.+)\0$/so;
die "read error: $!\nLast input line was '$_'" unless defined($name);
+ my $inode = sprintf('%016x:%016x', $dev, $ino);
+
print STDERR "weak_key=$weak_key inode=$inode name=$name\n" if $debug;
unless (! (-l $name) && (-f _)) {
warn "Bogon file " . tick_quote($name);
- $bogons_input++;
+ $input_bogons++;
next;
}
- $links_input++;
+ $input_links++;
merge_files if $weak_key ne $current_key;
$current_key = $weak_key;
merge_files;
-print STDERR <<STATS;
-links_input $links_input
-files_input ........... $files_input
-bogons_input $bogons_input
-merges_attempted ...... $merges_attempted
-trivially_unique $trivially_unique
-files_hashed .......... $files_hashed
-hash_errors $hash_errors
-surprises ............. $surprises
+my $stats_blob = <<STATS;
+compare_bytes $compare_bytes
compare_count $compare_count
-compare_differences ... $compare_differences
+compare_differences $compare_differences
compare_errors $compare_errors
-hard_links ............ $hard_links
+hard_links $hard_links
+hash_bytes $hash_bytes
+hash_errors $hash_errors
+hash_files $hash_files
+input_bogons $input_bogons
+input_files $input_files
+input_links $input_links
link_errors $link_errors
-link_retries .......... $link_retries
-bytes_recovered $bytes_recovered
-files_recovered ....... $files_recovered
-bytes_lost $bytes_lost
-files_lost ............ $files_lost
+link_retries $link_retries
+lost_bytes $lost_bytes
+lost_files $lost_files
+merges_attempted $merges_attempted
+recovered_bytes $recovered_bytes
+recovered_files $recovered_files
+surprises $surprises
+trivially_unique $trivially_unique
STATS
+if ($humane) {
+ my $max_num_len = 0;
+
+ sub measure_numbers {
+ my ($num) = @_;
+ my $len = length($num);
+ $len += int( (length($num) - 1) / 3);
+ $max_num_len = $len if $len > $max_num_len;
+ }
+
+ (my $dummy = $stats_blob) =~ s/\d+/measure_numbers($&)/geos;
+
+ sub space_numbers {
+ my ($num) = @_;
+ 1 while $num =~ s/(\d)(\d\d\d)( \d\d\d)*$/$1 $2$3/os;
+ $num = ' ' x ($max_num_len - length($num)) . $num;
+ return $num;
+ }
+
+ $stats_blob =~ s/\d+/space_numbers($&)/geos;
+}
+
+$stats_blob =~ s/([^\n]*\n[^\n]*? )(\s+)( [^\n]*\n)/$1 . ('.' x length($2)) . $3/oemg;
+
+print STDERR $stats_blob;
+
exit(0);
+
+__END__
+
+#################################################################################
+# GNU GENERAL PUBLIC LICENSE #
+# Version 2, June 1991 #
+# #
+# Copyright (C) 1989, 1991 Free Software Foundation, Inc. #
+# 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA #
+# Everyone is permitted to copy and distribute verbatim copies #
+# of this license document, but changing it is not allowed. #
+# #
+# Preamble #
+# #
+# The licenses for most software are designed to take away your #
+# freedom to share and change it. By contrast, the GNU General Public #
+# License is intended to guarantee your freedom to share and change free #
+# software--to make sure the software is free for all its users. This #
+# General Public License applies to most of the Free Software #
+# Foundation's software and to any other program whose authors commit to #
+# using it. (Some other Free Software Foundation software is covered by #
+# the GNU Library General Public License instead.) You can apply it to #
+# your programs, too. #
+# #
+# When we speak of free software, we are referring to freedom, not #
+# price. Our General Public Licenses are designed to make sure that you #
+# have the freedom to distribute copies of free software (and charge for #
+# this service if you wish), that you receive source code or can get it #
+# if you want it, that you can change the software or use pieces of it #
+# in new free programs; and that you know you can do these things. #
+# #
+# To protect your rights, we need to make restrictions that forbid #
+# anyone to deny you these rights or to ask you to surrender the rights. #
+# These restrictions translate to certain responsibilities for you if you #
+# distribute copies of the software, or if you modify it. #
+# #
+# For example, if you distribute copies of such a program, whether #
+# gratis or for a fee, you must give the recipients all the rights that #
+# you have. You must make sure that they, too, receive or can get the #
+# source code. And you must show them these terms so they know their #
+# rights. #
+# #
+# We protect your rights with two steps: (1) copyright the software, and #
+# (2) offer you this license which gives you legal permission to copy, #
+# distribute and/or modify the software. #
+# #
+# Also, for each author's protection and ours, we want to make certain #
+# that everyone understands that there is no warranty for this free #
+# software. If the software is modified by someone else and passed on, we #
+# want its recipients to know that what they have is not the original, so #
+# that any problems introduced by others will not reflect on the original #
+# authors' reputations. #
+# #
+# Finally, any free program is threatened constantly by software #
+# patents. We wish to avoid the danger that redistributors of a free #
+# program will individually obtain patent licenses, in effect making the #
+# program proprietary. To prevent this, we have made it clear that any #
+# patent must be licensed for everyone's free use or not licensed at all. #
+# #
+# The precise terms and conditions for copying, distribution and #
+# modification follow. #
+# #
+# GNU GENERAL PUBLIC LICENSE #
+# TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION #
+# #
+# 0. This License applies to any program or other work which contains #
+# a notice placed by the copyright holder saying it may be distributed #
+# under the terms of this General Public License. The "Program", below, #
+# refers to any such program or work, and a "work based on the Program" #
+# means either the Program or any derivative work under copyright law: #
+# that is to say, a work containing the Program or a portion of it, #
+# either verbatim or with modifications and/or translated into another #
+# language. (Hereinafter, translation is included without limitation in #
+# the term "modification".) Each licensee is addressed as "you". #
+# #
+# Activities other than copying, distribution and modification are not #
+# covered by this License; they are outside its scope. The act of #
+# running the Program is not restricted, and the output from the Program #
+# is covered only if its contents constitute a work based on the #
+# Program (independent of having been made by running the Program). #
+# Whether that is true depends on what the Program does. #
+# #
+# 1. You may copy and distribute verbatim copies of the Program's #
+# source code as you receive it, in any medium, provided that you #
+# conspicuously and appropriately publish on each copy an appropriate #
+# copyright notice and disclaimer of warranty; keep intact all the #
+# notices that refer to this License and to the absence of any warranty; #
+# and give any other recipients of the Program a copy of this License #
+# along with the Program. #
+# #
+# You may charge a fee for the physical act of transferring a copy, and #
+# you may at your option offer warranty protection in exchange for a fee. #
+# #
+# 2. You may modify your copy or copies of the Program or any portion #
+# of it, thus forming a work based on the Program, and copy and #
+# distribute such modifications or work under the terms of Section 1 #
+# above, provided that you also meet all of these conditions: #
+# #
+# a) You must cause the modified files to carry prominent notices #
+# stating that you changed the files and the date of any change. #
+# #
+# b) You must cause any work that you distribute or publish, that in #
+# whole or in part contains or is derived from the Program or any #
+# part thereof, to be licensed as a whole at no charge to all third #
+# parties under the terms of this License. #
+# #
+# c) If the modified program normally reads commands interactively #
+# when run, you must cause it, when started running for such #
+# interactive use in the most ordinary way, to print or display an #
+# announcement including an appropriate copyright notice and a #
+# notice that there is no warranty (or else, saying that you provide #
+# a warranty) and that users may redistribute the program under #
+# these conditions, and telling the user how to view a copy of this #
+# License. (Exception: if the Program itself is interactive but #
+# does not normally print such an announcement, your work based on #
+# the Program is not required to print an announcement.) #
+# #
+# These requirements apply to the modified work as a whole. If #
+# identifiable sections of that work are not derived from the Program, #
+# and can be reasonably considered independent and separate works in #
+# themselves, then this License, and its terms, do not apply to those #
+# sections when you distribute them as separate works. But when you #
+# distribute the same sections as part of a whole which is a work based #
+# on the Program, the distribution of the whole must be on the terms of #
+# this License, whose permissions for other licensees extend to the #
+# entire whole, and thus to each and every part regardless of who wrote it. #
+# #
+# Thus, it is not the intent of this section to claim rights or contest #
+# your rights to work written entirely by you; rather, the intent is to #
+# exercise the right to control the distribution of derivative or #
+# collective works based on the Program. #
+# #
+# In addition, mere aggregation of another work not based on the Program #
+# with the Program (or with a work based on the Program) on a volume of #
+# a storage or distribution medium does not bring the other work under #
+# the scope of this License. #
+# #
+# 3. You may copy and distribute the Program (or a work based on it, #
+# under Section 2) in object code or executable form under the terms of #
+# Sections 1 and 2 above provided that you also do one of the following: #
+# #
+# a) Accompany it with the complete corresponding machine-readable #
+# source code, which must be distributed under the terms of Sections #
+# 1 and 2 above on a medium customarily used for software interchange; or, #
+# #
+# b) Accompany it with a written offer, valid for at least three #
+# years, to give any third party, for a charge no more than your #
+# cost of physically performing source distribution, a complete #
+# machine-readable copy of the corresponding source code, to be #
+# distributed under the terms of Sections 1 and 2 above on a medium #
+# customarily used for software interchange; or, #
+# #
+# c) Accompany it with the information you received as to the offer #
+# to distribute corresponding source code. (This alternative is #
+# allowed only for noncommercial distribution and only if you #
+# received the program in object code or executable form with such #
+# an offer, in accord with Subsection b above.) #
+# #
+# The source code for a work means the preferred form of the work for #
+# making modifications to it. For an executable work, complete source #
+# code means all the source code for all modules it contains, plus any #
+# associated interface definition files, plus the scripts used to #
+# control compilation and installation of the executable. However, as a #
+# special exception, the source code distributed need not include #
+# anything that is normally distributed (in either source or binary #
+# form) with the major components (compiler, kernel, and so on) of the #
+# operating system on which the executable runs, unless that component #
+# itself accompanies the executable. #
+# #
+# If distribution of executable or object code is made by offering #
+# access to copy from a designated place, then offering equivalent #
+# access to copy the source code from the same place counts as #
+# distribution of the source code, even though third parties are not #
+# compelled to copy the source along with the object code. #
+# #
+# 4. You may not copy, modify, sublicense, or distribute the Program #
+# except as expressly provided under this License. Any attempt #
+# otherwise to copy, modify, sublicense or distribute the Program is #
+# void, and will automatically terminate your rights under this License. #
+# However, parties who have received copies, or rights, from you under #
+# this License will not have their licenses terminated so long as such #
+# parties remain in full compliance. #
+# #
+# 5. You are not required to accept this License, since you have not #
+# signed it. However, nothing else grants you permission to modify or #
+# distribute the Program or its derivative works. These actions are #
+# prohibited by law if you do not accept this License. Therefore, by #
+# modifying or distributing the Program (or any work based on the #
+# Program), you indicate your acceptance of this License to do so, and #
+# all its terms and conditions for copying, distributing or modifying #
+# the Program or works based on it. #
+# #
+# 6. Each time you redistribute the Program (or any work based on the #
+# Program), the recipient automatically receives a license from the #
+# original licensor to copy, distribute or modify the Program subject to #
+# these terms and conditions. You may not impose any further #
+# restrictions on the recipients' exercise of the rights granted herein. #
+# You are not responsible for enforcing compliance by third parties to #
+# this License. #
+# #
+# 7. If, as a consequence of a court judgment or allegation of patent #
+# infringement or for any other reason (not limited to patent issues), #
+# conditions are imposed on you (whether by court order, agreement or #
+# otherwise) that contradict the conditions of this License, they do not #
+# excuse you from the conditions of this License. If you cannot #
+# distribute so as to satisfy simultaneously your obligations under this #
+# License and any other pertinent obligations, then as a consequence you #
+# may not distribute the Program at all. For example, if a patent #
+# license would not permit royalty-free redistribution of the Program by #
+# all those who receive copies directly or indirectly through you, then #
+# the only way you could satisfy both it and this License would be to #
+# refrain entirely from distribution of the Program. #
+# #
+# If any portion of this section is held invalid or unenforceable under #
+# any particular circumstance, the balance of the section is intended to #
+# apply and the section as a whole is intended to apply in other #
+# circumstances. #
+# #
+# It is not the purpose of this section to induce you to infringe any #
+# patents or other property right claims or to contest validity of any #
+# such claims; this section has the sole purpose of protecting the #
+# integrity of the free software distribution system, which is #
+# implemented by public license practices. Many people have made #
+# generous contributions to the wide range of software distributed #
+# through that system in reliance on consistent application of that #
+# system; it is up to the author/donor to decide if he or she is willing #
+# to distribute software through any other system and a licensee cannot #
+# impose that choice. #
+# #
+# This section is intended to make thoroughly clear what is believed to #
+# be a consequence of the rest of this License. #
+# #
+# 8. If the distribution and/or use of the Program is restricted in #
+# certain countries either by patents or by copyrighted interfaces, the #
+# original copyright holder who places the Program under this License #
+# may add an explicit geographical distribution limitation excluding #
+# those countries, so that distribution is permitted only in or among #
+# countries not thus excluded. In such case, this License incorporates #
+# the limitation as if written in the body of this License. #
+# #
+# 9. The Free Software Foundation may publish revised and/or new versions #
+# of the General Public License from time to time. Such new versions will #
+# be similar in spirit to the present version, but may differ in detail to #
+# address new problems or concerns. #
+# #
+# Each version is given a distinguishing version number. If the Program #
+# specifies a version number of this License which applies to it and "any #
+# later version", you have the option of following the terms and conditions #
+# either of that version or of any later version published by the Free #
+# Software Foundation. If the Program does not specify a version number of #
+# this License, you may choose any version ever published by the Free Software #
+# Foundation. #
+# #
+# 10. If you wish to incorporate parts of the Program into other free #
+# programs whose distribution conditions are different, write to the author #
+# to ask for permission. For software which is copyrighted by the Free #
+# Software Foundation, write to the Free Software Foundation; we sometimes #
+# make exceptions for this. Our decision will be guided by the two goals #
+# of preserving the free status of all derivatives of our free software and #
+# of promoting the sharing and reuse of software generally. #
+# #
+# NO WARRANTY #
+# #
+# 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY #
+# FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN #
+# OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES #
+# PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED #
+# OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF #
+# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS #
+# TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE #
+# PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, #
+# REPAIR OR CORRECTION. #
+# #
+# 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING #
+# WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR #
+# REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, #
+# INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING #
+# OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED #
+# TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY #
+# YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER #
+# PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE #
+# POSSIBILITY OF SUCH DAMAGES. #
+# #
+# END OF TERMS AND CONDITIONS #
+# #
+# How to Apply These Terms to Your New Programs #
+# #
+# If you develop a new program, and you want it to be of the greatest #
+# possible use to the public, the best way to achieve this is to make it #
+# free software which everyone can redistribute and change under these terms. #
+# #
+# To do so, attach the following notices to the program. It is safest #
+# to attach them to the start of each source file to most effectively #
+# convey the exclusion of warranty; and each file should have at least #
+# the "copyright" line and a pointer to where the full notice is found. #
+# #
+# <one line to give the program's name and a brief idea of what it does.> #
+# Copyright (C) <year> <name of author> #
+# #
+# This program is free software; you can redistribute it and/or modify #
+# it under the terms of the GNU General Public License as published by #
+# the Free Software Foundation; either version 2 of the License, or #
+# (at your option) any later version. #
+# #
+# This program is distributed in the hope that it will be useful, #
+# but WITHOUT ANY WARRANTY; without even the implied warranty of #
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
+# GNU General Public License for more details. #
+# #
+# You should have received a copy of the GNU General Public License #
+# along with this program; if not, write to the Free Software #
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA #
+# #
+# #
+# Also add information on how to contact you by electronic and paper mail. #
+# #
+# If the program is interactive, make it output a short notice like this #
+# when it starts in an interactive mode: #
+# #
+# Gnomovision version 69, Copyright (C) year name of author #
+# Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. #
+# This is free software, and you are welcome to redistribute it #
+# under certain conditions; type `show c' for details. #
+# #
+# The hypothetical commands `show w' and `show c' should show the appropriate #
+# parts of the General Public License. Of course, the commands you use may #
+# be called something other than `show w' and `show c'; they could even be #
+# mouse-clicks or menu items--whatever suits your program. #
+# #
+# You should also get your employer (if you work as a programmer) or your #
+# school, if any, to sign a "copyright disclaimer" for the program, if #
+# necessary. Here is a sample; alter the names: #
+# #
+# Yoyodyne, Inc., hereby disclaims all copyright interest in the program #
+# `Gnomovision' (which makes passes at compilers) written by James Hacker. #
+# #
+# <signature of Ty Coon>, 1 April 1989 #
+# Ty Coon, President of Vice #
+# #
+# This General Public License does not permit incorporating your program into #
+# proprietary programs. If your program is a subroutine library, you may #
+# consider it more useful to permit linking proprietary applications with the #
+# library. If this is what you want to do, use the GNU Library General #
+# Public License instead of this License. #
+#################################################################################