Building on Win 32 platforms
============================
31.7.1999, Sampo Kellomaki <sampo@iki..fi>
7.6.2002, reviewed and added comments, --Sampo
16.8.2002, added comments by Marcel Bucher --Sampo
10.7.2007. Complete rewrite to agree with latest version 1.31. References to
ancient versions and untested procedures removed --mikem
22.4.2010 Updated info for 64 bit versions --mikem

Notes: 

1. With some combinations of Windows, perl, compiler and compiler options, you
may see a runtime error "no OPENSSL_Applink", when calling
Net::SSLeay::P_PKCS12_load_file. This appears to be due to incompatible
compile options between the openssl libraries and Net::SSLeay. In particular
it has been observed with Shining Light OpenSSL See
https://www.openssl.org/support/faq.html for more details. Alas, the
apparently simple and receommended solution of adding applink.c to the SSLeay
library does not work, since applink.c need to be in the .exe file, not the
.dll for this to work. Best workaround is to build and install OpenSSL for
windows yourself.

2. If your OpenSSL is installed in an unusual place, you can tell
Net-SSLeay where to find it with the OPENSSL_PREFIX environment
variable:
set OPENSSL_PREFIX=c:\OpenSSL-1.0.1c
perl Makefile.PL
make
.....

1. Windows Server 2003
   ActivePerl 5.8.8.820
   VC++ 6.0
   Microsoft Platform SDK SVR2003R2
   Shining Light Win32 OpenSSL 0.9.7L
      http://www.shininglightpro.com/products/Win32OpenSSL.html
   Dynamic linking to SSL DLLs

Install all packages in the order listed above
Unpack and install the Net-SSLeay package
 cd Net-SSLeay-xxxx
 perl Makefile.PL
 nmake
 nmake test
 nmake install

Caution. There is an issue with Shining Light Win32 OpenSSL 0.9.7m and 0.9.8e
on Server 2003: These versions were built with VC 7.1 and the packages are
missing the 7.1 runtime DLL. This means that the openssl binaries from those
versions will not run on a standard Server 2003 platform, and this prevents
Net-SSLeay being built. Shining Light say this problem will be fixed in later
versions, where they will revert to the earlier build procedures.

2. Windows Server 2003
   ActivePerl 5.8.8.820
   VC++ 6.0
   Microsoft Platform SDK SVR2003R2
   OpenSSL 0.9.8e source openssl-0.9.8e.tar.gz
   Dynamic linking to SSL DLLs

Install all packages in the order listed above
Unpack and build OpenSSL:
  cd openssl-0.9.8e
  perl Configure VC-WIN32 --prefix=c:/OpenSSL
  ms\do_ms
  nmake -f ms\ntdll.mak
  nmake -f ms\ntdll.mak install
(if you have trouble getting to this stage, consult INSTALL.W32)
  copy c:\OpenSSL\bin\*.dll c:\windows\system32

Unpack and install the Net-SSLeay package
 cd Net-SSLeay-xxxx
 perl Makefile.PL
 nmake
 copy c:\OpenSSL\bin\*.dll blib\arch\auto\Net\SSLeay\
 nmake test
 nmake install

3. Windows XP SP2 CAUTION: this is not working yet
   ActivePerl 5.8.8.820
   Visual Studio Express 2005
   Microsoft Platform SDK SVR2003R2
   OpenSSL 0.9.8e source openssl-0.9.8e.tar.gz
   Dynamic linking to SSL DLLs

- Install all packages in the order listed above (make sure you follow the
   instructions on the download page about adding the appropriate paths to the
   Projects and Solutions section of the Options dialog box, and updating
   corewin_express.vsprops file)
- Start a build shell with Start->All Programs->Microsoft Windows SDK->CMD Shell
- cd openssl-0.9.8e
- perl Configure VC-WIN32 --prefix=c:/OpenSSL
- ms\do_masm
- nmake -f ms\ntdll.mak
- nmake -f ms\ntdll.mak install
   (if you have trouble getting to this stage, consult INSTALL.W32)
- cd Net-SSLeay-xxxx
- perl Makefile.PL
- nmake
- copy c:\OpenSSL\bin\*.dll blib\arch\auto\Net\SSLeay\
- nmake test
  CAUTION: nmake test fails at this stage. Any suggestions?? This may be
   relevant: http://www.itwriting.com/blog/?postid=261&replyto=2542
- nmake install

4. Windows XP SP2
   Strawberry Perl 5.8.8-alpha-2
   OpenSSL 0.9.8e source openssl-0.9.8e.tar.gz

- Install Strawberry Perl by running the installer
  (strawberry-perl-5.8.8-alpha-2.exe in this example)
