d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Minor man page corrections and fixups to document the difference between

Browse Source 
tap and vmnet style devices.

Submitted by:	Vladimir
This commit is contained in:
nsayer 2000-08-02 17:27:39 +00:00
parent 5ec5779e12
commit 6547d607e1
1 changed files with 41 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
share/man/man4/tap.4
View File

@ -147,23 +147,41 @@ Retrieve the process group value for
signals into the argument
.Va int
value.
.It SIOCGIFADDR
.It Dv SIOCGIFADDR
Retrieve the Media Access Control
.Pq MAC
address. This command should be executed on descriptor, associated with
control device
.Pq Pa /dev/tap Ns Sy N .
.Pq Dv MAC
address of the
.Dq remote
side. This command is used by the VMware port and expected to be executed on
descriptor, associated with control device
.Po
usually
.Pa /dev/vmnet Ns Sy N
or
.Pa /dev/tap Ns Sy N
.Pc .
The
.Va buffer ,
which is passed as argument, is expected to have enought space to store
.Pq MAC
which is passed as the argument, is expected to have enough space to store
the
.Dv MAC
address. At the open time both
.Dq local
and
.Dq remote
.Dv MAC
addresses are the same, so this command could be used to retrieve the
.Dq local
.Dv MAC
address.
.It SIOCSIFADDR
.It Dv SIOCSIFADDR
Set the Media Access Control
.Pq MAC
address. This command should be executed on a descriptor, associated with
control device
.Pq Pa /dev/tap Ns Sy N .
.Pq Dv MAC
address of the
.Dq remote
side. This command is used by VMware port and expected to be executed on
a descriptor, associated with control device
.Pq usually Pa /dev/vmnet Ns Sy N .
.El
.Pp
The control device also supports
@ -171,24 +189,25 @@ The control device also supports
for read; selecting for write is pointless, and always succeeds, since
writes are always non-blocking.
.Pp
On the last close of the data device, by default, the interface is
On the last close of the data device, the interface is
brought down
.Po
as if with
.Dq ifconfig tap Ns Sy N No down
.Pc .
.Pc unless the devices is a VMnet device.
All queued frames are thrown away. If the interface is up when the data
device is not open output frames are always thrown away rather than
device is not open, output frames are thrown away rather than
letting them pile up.
.Pp
The
.Nm tap
device is also can be used with VMware port as a replacement
of VMnet device driver. The driver uses minor number to select between
device is also can be used with the VMware port as a replacement
for the old VMnet device driver. The driver uses the minor number
to select between
.Nm tap
and
.Nm vmnet
devices. VMnet minor numbering is
devices. VMnet minor numbers begin at
.Va 0x10000
+
.Va N .
@ -198,13 +217,14 @@ is a VMnet unit number. In this case control device is expected to be
.Pa /dev/vmnet Ns Sy N ,
and network interface will be
.Sy vmnet Ns Ar N .
Everything else is the same.
Additionally, VMnet devices do not ifconfig themselves down when the
control device is closed. Everything else is the same.
.Pp
In addition to mentioned above
.Xr ioctl 2
there are additional one for VMware port.
there is one additional one for the VMware port.
.Bl -tag -width VMIO_SIOCSETMACADDR
.It VMIO_SIOCSIFFLAGS
.It Dv VMIO_SIOCSIFFLAGS
VMware
.Dv SIOCSIFFLAGS .
.El