xref: /freebsd/sbin/nos-tun/nos-tun.8 (revision a8445737e740901f5f2c8d24c12ef7fc8b00134e)
1.\"
2.\" ----------------------------------------------------------------------------
3.\" "THE BEER-WARE LICENSE" (Revision 42):
4.\" <phk@FreeBSD.org> wrote this file.  As long as you retain this notice you
5.\" can do whatever you want with this stuff. If we meet some day, and you think
6.\" this stuff is worth it, you can buy me a beer in return.   Poul-Henning Kamp
7.\" ----------------------------------------------------------------------------
8.\"
9.\" $Id: nos-tun.8,v 1.1 1998/04/11 19:33:05 phk Exp $
10.\"
11.Dd April 11, 1998
12.Dt NOS-TUN 8
13.Os FreeBSD 3.0
14.Sh NAME
15.Nm nos-tun
16.Nd implement ``nos'' or ``ka9q'' style IP over IP tunnel
17.Sh SYNOPSIS
18.Nm nos-tun
19.Fl t
20.Ar tunnel
21.Fl s
22.Ar source
23.Fl d
24.Ar destination
25.Ar target
26.Sh DESCRIPTION
27.Nm Nos-tun
28is used to establish an
29.Em nos
30style tunnel, (also known as
31.Em ka9q
32or
33.Em IP-IP
34tunnel) using a
35.Xr tun 4
36kernel interface.
37.Pp
38.Ar Tunnel
39is the name of the tunnel device
40.Pa /dev/tun0
41for example.
42.Pp
43.Ar Source
44and
45.Ar destination
46are the addresses used on the tunnel device.
47If you configure the tunnel against a cisco router, use a netmask of
48.Dq 255.255.255.252
49on the cisco.  This is because the tunnel is a point-to-point interface
50in the
51.Bx Free
52end, a concept cisco doesn't really implement.
53.Pp
54.Ar Target
55is the address of the remote tunnel device, this must match the source
56address set on the remote end.
57.Sh EXAMPLES
58This end, a
59.Bx Free
60box on address 192.168.59.34:
61.Bd -literal -offset indent 4m
62nos-tun -t /dev/tun0 -s 192.168.61.1 -d 192.168.61.2 192.168.56.45
63.Ed
64.Pp
65Remote cisco on address 192.168.56.45:
66.Bd -literal -offset indent 4m
67interface tunnel 0
68ip address 192.168.61.2 255.255.255.252
69tunnel mode nos
70tunnel destination 192.168.59.34
71tunnel source 192.168.56.45
72.Ed
73.Sh BUGS
74We don't allow for setting our source address for multihomed machines.
75.Sh AUTHORS
76.An Nickolay N. Dudorov Aq nnd@itfs.nsk.su
77wrote the program,
78.An Poul-Henning Kamp Aq phk@FreeBSD.org
79wrote the man-page.
80