summaryrefslogtreecommitdiff
path: root/docs/interfaces/bridging.rst
diff options
context:
space:
mode:
authorChristian Poessinger <christian@poessinger.com>2019-08-05 15:50:55 +0200
committerChristian Poessinger <christian@poessinger.com>2019-11-07 21:54:22 +0100
commit9c87432239795df17c92ed1409bf72375d003a28 (patch)
tree049d6ed586234ec43275dca7e6ac242a6f862c81 /docs/interfaces/bridging.rst
parent0de54083437d84cb678d7d2676e6a2128e6baad4 (diff)
downloadvyos-documentation-9c87432239795df17c92ed1409bf72375d003a28.tar.gz
vyos-documentation-9c87432239795df17c92ed1409bf72375d003a28.zip
bridge: T1556: adopt to new bridge syntax
Diffstat (limited to 'docs/interfaces/bridging.rst')
-rw-r--r--docs/interfaces/bridging.rst43
1 files changed, 24 insertions, 19 deletions
diff --git a/docs/interfaces/bridging.rst b/docs/interfaces/bridging.rst
index e42d76ad..dbd5f0db 100644
--- a/docs/interfaces/bridging.rst
+++ b/docs/interfaces/bridging.rst
@@ -5,15 +5,23 @@ Interfaces in VyOS can be bridged together to provide software switching of
Layer-2 traffic.
A bridge is created when a bridge interface is defined. In the example below
-we will be creating a bridge for VLAN 100 and assigning a VIF to the bridge.
+we create a bridge named br100 with eth1 and eth2 as the bridge member ports.
.. code-block:: sh
set interfaces bridge 'br100'
- ~~set interfaces ethernet eth1 vif 100 bridge-group bridge br100~~
- set interfaces bridge br100 member interface eth1
-
-Interfaces assigned to a bridge-group do not have address configuration. An IP
+ set interfaces bridge br100 member interface eth1
+ set interfaces bridge br100 member interface eth2
+
+Each bridge member can be assiged a port cost and priority using the following
+commands:
+
+.. code-block:: sh
+
+ set interfaces bridge br100 member interface eth1 cost 10
+ set interfaces bridge br100 member interface eth1 priority 1024
+
+Interfaces assigned to a bridge do not have address configuration. An IP
address can be assigned to the bridge interface itself, however, like any
normal interface.
@@ -29,16 +37,17 @@ Example Result:
bridge br100 {
address 192.168.100.1/24
address 2001:db8:100::1/64
- }
- [...]
- ethernet eth1 {
- [...]
- vif 100 {
- bridge-group {
- bridge br100
+ member {
+ interface eth1 {
+ cost 10
+ priority 1024
+ }
+ interface eth2 {
}
}
+
}
+ [...]
In addition to normal IP interface configuration, bridge interfaces support
Spanning-Tree Protocol. STP is disabled by default.
@@ -46,20 +55,16 @@ Spanning-Tree Protocol. STP is disabled by default.
.. note:: Please use caution when introducing spanning-tree protocol on a
network as it may result in topology changes.
-To enable spanning-tree use the
-`set interfaces bridge <name> stp true` command:
+To enable spanning-tree use the `set interfaces bridge <name> stp` command:
.. code-block:: sh
- set interfaces bridge br100 stp true
+ set interfaces bridge br100 stp
STP `priority`, `forwarding-delay`, `hello-time`, and `max-age` can be
-configured for the bridge-group. The MAC aging time can also be configured
+configured for the bridge. The MAC aging time can also be configured
using the `aging` directive.
-For member interfaces, the bridge-group `priority` and `cost` can be
-configured.
-
The `show bridge` operational command can be used to display configured
bridges: