Crate checksums [] [src]

Tool for making/verifying checksums of directory trees.

SYNOPSIS

checksums [OPTIONS] [DIRECTORY]

DESCRIPTION

Tool for making/verifying checksums of directory trees.

Use the generated checksums to automatically verify file/directory tree correctness.

OPTIONS

-a --algorithm <algorithm>

Set the hashing algorithm to use.

Supported algorithms: SHA1, SHA2-256, SHA2-512, SHA3-256, SHA3-512, BLAKE,
                    BLAKE2, CRC8, CRC16, CRC32, CRC64, MD5, XOR8

-c --create

Create directory hashes, rather than verifying them.

Directory hashes are output to the output file, which, if not specified, will
be "`DIRECTORY`.hash".

Will fail if the output file already exists and `--force` is not specified.

Exclusive with `--verify`. Overrides `--verify`.

-v --verify

Verify directory hashes. Default.

Exclusive with `--create`. Overrides `--create`.

-d --depth <depth>

Set max recursion depth to `depth`. Default: 0.

Exclusive with `--recursive`. Overrides `--recursive`.

-r --recursive

Set max recursion depth to infinity.

Exclusive with `--depth`. Overrides `--depth`.

--force

Override output file in `--create` mode. No meaning in `--verify` mode.

[DIRECTORY]

Directory to create/verify hash for. Default: current workdir.

EXAMPLES

examples [-v] [-f infile]

Verify the current directory tree against the saved hashes.

`-v` is not necessary as it's the default.

*infile* defaults to "`DIRECTORY`.hash"

examples -c [-f outfile] [--force]

Create hashes of the current directory tree for later verification.

*outfile* defaults to "`DIRECTORY`.hash".

Use `--force` to override *outfile*.

examples [-d depth] [-r] [OTHER OPTIONS]

Recurse *depth* or infinity directories down.

Modules

ops

Main functions doing actual work.

options

Option parsing and management.

util

Module containing various utility functions

Enums

Algorithm

A hashing algorithm.

Functions

hash_file

Hash the specified file using the specified hashing algorithm.