xref: /freebsd/sbin/nos-tun/nos-tun.8 (revision e1205e80e5c937ac999f02f51edfb25d5b7a7ad6)
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
52e66dbdb6SPoul-Henning Kampon the cisco.  This is because the tunnel is a point-to-point interface
5359edad7aSPhilippe Charnierin the
54f050f700SMike Pritchard.Fx
5559edad7aSPhilippe Charnierend, a concept cisco doesn't really implement.
56e66dbdb6SPoul-Henning Kamp.Pp
57d59cf2acSPoul-Henning Kamp.Ar Protocol number
58ef8f7ac9SSheldon Hearnsets tunnel mode.
5978d9ac57SBill FumerolaOriginal KA9Q NOS uses 94 but many people use 4
6078d9ac57SBill Fumerolaon the worldwide backbone of ampr.org.
61d59cf2acSPoul-Henning Kamp.Pp
6259edad7aSPhilippe Charnier.Ar Target
63e66dbdb6SPoul-Henning Kampis the address of the remote tunnel device, this must match the source
64e66dbdb6SPoul-Henning Kampaddress set on the remote end.
65e66dbdb6SPoul-Henning Kamp.Sh EXAMPLES
6659edad7aSPhilippe CharnierThis end, a
67f050f700SMike Pritchard.Fx
6859edad7aSPhilippe Charnierbox on address 192.168.59.34:
691252c1bbSRuslan Ermilov.Bd -literal -offset indent
70e66dbdb6SPoul-Henning Kampnos-tun -t /dev/tun0 -s 192.168.61.1 -d 192.168.61.2 192.168.56.45
71e66dbdb6SPoul-Henning Kamp.Ed
72e66dbdb6SPoul-Henning Kamp.Pp
73e66dbdb6SPoul-Henning KampRemote cisco on address 192.168.56.45:
741252c1bbSRuslan Ermilov.Bd -literal -offset indent
75e66dbdb6SPoul-Henning Kampinterface tunnel 0
76e66dbdb6SPoul-Henning Kampip address 192.168.61.2 255.255.255.252
77e66dbdb6SPoul-Henning Kamptunnel mode nos
78e66dbdb6SPoul-Henning Kamptunnel destination 192.168.59.34
79e66dbdb6SPoul-Henning Kamptunnel source 192.168.56.45
80e66dbdb6SPoul-Henning Kamp.Ed
81e66dbdb6SPoul-Henning Kamp.Sh BUGS
82e66dbdb6SPoul-Henning KampWe don't allow for setting our source address for multihomed machines.
8359edad7aSPhilippe Charnier.Sh AUTHORS
84f4d874a1SRuslan Ermilov.An -nosplit
8559edad7aSPhilippe Charnier.An Nickolay N. Dudorov Aq nnd@itfs.nsk.su
8659edad7aSPhilippe Charnierwrote the program,
8759edad7aSPhilippe Charnier.An Poul-Henning Kamp Aq phk@FreeBSD.org
8859edad7aSPhilippe Charnierwrote the man-page.
89d59cf2acSPoul-Henning Kamp.An Isao SEKI Aq iseki@gongon.com
90d59cf2acSPoul-Henning Kampadded a new flag, IP protocol number.
91