]> git.rkrishnan.org Git - tahoe-lafs/tahoe-lafs.git/blob - README.win32
contrib/README: make it clear that these things might not work
[tahoe-lafs/tahoe-lafs.git] / README.win32
1 BUILDING ALLMYDATA.ORG TAHOE ON WINDOWS
2
3 There are three ways to do it:
4
5 OPTION 1: ALL CYGWIN ALL THE TIME 
6
7 If you are building on Windows, then the easy way is to install cygwin
8 and use the cygwin version of Python and the cygwin versions of all
9 dependencies (which will happen naturally if you follow the main
10 README file -- note that you cannot use Windows-native versions of any
11 of the dependencies -- they all have to be the cygwin versions).  So
12 if you are taking this approach then you don't need to read the rest
13 of this README.win32 file at all.
14
15 OPTION 2: CYGWIN TOOLS TO BUILD WINDOWS-NATIVE LIBRARIES
16
17 The second-easiest way is to install cygwin and use cygwin development
18 tools such as bash, GNU make, gcc, etc., but install the
19 Windows-native version of Python and the Windows-native versions of
20 all of the dependencies.  If you create a distutils config file (as
21 per http://docs.python.org/inst/config-syntax.html ) and put "[build]"
22 then "compiler=mingw32" in it, then you can follow the rest of the
23 main README file and the dependencies will all be automatically built
24 (by the cygwin gcc compiler) as Windows-native libraries.  This
25 README.win32 file contains some extra notes about how to take this
26 approach.
27
28 OPTION 3: OTHER BUILD TOOLS
29
30 The third-easiest way is to use a Microsoft compiler or some other
31 compiler.  Our README files do not currently explain how to do that.
32 You are on your own for now, but please feel free to contribute a
33 document which explains how to build all these dependencies using your
34 favorite compiler.XXX MikeB: the previous paragraph is false -- please
35 fix it!  --Zooko
36
37
38 Okay, here are some notes about following "OPTION 2: CYGWIN TOOLS TO BUILD
39 WINDOWS-NATIVE LIBRARIES" approach:
40
41
42 EXTRA MANUAL DEPENDENCIES
43
44 In addition to the dependencies listed in the main README file, you
45 also need the following:
46
47  + the pywin32 package (210 or later)
48
49    http://sourceforge.net/projects/pywin32/
50
51
52 NOTES ABOUT BUILDING OPENSSL
53
54 In order to compile the tahoe source you need to have libeay32.dll version
55 0.9.8.5 and ssleay32.dll version 0.9.8.5 or newer installed. If you find that 
56 you have the wrong version of either of these dlls, you can download and 
57 compile openssl from http://openssl.org. 
58
59 You will need to have perl installed to compile openssl. One place where you 
60 can find a version of perl is http://www.activestate.com/products/activeperl.
61
62 If you want to compile openssl using Visual Studio, you may find adding your 
63 Visual Studio bin, include and lib directories to your %PATH% environment 
64 variable helpful. For example, if you're compiling with VS2005:
65
66    "C:\Program Files\Microsoft Visual Studio\VC98\Bin;C:\Program Files\
67    Microsoft Visual Studio 8\VC\include;C:\Program Files\Microsoft Visual 
68    Studio 8\VC\PlatformSDK\Include;C:\Program Files\Microsoft Visual Studio 
69    8\VC\lib;C:\Program Files\Microsoft Visual Studio 8\VC\PlatformSDK\Lib"
70  
71
72 NOTES ABOUT INSTALLING PYOPENSSL
73
74 To install PyOpenSSL on Windows-native, download this:
75
76 http://allmydata.org/source/pyOpenSSL-0.6.win32-py2.5.exe
77
78 or for Python 2.4, this:
79
80 http://allmydata.org/source/pyOpenSSL-0.6.win32-py2.4.exe