aboutsummaryrefslogtreecommitdiff
path: root/doc/tor-osx-dmg-creation.txt
blob: 9a89e98759c842a0b77ece58924f7f9268eb2d63 (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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
## 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:
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.

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

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/

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" \
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: 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" \
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: 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.