chksum-cli

A simple checksum calculator.

Motivation

There are variety of tools that allows calculate hash digests.

However tools like md5sum, sha1sum, b2sum, sha224sum and others offer only file-based checksums.

find dir/ -type f | sort | xargs cat | sha224sum

Instead you can just use chksum with preffered hash algorithm.

chksum sha2-224 dir/

Features

• Written in pure Rust
• No unsafe code
• Configurable via Cargo features
• Multithread

Installation

Use cargo install to install chksum binary in $HOME/.cargo/bin directory.

cargo install chksum-cli

Usage

$ chksum help
A simple checksum calculator.

Usage: chksum [OPTIONS] <COMMAND>

Commands:
  md5       Calculate MD5 digest
  sha1      Calculate SHA-1 digest
  sha2-224  Calculate SHA-2 224 digest
  sha2-256  Calculate SHA-2 256 digest
  sha2-384  Calculate SHA-2 384 digest
  sha2-512  Calculate SHA-2 512 digest
  help      Print this message or the help of the given subcommand(s)

Options:
  -c, --color <COLOR>  Show colored output [default: auto] [possible values: always, auto, never]
  -h, --help           Print help
  -V, --version        Print version

$ chksum help sha2-224
Calculate SHA-2 224 digest

Usage: chksum sha2-224 [OPTIONS] <PATH>...

Arguments:
  <PATH>...  Path to file or directory

Options:
  -s, --stdin          Calculate digest from stdin
  -c, --color <COLOR>  Show colored output [default: auto] [possible values: always, auto, never]
  -h, --help           Print help

File

$ chksum sha2-224 LICENSE
LICENSE: 99258bca0d23c69388dd53412f1009132753b89459359a401a6ed158

Directory

$ chksum sha1 src/
src/: 03e4ae615c034f5db47c72bd5c6c9e5bf450a2bd

Standard input

$ echo -n admin1 | chksum md5 --stdin
<stdin>: e00cf25ad42683b3df678c61f42c6bda

Library

Check chksum crate to see the library that allows you to calculate digests of files and directories with easy-to-use interface.

Hash algorithms

Implemented hash algorithms:

• MD5 - RFC 1321: The MD5 Message-Digest Algorithm
• SHA-1 - RFC 3174: US Secure Hash Algorithm 1 (SHA1)
• SHA-2 family (SHA-224, SHA-256, SHA-386, SHA-512) - FIPS PUB 180-4: Secure Hash Standard

Feature flags

Algorithms

• md5: Enables MD5 hash algorithm.
• sha1: Enables SHA-1 hash algorithm.
• sha2: Enables SHA-2 hash family algorithms.
  • sha2-224: Enables only SHA-2 224 hash algorithm.
  • sha2-256: Enables only SHA-2 256 hash algorithm.
  • sha2-384: Enables only SHA-2 384 hash algorithm.
  • sha2-512: Enables only SHA-2 512 hash algorithm.

Options

• color: Enables colored output.

By default all of them are enabled.

Disclaimer

Code is under development. The interface may change in the future.

License

MIT