sha3sum — Print or check SHA3 / Keccak digests

Command-line tool wrapping the RustCrypto/hashes sha3 crate.
Options and output format mirror the GNU sha256sum / sha512sum family.

One goal of this project is a cross-platform, dependency-light binary with no external system libraries required.

Supported algorithms

Install

From crates.io (recommended)

cargo install sha3sum

Pre-built binaries

Binary packages for Linux (x86_64, aarch64) and Windows (x86_64) are available in the Package Registry.
See the Wiki for installation instructions.

From source

git clone https://gitlab.com/kurdy/sha3sum.git
cd sha3sum
cargo build --release
# binary is at target/release/sha3sum

Usage

sha3sum - compute and check SHA3 message digest.

Usage: sha3sum [OPTIONS] [FILES]...

Arguments:
  [FILES]...  Displays the check sum for the files

Options:
  -a, --algorithm <ALGORITHM>
          sha3 algorithm {224 256 384 512 Keccak224 Keccak256 Keccak256Full Keccak384 Keccak512}
  -c, --check <CHECK>
          read SHA3 sums and file path from a file and check them
  -b, --binary
          read using Binary mode (default)
      --quiet
          don't print OK for each successfully verified file
      --status
          don't output anything, status code shows success
      --tag
          create a BSD-style checksum
  -t, --text
          read using Text mode
  -l, --license
          Prints license information
  -h, --help
          Print help
  -V, --version
          Print version

Examples

# Hash a single file with SHA3-256
sha3sum -a 256 file.bin

# Hash all files in a directory with Keccak-512
sha3sum -a Keccak512 ./data/

# Hash a text file in text mode (line-by-line, strips \r)
sha3sum -a 384 -t document.txt

# BSD-style output  →  SHA3_256 (file.bin) = abc123…
sha3sum -a 256 --tag file.bin

# Hash stdin
echo -n "hello" | sha3sum -a 256

# Verify a check file (GNU format or BSD format)
sha3sum -c checksums.txt

# Verify silently — check exit code only
sha3sum -c checksums.txt --status && echo "all OK"

# Verify and suppress OK lines
sha3sum -c checksums.txt --quiet

Output formats

Note: the separator between hash and filename is a no-break space (U+00A0), which prevents false splits when filenames contain regular spaces.

Exit codes

Performance tuning

By default each file is read in 64 KB blocks. Set SHA3_BLOCK_SIZE at compile time to override (value is embedded in the binary):

SHA3_BLOCK_SIZE=131072 cargo build --release

Multiple files are hashed in parallel using one thread per logical CPU (std::thread::available_parallelism).

Development

Requirements

• Rust ≥ 1.85 (MSRV — required for edition 2024)

Run tests

cargo test

Run benchmarks

Benchmarks use Criterion and produce statistical reports with HTML output under target/criterion/.

# Full benchmark suite
cargo bench

# Single group  (algorithms | read_strategy | read_mode | file_sizes)
cargo bench -- algorithms

Check-file format

Two formats are accepted by -c:

GNU format (produced by default):

<hash><NBSP>*<filename>     # binary mode
<hash><NBSP><filename>      # text mode

BSD tag format (produced by --tag):

<ALGORITHM><NBSP>(<filename>)<NBSP>=<NBSP><hash>

Tested platforms

License

GPL-3.0-or-later — see LICENSE.

Sources on GitLab