- Unpack openssl-0.9.8e.tar.gz
- cd openssl-0.9.8e
- ms\mingw32
- cd out
- ..\ms\test
   (if you have trouble getting to this stage, consult INSTALL.W32)
- md c:\openssl 
- md c:\openssl\bin
- md c:\openssl\lib
- md c:\openssl\include
- md c:\openssl\include\openssl
- copy /b inc32\openssl\*       c:\openssl\include\openssl
- copy /b out\libssl32.a c:\openssl\lib
- copy /b out\libeay32.a c:\openssl\lib
- copy /b libssl32.dll c:\openssl\bin
- copy /b libeay32.dll c:\openssl\bin
- copy /b out\openssl.exe  c:\openssl\bin
- cd Net-SSLeay-xxxx
- c:\strawberry-perl\perl\bin\perl Makefile.PL
- dmake
- copy c:\openssl\bin\*.dll blib/arch/auto/Net/SSLeay
- dmake install

4. Windows XP SP2
   Perl CamelPack perl-camelpack-5.8.7.exe
   Shining Light Win32 OpenSSL 0.9.7L
      http://www.shininglightpro.com/products/Win32OpenSSL.html

Install all packages in the order listed above
Unpack and install the Net-SSLeay package
 cd Net-SSLeay-xxxx
 perl Makefile.PL (accept external tests and extra CPAN installs)
 nmake
 nmake install

(Note that 'nmake test' does not seem to work with CamelPack 5.8.7)

5. Windows Server 2003
   ActivePerl 5.8.8.820
   VC++ 6.0
   Microsoft Platform SDK SVR2003R2
   OpenSSL 0.9.8e source openssl-0.9.8e.tar.gz + tls extensions patch 
    from Radiator/goodies/openssl-0.9.8e-session-ticket-osc.patch   
   Dynamic linking to SSL DLLs

Install all packages in the order listed above
Unpack, patch and  and build OpenSSL, patch with 
  cd openssl-0.9.8e+extensions
  patch -p1 < Radiator/goodies/openssl-0.9.8e-session-ticket-osc.patch                 
  perl Configure VC-WIN32 --prefix=c:/OpenSSL enable-tlsext
  ms\do_ms
  nmake -f ms\ntdll.mak
  nmake -f ms\ntdll.mak install
(if you have trouble getting to this stage, consult INSTALL.W32)
  copy c:\OpenSSL\bin\*.dll c:\windows\system32

Unpack and install the Net-SSLeay package
 cd Net-SSLeay-xxxx
 perl Makefile.PL
 nmake
 copy c:\OpenSSL\bin\*.dll blib\arch\auto\Net\SSLeay\
 nmake test
 nmake install

6. Windows Server 2003
   ActivePerl 5.10.1
   Microsoft Platform SDK 2003 SP1
   OpenSSL 0.9.8i source including TLS extensions
   Dynamic linking to SSL DLLs

Build OpenSSL
   S:
   cd \openssl-0.9.8i+extensions
   nmake -f ms\ntdll.mak clean
   perl Configure VC-WIN64A --prefix=c:/OpenSSL enable-tlsext
   ms\do_win64a
   nmake -f ms\ntdll.mak
   cd out32dll
   ..\ms\test
   nmake -f ms\ntdll.mak install
Now build Net-SSLeay
   nmake clean
   R:
   cd \net-ssleay\trunk
   perl Makefile.PL
   nmake
   copy c:\OpenSSL\bin\*.dll blib\arch\auto\Net\SSLeay
   nmake test
   nmake install

7. Windows XP Professional SP3
  ActivePerl 5.16.1
  OpenSSL 1.0.1j binary from http://slproweb.com/download/Win32OpenSSL-1_0_1j.exe
  Visual C++ 2008 Redistributables from http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF
  Microsoft Visual Studio 2010 Express
   with Visual Studio Command Prompt shell:
   R:
   cd \net-ssleay\trunk
   perl Makefile.PL
   nmake
   nmake test (some warnings will be reported)

8. Windows XP Professional SP3 on VMWare
  ActivePerl 5.16.1
  OpenSSL 1.0.1 source code
  Microsoft Visual Studio 2010 Express
   with Visual Studio Command Prompt shell:
Build OpenSSL
   S:
   cd \openssl-1.0.1e
   perl Configure VC-WIN32 no-asm --prefix=c:/OpenSSL 
   ms\do_ms
   nmake -f ms\ntdll.mak
   nmake -f ms\ntdll.mak install
Now build Net-SSLeay
   R:
   cd \net-ssleay\trunk
   nmake clean
   perl Makefile.PL
   nmake
   nmake test (some warnings will be reported)
