.\" $OpenBSD: brconfig.8,v 1.4 1999/03/01 16:01:48 jason Exp $ .\" .\" Copyright (c) 1999 Jason L. Wright (jason@thought.net) .\" All rights reserved. .\" .\" 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 by Jason L. Wright .\" 4. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 THE AUTHOR 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 Feb 26, 1999 .Dt BRCONFIG 8 .Os .Sh NAME .Nm brconfig .Nd manipulate bridge interfaces .Sh SYNOPSIS .Nm brconfig .Ar -a .Nm brconfig .Ar bridge-name .Op Ar up .Op Ar down .Op Ar addr .Op Ar add interface-name .Op Ar delete interface-name .Op Ar maxaddr size .Op Ar link0 .Op Ar link1 .Op Ar -link0 .Op Ar -link1 .Op Ar ... .Sh DESCRIPTION The .Nm brconfig utility retrieves kernel state of bridge interfaces and allows user control of these bridges. In the first synopsis, the command will list the status of all bridges in the system. In the second, its command line consists of the name of a bridge and a set of operations to be performed on that bridge. The commands are executed in the order they were specified. If no command is specified in the second synopsis, the .Nm brconfig will display status information about the bridge. .Pp The available commands are: .Bl -tag -width Ds .It Ar up Start the bridge forwarding packets. .It Ar down Stop the bridge from forwarding packets. .It Ar addr Display the addresses that have been learned by the bridge. .It Ar add interface-name Add the interface named by .Ar interface-name as a member of the bridge. The interface must already be ready for packet reception, (ie. it must be in the .Cm up state, see .Xr ifconfig 8 ) The interface is put into promiscuous mode so that it can receive every packet sent on the network. .It Ar delete interface-name Remove the interface named by .Ar interface-name from the bridge. Promiscuous mode is turned off for the interface when it is removed from the bridge. .It Ar del Alias for `delete'. .It Ar maxaddr size Set the address cache size to .Cm size . The default is 100 entries. .It Ar link0 Setting this flag stops all non-IP multicast packets from being forwarded by the bridge. .It Ar -link0 Clear the .Ar link0 flag on the bridge interface. .It Ar link1 Setting this flags stops all IP multicast packets from being forwarded by the bridge. .It Ar -link0 Clear the .Ar link1 flag on the bridge interface. .El .Sh EXAMPLES .Bl -tag -width brconfig .It Cm brconfig bridge0 add pn0 add mx0 up Add the Ethernet interfaces pn0 and mx0 to the bridge bridge0, and start the bridge forwarding packets. .It Cm brconfig bridge0 Retrieve a list of interfaces that are members of bridge0, and the addresses learned by the bridge. .It Cm brconfig bridge0 down Stop bridge0 from forwarding packets. .It Cm brconfig bridge0 delete pn0 Remove the interface pn0 from the bridge bridge0. .El .Sh SEE ALSO .Xr ifconfig 8 , .Xr bridge 4 .Sh HISTORY .Nm brconfig first appeared in .Ox 2.5 . .Sh AUTHOR The .Xr brconfig 8 command and the .Xr bridge 4 kernel interface were written by Jason L. Wright as part of an undergraduate indenpendent study at the University of North Carolina at Greensboro. .Sh BUGS There are some network interface chipsets which will not work in a bridge configuration. Some, like the Lite-On PNIC, have serious flaws when running in promiscuous mode, and others, like the TI ThunderLAN, receive their own transmissions, which makes the address learning code ineffective.