From 11589f11fdd42e7f4be3fa3f5da184a99ed8889d Mon Sep 17 00:00:00 2001 From: jmc Date: Sun, 29 Dec 2013 21:19:11 +0000 Subject: [PATCH] update sha256(1) to better reflect that it documents sha512 now too. that led me to whack some unneccessary mark up and quoting (and phrasing), and the changes to the other pages are really just to unify the newer text layout; tedu provided feedback and answers (thanks); --- bin/md5/cksum.1 | 7 +++--- bin/md5/md5.1 | 47 ++++++++++++++++++++-------------------- bin/md5/sha1.1 | 43 +++++++++++++++---------------------- bin/md5/sha256.1 | 56 ++++++++++++++++++++++-------------------------- 4 files changed, 70 insertions(+), 83 deletions(-) diff --git a/bin/md5/cksum.1 b/bin/md5/cksum.1 index 57be36a801e..085af5f26eb 100644 --- a/bin/md5/cksum.1 +++ b/bin/md5/cksum.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: cksum.1,v 1.24 2013/04/15 15:54:17 millert Exp $ +.\" $OpenBSD: cksum.1,v 1.25 2013/12/29 21:19:11 jmc Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)cksum.1 8.2 (Berkeley) 4/28/95 .\" -.Dd $Mdocdate: April 15 2013 $ +.Dd $Mdocdate: December 29 2013 $ .Dt CKSUM 1 .Os .Sh NAME @@ -269,7 +269,8 @@ The .Nm cksum and .Nm sum -utilities exit 0 on success or \*(Gt0 if an error occurred. +utilities exit 0 on success, +and >0 if an error occurs. .Sh SEE ALSO .Xr md5 1 , .Xr sha1 1 , diff --git a/bin/md5/md5.1 b/bin/md5/md5.1 index ec728216ac0..a0596d009b8 100644 --- a/bin/md5/md5.1 +++ b/bin/md5/md5.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: md5.1,v 1.33 2012/09/22 20:09:43 jmc Exp $ +.\" $OpenBSD: md5.1,v 1.34 2013/12/29 21:19:11 jmc Exp $ .\" .\" Copyright (c) 2003, 2004, 2006 Todd C. Miller .\" @@ -18,12 +18,12 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.Dd $Mdocdate: September 22 2012 $ +.Dd $Mdocdate: December 29 2013 $ .Dt MD5 1 .Os .Sh NAME .Nm md5 -.Nd calculate a message-digest fingerprint (checksum) for a file +.Nd calculate a message digest (checksum) for a file .Sh SYNOPSIS .Nm md5 .Op Fl bpqrtx @@ -33,32 +33,25 @@ .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 was conjectured that it would be computationally infeasible to produce -two messages having the same message digest (a collision), or to produce any -message having a given prespecified target message digest. -However, collisions have now been produced for -.Em MD5 , +as output a 128-bit message digest (checksum) of the input. +It is conjectured that it is computationally infeasible to produce +two messages having the same message digest (a collision), +or to produce any message having a given prespecified target message digest. +However, collisions have now been produced for MD5, so the use of other message digest functions, such as .Xr sha256 1 , is now preferred. .Pp -The -.Em 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 -.Em RSA . +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 RSA. .Pp The options are as follows: .Bl -tag -width Ds .It Fl b Output checksums in base64 notation, not hexadecimal. -.It Xo -.Fl c -.Op Ar checklist ... -.Xc +.It Fl c Op Ar checklist ... Compares all checksums contained in the file .Ar checklist with newly computed checksums for the corresponding files. @@ -69,8 +62,7 @@ This will validate any of the supported checksums (see If no file is given, stdin is used. .It Fl p Echoes stdin to stdout and appends the -.Em MD5 -sum to stdout. +checksum to stdout. .It Fl q Only print the checksum (quiet mode). .It Fl r @@ -90,8 +82,15 @@ by 10 for each additional flag. Runs a built-in test script. .El .Pp -The MD5 sum of each file listed on the command line is printed after the -options are processed. +The checksum of each file listed on the command line is printed +after the options are processed. +.Pp +The +.Nm +command is shorthand for: +.Bd -literal -offset indent +$ cksum -a md5 +.Ed .Sh EXIT STATUS .Ex -std md5 .Sh SEE ALSO diff --git a/bin/md5/sha1.1 b/bin/md5/sha1.1 index 5829888de8b..d2d4fd0a7c4 100644 --- a/bin/md5/sha1.1 +++ b/bin/md5/sha1.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sha1.1,v 1.31 2012/09/22 20:09:43 jmc Exp $ +.\" $OpenBSD: sha1.1,v 1.32 2013/12/29 21:19:11 jmc Exp $ .\" .\" Copyright (c) 2003, 2004, 2006 Todd C. Miller .\" @@ -18,12 +18,12 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.Dd $Mdocdate: September 22 2012 $ +.Dd $Mdocdate: December 29 2013 $ .Dt SHA1 1 .Os .Sh NAME .Nm sha1 -.Nd calculate a message-digest fingerprint (checksum) for a file +.Nd calculate a message digest (checksum) for a file .Sh SYNOPSIS .Nm sha1 .Op Fl bpqrtx @@ -33,33 +33,26 @@ .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. +as output a 160-bit message digest (checksum) of the input. It is conjectured that it is computationally infeasible to produce -two messages having the same message digest (a collision), or to produce any -message having a given prespecified target message digest. +two messages having the same message digest (a collision), +or to produce any message having a given prespecified target message digest. However, researchers have developed theoretical attacks that significantly -reduce the amount of time needed to find a collision in -.Em SHA-1 . +reduce the amount of time needed to find a collision in SHA-1. The use of other message digest functions, such as .Xr sha256 1 , is now preferred. .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 . +The 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 RSA. .Pp The options are as follows: .Bl -tag -width Ds .It Fl b Output checksums in base64 notation, not hexadecimal. -.It Xo -.Fl c -.Op Ar checklist ... -.Xc +.It Fl c Op Ar checklist ... Compares all checksums contained in the file .Ar checklist with newly computed checksums for the corresponding files. @@ -70,8 +63,7 @@ This will validate any of the supported checksums (see If no file is given, stdin is used. .It Fl p Echoes stdin to stdout and appends the -.Em SHA-1 -sum to stdout. +checksum to stdout. .It Fl q Only print the checksum (quiet mode). .It Fl r @@ -91,15 +83,14 @@ by 10 for each additional flag. 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. +The checksum of each file listed on the command line is printed +after the options are processed. .Pp The .Nm -command is shorthand for +command is shorthand for: .Bd -literal -offset indent -cksum -a sha1 +$ cksum -a sha1 .Ed .Pp The diff --git a/bin/md5/sha256.1 b/bin/md5/sha256.1 index 937766d787b..8a8549e0e8f 100644 --- a/bin/md5/sha256.1 +++ b/bin/md5/sha256.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: sha256.1,v 1.6 2013/12/23 23:00:38 tedu Exp $ +.\" $OpenBSD: sha256.1,v 1.7 2013/12/29 21:19:11 jmc Exp $ .\" .\" Copyright (c) 2003, 2004, 2006 Todd C. Miller .\" @@ -18,12 +18,13 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.Dd $Mdocdate: December 23 2013 $ +.Dd $Mdocdate: December 29 2013 $ .Dt SHA256 1 .Os .Sh NAME -.Nm sha256 -.Nd calculate a message-digest fingerprint (checksum) for a file +.Nm sha256 , +.Nm sha512 +.Nd calculate a message digest (checksum) for a file .Sh SYNOPSIS .Nm sha256 .Op Fl bpqrtx @@ -38,33 +39,25 @@ .Sh DESCRIPTION .Nm takes as input a message of arbitrary length and produces -as output a 256-bit "fingerprint" or "message digest" of the input. +as output a 256-bit message digest (checksum) 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-256 -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 . +two messages having the same message digest (a collision), +or to produce any message having a given prespecified target message digest. .Pp When invoked as .Nm sha512 , -the -.Em SHA-512 -algorithm is used instead, generating a 512-bit digest. +the SHA-512 algorithm is used instead, generating a 512-bit digest. +.Pp +These algorithms are 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 RSA. .Pp The options are as follows: .Bl -tag -width Ds .It Fl b Output checksums in base64 notation, not hexadecimal. -.It Xo -.Fl c -.Op Ar checklist ... -.Xc +.It Fl c Op Ar checklist ... Compares all checksums contained in the file .Ar checklist with newly computed checksums for the corresponding files. @@ -75,8 +68,7 @@ This will validate any of the supported checksums (see If no file is given, stdin is used. .It Fl p Echoes stdin to stdout and appends the -.Em SHA-256 -sum to stdout. +checksum to stdout. .It Fl q Only print the checksum (quiet mode). .It Fl r @@ -96,18 +88,22 @@ by 10 for each additional flag. Runs a built-in test script. .El .Pp -The SHA-256 -sum of each file listed on the command line is printed after the options -are processed. +The checksum of each file listed on the command line is printed +after the options are processed. .Pp The .Nm -command is shorthand for +command is shorthand for: .Bd -literal -offset indent -cksum -a sha256 +$ cksum -a sha256 .Ed .Sh EXIT STATUS -.Ex -std sha256 +The +.Nm sha256 +and +.Nm sha512 +utilities exit 0 on success, +and >0 if an error occurs. .Sh SEE ALSO .Xr cksum 1 , .Xr md5 1 , -- 2.20.1