diff options
author | Christian Poessinger <christian@poessinger.com> | 2019-11-23 10:42:03 +0100 |
---|---|---|
committer | Christian Poessinger <christian@poessinger.com> | 2019-11-23 10:49:48 +0100 |
commit | a0a07c6ab314311909ee3c808d13a712cfba2fb2 (patch) | |
tree | ef1362161463e9bd7fd00358be53a60aa78649aa /docs/interfaces/bridging.rst | |
parent | cfd378949fd3ff0c755e59d9d8564e872a89adb9 (diff) | |
download | vyos-documentation-a0a07c6ab314311909ee3c808d13a712cfba2fb2.tar.gz vyos-documentation-a0a07c6ab314311909ee3c808d13a712cfba2fb2.zip |
interfaces: update base interface definitions and links
Diffstat (limited to 'docs/interfaces/bridging.rst')
-rw-r--r-- | docs/interfaces/bridging.rst | 112 |
1 files changed, 0 insertions, 112 deletions
diff --git a/docs/interfaces/bridging.rst b/docs/interfaces/bridging.rst deleted file mode 100644 index f31e30e6..00000000 --- a/docs/interfaces/bridging.rst +++ /dev/null @@ -1,112 +0,0 @@ -.. _bridge: - -Interface Bridge ----------------- - -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 create a bridge named br100 with eth1 and eth2 as the bridge member ports. - -.. code-block:: sh - - set interfaces bridge 'br100' - 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. - -.. code-block:: sh - - set interfaces bridge br100 address '192.168.100.1/24' - set interfaces bridge br100 address '2001:db8:100::1/64' - -Example Result: - -.. code-block:: sh - - bridge br100 { - address 192.168.100.1/24 - address 2001:db8:100::1/64 - 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. - -.. 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` command: - -.. code-block:: sh - - set interfaces bridge br100 stp - -STP `priority`, `forwarding-delay`, `hello-time`, and `max-age` can be -configured for the bridge. The MAC aging time can also be configured -using the `aging` directive. - -The `show bridge` operational command can be used to display configured -bridges: - -.. code-block:: sh - - vyos@vyos:~$ show bridge - bridge name bridge id STP enabled interfaces - br100 0000.000c29443b19 yes eth1.100 - -If spanning-tree is enabled, the `show bridge <name> spanning-tree` command -can be used to show STP configuration: - -.. code-block:: sh - - vyos@vyos:~$ show bridge br100 spanning-tree - br100 - bridge id 0000.000c29443b19 - designated root 0000.000c29443b19 - root port 0 path cost 0 - max age 20.00 bridge max age 20.00 - hello time 2.00 bridge hello time 2.00 - forward delay 15.00 bridge forward delay 15.00 - ageing time 300.00 - hello timer 0.47 tcn timer 0.00 - topology change timer 0.00 gc timer 64.63 - flags - - eth1.100 (1) - port id 8001 state forwarding - designated root 0000.000c29443b19 path cost 4 - designated bridge 0000.000c29443b19 message age timer 0.00 - designated port 8001 forward delay timer 0.00 - designated cost 0 hold timer 0.00 - flags - -The MAC address-table for a bridge can be displayed using the -`show bridge <name> macs` command: - -.. code-block:: sh - - vyos@vyos:~$ show bridge br100 macs - port no mac addr is local? ageing timer - 1 00:0c:29:44:3b:19 yes 0.00 |