[Openvpn-devel] docs: Update INSTALL

Message ID 20190327120604.21101-1-davids@openvpn.net
State Accepted
Headers show
Series [Openvpn-devel] docs: Update INSTALL | expand

Commit Message

David Sommerseth March 27, 2019, 1:06 a.m. UTC
The INSTALL file contained several minor errors, typos and was generally
not up-to-date in regards to what ./configure provides today.  In
addition, several URL references have moved around to new homes.

Signed-off-by: David Sommerseth <davids@openvpn.net>
---
 INSTALL | 104 +++++++++++++++++++++++++++++++++++---------------------
 1 file changed, 65 insertions(+), 39 deletions(-)

Comments

Gert Doering March 29, 2019, 8:10 a.m. UTC | #1
Acked-by: Gert Doering <gert@greenie.muc.de>

Thanks.  Changes look reasonable.  I have *not* applied this to release/2.4
as I assume that stuff like "openssl version" and "configure output" will
look different, so it would bring in incorrect "improvements".  (Can you
do a 2.4 version as well, please? :) )

Your patch has been applied to the master branch.

commit 6099ab67122429c04d743443a50d258b11ac1f07
Author: David Sommerseth
Date:   Wed Mar 27 13:06:04 2019 +0100

     docs: Update INSTALL

     Signed-off-by: David Sommerseth <davids@openvpn.net>
     Acked-by: Gert Doering <gert@greenie.muc.de>
     Message-Id: <20190327120604.21101-1-davids@openvpn.net>
     URL: https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg18307.html
     Signed-off-by: Gert Doering <gert@greenie.muc.de>


--
kind regards,

Gert Doering

Patch

diff --git a/INSTALL b/INSTALL
index 7c6c34e8..0ba3bba6 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,6 +1,6 @@ 
 Installation instructions for OpenVPN, a Secure Tunneling Daemon
 
-Copyright (C) 2002-2018 OpenVPN Inc. This program is free software;
+Copyright (C) 2002-2019 OpenVPN Inc. This program is free software;
 you can redistribute it and/or modify
 it under the terms of the GNU General Public License version 2
 as published by the Free Software Foundation.
@@ -10,26 +10,30 @@  as published by the Free Software Foundation.
 QUICK START:
 
   Unix:
-    ./configure && make && make-install
+    ./configure && make && make install
 
 *************************************************************************
 
-To download OpenVPN, go to:
+To download OpenVPN source code of releases, go to:
 
-    http://openvpn.net/download.html
+    https://openvpn.net/community-downloads/
 
 OpenVPN releases are also available as Debian/RPM packages:
 
     https://community.openvpn.net/openvpn/wiki/OpenvpnSoftwareRepos
 
+OpenVPN development versions can be found here:
+
+   https://github.com/OpenVPN/openvpn
+   https://gitlab.com/OpenVPN/openvpn
+   https://sourceforge.net/p/openvpn/openvpn/ci/master/tree/
+
+They should all be in sync at any time.
+
 To download easy-rsa go to:
 
     https://github.com/OpenVPN/easy-rsa
 
-To download tap-windows (NDIS 5) driver source code go to:
-
-    https://github.com/OpenVPN/tap-windows
-
 To download tap-windows (NDIS 6) driver source code go to:
 
     https://github.com/OpenVPN/tap-windows6
@@ -40,15 +44,11 @@  To get the cross-compilation environment go to:
 
 For step-by-step instructions with real-world examples see:
 
-    http://openvpn.net/howto.html
+    https://community.openvpn.net/openvpn/wiki/GettingStartedwithOVPN
     https://community.openvpn.net/openvpn/wiki
+    https://openvpn.net/community-resources/
 
-For examples see:
-
-    http://openvpn.net/examples.html
-
-Also see the man page for more information, usage examples, and information on
-firewall configuration.
+Also see the man page for more information.
 
 *************************************************************************
 
@@ -73,7 +73,7 @@  REQUIRES:
       TUN/TAP Driver Configuration section below for more info.
 
 OPTIONAL (but recommended):
-  (1) OpenSSL library, necessary for encryption, version 0.9.8 or higher
+  (1) OpenSSL library, necessary for encryption, version 1.0.1 or higher
       required, available from http://www.openssl.org/
   (2) mbed TLS library, an alternative for encryption, version 2.0 or higher
       required, available from https://tls.mbed.org/
@@ -100,11 +100,12 @@  CHECK OUT SOURCE FROM SOURCE REPOSITORY:
   Clone the repository:
 
     git clone https://github.com/OpenVPN/openvpn
+    git clone https://gitlab.com/OpenVPN/openvpn
     git clone git://openvpn.git.sourceforge.net/gitroot/openvpn/openvpn
 
   Check out stable version:
 
-    git checkout -b 2.2 remotes/origin/release/2.2
+    git checkout release/2.4
 
   Check out master (unstable) branch:
 
@@ -134,7 +135,7 @@  BUILD A TARBALL FROM SOURCE REPOSITORY CHECKOUT:
 
 	autoreconf -i -v -f
 	./configure
-	make dist
+	make distcheck
 
 *************************************************************************
 
@@ -160,24 +161,19 @@  environment. See tests/t_client.rc-sample for details.
 OPTIONS for ./configure:
 
   --disable-lzo           disable LZO compression support [default=yes]
