From: Pádraig Brady <P@draigBrady.com>
Date: Sun, 18 Jan 2026 13:35:17 +0000 (+0000)
Subject: doc: add more redirections from legacy *sum to cksum
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f7bb91968b9d1a1a70f9c5e8ea8986b868df5f7f;p=thirdparty%2Fcoreutils.git

doc: add more redirections from legacy *sum to cksum

*  doc/coreutils.texi (md5sum invocation, sha1sum invocation,
b2sum invocation, sha2 utilities): Mention these are legacy interfaces,
and reference 'cksum invocation'.
*  src/cksum.c (usage): Likewise.
*  man/md5sum.x: Redirect to cksum, rather than individual utils.
*  man/sha1sum.x: Likewise.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index e324b886dd..92ff9dec5a 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 3f4cc6409a..c8fd8c0ed8 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 8fd824f109..fb28513900 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 7d6ff982bc..8c9f8ac84b 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 ();