GOST public key algorithm ENGINE donated to the OpenSSL by Cryptocom.
[openssl.git] / engines / ccgost / gostsum.1
1 .\" Hey, Emacs!  This is an -*- nroff -*- source file.
2 .TH MD5SUM 1 "29th November 1995" "Lankester et al." "Debian GNU/Linux"
3 .SH NAME
4 gostsum \- generates or checks GOST R34.11-94 message digests
5
6 .SH SYNOPSIS
7 .B gostsum
8 [\-bv] [\-c [file]] | [file...]
9
10 .SH DESCRIPTION
11 .B gostsum
12 generates or checks GOST hash sums. The algorithm to generate the
13 is reasonably fast and strong enough for most cases. Exact
14 specification of the algorithm is in
15 .I GOST R34.11-94.
16
17 Normally
18 .B gostsum
19 generates checksums of all files given to it as a parameter and prints
20 the checksums followed by the filenames. If, however,
21 .B \-c
22 is specified, only one filename parameter is allowed. This file should
23 contain checksums and filenames to which these checksums refer to, and
24 the files listed in that file are checked against the checksums listed
25 there. See option
26 .B \-c
27 for more information.
28
29 .SS OPTIONS
30 .TP
31 .B \-b
32 Use binary mode. In unix environment, only difference between this and
33 the normal mode is an asterisk preceding the filename in the output.
34 .TP
35 .B \-c
36 Check md5sum of all files listed in
37 .I file
38 against the checksum listed in the same file. The actual format of that
39 file is the same as output of
40 .B md5sum.
41 That is, each line in the file describes a file. A line looks like:
42
43 .B <hashsum>  <filename>
44
45 So, for example, if a file was created and its message digest calculated
46 like so:
47
48 .B echo foo > hash\-test\-file; gost5sum hash\-test\-file
49
50 .B gost5sum
51 would report:
52
53 .B d3b07384d113edec49eaa6238ad5ff00\  md5\-test\-file
54
55 .TP
56 .B \-v
57 Be more verbose. Print filenames when checking (with \-c).
58
59 .TP
60 .B -t 
61 Use test parameter set. 
62 .B gostsum supports two sets of parameters (which are really parameters
63 of GOST 28147-89 block cipher) specified in the IETF draft 
64 .B draft-popov-cryptopro-cpalgs-02.txt
65 By default, cryptopro paramset is used. This option enables use of test
66 paramset as specified in appendices to the GOST.
67
68 .SH BUGS
69
70 This manpage is not quite accurate and has formatting inconsistent
71 with other manpages.
72
73 .B gostsum
74 does not accept standard options like
75 .BR \-\-help .
76
77 .SH AUTHOR
78