pygost.gost3410.sign rand argument and more 34.10-2012 test vectors

[pygost.git] / download.texi

diff --git a/download.texi b/download.texi
index 3343619ad80eed1503652086399e7e3112318425..043e1fed4b0112f3eedc21395a62f00fdce72974 100644 (file)
--- a/download.texi
+++ b/download.texi
@@ -1,61 +1,71 @@
 @node Download
 @unnumbered Download
 
 @node Download
 @unnumbered Download
 

+@set VERSION 4.2
+

 No additional dependencies except Python 2.7/3.x interpreter are required.
 
 Preferable way is to download tarball with the signature:
 
 No additional dependencies except Python 2.7/3.x interpreter are required.
 
 Preferable way is to download tarball with the signature:
 

-@verbatim
-% wget http://pygost.cypherpunks.ru/pygost-3.8.tar.xz
-% wget http://pygost.cypherpunks.ru/pygost-3.8.tar.xz.sig
-% gpg --verify pygost-3.8.tar.xz.sig pygost-3.8.tar.xz
-% xz -d < pygost-3.8.tar.xz | tar xf -
-% cd pygost-3.8
-% python setup.py install
-@end verbatim
+@example
+$ [fetch|wget] http://pygost.cypherpunks.ru/pygost-@value{VERSION}.tar.xz
+$ [fetch|wget] http://pygost.cypherpunks.ru/pygost-@value{VERSION}.tar.xz.sig
+$ gpg --verify pygost-@value{VERSION}.tar.xz.sig pygost-@value{VERSION}.tar.xz
+$ xz --decompress --stdout pygost-@value{VERSION}.tar.xz | tar xf -
+$ cd pygost-@value{VERSION}
+$ python setup.py install
+@end example

 
 @multitable {XXXXX} {XXXX-XX-XX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}
 @headitem Version @tab Date @tab Size @tab Tarball @tab SHA256 checksum @tab Streebog-256 checksum
 
 
 @multitable {XXXXX} {XXXX-XX-XX} {XXXX KiB} {link sign} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} {xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}
 @headitem Version @tab Date @tab Size @tab Tarball @tab SHA256 checksum @tab Streebog-256 checksum
 

+@item @ref{Release 4.1, 4.1} @tab 2019-12-17 @tab 60 KiB
+@tab @url{pygost-4.1.tar.xz, link} @url{pygost-4.1.tar.xz.sig, sign}
+@tab @code{CF029E30 8207DF45 884DD118 843A9E5A 33C5D979 F1D05FEA 17B81628 41257A64}
+@tab @code{5ac0ab2989f5dd5ed3f941f40db5e6e0eba7d84708b376b95eb7396427b2511e}
+
+@item @ref{Release 4.0, 4.0} @tab 2019-07-19 @tab 61 KiB
+@tab @url{pygost-4.0.tar.xz, link} @url{pygost-4.0.tar.xz.sig, sign}
+@tab @code{E4A329A9 AB0A781A 254AF940 10237D4C 9EEB37CB F849BA1C EA7BAF60 E3BB98B3}
+@tab @code{d2646d1815338bb5e2b41388e34f2f445828d10c3253e1996fc5d8d865cdf94f}
+
+@item @ref{Release 3.15, 3.15} @tab 2018-12-09 @tab 54 KiB
+@tab @url{pygost-3.15.tar.xz, link} @url{pygost-3.15.tar.xz.sig, sign}
+@tab @code{930C4DAB 580F43A6 D2D32560 A77B877D 0C88F4F6 421307AA 36B7132F 04F8EA89}
+@tab @code{2d0742c70d76fceb20ac7db750dea5337b7584a0ae938a289c46ee9945439eb1}
+
+@item @ref{Release 3.14, 3.14} @tab 2018-12-03 @tab 49 KiB
+@tab unavailable @tab @tab
+
+@item @ref{Release 3.13, 3.13} @tab 2018-12-03 @tab 49 KiB
+@tab unavailable @tab @tab
+
+@item @ref{Release 3.12, 3.12} @tab 2018-11-05 @tab 44 KiB
+@tab unavailable @tab @tab
+

 @item @ref{Release 3.11, 3.11} @tab 2018-09-21 @tab 44 KiB
 @item @ref{Release 3.11, 3.11} @tab 2018-09-21 @tab 44 KiB

