diff options
author | Mattias Andrée <maandree@kth.se> | 2017-10-15 15:30:55 +0200 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2017-10-15 15:30:55 +0200 |
commit | b73bcec311b10f7f622058b8b0c2bef428790686 (patch) | |
tree | 9d80e54b4dae8556f88f52c19cb241d835fcbc42 /xsum.man | |
parent | Add test (diff) | |
download | sha3sum-1.1.tar.gz sha3sum-1.1.tar.bz2 sha3sum-1.1.tar.xz |
Fix dependencies in makefile1.1
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'xsum.man')
-rw-r--r-- | xsum.man | 98 |
1 files changed, 98 insertions, 0 deletions
diff --git a/xsum.man b/xsum.man new file mode 100644 index 0000000..bd7c64f --- /dev/null +++ b/xsum.man @@ -0,0 +1,98 @@ +.TH XSUM 1 sha3sum +.SH NAME +xsum - Compute and check Xsum message digests +.SH SYNOPSIS +.B xsum +[-u | -l | -b | -c] +[-R +.IR rate ] +[-C +.IR capacity ] +[-N +.IR output-size ] +[-S +.IR state-size ] +[-W +.IR word-size ] +[-Z +.IR squeeze-count ] +[-vx] +.RI [ file \ ...] +.SH DESCRIPTION +Print or check Xsum checksums. If no file +or when the file is -, read standard input. +.TP +.B -u +Output checksums in upper-case hexadecimal representation. (default) +.TP +.B -l +Output checksums in lower-case hexadecimal representation. +.TP +.B -b +Output checksums in binary representation. This suppresses +the filenames and checksum delimiters. Only the checksums +are printed. +.TP +.B -c +Read Xsum sums from the file and check them against +the files on your systems. The input files files +should be formated as the output of this program, or +similarly. This is not going to work if any of the +filenames in the input files starts with a regular +blank space or horizontal tab space, or if they +contain a line feed, carriage return or form feed. +.TP +.B -x +Convert input files from hexadecimal for to binary form +before calculating the checksums. +.TP +.B -v +Print the hashing parameters. +.P +The following options change the hashing parameters: +.TP +.BI -R\ rate +Change the rate. +.TP +.BI -C\ capacity +Change the capacity. +.TP +.BR -N ,\ -O \ \fIoutput-size\fP +Change the output size. +.TP +.BR -S ,\ -B \ \fIstate-size\fP +Change the state size. +.TP +.BI -W\ word-size +Change the word size. +.TP +.BI -Z\ squeeze-count +Change the number of squeezes that is performed. +.SH EXIT STATUS +.TP +0 +Successful completion. +.TP +1 +Checksums did not match or a file did not exist. +.TP +2 +An error occurrsed. +.SH AUTHORS +Mattias Andrée +.RI < maandree@kth.se > +.SH NOTES +All commands in the sha3sum package allow changing +the hashing parameters. However it is only intended +to be used with +.BR keccaksum (1), +or if you know what you are doing; apart from +.B -N +which is intended to +.I always +be used with +.BR shake256sum (1), +.BR shake512sum (1), +.BR rawshake256sum (1), +and +.BR rawshake512sum (1). |