… | |
… | |
30 | possible), or you need to send a packet from these hosts into the vpn |
30 | possible), or you need to send a packet from these hosts into the vpn |
31 | network to tell gvpe the local interface address. |
31 | network to tell gvpe the local interface address. |
32 | |
32 | |
33 | =head2 native/linux |
33 | =head2 native/linux |
34 | |
34 | |
35 | TAP-device is already part of the kernel (only 2.4 supported, but see |
35 | TAP-device; already part of the kernel (only 2.4+ supported, but see |
36 | tincd/linux). This is the configuration tested best, as gvpe is being |
36 | tincd/linux). This is the configuration tested best, as gvpe is being |
37 | developed on this platform. |
37 | developed on this platform. |
38 | |
38 | |
39 | To configure the interface, use either iproute2: |
39 | To configure the interface, use either iproute2: |
40 | |
40 | |
41 | ip set $IFNAME address $MAC mtu $MTU up |
41 | ip set $IFNAME address $MAC mtu $MTU up |
42 | ip addr add $IFNAME 10.11.12.13 |
42 | ip addr add $IFNAME 10.11.12.13 |
43 | ip route add $IFNAME 10.11.12.13/8 |
43 | ip route add $IFNAME 10.11.12.13/8 |
44 | |
44 | |
45 | Or ifconfig: |
45 | Or C<ifconfig>: |
46 | |
46 | |
47 | ifconfig $IFNAME hw ether $MAC mtu $MTU |
47 | ifconfig $IFNAME hw ether $MAC mtu $MTU |
48 | ifconfig $IFNAME 10.11.12.13 netmask 255.0.0.0 |
48 | ifconfig $IFNAME 10.11.12.13 netmask 255.0.0.0 |
49 | |
49 | |
50 | To hardwire ARP addresses, use iproute2 (ifconfig can do it, too): |
50 | To hardwire ARP addresses, use iproute2 (C<arp> can do it, too): |
51 | |
51 | |
52 | MAC=fe:fd:80:00:00:$(printf "%02x" $NODEID) |
52 | MAC=fe:fd:80:00:00:$(printf "%02x" $NODEID) |
53 | ip neighbour add 10.11.12.13 lladdr $MAC nud permanent dev $IFNAME |
53 | ip neighbour add 10.11.12.13 lladdr $MAC nud permanent dev $IFNAME |
54 | |
54 | |
55 | =head2 tincd/linux |
55 | =head2 tincd/linux |
56 | |
56 | |
57 | TAP-device is already part of the kernel (2.2 and 2.4 supported, only 2.4 |
57 | TAP-device; already part of the kernel (2.2+ supported). See |
58 | tested). See C<native/linux> for more info. |
58 | C<native/linux> for more info. |
59 | |
59 | |
60 | =head2 native/cygwin |
60 | =head2 native/cygwin |
61 | |
61 | |
62 | TAP-device. The MAC need not be set (and in fact I<cannot> be set). The |
62 | TAP-device; The TAP device to be used must either be the CIPE driver |
63 | MAC address is dynamically being patched into packets and ARP-requests, so |
63 | (C<http://cipe-win32.sourceforge.net/>), or (highly recommended) the newer |
64 | only IPv4 works with ARP on this platform. |
64 | TAP-Win32 driver bundled with openvpn (http://openvpn.sf.net/). Just |
|
|
65 | download and run the openvpn installer. The only option you need to select |
|
|
66 | is the TAP driver. |
65 | |
67 | |
66 | The TAP device to be used must either be the CIPE driver |
68 | The MAC need not be set (and in fact I<cannot> be set). The MAC address |
67 | (C<http://cipe-win32.sourceforge.net/>), or the newer TAP-Win32 driver |
69 | is dynamically being patched into packets and ARP-requests, so only IPv4 |
68 | bundled with openvpn (http://openvpn.sf.net/). Just download and run the |
70 | works with ARP on this platform. |
69 | openvpn installer. The only option you need to select is the TAP driver. |
|
|
70 | |
71 | |
71 | =head2 tincd/freebsd |
72 | =head2 tincd/freebsd |
72 | |
73 | |
73 | TAP-device is part of kernel (since 4.x, maybe earlier). To initialize the |
74 | TAP-device; part of the kernel (since 4.x, maybe earlier). To initialize |
74 | interface, use this command: |
75 | the interface, use this command: |
75 | |
76 | |
76 | ifconfig $IFNAME ether $MAC mtu $MTU up |
77 | ifconfig $IFNAME ether $MAC mtu $MTU up |
77 | |
78 | |
|
|
79 | These commands might be helpful examples: |
|
|
80 | |
|
|
81 | ifconfig $IFNAME 10.0.0.$NODEID |
|
|
82 | route add -net 10.0.0.0 -netmask 255.255.255.0 -interface $IFNAME 10.0.0.$NODEID |
|
|
83 | |
78 | =head2 tincd/netbsd |
84 | =head2 tincd/netbsd |
79 | |
85 | |
80 | TUN-device. The interface is a point to point-device. To initialize it, |
86 | TUN-device; The interface is a point to point-device. To initialize it, |
81 | you currently need to configure it as such, giving it an address on your |
87 | you currently need to configure it as such, giving it an address on your |
82 | vpn (the exact address doesn't matter), like this: |
88 | vpn (the exact address doesn't matter), like this: |
83 | |
89 | |
84 | ifconfig $IFNAME mtu $MTU up |
90 | ifconfig $IFNAME mtu $MTU up |
85 | ifconfig $IFNAME 10.11.12.13 10.55.66.77 |
91 | ifconfig $IFNAME 10.11.12.13 10.55.66.77 |
86 | route add -net 10.0.0.0 10.55.66.77 255.0.0.0 |
92 | route add -net 10.0.0.0 10.55.66.77 255.0.0.0 |
87 | ping -c1 10.55.66.77 # ping once to tell gvpe your gw ip |
93 | ping -c1 10.55.66.77 # ping once to tell gvpe your gw ip |
88 | |
94 | |
89 | =head2 tincd/openbsd |
95 | =head2 tincd/openbsd |
90 | |
96 | |
91 | TUN-device is already part of the kernel. See C<tincd/netbsd> for more information. |
97 | TUN-device; already part of the kernel. See C<tincd/netbsd> for more information. |
|
|
98 | |
|
|
99 | =head2 native/darwin |
|
|
100 | |
|
|
101 | TAP-device; |
|
|
102 | |
|
|
103 | The necessary kernel extension can be found here: |
|
|
104 | |
|
|
105 | http://www-user.rhrk.uni-kl.de/~nissler/tuntap/ |
|
|
106 | |
|
|
107 | There are two drivers, the one to use is the "tap" driver. It driver must |
|
|
108 | be loaded before use, read the docs on how to install it as a startup |
|
|
109 | item. |
|
|
110 | |
|
|
111 | To initialize the interface, use this command: |
|
|
112 | |
|
|
113 | ifconfig $IFNAME ether $MAC mtu $MTU up |
|
|
114 | |
|
|
115 | These commands might be helpful examples: |
|
|
116 | |
|
|
117 | ifconfig $IFNAME 10.0.0.$NODEID |
|
|
118 | route add -net 10.0.0.0 -interface $IFNAME 255.255.255.0 |
92 | |
119 | |
93 | =head2 tincd/darwin |
120 | =head2 tincd/darwin |
94 | |
121 | |
95 | TUN-device. See C<tincd/netbsd> for more information. |
122 | TUN-device; See C<tincd/netbsd> for more information. C<native/darwin> is |
|
|
123 | preferable. |
96 | |
124 | |
97 | The necessary kernel extension can be found here: |
125 | The necessary kernel extension can be found here: |
98 | |
126 | |
99 | http://chrisp.de/en/projects/tunnel.html |
127 | http://chrisp.de/en/projects/tunnel.html |
100 | |
128 | |
|
|
129 | The driver must be loaded before use: |
|
|
130 | |
|
|
131 | kmodload tunnel |
|
|
132 | |
101 | =head2 tincd/solaris |
133 | =head2 tincd/solaris |
102 | |
134 | |
103 | TUN-device is already part of the kernel. see C<tincd/netbsd> for more information. Completey untested so far. |
135 | TUN-device; already part of the kernel(?), or available here: |
|
|
136 | |
|
|
137 | http://vtun.sourceforge.net/tun/ |
|
|
138 | |
|
|
139 | Some precompiled tun drivers might be available here: |
|
|
140 | |
|
|
141 | http://www.monkey.org/~dugsong/fragroute/ |
|
|
142 | |
|
|
143 | See C<tincd/netbsd> for more information. |
|
|
144 | |
|
|
145 | Completely unstested so far. |
104 | |
146 | |
105 | =head2 tincd/mingw |
147 | =head2 tincd/mingw |
106 | |
148 | |
107 | TAP-device, see C<native/cygwin> for more information. Completey untested so far. |
149 | TAP-device; see C<native/cygwin> for more information. |
|
|
150 | |
|
|
151 | Completely untested so far. |
|
|
152 | |
|
|
153 | =head2 tincd/raw_socket |
|
|
154 | |
|
|
155 | TAP-device; purpose unknown and untested, probably binds itself on an |
|
|
156 | existing ethernet device (given by C<ifname>), which should probably not |
|
|
157 | be configured in any way, except for setting it I<up>. |
|
|
158 | |
|
|
159 | =head2 tincd/uml_socket |
|
|
160 | |
|
|
161 | TAP-device; purpose unknown and untested, probably creates a unix datagram |
|
|
162 | socket (path given by C<ifname>) and reads and writes raw packets, so |
|
|
163 | might be useful in other than UML contexts. |
108 | |
164 | |
109 | =head2 tincd/cygwin |
165 | =head2 tincd/cygwin |
110 | |
166 | |
111 | Known to be broken. |
167 | Known to be broken, use C<native/cygwin> instead. |
112 | |
|
|
113 | |
168 | |
114 | =head1 SEE ALSO |
169 | =head1 SEE ALSO |
115 | |
170 | |
116 | gvpe(5). |
171 | gvpe(5). |
117 | |
172 | |