freebsd-dev/share/man
Kyle Evans 251a32b5b2 tun/tap: merge and rename to tuntap
tun(4) and tap(4) share the same general management interface and have a lot
in common. Bugs exist in tap(4) that have been fixed in tun(4), and
vice-versa. Let's reduce the maintenance requirements by merging them
together and using flags to differentiate between the three interface types
(tun, tap, vmnet).

This fixes a couple of tap(4)/vmnet(4) issues right out of the gate:
- tap devices may no longer be destroyed while they're open [0]
- VIMAGE issues already addressed in tun by kp

[0] emaste had removed an easy-panic-button in r240938 due to devdrn
blocking. A naive glance over this leads me to believe that this isn't quite
complete -- destroy_devl will only block while executing d_* functions, but
doesn't block the device from being destroyed while a process has it open.
The latter is the intent of the condvar in tun, so this is "fixed" (for
certain definitions of the word -- it wasn't really broken in tap, it just
wasn't quite ideal).

ifconfig(8) also grew the ability to map an interface name to a kld, so
that `ifconfig {tun,tap}0` can continue to autoload the correct module, and
`ifconfig vmnet0 create` will now autoload the correct module. This is a
low overhead addition.

(MFC commentary)

This may get MFC'd if many bugs in tun(4)/tap(4) are discovered after this,
and how critical they are. Changes after this are likely easily MFC'd
without taking this merge, but the merge will be easier.

I have no plans to do this MFC as of now.

Reviewed by:	bcr (manpages), tuexen (testing, syzkaller/packetdrill)
Input also from:	melifaro
Relnotes:	yes
Differential Revision:	https://reviews.freebsd.org/D20044
2019-05-08 02:32:11 +00:00
..
man1 share: normalize paths using SRCTOP-relative paths or :H when possible 2017-03-04 11:26:40 +00:00
man3 Drop "All rights reserved" from my copyright statements. 2019-03-06 22:11:45 +00:00
man4 tun/tap: merge and rename to tuntap 2019-05-08 02:32:11 +00:00
man5 Update the spelling of my name 2019-04-22 17:52:46 +00:00
man6 Update intro(6) - remove hint that doesn't work, add explicit list 2017-11-27 12:39:35 +00:00
man7 Remove trailing slashes from URLs; current mandoc(1) seems to render 2019-05-01 13:00:33 +00:00
man8 Add rc.resume(8) alias for rc(8) to fix the manpage cross references 2019-02-12 23:33:16 +00:00
man9 device_printf: Use sbuf for more coherent prints on SMP 2019-05-07 17:47:20 +00:00
Makefile