doc/tor-osx-dmg-creation.txt

   1 ## Instructions for building the official dmgs for OSX.
   2 ##
   3 ## The loose table of contents:
   4 ## Single Architecture Binaries for PowerPc or i386 architecture, not both.
   5 ## Backwards compatible single-architecture binaries for OSX i386 10.4 from
   6 ## newer versions of OS X.
   7 ## Universal Binaries for OSX PPC and i386
   8 ## Each section is delineated by ###.
   9
  10 #######################################
  11 #
  12 # Section 1
  13 #
  14 # Single Architecture Binaries for PPC or i386, not both.
  15 # This method works in all versions of OSX 10.3 through 10.6
  16 #######################################
  17
  18 ## Compiling libevent ##
  19
  20 1) Download the latest stable libevent from
  21 http://www.monkey.org/~provos/libevent/
  22
  23 2) The first step of compiling libevent is to configure it as
  24 follows:
  25 ./configure --enable-static --disable-shared
  26
  27 3) Complete the "make" and "make install". You will need to be root,
  28 or sudo -s, to complete the "make install".
  29
  30 ## Compiling Tor ##
  31
  32 4) Get your preferred version of the tor source from
  33 https://www.torproject.org/dist/ or
  34 http://archive.torproject.org/tor-package-archive/. Extract the tarball.
  35
  36 5) In the top level, this means /path/to/tor/, not tor/contrib/osx,
  37 do a configure with these parameters:
  38
  39 CONFDIR=/Library/Tor ./configure --prefix=/Library/Tor \
  40 --bindir=/Library/Tor --sysconfdir=/Library
  41
  42 6) In same top level dir, do a "make dist-osx". There now exists a
  43 .dmg file in the same directory. Install from this dmg.
  44
  45 #######################################
  46 #
  47 # Section 2
  48 # Backwards compatible single-architecture binaries for OSX x86 10.4 from
  49 # newer versions of OS X.
  50 #
  51 #######################################
  52
  53 1) Install the latest XCode updates available from http://developer.apple.com.
  54
  55 ## Compiling libevent ##
  56
  57 2) Download latest stable libevent from
  58 http://www.monkey.org/~provos/libevent/
  59
  60 3) The first step of compiling libevent is to configure it as
  61 follows:
  62
  63 CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot \
  64 /Developer/SDKs/MacOSX10.4u.sdk -arch i386" \
  65 LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \
  66 ./configure --enable-static --disable-shared --disable-dependency-tracking \
  67 CC="gcc-4.0"
  68
  69 4) Complete the "make" and "make install". You will need to be root,
  70 or sudo -s, to complete the "make install".
  71
  72 5) Check for a successful universal binary of libevent.a in, by default,
  73 /usr/local/lib by using the following command:
  74
  75         "file /usr/local/lib/libevent.a"
  76
  77         Your output should be:
  78
  79 "/usr/local/lib/libevent.a (for architecture i386):
  80 current ar archive random library"
  81
  82 6) Get your preferred version of the tor source from
  83 https://www.torproject.org/dist/ or
  84 http://archive.torproject.org/tor-package-archive/.
  85 Extract the tarball.
  86
  87 7) In the top level, this means /path/to/tor/, not tor/contrib/osx,
  88 do a configure with these parameters:
  89
  90 CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot \
  91 /Developer/SDKs/MacOSX10.4u.sdk -arch i386" \
  92 LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \
  93 CONFDIR=/Library/Tor \
  94 ./configure --prefix=/Library/Tor --bindir=/Library/Tor \
  95 --sysconfdir=/Library --disable-dependency-tracking CC="gcc-4.0"
  96
  97 8) "make dist-osx"
  98
  99 9) Confirm you have created a universal binary by issuing the follow command:
 100 "file src/or/tor". Its output should be as follows:
 101 src/or/tor (for architecture i386): Mach-O executable i386
 102
 103 10) There should exist in the top-level directory a
 104 Tor-$VERSION-i386-Bundle.dmg
 105
 106 11) Congrats. You have a backwards-compatible binary.
 107 You are now ready to install Tor.
 108
 109 ####################################################################
 110 #
 111 # Section 3
 112 #
 113 # Universal Binaries for OSX PPC and X86
 114 # This method works in OSX 10.4 (Tiger) and newer OSX versions.
 115 #
 116 ####################################################################
 117
 118 1) Install the latest XCode updates available from http://developer.apple.com.
 119
 120 ## Compiling libevent ##
 121
 122 2) Download latest stable libevent from
 123 http://www.monkey.org/~provos/libevent/
 124
 125 3) The first step of compiling libevent is to configure it as
 126 follows:
 127 CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot \
 128 /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc" \
 129 LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \
 130 ./configure --enable-static --disable-shared --disable-dependency-tracking \
 131 CC="gcc-4.0"
 132
 133 4) Complete the "make" and "make install". You will need to be root,
 134 or sudo -s, to complete the "make install".
 135
 136 5) Check for a successful universal binary of libevent.a in, by default,
 137 /usr/local/lib by using the following command:
 138         "file /usr/local/lib/libevent.a"
 139
 140         Your output should be:
 141
 142 /usr/local/lib/libevent.a: Mach-O fat file with 2 architectures
 143 /usr/local/lib/libevent.a (for architecture i386):
 144 current ar archive random library
 145 /usr/local/lib/libevent.a (for architecture ppc):
 146 current ar archive
 147
 148 6) Get your preferred version of the tor source from
 149 https://www.torproject.org/dist/ or
 150 http://archive.torproject.org/tor-package-archive/.
 151 Extract the tarball.
 152
 153 7) In the top level, this means /path/to/tor/, not tor/contrib/osx,
 154 do a configure with these parameters:
 155
 156 CFLAGS="-O -g -mmacosx-version-min=10.4 -isysroot \
 157 /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc" \
 158 LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk" \
 159 CONFDIR=/Library/Tor \
 160 ./configure --prefix=/Library/Tor --bindir=/Library/Tor \
 161 --sysconfdir=/Library --disable-dependency-tracking CC="gcc-4.0"
 162
 163 8) "make dist-osx"
 164
 165 9) Confirm you have created a universal binary by issuing the follow command:
 166 "file src/or/tor". Its output should be as follows:
 167
 168 src/or/tor: Mach-O fat file with 2 architectures
 169 src/or/tor (for architecture i386): Mach-O executable i386
 170 src/or/tor (for architecture ppc): Mach-O executable ppc
 171
 172 10) There should exist in the top-level directory a
 173 Tor-$VERSION-universal-Bundle.dmg
 174
 175 11) Congrats. You have a universal binary. You are now ready to install Tor.