e5514a90 |
#!/bin/sh
|
1568d7f4 |
# This is the master OpenVPN build script for Windows. |
657ecf14 |
# This script will build OpenVPN, the TAP driver, and |
52d84f6e |
# the installer from source, targeting x86 on Windows
# 2000 and higher, and x64 on Windows 2003 and higher. |
ba865c55 |
# For quick start options, see pre-built notes below. |
1568d7f4 |
# |
1bda73a7 |
# Note that if you are only looking to build the
# openvpn user-space binaries (openvpn.exe
# and openvpnserv.exe) you can use the
# provided autoconf/automake build environment.
# |
47ae8457 |
# If you are building from an expanded .tar.gz file,
# make sure to run "./doclean" before "./domake-win".
# |
ba865c55 |
# See top-level build configuration and settings in: |
657ecf14 |
# |
1bda73a7 |
# version.m4 |
ba865c55 |
# install-win32/settings.in
#
# Mandatory prerequisites: |
657ecf14 |
#
# MinGW -- for GNU C compiler
# MSYS -- for bash
# msysDTK -- for perl
# NSIS -- for building installer |
ba865c55 |
#
# The following additional prerequisites may be omitted
# when building in pre-built mode (see note below). |
9ff2821b |
# |
657ecf14 |
# svn -- for checking out source code (or TortoiseSVN) |
ba865c55 |
# Windows Driver Kit (6001_17121_HyperV_WDK.iso) -- for building
# TAP driver + tapinstall |
52d84f6e |
#
# Required libraries (must be prebuilt)
# |
f02576fa |
# OpenSSL -- define OPENSSL_DIR in settings.in
# LZO -- define LZO_DIR in settings.in
# PKCS11-HELPER -- define PKCS11_HELPER_DIR |
657ecf14 |
# |
6102c371 |
# Optional OpenVPN GUI binary (prebuilt)
# -- define OPENVPN_GUI_DIR and OPENVPN_GUI in settings.in
# |
657ecf14 |
# Required source code not included in OpenVPN SVN repository
# because of MS licensing restrictions: |
1568d7f4 |
# |
657ecf14 |
# ../tapinstall -- This is based on 'devcon' which is found in the
# Windows Driver Kit (formerly known as DDK).
# Copy the 'devcon' source tree to ../tapinstall
# Edit 'sources' and modify TARGETNAME=tapinstall |
35a3c167 |
|
ba865c55 |
# Note that all variables referenced here such as GENOUT,
# GENOUT_PREBUILT, and CLEAN are defined in install-win32/settings.in |
63082c8a |
|
ba865c55 |
# SPECIAL NOTES ON PRE-BUILT MODE
# Setting up a complete tool chain to build OpenVPN and all
# dependencies on Windows can be an onerous task, so the capability
# is provided to reference a directory of pre-built components during |
5449d743 |
# the build process. When dependencies are missing to build a given
# component (such as the TAP driver), the build script will auto-detect
# this and use the pre-built version instead. This would allow you, for
# example, to build an OpenVPN installer with custom edits to
# install-win32/settings.in, but then avoid needing to build all other |
9ff2821b |
# components (such as OpenSSL, LZO, Pkcs11-helper, TAP driver, Windows |
5449d743 |
# service, etc.). The procedure is as follows. First Download and expand
# the pre-built binaries from: |
ba865c55 |
# |
9ff2821b |
# http://openvpn.net/prebuilt/ (choose the most recent -prebuilt .tbz file) |
ba865c55 |
#
# After expanding the .tbz file, cd to the top level directory and
# expand an OpenVPN source distribution taken from either the subversion
# repository or a source .tar.gz file. It's best to use an OpenVPN source
# version that is the same or slightly later than the pre-built binaries
# file. So now you have a directory containing something that looks like
# this:
#
# gen-prebuilt -> from prebuilt .tbz file
# lzo-2.02 -> from prebuilt .tbz file |
9ff2821b |
# openssl-0.9.8i -> from prebuilt .tbz file |
ba865c55 |
# pkcs11-helper -> from prebuilt .tbz file |
9ff2821b |
# openvpn-2.1_rc13.tar.gz -> downloaded from openvpn.net
# openvpn-2.1_rc13 -> directory expanded from above file |
ba865c55 |
# |
9ff2821b |
# Now cd to your expanded source tree (openvpn-2.1_rc13 in the |
ba865c55 |
# example above), make edits to install-win32/settings.in (or even
# patch the OpenVPN source code directly), and run this script:
#
# ./domake-win
#
# If everything runs correctly, you should have a custom installer
# written to ./gen/install
# First build the autodefs directory, containing C, sh, and NSIS versions |
63082c8a |
# of global settings, using install-win32/settings.in as source.
# These settings will then drive the rest of the build process. |
e5514a90 |
install-win32/winconfig |
63082c8a |
|
a7eef14a |
# clean all generated files |
63082c8a |
install-win32/doclean
|
ba865c55 |
# Load a pre-built GENOUT directory if GENOUT_PREBUILT is defined
# and the GENOUT directory is non-existing
install-win32/getprebuilt
|
63082c8a |
# Each of the scripts below build, get, and/or possibly sign a different
# OpenVPN component, placing the generated files in GENOUT. Each of these
# steps is fully indepedent, and can be executed in any order or omitted.
# The exception is the last script which gathers together all files from |
ba865c55 |
# GENOUT and builds the installer. |
63082c8a |
|
1bda73a7 |
# Make the OpenVPN user-space components (OpenVPN and service) |
0039dd40 |
install-win32/makeopenvpn |
63082c8a |
# Make the OpenVPN TAP driver |
e5514a90 |
install-win32/maketap |
63082c8a |
# Make the tapinstall utility, used to install the TAP driver
install-win32/maketapinstall
# Get the OpenSSL libraries from a pre-build OpenSSL tree
install-win32/getopenssl
# Get the PKCS-11 helper library from a pre-built OpenSSL tree
install-win32/getpkcs11helper
# Get the OpenVPN GUI (must be prebuilt) |
657ecf14 |
install-win32/getgui |
63082c8a |
|
9ca8f3cf |
# Get the OpenVPN XML-based GUI (must be prebuilt)
install-win32/getxgui
|
63903a82 |
# Produce the license text, install README, and sample config files
install-win32/maketext
|
63082c8a |
# This final step builds the OpenVPN installer using generated
# files from GENOUT |
e5514a90 |
install-win32/buildinstaller |