1 .\" This file is part of GNUnet.
2 .\" Copyright (C) 2001-2019 GNUnet e.V.
4 .\" Permission is granted to copy, distribute and/or modify this document
5 .\" under the terms of the GNU Free Documentation License, Version 1.3 or
6 .\" any later version published by the Free Software Foundation; with no
7 .\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
8 .\" copy of the license is included in the file
11 .\" A copy of the license is also available from the Free Software
12 .\" Foundation Web site at http://www.gnu.org/licenses/fdl.html}.
14 .\" Alternately, this document is also available under the General
15 .\" Public License, version 3 or later, as published by the Free Software
16 .\" Foundation. A copy of the license is included in the file
19 .\" A copy of the license is also available from the Free Software
20 .\" Foundation Web site at http://www.gnu.org/licenses/gpl.html
22 .\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
29 .Nd manually setup a GNUnet VPN tunnel
34 .Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
35 .Op Fl d Ar TIME | Fl -duration Ar TIME
37 .Op Fl i Ar IP | Fl -ip Ar IP
38 .Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
39 .Op Fl p Ar PEERID | Fl -peer= Ns Ar PEERID
40 .Op Fl s Ar NAME | Fl -service= Ns Ar NAME
47 can be used to manually setup a VPN tunnel via the GNUnet network.
48 There are two main types of tunnels.
49 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.
50 Depending on the type of tunnel, gnunet-vpn takes different options.
53 option is required for tunnels to an exit node, whereas the
57 options in conjunction with either
61 are required for tunnels to services.
62 For exit tunnels, both UDP and TCP traffic will be redirected.
63 For service tunnels, either UDP
67 traffic will be redirected.
68 The tool will display the IP address for this end of the tunnel.
69 The address can be displayed as soon as it has been allocated, or only after
71 the tunnel has been created.
72 .Bl -tag -width indent
74 Desired IP address on this end of the tunnel should be an IPv4 address.
76 Desired IP address on this end of the tunnel should be an IPv6 address.
77 .It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
78 Use the configuration file FILENAME.
79 .It Fl d Ar TIME | Fl -duration Ar TIME
80 The mapping should be established for TIME.
81 The value given must be a number followed by a space and a time unit, for example "500 ms".
82 Note that the quotes are required on the shell.
83 The default vaue is 5 minutes.
85 Print short help on options.
86 .It Fl i Ar IP | Fl -ip Ar IP
87 Tunnel should be to an exit node and connect to the given IPv4 or IPv6
89 Note that you can specify an IPv6 address as the target here, even in
90 combination with "-4" (4to6) and similarly you can specify an IPv4
91 address in combination with "-6" (6to4).
92 .It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
93 Use LOGLEVEL for logging.
94 Valid values are DEBUG, INFO, WARNING and ERROR.
95 .It Fl p Ar PEERID | Fl -peer= Ns Ar PEERID
96 Name of the peer offering the service to connect to.
97 Cannot be used in conjunction with
101 .It Fl s Ar NAME | Fl -service= Ns Ar NAME
102 Name of the service running on the target peer.
103 Cannot be used in conjunction with
113 must be specified when using
121 must be specified when using
126 Print GNUnet version number.
131 The full documentation for gnunet is maintained as a Texinfo manual.
134 and gnunet programs are properly installed at your site, the command
138 should give you access to the complete handbook,
140 .Dl info gnunet-c-tutorial
142 will give you access to a tutorial for developers.
144 Depending on your installation, this information is also available in
146 .Xr gnunet-c-tutorial 7 .
151 .Lk https://bugs.gnunet.org
152 or by sending electronic mail to
153 .Aq Mt gnunet-developers@gnu.org .