aboutsummaryrefslogtreecommitdiff
path: root/doc/tor-osx-dmg-creation.txt
blob: 311b79a131919cbbed3c432099d7b72f39e84f88 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
## Instructions for building the official dmgs for OSX.
##

The following steps are the exact steps used to produce the "official"
OSX builds of tor.

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) Update some variables in contrib/osx/package.sh
4) "make dist-osx"
5) 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 "###"

1) Install XCode 2.4.1 updates available from http://developer.apple.com.

## Compiling libevent

2)  Download latest libevent from
http://www.monkey.org/~provos/libevent/

3) The first step of compiling libevent is to configure it as
follows:
CFLAGS="-O -g -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,
or sudo -s, to complete the "make install".

4) If you have previouslly installed libevent, rm the old libevent.*, located
by default, in /usr/local/lib/.  

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: 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 -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

13) "make dist-osx"

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

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.

### 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 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.

### Compiling Tor

1) Get your preferred version of the tor source from https://www.torproject.org.  Extract the
tarball.

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

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.