ddgst, dd's digest utility

ddgst is a simple hasher available cross-platform (Windows, macOS, Linux, BSDs) and comes with more features than built-in OS utilities.

Feature Comparison

Algorithm Comparison

Algorithm Security

Usage

Usage:

• ddgst [options...] [file|-]
• ddgst [options...] {--check|--autocheck} list
• ddgst [options...] --against=HASH files...
• ddgst [options...] --compare files...
• ddgst [options...] --args text...
• ddgst [options...] --benchmark

With no arguments, the help page is shown.

For a list of options available, use the --help argument.

For a list of supported checksums and hashes, use the --hashes switch.

Hashing files

The default mode is hashing files and directories using the GNU style.

Styles available:

Check list of hashes

Check against file list (supports --tag):

$ ddgst --sha256 -c list
file1: OK
file2: FAILED
2 total: 1 mismatch, 0 not read

Using autodetection:

$ ddgst --autocheck list.sha256
file: OK
file2: FAILED
2 total: 1 mismatch, 0 not read

Check files against a hash digest

Supports hex and base64 digests.

$ ddgst --sha1 LICENSE -A f6067df486cbdbb0aac026b799b26261c92734a3
LICENSE: OK

Compare files against each other

$ ddgst --sha512 --compare LICENSE README.md dub.sdl 
Files 'LICENSE' and 'README.md' are different
Files 'README.md' and 'dub.sdl' are different
Files 'LICENSE' and 'dub.sdl' are different

Hash text entries

$ ddgst --crc32 --args "Argument with spaces" Arguments without spaces
f17cf59f  "Argument with spacesArgumentswithoutspaces"

Digest parameters

Some hashes may take optional parameters.

• Murmurhash3
  • The --seed option takes an argument literal for seeding the hash.
  • Can only be a 32-bit integer seed in decimal format.
• BLAKE2
  • The --key option takes a binary file for keying the hash.
  • BLAKE2s: Key can be up to 64 Bytes in size.
  • BLAKE2b: Key can be up to 128 Bytes in size.

File Pattern Globbing (* vs. '*')

This utility supports file globbing out of the box using std.file.dirEntries.

However, while useful on Windows, most UNIX-like terminals support in-shell globbing. This may behave differently than the dirEntries function.

To force the usage of the embedded globbing mechanism, you may want to use '*' or \*. To disable it, use the -- parameter.

The globbing pattern is further explained on dlang.org.

The default parameters used in dirEntries are:

• SpanMode: shallow (same-level directory);
• And followSymlink: true (follows soft symbolic links).

NOTE: The embedded globbing system includes hidden files.

EXAMPLE: A pattern such as src/*.{d,dd}:

• Matches src/example.d, src/.dd, and src/file.dd;
• But doesn't match example.d, src/.ddd, and src/.e;
• Basically all files ending with .d and .dd in the src directory, following symlinks.

Errors

Compiling

Compiling requires a recent D compiler and DUB.

To compile a debug build with the default compiler:

dub build

Release recommendation with the LDC compiler:

dub build -b release-nobounds --compiler=ldc2

To compile with GDC, you'll also need gdmd installed.

[^2]: All but cksum and sum. [^3]: See dgst command. [^4]: * prepended to filename. [^5]: Possible to do with a chain of commands, but good luck remembering them. [^6]: While the official BLAKE3 team has a b3sum, GNU does not. [^8]: The OpenSSL team is waiting for BLAKE3 to be standardized. [^9]: As of 0.0.13