chiark / gitweb /
changelog, Makefile.in: finalise 0.3.1~beta2
[secnet.git] / README.mac
1 How to install secnet on a Fink-equipped OS X system:
2   - Install GMP:
3     fink install gmp
4   - Download and install ADNS:
5     ./configure --disable-dynamic
6     make
7     sudo make install
8   - Build secnet:
9     ./configure
10     make
11     sudo make install
12   - Install tuntap for OSX from http://tuntaposx.sourceforge.net/
13   - Create /etc/secnet/{key,secnet.conf,sites.conf} as usual
14   - If you don't want secnet 'always on', edit
15     uk.org.greenend.secnet.plist and remove *both* these two lines:
16         <key>RunAtLoad</key>
17         <true/>
18   - Create the 'secnet' user and install the job configuration:
19     ./setup.mac.
20
21 To start secnet:
22   sudo launchctl start uk.org.greenend.secnet
23
24 To stop secnet:
25   sudo launchctl stop uk.org.greenend.secnet
26
27 To uninstall:
28   sudo launchctl unload /Library/LaunchDaemons/uk.org.greenend.secnet.plist
29   sudo rm -f /Library/LaunchDaemons/uk.org.greenend.secnet.plist
30
31 If you need to enable IP forwarding:
32   sudo sysctl -w net.inet.ip.forwarding=1
33
34 (Note that on a Mac, you need to enable IP forwarding if you want to
35 route to addresses on one interface via another; i.e. if you expect to
36 be able to reach an address on en0 with a packet delivered through
37 tun0, IP forwarding must be turned on.)
38
39 How to import secnet into XCode 3.2:
40
41 - Set up build directories as follows:
42     $ mkdir build/Debug build/Release
43     $ cd build/Debug
44     $ ~/src/secnet/configure CFLAGS="-g -O0"
45     $ cd ../Release
46     $ ~/src/secnet/configure
47     $ cd ../..
48   (Replace ~/src/secnet with the *absolute* path to your secnet tree -
49   XCode cannot map the relative paths in errors to the source files
50   otherwise.)
51 - Start XCode
52 - Menubar -> File -> New Project
53   - Choose the Mac OS X -> Other -> External Build System template
54   - Choose the *parent* of the secnet directory and call the project
55     secnet
56     - OK the overwrite (it won't overwrite anything that matters)
57     - This creates 'build' and 'secnet.xcodeproj' directories in your
58       secnet tree.
59 - Right-click Groups & Files -> secnet -> Add -> Existing files and
60   select all the *.c, *.h, *.y and *.fl files.
61   - Omit the following files:
62     - *.yy.[ch]       \
63     - *.tab.[ch]      | generated during build
64     - version.c       |
65     - config.h        /
66     - snprintf.[ch]   - unnecessary on OSX
67   - Sort by 'kind' may make this easier
68   - Leave 'Copy items...' unchecked
69   - Add To Targets should have 'secnet' checked
70   - For conffile.fl, right click Get Info -> General, and set File
71     Type to sourcecode.lex.
72 - Under Groups & Files -> secnet, select all source files and right
73   click Get Info -> General, and set:
74   - Tab Width to 8
75   - Indent Width to 4
76   - Check Editor uses tabs
77 - Double click click Groups & Files -> Targets secnet
78   - Add '-C $TARGET_BUILD_DIR' to the start of the arguments.
79
80 You should now be able to build both debug and release configurations
81 using ⌘B.
82
83 Richard Kettlewell 2011-07-23