| @@ -1,40 +1,40 @@ | | | @@ -1,40 +1,40 @@ |
1 | .\" $NetBSD: tap.4,v 1.8 2008/04/30 13:10:54 martin Exp $ | | 1 | .\" $NetBSD: tap.4,v 1.8.4.1 2009/03/18 05:15:48 snj Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 2004, 2005 The NetBSD Foundation. | | 3 | .\" Copyright (c) 2004, 2005 The NetBSD Foundation. |
4 | .\" All rights reserved. | | 4 | .\" All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" Redistribution and use in source and binary forms, with or without | | 6 | .\" Redistribution and use in source and binary forms, with or without |
7 | .\" modification, are permitted provided that the following conditions | | 7 | .\" modification, are permitted provided that the following conditions |
8 | .\" are met: | | 8 | .\" are met: |
9 | .\" 1. Redistributions of source code must retain the above copyright | | 9 | .\" 1. Redistributions of source code must retain the above copyright |
10 | .\" notice, this list of conditions and the following disclaimer. | | 10 | .\" notice, this list of conditions and the following disclaimer. |
11 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 11 | .\" 2. Redistributions in binary form must reproduce the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer in the | | 12 | .\" notice, this list of conditions and the following disclaimer in the |
13 | .\" documentation and/or other materials provided with the distribution. | | 13 | .\" documentation and/or other materials provided with the distribution. |
14 | .\" | | 14 | .\" |
15 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS | | 15 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS |
16 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | | 16 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
17 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | | 17 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
18 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS | | 18 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS |
19 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | | 19 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
20 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | | 20 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
21 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 21 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
22 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | | 22 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
23 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | | 23 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
24 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | | 24 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
25 | .\" POSSIBILITY OF SUCH DAMAGE. | | 25 | .\" POSSIBILITY OF SUCH DAMAGE. |
26 | .\" | | 26 | .\" |
27 | .Dd December 18, 2006 | | 27 | .Dd March 9, 2009 |
28 | .Dt TAP 4 | | 28 | .Dt TAP 4 |
29 | .Os | | 29 | .Os |
30 | .Sh NAME | | 30 | .Sh NAME |
31 | .Nm tap | | 31 | .Nm tap |
32 | .Nd virtual Ethernet device | | 32 | .Nd virtual Ethernet device |
33 | .Sh SYNOPSIS | | 33 | .Sh SYNOPSIS |
34 | .Cd pseudo-device tap | | 34 | .Cd pseudo-device tap |
35 | .Sh DESCRIPTION | | 35 | .Sh DESCRIPTION |
36 | The | | 36 | The |
37 | .Nm | | 37 | .Nm |
38 | driver allows the creation and use of virtual Ethernet devices. | | 38 | driver allows the creation and use of virtual Ethernet devices. |
39 | Those interfaces appear just as any real Ethernet NIC to the kernel, | | 39 | Those interfaces appear just as any real Ethernet NIC to the kernel, |
40 | but can also be accessed by userland through a character device node in order | | 40 | but can also be accessed by userland through a character device node in order |
| @@ -154,27 +154,27 @@ of the form f2:0b:a4:xx:xx:xx. | | | @@ -154,27 +154,27 @@ of the form f2:0b:a4:xx:xx:xx. |
154 | This address can later be changed in two ways: | | 154 | This address can later be changed in two ways: |
155 | through a sysctl node, or an ioctl call. | | 155 | through a sysctl node, or an ioctl call. |
156 | .Pp | | 156 | .Pp |
157 | The sysctl node is net.link.tap.\*[Lt]iface\*[Gt]. | | 157 | The sysctl node is net.link.tap.\*[Lt]iface\*[Gt]. |
158 | Any string of six colon-separated hexadecimal numbers will be accepted. | | 158 | Any string of six colon-separated hexadecimal numbers will be accepted. |
159 | Reading that node will provide a string representation of the current | | 159 | Reading that node will provide a string representation of the current |
160 | Ethernet address. | | 160 | Ethernet address. |
161 | .Pp | | 161 | .Pp |
162 | The address can also be changed with the | | 162 | The address can also be changed with the |
163 | .Dv SIOCSIFPHYADDR | | 163 | .Dv SIOCSIFPHYADDR |
164 | ioctl, which is used the same way as with | | 164 | ioctl, which is used the same way as with |
165 | .Xr gif 4 . | | 165 | .Xr gif 4 . |
166 | The difference is in the family of the address which is passed inside the | | 166 | The difference is in the family of the address which is passed inside the |
167 | .Ft struct ifreqalias | | 167 | .Ft struct ifaliasreq |
168 | argument, which should be set to | | 168 | argument, which should be set to |
169 | .Dv AF_LINK . | | 169 | .Dv AF_LINK . |
170 | This ioctl call should be made on a socket, as it is not available on | | 170 | This ioctl call should be made on a socket, as it is not available on |
171 | the ioctl handler of the character device interface. | | 171 | the ioctl handler of the character device interface. |
172 | .Sh FILES | | 172 | .Sh FILES |
173 | .Bl -tag -compact -width /dev/tap[0-9]* | | 173 | .Bl -tag -compact -width /dev/tap[0-9]* |
174 | .It Pa /dev/tap | | 174 | .It Pa /dev/tap |
175 | cloning device | | 175 | cloning device |
176 | .It Pa /dev/tap[0-9]* | | 176 | .It Pa /dev/tap[0-9]* |
177 | individual character device nodes | | 177 | individual character device nodes |
178 | .El | | 178 | .El |
179 | .Sh SEE ALSO | | 179 | .Sh SEE ALSO |
180 | .Xr bridge 4 , | | 180 | .Xr bridge 4 , |