From 25f9e20a1c10aae6bf5b43a25c668b7295a64525 Mon Sep 17 00:00:00 2001 From: phobos Date: Tue, 25 Aug 2009 15:58:25 -0400 Subject: [PATCH] update osx-dmg creation directions for the new methods --- doc/tor-osx-dmg-creation.txt | 119 +++++++++++++++++++++++++---------- 1 file changed, 85 insertions(+), 34 deletions(-) diff --git a/doc/tor-osx-dmg-creation.txt b/doc/tor-osx-dmg-creation.txt index 6728e24ae8..9a89e98759 100644 --- a/doc/tor-osx-dmg-creation.txt +++ b/doc/tor-osx-dmg-creation.txt @@ -1,24 +1,103 @@ ## Instructions for building the official dmgs for OSX. ## +## The loose table of contents: +## Summary +## Single Architecture Binaries for PPC or X86, not both. +## Backwards compatible single-architecture binaries for OSX x86 10.4 from newer versions of OS X. +## Universal Binaries for OSX PPC and X86 +## Each section is delineated by ###. The following steps are the exact steps used to produce the "official" OSX builds of tor. -Summary: +### Summary: 1) Compile and install a static version of the latest release of libevent. 2) Acquire and install your preferred version of tor. Extract. 3) "make dist-osx" 4) You now have a dmg from which you can install Tor. -## Universal Binaries for OSX PPC and X86 -## This method works in OSX 10.4 (Tiger) and newer OSX versions. -## See far below if you don't care about cross compiling for PPC and X86. -## The single architecture process starts with "###" +### Single Architecture Binaries for PPC or X86, not both. +### This method works in all versions of OSX 10.3 through 10.6 + +## Compiling libevent ## + +1) Download the latest stable 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". + +## Compiling Tor ## + +4) Get your preferred version of the tor source from https://www.torproject.org. Extract the +tarball. + +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. + +### Backwards compatible single-architecture binaries for OSX x86 10.4 from newer versions of OS X. 1) Install the latest XCode updates available from http://developer.apple.com. -## Compiling libevent +## Compiling libevent ## + +2) Download latest stable libevent from +http://www.monkey.org/~provos/libevent/ + +3) The first step of compiling libevent is to configure it as +follows: +CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch i386" \ +LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \ +./configure --enable-static --disable-shared --disable-dependency-tracking + +4) Complete the "make" and "make install". You will need to be root, +or sudo -s, to complete the "make install". + +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" + + Your output should be: +/usr/local/lib/libevent.a (for architecture i386): current ar archive random library + +6) Get your preferred version of the tor source from https://www.torproject.org/download. +Extract the tarball. + +7) In the top level, this means /path/to/tor/, not tor/contrib/osx, +do a configure with these parameters: +CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch i386" \ +LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \ +CONFDIR=/Library/Tor \ +./configure --prefix=/Library/Tor --bindir=/Library/Tor \ +--sysconfdir=/Library --disable-dependency-tracking + +8) "make dist-osx" + +9) 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 (for architecture i386): Mach-O executable i386 + +10) There should exist in the top-level directory a +Tor-$VERSION-universal-Bundle.dmg + +11) Congrats. You have a backwards-compatible binary. You are now ready to install Tor. + +### Universal Binaries for OSX PPC and X86 +### This method works in OSX 10.4 (Tiger) and newer OSX versions. + +1) Install the latest XCode updates available from http://developer.apple.com. + +## Compiling libevent ## 2) Download latest stable libevent from http://www.monkey.org/~provos/libevent/ @@ -64,31 +143,3 @@ src/or/tor (for architecture ppc): Mach-O executable ppc Tor-$VERSION-universal-Bundle.dmg 11) Congrats. You have a universal binary. You are now ready to install Tor. - -### Single Architecture Binaries for PPC or X86, not both. -### This method works in all versions of OSX 10.3 through 10.5 - -### Compiling libevent - -1) Download the latest stable 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". - -### Compiling Tor - -4) Get your preferred version of the tor source from https://www.torproject.org. Extract the -tarball. - -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.