sbin/md5/md5.1

   1 .\" $FreeBSD$
   2 .Dd May 17, 2014
   3 .Dt MD5 1
   4 .Os
   5 .Sh NAME
   6 .Nm md5 , sha1 , sha256 , sha512, rmd160
   7 .Nd calculate a message-digest fingerprint (checksum) for a file
   8 .Sh SYNOPSIS
   9 .Nm md5
  10 .Op Fl pqrtx
  11 .Op Fl c Ar string
  12 .Op Fl s Ar string
  13 .Op Ar
  14 .Nm sha1
  15 .Op Fl pqrtx
  16 .Op Fl c Ar string
  17 .Op Fl s Ar string
  18 .Op Ar
  19 .Nm sha256
  20 .Op Fl pqrtx
  21 .Op Fl c Ar string
  22 .Op Fl s Ar string
  23 .Op Ar
  24 .Nm sha512
  25 .Op Fl pqrtx
  26 .Op Fl c Ar string
  27 .Op Fl s Ar string
  28 .Op Ar
  29 .Nm rmd160
  30 .Op Fl pqrtx
  31 .Op Fl c Ar string
  32 .Op Fl s Ar string
  33 .Op Ar
  34 .Sh DESCRIPTION
  35 The
  36 .Nm md5 , sha1 , sha256 , sha512
  37 and
  38 .Nm rmd160
  39 utilities take as input a message of arbitrary length and produce as
  40 output a
  41 .Dq fingerprint
  42 or
  43 .Dq message digest
  44 of the input.
  45 It is conjectured that it is computationally infeasible to
  46 produce two messages having the same message digest, or to produce any
  47 message having a given prespecified target message digest.
  48 The
  49 .Tn MD5 , SHA-1 , SHA-256 , SHA-512
  50 and
  51 .Tn RIPEMD-160
  52 algorithms are intended for digital signature applications, where a
  53 large file must be
  54 .Dq compressed
  55 in a secure manner before being encrypted with a private
  56 (secret)
  57 key under a public-key cryptosystem such as
  58 .Tn RSA .
  59 .Pp
  60 .Tn MD5
  61 has been completely broken as far as finding collisions is
  62 concerned, and should not be relied upon to produce unique outputs.
  63 This also means that
  64 .Tn MD5
  65 should not be used as part of a cryptographic signature scheme.
  66 At the current time (2014-05-17) there is no publicly known method to
  67 .Dq reverse
  68 MD5, i.e., to find an input given a hash value.
  69 .Pp
  70 .Tn SHA-1
  71 currently (2014-05-17) has no known collisions, but an attack has been
  72 found which is faster than a brute-force search, placing the security of
  73 .Tn SHA-1
  74 in doubt.
  75 .Pp
  76 It is recommended that all new applications use
  77 .Tn SHA-256
  78 instead of one of the other hash functions.
  79 .Pp
  80 The following options may be used in any combination and must
  81 precede any files named on the command line.
  82 The hexadecimal checksum of each file listed on the command line is printed
  83 after the options are processed.
  84 .Bl -tag -width indent
  85 .It Fl c Ar string
  86 Compare the digest of the file against this string.
  87 .Pq Note that this option is not yet useful if multiple files are specified.
  88 .It Fl s Ar string
  89 Print a checksum of the given
  90 .Ar string .
  91 .It Fl p
  92 Echo stdin to stdout and append the checksum to stdout.
  93 .It Fl q
  94 Quiet mode \(em only the checksum is printed out.
  95 Overrides the
  96 .Fl r
  97 option.
  98 .It Fl r
  99 Reverses the format of the output.
 100 This helps with visual diffs.
 101 Does nothing
 102 when combined with the
 103 .Fl ptx
 104 options.
 105 .It Fl t
 106 Run a built-in time trial.
 107 .It Fl x
 108 Run a built-in test script.
 109 .El
 110 .Sh EXIT STATUS
 111 The
 112 .Nm md5 , sha1 , sha256 , sha512
 113 and
 114 .Nm rmd160
 115 utilities exit 0 on success,
 116 1 if at least one of the input files could not be read,
 117 and 2 if at least one file does not have the same hash as the
 118 .Fl c
 119 option.
 120 .Sh SEE ALSO
 121 .Xr cksum 1 ,
 122 .Xr md5 3 ,
 123 .Xr ripemd 3 ,
 124 .Xr sha 3 ,
 125 .Xr sha256 3 ,
 126 .Xr sha512 3
 127 .Rs
 128 .%A R. Rivest
 129 .%T The MD5 Message-Digest Algorithm
 130 .%O RFC1321
 131 .Re
 132 .Rs
 133 .%A J. Burrows
 134 .%T The Secure Hash Standard
 135 .%O FIPS PUB 180-2
 136 .Re
 137 .Rs
 138 .%A D. Eastlake and P. Jones
 139 .%T US Secure Hash Algorithm 1
 140 .%O RFC 3174
 141 .Re
 142 .Pp
 143 RIPEMD-160 is part of the ISO draft standard
 144 .Qq ISO/IEC DIS 10118-3
 145 on dedicated hash functions.
 146 .Pp
 147 Secure Hash Standard (SHS):
 148 .Pa http://csrc.nist.gov/cryptval/shs.html .
 149 .Pp
 150 The RIPEMD-160 page:
 151 .Pa http://www.esat.kuleuven.ac.be/~bosselae/ripemd160.html .
 152 .Sh ACKNOWLEDGMENTS
 153 This program is placed in the public domain for free general use by
 154 RSA Data Security.
 155 .Pp
 156 Support for SHA-1 and RIPEMD-160 has been added by
 157 .An Oliver Eikemeier Aq Mt eik@FreeBSD.org .