xref: /freebsd/sbin/nos-tun/nos-tun.8 (revision ef8f7ac9356563fe48e63d3b02c92b7b9e0d73e8)
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
13e66dbdb6SPoul-Henning Kamp.Os FreeBSD 3.0
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
18e66dbdb6SPoul-Henning Kamp.Nm nos-tun
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
2959edad7aSPhilippe Charnier.Nm Nos-tun
30e66dbdb6SPoul-Henning Kampis used to establish an
31e66dbdb6SPoul-Henning Kamp.Em nos
32e66dbdb6SPoul-Henning Kampstyle tunnel, (also known as
33e66dbdb6SPoul-Henning Kamp.Em ka9q
34e66dbdb6SPoul-Henning Kampor
35e66dbdb6SPoul-Henning Kamp.Em IP-IP
36e66dbdb6SPoul-Henning Kamptunnel) using a
37e66dbdb6SPoul-Henning Kamp.Xr tun 4
38e66dbdb6SPoul-Henning Kampkernel interface.
39e66dbdb6SPoul-Henning Kamp.Pp
4059edad7aSPhilippe Charnier.Ar Tunnel
41e66dbdb6SPoul-Henning Kampis the name of the tunnel device
4259edad7aSPhilippe Charnier.Pa /dev/tun0
43e66dbdb6SPoul-Henning Kampfor example.
44e66dbdb6SPoul-Henning Kamp.Pp
4559edad7aSPhilippe Charnier.Ar Source
46e66dbdb6SPoul-Henning Kampand
47e66dbdb6SPoul-Henning Kamp.Ar destination
48e66dbdb6SPoul-Henning Kampare the addresses used on the tunnel device.
49e66dbdb6SPoul-Henning KampIf you configure the tunnel against a cisco router, use a netmask of
50e66dbdb6SPoul-Henning Kamp.Dq 255.255.255.252
51e66dbdb6SPoul-Henning Kampon the cisco.  This is because the tunnel is a point-to-point interface
5259edad7aSPhilippe Charnierin the
53f050f700SMike Pritchard.Fx
5459edad7aSPhilippe Charnierend, a concept cisco doesn't really implement.
55e66dbdb6SPoul-Henning Kamp.Pp
56d59cf2acSPoul-Henning Kamp.Ar Protocol number
57ef8f7ac9SSheldon Hearnsets tunnel mode.
58ef8f7ac9SSheldon HearnOriginal KA9Q NOS uses 94 but many peoples use 4
59d59cf2acSPoul-Henning Kampin worldwide backbone of ampr.org.
60d59cf2acSPoul-Henning Kamp.Pp
6159edad7aSPhilippe Charnier.Ar Target
62e66dbdb6SPoul-Henning Kampis the address of the remote tunnel device, this must match the source
63e66dbdb6SPoul-Henning Kampaddress set on the remote end.
64e66dbdb6SPoul-Henning Kamp.Sh EXAMPLES
6559edad7aSPhilippe CharnierThis end, a
66f050f700SMike Pritchard.Fx
6759edad7aSPhilippe Charnierbox on address 192.168.59.34:
68e66dbdb6SPoul-Henning Kamp.Bd -literal -offset indent 4m
69e66dbdb6SPoul-Henning Kampnos-tun -t /dev/tun0 -s 192.168.61.1 -d 192.168.61.2 192.168.56.45
70e66dbdb6SPoul-Henning Kamp.Ed
71e66dbdb6SPoul-Henning Kamp.Pp
72e66dbdb6SPoul-Henning KampRemote cisco on address 192.168.56.45:
73e66dbdb6SPoul-Henning Kamp.Bd -literal -offset indent 4m
74e66dbdb6SPoul-Henning Kampinterface tunnel 0
75e66dbdb6SPoul-Henning Kampip address 192.168.61.2 255.255.255.252
76e66dbdb6SPoul-Henning Kamptunnel mode nos
77e66dbdb6SPoul-Henning Kamptunnel destination 192.168.59.34
78e66dbdb6SPoul-Henning Kamptunnel source 192.168.56.45
79e66dbdb6SPoul-Henning Kamp.Ed
80e66dbdb6SPoul-Henning Kamp.Sh BUGS
81e66dbdb6SPoul-Henning KampWe don't allow for setting our source address for multihomed machines.
8259edad7aSPhilippe Charnier.Sh AUTHORS
8359edad7aSPhilippe Charnier.An Nickolay N. Dudorov Aq nnd@itfs.nsk.su
8459edad7aSPhilippe Charnierwrote the program,
8559edad7aSPhilippe Charnier.An Poul-Henning Kamp Aq phk@FreeBSD.org
8659edad7aSPhilippe Charnierwrote the man-page.
87d59cf2acSPoul-Henning Kamp.An Isao SEKI Aq iseki@gongon.com
88d59cf2acSPoul-Henning Kampadded a new flag, IP protocol number.
89