NAME¶

sha3sum - Compute and check SHA3 message digests

SYNOPSIS¶

sha3sum [-u | -l | -b | -c] [-a bits] [-R rate] [-C capacity] [-N output-size] [-S state-size] [-W word-size] [-Z squeeze-count] [-vxz] [file ...]

DESCRIPTION¶

Print or check SHA3 checksums. If no file or when the file is -, read standard input.

-u

Output checksums in upper-case hexadecimal representation.

-l

Output checksums in lower-case hexadecimal representation. (default)

-b

Output checksums in binary representation. This suppresses the filenames and checksum delimiters. Only the checksums are printed.

-c

Read SHA3 sums from the file and check them against the files on your systems. The input files files should be formated as the output of this program, or similarly. This is not going to work if any of the filenames in the input files starts with a regular blank space or horizontal tab space, or if they contain a line feed, carriage return or form feed, unless the -z option is also used.

-a bits

Select version of the SHA3 algorithm. Valid values are 224 (default), 256, 384, and 512.

-v

Print the hashing parameters.

-x

Convert input files from hexadecimal for to binary form before calculating the checksums.

-z

Lines end with NUL instead of LF. If used with -c, this applies to read files (not the output), but it will also apply more strict parsing and allow any whitespace in file names.

The following options change the hashing parameters:

-R rate

Change the rate.

-C capacity

Change the capacity.

-N, -O output-size

Change the output size.

-S, -B state-size

Change the state size.

-W word-size

Change the word size.

-Z squeeze-count

Change the number of squeezes that is performed.

EXIT STATUS¶

0

Successful completion.

1

Checksums did not match or a file did not exist.

2

An error occurred.

AUTHORS¶

Mattias Andrée <maandree@kth.se>

NOTES¶

All commands in the sha3sum package allow changing the hashing parameters. However it is only intended to be used with keccaksum(1), or if you know what you are doing; apart from -N which is intended to always be used with shake128sum(1), shake256sum(1), shake512sum(1), rawshake128sum(1), rawshake256sum(1), and rawshake512sum(1).