mdoc'ify man page

This commit is contained in:
jmg 1997-03-02 21:43:10 +00:00
parent 26bd0fe0b6
commit b6a02cdd45

View File

@ -1,46 +1,60 @@
.TH MD5 1 "Feb 14, 1994" .Dd Feburary 14, 1994
.SH NAME .Dt MD5 1
md5 \- calculate a message-digest fingerprint (checksum) for a file .Os
.SH SYNOPSIS .Sh NAME
.B md5 .Nm md5
[ -p | -t | -x | -sstring | filename(s) ] .Nd calculate a message-digest fingerprint (checksum) for a file
.SH DESCRIPTION .Sh SYNOPSIS
.B md5 .Nm
.Op Fl p
.Op Fl t
.Op Fl x
.Op Fl s Ns Ar string
.Op Ar filename Ns Pq s
.Sh DESCRIPTION
.Nm
takes as input a message of arbitrary length and produces takes as input a message of arbitrary length and produces
as output a 128-bit "fingerprint" or "message digest" of the input. as output a 128-bit
It is conjectured that it is computationally infeasible to produce .Dq fingerprint
two messages having the same message digest, or to produce any or
.Dq message digest
of the input. It is conjectured that it is computationally infeasible to
produce two messages having the same message digest, or to produce any
message having a given prespecified target message digest. message having a given prespecified target message digest.
The MD5 algorithm is intended for digital signature applications, where a The MD5 algorithm is intended for digital signature applications, where a
large file must be "compressed" in a secure manner before being large file must be
encrypted with a private (secret) key under a public-key cryptosystem .Dq compressed
such as in a secure manner before being encrypted with a private
.I RSA. .Pq secret
.SH OPTIONS key under a public-key cryptosystem such as
.Em RSA .
.Pp
The following four options may be used in any combination, except The following four options may be used in any combination, except
that that
.B "filename(s)" .Ar filename Ns Pq s
must be the last objects on the command line. must be the last objects on the command line.
.in +5 .Bl -tag -width Fl
.PP .It Fl s Ns Ar string
.B -sstring prints a checksum of the given
prints a checksum of the given "string". .Dq string .
.PP .It Fl p
.B -p
echos stdin to stdout and appends the MD5 sum to stdout. echos stdin to stdout and appends the MD5 sum to stdout.
.PP .It Fl t
.B -t
runs a built-in time trial. runs a built-in time trial.
.PP .It Fl x
.B -x
runs a built-in test script. runs a built-in test script.
.PP .It Ar filename Ns Pq s
.B filename(s) prints a checksum
prints a checksum(s) for each of the files. .Pq s
.SH "SEE ALSO" for each of the files.
.BR cksum (1) .El
.PP .Sh SEE ALSO
RFC 1321 describes in detail the MD2, MD4, and MD5 message-digest algorithms. .Xr cksum 1
.SH ACKNOWLEDGEMENTS .Rs
.%A R. Rivest
.%T The MD5 Message-Digest Algorithm
.%O RFC1321
.Re
.Sh ACKNOWLEDGEMENTS
This program is placed in the public domain for free general use by This program is placed in the public domain for free general use by
RSA Data Security. RSA Data Security.