summaryrefslogtreecommitdiff
path: root/docs/configuration/interfaces/bridge.rst
diff options
context:
space:
mode:
authorRobert Göhler <github@ghlr.de>2021-01-11 19:35:50 +0100
committerGitHub <noreply@github.com>2021-01-11 19:35:50 +0100
commit3f2b73f244b57ef762d4866c256428d672bc2c0c (patch)
tree2671c520b77a1d357480d6e1471f748e419f2658 /docs/configuration/interfaces/bridge.rst
parentebb730fc96470e4c6972227cb4e56408fad7ce38 (diff)
parent9c6293817944b61ac33ae9df4b44978217f38e17 (diff)
downloadvyos-documentation-3f2b73f244b57ef762d4866c256428d672bc2c0c.tar.gz
vyos-documentation-3f2b73f244b57ef762d4866c256428d672bc2c0c.zip
Merge pull request #424 from jack9603301/master
bridge: Add active VLAN aware option
Diffstat (limited to 'docs/configuration/interfaces/bridge.rst')
-rw-r--r--docs/configuration/interfaces/bridge.rst30
1 files changed, 21 insertions, 9 deletions
diff --git a/docs/configuration/interfaces/bridge.rst b/docs/configuration/interfaces/bridge.rst
index 17e3d50b..c53d6f51 100644
--- a/docs/configuration/interfaces/bridge.rst
+++ b/docs/configuration/interfaces/bridge.rst
@@ -116,6 +116,16 @@ links providing fault tolerance if an active link fails.
VLAN
====
+.. note:: It is not valid to use the `vif 1` option for VLAN aware bridges
+ because VLAN aware bridges assume that all unlabeled packets belong to
+ the default VLAN 1 member and that the VLAN ID of the bridge's parent
+ interface is always 1
+
+.. cfgcmd:: set interfaces bridge <interface> enable-vlan
+
+ To activate the VLAN aware bridge, you must activate this setting to use VLAN
+ settings for the bridge
+
.. cmdinclude:: /_include/interface-vlan-8021q.txt
:var0: bridge
:var1: br0
@@ -160,9 +170,9 @@ Port Mirror (SPAN)
:var1: br1
:var2: eth3
-*******
-Example
-*******
+******************************
+Example: Create a basic bridge
+******************************
Creating a bridge interface is very simple. In this example we will
have:
@@ -195,9 +205,9 @@ This results in the active configuration:
}
stp
-*******
-Example
-*******
+*********************************
+Example: Using VLAN aware Bridge
+*********************************
An example of creating a VLAN-aware bridge is as follows:
@@ -209,6 +219,7 @@ An example of creating a VLAN-aware bridge is as follows:
.. code-block:: none
+ set interfaces bridge br100 enable-vlan
set interfaces bridge br100 member interface eth1 allowed-vlan 10
set interfaces bridge br100 member interface eth2 native-vlan 10
set interfaces bridge br100 vif 10 address 192.0.2.1/24
@@ -220,6 +231,7 @@ This results in the active configuration:
.. code-block:: none
vyos@vyos# show interfaces bridge br100
+ enable-vlan
member {
interface eth1 {
allowed-vlan 10
@@ -234,9 +246,9 @@ This results in the active configuration:
address 2001:db8::ffff/64
}
-*******
-Example
-*******
+********************************************************************
+Example: Using the operation mode command to view Bridge Information
+********************************************************************
.. opcmd:: show bridge