Imported Upstream version 0.3
[anytun.git] / README
1 Dependencies
2 ============
3
4 Anytun can be built by using either libgcrypt or the openssl-crypto library. 
5 The latter is more performant in most cases but there are some license 
6 issues when using this library.
7
8 Linux
9 -----
10
11 using libgcrypt:
12   libgcrypt11-dev
13
14 using ssl crypto lib:
15   libssl-dev
16
17 common:
18   build-essential
19   libboost-serialization1.35-dev
20   libboost-thread1.35-dev
21   libboost-system1.35-dev
22   libboost-regex1.35-dev
23   asciidoc (only for manpage)
24
25
26 Windows
27 -------
28 OpenSSL
29  Developer: 
30         http://www.slproweb.com/download/Win32OpenSSL-0_9_8j.exe
31
32  Runtime Only: 
33         http://www.slproweb.com/download/Win32OpenSSL_Light-0_9_8j.exe
34   
35 Boost 1.35: 
36         http://www.boostpro.com/download/boost_1_35_0_setup.exe
37
38   As it can take some time to install everything from boost here is a 
39   complete list of libraries which have to be installed in order to build anytun:
40    
41    * Serialization
42    * Thread 
43    * date_time
44    * System
45    * regex
46
47 Microsoft Visual C++ 2008 Redistributable Package (x86):
48         http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF
49
50
51
52 Installation
53 ============
54
55 Getting the source via subversion:
56 ----------------------------------
57 svn co http://anytun.org/svn/anytun/
58
59 Building from source
60 --------------------
61
62 using libgcrypt:
63
64  # cd src
65  # ./configure
66  # make
67
68 using ssl crypto library:
69
70  # cd src
71  # ./configure --use-ssl-crypto
72  # make
73
74
75 Notes: 
76   - try './configure --help' for further information
77   - if using openssl pre 0.9.8 you have to disable passphrase
78     because openssl had no SHA256 implementation prior to this
79     version
80
81
82 Errors:
83 =======
84
85 Note: Cannot open TUN/TAP dev /dev/net/tun: No such file or directory (errno=2)
86 Cannot open TUN/TAP dev /dev/anytun0: No such file or directory (errno=2)
87
88 Solution: Enabling tun/tap device
89 ------------------------------------
90
91 modprobe tun
92 cd /dev
93 ./MAKEDEV tun
94
95 edit /etc/modules and add the line
96 tun
97 to load the module automatically