download.texi

   1 @node Download
   2 @unnumbered Download
   3
   4 Preferable way is to download tarball with the signature from
   5 website and, for example, run tests with benchmarks:
   6
   7 @verbatim
   8 % wget http://gogost.cypherpunks.ru/gogost-1.1.tar.xz
   9 % wget http://gogost.cypherpunks.ru/gogost-1.1.tar.xz.sig
  10 % gpg --verify gogost-1.1.tar.xz.sig gogost-1.1.tar.xz
  11 % xz -d < gogost-1.1.tar.xz | tar xf -
  12 % make -C gogost-1.1 all bench
  13 % echo hello world | ./gogost-1.1/streebog256
  14 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
  15 @end verbatim
  16
  17 And then you can include its source code in your project for example
  18 like this:
  19
  20 @verbatim
  21 % mkdir -p myproj/src
  22 % export GOPATH=$PWD/myproj
  23 % cd myproj/src
  24 % cat > main.go <<EOF
  25 package main
  26
  27 import (
  28     "encoding/hex"
  29     "fmt"
  30
  31     "cypherpunks.ru/gogost/gost34112012256"
  32 )
  33
  34 func main() {
  35     h := gost34112012256.New()
  36     h.Write([]byte("hello world"))
  37     fmt.Println(hex.EncodeToString(h.Sum(nil)))
  38 }
  39 EOF
  40 % cp -r ../../gogost-1.1/src/cypherpunks.ru .
  41 % go run main.go
  42 c600fd9dd049cf8abd2f5b32e840d2cb0e41ea44de1c155dcd88dc84fe58a855
  43 @end verbatim
  44
  45 @multitable {XXXXX} {XXXX-XX-XX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}
  46 @headitem Version @tab Date @tab Size @tab Tarball @tab SHA256 checksum @tab Streebog-256 checksum
  47
  48 @item @ref{Release 2.0, 2.0} @tab 2016-11-26 @tab 39 KiB
  49 @tab @url{gogost-2.0.tar.xz, link} @url{gogost-2.0.tar.xz.sig, sign}
  50 @tab @code{28E8C15C 0EC5CC2A 47A8CCDA DF9EADB5 E46970AA FB7FAAF3 AA250FFC 79CE57F7}
  51 @tab @code{e2858b9c1e7834663838c44b9b9ebbd1f37e5b85ceba5698b6fb5d180e071710}
  52
  53 @item 1.2 @tab 2016-11-13 @tab 34 KiB
  54 @tab @url{gogost-1.2.tar.xz, link} @url{gogost-1.2.tar.xz.sig, sign}
  55 @tab @code{B894D0E4 923F0361 8A33A360 65AE860F FCFAF8F5 42A82D71 EA0A0BA7 7BC99093}
  56 @tab @code{fc6d3533e28d356398877674b6ee18954581c7f46832a5cf994ae243ab00ddf5}
  57
  58 @item @ref{Release 1.1, 1.1} @tab 2016-10-04 @tab 33 KiB
  59 @tab @url{gogost-1.1.tar.xz, link} @url{gogost-1.1.tar.xz.sig, sign}
  60 @tab @code{26D37912 6FE220C1 C0381835 DEFFDC4B BDCDC394 15D6E9C1 F8A5A302 04F9452B}
  61 @tab @code{313fa58c2c030dd5acd20b524842bd2d4ec7403fcfca2a4a238ddc187c3ef0df}
  62
  63 @end multitable
  64
  65 You @strong{have to} verify downloaded tarballs integrity and
  66 authenticity to be sure that you retrieved trusted and untampered
  67 software. @url{https://www.gnupg.org/, The GNU Privacy Guard} is used
  68 for that purpose.
  69
  70 For the very first time it is necessary to get signing public key and
  71 import it. It is provided below, but you should check alternative
  72 resources.
  73
  74 @verbatim
  75 pub   rsa2048/0x82343436696FC85A 2016-09-13 [SC]
  76       CEBD 1282 2C46 9C02 A81A  0467 8234 3436 696F C85A
  77 uid   GoGOST releases <gogost at cypherpunks dot ru>
  78 @end verbatim
  79
  80 @itemize
  81
  82 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
  83
  84 @item
  85 @verbatim
  86 % gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
  87 % gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
  88 @end verbatim
  89
  90 @item
  91 @verbatiminclude PUBKEY.asc
  92
  93 @end itemize
  94
  95 You can obtain development source code by cloning
  96 @url{http://git-scm.com/, Git}
  97 @url{https://git.cypherpunks.ru/cgit.cgi/gogost.git/}.