cksum: better describe the -c (checklist) option

The -c option can handle entries in normal (BSD) and reverse (GNU)
format. Both hex and base64 entries are supported. OK jmc@

use imperative tense consistently; OK jmc

change some 4.4BSD references to earlier releases
ok schwarze@

add sha512/256 support to check that the libc code is right :)

missed a turd

purge sum and sysvsum code. ok deraadt jmc lteo millert
a few initial leftovers spotted by naddy

remove insecure MD4 checksum algorithm; ok tedu@, man page ok jmc@

"A collision attack published in 2007 can find collisions for full
MD4 in less than two hash operations."

use Ex;

When using the -C option, exit with an exit status of 1 if any of the
files specified on the command line do not exist in the checklist.

ok deraadt@ tedu@

Add MISSING to the list of possible results of a checklist comparison
(md5.1 already has this).

bump the year for ISO/IEC 8802:3 from 1989 to 1996;
ingo recommends not defining a new St macro for every revision here

ok sobrado schwarze

Do not use .Ar for fixed strings, it is intended for argument placeholders.
We could switch to .Cm, but jmc@ thinks that just removing the markup
from the algorith names is better in this case. Otherwise, the
total amount of markup could be considered excessive.

The strings "1" and "2" are not placeholders for arguments,
but have to be given verbatim on the command line, so use .Cm.
Found while testing mandocdb(8), ok jmc@.

add -C to the man page, and adjust usage();
ok lteo

catch up to the fact that md5/sha* got merged, and document -c consistently;
some style and cleanup tweaks while here

ok deraadt

sort options;

Add support for -h hashfile. This is very useful with with -p, in a pipeline,
to deliver the hash output to a different location.
ok millert

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);

SHA-224 is to SHA-256 as SHA-384 is to SHA-512. It was added in a
later revision of FIPS-180. OK miod@ jmc@ guenther@ djm@

more EXIT STATUS bits; from Daniel Dickman

replace rmd160 links with sha256. it's way more popular and more better, too.
too many oks to enumerate.
while here, add Xr to the relevant libc functions in each page.

dispense with some wacky escape sequences;

replace ".Ar file ..." with ".Ar" whenever possible.

ok jmc@

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

md5(1), sha1(1), rmd160(1), cksum(1) and sum(1) have different options;
while here, some KNF improvements.

based on a diff for compress(1) written by millert@,
fixes from guenther@ and pyr@.

ok millert@, pyr@; (for the manual page tweaks) jmc@

convert to new .Dd format;

some i missed...
- consistent text for STANDARDS
- note which options are extensions to POSIX

allow multiple -t to increase the test count. cpus are getting too fast.
ok grunk. with manpage from grunk and jmc

Add base64 support to cksum and friends. Output encoding can
be set globally or on a per-algorithm basis when using multiple
hash functions. OK espie@ simon@ deraadt@; man help from jmc@

augment the -q option, now if specifed with -c (checklist)
it will only print out the failed cases.

OK millert@

Add md5 to the list of unsecure checksums. Adapted from a diff by
Tamas TEVESZ.

WARNING/BUGS -> CAVEATS; ok millert

