aboutsummaryrefslogtreecommitdiffstats
path: root/man/keccaksum.1
blob: cbc76eec85233c383844fef28ab4c28562e193dd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
.TH KECCAKSUM 1 anysum
.SH NAME
keccaksum - compute or verify against multiple Keccak hashes

.SH SYNOPSIS
.B keccaksum
.RB [ -c
.RB [ -w ]]
.RB [ -R
.IR bitrate ]
.RB [ -C
.IR capacity ]
.RB [ -N
.IR hashsize ]
.RB [ -S
.IR statesize ]
.RB [ -W
.IR statesize ]
.RB [ -Z
.IR squeezes ]
.RB [ -W
.IR options ]\ ...
.RB [ -z ]
.RI [ file ]\ ...

.SH DESCRIPTION
The
.B keccaksum
utility calculates and prints or checks Keccak
(Keccak[r=1152,c=448,n=224]) checksums.
.PP
The
.B keccaksum
utility can also check a file against multiple Keccak
checksums, and check that the file matches at least one
of the listed checksums.

.SH OPTIONS
The keccaksum utility conforms to the Base Definitions
volume of POSIX.1-2017,
.IR "Section 12.2" ,
.IR "Utility Syntax Guidelines" .
.PP
The following options are supported:
.TP
.B -b
Equivalent to
.BR "-W output=binary" .
.TP
.BR -C \ \fIcapacity\fP
The capacity, in bits, for the Keccak function.
.TP
.B -c
Verify the the files listed in file against the
checksums listed on the same lines. The file
shall be formatted as the output of the utility
when this option is not used. See the
.B STDOUT
section for more information. If a file is listed
multiple times, it need only match one of the
checksums listed for the file.

The length of the listed checksums need not match
the length output by this utility; before the
checksums are compared, they are truncated to the
shorter of the two checksums.
.TP
.B -l
Equivalent to
.BR "-W output=lowercase" .
.TP
.BR -N , -O \ \fIhashsize\fP
The output size in bits.
.TP
.BR -R \ \fIbitrate\fP
The bitrate for the Keccak function.
.TP
.BR -S , -B \ \fIstatesize\fP
The state-size, in bits, for the Keccak function.
.TP
.B -u
Equivalent to
.BR "-W output=uppercase" .
.TP
.B -v
Print Keccak parameters to standard error.
.TP
.BR -W \ \fIwordsize\fP
The word-size, in bits, for the Keccak function.
.TP
.BR -W \ \fIoptions\fP
Comma-sepearated list of implementation-specific
options. The following options are supported:
.RS
.TP
.BI output= format
.I format
shall be
.RB \(dq lowercase \(dq
if the checksums shall be printed in lowercase
hexadecimal format (default),
.RB \(dq uppercase \(dq
for uppercase hexadecimal format, or
.RB \(dq binary \(dq
for binary format without anything but the
checksum printed to standard output. This
option is ignored if the
.B -c
option is used.
.TP
.BI input= format
.I format
shall be
.RB \(dq binary \(dq
if the files are be read in binary mode,
.RB \(dq text \(dq
if the files shall be read in text mode, or
.RB \(dq hexadecimal \(dq
they shall be decoded from hexadecimal to
binary. If the
.B -c
option is used, the mode specification
associated with a file is overrides this
behaviour for that file if the line
specifies hexadecimal mode.
.TP
.B recursive
If a
.I file
operand is a directory, the checksum is computed for
all files recursively. This option is ignored if the
.B -c
option is used.
.TP
.B no-recursive
The utility shall traverse directories.
(This is the default behaviour).
.TP
.B xdev
Implies
.B -W recursive
but also allows the recursion across mountpoints.
.TP
.B no-xdev
Disable recursion across mountpoints.
(This is the default behaviour).
Note that this does not disable
recursion by itself.
.TP
.B xlink
Implies
.B -W recursive
but also allows the recursion across symbolic links.
.TP
.B no-xlink
Disable recursion across symbolic links.
(This is the default behaviour).
Note that this does not disable
recursion by itself.
.RE
.TP
.B -w
Warn about, but skip, lines that are not properly
formatted.
.TP
.B -x
Equivalent to
.BR "-W input=hexadeximal" .
.TP
.BR -Z \ \fIsqueeze\fP
The number of squeezes to perform on at the end phase
of the Keccak function (this changes the hash but not
the length of the hash).
.TP
.B -z
Use NUL byte as line ending instead of LF.
.PP
There is no difference between binary mode and text mode.

.SH OPERANDS
The following operand is supported:
.TP
.I file
The file to read and compute the checksum for, or if the
.B -c
option is used, use as the listing of files and checksums
to verify the files against. If dash
.RB (' - ')
is used or if no file operand is specified, standard input
will be used.

.SH STDOUT
If the
.B -c
option is not used, the utility shall print the following
line for each calculated checksum, however there are options
that modify the format; see the
.B OPTIONS
section for more information:
.PP
.RS
.B \(dq%s %c%s\en\(dq,
.RI < hash >\fB,\fP
.RI < mode >\fB,\fP
.RI < file >
.RE
.PP
where
.I mode
is SP (' ') for text mode, an asterisk
.RB (' * ')
for binary mode, or a pound sign
.RB (' # ')
for hexadecimal mode; however if there is no difference
between binary mode and text mode and either is selected,
SP (' ') (text mode) is used.
.PP
If the
.B -c
option the output shall be on the format:
.PP
.RS
.B \(dq%s: %s\en\(dq,
.RI < file >\fB,\fP
.RI < validity >
.RE
.PP
where
.I validity
is an implementation specified string
that describes whether the checksum was valid (possibly
with remarks), the file did not exist, the file could
not be read (possibly with error information), or if
the checksum was invalid or could not be compared
(possibly with remarks). The
.B -z
option does not modify the line ending.

.SH EXIT STATUS
The following exit values are returned:
.TP
0
Successful completion.
.TP
1
Checksums did not match or a file did not exist.
.TP
2
An error occurred.

.SH NOTES
Other implementations do not necessarily recognise the
hexadecimal mode specifier
.RB (' # ')
in checksum list files.
.PP
The
.B -c
option accepting truncated checksums is an
implementation-specific behaviour.

.SH SEE ALSO
.BR anysum (1)