doc/tor-win32-mingw-creation.txt

   1 ## Instructions for building Tor with MinGW (http://www.mingw.org/)
   2 ##
   3
   4 Stage One:  Download and Install MinGW.
   5 ---------------------------------------
   6
   7 Download mingw:
   8 http://prdownloads.sf.net/mingw/MinGW-5.1.3.exe?download
   9
  10 Download msys:
  11 http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download
  12
  13 Download the mingw developer tool kit:
  14 http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download
  15
  16 Download the mingw autoconf-2.59 update:
  17 http://prdownloads.sf.net/mingw/msys-autoconf-2.59.tar.bz2?download
  18
  19 Install mingw, msys and mingw-dtk.  Extract msys-autoconf-2.59.tar.bz2 into
  20 your mingw install location.  For example, if you installed mingw into
  21 /c/mingw/1.0/ you want to extract msys-autoconf-2.59.tar.bz2 into this
  22 directory.
  23
  24 Create a directory called "tor-mingw".
  25
  26 Stage Two:  Download, extract, compile openssl
  27 ----------------------------------------------
  28
  29 Download openssl:
  30 http://www.openssl.org/source/openssl-0.9.8g.tar.gz
  31
  32 Extract openssl:
  33 Copy the openssl tarball into the "tor-mingw" directory.
  34 Type "cd tor-mingw/"
  35 Type "tar zxf openssl-0.9.8g.tar.gz"
  36
  37 Make openssl libraries:
  38 Type "cd tor-mingw/openssl-0.9.8g/"
  39 Type "./Configure -no-idea -no-rc5 -no-mdc2 mingw"
  40 Edit Makefile and remove the "test:" and "tests:" sections.
  41 Type "rm -rf ./test"
  42 Type "cd crypto/"
  43 Type "find ./ -name "*.h" -exec cp {} ../include/openssl/ \;"
  44 Type "cd ../ssl/"
  45 Type "find ./ -name "*.h" -exec cp {} ../include/openssl/ \;"
  46 Type "cd .."
  47 Type "cp *.h include/openssl/"
  48 # The next steps can take up to 30 minutes to complete.
  49 Type "make"
  50 Type "make install"
  51
  52 Alternatively:
  53 Download the pre-compiled openssl for win32.
  54 Install and proceed.
  55
  56
  57 Stage Three:  Download, extract, compile zlib
  58 ---------------------------------------------
  59
  60 Download zlib source:
  61 http://www.zlib.net/zlib-1.2.3.tar.gz
  62
  63 Extract zlib:
  64 Copy the zlib tarball into the "tor-mingw" directory
  65 Type "cd tor-mingw/"
  66 Type "tar zxf zlib-1.2.3.tar.gz"
  67
  68 CHOICE:
  69
  70 Make zlib.a:
  71 Type "cd tor-mingw/zlib-1.2.3/"
  72 Type "./configure"
  73 Type "make"
  74 Type "make install"
  75
  76 OR
  77
  78 Make zlib1.dll:
  79 Type "cd tor-mingw/zlib-1.2.3/"
  80 Type "./configure"
  81 Type "make -f win32/Makefile.gcc"
  82
  83 Done.
  84
  85
  86 Stage Four: Download, extract, and compile libevent-1.3e
  87 ------------------------------------------------------
  88
  89 Download the libevent 1.3e release:
  90 http://www.monkey.org/~provos/libevent/
  91
  92 Copy the libevent tarball into the "tor-mingw" directory.
  93 Type "cd tor-mingw"
  94
  95 Extract libevent.
  96
  97 Type "./configure --enable-static --disable-shared"
  98 Type "make"
  99 Type "make install"
 100
 101 Stage Five:  Build Tor
 102 ----------------------
 103
 104 Download the current Tor alpha release from https://www.torproject.org/download.html.
 105 Copy the Tor tarball into the "tor-mingw" directory.
 106 Extract Tor:
 107 Type "tar zxf latest-tor-alpha.tar.gz"
 108
 109 cd tor-<version>
 110 Type "./configure"
 111 Type "make"
 112
 113 You now have a tor.exe in src/or/.  This is Tor.
 114 You now have a tor-resolve.exe in src/tools/.
 115
 116 Stage Six:  Build the installer
 117 -------------------------------
 118
 119 Install the latest NSIS:
 120 http://nsis.sourceforge.net/Download
 121
 122 Run the package script in contrib:
 123 From the Tor build directory above, run:
 124 "./contrib/package_nsis-mingw.sh"
 125
 126 The resulting Tor installer executable is in ./win_tmp/.
 127