-@tab @url{pygost-3.11.tar.xz, link} @url{pygost-3.11.tar.xz.sig, sign}
-@tab @code{34C092B7 78778DD4 1587BD31 AC62E7E6 3C45CEB8 7B664293 CCCA66DB 21147835}
-@tab @code{fdf1f96b93feb7ef5d6cd2f525a493bcd26933a1e15970f182d554595c2d2839}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.10, 3.10} @tab 2018-06-23 @tab 44 KiB
 
 @item @ref{Release 3.10, 3.10} @tab 2018-06-23 @tab 44 KiB

-@tab @url{pygost-3.10.tar.xz, link} @url{pygost-3.10.tar.xz.sig, sign}
-@tab @code{8508C513 EBA78BA3 9D4BE5DA 42A2CE39 B0EB8998 9C9EBF20 5E100A1F B594AB10}
-@tab @code{357fe05d52f1d30e0972a3b7fa381bdc84be45ebcc01e59d921c78d8e3a456c0}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.9, 3.9} @tab 2018-05-05 @tab 44 KiB
 
 @item @ref{Release 3.9, 3.9} @tab 2018-05-05 @tab 44 KiB

-@tab @url{pygost-3.9.tar.xz, link} @url{pygost-3.9.tar.xz.sig, sign}
-@tab @code{EA734025 6A892D4C 6272E577 B773CADA 6D5DEAB5 651D82D0 4721F92C 068CCC10}
-@tab @code{4302d934b9ccfbd63da4e3587eff322cbf6712fa45ffeb917fb831121a673dc9}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.8, 3.8} @tab 2018-04-30 @tab 44 KiB
 
 @item @ref{Release 3.8, 3.8} @tab 2018-04-30 @tab 44 KiB

-@tab @url{pygost-3.8.tar.xz, link} @url{pygost-3.8.tar.xz.sig, sign}
-@tab @code{C8219F12 900B15D6 DA479157 BC48EE08 8BDF7FD0 548E02E4 16B44B6A 4A2FFDD3}
-@tab @code{0ad60ab474171cb72aa7282a77e5a87a3b8c6f958a0d781504dde2f82e7b839a}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.7, 3.7} @tab 2017-12-24 @tab 43 KiB
 
 @item @ref{Release 3.7, 3.7} @tab 2017-12-24 @tab 43 KiB

-@tab @url{pygost-3.7.tar.xz, link} @url{pygost-3.7.tar.xz.sig, sign}
-@tab @code{2BE1647A 2ED7C794 7B80EBFA 32EB71B1 2AA95711 71CAA0CE E8319BF7 17361E28}
-@tab @code{b76ba4964a61b15a65be60c19d85063b88222fff881d9a9a8ff7dd8a07b2fc67}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.6, 3.6} @tab 2017-11-28 @tab 43 KiB
 
 @item @ref{Release 3.6, 3.6} @tab 2017-11-28 @tab 43 KiB

-@tab @url{pygost-3.6.tar.xz, link} @url{pygost-3.6.tar.xz.sig, sign}
-@tab @code{37EA8A31 B308DBC6 B3229922 ABA0355F 46008BEC 2649BF98 11F62091 17BD94B3}
-@tab @code{47495afde7218e5d01160800daa0f9c786f5c95579686b0ce5a37fb7550bc735}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.5, 3.5} @tab 2017-08-25 @tab 43 KiB
 
 @item @ref{Release 3.5, 3.5} @tab 2017-08-25 @tab 43 KiB