`<' -> \*(Lt

discourage .Tn;

.Ex these pages; ok millert

simplify synopsis and usage(); ok millert

Add -r and -q options similar to what is supported by FreeBSD's md5
OK deraadt@ ckuethe@

more macro simplification;

avoid specifying which hash to use;
this after some discussion w/ otto;

started by pr #4120, from andy isaacson;

Add support for multiple using algorithms. OK'd by several people
a while ago so get this out of my tree...

- simplify synopses
- correct macros
- various grammatical fixes

ok millert@

Add support for cksum (3 varieties), md4, sha256, sha384, and sha512.
Consequently, cksum moves becomes a link to md5 and moves to /bin.
The cksum man page could use some polishing.

use imperative tense consistently; OK jmc

change some 4.4BSD references to earlier releases
ok schwarze@

add sha512/256 support to check that the libc code is right :)

missed a turd

purge sum and sysvsum code. ok deraadt jmc lteo millert
a few initial leftovers spotted by naddy

remove insecure MD4 checksum algorithm; ok tedu@, man page ok jmc@

"A collision attack published in 2007 can find collisions for full
MD4 in less than two hash operations."

use Ex;

When using the -C option, exit with an exit status of 1 if any of the
files specified on the command line do not exist in the checklist.

ok deraadt@ tedu@

Add MISSING to the list of possible results of a checklist comparison
(md5.1 already has this).

bump the year for ISO/IEC 8802:3 from 1989 to 1996;
ingo recommends not defining a new St macro for every revision here

ok sobrado schwarze

Do not use .Ar for fixed strings, it is intended for argument placeholders.
We could switch to .Cm, but jmc@ thinks that just removing the markup
from the algorith names is better in this case. Otherwise, the
total amount of markup could be considered excessive.

The strings "1" and "2" are not placeholders for arguments,
but have to be given verbatim on the command line, so use .Cm.
Found while testing mandocdb(8), ok jmc@.

add -C to the man page, and adjust usage();
ok lteo

catch up to the fact that md5/sha* got merged, and document -c consistently;
some style and cleanup tweaks while here

ok deraadt

sort options;

Add support for -h hashfile. This is very useful with with -p, in a pipeline,
to deliver the hash output to a different location.
ok millert

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);

SHA-224 is to SHA-256 as SHA-384 is to SHA-512. It was added in a
later revision of FIPS-180. OK miod@ jmc@ guenther@ djm@

more EXIT STATUS bits; from Daniel Dickman

replace rmd160 links with sha256. it's way more popular and more better, too.
too many oks to enumerate.
while here, add Xr to the relevant libc functions in each page.

dispense with some wacky escape sequences;

replace ".Ar file ..." with ".Ar" whenever possible.

ok jmc@

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

md5(1), sha1(1), rmd160(1), cksum(1) and sum(1) have different options;
while here, some KNF improvements.

based on a diff for compress(1) written by millert@,
fixes from guenther@ and pyr@.

ok millert@, pyr@; (for the manual page tweaks) jmc@

convert to new .Dd format;

some i missed...
- consistent text for STANDARDS
- note which options are extensions to POSIX

allow multiple -t to increase the test count. cpus are getting too fast.
ok grunk. with manpage from grunk and jmc

Add base64 support to cksum and friends. Output encoding can
be set globally or on a per-algorithm basis when using multiple
hash functions. OK espie@ simon@ deraadt@; man help from jmc@

augment the -q option, now if specifed with -c (checklist)
it will only print out the failed cases.

OK millert@

Add md5 to the list of unsecure checksums. Adapted from a diff by
Tamas TEVESZ.

WARNING/BUGS -> CAVEATS; ok millert

`<' -> \*(Lt

discourage .Tn;

.Ex these pages; ok millert

simplify synopsis and usage(); ok millert

Add -r and -q options similar to what is supported by FreeBSD's md5
OK deraadt@ ckuethe@

more macro simplification;

avoid specifying which hash to use;
this after some discussion w/ otto;

started by pr #4120, from andy isaacson;

Add support for multiple using algorithms. OK'd by several people
a while ago so get this out of my tree...

- simplify synopses
- correct macros
- various grammatical fixes

ok millert@

Add support for cksum (3 varieties), md4, sha256, sha384, and sha512.
Consequently, cksum moves becomes a link to md5 and moves to /bin.
The cksum man page could use some polishing.

change some 4.4BSD references to earlier releases
ok schwarze@

add sha512/256 support to check that the libc code is right :)

missed a turd

purge sum and sysvsum code. ok deraadt jmc lteo millert
a few initial leftovers spotted by naddy

remove insecure MD4 checksum algorithm; ok tedu@, man page ok jmc@

"A collision attack published in 2007 can find collisions for full
MD4 in less than two hash operations."

use Ex;

When using the -C option, exit with an exit status of 1 if any of the
files specified on the command line do not exist in the checklist.

ok deraadt@ tedu@

Add MISSING to the list of possible results of a checklist comparison
(md5.1 already has this).

bump the year for ISO/IEC 8802:3 from 1989 to 1996;
ingo recommends not defining a new St macro for every revision here

ok sobrado schwarze

Do not use .Ar for fixed strings, it is intended for argument placeholders.
We could switch to .Cm, but jmc@ thinks that just removing the markup
from the algorith names is better in this case. Otherwise, the
total amount of markup could be considered excessive.

The strings "1" and "2" are not placeholders for arguments,
but have to be given verbatim on the command line, so use .Cm.
Found while testing mandocdb(8), ok jmc@.

add -C to the man page, and adjust usage();
ok lteo

catch up to the fact that md5/sha* got merged, and document -c consistently;
some style and cleanup tweaks while here

ok deraadt

sort options;

Add support for -h hashfile. This is very useful with with -p, in a pipeline,
to deliver the hash output to a different location.
ok millert

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);

SHA-224 is to SHA-256 as SHA-384 is to SHA-512. It was added in a
later revision of FIPS-180. OK miod@ jmc@ guenther@ djm@

more EXIT STATUS bits; from Daniel Dickman

replace rmd160 links with sha256. it's way more popular and more better, too.
too many oks to enumerate.
while here, add Xr to the relevant libc functions in each page.

dispense with some wacky escape sequences;

replace ".Ar file ..." with ".Ar" whenever possible.

ok jmc@

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

md5(1), sha1(1), rmd160(1), cksum(1) and sum(1) have different options;
while here, some KNF improvements.

based on a diff for compress(1) written by millert@,
fixes from guenther@ and pyr@.

ok millert@, pyr@; (for the manual page tweaks) jmc@

convert to new .Dd format;

