MAN page from openSUSE Tumbleweed wicked-0.6.45-1.1.x86_64.rpm
Section: Network configuration (5)
Updated: Januar 2014Index
ifcfg-bridge - ethernet bridge interface configuration
To setup a bridge interface you need a configuration fileifcfg-<interface-name>
with the usual network settings. But you must add additional variables:
- BRIDGE <yes|no>
- This option must be set to 'yes' to identify this interface as a bridge interface.
- BRIDGE_PORTS <interface1 interface2 ... interfaceN>
- This variable contains a space-separated list of N interfaces which take part in thebridging.
- BRIDGE_AGEINGTIME <time>
- This option sets the ethernet address ageing time, in seconds. After <time>seconds of not having seen a frame coming from a certain address, the bridge willdelete that address from the forwarding database. Setting ageing time to zeromakes all entries permanent.
- BRIDGE_FORWARDDELAY <time>
- Forwarding delay time is the time in seconds spent in each of the listening andlearning states before the forwarding state is entered. This delay is so that whena new bridge comes onto a busy network it looks at some traffic before participating.
- BRIDGE_HELLOTIME <time>
- Periodically, a hello packet is sent out by the root bridge and the designated bridges.Hello packets are used to communicate information about the topology throughout theentire bridged local area network.
- BRIDGE_MAXAGE <time>
- If a another bridge in the spanning tree does not send out a hello packet for a longperiod of time, it is assumed to be dead. This timeout can be set with this variable.
- BRIDGE_PATHCOSTS <costs1 costs2 ... costsN>
- This is a space-separated list of costs corresponding to the interfaces in BRIDGE_PORTS.Each interface in BRIDGE_PORTS could have a different speed and this value is used whendeciding which link to use. Faster interfaces should have lower costs.Use '-' to skip setting of the path costs for a port in a non-empty cost list.
- BRIDGE_PORTPRIORITIES <prio1 prio2 ... prioN>
- This is a space-separated list of priorities corresponding to the interfaces in BRIDGE_PORTS.The priority value is an unsigned 8-bit quantity (a number between 0 and 255), and hasno dimension. This metric is used in the designated port and root port selection algorithms.Use '-' to skip setting of the priority for a port in a non-empty priority list.
- BRIDGE_PRIORITY <priority>
- This option sets the bridge's priority to <priority>. The priority value is anunsigned 16-bit quantity (a number between 0 and 65535), and has no dimension.Lower priority values are 'better'. The bridge with the lowest priority will beelected 'root bridge'.
- BRIDGE_STP <on|off>
- Multiple ethernet bridges can work together to create even larger networksof ethernets using the IEEE 802.1d spanning tree protocol. This protocol isused for finding the shortest path between two ethernets, and for eliminatingloops from the topology.The spanning tree protocol can also be turned off (for those situationswhere it just doesn't make sense, for example when this linux box isthe only bridge on the LAN, or when you know that there are no loops inthe topology.)
Minimal example for a bridge interface on eth0 and eth1, the bridge interface itself is configured via dhcp:
STARTMODE='auto' BOOTPROTO='dhcp' BRIDGE='yes' BRIDGE_STP='off' BRIDGE_FORWARDDELAY='0' BRIDGE_PORTS='eth0 eth1'
For additional and more general information have a look into<http://www.linuxfoundation.org/collaborate/workgroups/networking/bridge>.
Copyright (C) 2014 SUSE LINUX Products GmbH, Nuernberg, Germany.
Please report bugs at <https://bugzilla.novell.com/index.cgi
Stefan Scheler -- original bridge man page
- OPTIONAL VARIABLES
- ADDITIONAL INFORMATION
- SEE ALSO
This document was created byman2html,using the manual pages.