[or-cvs] r13069: Backport: update documentation to match the new installers. (tor/branches/tor-0_1_2-patches/doc)
phobos at seul.org
phobos at seul.org
Tue Jan 8 01:58:36 UTC 2008
Author: phobos
Date: 2008-01-07 20:58:36 -0500 (Mon, 07 Jan 2008)
New Revision: 13069
Modified:
tor/branches/tor-0_1_2-patches/doc/tor-osx-dmg-creation.txt
tor/branches/tor-0_1_2-patches/doc/tor-win32-mingw-creation.txt
Log:
Backport: update documentation to match the new installers.
Modified: tor/branches/tor-0_1_2-patches/doc/tor-osx-dmg-creation.txt
===================================================================
--- tor/branches/tor-0_1_2-patches/doc/tor-osx-dmg-creation.txt 2008-01-08 01:55:07 UTC (rev 13068)
+++ tor/branches/tor-0_1_2-patches/doc/tor-osx-dmg-creation.txt 2008-01-08 01:58:36 UTC (rev 13069)
@@ -2,7 +2,7 @@
##
The following steps are the exact steps used to produce the "official"
-OSX builds of tor
+OSX builds of tor.
Summary:
1) Compile and install a static version of the latest release of
@@ -10,54 +10,22 @@
2) Acquire privoxyosx_setup_3.0.6.zip.
http://downloads.sourceforge.net/ijbswa/privoxyosx_setup_3.0.6.zip?modtime=1164104652&big_mirror=0
Remember where you put this file.
-3) Acquire and install your preferred version of tor via "make
-dist-osx"
+3) Acquire torbutton xpi and license file.
+4) Acquire and install your preferred version of tor. Extract.
+5) Update some variables in contrib/osx/package.sh
+6) "make dist-osx"
+7) You now have a dmg from which you can install Tor, Privoxy, and the
+Torbutton extension for Firefox.
-Details:
-### Compiling libevent
+## Universal Binaries for OSX PPC and X86
+## This method works in OSX 10.4 (Tiger) and 10.5 (Leopard) only.
+## See far below if you don't care about cross compiling for PPC and X86.
+## The single architecture process starts with "###"
-1) Download the latest libevent from
-http://www.monkey.org/~provos/libevent/
+1) Install XCode 2.4.1 updates available from http://developer.apple.com.
-2) The first step of compiling libevent is to configure it as
-follows:
- ./configure --enable-static --disable-shared
+## Compiling libevent
-3) Complete the "make" and "make install". You will need to be root,
-or sudo -s, to complete the "make install".
-
-4) If you have previouslly installed libevent, go rm the old libevent.so*
-files so the linker doesn't get suckered into using them.
-
-
-### Acquiring privoxy
-
-1) Download osx privoxy source from
-http://downloads.sourceforge.net/ijbswa/privoxyosx_setup_3.0.6.zip?modtime=1164104652&big_mirror=0
-
-2) Edit /path/to/tor/contrib/osx/package.sh and confirm
-PRIVOXY_PKG_ZIP= is set to the correct path to find the
-file privoxyosx_setup_3.0.6.zip
-
-
-## Compiling Tor
-
-1) Get your preferred version of the tor source from https://www.torproject.org/
-
-2) In the top level, this means /path/to/tor/, not tor/contrib/osx,
-do a configure with these parameters:
- CONFDIR=/Library/Tor ./configure --prefix=/Library/Tor \
- --bindir=/Library/Tor --sysconfdir=/Library \
- --enable-static --disable-shared
-
-3) In same top level dir, do a "make dist-osx". There now exists a
-.dmg file in the same directory. Install from this dmg.
-
-
-## Universal Binaries for OSX PPC and X86
-
-1) Install XCode 2.4 updates available from http://developer.apple.com.
-
2) Download latest libevent from
http://www.monkey.org/~provos/libevent/
@@ -75,30 +43,109 @@
5) Check for a successful universal binary of libevent.a in, by default,
/usr/local/lib by using the following command:
- file /usr/local/lib/libevent.a
+ "file /usr/local/lib/libevent.a"
Your output should be:
/usr/local/lib/libevent.a: Mach-O fat file with 2 architectures
/usr/local/lib/libevent.a (for architecture i386): current ar archive random library
/usr/local/lib/libevent.a (for architecture ppc): current ar archive
-6) Get your preferred version of the tor source from https://www.torproject.org/
+## Acquiring privoxy
-7) In the top level, this means /path/to/tor/, not tor/contrib/osx,
+6) Download osx privoxy source from
+http://downloads.sourceforge.net/ijbswa/privoxyosx_setup_3.0.6.zip?modtime=1164104652&big_mirror=0
+
+7) Place the privoxyosx_setup_3.0.6.zip in a location of your choice.
+Remember this location.
+
+8) Get your preferred version of Torbutton from https://torbutton.torproject.org.
+Place into a location of your choosing, remember this location.
+
+9) Get the torbutton LICENSE file from https://torbutton.torproject.org.
+Place into a location of your choosing, remember this location.
+
+10) Get your preferred version of the tor source from https://www.torproject.org/download.
+Extract the tarball.
+
+11) Update three variables in contrib/osx/package.sh:
+PRIVOXY_PKG_ZIP=~/tmp/privoxyosx_setup_3.0.6.zip
+TORBUTTON_PATH=~/tmp/torbutton-1.1.9.1-alpha.xpi
+TORBUTTON_LIC_PATH=~/tmp/LICENSE
+
+Make sure the paths are correct. The build will fail if they are not.
+
+12) In the top level, this means /path/to/tor/, not tor/contrib/osx,
do a configure with these parameters:
CFLAGS="-O -g -isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc" \
LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \
CONFDIR=/Library/Tor \
./configure --prefix=/Library/Tor --bindir=/Library/Tor \
---sysconfdir=/Library --enable-static --disable-shared \
---disable-dependency-tracking
+--sysconfdir=/Library --disable-dependency-tracking
-8) "make dist-osx"
+13) "make dist-osx"
-9) Confirm you have created a universal binary by issuing the follow command:
-file src/or/tor
+14) Confirm you have created a universal binary by issuing the follow command:
+"file src/or/tor". Its output should be as follows:
src/or/tor: Mach-O fat file with 2 architectures
src/or/tor (for architecture i386): Mach-O executable i386
src/or/tor (for architecture ppc): Mach-O executable ppc
-Congrats. You have a universal binary.
+15) There should exist in the top-level directory a
+Tor-$VERSION-universal-$OS-Bundle.dmg
+
+16) Congrats. You have a universal binary. You are now ready to install Tor,
+Privoxy, and the Torbutton extension for Firefox.
+
+
+### Single Architecture Binaries for PPC or X86, not both.
+### This method works in all versions of OSX 10.1 through 10.5
+
+### Compiling libevent
+
+1) Download the latest libevent from
+http://www.monkey.org/~provos/libevent/
+
+2) The first step of compiling libevent is to configure it as
+follows:
+ ./configure --enable-static --disable-shared
+
+3) Complete the "make" and "make install". You will need to be root,
+or sudo -s, to complete the "make install".
+
+4) If you have previouslly installed libevent, go rm the old libevent.so*
+files so the linker doesn't get suckered into using them.
+
+### Acquiring privoxy
+
+1) Download osx privoxy source from
+http://downloads.sourceforge.net/ijbswa/privoxyosx_setup_3.0.6.zip?modtime=1164104652&big_mirror=0
+
+2) Place the privoxyosx_setup_3.0.6.zip in a location of your choice.
+Remember this location.
+
+### Compiling Tor
+
+1) Get your preferred version of Torbutton from
+https://torbutton.torproject.org.
+Place into a location of your choosing, remember this location.
+
+2) Get the torbutton LICENSE file from https://torbutton.torproject.org.
+Place into a location of your choosing, remember this location.
+
+3) Get your preferred version of the tor source from https://www.torproject.org. Extract the
+tarball.
+
+4) Update three variables in contrib/osx/package.sh:
+PRIVOXY_PKG_ZIP=~/tmp/privoxyosx_setup_3.0.6.zip
+TORBUTTON_PATH=~/tmp/torbutton-1.1.9.1-alpha.xpi
+TORBUTTON_LIC_PATH=~/tmp/LICENSE
+
+Make sure the paths are correct. The build will fail if they are not.
+
+5) In the top level, this means /path/to/tor/, not tor/contrib/osx,
+do a configure with these parameters:
+ CONFDIR=/Library/Tor ./configure --prefix=/Library/Tor \
+ --bindir=/Library/Tor --sysconfdir=/Library
+
+6) In same top level dir, do a "make dist-osx". There now exists a
+.dmg file in the same directory. Install from this dmg.
Modified: tor/branches/tor-0_1_2-patches/doc/tor-win32-mingw-creation.txt
===================================================================
--- tor/branches/tor-0_1_2-patches/doc/tor-win32-mingw-creation.txt 2008-01-08 01:55:07 UTC (rev 13068)
+++ tor/branches/tor-0_1_2-patches/doc/tor-win32-mingw-creation.txt 2008-01-08 01:58:36 UTC (rev 13069)
@@ -5,7 +5,7 @@
---------------------------------------
Download mingw:
-http://prdownloads.sf.net/mingw/MinGW-5.0.3.exe?download
+http://prdownloads.sf.net/mingw/MinGW-5.1.3.exe?download
Download msys:
http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download
@@ -13,30 +13,36 @@
Download the mingw developer tool kit:
http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download
-Install mingw, msys and mingw-dtk.
+Download the mingw autoconf-2.59 update:
+http://prdownloads.sf.net/mingw/msys-autoconf-2.59.tar.bz2?download
+Install mingw, msys and mingw-dtk. Extract msys-autoconf-2.59.tar.bz2 into
+your mingw install location. For example, if you installed mingw into
+/c/mingw/1.0/ you want to extract msys-autoconf-2.59.tar.bz2 into this
+directory.
+
Create a directory called "tor-mingw".
Stage Two: Download, extract, compile openssl
----------------------------------------------
Download openssl:
-http://www.openssl.org/source/openssl-0.9.8e.tar.gz
+http://www.openssl.org/source/openssl-0.9.8g.tar.gz
Extract openssl:
Copy the openssl tarball into the "tor-mingw" directory.
Type "cd tor-mingw/"
-Type "tar zxf openssl-0.9.8e.tar.gz"
+Type "tar zxf openssl-0.9.8g.tar.gz"
Make openssl libraries:
-Type "cd tor-mingw/openssl-0.9.8e/"
-Type "./Configure mingw"
+Type "cd tor-mingw/openssl-0.9.8g/"
+Type "./Configure -no-idea -no-rc5 -no-mdc2 mingw"
Edit Makefile and remove the "test:" and "tests:" sections.
Type "rm -rf ./test"
Type "cd crypto/"
Type "find ./ -name "*.h" -exec cp {} ../include/openssl/ \;"
Type "cd ../ssl/"
-Type "find ./ -name "*.h" -exec cp {} ../include/openssl/ \;
+Type "find ./ -name "*.h" -exec cp {} ../include/openssl/ \;"
Type "cd .."
Type "cp *.h include/openssl/"
# The next steps can take up to 30 minutes to complete.
@@ -77,17 +83,16 @@
Done.
-Stage Four: Download, extract, and patch libevent-1.3e.
+Stage Four: Download, extract, and compile libevent-1.3e
------------------------------------------------------
-Download libevent-1.3e:
+Download the libevent 1.3e release:
http://www.monkey.org/~provos/libevent/
Copy the libevent tarball into the "tor-mingw" directory.
Type "cd tor-mingw"
-Extract libevent:
-Type "tar zxf libevent-1.3e.tar.gz"
+Extract libevent.
Type "./configure --enable-static --disable-shared"
Type "make"
@@ -102,14 +107,15 @@
Type "tar zxf latest-tor-alpha.tar.gz"
cd tor-<version>
-Type "./configure --enable-static --disable-shared"
+Type "./configure"
Type "make"
You now have a tor.exe in src/or/. This is Tor.
You now have a tor-resolve.exe in src/tools/.
-Stage Six: Build installer
----------------------------
+Stage Six: Build the installer
+-------------------------------
+
Install the latest NSIS:
http://nsis.sourceforge.net/Download
@@ -118,3 +124,4 @@
"./contrib/package_nsis-mingw.sh"
The resulting Tor installer executable is in ./win_tmp/.
+
More information about the tor-commits
mailing list