16TUNNEL(1)                  General Commands Manual                 6TUNNEL(1)
2
3
4

NAME

6       6tunnel - tunnelling for application that don't speak IPv6
7

SYNOPSIS

9       6tunnel  [ -146dhfv ] [ -u username ] [ -i password ] [ -I password ] [
10       -l local_host ] [ -L limit ] [ -p pid_file ] [ -m map_file ] local_port
11       remote_host [ remote_port ]
12

DESCRIPTION

14       6tunnel  allows  you  to  use  services  provided  by  IPv6  hosts with
15       IPv4-only applications and vice-versa. It can bind to any of your  IPv4
16       (default)  or  IPv6 addresses and forward all data to IPv4 or IPv6 (de‐
17       fault) host. For example
18
19              6tunnel -1 6668 irc6.net 6667
20
21       will be enough to connect to IPv6 irc server with
22
23              irc foobar localhost:6668
24
25       If you don't wish to run 6tunnel every  time  you  want  to  show  your
26       :c001:  or  :dead: IPv6 address on IRC, you can use -i parameter, which
27       makes 6tunnel ask your client for specified password. Just run
28
29              6tunnel -i dupa.8 31337 irc6.net 6667
30
31       and then type
32
33              irc foobar localhost:31337:dupa.8
34
35       If your IRC server requires you to send password, specify  it  with  -I
36       parameter -- after successful proxy authentication 6tunnel will send it
37       to the server.
38
39       6tunnel can also be used as a tunnel for all other combinations of IPv4
40       and  IPv6  endpoints.  If  remote host doesn't have any IPv6 addresses,
41       6tunnel will use the IPv4 one. In other cases, use -4  parameter  which
42       makes  IPv4  address  the preferred one. For IPv6-to-any tunnels use -6
43       which makes 6tunnel bind to IPv6 address.
44

OPTIONS

46       -1     Exit after first connection.
47
48       -4     Prefer IPv4 endpoint if the machine has both address types.
49
50       -6     Listen on IPv6 address (IPv4 is default).
51
52       -d     Don't detach.
53
54       -f     Force tunneling even if remote host is not resolvable at the ex‐
55              ecution time.
56
57       -h     Print hex dump of every packet received or sent.
58
59       -u username
60              Change UID and GID after bind().
61
62       -i password
63              Act as an IRC proxy and require user to authenticate.
64
65       -I password
66              If  you are using 6tunnel as an IRC proxy and the IRC server re‐
67              quires you to send password, place it right here.
68
69       -l local_host
70              Listen on specified address (IPv4, or IPv6 if -6 used).
71
72       -L limit
73              Limit simultaneous connections.
74
75       -p pid_file
76              Write down pid to specified file.
77
78       -s source_host
79              Connect to the remote host using specified source address.
80
81       -m map_file
82              Binds to specified IPv6 addresses on basis of  source  IPv4  ad‐
83              dress.  The  file contains one mapping per line with IPv4 source
84              address and corresponding IPv6 address. Only  listed  hosts  are
85              allowed  to  connect. If you want to allow any host, add mapping
86              for default or 0.0.0.0 address. Example:
87
88              192.168.0.2 3ffe:8010:18::1000:2
89              192.168.0.3 3ffe:8010:18::1000:3
90
91       -v     Be verbose and don't detach.
92

NOTES

94       Option -H to disable all resolver hints has been removed  since  proper
95       combination of -4 and -6 will yield in any combination of IPv4 and IPv6
96       sources and destinations.
97

SIGNALS

99       Sending SIGHUP forces map file reload.
100

THANKS

102       #ipv6 crew, Lam.
103

BUGS

105       Terrible man page. Hex dump doesn't include IRC  proxy  authentication.
106       IRC  proxy  requires  your  client  to send password first (don't worry
107       ircii, EPIC, BitchX, mIRC and many more will work). No  logging  except
108       debug output.
109

AUTHORS

111       Wojtek   Kaniewski   (wojtekka@toxygen.net),   Dariusz  Jackowski  (as‐
112       cent@linux.pl), Ramunas Lukosevicus (lukoramu@parok.lt), Roland  Stigge
113       (stigge@antcom.de)
114

SEE ALSO

116       ssh(1)
117
118
119
120                                 Oct 19, 2019                       6TUNNEL(1)
Impressum