PRF_IPSEC_PRFPLUS_GOSTR3411_2012_{256,512}

[gogost.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 690ba98156248f97362ebc8cba233f39329b29a9..22565efcf353e7069072c94417f6b3fedeca58a4 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,19 +1,19 @@
 Preferable way is to download tarball with the signature from official
 website and, for example, run tests with benchmarks:
 
 Preferable way is to download tarball with the signature from official
 website and, for example, run tests with benchmarks:
 

-    $ wget http://gogost.cypherpunks.ru/gogost-4.1.0.tar.xz
-    $ wget http://gogost.cypherpunks.ru/gogost-4.1.0.tar.xz.sig
-    $ gpg --verify gogost-4.1.0.tar.xz.sig gogost-4.1.0.tar.xz
-    $ xz -d < gogost-4.1.0.tar.xz | tar xf -
-    $ make -C gogost-4.1.0 all bench
-    $ echo hello world | ./gogost-4.1.0/streebog256
+    $ wget http://gogost.cypherpunks.ru/gogost-4.2.0.tar.xz
+    $ wget http://gogost.cypherpunks.ru/gogost-4.2.0.tar.xz.sig
+    $ gpg --verify gogost-4.2.0.tar.xz.sig gogost-4.2.0.tar.xz
+    $ xz -d < gogost-4.2.0.tar.xz | tar xf -
+    $ make -C gogost-4.2.0 all bench
+    $ echo hello world | ./gogost-4.2.0/streebog256

     f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 
 And then you can include its source code in your project for example
 like this:
 
     $ mkdir -p myproj/src
     f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 
 And then you can include its source code in your project for example
 like this:
 
     $ mkdir -p myproj/src

-    $ cp -r gogost-4.1.0/src/go.cypherpunks.ru myproj/src
+    $ cp -r gogost-4.2.0/src/go.cypherpunks.ru myproj/src

     $ export GOPATH=$PWD/myproj
     $ cd myproj/src
     $ cat > main.go <<EOF
     $ export GOPATH=$PWD/myproj
     $ cd myproj/src
     $ cat > main.go <<EOF


@@ -35,10 +35,6 @@ like this:
     $ go run main.go
     f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 
     $ go run main.go
     f72018189a5cfb803dbe1f2149cf554c40093d8e7f81c21e08ac5bcd09d9934d
 

-GoGOST is also go-get-able. For example to use streebog256 utility:
-
-    $ go get go.cypherpunks.ru/gogost/cmd/streebog256
-

 You have to verify downloaded tarballs integrity and authenticity to be
 sure that you retrieved trusted and untampered software. GNU Privacy
 Guard is used for that purpose.
 You have to verify downloaded tarballs integrity and authenticity to be
 sure that you retrieved trusted and untampered software. GNU Privacy
 Guard is used for that purpose.


@@ -54,3 +50,19 @@ resources.
     Look in PUBKEY.asc file.
     $ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
     $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru
     Look in PUBKEY.asc file.
     $ gpg --auto-key-locate dane --locate-keys gogost at cypherpunks dot ru
     $ gpg --auto-key-locate wkd --locate-keys gogost at cypherpunks dot ru

+
+GoGOST is also go-get-able. For example to use streebog256 utility:
+
+    $ go get go.cypherpunks.ru/gogost/cmd/streebog256
+
+go.cypherpunks.ru uses CACert.org certificate authority, that is not
+included by default in some operating system distributions and probably
+you have to install it in your system, because "go get" uses HTTPS
+connections. If you have issues using either sum.golang.org or
+proxy.golang.org, then you can disable their usage with
+GOPRIVATE=go.cypherpunks.ru/gogost environment variable.
+
+Also you can use "replace" feature inside your go.mod, like:
+
+    require go.cypherpunks.ru/gogost/v4 v4.2.0
+    replace go.cypherpunks.ru/gogost/v4 => /home/stargrave/gogost-4.2.0/src/go.cypherpunks.ru/gogost/v4