gostsum.1

   1 .\" Hey, Emacs!  This is an -*- nroff -*- source file.
   2 .TH GOSTSUM 1 "02 Aug 2017" "Openssl" "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 [\-bvt] [\-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 gost hashes 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; gostsum hash\-test\-file
  49
  50 .B gostsum
  51 would report:
  52
  53 1541e09d0aa5971f732991ae1bdfb63f2609edd7536b40f8c2ae7c1e2f99e072 hash-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 CAVEATS
  69
  70 The output of gost12sum has a reversed byte order compared to output of
  71 .B openssl dgst
  72 command because of the Russian GOST requrements.
  73
  74 .SH BUGS
  75
  76 This manpage is not quite accurate and has formatting inconsistent
  77 with other manpages.
  78
  79 .B gostsum
  80 does not accept standard options like
  81 .BR \-\-help .
  82
  83 .SH AUTHOR
  84         Victor Wagner <vitus@wagner.pp.ru>
  85