-@tab @url{pygost-3.5.tar.xz, link} @url{pygost-3.5.tar.xz.sig, sign}
-@tab @code{14E504AE 81E74DDD 122E5BF1 0B9E25D7 82D51AB6 5ED43533 0BF276A4 8A7C7AA4}
-@tab @code{eb2106523cf8ed1b462d7a0a57f771f94759047a7e0e5a0b96ee35b24293e264}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.4, 3.4} @tab 2017-08-19 @tab 43 KiB
 
 @item @ref{Release 3.4, 3.4} @tab 2017-08-19 @tab 43 KiB

-@tab @url{pygost-3.4.tar.xz, link} @url{pygost-3.4.tar.xz.sig, sign}
-@tab @code{89715612 8A197071 AD7689FA 96F89304 19E42F76 87632309 B47E5FDE 1AD6126D}
-@tab @code{e590ddc7485e6f99658f26ac23cd2266648f27efa584a33f93abec8b80e1771d}
+@tab unavailable @tab @tab

 
 @item @ref{Release 3.3, 3.3} @tab 2017-06-11 @tab 41 KiB
 @tab @url{pygost-3.3.tar.xz, link} @url{pygost-3.3.tar.xz.sig, sign}
 
 @item @ref{Release 3.3, 3.3} @tab 2017-06-11 @tab 41 KiB
 @tab @url{pygost-3.3.tar.xz, link} @url{pygost-3.3.tar.xz.sig, sign}


@@ -89,15 +99,17 @@ Preferable way is to download tarball with the signature:
 
 @end multitable
 
 
 @end multitable
 

-But also you can use PIP (@strong{no} authentication is performed!):
+But also you can use pip (@strong{no} OpenPGP authentication is
+performed!) with PyPI:

 
 

-@verbatim
-% pip install pygost==3.7
-@end verbatim
+@example
+$ echo pygost==@value{VERSION} --hash=sha256:9e8daad58a7fca0c3addd357268bff4c506074dd300887ebf96c0f1c21123835 > requirements.txt
+$ pip install --requirement requirements.txt
+@end example

 
 You @strong{have to} verify downloaded tarballs integrity and
 authenticity to be sure that you retrieved trusted and untampered
 
 You @strong{have to} verify downloaded tarballs integrity and
 authenticity to be sure that you retrieved trusted and untampered

-software. @url{https://www.gnupg.org/, The GNU Privacy Guard} is used
+software. @url{https://www.gnupg.org/, GNU Privacy Guard} is used

 for that purpose.
 
 For the very first time it is necessary to get signing public key and
 for that purpose.
 
 For the very first time it is necessary to get signing public key and


@@ -115,17 +127,15 @@ uid   PyGOST releases <pygost at cypherpunks dot ru>
 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
 
 @item
 @item @url{https://lists.cypherpunks.ru/mailman/listinfo/gost, gost} maillist
 
 @item

-@verbatim
-% gpg --keyserver hkp://keys.gnupg.net/ --recv-keys 0xE6FD1269CD0C009E
-% gpg --auto-key-locate dane --locate-keys pygost at cypherpunks dot ru
-% gpg --auto-key-locate wkd --locate-keys pygost at cypherpunks dot ru
-@end verbatim
+@example
+$ gpg --auto-key-locate dane --locate-keys pygost at cypherpunks dot ru
+$ gpg --auto-key-locate wkd --locate-keys pygost at cypherpunks dot ru
+@end example

 
 @item
 @verbatiminclude PUBKEY.asc
 
 @end itemize
 
 
 @item
 @verbatiminclude PUBKEY.asc
 
 @end itemize
 

-You can obtain development source code by cloning
-@url{http://git-scm.com/, Git}
-@url{https://git.cypherpunks.ru/cgit.cgi/pygost.git/}.
+You can obtain development source code with
+@command{git clone git://git.cypherpunks.ru/pygost.git}.