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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
|
module openconfig-vlan {
yang-version "1";
// namespace
namespace "http://openconfig.net/yang/vlan";
prefix "oc-vlan";
// import some basic types
import openconfig-vlan-types { prefix oc-vlan-types; }
import openconfig-interfaces { prefix oc-if; }
import openconfig-if-ethernet { prefix oc-eth; }
import openconfig-if-aggregate { prefix oc-lag; }
import iana-if-type { prefix ift; }
import openconfig-extensions { prefix oc-ext; }
// meta
organization "OpenConfig working group";
contact
"OpenConfig working group
netopenconfig@googlegroups.com";
description
"This module defines configuration and state variables for VLANs,
in addition to VLAN parameters associated with interfaces";
oc-ext:openconfig-version "3.0.1";
revision "2018-06-05" {
description
"Fix bugs in when statements.";
reference "3.0.1";
}
revision "2018-02-14" {
description
"Fix bug with name of 802.1ad identity.";
reference "3.0.0";
}
revision "2017-07-14" {
description
"Move top-level vlan data to network-instance; Update
identities to comply to style guide; fixed pattern
quoting; corrected trunk vlan types; added TPID config to
base interface.";
reference "2.0.0";
}
revision "2016-05-26" {
description
"OpenConfig public release";
reference "1.0.2";
}
// grouping statements
grouping vlan-config {
description "VLAN configuration container.";
leaf vlan-id {
type oc-vlan-types:vlan-id;
description "Interface VLAN id.";
}
leaf name {
type string;
description "Interface VLAN name.";
}
leaf status {
type enumeration {
enum ACTIVE {
description "VLAN is active";
}
enum SUSPENDED {
description "VLAN is inactive / suspended";
}
}
default ACTIVE;
description "Admin state of the VLAN";
}
}
grouping vlan-state {
description "State variables for VLANs";
// placeholder
}
grouping vlan-tpid-config {
description
"TPID configuration for dot1q-enabled interfaces";
leaf tpid {
type identityref {
base oc-vlan-types:TPID_TYPES;
}
default oc-vlan-types:TPID_0X8100;
description
"Optionally set the tag protocol identifier field (TPID) that
is accepted on the VLAN";
}
}
grouping vlan-tpid-state {
description
"TPID opstate for dot1q-enabled interfaces";
// placeholder
}
grouping vlan-members-state {
description
"List of interfaces / subinterfaces belonging to the VLAN.";
container members {
description
"Enclosing container for list of member interfaces";
list member {
config false;
description
"List of references to interfaces / subinterfaces
associated with the VLAN.";
uses oc-if:base-interface-ref-state;
}
}
}
grouping vlan-switched-config {
description
"VLAN related configuration that is part of the physical
Ethernet interface.";
leaf interface-mode {
type oc-vlan-types:vlan-mode-type;
description
"Set the interface to access or trunk mode for
VLANs";
}
leaf native-vlan {
when "../interface-mode = 'TRUNK'" {
description
"Native VLAN is valid for trunk mode interfaces";
}
type oc-vlan-types:vlan-id;
description
"Set the native VLAN id for untagged frames arriving on
a trunk interface. Tagged frames sent on an interface
configured with a native VLAN should have their tags
stripped prior to transmission. This configuration is only
valid on a trunk interface.";
}
leaf access-vlan {
when "../interface-mode = 'ACCESS'" {
description
"Access VLAN assigned to the interfaces";
}
type oc-vlan-types:vlan-id;
description
"Assign the access vlan to the access port.";
}
leaf-list trunk-vlans {
when "../interface-mode = 'TRUNK'" {
description
"Allowed VLANs may be specified for trunk mode
interfaces.";
}
type union {
type oc-vlan-types:vlan-id;
type oc-vlan-types:vlan-range;
}
description
"Specify VLANs, or ranges thereof, that the interface may
carry when in trunk mode. If not specified, all VLANs are
allowed on the interface. Ranges are specified in the form
x..y, where x<y - ranges are assumed to be inclusive (such
that the VLAN range is x <= range <= y.";
}
}
grouping vlan-switched-state {
description
"VLAN related operational state that is part of Ethernet
interface state data";
//TODO: placeholder for operational state related to VLANs
//on the physical interface
}
grouping vlan-switched-top {
description
"Top-level grouping for VLAN data associated with an
Ethernet interface";
container switched-vlan {
description
"Enclosing container for VLAN interface-specific
data on Ethernet interfaces. These are for standard
L2, switched-style VLANs.";
container config {
description "Configuration parameters for VLANs";
uses vlan-switched-config;
}
container state {
config false;
description "State variables for VLANs";
uses vlan-switched-config;
uses vlan-switched-state;
}
}
}
grouping vlan-logical-config {
description
"VLAN related configuration that is part of subinterface
(logical interface) configuration. These are generally
L3 VLANs with an id that is local.";
leaf vlan-id {
type union {
type oc-vlan-types:vlan-id;
type oc-vlan-types:qinq-id;
}
description
"VLAN id for the subinterface -- specified inline for the
case of a local VLAN. The id is scoped to the
subinterface, and could be repeated on different
subinterfaces.";
}
}
grouping vlan-logical-state {
description
"VLAN related operational state that is part of logical
interface state data";
//TODO: placeholder to add VLAN-specific state variables on
//the subinterface
}
grouping vlan-top {
description "Top-level grouping for VLAN configuration";
container vlans {
description "Container for VLAN configuration and state
variables";
list vlan {
key "vlan-id";
description "Configured VLANs keyed by id";
leaf vlan-id {
type leafref {
path "../config/vlan-id";
}
description "references the configured vlan-id";
}
container config {
description "Configuration parameters for VLANs";
uses vlan-config;
}
container state {
config false;
description "State variables for VLANs";
uses vlan-config;
uses vlan-state;
}
uses vlan-members-state;
}
}
}
grouping vlan-logical-top {
description
"Top-level grouping for VLAN data associated with a
logical interface or subinterface";
container vlan {
description
"Enclosing container for VLAN interface-specific
data on subinterfaces";
container config {
description "Configuration parameters for VLANs";
uses vlan-logical-config;
}
container state {
config false;
description "State variables for VLANs";
uses vlan-logical-config;
uses vlan-logical-state;
}
}
}
grouping vlan-routed-config {
description
"Configuration data for routed vlans (SVI, IRB, etc.)";
leaf vlan {
type union {
// TODO: in YANG 1.1, unions support leafref types which
// should be used here to reference a configured VLAN by
// id or name
type uint16;
type string;
}
description
"References the VLAN for which this IP interface
provides routing services -- similar to a switch virtual
interface (SVI), or integrated routing and bridging interface
(IRB) in some implementations.";
}
}
grouping vlan-routed-state {
description
"Operational state data for routed vlan interfaces.";
}
grouping vlan-routed-top {
description
"Top-level grouping for routed vlan logical interfaces";
container routed-vlan {
description
"Top-level container for routed vlan interfaces. These
logical interfaces are also known as SVI (switched virtual
interface), IRB (integrated routing and bridging), RVI
(routed VLAN interface)";
container config {
description
"Configuration data for routed vlan interfaces";
uses vlan-routed-config;
}
container state {
config false;
description
"Operational state data ";
uses vlan-routed-config;
uses vlan-routed-state;
}
}
}
// data definition statements
// augment statements
augment "/oc-if:interfaces/oc-if:interface/oc-if:subinterfaces/" +
"oc-if:subinterface" {
description
"Adds VLAN settings to individual subinterfaces";
uses vlan-logical-top;
}
augment "/oc-if:interfaces/oc-if:interface/oc-if:config" {
description
"Adds TPID / ethertype setting for the base interface";
uses vlan-tpid-config;
}
augment "/oc-if:interfaces/oc-if:interface/oc-if:state" {
description
"Adds TPID / ethertype opstate for the base interface";
uses vlan-tpid-config;
uses vlan-tpid-state;
}
augment "/oc-if:interfaces/oc-if:interface/oc-eth:ethernet" {
description
"Adds VLAN settings to individual Ethernet interfaces";
uses vlan-switched-top;
}
augment "/oc-if:interfaces/oc-if:interface/oc-lag:aggregation" {
description "Adds VLAN settings to a LAG interface";
uses vlan-switched-top;
}
augment "/oc-if:interfaces/oc-if:interface" {
description
"Adds configuration and state for routed VLAN interfaces";
uses vlan-routed-top {
when "current()/oc-if:config/oc-if:type = 'ift:l3ipvlan'" {
description
"Active when the interface is a logical interface providing
L3 routing for VLANs";
}
}
}
// rpc statements
// notification statements
}
|
