xref: /freebsd/sbin/nos-tun/nos-tun.8 (revision 9806e231322307da0109e101ae2ef997a4a22290)
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.\"
11e66dbdb6SPoul-Henning Kamp.Dd April 11, 1998
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
27e66dbdb6SPoul-Henning Kamp.Ar target
28e66dbdb6SPoul-Henning Kamp.Sh DESCRIPTION
29e1205e80SPhilippe CharnierThe
30e1205e80SPhilippe Charnier.Nm
31e1205e80SPhilippe Charnierutility is used to establish an
32e66dbdb6SPoul-Henning Kamp.Em nos
33e66dbdb6SPoul-Henning Kampstyle tunnel, (also known as
34e66dbdb6SPoul-Henning Kamp.Em ka9q
35e66dbdb6SPoul-Henning Kampor
36e66dbdb6SPoul-Henning Kamp.Em IP-IP
37e66dbdb6SPoul-Henning Kamptunnel) using a
38e66dbdb6SPoul-Henning Kamp.Xr tun 4
39e66dbdb6SPoul-Henning Kampkernel interface.
40e66dbdb6SPoul-Henning Kamp.Pp
4159edad7aSPhilippe Charnier.Ar Tunnel
42e66dbdb6SPoul-Henning Kampis the name of the tunnel device
4359edad7aSPhilippe Charnier.Pa /dev/tun0
44e66dbdb6SPoul-Henning Kampfor example.
45e66dbdb6SPoul-Henning Kamp.Pp
4659edad7aSPhilippe Charnier.Ar Source
47e66dbdb6SPoul-Henning Kampand
48e66dbdb6SPoul-Henning Kamp.Ar destination
49e66dbdb6SPoul-Henning Kampare the addresses used on the tunnel device.
50e66dbdb6SPoul-Henning KampIf you configure the tunnel against a cisco router, use a netmask of
51e66dbdb6SPoul-Henning Kamp.Dq 255.255.255.252
529806e231SRuslan Ermilovon the cisco.
539806e231SRuslan ErmilovThis is because the tunnel is a point-to-point interface
5459edad7aSPhilippe Charnierin the
55f050f700SMike Pritchard.Fx
5659edad7aSPhilippe Charnierend, a concept cisco doesn't really implement.
57e66dbdb6SPoul-Henning Kamp.Pp
58d59cf2acSPoul-Henning Kamp.Ar Protocol number
59ef8f7ac9SSheldon Hearnsets tunnel mode.
6078d9ac57SBill FumerolaOriginal KA9Q NOS uses 94 but many people use 4
6178d9ac57SBill Fumerolaon the worldwide backbone of ampr.org.
62d59cf2acSPoul-Henning Kamp.Pp
6359edad7aSPhilippe Charnier.Ar Target
64e66dbdb6SPoul-Henning Kampis the address of the remote tunnel device, this must match the source
65e66dbdb6SPoul-Henning Kampaddress set on the remote end.
66e66dbdb6SPoul-Henning Kamp.Sh EXAMPLES
6759edad7aSPhilippe CharnierThis end, a
68f050f700SMike Pritchard.Fx
6959edad7aSPhilippe Charnierbox on address 192.168.59.34:
701252c1bbSRuslan Ermilov.Bd -literal -offset indent
71e66dbdb6SPoul-Henning Kampnos-tun -t /dev/tun0 -s 192.168.61.1 -d 192.168.61.2 192.168.56.45
72e66dbdb6SPoul-Henning Kamp.Ed
73e66dbdb6SPoul-Henning Kamp.Pp
74e66dbdb6SPoul-Henning KampRemote cisco on address 192.168.56.45:
751252c1bbSRuslan Ermilov.Bd -literal -offset indent
76e66dbdb6SPoul-Henning Kampinterface tunnel 0
77e66dbdb6SPoul-Henning Kampip address 192.168.61.2 255.255.255.252
78e66dbdb6SPoul-Henning Kamptunnel mode nos
79e66dbdb6SPoul-Henning Kamptunnel destination 192.168.59.34
80e66dbdb6SPoul-Henning Kamptunnel source 192.168.56.45
81e66dbdb6SPoul-Henning Kamp.Ed
82e66dbdb6SPoul-Henning Kamp.Sh BUGS
83e66dbdb6SPoul-Henning KampWe don't allow for setting our source address for multihomed machines.
8459edad7aSPhilippe Charnier.Sh AUTHORS
85f4d874a1SRuslan Ermilov.An -nosplit
8659edad7aSPhilippe Charnier.An Nickolay N. Dudorov Aq nnd@itfs.nsk.su
8759edad7aSPhilippe Charnierwrote the program,
8859edad7aSPhilippe Charnier.An Poul-Henning Kamp Aq phk@FreeBSD.org
8959edad7aSPhilippe Charnierwrote the man-page.
90d59cf2acSPoul-Henning Kamp.An Isao SEKI Aq iseki@gongon.com
91d59cf2acSPoul-Henning Kampadded a new flag, IP protocol number.
92