1XXHSUM(1) User Commands XXHSUM(1)
2
3
4
6 xxhsum - print or check xxHash non-cryptographic checksums
7
9 xxhsum [<OPTION>] ... [<FILE>] ...
10 xxhsum -b [<OPTION>] ...
11
12 xxh32sum is equivalent to xxhsum -H0
13 xxh64sum is equivalent to xxhsum -H1
14 xxh128sum is equivalent to xxhsum -H2
15
17 Print or check xxHash (32, 64 or 128 bits) checksums. When FILE is -,
18 read standard input.
19
20 xxhsum supports a command line syntax similar but not identical to
21 md5sum(1). Differences are: xxhsum doesn´t have text/binary mode switch
22 (-b, -t); xxhsum always treats file as binary file; xxhsum has hash bit
23 width switch (-H);
24
25 As xxHash is a fast non-cryptographic checksum algorithm, xxhsum should
26 not be used for security related purposes.
27
28 xxhsum -b invokes benchmark mode. See OPTIONS and EXAMPLES for details.
29
31 -V, --version
32 Display xxhsum version and exits
33
34 -HHASHTYPE
35 Hash selection. HASHTYPE means 0=32bits, 1=64bits, 2=128bits.
36 Default value is 1 (64bits)
37
38 -q, --quiet
39 Remove status messages like "Loading ..." written to stderr .
40
41 --little-endian
42 Set output hexadecimal checksum value as little endian conven‐
43 tion. By default, value is displayed as big endian.
44
45 -h, --help
46 Display help and exit
47
48 The following four options are useful only when verifying checksums
49 (-c)
50
51 -c, --check
52 Read xxHash sums from the FILEs and check them
53
54 q, --quiet
55 Exit non-zero for improperly formatted checksum lines
56
57 --strict
58 Don´t print OK for each successfully verified file
59
60 --status
61 Don´t output anything, status code shows success
62
63 -w, --warn
64 Warn about improperly formatted checksum lines
65
66 The following options are useful only benchmark purpose
67
68 -b Benchmark mode. See EXAMPLES for details.
69
70 -BBLOCKSIZE
71 Only useful for benchmark mode (-b). See EXAMPLES for details.
72 BLOCKSIZE specifies benchmark mode´s test data block size in
73 bytes. Default value is 102400
74
75 -iITERATIONS
76 Only useful for benchmark mode (-b). See EXAMPLES for details.
77 ITERATIONS specifies number of iterations in benchmark. Single
78 iteration lasts approximately 1000 milliseconds. Default value
79 is 3
80
82 xxhsum exit 0 on success, 1 if at least one file couldn´t be read or
83 doesn´t have the same checksum as the -c option.
84
86 Output xxHash (64bit) checksum values of specific files to standard
87 output
88
89
90
91 $ xxhsum -H1 foo bar baz
92
93
94
95 Output xxHash (32bit and 64bit) checksum values of specific files to
96 standard output, and redirect it to xyz.xxh32 and qux.xxh64
97
98
99
100 $ xxhsum -H0 foo bar baz > xyz.xxh32
101 $ xxhsum -H1 foo bar baz > qux.xxh64
102
103
104
105 Read xxHash sums from specific files and check them
106
107
108
109 $ xxhsum -c xyz.xxh32 qux.xxh64
110
111
112
113 Benchmark xxHash algorithm for 16384 bytes data in 10 times. xxhsum
114 benchmarks all xxHash variants and output results to standard output.
115 First column means algorithm, second column is source data size in
116 bytes, third column is number of hashes generated per second (through‐
117 put), and finally last column translates speed in mega-bytes per sec‐
118 onds.
119
120
121
122 $ xxhsum -b -i10 -B16384
123
124
125
127 Report bugs at: https://github.com/Cyan4973/xxHash/issues/
128
130 Yann Collet
131
133 md5sum(1)
134
135
136
137xxhsum 0.7.2 October 2019 XXHSUM(1)