|  | @@ -1,31 +1,62 @@
 | 
	
		
			
				|  |  |  ## 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 -arch ppc" \
 | 
	
		
			
				|  |  | +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
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -37,16 +68,14 @@ or sudo -s, to complete the "make install".
 | 
	
		
			
				|  |  |  	"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/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 -arch ppc" \
 | 
	
		
			
				|  |  | +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 \
 | 
	
	
		
			
				|  | @@ -56,39 +85,61 @@ CONFDIR=/Library/Tor \
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  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: 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
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  10) There should exist in the top-level directory a
 | 
	
		
			
				|  |  |  Tor-$VERSION-universal-Bundle.dmg
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -11) Congrats.  You have a universal binary. You are now ready to install Tor.
 | 
	
		
			
				|  |  | +11) Congrats.  You have a backwards-compatible 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
 | 
	
		
			
				|  |  | +### 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
 | 
	
		
			
				|  |  | +## Compiling libevent ##
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -1)  Download the latest stable libevent from
 | 
	
		
			
				|  |  | +2)  Download latest stable libevent from
 | 
	
		
			
				|  |  |  http://www.monkey.org/~provos/libevent/
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -2) The first step of compiling libevent is to configure it as
 | 
	
		
			
				|  |  | +3) The first step of compiling libevent is to configure it as
 | 
	
		
			
				|  |  |  follows:
 | 
	
		
			
				|  |  | -       ./configure --enable-static --disable-shared
 | 
	
		
			
				|  |  | +CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc" \
 | 
	
		
			
				|  |  | +LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \
 | 
	
		
			
				|  |  | +./configure --enable-static --disable-shared --disable-dependency-tracking
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -3) Complete the "make" and "make install".  You will need to be root,
 | 
	
		
			
				|  |  | +4) Complete the "make" and "make install".  You will need to be root,
 | 
	
		
			
				|  |  |  or sudo -s, to complete the "make install".
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -### Compiling Tor
 | 
	
		
			
				|  |  | +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"
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -4) Get your preferred version of the tor source from https://www.torproject.org.  Extract the
 | 
	
		
			
				|  |  | -tarball.
 | 
	
		
			
				|  |  | +	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
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -5) In the top level, this means /path/to/tor/, not tor/contrib/osx,
 | 
	
		
			
				|  |  | +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:
 | 
	
		
			
				|  |  | -     CONFDIR=/Library/Tor ./configure --prefix=/Library/Tor \
 | 
	
		
			
				|  |  | -     --bindir=/Library/Tor --sysconfdir=/Library
 | 
	
		
			
				|  |  | +CFLAGS="-O -g -mmacosx-version-min=10.4 -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 --disable-dependency-tracking
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -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.
 | 
	
		
			
				|  |  | +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: 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
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +10) There should exist in the top-level directory a
 | 
	
		
			
				|  |  | +Tor-$VERSION-universal-Bundle.dmg
 | 
	
		
			
				|  |  | +
 | 
	
		
			
				|  |  | +11) Congrats.  You have a universal binary. You are now ready to install Tor.
 |