6 Preferable way is to download tarball with the signature from
7 website and, for example, run tests with benchmarks:
10 $ [fetch|wget] http://gogost.cypherpunks.ru/gogost-@value{VERSION}.tar.xz
11 $ [fetch|wget] http://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 $ make -C gogost-@value{VERSION} all bench
15 $ echo hello world | gogost-@value{VERSION}/streebog256
16 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
19 @include download.texi
21 And then you can include its source code in your project for example
26 $ cp -r gogost-@value{VERSION}/src/go.cypherpunks.ru myproj/src
27 $ export GOPATH=$PWD/myproj
36 "go.cypherpunks.ru/gogost/v4/gost34112012256"
40 h := gost34112012256.New()
41 h.Write([]byte("hello world\n"))
42 fmt.Println(hex.EncodeToString(h.Sum(nil)))
46 f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
49 You @strong{have to} verify downloaded tarballs integrity and
50 authenticity to be sure that you retrieved trusted and untampered
51 software. @url{https://www.gnupg.org/, GNU Privacy Guard} is used
54 For the very first time it is necessary to get signing public key and
55 import it. It is provided below, but you should check alternative
59 pub rsa2048/0x82343436696FC85A 2016-09-13 [SC]
60 CEBD 1282 2C46 9C02 A81A 0467 8234 3436 696F C85A
61 uid GoGOST releases <gogost at cypherpunks dot ru>
66 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
70 $ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
71 $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
75 @verbatiminclude PUBKEY.asc
79 GoGOST is also @command{go get}-able. For example to use
80 @command{streebog256} utility:
83 $ go get go.cypherpunks.ru/gogost/cmd/streebog256
86 @code{go.cypherpunks.ru} uses @url{https://www.cacert.org/, CACert.org}
87 certificate authority, that is not included by default in some operating
88 system distributions and probably you have to install it in your system,
89 because @command{go get} uses HTTPS connections. If you have issues
90 using either @code{sum.golang.org} or @code{proxy.golang.org}, then you
91 can disable their usage with @env{GOPRIVATE=go.cypherpunks.ru/gogost}
94 Also you can use @code{replace} feature inside your @file{go.mod}, like:
97 require go.cypherpunks.ru/gogost/v4 v@value{VERSION}
98 replace go.cypherpunks.ru/gogost/v4 => /home/stargrave/gogost-@value{VERSION}/src/go.cypherpunks.ru/gogost/v4
101 You can obtain development source code with
102 @command{git clone git://git.cypherpunks.ru/gogost.git}.