nos-tun(8)

nos-tun8

Implement ``nos'' or ``ka9q'' style ip over ip tunnel

Usage

nos-tun -t tunnel -s source -d destination -p protocol_number [source] target

Overview

The nos-tun utility is used to establish an nos style tunnel, (also known as ka9q or IP-IP tunnel) using a tun(4) kernel interface.

Tunnel is the name of the tunnel device /dev/tun0 for example.

Source and destination are the addresses used on the tunnel device. If you configure the tunnel against a cisco router, use a netmask of “255.255.255.252” on the cisco. This is because the tunnel is a point-to-point interface in the FreeBSD end, a concept cisco does not really implement.

Protocol number sets tunnel mode. Original KA9Q NOS uses 94 but many people use 4 on the worldwide backbone of ampr.org.

Target is the address of the remote tunnel device, this must match the source address set on the remote end.

Examples

This end, a FreeBSD box on address 192.168.59.34:

nos-tun -t /dev/tun0 -s 192.168.61.1 -d 192.168.61.2 192.168.56.45

Remote cisco on address 192.168.56.45:

interface tunnel 0
ip address 192.168.61.2 255.255.255.252
tunnel mode nos
tunnel destination 192.168.59.34
tunnel source 192.168.56.45

Releases

77 releases since FreeBSD 3.0-RELEASE; the text changed 41 times.

  1. 3.0–3.2
  2. 3.3–3.5.1
  3. 4.0–4.2
  4. 4.3
  5. 4.4
  6. 4.5–4.7
  7. 4.8–4.11
  8. 5.0–5.2.1
  9. 5.3–5.5
  10. 6.0–6.3
  11. 6.4
  12. 7.0
  13. 7.1
  14. 7.2
  15. 7.3
  16. 7.4
  17. 8.0
  18. 8.1
  19. 8.2
  20. 8.3
  21. 8.4
  22. 9.0
  23. 9.1
  24. 9.2
  25. 9.3
  26. 10.0
  27. 10.1
  28. 10.2
  29. 10.3
  30. 10.4
  31. 11.0
  32. 11.1
  33. 11.2
  34. 11.3
  35. 11.4
  36. 12.0
  37. 12.1
  38. 12.2
  39. 12.3
  40. 12.4
  41. 13.0–13.2
  42. 13.3–16.0

History

The nos-tun utility appeared in FreeBSD 3.0.

Authors

Nickolay N. Dudorov ⟨[email protected]⟩ wrote the program, Poul-Henning Kamp ⟨[email protected]⟩ wrote the man-page. Isao SEKI ⟨[email protected]⟩ added a new flag, IP protocol number.

Bugs

We do not allow for setting our source address for multihomed machines.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.