Man Linux: Main Page and Category List

NAME

       cookfp - calculate file fingerprint

SYNOPSIS

       cookfp [ option...  ][ filename...  ]
       cookfp -Help
       cookfp -VERSion

DESCRIPTION

       The  cookfp  program is used to calculate the fingerprints of files.  A
       fingerprint is  a  hash  of  the  contents  of  a  file.   The  default
       fingerprint  is  cryptographically  strong,  so  the probability of two
       different files having the same fingerprint is less than 1 in 2**200.

       The fingerprint is based on Dan  Berstien  <djb@silverton.berkeley.edu>
       public  domain  fingerprint  0.50  beta  package  930809, posted to the
       alt.sources newsgroup.  This program produces  identical  results;  the
       expected test results were generated using Dan’s package.

       The  fingerprint  is a base-64-sanely-encoded fingerprint of the input.
       Imagine this fingerprint  as  something  universal  and  permanent.   A
       fingerprint is 76 characters long, containing the following:

       1.  A  Snefru-8  (version 2.5, 8 passes, 512->256) hash.  (Derived from
           the Xerox Secure Hash Function.)

       2.  An MD5 hash, as  per  RFC  1321.   (Derived  from  the  RSADSI  MD5
           Message-Digest Algorithm.)

       3.  A CRC checksum, as in the new cksum utility.

       4.  Length modulo 2^40.

       The  output  format  is  not  expected  to be compatible with anything.
       However, options are available  to  produce  the  purported  output  of
       Merkle’s  snefru program, the purported output of RSADSI’s mddriver -x,
       or the purported output of the POSIX cksum program.

       If no files are named as input, the standard input will be  used.   The
       special file name ‘‘-’’ is understood to mean the standard input.

OPTIONS

       The following options are understood:

       -Checksum
               Print the CRC32 checksum and length of the named file(s).

       -Identifier
               Print   a  condensed  form  of  the  fingerprint  (obtained  by
               performing a CRC32 checksum on the full  fingerprint  described
               above  -  a definite overkill).  This is an 8-digit hexadecimal
               number, useful for generating unique short identifiers  out  of
               long  names.   The first character is forced to be a letter (g-
               p), so there is no problem in using the output  as  a  variable
               name.

       -Help
               Provide some help with using the cookfp program.

       -Message_Digest
               Print  the RSA Data Security, Inc. MD5 Message-Digest Algorithm
               hash of the named file(s).

       -Snefru Print the Snefru hash of the named file(s),  derived  from  the
               Xerox Secure Hash Function.

       -VERSion
               Print the version of the cookfp program being executed.

       All other options will produce a diagnostic error.

       All  options  may be abbreviated; the abbreviation is documented as the
       upper case letters, all lower case  letters  and  underscores  (_)  are
       optional.  You must use consecutive sequences of optional letters.

       All  options  are  case insensitive, you may type them in upper case or
       lower case or a combination of both, case is not important.

       For example: the arguments "-help", "-HEL" and "-h" are all interpreted
       to  mean the -Help option.  The argument "-hlp" will not be understood,
       because consecutive optional characters were not supplied.

       Options and other command line arguments may be  mixed  arbitrarily  on
       the command line.

       The  GNU  long option names are understood.  Since all option names for
       cookfp are long, this  means  ignoring  the  extra  leading  ’-’.   The
       "--option=value" convention is also understood.

EXIT STATUS

       The  cookfp  command  will  exit  with a status of 1 on any error.  The
       cookfp command will only exit with a  status  of  0  if  there  are  no
       errors.

COPYRIGHT

       cookfp version 2.33
       Copyright  (C)  1988,  1989,  1990, 1991, 1992, 1993, 1994, 1995, 1996,
       1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
       2009 Peter Miller

       The  cookfp  program comes with ABSOLUTELY NO WARRANTY; for details use
       the ’cookfp -VERSion License’ command.  This is free software  and  you
       are  welcome  to  redistribute it under certain conditions; for details
       use the ’cookfp -VERSion License’ command.

AUTHOR

       Peter Miller   E-Mail:   pmiller@opensource.org.au
       /\/\*             WWW:   http://miller.emu.id.au/pmiller/

       Portions of this program are derived from sources  from  other  people,
       sometimes  with liberal copyrights, and sometimes in the public domain.
       These include:

       Dan Bernstien
               See common/fp/README for details.

       Gary S Brown.
               See common/fp/crc32.c for details.

       RSA Data Security, Inc.
               See common/fp/md5.c for details.

       Xerox Corporation
               See common/fp/snefru.c for details.

       In addition to the above copyright holders, there  have  been  numerous
       authors and contributors, see the named files for details.  Files names
       are relative to the root of the cook distribution.