xxhsum
[] ... [] ...
xxhsum -b
[] ...
Print or check xxHash (32 or 64bit) checksums. When is -
, read standard input.
xxhsum
supports a command line syntax similar but not indentical to md5sum(1). Differences are: xxhsum
doesn't have text/binary mode switch (-b
, -t
); xxhsum
always treats file as binary file; xxhsum
has hash bit width switch (-H
);
Since xxHash is non-cryptographic checksum algorithm, xxhsum
should not be used any more for security related purposes.
xxhsum -b
invokes benchmark mode. See OPTIONS and EXAMPLES for details.
-c
, --check
: Read xxHash sums from the s and check them
-h
, --help
: Display help and exit
-H
: Hash selection. means 0
=32bits, 1
=64bits. Default value is 1
(64bits)
--little-endian
: Set output hexadecimal checksum value as little endian convention. By default, value is displayed as big endian
-V
, --version
: Display xxhsum version
The following four options are useful only when verifying checksums (-c
)
--quiet
: Exit non-zero for improperly formatted checksum lines
--strict
: Don't print OK for each successfully verified file
--status
: Don't output anything, status code shows success
-w
, --warn
: Warn about improperly formatted checksum lines
The following options are useful only benchmark purpose
-b
: Benchmark mode. See EXAMPLES for details.
-B
: Only useful for benchmark mode (-b
). See EXAMPLES for details. specifies benchmark mode's test data block size in bytes. Default value is 102400
-i
: Only useful for benchmark mode (-b
). See EXAMPLES for details. specifies number of iterations in benchmark. Single iteration takes at least 2500 milliseconds. Default value is 3
xxhsum
exit 0
on success, 1
if at least one file couldn‘t be read or doesn’t have the same checksum as the -c
option.
Output xxHash (64bit) checksum values of specific files to standard output
$ xxhsum -H1 foo bar baz
Output xxHash (32bit and 64bit) checksum values of specific files to standard output, and redirect it to xyz.xxh32
and qux.xxh64
$ xxhsum -H0 foo bar baz > xyz.xxh32 $ xxhsum -H1 foo bar baz > qux.xxh64
Read xxHash sums from specific files and check them
$ xxhsum -c xyz.xxh32 qux.xxh64
Benchmark xxHash algorithm for 16384 bytes data in 10 times. xxhsum
benchmarks xxHash algorithm for 32-bit and 64-bit and output results to standard output. First column means algorithm, second column is source data size in bytes, last column means hash generation speed in mega-bytes per seconds.
$ xxhsum -b -i10 -B16384
Report bugs at: https://github.com/Cyan4973/xxHash/issues/
Yann Collet
md5sum(1)