2 *------------------------------------------------------------------
3 * l2_api.c - layer 2 forwarding api
5 * Copyright (c) 2016 Cisco and/or its affiliates.
6 * Licensed under the Apache License, Version 2.0 (the "License");
7 * you may not use this file except in compliance with the License.
8 * You may obtain a copy of the License at:
10 * http://www.apache.org/licenses/LICENSE-2.0
12 * Unless required by applicable law or agreed to in writing, software
13 * distributed under the License is distributed on an "AS IS" BASIS,
14 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 * See the License for the specific language governing permissions and
16 * limitations under the License.
17 *------------------------------------------------------------------
20 #include <vnet/vnet.h>
21 #include <vlibmemory/api.h>
23 #include <vnet/interface.h>
24 #include <vnet/api_errno.h>
25 #include <vnet/l2/l2_input.h>
26 #include <vnet/l2/l2_fib.h>
27 #include <vnet/l2/l2_vtr.h>
28 #include <vnet/l2/l2_learn.h>
30 #include <vnet/vnet_msg_enum.h>
32 #define vl_typedefs /* define message structures */
33 #include <vnet/vnet_all_api_h.h>
36 #define vl_endianfun /* define message structures */
37 #include <vnet/vnet_all_api_h.h>
40 #define vl_api_bridge_domain_details_t_endian vl_noop_handler
41 #define vl_api_bridge_domain_details_t_print vl_noop_handler
43 /* instantiate all the print functions we know about */
44 #define vl_print(handle, ...) vlib_cli_output (handle, __VA_ARGS__)
46 #include <vnet/vnet_all_api_h.h>
49 #include <vlibapi/api_helper_macros.h>
51 #define foreach_vpe_api_msg \
52 _(L2_XCONNECT_DUMP, l2_xconnect_dump) \
53 _(L2_FIB_CLEAR_TABLE, l2_fib_clear_table) \
54 _(L2_FIB_TABLE_DUMP, l2_fib_table_dump) \
55 _(L2FIB_FLUSH_ALL, l2fib_flush_all) \
56 _(L2FIB_FLUSH_INT, l2fib_flush_int) \
57 _(L2FIB_FLUSH_BD, l2fib_flush_bd) \
58 _(L2FIB_ADD_DEL, l2fib_add_del) \
59 _(WANT_L2_MACS_EVENTS, want_l2_macs_events) \
60 _(L2_FLAGS, l2_flags) \
61 _(BRIDGE_DOMAIN_ADD_DEL, bridge_domain_add_del) \
62 _(BRIDGE_DOMAIN_DUMP, bridge_domain_dump) \
63 _(BRIDGE_FLAGS, bridge_flags) \
64 _(L2_INTERFACE_VLAN_TAG_REWRITE, l2_interface_vlan_tag_rewrite) \
65 _(L2_INTERFACE_PBB_TAG_REWRITE, l2_interface_pbb_tag_rewrite) \
66 _(BRIDGE_DOMAIN_SET_MAC_AGE, bridge_domain_set_mac_age)
69 send_l2_xconnect_details (unix_shared_memory_queue_t * q, u32 context,
70 u32 rx_sw_if_index, u32 tx_sw_if_index)
72 vl_api_l2_xconnect_details_t *mp;
74 mp = vl_msg_api_alloc (sizeof (*mp));
75 memset (mp, 0, sizeof (*mp));
76 mp->_vl_msg_id = ntohs (VL_API_L2_XCONNECT_DETAILS);
77 mp->context = context;
78 mp->rx_sw_if_index = htonl (rx_sw_if_index);
79 mp->tx_sw_if_index = htonl (tx_sw_if_index);
81 vl_msg_api_send_shmem (q, (u8 *) & mp);
85 vl_api_l2_xconnect_dump_t_handler (vl_api_l2_xconnect_dump_t * mp)
87 unix_shared_memory_queue_t *q;
88 vnet_main_t *vnm = vnet_get_main ();
89 vnet_interface_main_t *im = &vnm->interface_main;
90 l2input_main_t *l2im = &l2input_main;
91 vnet_sw_interface_t *swif;
92 l2_input_config_t *config;
94 q = vl_api_client_index_to_input_queue (mp->client_index);
99 pool_foreach (swif, im->sw_interfaces,
101 config = vec_elt_at_index (l2im->configs, swif->sw_if_index);
102 if (config->xconnect)
103 send_l2_xconnect_details (q, mp->context, swif->sw_if_index,
104 config->output_sw_if_index);
110 vl_api_l2_fib_clear_table_t_handler (vl_api_l2_fib_clear_table_t * mp)
113 vl_api_l2_fib_clear_table_reply_t *rmp;
115 /* Clear all MACs including static MACs */
116 l2fib_clear_table ();
118 REPLY_MACRO (VL_API_L2_FIB_CLEAR_TABLE_REPLY);
122 send_l2fib_table_entry (vpe_api_main_t * am,
123 unix_shared_memory_queue_t * q,
124 l2fib_entry_key_t * l2fe_key,
125 l2fib_entry_result_t * l2fe_res, u32 context)
127 vl_api_l2_fib_table_details_t *mp;
129 mp = vl_msg_api_alloc (sizeof (*mp));
130 memset (mp, 0, sizeof (*mp));
131 mp->_vl_msg_id = ntohs (VL_API_L2_FIB_TABLE_DETAILS);
134 ntohl (l2input_main.bd_configs[l2fe_key->fields.bd_index].bd_id);
136 mp->mac = l2fib_make_key (l2fe_key->fields.mac, 0);
137 mp->sw_if_index = ntohl (l2fe_res->fields.sw_if_index);
138 mp->static_mac = l2fe_res->fields.static_mac;
139 mp->filter_mac = l2fe_res->fields.filter;
140 mp->bvi_mac = l2fe_res->fields.bvi;
141 mp->context = context;
143 vl_msg_api_send_shmem (q, (u8 *) & mp);
147 vl_api_l2_fib_table_dump_t_handler (vl_api_l2_fib_table_dump_t * mp)
149 vpe_api_main_t *am = &vpe_api_main;
150 bd_main_t *bdm = &bd_main;
151 l2fib_entry_key_t *l2fe_key = NULL;
152 l2fib_entry_result_t *l2fe_res = NULL;
153 u32 ni, bd_id = ntohl (mp->bd_id);
155 unix_shared_memory_queue_t *q;
158 q = vl_api_client_index_to_input_queue (mp->client_index);
162 /* see l2fib_table_dump: ~0 means "any" */
167 p = hash_get (bdm->bd_index_by_bd_id, bd_id);
174 l2fib_table_dump (bd_index, &l2fe_key, &l2fe_res);
176 vec_foreach_index (ni, l2fe_key)
178 send_l2fib_table_entry (am, q, vec_elt_at_index (l2fe_key, ni),
179 vec_elt_at_index (l2fe_res, ni), mp->context);
186 vl_api_l2fib_add_del_t_handler (vl_api_l2fib_add_del_t * mp)
188 bd_main_t *bdm = &bd_main;
189 l2input_main_t *l2im = &l2input_main;
190 vl_api_l2fib_add_del_reply_t *rmp;
192 u32 bd_id = ntohl (mp->bd_id);
193 uword *p = hash_get (bdm->bd_index_by_bd_id, bd_id);
197 rv = VNET_API_ERROR_NO_SUCH_ENTRY;
198 goto bad_sw_if_index;
206 l2fib_add_filter_entry (mac, bd_index);
209 u32 sw_if_index = ntohl (mp->sw_if_index);
210 VALIDATE_SW_IF_INDEX (mp);
211 if (vec_len (l2im->configs) <= sw_if_index)
213 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX;
214 goto bad_sw_if_index;
218 l2_input_config_t *config;
219 config = vec_elt_at_index (l2im->configs, sw_if_index);
220 if (config->bridge == 0)
222 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX;
223 goto bad_sw_if_index;
226 u8 static_mac = mp->static_mac ? 1 : 0;
227 u8 bvi_mac = mp->bvi_mac ? 1 : 0;
228 l2fib_add_fwd_entry (mac, bd_index, sw_if_index, static_mac,
234 l2fib_del_entry (mac, bd_index);
237 BAD_SW_IF_INDEX_LABEL;
239 REPLY_MACRO (VL_API_L2FIB_ADD_DEL_REPLY);
243 vl_api_want_l2_macs_events_t_handler (vl_api_want_l2_macs_events_t * mp)
246 vl_api_want_l2_macs_events_reply_t *rmp;
247 l2learn_main_t *lm = &l2learn_main;
248 l2fib_main_t *fm = &l2fib_main;
249 u32 pid = ntohl (mp->pid);
250 u32 learn_limit = ntohl (mp->learn_limit);
252 if (mp->enable_disable)
254 if (lm->client_pid == 0)
256 lm->client_pid = pid;
257 lm->client_index = mp->client_index;
259 if (mp->max_macs_in_event)
260 fm->max_macs_in_event = mp->max_macs_in_event * 10;
262 fm->max_macs_in_event = L2FIB_EVENT_MAX_MACS_DEFAULT;
265 fm->event_scan_delay = (f64) (mp->scan_delay) * 10e-3;
267 fm->event_scan_delay = L2FIB_EVENT_SCAN_DELAY_DEFAULT;
269 /* change learn limit and flush all learned MACs */
270 if (learn_limit && (learn_limit < L2LEARN_DEFAULT_LIMIT))
271 lm->global_learn_limit = learn_limit;
273 lm->global_learn_limit = L2FIB_EVENT_LEARN_LIMIT_DEFAULT;
275 l2fib_flush_all_mac (vlib_get_main ());
277 else if (lm->client_pid != pid)
279 rv = VNET_API_ERROR_L2_MACS_EVENT_CLINET_PRESENT;
283 else if (lm->client_pid)
286 lm->client_index = 0;
288 lm->global_learn_limit = learn_limit;
290 lm->global_learn_limit = L2LEARN_DEFAULT_LIMIT;
294 REPLY_MACRO (VL_API_WANT_L2_MACS_EVENTS_REPLY);
298 vl_api_l2fib_flush_int_t_handler (vl_api_l2fib_flush_int_t * mp)
301 vlib_main_t *vm = vlib_get_main ();
302 vl_api_l2fib_flush_int_reply_t *rmp;
304 VALIDATE_SW_IF_INDEX (mp);
306 u32 sw_if_index = ntohl (mp->sw_if_index);
307 l2fib_flush_int_mac (vm, sw_if_index);
309 BAD_SW_IF_INDEX_LABEL;
310 REPLY_MACRO (VL_API_L2FIB_FLUSH_INT_REPLY);
314 vl_api_l2fib_flush_all_t_handler (vl_api_l2fib_flush_all_t * mp)
317 vl_api_l2fib_flush_all_reply_t *rmp;
319 l2fib_flush_all_mac (vlib_get_main ());
320 REPLY_MACRO (VL_API_L2FIB_FLUSH_ALL_REPLY);
324 vl_api_l2fib_flush_bd_t_handler (vl_api_l2fib_flush_bd_t * mp)
327 vlib_main_t *vm = vlib_get_main ();
328 bd_main_t *bdm = &bd_main;
329 vl_api_l2fib_flush_bd_reply_t *rmp;
331 u32 bd_id = ntohl (mp->bd_id);
332 uword *p = hash_get (bdm->bd_index_by_bd_id, bd_id);
335 rv = VNET_API_ERROR_NO_SUCH_ENTRY;
338 l2fib_flush_bd_mac (vm, *p);
340 REPLY_MACRO (VL_API_L2FIB_FLUSH_BD_REPLY);
344 vl_api_l2_flags_t_handler (vl_api_l2_flags_t * mp)
346 vl_api_l2_flags_reply_t *rmp;
350 VALIDATE_SW_IF_INDEX (mp);
352 u32 sw_if_index = ntohl (mp->sw_if_index);
353 u32 flags = ntohl (mp->feature_bitmap);
356 if (flags & L2_LEARN)
357 bitmap |= L2INPUT_FEAT_LEARN;
360 bitmap |= L2INPUT_FEAT_FWD;
362 if (flags & L2_FLOOD)
363 bitmap |= L2INPUT_FEAT_FLOOD;
365 if (flags & L2_UU_FLOOD)
366 bitmap |= L2INPUT_FEAT_UU_FLOOD;
368 if (flags & L2_ARP_TERM)
369 bitmap |= L2INPUT_FEAT_ARP_TERM;
371 rbm = l2input_intf_bitmap_enable (sw_if_index, bitmap, mp->is_set);
373 BAD_SW_IF_INDEX_LABEL;
376 REPLY_MACRO2(VL_API_L2_FLAGS_REPLY,
378 rmp->resulting_feature_bitmap = ntohl(rbm);
384 vl_api_bridge_domain_set_mac_age_t_handler (vl_api_bridge_domain_set_mac_age_t
387 vlib_main_t *vm = vlib_get_main ();
388 bd_main_t *bdm = &bd_main;
389 vl_api_bridge_domain_set_mac_age_reply_t *rmp;
391 u32 bd_id = ntohl (mp->bd_id);
396 rv = VNET_API_ERROR_BD_NOT_MODIFIABLE;
400 p = hash_get (bdm->bd_index_by_bd_id, bd_id);
403 rv = VNET_API_ERROR_NO_SUCH_ENTRY;
406 bd_set_mac_age (vm, *p, mp->mac_age);
408 REPLY_MACRO (VL_API_BRIDGE_DOMAIN_SET_MAC_AGE_REPLY);
412 vl_api_bridge_domain_add_del_t_handler (vl_api_bridge_domain_add_del_t * mp)
414 l2_bridge_domain_add_del_args_t a = {
415 .is_add = mp->is_add,
417 .uu_flood = mp->uu_flood,
418 .forward = mp->forward,
420 .arp_term = mp->arp_term,
421 .mac_age = mp->mac_age,
422 .bd_id = ntohl (mp->bd_id),
425 int rv = bd_add_del (&a);
427 vl_api_bridge_domain_add_del_reply_t *rmp;
428 REPLY_MACRO (VL_API_BRIDGE_DOMAIN_ADD_DEL_REPLY);
432 send_bridge_domain_details (l2input_main_t * l2im,
433 unix_shared_memory_queue_t * q,
434 l2_bridge_domain_t * bd_config,
435 u32 n_sw_ifs, u32 context)
437 vl_api_bridge_domain_details_t *mp;
438 l2_flood_member_t *m;
439 vl_api_bridge_domain_sw_if_t *sw_ifs;
440 l2_input_config_t *input_cfg;
442 mp = vl_msg_api_alloc (sizeof (*mp) +
443 (n_sw_ifs * sizeof (vl_api_bridge_domain_sw_if_t)));
444 memset (mp, 0, sizeof (*mp));
445 mp->_vl_msg_id = ntohs (VL_API_BRIDGE_DOMAIN_DETAILS);
446 mp->bd_id = ntohl (bd_config->bd_id);
447 mp->flood = bd_feature_flood (bd_config);
448 mp->uu_flood = bd_feature_uu_flood (bd_config);
449 mp->forward = bd_feature_forward (bd_config);
450 mp->learn = bd_feature_learn (bd_config);
451 mp->arp_term = bd_feature_arp_term (bd_config);
452 mp->bvi_sw_if_index = ntohl (bd_config->bvi_sw_if_index);
453 mp->mac_age = bd_config->mac_age;
454 mp->context = context;
456 sw_ifs = (vl_api_bridge_domain_sw_if_t *) mp->sw_if_details;
457 vec_foreach (m, bd_config->members)
459 sw_ifs->sw_if_index = ntohl (m->sw_if_index);
460 input_cfg = vec_elt_at_index (l2im->configs, m->sw_if_index);
461 sw_ifs->shg = input_cfg->shg;
465 mp->n_sw_ifs = htonl (mp->n_sw_ifs);
467 vl_msg_api_send_shmem (q, (u8 *) & mp);
471 vl_api_bridge_domain_dump_t_handler (vl_api_bridge_domain_dump_t * mp)
473 bd_main_t *bdm = &bd_main;
474 l2input_main_t *l2im = &l2input_main;
476 unix_shared_memory_queue_t *q =
477 vl_api_client_index_to_input_queue (mp->client_index);
481 u32 bd_id = ntohl (mp->bd_id);
487 bd_index = 0, end = vec_len (l2im->bd_configs);
490 bd_index = bd_find_index (bdm, bd_id);
497 for (; bd_index < end; bd_index++)
499 l2_bridge_domain_t *bd_config =
500 l2input_bd_config_from_index (l2im, bd_index);
501 /* skip dummy bd_id 0 */
502 if (bd_config && (bd_config->bd_id > 0))
503 send_bridge_domain_details (l2im, q, bd_config,
504 vec_len (bd_config->members),
510 vl_api_bridge_flags_t_handler (vl_api_bridge_flags_t * mp)
512 vlib_main_t *vm = vlib_get_main ();
513 bd_main_t *bdm = &bd_main;
514 vl_api_bridge_flags_reply_t *rmp;
517 u32 flags = ntohl (mp->feature_bitmap);
518 u32 bd_id = ntohl (mp->bd_id);
521 rv = VNET_API_ERROR_BD_NOT_MODIFIABLE;
525 u32 bd_index = bd_find_index (bdm, bd_id);
528 rv = VNET_API_ERROR_NO_SUCH_ENTRY;
532 u32 bitmap = bd_set_flags (vm, bd_index, flags, mp->is_set);
536 REPLY_MACRO2(VL_API_BRIDGE_FLAGS_REPLY,
538 rmp->resulting_feature_bitmap = ntohl(bitmap);
544 vl_api_l2_interface_vlan_tag_rewrite_t_handler
545 (vl_api_l2_interface_vlan_tag_rewrite_t * mp)
548 vl_api_l2_interface_vlan_tag_rewrite_reply_t *rmp;
549 vnet_main_t *vnm = vnet_get_main ();
550 vlib_main_t *vm = vlib_get_main ();
553 VALIDATE_SW_IF_INDEX (mp);
555 vtr_op = ntohl (mp->vtr_op);
557 /* The L2 code is unsuspicious */
560 case L2_VTR_DISABLED:
565 case L2_VTR_TRANSLATE_1_1:
566 case L2_VTR_TRANSLATE_1_2:
567 case L2_VTR_TRANSLATE_2_1:
568 case L2_VTR_TRANSLATE_2_2:
572 rv = VNET_API_ERROR_INVALID_VALUE;
573 goto bad_sw_if_index;
576 rv = l2vtr_configure (vm, vnm, ntohl (mp->sw_if_index), vtr_op,
577 ntohl (mp->push_dot1q), ntohl (mp->tag1),
580 BAD_SW_IF_INDEX_LABEL;
582 REPLY_MACRO (VL_API_L2_INTERFACE_VLAN_TAG_REWRITE_REPLY);
586 vl_api_l2_interface_pbb_tag_rewrite_t_handler
587 (vl_api_l2_interface_pbb_tag_rewrite_t * mp)
589 vl_api_l2_interface_pbb_tag_rewrite_reply_t *rmp;
590 vnet_main_t *vnm = vnet_get_main ();
591 vlib_main_t *vm = vlib_get_main ();
595 VALIDATE_SW_IF_INDEX (mp);
597 vtr_op = ntohl (mp->vtr_op);
601 case L2_VTR_DISABLED:
604 case L2_VTR_TRANSLATE_2_1:
608 rv = VNET_API_ERROR_INVALID_VALUE;
609 goto bad_sw_if_index;
612 rv = l2pbb_configure (vm, vnm, ntohl (mp->sw_if_index), vtr_op,
613 mp->b_dmac, mp->b_smac, ntohs (mp->b_vlanid),
614 ntohl (mp->i_sid), ntohs (mp->outer_tag));
616 BAD_SW_IF_INDEX_LABEL;
618 REPLY_MACRO (VL_API_L2_INTERFACE_PBB_TAG_REWRITE_REPLY);
623 * Add vpe's API message handlers to the table.
624 * vlib has alread mapped shared memory and
625 * added the client registration handlers.
626 * See .../vlib-api/vlibmemory/memclnt_vlib.c:memclnt_process()
628 #define vl_msg_name_crc_list
629 #include <vnet/vnet_all_api_h.h>
630 #undef vl_msg_name_crc_list
633 setup_message_id_table (api_main_t * am)
635 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id);
636 foreach_vl_msg_name_crc_l2;
640 static clib_error_t *
641 l2_api_hookup (vlib_main_t * vm)
643 api_main_t *am = &api_main;
646 vl_msg_api_set_handlers(VL_API_##N, #n, \
647 vl_api_##n##_t_handler, \
649 vl_api_##n##_t_endian, \
650 vl_api_##n##_t_print, \
651 sizeof(vl_api_##n##_t), 1);
656 * Set up the (msg_name, crc, message-id) table
658 setup_message_id_table (am);
663 VLIB_API_INIT_FUNCTION (l2_api_hookup);
666 * fd.io coding-style-patch-verification: ON
669 * eval: (c-set-style "gnu")