diff --git a/doc/coreutils.texi b/doc/coreutils.texi index e324b886d..92ff9dec5 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -4203,6 +4203,12 @@ Also file name escaping is not used. @command{md5sum} computes a 128-bit checksum (or @dfn{fingerprint} or @dfn{message-digest}) for each specified @var{file}. +@macro legacyDigest +This is a legacy interface to the more modern @command{cksum} utility. +@xref{cksum invocation}. +@end macro +@legacyDigest + @macro weakHash{hash} The \hash\ digest is more reliable than a simple CRC (provided by the @command{cksum} command) for detecting accidental file corruption, @@ -4214,7 +4220,6 @@ to modify certain files, including digital certificates, so that they appear valid when signed with an \hash\ digest. For more secure hashes, consider using @samp{sha2}, @samp{sha3}, or @samp{blake2b}, available through the @command{cksum} @option{--algorithm} option. -@xref{cksum invocation}. @end macro @weakHash{MD5} @@ -4251,6 +4256,8 @@ The program accepts @ref{cksum common options}. Also see @ref{Common options}. @command{b2sum} computes a 512-bit checksum for each specified @var{file}. +@legacyDigest + @checksumUsage{b2sum} In addition @command{b2sum} supports the following options. @@ -4282,6 +4289,8 @@ as the length is automatically determined when checking. @command{sha1sum} computes a 160-bit checksum for each specified @var{file}. +@legacyDigest + @weakHash{SHA-1} @checksumUsage{sha1sum} @@ -4289,6 +4298,8 @@ as the length is automatically determined when checking. @node sha2 utilities @section sha2 utilities: Print or check SHA-2 digests +@legacyDigest + @pindex sha224sum @pindex sha256sum @pindex sha384sum diff --git a/man/md5sum.x b/man/md5sum.x index 3f4cc6409..c8fd8c0ed 100644 --- a/man/md5sum.x +++ b/man/md5sum.x @@ -4,8 +4,7 @@ md5sum \- compute and check MD5 message digest .\" Add any additional description here [BUGS] Do not use the MD5 algorithm for security related purposes. -Instead, use an SHA\-2 algorithm, implemented in the programs -sha224sum(1), sha256sum(1), sha384sum(1), sha512sum(1), -or the BLAKE2 algorithm, implemented in b2sum(1) +Instead, use an SHA\-2, SHA\-3, or BLAKE2 algorithm, +implemented in the cksum(1) program. [SEE ALSO] cksum(1) diff --git a/man/sha1sum.x b/man/sha1sum.x index 8fd824f10..fb2851390 100644 --- a/man/sha1sum.x +++ b/man/sha1sum.x @@ -3,9 +3,8 @@ sha1sum \- compute and check SHA1 message digest [DESCRIPTION] .\" Add any additional description here [BUGS] -Do not use the SHA-1 algorithm for security related purposes. -Instead, use an SHA\-2 algorithm, implemented in the programs -sha224sum(1), sha256sum(1), sha384sum(1), sha512sum(1), -or the BLAKE2 algorithm, implemented in b2sum(1) +Do not use the MD5 algorithm for security related purposes. +Instead, use an SHA\-2, SHA\-3, or BLAKE2 algorithm, +implemented in the cksum(1) program. [SEE ALSO] cksum(1) diff --git a/src/cksum.c b/src/cksum.c index 7d6ff982b..8c9f8ac84 100644 --- a/src/cksum.c +++ b/src/cksum.c @@ -487,9 +487,14 @@ Usage: %s [OPTION]... [FILE]...\n\ "), program_name); #if HASH_ALGO_CKSUM if (legacy_mode) - printf (_("\ + { + printf (_("\ Print or check %s checksums.\n\ "), DIGEST_TYPE_STRING); + fputs (_("\ +Legacy interface to the cksum utility.\n\ +"), stdout); + } else fputs (_("\ Print or verify checksums.\n\ @@ -501,6 +506,9 @@ Print or check %s (%d-bit) checksums.\n\ "), DIGEST_TYPE_STRING, DIGEST_BITS); + fputs (_("\ +Legacy interface to the cksum utility.\n\ +"), stdout); #endif emit_stdin_note ();