1Building with Visual C++, prerequises
2=====================================
3
4   This document describes how to compile, build and install curl and libcurl
5   from sources using the Visual C++ build tool. To build with VC++, you will
6   of course have to first install VC++. The minimum required version of
7   VC is 6 (part of Visual Studio 6). However using a more recent version is
8   strongly recommended.
9
10   VC++ is also part of the Windows Platform SDK. You do not have to install
11   the full Visual Studio or Visual C++ if all you want is to build curl.
12
13   The latest Platform SDK can be downloaded freely from:
14
15    http://msdn.microsoft.com/en-us/windows/bb980924
16
17   If you are building with VC6 then you will also need the February 2003
18   Edition of the Platform SDK which can be downloaded from:
19
20    http://www.microsoft.com/en-us/download/details.aspx?id=12261
21
22   If you wish to support zlib, openssl, ssh2, you will have to download
23   them separately and copy them to the deps directory as shown below:
24   
25   somedirectory\
26    |_curl-src
27    | |_winbuild
28    |
29    |_deps
30      |_ lib
31      |_ include
32      |_ bin
33
34   It is also possible to create the deps directory in some other random
35   places and tell the Makefile its location using the WITH_DEVEL option.
36
37Building with Visual C++
38========================
39
40Open a Visual Studio Command prompt or the SDK CMD shell.
41
42    Using the CMD Shell:
43     choose the right environment via the setenv command (see setenv /?)
44     for the full list of options. setenv /xp /x86 /release for example.
45
46    Using the Visual Studio command prompt Shell:
47     Everything is already pre-configured by calling one of the command
48     prompt.
49
50Once you are in the console, go to the winbuild directory in the Curl 
51sources:
52    cd curl-src\winbuild
53
54Then you can call nmake /f Makefile.vc with the desired options (see below).
55The builds will be in the top src directory, builds\ directory, in 
56a directory named using the options given to the nmake call.
57
58nmake /f Makefile.vc mode=<static or dll> <options>
59
60where <options> is one or many of:
61  VC=<6,7,8,9,10,11,12>        - VC versions
62  WITH_DEVEL=<path>            - Paths for the development files (SSL, zlib, etc.)
63                                 Defaults to sibbling directory deps: ../deps
64                                 Libraries can be fetched at http://windows.php.net/downloads/php-sdk/deps/
65                                 Uncompress them into the deps folder.
66  WITH_SSL=<dll or static>     - Enable OpenSSL support, DLL or static
67  WITH_ZLIB=<dll or static>    - Enable zlib support, DLL or static
68  WITH_SSH2=<dll or static>    - Enable libSSH2 support, DLL or static
69  ENABLE_SSPI=<yes or no>      - Enable SSPI support, defaults to yes
70  ENABLE_IPV6=<yes or no>      - Enable IPv6, defaults to yes
71  ENABLE_IDN=<yes or no>       - Enable use of Windows IDN APIs, defaults to yes
72                                 Requires Windows Vista or later, or installation from:
73                                 http://www.microsoft.com/downloads/details.aspx?FamilyID=AD6158D7-DDBA-416A-9109-07607425A815
74  ENABLE_WINSSL=<yes or no>    - Enable native Windows SSL support, defaults to yes
75  GEN_PDB=<yes or no>          - Generate Program Database (debug symbols for release build)
76  DEBUG=<yes or no>            - Debug builds
77  MACHINE=<x86 or x64>         - Target architecture (default is x86)
78