Changeset View
Changeset View
Standalone View
Standalone View
sbin/md5/md5.1
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.Dd October 17, 2015 | .Dd April 22, 2016 | ||||
.Dt MD5 1 | .Dt MD5 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm md5 , sha1 , sha256 , sha384 , sha512, rmd160 | .Nm md5 , sha1 , sha256 , sha384 , sha512, sha512t256, rmd160 | ||||
.Nd calculate a message-digest fingerprint (checksum) for a file | .Nd calculate a message-digest fingerprint (checksum) for a file | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm md5 | .Nm md5 | ||||
.Op Fl pqrtx | .Op Fl pqrtx | ||||
.Op Fl c Ar string | .Op Fl c Ar string | ||||
.Op Fl s Ar string | .Op Fl s Ar string | ||||
.Op Ar | .Op Ar | ||||
.Nm sha1 | .Nm sha1 | ||||
Show All 11 Lines | |||||
.Op Fl c Ar string | .Op Fl c Ar string | ||||
.Op Fl s Ar string | .Op Fl s Ar string | ||||
.Op Ar | .Op Ar | ||||
.Nm sha512 | .Nm sha512 | ||||
.Op Fl pqrtx | .Op Fl pqrtx | ||||
.Op Fl c Ar string | .Op Fl c Ar string | ||||
.Op Fl s Ar string | .Op Fl s Ar string | ||||
.Op Ar | .Op Ar | ||||
.Nm sha512t256 | |||||
.Op Fl pqrtx | |||||
.Op Fl c Ar string | |||||
.Op Fl s Ar string | |||||
.Op Ar | |||||
.Nm rmd160 | .Nm rmd160 | ||||
.Op Fl pqrtx | .Op Fl pqrtx | ||||
.Op Fl c Ar string | .Op Fl c Ar string | ||||
.Op Fl s Ar string | .Op Fl s Ar string | ||||
.Op Ar | .Op Ar | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm md5 , sha1 , sha256 , sha384 , sha512 | .Nm md5 , sha1 , sha256 , sha384 , sha512, sha512t256 | ||||
and | and | ||||
.Nm rmd160 | .Nm rmd160 | ||||
utilities take as input a message of arbitrary length and produce as | utilities take as input a message of arbitrary length and produce as | ||||
output a | output a | ||||
.Dq fingerprint | .Dq fingerprint | ||||
or | or | ||||
.Dq message digest | .Dq message digest | ||||
of the input. | of the input. | ||||
Show All 23 Lines | |||||
MD5, i.e., to find an input given a hash value. | MD5, i.e., to find an input given a hash value. | ||||
.Pp | .Pp | ||||
.Tn SHA-1 | .Tn SHA-1 | ||||
currently (2014-05-17) has no known collisions, but an attack has been | currently (2014-05-17) has no known collisions, but an attack has been | ||||
found which is faster than a brute-force search, placing the security of | found which is faster than a brute-force search, placing the security of | ||||
.Tn SHA-1 | .Tn SHA-1 | ||||
in doubt. | in doubt. | ||||
.Pp | .Pp | ||||
It is recommended that all new applications use | .Tn SHA-512t256 | ||||
is a version of | |||||
bcr: I this think should be "a version". | |||||
.Tn SHA-512 | |||||
truncated to only 256 bits. | |||||
On 64-bit hardware, this algorithm is approximately 50% faster than | |||||
.Tn SHA-256 | .Tn SHA-256 | ||||
but with the same level of security. | |||||
The hashes are not interchangeable. | |||||
.Pp | |||||
It is recommended that all new applications use | |||||
.Tn SHA-512 | |||||
instead of one of the other hash functions. | instead of one of the other hash functions. | ||||
.Pp | .Pp | ||||
The following options may be used in any combination and must | The following options may be used in any combination and must | ||||
precede any files named on the command line. | precede any files named on the command line. | ||||
The hexadecimal checksum of each file listed on the command line is printed | The hexadecimal checksum of each file listed on the command line is printed | ||||
after the options are processed. | after the options are processed. | ||||
.Bl -tag -width indent | .Bl -tag -width indent | ||||
.It Fl c Ar string | .It Fl c Ar string | ||||
Show All 18 Lines | |||||
options. | options. | ||||
.It Fl t | .It Fl t | ||||
Run a built-in time trial. | Run a built-in time trial. | ||||
.It Fl x | .It Fl x | ||||
Run a built-in test script. | Run a built-in test script. | ||||
.El | .El | ||||
.Sh EXIT STATUS | .Sh EXIT STATUS | ||||
The | The | ||||
.Nm md5 , sha1 , sha256 , sha512 | .Nm md5 , sha1 , sha256 , sha512, sha512t256 | ||||
and | and | ||||
.Nm rmd160 | .Nm rmd160 | ||||
utilities exit 0 on success, | utilities exit 0 on success, | ||||
1 if at least one of the input files could not be read, | 1 if at least one of the input files could not be read, | ||||
and 2 if at least one file does not have the same hash as the | and 2 if at least one file does not have the same hash as the | ||||
.Fl c | .Fl c | ||||
option. | option. | ||||
.Sh SEE ALSO | .Sh SEE ALSO | ||||
Show All 38 Lines |
I this think should be "a version".