xref: /freebsd/sbin/nos-tun/nos-tun.8 (revision 04970b8d6e7087a0cf17e5dde2cdfbe17cf14b92)
1e66dbdb6SPoul-Henning Kamp.\"
2e66dbdb6SPoul-Henning Kamp.\" ----------------------------------------------------------------------------
3e66dbdb6SPoul-Henning Kamp.\" "THE BEER-WARE LICENSE" (Revision 42):
4e66dbdb6SPoul-Henning Kamp.\" <phk@FreeBSD.org> wrote this file.  As long as you retain this notice you
5e66dbdb6SPoul-Henning Kamp.\" can do whatever you want with this stuff. If we meet some day, and you think
6e66dbdb6SPoul-Henning Kamp.\" this stuff is worth it, you can buy me a beer in return.   Poul-Henning Kamp
7e66dbdb6SPoul-Henning Kamp.\" ----------------------------------------------------------------------------
8e66dbdb6SPoul-Henning Kamp.\"
97f3dea24SPeter Wemm.\" $FreeBSD$
10e66dbdb6SPoul-Henning Kamp.\"
11*04970b8dSSevan Janiyan.Dd October 5, 2016
12e66dbdb6SPoul-Henning Kamp.Dt NOS-TUN 8
139fe48c6eSRuslan Ermilov.Os
14e66dbdb6SPoul-Henning Kamp.Sh NAME
15e66dbdb6SPoul-Henning Kamp.Nm nos-tun
1659edad7aSPhilippe Charnier.Nd implement ``nos'' or ``ka9q'' style IP over IP tunnel
17e66dbdb6SPoul-Henning Kamp.Sh SYNOPSIS
187c7fb079SRuslan Ermilov.Nm
19e66dbdb6SPoul-Henning Kamp.Fl t
20e66dbdb6SPoul-Henning Kamp.Ar tunnel
21e66dbdb6SPoul-Henning Kamp.Fl s
22e66dbdb6SPoul-Henning Kamp.Ar source
23e66dbdb6SPoul-Henning Kamp.Fl d
24e66dbdb6SPoul-Henning Kamp.Ar destination
25d59cf2acSPoul-Henning Kamp.Fl p
26d59cf2acSPoul-Henning Kamp.Ar protocol_number
278d646af5SRuslan Ermilov.Op Ar source
28e66dbdb6SPoul-Henning Kamp.Ar target
29e66dbdb6SPoul-Henning Kamp.Sh DESCRIPTION
30e1205e80SPhilippe CharnierThe
31e1205e80SPhilippe Charnier.Nm
32e1205e80SPhilippe Charnierutility is used to establish an
33e66dbdb6SPoul-Henning Kamp.Em nos
34e66dbdb6SPoul-Henning Kampstyle tunnel, (also known as
35e66dbdb6SPoul-Henning Kamp.Em ka9q
36e66dbdb6SPoul-Henning Kampor
37e66dbdb6SPoul-Henning Kamp.Em IP-IP
38e66dbdb6SPoul-Henning Kamptunnel) using a
39e66dbdb6SPoul-Henning Kamp.Xr tun 4
40e66dbdb6SPoul-Henning Kampkernel interface.
41e66dbdb6SPoul-Henning Kamp.Pp
4259edad7aSPhilippe Charnier.Ar Tunnel
43e66dbdb6SPoul-Henning Kampis the name of the tunnel device
4459edad7aSPhilippe Charnier.Pa /dev/tun0
45e66dbdb6SPoul-Henning Kampfor example.
46e66dbdb6SPoul-Henning Kamp.Pp
4759edad7aSPhilippe Charnier.Ar Source
48e66dbdb6SPoul-Henning Kampand
49e66dbdb6SPoul-Henning Kamp.Ar destination
50e66dbdb6SPoul-Henning Kampare the addresses used on the tunnel device.
51e66dbdb6SPoul-Henning KampIf you configure the tunnel against a cisco router, use a netmask of
52e66dbdb6SPoul-Henning Kamp.Dq 255.255.255.252
539806e231SRuslan Ermilovon the cisco.
549806e231SRuslan ErmilovThis is because the tunnel is a point-to-point interface
5559edad7aSPhilippe Charnierin the
56f050f700SMike Pritchard.Fx
570227791bSRuslan Ermilovend, a concept cisco does not really implement.
58e66dbdb6SPoul-Henning Kamp.Pp
59d59cf2acSPoul-Henning Kamp.Ar Protocol number
60ef8f7ac9SSheldon Hearnsets tunnel mode.
6178d9ac57SBill FumerolaOriginal KA9Q NOS uses 94 but many people use 4
6278d9ac57SBill Fumerolaon the worldwide backbone of ampr.org.
63d59cf2acSPoul-Henning Kamp.Pp
6459edad7aSPhilippe Charnier.Ar Target
65e66dbdb6SPoul-Henning Kampis the address of the remote tunnel device, this must match the source
66e66dbdb6SPoul-Henning Kampaddress set on the remote end.
67e66dbdb6SPoul-Henning Kamp.Sh EXAMPLES
6859edad7aSPhilippe CharnierThis end, a
69f050f700SMike Pritchard.Fx
7059edad7aSPhilippe Charnierbox on address 192.168.59.34:
711252c1bbSRuslan Ermilov.Bd -literal -offset indent
72e66dbdb6SPoul-Henning Kampnos-tun -t /dev/tun0 -s 192.168.61.1 -d 192.168.61.2 192.168.56.45
73e66dbdb6SPoul-Henning Kamp.Ed
74e66dbdb6SPoul-Henning Kamp.Pp
75e66dbdb6SPoul-Henning KampRemote cisco on address 192.168.56.45:
761252c1bbSRuslan Ermilov.Bd -literal -offset indent
77e66dbdb6SPoul-Henning Kampinterface tunnel 0
78e66dbdb6SPoul-Henning Kampip address 192.168.61.2 255.255.255.252
79e66dbdb6SPoul-Henning Kamptunnel mode nos
80e66dbdb6SPoul-Henning Kamptunnel destination 192.168.59.34
81e66dbdb6SPoul-Henning Kamptunnel source 192.168.56.45
82e66dbdb6SPoul-Henning Kamp.Ed
83*04970b8dSSevan Janiyan.Sh HISTORY
84*04970b8dSSevan JaniyanThe
85*04970b8dSSevan Janiyan.Nm
86*04970b8dSSevan Janiyanutility appeared in
87*04970b8dSSevan Janiyan.Fx 3.0 .
8859edad7aSPhilippe Charnier.Sh AUTHORS
89f4d874a1SRuslan Ermilov.An -nosplit
90bd0891ceSBaptiste Daroussin.An Nickolay N. Dudorov Aq Mt nnd@itfs.nsk.su
9159edad7aSPhilippe Charnierwrote the program,
92bd0891ceSBaptiste Daroussin.An Poul-Henning Kamp Aq Mt phk@FreeBSD.org
9359edad7aSPhilippe Charnierwrote the man-page.
94bd0891ceSBaptiste Daroussin.An Isao SEKI Aq Mt iseki@gongon.com
95d59cf2acSPoul-Henning Kampadded a new flag, IP protocol number.
966087df9eSRuslan Ermilov.Sh BUGS
970227791bSRuslan ErmilovWe do not allow for setting our source address for multihomed machines.
98