mirror of https://github.com/BLAKE3-team/BLAKE3 synced 2024-09-22 21:40:45 +02:00

History

Jack O'Connor 14cd5c51c4 version 0.1.2 Changes since 0.1.1: - b3sum no longer mmaps files smaller than 16 KiB. This improves performance for hashing many small files. Contributed by @xzfc. - b3sum now supports --raw output. Contributed by @phayes.		2020-01-17 13:58:55 -05:00
..
src	edit the --raw help string	2020-01-17 13:36:09 -05:00
tests	Making sure our raw multi-file test is testing what we think it is	2020-01-13 14:48:24 -08:00
Cargo.toml	version 0.1.2	2020-01-17 13:58:55 -05:00
README.md	version 0.1.2	2020-01-17 13:58:55 -05:00

README.md

b3sum

b3sum 0.1.2

USAGE:
    b3sum [FLAGS] [OPTIONS] [file]...

FLAGS:
    -h, --help        Prints help information
        --keyed       Uses the keyed mode, with the raw 32-byte key read from stdin
        --no-names    Omits filenames in the output
        --raw         Writes raw output bytes to stdout, rather than hex. --no-names is implied.
                      In this case, only a single input is allowed
    -V, --version     Prints version information

OPTIONS:
        --derive-key <CONTEXT>    Uses the key derivation mode, with the input as key material
    -l, --length <LEN>            The number of output bytes, prior to hex encoding (default 32)

ARGS:
    <file>...

Building

The standard way to install b3sum is:

cargo install b3sum

On Linux for example, Cargo will put the compiled binary in ~/.cargo/bin. You might want to add that directory to your $PATH, or rustup might have done it for you when you installed Cargo.

If you want to install directly from this directory, you can run cargo install --path .. Or you can just build with cargo build --release, which puts the binary at ./target/release/b3sum.

AVX-512 support (via C FFI, with dynamic CPU feature detection) and multi-threading (via Rayon) are enabled by default. Note that the underlying blake3 crate does not enable those by default.