sbin/md5/md5.1

   1 .\" $FreeBSD$
   2 .Dd February 14, 1994
   3 .Dt MD5 1
   4 .Os
   5 .Sh NAME
   6 .Nm md5
   7 .Nd calculate a message-digest fingerprint (checksum) for a file
   8 .Sh SYNOPSIS
   9 .Nm
  10 .Op Fl pqrtx
  11 .Op Fl s Ar string
  12 .Op Ar
  13 .Sh DESCRIPTION
  14 .Nm Md5
  15 takes as input a message of arbitrary length and produces
  16 as output a 128-bit
  17 .Dq fingerprint
  18 or
  19 .Dq message digest
  20 of the input.
  21 It is conjectured that it is computationally infeasible to
  22 produce two messages having the same message digest, or to produce any
  23 message having a given prespecified target message digest.
  24 The MD5 algorithm is intended for digital signature applications, where a
  25 large file must be
  26 .Dq compressed
  27 in a secure manner before being encrypted with a private
  28 (secret)
  29 key under a public-key cryptosystem such as
  30 .Em RSA .
  31 .Pp
  32 MD5 has not yet (2001-09-03) been broken, but sufficient attacks have been
  33 made that its security is in some doubt.
  34 The attacks on MD5
  35 are in the nature of finding
  36 .Dq collisions
  37 \(em that is, multiple
  38 inputs which hash to the same value; it is still unlikely for an attacker
  39 to be able to determine the exact original input given a hash value.
  40 .Pp
  41 The following options may be used in any combination and must
  42 precede any files named on the command line.
  43 The MD5
  44 sum of each file listed on the command line is printed after the options
  45 are processed.
  46 .Bl -tag -width indent
  47 .It Fl s Ar string
  48 Print a checksum of the given
  49 .Ar string .
  50 .It Fl p
  51 Echo stdin to stdout and appends the MD5 sum to stdout.
  52 .It Fl q
  53 Quiet mode - only the MD5 sum is printed out.
  54 Overrides the
  55 .Fl r
  56 option.
  57 .It Fl r
  58 Reverses the format of the output.
  59 This helps with visual diffs.
  60 Does nothing
  61 when combined with the
  62 .Fl ptx
  63 options.
  64 .It Fl t
  65 Run a built-in time trial.
  66 .It Fl x
  67 Run a built-in test script.
  68 .El
  69 .Sh SEE ALSO
  70 .Xr cksum 1
  71 .Rs
  72 .%A R. Rivest
  73 .%T The MD5 Message-Digest Algorithm
  74 .%O RFC1321
  75 .Re
  76 .Sh ACKNOWLEDGMENTS
  77 This program is placed in the public domain for free general use by
  78 RSA Data Security.