aboutsummaryrefslogtreecommitdiff
path: root/sbin/md5/md5.1
diff options
context:
space:
mode:
authorJohn-Mark Gurney <jmg@FreeBSD.org>1997-03-02 21:43:10 +0000
committerJohn-Mark Gurney <jmg@FreeBSD.org>1997-03-02 21:43:10 +0000
commitf22592e7606b000a690e28eaa2addeb31b11f044 (patch)
tree9acf4cdbcc7daf2f2ad855089d56607913719f69 /sbin/md5/md5.1
parent6fa0fa0ec912693f9631bfef670373651d4c79ea (diff)
downloadsrc-f22592e7606b000a690e28eaa2addeb31b11f044.tar.gz
src-f22592e7606b000a690e28eaa2addeb31b11f044.zip
mdoc'ify man page
Notes
Notes: svn path=/head/; revision=23301
Diffstat (limited to 'sbin/md5/md5.1')
-rw-r--r--sbin/md5/md5.184
1 files changed, 49 insertions, 35 deletions
diff --git a/sbin/md5/md5.1 b/sbin/md5/md5.1
index 153054a89046..4a79abbacfae 100644
--- a/sbin/md5/md5.1
+++ b/sbin/md5/md5.1
@@ -1,46 +1,60 @@
-.TH MD5 1 "Feb 14, 1994"
-.SH NAME
-md5 \- calculate a message-digest fingerprint (checksum) for a file
-.SH SYNOPSIS
-.B md5
-[ -p | -t | -x | -sstring | filename(s) ]
-.SH DESCRIPTION
-.B md5
+.Dd Feburary 14, 1994
+.Dt MD5 1
+.Os
+.Sh NAME
+.Nm md5
+.Nd calculate a message-digest fingerprint (checksum) for a file
+.Sh SYNOPSIS
+.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
-as output a 128-bit "fingerprint" or "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
+as output a 128-bit
+.Dq fingerprint
+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.
The MD5 algorithm is intended for digital signature applications, where a
-large file must be "compressed" in a secure manner before being
-encrypted with a private (secret) key under a public-key cryptosystem
-such as
-.I RSA.
-.SH OPTIONS
+large file must be
+.Dq compressed
+in a secure manner before being encrypted with a private
+.Pq secret
+key under a public-key cryptosystem such as
+.Em RSA .
+.Pp
The following four options may be used in any combination, except
that
-.B "filename(s)"
+.Ar filename Ns Pq s
must be the last objects on the command line.
-.in +5
-.PP
-.B -sstring
-prints a checksum of the given "string".
-.PP
-.B -p
+.Bl -tag -width Fl
+.It Fl s Ns Ar string
+prints a checksum of the given
+.Dq string .
+.It Fl p
echos stdin to stdout and appends the MD5 sum to stdout.
-.PP
-.B -t
+.It Fl t
runs a built-in time trial.
-.PP
-.B -x
+.It Fl x
runs a built-in test script.
-.PP
-.B filename(s)
-prints a checksum(s) for each of the files.
-.SH "SEE ALSO"
-.BR cksum (1)
-.PP
-RFC 1321 describes in detail the MD2, MD4, and MD5 message-digest algorithms.
-.SH ACKNOWLEDGEMENTS
+.It Ar filename Ns Pq s
+prints a checksum
+.Pq s
+for each of the files.
+.El
+.Sh SEE ALSO
+.Xr cksum 1
+.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
RSA Data Security.