cksumx
Print or check checksums and byte counts.
Mirrors GNU cksum. Run it as cksumx, or as gnux cksumx.
Synopsis
cksumx [OPTION]... [FILE]...GNU reference
Description
cksumx prints a checksum and the byte count of each FILE. With no FILE, or when FILE is -, it reads standard input (and, with no FILE at all, prints no name). By default it computes the POSIX CRC (the 'crc' algorithm), as plain cksum always has. -a ALGORITHM picks another: sysv and bsd (the legacy sum checksums, with a block count rather than a byte count), crc32b (the CRC-32 of zlib and gzip), or the message digests md5, sha1, sha224, sha256, sha384, sha512 and blake2b. Digests are printed as BSD-style tagged lines ('SHA256 (FILE) = DIGEST'); --untagged prints them in the md5sumx style instead, and when both --tag and --untagged are given, --tag wins. --base64 prints digests in base64, --raw writes the bare binary checksum of a single input, -l BITS shortens a blake2b digest, and -z ends lines with NUL. -c checks the files listed in tagged or untagged digest lines, detecting the algorithm from each tagged line when -a is not given, with --ignore-missing, --quiet, --status, --strict and -w as in md5sumx. The legacy algorithms cannot be checked. On Windows a backslash in a file name is the path separator, so it is not escaped as GNU escapes it on Unix; a name with a newline is still escaped.
Permissions
Needs read permission on each FILE (and, with -c, on the checksum lists and every file they name) and search permission on the directories leading to them. Nothing is ever modified.
Use cases
- Comparing a file with the CRC a POSIX system's
cksumprinted for it. - Computing any of the supported digests with one tool and one syntax.
- Verifying mixed checksum lists that name their algorithm per line.
- Getting a gzip-compatible CRC-32 with
-acrc32b. - Printing a digest in
base64, as package managers and SRI hashes use.
Flags
-a, --algorithm TYPE select the digest TYPE to use: sysv, bsd, crc, crc32b, md5, sha1, sha224, sha256, sha384, sha512, blake2b
--base64 emit base64-encoded digests, not hexadecimal
-c, --check read checksums from the FILEs and check them
--help display this help and exit
--ignore-missing don't fail or report status for missing files
-l, --length bits digest length in bits; must not exceed the maximum for the blake2 algorithm and must be a multiple of 8
--quiet don't print OK for each successfully verified file
--raw emit a raw binary digest, not hexadecimal
--status don't output anything, status code shows success
--strict exit non-zero for improperly formatted checksum lines
--tag create a BSD-style checksum (the default)
--untagged create a reversed style checksum, without digest type
--version output version information and exit
-w, --warn warn about improperly formatted checksum lines
-z, --zero end each output line with NUL, not newline, and disable file name escapingExamples
Print the POSIX CRC and size of a file
cksumx file.isoChecksum standard input
echox hello | cksumxPrint a SHA-256 digest as a tagged line
cksumx -a sha256 file.isoPrint it in the sha256sumx style
cksumx -a sha256 --untagged file.isoPrint a digest in base64 (as SRI hashes use)
cksumx -a sha384 --base64 app.jsPrint a 256-bit BLAKE2b digest
cksumx -a blake2b -l 256 file.isoPrint the gzip-compatible CRC-32
cksumx -a crc32b data.binPrint the legacy BSD sum checksum
cksumx -a bsd file.txtSave tagged digests and check them later
cksumx -a sha256 *.iso > SUMS && cksumx -c SUMSCheck silently and branch on the result
cksumx -c --status SUMS && echox verifiedWrite the raw binary digest of one file
cksumx -a sha256 --raw file.iso > file.sha256.binChecksum in the portable gnux shell
gnux shell -c 'cksumx -a sha256 file.iso > file.iso.sum'Options
Each option has a page of its own, with its usage and examples.
- -a, --algorithm: Select the digest TYPE to use: sysv, bsd, crc, crc32b, md5, sha1, sha224, sha256, sha384, sha512, blake2b.
- --base64: Emit
base64``-encodeddigests, not hexadecimal. - -c, --check: Read checksums from the FILEs and check them.
- --ignore-missing: Don't fail or report status for missing files.
- -l, --length: Digest length in bits; must not exceed the maximum for the blake2 algorithm and must be a multiple of 8.
- --quiet: Don't print OK for each successfully verified file.
- --raw: Emit a raw binary digest, not hexadecimal.
- --status: Don't output anything, status code shows success.
- --strict: Exit non-zero for improperly formatted checksum lines.
- --tag: Create a BSD-style checksum (the default).
- --untagged: Create a reversed style checksum, without digest type.
- -w, --warn: Warn about improperly formatted checksum lines.
- -z, --zero: End each output line with NUL, not newline, and disable file name escaping.
Exit status
| Status | Meaning |
|---|---|
| 0 | success: every operand was processed |
| 1 | failure: an operand could not be processed (diagnosed on standard error), or a command-line mistake |
Help in the terminal
cksumx --help # options, first examples, exit status
gnux help cksumx # this page: the full manual
gnux help cksumx --OPTION # one option in depth, with its examples