[svn-upgrade] Integrating new upstream version, iodine (0.5.1)
[debian/iodine.git] / README-win32.txt
1 \r
2 \r
3 iodine - http://code.kryo.se/iodine\r
4 \r
5 ***********************************\r
6 \r
7 Extra README file for Win32 related stuff\r
8 \r
9 \r
10 == Running iodine on Windows:\r
11 1. Install the TAP32 driver \r
12  http://openvpn.net/index.php/downloads.html \r
13  choose OpenVPN 2.0.9 Windows Installer, when installing you can\r
14  select to install only the TAP driver.\r
15 \r
16 2. Have one TAP32 interface installed\r
17 \r
18 3. Name the interface "dns"\r
19 \r
20 4. Make sure the interface does not have a default gateway set\r
21 \r
22 5. Run iodine/iodined as normal.\r
23 \r
24 6. Enjoy!\r
25 \r
26 \r
27 == Building on Windows:\r
28 You need:\r
29         MinGW, MSYS, GCC, zlib\r
30 \r
31 Then just run make\r
32 \r
33 \r
34 == Cross-compiling for MinGW:\r
35 You need:\r
36         MinGW crosscompiler, crosscompiled zlib\r
37 \r
38 Then run "make cross-mingw"\r
39 Note that the binaries will not get a .exe suffix\r
40 \r
41 \r
42 == Zlib download\r
43 You can get zlib for MinGW here (both for native and crosscompile):\r
44 http://code.kryo.se/iodine/deps/zlib.zip\r
45 Unzip it in your MinGW directory on Windows or in $ROOT/usr for\r
46 cross-compile.\r
47 \r
48 \r
49 == Results of crappy Win32 API:\r
50 The following fixable limitations apply:\r
51 - Exactly one TAP32 interface must be installed\r
52 - The TAP32 interface must be named "dns" and be version 0801 or 0901\r
53 - Server cannot read packet destination address\r
54 \r
55 The following (probably) un-fixable limitations apply:\r
56 - A password entered as -P argument can be shown in process list\r
57 - Priviligies cannot be dropped\r
58 - chroot() cannot be used\r
59 - Detaching from terminal not possible\r
60 - Server on windows must be run with /30 netmask\r
61 - Client can only talk to server, not other clients\r
62 \r