6 Preferable way is to download tarball with the signature from
7 website and, for example, run tests with benchmarks:
10 $ [fetch|wget] http://www.gogost.cypherpunks.ru/gogost-@value{VERSION}.tar.xz
11 $ [fetch|wget] http://www.gogost.cypherpunks.ru/gogost-@value{VERSION}.tar.xz.sig
12 $ gpg --verify gogost-@value{VERSION}.tar.xz.sig gogost-@value{VERSION}.tar.xz
13 $ xz --decompress --stdout gogost-@value{VERSION}.tar.xz | tar xf -
14 $ cd gogost-@value{VERSION}
17 $ echo hello world | ./streebog256
18 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
21 It uses @url{http://cr.yp.to/redo.html, redo} build system for that
22 examples. You can use either dozen of various implementations, or at
23 least minimalistic POSIX shell @code{apenwarr/do}:
26 $ [fetch|wget] https://github.com/apenwarr/redo/raw/master/minimal/do
27 $ mv do redo ; chmod +x redo
30 @include download.texi
32 And then you can include its source code in your project for example
37 $ cp -r gogost-@value{VERSION}/src/go.cypherpunks.ru myproj/src
38 $ export GOPATH=$PWD/myproj
47 "go.cypherpunks.ru/gogost/v4/gost34112012256"
51 h := gost34112012256.New()
52 h.Write([]byte("hello world\n"))
53 fmt.Println(hex.EncodeToString(h.Sum(nil)))
57 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
60 You @strong{have to} verify downloaded tarballs integrity and
61 authenticity to be sure that you retrieved trusted and untampered
62 software. @url{https://www.gnupg.org/, GNU Privacy Guard} is used
65 For the very first time it is necessary to get signing public key and
66 import it. It is provided below, but you should check alternative
70 pub rsa2048/0x82343436696FC85A 2016-09-13 [SC]
71 CEBD 1282 2C46 9C02 A81A 0467 8234 3436 696F C85A
72 uid GoGOST releases <gogost at cypherpunks dot ru>
77 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
81 $ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
82 $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
86 @verbatiminclude PUBKEY.asc
90 GoGOST is also @command{go get}-able. For example to use
91 @command{streebog256} utility:
94 $ go get go.cypherpunks.ru/gogost/cmd/streebog256
97 @code{go.cypherpunks.ru} uses @url{http://www.ca.cypherpunks.ru/, ca.cypherpunks.ru}
98 certificate authority. If you have issues using either
99 @code{sum.golang.org} or @code{proxy.golang.org}, then you can disable
100 their usage with @env{GOPRIVATE=go.cypherpunks.ru/gogost} environment
103 Also you can use @code{replace} feature inside your @file{go.mod}, like:
106 require go.cypherpunks.ru/gogost/v4 v@value{VERSION}
107 replace go.cypherpunks.ru/gogost/v4 => /home/stargrave/gogost-@value{VERSION}/src/go.cypherpunks.ru/gogost/v4
110 You can obtain development source code with
111 @command{git clone git://git.cypherpunks.ru/gogost.git}.