www.texi

   1 \input texinfo
   2 @documentencoding UTF-8
   3 @settitle GoGOST
   4
   5 @copying
   6 Copyright @copyright{} 2015-2016 @email{stargrave@@stargrave.org, Sergey Matveev}
   7 @end copying
   8
   9 @node Top
  10 @top GoGOST
  11
  12 Pure Go GOST cryptographic functions library.
  13 GOST is GOvernment STandard of Russian Federation (and Soviet Union).
  14 It is
  15 @url{https://www.gnu.org/philosophy/pragmatic.html, copylefted}
  16 @url{https://www.gnu.org/philosophy/free-sw.html, free software}:
  17 licenced under @url{https://www.gnu.org/licenses/gpl-3.0.html, GPLv3+}.
  18
  19 Currently supported algorithms are:
  20
  21 @itemize
  22 @item GOST 28147-89 (@url{https://tools.ietf.org/html/rfc5830.html, RFC 5830})
  23     block cipher with ECB, CNT (CTR), CFB, MAC,
  24     CBC (@url{https://tools.ietf.org/html/rfc4357.html, RFC 4357})
  25     modes of operation
  26 @item various 28147-89-related S-boxes included
  27 @item GOST R 34.11-94 hash function
  28     (@url{https://tools.ietf.org/html/rfc5831.html, RFC 5831})
  29 @item GOST R 34.11-2012 Стрибог (Streebog) hash function
  30     (@url{https://tools.ietf.org/html/rfc6986.html, RFC 6986})
  31 @item GOST R 34.10-2001
  32     (@url{https://tools.ietf.org/html/rfc5832.html, RFC 5832})
  33     public key signature function
  34 @item GOST R 34.10-2012
  35     (@url{https://tools.ietf.org/html/rfc7091.html, RFC 7091})
  36     public key signature function
  37 @item various 34.10 curve parameters included
  38 @item GOST R 34.12-2015 128-bit block cipher Кузнечик (Kuznechik)
  39     (@url{https://tools.ietf.org/html/rfc7801.html, RFC 7801})
  40 @item GOST R 34.13-2015 padding methods
  41 @end itemize
  42
  43 Please send questions, bug reports and patches to
  44 @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost}
  45 mailing list. Announcements also go to this mailing list.
  46
  47 @insertcopying
  48
  49 @node Download
  50 @unnumbered Download
  51
  52 Preferable way is to download tarball with the signature from
  53 website and, for example, run tests with benchmarks:
  54
  55 @verbatim
  56 % wget http://www.cypherpunks.ru/gogost/gogost-1.1.tar.xz
  57 % wget http://www.cypherpunks.ru/gogost/gogost-1.1.tar.xz.sig
  58 % gpg --verify gogost-1.1.tar.xz.sig gogost-1.1.tar.xz
  59 % xz -d < gogost-1.1.tar.gz | tar xf -
  60 % make -C gogost-1.1 bench
  61 @end verbatim
  62
  63 @multitable {XXXXX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}
  64 @headitem Version @tab Size @tab Tarball @tab SHA256 checksum @tab Streebog-256 checksum
  65
  66 @item 1.1 @tab 33 KiB
  67 @tab @url{gogost-1.1.tar.xz, link} @url{gogost-1.1.tar.xz.sig, sign}
  68 @tab @code{26D37912 6FE220C1 C0381835 DEFFDC4B BDCDC394 15D6E9C1 F8A5A302 04F9452B}
  69 @tab @code{313fa58c2c030dd5acd20b524842bd2d4ec7403fcfca2a4a238ddc187c3ef0df}
  70
  71 @end multitable
  72
  73 You @strong{have to} verify downloaded tarballs integrity and
  74 authenticity to be sure that you retrieved trusted and untampered
  75 software. @url{https://www.gnupg.org/, The GNU Privacy Guard} is used
  76 for that purpose.
  77
  78 For the very first time it it necessary to get signing public key and
  79 import it. It is provided below, but you should check alternative
  80 resources.
  81
  82 @verbatim
  83 pub   rsa2048/0x82343436696FC85A 2016-09-13 [SC]
  84       CEBD 1282 2C46 9C02 A81A  0467 8234 3436 696F C85A
  85 uid   GoGOST releases <gogost at cypherpunks dot ru>
  86 @end verbatim
  87
  88 @itemize
  89
  90 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
  91
  92 @item
  93 @verbatim
  94 % gpg --keyserver hkp://keys.gnupg.net/ --recv-keys 0x82343436696FC85A
  95 % gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
  96 % gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
  97 % gpg --auto-key-locate pka --locate-keys gogost at cypherpunks dot ru
  98 @end verbatim
  99
 100 @item
 101 @verbatiminclude PUBKEY.asc
 102
 103 @end itemize
 104
 105 You can obtain development source code by cloning
 106 @url{http://git-scm.com/, Git}
 107 @url{https://git.cypherpunks.ru/cgit.cgi/gogost.git/, repository}.
 108
 109 @bye