.\"	$OpenBSD: sha1.1,v 1.9 2001/06/03 17:51:29 millert Exp $
.\"
.Dd June 4, 2001
.Dt SHA1 1
.Os
.Sh NAME
.Nm sha1
.Nd calculate a message-digest fingerprint (checksum) for a file
.Sh SYNOPSIS
.Nm sha1
.Oo
.Fl p | Fl t | Fl x |
.Fl s Ar string | Ar file ...
.Oc
.Sh DESCRIPTION
.Nm
takes as input a message of arbitrary length and produces
as output a 160-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
message having a given prespecified target message digest.
.Pp
The
.Em SHA-1
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
.Em RSA .
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl s Ar string
Prints a checksum of the given
.Ar string .
.It Fl p
Echos stdin to stdout and appends the
.Em SHA-1
sum to stdout.
.It Fl t
Runs a built-in time trial.
.It Fl x
Runs a built-in test script.
.El
.Pp
The SHA-1
sum of each file listed on the command line is printed after the options
are processed.
.Sh SEE ALSO
.Xr cksum 1 ,
.Xr md5 1 ,
.Xr rmd160 1
.Pp
NIST FIPS PUB 180-1 describes the SHA-1 message-digest algorithm in detail.