| tap.4 (144979) | tap.4 (166497) |
|---|---|
| 1.\" $FreeBSD: head/share/man/man4/tap.4 144979 2005-04-13 00:30:19Z mdodd $ | 1.\" $FreeBSD: head/share/man/man4/tap.4 166497 2007-02-04 16:32:46Z bms $ |
| 2.\" Based on PR#2411 3.\" | 2.\" Based on PR#2411 3.\" |
| 4.Dd July 9, 2000 | 4.Dd February 4, 2007 |
| 5.Os 6.Dt TAP 4 7.Sh NAME 8.Nm tap 9.Nd Ethernet tunnel software network interface 10.Sh SYNOPSIS 11.Cd device tap 12.Sh DESCRIPTION --- 23 unchanged lines hidden (view full) --- 36interface. 37.Pp 38The network interfaces are named 39.Dq Li tap0 , 40.Dq Li tap1 , 41etc., one for each control device that has been opened. 42These Ethernet network interfaces persist until 43.Pa if_tap.ko | 5.Os 6.Dt TAP 4 7.Sh NAME 8.Nm tap 9.Nd Ethernet tunnel software network interface 10.Sh SYNOPSIS 11.Cd device tap 12.Sh DESCRIPTION --- 23 unchanged lines hidden (view full) --- 36interface. 37.Pp 38The network interfaces are named 39.Dq Li tap0 , 40.Dq Li tap1 , 41etc., one for each control device that has been opened. 42These Ethernet network interfaces persist until 43.Pa if_tap.ko |
| 44module is unloaded (if | 44module is unloaded, or until removed with "ifconfig destroy" (see below). 45.Pp |
| 45.Nm | 46.Nm |
| 46is built into your kernel, the network interfaces cannot be removed). | 47devices are created using interface cloning. 48This is done using the 49.Dq ifconfig tap Ns Sy N No create 50command. 51This is the preferred method of creating 52.Nm 53devices. 54The same method allows removal of interfaces. 55For this, use the 56.Dq ifconfig tap Ns Sy N No destroy 57command. |
| 47.Pp | 58.Pp |
| 48The | 59If the 60.Xr sysctl 8 61variable 62.Va net.link.tap.devfs_cloning 63is non-zero, the |
| 49.Nm 50interface 51permits opens on the special control device 52.Pa /dev/tap . 53When this device is opened, 54.Nm 55will return a handle for the lowest unused 56.Nm 57device (use 58.Xr devname 3 59to determine which). | 64.Nm 65interface 66permits opens on the special control device 67.Pa /dev/tap . 68When this device is opened, 69.Nm 70will return a handle for the lowest unused 71.Nm 72device (use 73.Xr devname 3 74to determine which). |
| 75.Pp 76.Bf Em 77Disabling the legacy devfs cloning functionality may break existing 78applications which use 79.Nm , 80such as 81.Tn VMware 82and 83.Xr ssh 1 . 84It therefore defaults to being enabled until further notice. 85.Ef 86.Pp |
|
| 60Control devices (once successfully opened) persist until 61.Pa if_tap.ko | 87Control devices (once successfully opened) persist until 88.Pa if_tap.ko |
| 62is unloaded in the same way that network interfaces persist (see above). | 89is unloaded or the interface is destroyed. |
| 63.Pp 64Each interface supports the usual Ethernet network interface 65.Xr ioctl 2 Ns s , 66such as 67.Dv SIOCSIFADDR 68and 69.Dv SIOCSIFNETMASK , 70and thus can be used with --- 202 unchanged lines hidden --- | 90.Pp 91Each interface supports the usual Ethernet network interface 92.Xr ioctl 2 Ns s , 93such as 94.Dv SIOCSIFADDR 95and 96.Dv SIOCSIFNETMASK , 97and thus can be used with --- 202 unchanged lines hidden --- |