1 .TH GNUNET\-VPN 1 "February 25, 2012" "GNUnet"
3 gnunet\-vpn \- manually setup a GNUnet VPN tunnel
9 \fBgnunet\-vpn\fP can be used to manually setup a VPN tunnel via the
11 There are two main types of tunnels.
12 Tunnels to an exit node which routes the traffic to the global
13 Internet, and tunnels to a node that runs a service only within
15 Depending on the type of tunnel, gnunet\-vpn takes different options.
16 The "\-i" option is required for tunnels to an exit node, whereas the
17 "\-p" and "\-s" options in conjunction with either "\-u" or "\-t" are
18 required for tunnels to services.
19 For exit tunnels, both UDP and TCP traffic will be redirected.
20 For service tunnels, either UDP ("\-u") or TCP ("\-t") traffic will
22 The tool will display the IP address for this end of the tunnel.
23 The address can be displayed as soon as it has been allocated, or only
24 after ("\-a") the tunnel has been created.
28 Desired IP address on this end of the tunnel should be an IPv4 address.
31 Desired IP address on this end of the tunnel should be an IPv6 address.
33 .IP "\-c FILENAME, \-\-config=FILENAME"
34 Use the configuration file FILENAME.
36 .IP "\-d TIME, \-\-duration TIME"
37 The mapping should be established for TIME.
38 The value given must be a number followed by a space and a time unit,
40 Note that the quotes are required on the shell.
44 Print short help on options.
46 .IP "\-i IP, \-\-ip IP"
47 Tunnel should be to an exit node and connect to the given IPv4 or IPv6
49 Note that you can specify an IPv6 address as the target here, even in
50 combination with "\-4" (4to6) and similarly you can specify an IPv4
51 address in combination with "\-6" (6to4).
53 .IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
54 Use LOGLEVEL for logging.
55 Valid values are DEBUG, INFO, WARNING and ERROR.
57 .IP "\-p PEERID, \-\-peer=PEERID"
58 Name of the peer offering the service to connect to.
59 Cannot be used in conjunction with "\-i", requires "\-s".
61 .IP "\-s NAME, \-\-service=NAME"
62 Name of the service running on the target peer.
63 Cannot be used in conjunction with "\-i", requires "\-p".
67 Either "\-t" or "\-u" must be specified when using "\-s".
71 Either "\-t" or "\-u" must be specified when using "\-s".
73 .IP "\-V, \-\-verbose"
76 .IP "\-v, \-\-version"
77 Print GNUnet version number.
79 Report bugs by using Mantis <https://bugs.gnunet.org/> or by sending
80 electronic mail to <gnunet\-developers@gnu.org>
83 The full documentation for
85 is maintained as a Texinfo manual. If the
89 programs are properly installed at your site, the command
93 should give you access to the complete handbook,
95 .B info gnunet-c-tutorial
97 will give you access to a tutorial for developers.
99 Depending on your installation, this information is also
101 \fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).