aboutsummaryrefslogtreecommitdiff
path: root/doc/man/gnunet-vpn.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/gnunet-vpn.1')
-rw-r--r--doc/man/gnunet-vpn.165
1 files changed, 65 insertions, 0 deletions
diff --git a/doc/man/gnunet-vpn.1 b/doc/man/gnunet-vpn.1
new file mode 100644
index 000000000..4d07c5ad9
--- /dev/null
+++ b/doc/man/gnunet-vpn.1
@@ -0,0 +1,65 @@
1.TH GNUNET\-VPN 1 "Jan 7, 2012" "GNUnet"
2
3.SH NAME
4gnunet\-vpn \- manually setup a GNUnet VPN tunnel
5
6.SH SYNOPSIS
7.B gnunet\-vpn
8.RI [ options ]
9.br
10
11.SH DESCRIPTION
12\fBgnunet\-vpn\fP can be used to manually setup a VPN tunnel via the GNUnet network. There are two main types of tunnels. Tunnels to an exit node which routes the traffic to the global Internet, and tunnels to a node that runs a service only within GNUnet. Depending on the type of tunnel, gnunet\-vpn takes different options. The "\-i" option is required for tunnels to an exit node, whereas the "\-p" and "\-s" options in conjuction with either "\-u" or "\-t" are required for tunnels to services. For exit tunnels, both UDP and TCP traffic will be redirected. For service tunnels, either UDP ("\-u") or TCP ("\-t") traffic will be redirected.
13
14The tool will display the IP address for this end of the tunnel. The address can be displayed as soon as it has been allocated, or only after ("\-a") the tunnel has been created.
15
16.SH OPTIONS
17.B
18.IP "\-4, \-\-ipv4"
19Desired IP address on this end of the tunnel should be an IPv4 address.
20.B
21.IP "\-6, \-\-ipv6"
22Desired IP address on this end of the tunnel should be an IPv6 address.
23.B
24.IP "\-a, \-\-after\-connect"
25Display IP address only after the tunnel is fully connected.
26.B
27.IP "\-c FILENAME, \-\-config=FILENAME"
28Use the configuration file FILENAME.
29.B
30.IP "\-d SEC, \-\-duration SEC"
31The mapping should be established for SEC seconds. Default is 5 minutes.
32.B
33.IP "\-h, \-\-help"
34Print short help on options.
35.B
36.IP "\-i IP, \-\-ip IP"
37Tunnel should be to an exit node and connect to the given IPv4 or IPv6 IP address. Note that you can specify an IPv6 address as the target here, even in combination with "\-4" (4to6) and similarly you can specify an IPv4 address in combination with "\-6" (6to4).
38.B
39.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
40Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.
41.B
42.IP "\-p PEERID, \-\-peer=PEERID"
43Name of the peer offering the service to connect to. Cannot be used in conjunction with "\-i", requires "\-s".
44.B
45.IP "\-s NAME, \-\-service=NAME"
46Name of the service running on the target peer. Cannot be used in conjunction with "\-i", requires "\-p".
47.B
48.IP "\-t, \-\-tcp"
49Service runs TCP. Either "\-t" or \"-u" must be specified when using "\-s".
50.B
51.IP "\-u, \-\-udp"
52Service runs UDP. Either "\-t" or \"-u" must be specified when using "\-s".
53.B
54.IP "\-V, \-\-verbose"
55Be verbose.
56.B
57.IP "\-v, \-\-version"
58Print GNUnet version number.
59
60
61.SH BUGS
62Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
63
64.SH SEE ALSO
65gnunet\-service\-arm(1)