some i missed...
- consistent text for STANDARDS
- note which options are extensions to POSIX

allow multiple -t to increase the test count. cpus are getting too fast.
ok grunk. with manpage from grunk and jmc

Add base64 support to cksum and friends. Output encoding can
be set globally or on a per-algorithm basis when using multiple
hash functions. OK espie@ simon@ deraadt@; man help from jmc@

augment the -q option, now if specifed with -c (checklist)
it will only print out the failed cases.

OK millert@

Add md5 to the list of unsecure checksums. Adapted from a diff by
Tamas TEVESZ.

WARNING/BUGS -> CAVEATS; ok millert

`<' -> \*(Lt

discourage .Tn;

.Ex these pages; ok millert

simplify synopsis and usage(); ok millert

Add -r and -q options similar to what is supported by FreeBSD's md5
OK deraadt@ ckuethe@

more macro simplification;

avoid specifying which hash to use;
this after some discussion w/ otto;

started by pr #4120, from andy isaacson;

Add support for multiple using algorithms. OK'd by several people
a while ago so get this out of my tree...

- simplify synopses
- correct macros
- various grammatical fixes

ok millert@

Add support for cksum (3 varieties), md4, sha256, sha384, and sha512.
Consequently, cksum moves becomes a link to md5 and moves to /bin.
The cksum man page could use some polishing.

add sha512/256 support to check that the libc code is right :)

missed a turd

purge sum and sysvsum code. ok deraadt jmc lteo millert
a few initial leftovers spotted by naddy

remove insecure MD4 checksum algorithm; ok tedu@, man page ok jmc@

"A collision attack published in 2007 can find collisions for full
MD4 in less than two hash operations."

use Ex;

When using the -C option, exit with an exit status of 1 if any of the
files specified on the command line do not exist in the checklist.

ok deraadt@ tedu@

Add MISSING to the list of possible results of a checklist comparison
(md5.1 already has this).

bump the year for ISO/IEC 8802:3 from 1989 to 1996;
ingo recommends not defining a new St macro for every revision here

ok sobrado schwarze

Do not use .Ar for fixed strings, it is intended for argument placeholders.
We could switch to .Cm, but jmc@ thinks that just removing the markup
from the algorith names is better in this case. Otherwise, the
total amount of markup could be considered excessive.

The strings "1" and "2" are not placeholders for arguments,
but have to be given verbatim on the command line, so use .Cm.
Found while testing mandocdb(8), ok jmc@.

add -C to the man page, and adjust usage();
ok lteo

catch up to the fact that md5/sha* got merged, and document -c consistently;
some style and cleanup tweaks while here

ok deraadt

sort options;

Add support for -h hashfile. This is very useful with with -p, in a pipeline,
to deliver the hash output to a different location.
ok millert

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);

SHA-224 is to SHA-256 as SHA-384 is to SHA-512. It was added in a
later revision of FIPS-180. OK miod@ jmc@ guenther@ djm@

more EXIT STATUS bits; from Daniel Dickman

replace rmd160 links with sha256. it's way more popular and more better, too.
too many oks to enumerate.
while here, add Xr to the relevant libc functions in each page.

dispense with some wacky escape sequences;

replace ".Ar file ..." with ".Ar" whenever possible.

ok jmc@

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

md5(1), sha1(1), rmd160(1), cksum(1) and sum(1) have different options;
while here, some KNF improvements.

based on a diff for compress(1) written by millert@,
fixes from guenther@ and pyr@.

ok millert@, pyr@; (for the manual page tweaks) jmc@

convert to new .Dd format;

some i missed...
- consistent text for STANDARDS
- note which options are extensions to POSIX

allow multiple -t to increase the test count. cpus are getting too fast.
ok grunk. with manpage from grunk and jmc

Add base64 support to cksum and friends. Output encoding can
be set globally or on a per-algorithm basis when using multiple
hash functions. OK espie@ simon@ deraadt@; man help from jmc@

augment the -q option, now if specifed with -c (checklist)
it will only print out the failed cases.

OK millert@

Add md5 to the list of unsecure checksums. Adapted from a diff by
Tamas TEVESZ.

WARNING/BUGS -> CAVEATS; ok millert

`<' -> \*(Lt

discourage .Tn;

.Ex these pages; ok millert

simplify synopsis and usage(); ok millert

Add -r and -q options similar to what is supported by FreeBSD's md5
OK deraadt@ ckuethe@

more macro simplification;

avoid specifying which hash to use;
this after some discussion w/ otto;

started by pr #4120, from andy isaacson;

Add support for multiple using algorithms. OK'd by several people
a while ago so get this out of my tree...

- simplify synopses
- correct macros
- various grammatical fixes

ok millert@

Add support for cksum (3 varieties), md4, sha256, sha384, and sha512.
Consequently, cksum moves becomes a link to md5 and moves to /bin.
The cksum man page could use some polishing.