summaryrefslogtreecommitdiff
path: root/docs/_include/interface-vlan-8021q.txt
blob: 1a7a665ffc7b23460b7ac04c3da2c582065a05e8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
IEEE 802.1q_, often referred to as Dot1q, is the industry standard for 
implementing VLANs on Ethernet networks. It defines VLAN tagging for 
Ethernet frames and outlines procedures for bridges and switches. The 
standard also includes quality-of-service prioritization (IEEE 802.1p) 
and defines the Generic Attribute Registration Protocol.

VLAN-aware network segments  (i.e., IEEE 802.1q_ conformant) use VLAN tags. 
When a frame enters such a segment, a tag is added to indicate VLAN membership. 
Each frame can belong to only one VLAN. If a frame arrives without a tag, it 
is assumed to be part of the native VLAN.

IEEE 802.1, a working group of the IEEE 802 standards committee, has developed 
the standard and continues to revise it. One notable revision is 802.1Q-2014, 
which incorporated IEEE 802.1aq (Shortest Path Bridging) and much of the IEEE 
802.1d standard. 

In VyOS, 802.1q VLAN interfaces are represented as virtual subinterfaces, 
referred to as  ``vif``.

.. cfgcmd:: set interfaces {{ var0 }} <interface> vif <vlan-id>

  **Configure a VLAN interface with a unique VLAN ID.** 

  VLAN ID identifies a specific VLAN and ranges from 0 to 4094. 

  You can configure multiple VLAN interfaces on a single physical interface.

  .. note:: Only 802.1Q-tagged packets are accepted on Ethernet vifs.

.. cmdinclude:: /_include/interface-address-with-dhcp.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-description.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-disable.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-disable-link-detect.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-mac.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-mtu.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-ip.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-ipv6.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-vrf.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

**DHCP(v6)**

.. cmdinclude:: /_include/interface-dhcp-options.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-dhcpv6-options.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. cmdinclude:: /_include/interface-dhcpv6-prefix-delegation.txt
   :var0: {{ var0 }}
   :var1: {{ var1 }}
   :var2: vif
   :var3: <vlan-id>
   :var4: 10

.. include:: /_include/common-references.txt