=head1	NAME

chksize - File size checker.

=head1	SYNOPSYS

  chksize <options> <files>
  chksize -c <options> <files>

=head1	DESCRIPTION

The chksize program can create a file size list (build mode)
or compare file sizes against a file size list (check mode).

=head1	OPTIONS

=over 6

=item	B<-h>

prints a short help text.

Long option: --help

=item	B<-v>

prints version information.

Long option: --version

=item	B<-l>

The specified files (or standard input) are lists of file names
to inspect.

=item	B<-c>

switches to check mode. File names specified on the command line
are files containing file size lists produced previously by
chksize.

Long option: --check

=item	B<-q>

suppresses information messages about succeeded tests
in check mode.

Long option: --quiet

=item	B<-s>

suppresses messages about succeeded or failed tests
in check mode, the exit status is set only.

Long option: --status

=back

=head1	RETURN VALUE

The program uses the following exit status codes:

=over 6

=item	* 0 Success.

=item	* 1 At least one size mismatch was detected.

=item	* 2 Wrong option or syntax error in check list.

=item	* 3 Attempt to handle a directory.

=item	* 4 Illegal file type.

=item	* 5 The stat() or stat64() function failed for a file.

=back

=head1	SEE ALSO

http://dktools.sourceforge.net/fchksum.html

=head1	AUTHOR

Dirk Krause

=head1	COPYRIGHT AND LICENSE

Copyright (C) - 2009, Dirk Krause
All rights resrved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

 * Redistributions of source code must retain the above
   copyright notice, this list of conditions and the
   following disclaimer.

 * Redistributions in binary form must reproduce the above
   copyright notice, this list of conditions and the following
   disclaimer in the documentation and/or other materials
   provided with the distribution.

 * Neither the name of the Dirk Krause nor the names of
   contributors may be used to endorse or promote products
   derived from this software without specific prior written
   permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

=head1	HISTORY

2009-02-08: First version finished, tested on Solaris and Linux.

