FD.io VPP  v18.10-32-g1161dda
Vector Packet Processing
l2.api
Go to the documentation of this file.
1 /* Hey Emacs use -*- mode: C -*- */
2 /*
3  * Copyright (c) 2016 Cisco and/or its affiliates.
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at:
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 option version = "2.0.1";
18 
19 /** \brief Reply to l2_xconnect_dump
20  @param context - sender context which was passed in the request
21  @param rx_sw_if_index - Receive interface index
22  @param tx_sw_if_index - Transmit interface index
23  */
24 define l2_xconnect_details
25 {
29 };
30 
31 /** \brief Dump L2 XConnects
32  @param client_index - opaque cookie to identify the sender
33  @param context - sender context, to match reply w/ request
34 */
35 define l2_xconnect_dump
36 {
39 };
40 
41 /** \brief l2 fib table details structure
42  @param bd_id - the l2 fib / bridge domain table id
43  @param mac - the entry's mac address
44  @param sw_if_index - index of the interface
45  @param static_mac - the entry is statically configured.
46  @param filter_mac - the entry is a mac filter entry.
47  @param bvi_mac - the mac address is a bridge virtual interface
48 */
49 define l2_fib_table_details
50 {
53  u8 mac[6];
58 };
59 
60 /** \brief Dump l2 fib (aka bridge domain) table
61  @param client_index - opaque cookie to identify the sender
62  @param bd_id - the l2 fib / bridge domain table identifier
63 */
64 define l2_fib_table_dump
65 {
69 };
70 
71 /** \brief L2 fib clear table request, clear all mac entries in the l2 fib
72  @param client_index - opaque cookie to identify the sender
73  @param context - sender context, to match reply w/ request
74 */
75 autoreply define l2_fib_clear_table
76 {
79 };
80 
81 /** \brief L2 FIB flush all entries
82  @param client_index - opaque cookie to identify the sender
83  @param context - sender context, to match reply w/ request
84 */
85 autoreply define l2fib_flush_all
86 {
89 };
90 
91 /** \brief L2 FIB flush bridge domain entries
92  @param client_index - opaque cookie to identify the sender
93  @param context - sender context, to match reply w/ request
94  @param bd_id - the entry's bridge domain id
95 */
96 autoreply define l2fib_flush_bd
97 {
101 };
102 
103 /** \brief L2 FIB flush interface entries
104  @param client_index - opaque cookie to identify the sender
105  @param context - sender context, to match reply w/ request
106  @param bd_id - the entry's bridge domain id
107 */
108 autoreply define l2fib_flush_int
109 {
113 };
114 
115 /** \brief L2 FIB add entry request
116  @param client_index - opaque cookie to identify the sender
117  @param context - sender context, to match reply w/ request
118  @param mac - the entry's mac address
119  @param bd_id - the entry's bridge domain id
120  @param sw_if_index - the interface
121  @param is_add - If non zero add the entry, else delete it
122  @param static_mac -
123  @param filter_mac -
124 */
125 autoreply define l2fib_add_del
126 {
129  u8 mac[6];
136 };
137 
138 /** \brief Register to receive L2 MAC events for learned and aged MAC
139  @param client_index - opaque cookie to identify the sender
140  @param context - sender context, to match reply w/ request
141  @param learn_limit - MAC learn limit, 0 => default to 1000
142  @param scan_delay - event scan delay in 10 msec unit, 0 => default to 100 msec
143  @param max_macs_in_event - in units of 10 mac entries, 0 => default to 100 entries
144  @param enable_disable - 1 => register for MAC events, 0 => cancel registration
145  @param pid - sender's pid
146 */
147 autoreply define want_l2_macs_events
148 {
156 };
157 
158 /** \brief Entry for learned or aged MAC in L2 MAC Events
159  @param sw_if_index - sw_if_index in the domain
160  @param mac_addr - mac_address
161  @param action - 0 => newly learned MAC, 1 => MAC deleted by ager
162  3 => MAC move (sw_if_index changed)
163  @param flags - flag bits to provide other info, not yet used
164 */
165 typeonly define mac_entry
166 {
168  u8 mac_addr[6];
171 };
172 
173 /** \brief L2 MAC event for a list of learned or aged MACs
174  @param client_index - opaque cookie to identify the sender
175  @param pid - client pid registered to receive notification
176  @param n_macs - number of learned/aged MAC entries
177  @param mac - array of learned/aged MAC entries
178 */
179 define l2_macs_event
180 {
185 };
186 
188  rpc want_l2_macs_events returns want_l2_macs_events_reply
189  events l2_macs_event;
190 };
191 
192 /** \brief Set interface L2 flags (such as L2_LEARN, L2_FWD,
193  L2_FLOOD, L2_UU_FLOOD, or L2_ARP_TERM bits). This can be used
194  to disable one or more of the features represented by the
195  flag bits on an interface to override what is set as default
196  for all interfaces in the bridge domain
197  @param client_index - opaque cookie to identify the sender
198  @param context - sender context, to match reply w/ request
199  @param sw_if_index - interface
200  @param is_set - if non-zero, set the bits, else clear them
201  @param feature_bitmap - non-zero bits (as above) to set or clear
202 */
203 define l2_flags
204 {
210 };
211 
212 /** \brief Set interface L2 flags response
213  @param context - sender context, to match reply w/ request
214  @param retval - return code for the set l2 bits request
215  @param resulting_feature_bitmap - the internal l2 feature bitmap after the request is implemented
216 */
217 define l2_flags_reply
218 {
222 };
223 
224 /** \brief L2 bridge domain set mac age
225  @param client_index - opaque cookie to identify the sender
226  @param context - sender context, to match reply w/ request
227  @param bd_id - the bridge domain to create
228  @param mac_age - mac aging time in min, 0 for disabled
229 */
230 autoreply define bridge_domain_set_mac_age
231 {
236 };
237 
238 /** \brief L2 bridge domain add or delete request
239  @param client_index - opaque cookie to identify the sender
240  @param context - sender context, to match reply w/ request
241  @param bd_id - the bridge domain to create
242  @param flood - enable/disable bcast/mcast flooding in the bd
243  @param uu_flood - enable/disable unknown unicast flood in the bd
244  @param forward - enable/disable forwarding on all interfaces in the bd
245  @param learn - enable/disable learning on all interfaces in the bd
246  @param arp_term - enable/disable arp termination in the bd
247  @param mac_age - mac aging time in min, 0 for disabled
248  @param is_add - add or delete flag
249 */
250 autoreply define bridge_domain_add_del
251 {
261  u8 bd_tag[64];
263 };
264 
265 /** \brief L2 bridge domain request operational state details
266  @param client_index - opaque cookie to identify the sender
267  @param context - sender context, to match reply w/ request
268  @param bd_id - the bridge domain id desired or ~0 to request all bds
269 */
270 define bridge_domain_dump
271 {
275 };
276 
277 /** \brief L2 bridge domain sw interface operational state response
278  @param bd_id - the bridge domain id
279  @param sw_if_index - sw_if_index in the domain
280  @param shg - split horizon group for the interface
281 */
282 typeonly manual_print manual_endian define bridge_domain_sw_if
283 {
287 };
288 
289 /** \brief L2 bridge domain operational state response
290  @param bd_id - the bridge domain id
291  @param flood - bcast/mcast flooding state on all interfaces in the bd
292  @param uu_flood - unknown unicast flooding state on all interfaces in the bd
293  @param forward - forwarding state on all interfaces in the bd
294  @param learn - learning state on all interfaces in the bd
295  @param arp_term - arp termination state on all interfaces in the bd
296  @param mac_age - mac aging time in min, 0 for disabled
297  @param bd_tag - optional textual tag for the bridge domain
298  @param n_sw_ifs - number of sw_if_index's in the domain
299 */
300 manual_print manual_endian define bridge_domain_details
301 {
310  u8 bd_tag[64];
314  vl_api_bridge_domain_sw_if_t sw_if_details[n_sw_ifs];
315 };
316 
317 /** \brief Flags that can be changed on a bridge domain */
319 {
325 };
326 
327 /** \brief Set bridge flags request
328  @param client_index - opaque cookie to identify the sender
329  @param context - sender context, to match reply w/ request
330  @param bd_id - the bridge domain to set the flags for
331  @param is_set - if non-zero, set the flags, else clear them
332  @param flags - flags that are non-zero to set or clear
333 */
334 define bridge_flags
335 {
340  vl_api_bd_flags_t flags;
341 };
342 
343 /** \brief Set bridge flags response
344  @param context - sender context, to match reply w/ request
345  @param retval - return code for the set bridge flags request
346  @param resulting_feature_bitmap - the internal L2 feature bitmap after the request is implemented
347 */
348 define bridge_flags_reply
349 {
353 };
354 
355 /** \brief L2 interface vlan tag rewrite configure request
356  @param client_index - opaque cookie to identify the sender
357  @param context - sender context, to match reply w/ request
358  @param sw_if_index - interface the operation is applied to
359  @param vtr_op - Choose from l2_vtr_op_t enum values
360  @param push_dot1q - first pushed flag dot1q id set, else dot1ad
361  @param tag1 - Needed for any push or translate vtr op
362  @param tag2 - Needed for any push 2 or translate x-2 vtr ops
363 */
364 autoreply define l2_interface_vlan_tag_rewrite
365 {
370  u32 push_dot1q; // ethertype of first pushed tag is dot1q/dot1ad
371  u32 tag1; // first pushed tag
372  u32 tag2; // second pushed tag
373 };
374 
375 /** \brief L2 interface pbb tag rewrite configure request
376  @param client_index - opaque cookie to identify the sender
377  @param context - sender context, to match reply w/ request
378  @param sw_if_index - interface the operation is applied to
379  @param vtr_op - Choose from l2_vtr_op_t enum values
380  @param inner_tag - needed for translate_qinq vtr op only
381  @param outer_tag - needed for translate_qinq vtr op only
382  @param b_dmac - B-tag remote mac address, needed for any push or translate_qinq vtr op
383  @param b_smac - B-tag local mac address, needed for any push or translate qinq vtr op
384  @param b_vlanid - B-tag vlanid, needed for any push or translate qinq vtr op
385  @param i_sid - I-tag service id, needed for any push or translate qinq vtr op
386 */
387 autoreply define l2_interface_pbb_tag_rewrite
388 {
394  u8 b_dmac[6];
395  u8 b_smac[6];
398 };
399 
400 /** \brief L2 interface patch add / del request
401  @param client_index - opaque cookie to identify the sender
402  @param context - sender context, to match reply w/ request
403  @param rx_sw_if_index - receive side interface
404  @param tx_sw_if_index - transmit side interface
405  @param is_add - if non-zero set up the interface patch, else remove it
406 */
407 autoreply define l2_patch_add_del
408 {
414 };
415 
416 /** \brief Set L2 XConnect between two interfaces request
417  @param client_index - opaque cookie to identify the sender
418  @param context - sender context, to match reply w/ request
419  @param rx_sw_if_index - Receive interface index
420  @param tx_sw_if_index - Transmit interface index
421  @param enable - enable xconnect if not 0, else set to L3 mode
422 */
423 autoreply define sw_interface_set_l2_xconnect
424 {
430 };
431 
432 /**
433  * @brief An enumeration of the type of ports that can be added
434  * to a bridge domain
435  */
437 {
438  /* a 'normal' interface, i.e. not BVI or UU-Flood */
440  /* a BVI interface in the BD */
442  /* The interface on which to forward unknown unicast packets
443  * If this is not set for a BD then UU is flooded */
445 };
446 
447 /** \brief Interface bridge mode request
448  @param client_index - opaque cookie to identify the sender
449  @param context - sender context, to match reply w/ request
450  @param rx_sw_if_index - the interface
451  @param bd_id - bridge domain id
452  @param port_type - port_mode, see #l2_port_type
453  @param shg - Split horizon group, for bridge mode only
454  @param enable - Enable beige mode if not 0, else set to L3 mode
455 */
456 
457 autoreply define sw_interface_set_l2_bridge
458 {
463  vl_api_l2_port_type_t port_type;
466 };
467 
468 /** \brief Set bridge domain ip to mac entry request
469  @param client_index - opaque cookie to identify the sender
470  @param context - sender context, to match reply w/ request
471  @param bd_id - the bridge domain to set the flags for
472  @param is_add - if non-zero, add the entry, else clear it
473  @param is_ipv6 - if non-zero, ipv6 address, else ipv4 address
474  @param mac_address - MAC address
475  @param
476 */
477 autoreply define bd_ip_mac_add_del
478 {
484  u8 ip_address[16];
486 };
487 
488 /** \brief bridge domain IP to MAC entry details structure
489  @param bd_id - bridge domain table id
490  @param is_ipv6 - if non-zero, ipv6 address, else ipv4 address
491  @param ip_address - ipv4 or ipv6 address
492  @param mac_address - MAC address
493 */
494 define bd_ip_mac_details
495 {
499  u8 ip_address[16];
501 };
502 
503 /** \brief Dump bridge domain IP to MAC entries
504  @param client_index - opaque cookie to identify the sender
505  @param bd_id - bridge domain identifier
506 */
507 define bd_ip_mac_dump
508 {
512 };
513 
514 /** \brief L2 interface ethernet flow point filtering enable/disable request
515  @param client_index - opaque cookie to identify the sender
516  @param context - sender context, to match reply w/ request
517  @param sw_if_index - interface to enable/disable filtering on
518  @param enable_disable - if non-zero enable filtering, else disable
519 */
520 autoreply define l2_interface_efp_filter
521 {
526 };
527 
528 /** \brief Interface set vpath request
529  @param client_index - opaque cookie to identify the sender
530  @param context - sender context, to match reply w/ request
531  @param sw_if_index - interface used to reach neighbor
532  @param enable - if non-zero enable, else disable
533 */
534 autoreply define sw_interface_set_vpath
535 {
540 };
541 
542 /*
543  * Local Variables:
544  * eval: (c-set-style "gnu")
545  * End:
546  */
vl_api_l2_port_type_t port_type
Definition: l2.api:463
l2_port_type
An enumeration of the type of ports that can be added to a bridge domain.
Definition: l2.api:436
unsigned char u8
Definition: types.h:56
u8 action
Definition: l2.api:169
Entry for learned or aged MAC in L2 MAC Events.
Definition: l2.api:165
option version
Definition: l2.api:17
L2 bridge domain sw interface operational state response.
Definition: l2.api:282
u32 feature_bitmap
Definition: l2.api:209
unsigned int u32
Definition: types.h:88
u32 sw_if_index
Definition: l2.api:167
u32 client_index
Definition: l2.api:205
unsigned short u16
Definition: types.h:57
typedef mac_address
signed int i32
Definition: types.h:77
u8 flags
Definition: l2.api:170
service
Definition: l2.api:187
u32 resulting_feature_bitmap
Definition: l2.api:221
vl_api_bd_flags_t flags
Definition: l2.api:340
u32 sw_if_index
Definition: l2.api:207
bd_flags
Flags that can be changed on a bridge domain.
Definition: l2.api:318
vl_api_mac_address_t mac
Definition: gbp.api:31