-  --enable-lzo-stub       don't compile LZO compression support but still
-                          allow limited interoperability with LZO-enabled
-                          peers [default=no]
+  --disable-lz4           Disable LZ4 compression support
+  --enable-comp-stub      Don't compile compression support but still allow limited interoperability with compression-enabled peers
   --disable-crypto        disable crypto support [default=yes]
-  --disable-ssl           disable SSL support for TLS-based key exchange
+  --disable-ofb-cfb       disable support for OFB and CFB cipher modes
                           [default=yes]
   --enable-x509-alt-username
                           enable the --x509-username-field feature
                           [default=no]
-  --disable-multi         disable client/server support (--mode server +
-                          client mode) [default=yes]
   --disable-server        disable server support only (but retain client
                           support) [default=yes]
   --disable-plugins       disable plug-in support [default=yes]
   --disable-management    disable management server support [default=yes]
   --enable-pkcs11         enable pkcs11 support [default=no]
-  --disable-socks         disable Socks support [default=yes]
-  --disable-http-proxy    disable HTTP proxy support [default=yes]
   --disable-fragment      disable internal fragmentation support (--fragment)
                           [default=yes]
   --disable-multihome     disable multi-homed UDP server support (--multihome)
@@ -187,44 +183,74 @@  OPTIONS for ./configure:
   --disable-debug         disable debugging support (disable gremlin and verb
                           7+ messages) [default=yes]
   --enable-small          enable smaller executable size (disable OCC, usage
-                          message, and verb 4 parm list) [default=yes]
-  --enable-password-save  allow --askpass and --auth-user-pass passwords to be
-                          read from a file [default=yes]
+                          message, and verb 4 parm list) [default=no]
   --enable-iproute2       enable support for iproute2 [default=no]
   --disable-def-auth      disable deferred authentication [default=yes]
   --disable-pf            disable internal packet filter [default=yes]
+  --disable-plugin-auth-pam
+                          disable auth-pam plugin [default=platform specific]
+  --disable-plugin-down-root
+                          disable down-root plugin [default=platform specific]
+  --enable-pam-dlopen     dlopen libpam [default=no]
   --enable-strict         enable strict compiler warnings (debugging option)
                           [default=no]
   --enable-pedantic       enable pedantic compiler warnings, will not generate
                           a working executable (debugging option) [default=no]
+  --enable-werror         promote compiler warnings to errors, will cause
+                          builds to fail if the compiler issues warnings
+                          (debugging option) [default=no]
   --enable-strict-options enable strict options check between peers (debugging
                           option) [default=no]
   --enable-selinux        enable SELinux support [default=no]
   --enable-systemd        enable systemd support [default=no]
+  --enable-async-push     enable async-push support for plugins providing
+                          deferred authentication [default=no]
 
 ENVIRONMENT for ./configure:
 
+  PLUGINDIR   Path of plug-in directory [default=LIBDIR/openvpn/plugins]
   IFCONFIG    full path to ipconfig utility
   ROUTE       full path to route utility
   IPROUTE     full path to ip utility
   NETSTAT     path to netstat utility
   MAN2HTML    path to man2html utility
   GIT         path to git utility
+  SYSTEMD_ASK_PASSWORD
+              path to systemd-ask-password utility
+  SYSTEMD_UNIT_DIR
+              Path of systemd unit directory [default=LIBDIR/systemd/system]
+  TMPFILES_DIR
+              Path of tmpfiles directory [default=LIBDIR/tmpfiles.d]
+
+ENVIRONMENT variables adjusting parameters related to dependencies
+
   TAP_CFLAGS  C compiler flags for tap
-  OPENSSL_CFLAGS
-              C compiler flags for OpenSSL, overriding pkg-config
-  OPENSSL_LIBS
-              linker flags for OpenSSL, overriding pkg-config
-  POLARSSL_CFLAGS
-              C compiler flags for polarssl
-  POLARSSL_LIBS
-              linker flags for polarssl
-  LZO_CFLAGS  C compiler flags for lzo
-  LZO_LIBS    linker flags for lzo
+  LIBPAM_CFLAGS
+              C compiler flags for libpam
+  LIBPAM_LIBS linker flags for libpam
   PKCS11_HELPER_CFLAGS
               C compiler flags for PKCS11_HELPER, overriding pkg-config
   PKCS11_HELPER_LIBS
               linker flags for PKCS11_HELPER, overriding pkg-config
+  OPENSSL_CFLAGS
+              C compiler flags for OpenSSL
+  OPENSSL_LIBS
+              linker flags for OpenSSL
+  MBEDTLS_CFLAGS
+              C compiler flags for mbedtls
+  MBEDTLS_LIBS
+              linker flags for mbedtls
+  LZO_CFLAGS  C compiler flags for lzo
+  LZO_LIBS    linker flags for lzo
+  LZ4_CFLAGS  C compiler flags for lz4
+  LZ4_LIBS    linker flags for lz4
+  libsystemd_CFLAGS
+              C compiler flags for libsystemd, overriding pkg-config
+  libsystemd_LIBS
+              linker flags for libsystemd, overriding pkg-config
+  P11KIT_CFLAGS
+              C compiler flags for P11KIT, overriding pkg-config
+  P11KIT_LIBS linker flags for P11KIT, overriding pkg-config
 
 *************************************************************************