gost12sum.1

   1 .\" Hey, Emacs!  This is an -*- nroff -*- source file.
   2 .TH GOST12SUM 1 "02 Aug 2016" "Openssl" "Debian GNU/Linux"
   3 .SH NAME
   4 gost12sum \- generates or checks GOST R34.11-2012 message digests
   5
   6 .SH SYNOPSIS
   7 .B gost12sum
   8 [\-bvl] [\-c [file]] | [file...]
   9
  10 .SH DESCRIPTION
  11 .B gost12sum
  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-2012.
  16
  17 Normally
  18 .B gost12sum
  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; gost12sum hash\-test\-file
  49
  50 .B gost12sum
  51 would report:
  52
  53 3d4a51ee7713e6467442facefe06f153a303e7bdefbe7f9bdf2edb4ae9c866ff hash\-test\-file
  54
  55 When invoked with \-c option
  56 .B gost12sum
  57 normally works silently unless error found. Use \-v if you want to see
  58 list of successfully checked files
  59
  60 .TP
  61 .B \-v
  62 Be more verbose. Print filenames when checking (with \-c).
  63
  64 .TP
  65 .B -l
  66 Use long (512-bit) hash instead of short (256-bit).
  67
  68 .SH BUGS
  69
  70 This manpage is not quite accurate and has formatting inconsistent
  71 with other manpages.
  72
  73 .B gost12sum
  74 does not accept standard options like
  75 .BR \-\-help .
  76
  77 .SH AUTHOR
  78
  79 .B gost12sum
  80 utility written by Cryptocom LTD
  81
  82 This manual page is written by Victor Wagner <vitus@wagner.pp.ru> for
  83 Debian GNU/Linux
  84