]> Cypherpunks.ru repositories - govpn.git/blobdiff - doc/installation.texi
[DOC] Update user examples, making it more understandable
[govpn.git] / doc / installation.texi
index f1fbf0db017e817028524c0959fa1b5f804fe9df..3f5bde6eeefa6a0379be8b9d5d396c8c8c08191c 100644 (file)
@@ -1,48 +1,50 @@
 @node Installation
 @unnumbered Installation
 
-GoVPN is written on Go programming language, But
-@url{https://www.gnu.org/software/make/, Make} program is recommended
-also to be used. @url{https://www.gnu.org/software/texinfo/, Texinfo} is
-used for building documentation. Also it depends on
-@code{golang.org/x/crypto} Go libraries.
+GoVPN is written on @url{http://golang.org/, Go programming language},
+@emph{Make} is recommended for convenient building.
+@url{https://www.gnu.org/software/texinfo/, Texinfo}
+is used for building documentation.
 
-@include download.texi
+Included required libraries:
 
-You @strong{have to} verify downloaded archives integrity and check
-their signature to be sure that you have got trusted, untampered
-software. For integrity and authentication of downloaded binaries
-@url{https://www.gnupg.org/, The GNU Privacy Guard} is used. You must
-download signature provided with the tarball and run for example:
+@multitable @columnfractions .40 .20 .40
+@headitem Library @tab Platform @tab Licence
+@item @code{golang.org/x/crypto} @tab All @tab BSD 3-Clause
+@item @code{github.com/agl/ed25519} @tab All @tab BSD 3-Clause
+@item @code{github.com/bigeagle/water} @tab GNU/Linux @tab BSD 3-Clause
+@end multitable
 
-@example
-gpg --verify govpn-1.5.tar.xz.sig govpn-1.5.tar.xz
-@end example
+Get the tarball and run @code{make}.
+@emph{govpn-client}, @emph{govpn-server}, @emph{govpn-verifier}
+binaries will be build in the current directory.
 
-For the very first time you must also import signing public keys. They
-are provided below, but be sure that you are reading them from the
-trusted source. Alternatively check this page from other sources and
-look for the mailing list announcements.
+As a prerequisite you must install Go compiler and possibly TUN/TAP
+interfaces utilities:
 
-You have to set up @code{$GOPATH} properly first. For example you can
-clone the repository or decompress tarball and set path like this:
+@itemize @bullet
+@item @code{lang/go} port in FreeBSD.
+@item @code{golang} and @code{uml-utilities} packages in GNU/Linux
+distributions.
+@end itemize
 
 @example
-% mkdir -p govpn/src
-% git clone https://github.com/stargrave/govpn.git govpn/src/govpn
-or
-% tar xfC govpn-1.5.tar.xz govpn/src && mv govpn/src/govpn-1.5 govpn/src/govpn
-% export GOPATH=$(pwd)/govpn:$GOPATH
+% wget http://www.cypherpunks.ru/govpn/download/govpn-2.3.tar.xz
+% wget http://www.cypherpunks.ru/govpn/download/govpn-2.3.tar.xz.sig
+% gpg --verify govpn-2.3.tar.xz.sig govpn-2.3.tar.xz
+% tar xf govpn-2.3.tar.xz
+% make -C govpn-2.3 all
 @end example
 
-After that you can just type @code{make} and all necessary Go libraries
-will be installed and client/server binaries are built in the current
-directory:
+There is @code{install} target respecting @code{DESTDIR}. It will
+install binaries, info-documentation and utilities.
 
-@example
-% cd govpn/src/govpn
-% make
-[or gmake under FreeBSD]
-@end example
+@menu
+* Prepared tarballs::
+* Development source code::
+* Tarballs integrity check::
+@end menu
 
-@include pubkey.texi
+@include download.texi
+@include sources.texi
+@include integrity.texi