Merge branch 'rpcssl-help' of github.com:dooglus/bitcoin into dooglus-rpcssl-help
[novacoin.git] / build-msw.txt
1 Copyright (c) 2009-2010 Satoshi Nakamoto
2 Distributed under the MIT/X11 software license, see the accompanying
3 file license.txt or http://www.opensource.org/licenses/mit-license.php.
4 This product includes software developed by the OpenSSL Project for use in
5 the OpenSSL Toolkit (http://www.openssl.org/).  This product includes
6 cryptographic software written by Eric Young (eay@cryptsoft.com).
7
8
9 WINDOWS BUILD NOTES
10 ===================
11
12 Compilers Supported
13 -------------------
14 MinGW GCC (recommended)
15 http://tdm-gcc.tdragon.net/ has an easy installer.  Go back a few versions
16 for a little older gcc like gcc 4.4.?.
17
18 MSVC 8.0 (2005) SP1 has been tested.  Note: MSVC 7.0 and up have a habit of
19 linking to runtime DLLs that are not installed on XP by default.
20
21
22 Dependencies
23 ------------
24 Libraries you need to download separately and build:
25
26              default path  download
27 wxWidgets-2.9  \wxwidgets   http://www.wxwidgets.org/downloads/
28 OpenSSL        \openssl     http://www.openssl.org/source/
29 Berkeley DB    \db          http://www.oracle.com/technology/software/products/berkeley-db/index.html
30 Boost          \boost       http://www.boost.org/users/download/
31
32 Their licenses:
33 wxWidgets      LGPL 2.1 with very liberal exceptions
34 OpenSSL        Old BSD license with the problematic advertising requirement
35 Berkeley DB    New BSD license with additional requirement that linked software must be free open source
36 Boost          MIT-like license
37
38 Versions used in this release:
39 MinGW GCC    3.4.5
40 wxWidgets    2.9.0
41 OpenSSL      0.9.8k
42 Berkeley DB  4.7.25.NC
43 Boost        1.42.1
44
45
46 Notes
47 -----
48 The UI layout is edited with wxFormBuilder.  The project file is
49 uiproject.fbp.  It generates uibase.cpp and uibase.h, which define base
50 classes that do the rote work of constructing all the UI elements.
51
52 The release is built with GCC and then "strip bitcoin.exe" to strip the debug
53 symbols, which reduces the executable size by about 90%.
54
55
56 wxWidgets
57 ---------
58 cd \wxwidgets\build\msw
59 make -f makefile.gcc
60  or
61 nmake -f makefile.vc
62
63
64 OpenSSL
65 -------
66 If you want to exclude unused optional algorithms, a few patches are required.
67 (instructions for OpenSSL v0.9.8k)
68
69 Edit engines\e_gmp.c and engines\e_capi.c and add this #ifndef around
70 the openssl/rsa.h include:
71   #ifndef OPENSSL_NO_RSA
72   #include <openssl/rsa.h>
73   #endif
74
75 Edit ms\mingw32.bat and replace the Configure line's parameters with this
76 no-everything list.  You have to put this in the batch file because batch
77 files can't take more than nine command line parameters.
78   perl Configure mingw threads no-rc2 no-rc4 no-rc5 no-idea no-des no-bf no-cast no-aes no-camellia no-seed no-rsa no-dh
79
80 Also REM out the following line in ms\mingw32.bat after the mingw32-make
81 line.  The build fails after it's already finished building libeay32, which
82 is all we care about, but the failure aborts the script before it runs
83 dllwrap to generate libeay32.dll.
84   REM  if errorlevel 1 goto end
85
86 Build
87   cd \openssl
88   ms\mingw32.bat
89
90 If you're using MSVC, generate the .lib file
91   lib /machine:i386 /def:ms\libeay32.def /out:out\libeay32.lib
92
93
94 Berkeley DB
95 -----------
96 Using MinGW and MSYS:
97 cd \db\build_unix
98 sh ../dist/configure --enable-mingw --enable-cxx
99 make
100
101
102 Boost
103 -----
104 download bjam.exe from
105 http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=72941
106 cd \boost
107 bjam toolset=gcc --build-type=complete stage
108  or
109 bjam toolset=msvc --build-type=complete stage