diff options
Diffstat (limited to 'static/netbsd/man4/bridge.4')
| -rw-r--r-- | static/netbsd/man4/bridge.4 | 142 |
1 files changed, 142 insertions, 0 deletions
diff --git a/static/netbsd/man4/bridge.4 b/static/netbsd/man4/bridge.4 new file mode 100644 index 00000000..cd1b1cf7 --- /dev/null +++ b/static/netbsd/man4/bridge.4 @@ -0,0 +1,142 @@ +.\" $NetBSD: bridge.4,v 1.14 2020/09/27 15:42:48 roy Exp $ +.\" +.\" Copyright 2001 Wasabi Systems, Inc. +.\" All rights reserved. +.\" +.\" Written by Jason R. Thorpe for Wasabi Systems, Inc. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed for the NetBSD Project by +.\" Wasabi Systems, Inc. +.\" 4. The name of Wasabi Systems, Inc. may not be used to endorse +.\" or promote products derived from this software without specific prior +.\" written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED +.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd September 27, 2020 +.Dt BRIDGE 4 +.Os +.Sh NAME +.Nm bridge +.Nd network bridge device +.Sh SYNOPSIS +.Cd "pseudo-device bridge" +.Sh DESCRIPTION +The +.Nm +driver creates a logical link between two or more IEEE 802 networks +that use the same (or +.Dq similar enough ) +framing format. +For example, it is possible to bridge Ethernet and 802.11 networks together, +but it is not possible to bridge Ethernet and Token Ring together. +.Pp +To use +.Nm bridge , +the administrator must first create the interface and configure +the bridge parameters. +The bridge is created using the +.Xr ifconfig 8 +.Cm create +subcommand. +The learning and forwarding behavior and other parameters of a +bridge are configured by the +.Xr brconfig 8 +utility. +.Pp +A bridge can be used to provide several services, such as a simple +802.11-to-Ethernet bridge for wireless hosts, and traffic isolation. +.Pp +A bridge works like a switch, forwarding traffic from one interface +to another. +Multicast and broadcast packets are always forwarded to all +interfaces that are part of the bridge. +For unicast traffic, the bridge learns which MAC addresses are associated +with which interfaces and will forward the traffic selectively. +.Pp +The +.Nm +driver implements the IEEE 802.1D Spanning Tree protocol (STP). +Spanning Tree is used to detect and remove loops in a network topology. +.Pp +When filtering is enabled, bridged packets will pass through the filter +inbound on the originating interface and outbound on the appropriate +interfaces. +ARP and REVARP packets are forwarded without being filtered and others +that are not IP nor IPv6 packets are not forwarded when filtering is +enabled. +.Pp +Note that packets to and from the bridging host will be seen by the +filter on the interface with the appropriate address configured as well +as on the interface on which the packet arrives or departs. +.Pp +The +.Nm +driver will enable passing of VLAN tagged packets automatically if the underlying +interfaces support it. +This is to facilitate XEN network configurations with +.Xr xennet 4 . +.Pp +It is not possible to assign an IP address directly to the +.Nm +interface. +Instead, assign an IP address to a +.Xr vether 4 +interface which can be added to the bridge. +.Sh SEE ALSO +.Xr l2tp 4 , +.Xr options 4 , +.Xr xennet 4 , +.Xr vether 4 , +.Xr brconfig 8 , +.Xr ipf 8 +.Sh HISTORY +The +.Nm +driver first appeared in +.Nx 1.6 . +.Sh AUTHORS +.An -nosplit +The +.Nm bridge +driver was originally written by +.An Jason L. Wright +.Aq jason@thought.net +as part of an undergraduate independent study at the University of +North Carolina at Greensboro. +.Pp +This version of the +.Nm +driver has been heavily modified from the original version by +.An Jason R. Thorpe +.Aq thorpej@wasabisystems.com . +.Sh BUGS +The +.Nm +driver currently supports only Ethernet and Ethernet-like (e.g. 802.11) +network devices, with exactly the same interface MTU size as the bridge device. +.Pp +The +.Nm +driver currently does not support snooping via +.Xr bpf 4 . |
