2 *------------------------------------------------------------------
3 * interface_api.c - vnet interface 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/ethernet/ethernet.h>
26 #include <vnet/ip/ip.h>
27 #include <vnet/fib/fib_table.h>
28 #include <vnet/mfib/mfib_table.h>
29 #include <vnet/l2/l2_vtr.h>
30 #include <vnet/vnet_msg_enum.h>
31 #include <vnet/fib/fib_api.h>
32 #include <vnet/mfib/mfib_table.h>
34 #include <vlibapi/api_types.h>
36 #include <vnet/ip/ip_types_api.h>
37 #include <vnet/ethernet/ethernet_types_api.h>
39 #define vl_typedefs /* define message structures */
40 #include <vnet/vnet_all_api_h.h>
43 #define vl_endianfun /* define message structures */
44 #include <vnet/vnet_all_api_h.h>
47 /* instantiate all the print functions we know about */
48 #define vl_print(handle, ...) vlib_cli_output (handle, __VA_ARGS__)
50 #include <vnet/vnet_all_api_h.h>
53 #include <vlibapi/api_helper_macros.h>
54 vpe_api_main_t vpe_api_main;
56 #define foreach_vpe_api_msg \
57 _(SW_INTERFACE_SET_FLAGS, sw_interface_set_flags) \
58 _(HW_INTERFACE_SET_MTU, hw_interface_set_mtu) \
59 _(SW_INTERFACE_SET_MTU, sw_interface_set_mtu) \
60 _(WANT_INTERFACE_EVENTS, want_interface_events) \
61 _(SW_INTERFACE_DUMP, sw_interface_dump) \
62 _(SW_INTERFACE_ADD_DEL_ADDRESS, sw_interface_add_del_address) \
63 _(SW_INTERFACE_SET_RX_MODE, sw_interface_set_rx_mode) \
64 _(SW_INTERFACE_RX_PLACEMENT_DUMP, sw_interface_rx_placement_dump) \
65 _(SW_INTERFACE_SET_RX_PLACEMENT, sw_interface_set_rx_placement) \
66 _(SW_INTERFACE_SET_TABLE, sw_interface_set_table) \
67 _(SW_INTERFACE_GET_TABLE, sw_interface_get_table) \
68 _(SW_INTERFACE_SET_UNNUMBERED, sw_interface_set_unnumbered) \
69 _(SW_INTERFACE_CLEAR_STATS, sw_interface_clear_stats) \
70 _(SW_INTERFACE_TAG_ADD_DEL, sw_interface_tag_add_del) \
71 _(SW_INTERFACE_SET_MAC_ADDRESS, sw_interface_set_mac_address) \
72 _(SW_INTERFACE_GET_MAC_ADDRESS, sw_interface_get_mac_address) \
73 _(CREATE_VLAN_SUBIF, create_vlan_subif) \
74 _(CREATE_SUBIF, create_subif) \
75 _(DELETE_SUBIF, delete_subif) \
76 _(CREATE_LOOPBACK, create_loopback) \
77 _(CREATE_LOOPBACK_INSTANCE, create_loopback_instance) \
78 _(DELETE_LOOPBACK, delete_loopback) \
79 _(INTERFACE_NAME_RENUMBER, interface_name_renumber) \
80 _(COLLECT_DETAILED_INTERFACE_STATS, collect_detailed_interface_stats) \
81 _(SW_INTERFACE_SET_IP_DIRECTED_BROADCAST, \
82 sw_interface_set_ip_directed_broadcast)
85 vl_api_sw_interface_set_flags_t_handler (vl_api_sw_interface_set_flags_t * mp)
87 vl_api_sw_interface_set_flags_reply_t *rmp;
88 vnet_main_t *vnm = vnet_get_main ();
93 VALIDATE_SW_IF_INDEX (mp);
96 ((ntohl (mp->flags)) & IF_STATUS_API_FLAG_ADMIN_UP) ?
97 VNET_SW_INTERFACE_FLAG_ADMIN_UP : 0;
99 error = vnet_sw_interface_set_flags (vnm, ntohl (mp->sw_if_index), flags);
103 clib_error_report (error);
106 BAD_SW_IF_INDEX_LABEL;
107 REPLY_MACRO (VL_API_SW_INTERFACE_SET_FLAGS_REPLY);
111 vl_api_hw_interface_set_mtu_t_handler (vl_api_hw_interface_set_mtu_t * mp)
113 vl_api_hw_interface_set_mtu_reply_t *rmp;
114 vnet_main_t *vnm = vnet_get_main ();
115 u32 sw_if_index = ntohl (mp->sw_if_index);
116 u16 mtu = ntohs (mp->mtu);
117 ethernet_main_t *em = ðernet_main;
120 VALIDATE_SW_IF_INDEX (mp);
122 vnet_sw_interface_t *si = vnet_get_sw_interface (vnm, sw_if_index);
123 if (si->type != VNET_SW_INTERFACE_TYPE_HARDWARE)
125 rv = VNET_API_ERROR_INVALID_VALUE;
126 goto bad_sw_if_index;
129 vnet_hw_interface_t *hi = vnet_get_hw_interface (vnm, si->hw_if_index);
130 ethernet_interface_t *eif = ethernet_get_interface (em, si->hw_if_index);
134 rv = VNET_API_ERROR_FEATURE_DISABLED;
135 goto bad_sw_if_index;
138 if (mtu < hi->min_supported_packet_bytes)
140 rv = VNET_API_ERROR_INVALID_VALUE;
141 goto bad_sw_if_index;
144 if (mtu > hi->max_supported_packet_bytes)
146 rv = VNET_API_ERROR_INVALID_VALUE;
147 goto bad_sw_if_index;
150 vnet_hw_interface_set_mtu (vnm, si->hw_if_index, mtu);
152 BAD_SW_IF_INDEX_LABEL;
153 REPLY_MACRO (VL_API_HW_INTERFACE_SET_MTU_REPLY);
157 vl_api_sw_interface_set_mtu_t_handler (vl_api_sw_interface_set_mtu_t * mp)
159 vl_api_sw_interface_set_mtu_reply_t *rmp;
160 vnet_main_t *vnm = vnet_get_main ();
161 u32 sw_if_index = ntohl (mp->sw_if_index);
164 u32 per_protocol_mtu[VNET_N_MTU];
166 VALIDATE_SW_IF_INDEX (mp);
168 for (i = 0; i < VNET_N_MTU; i++)
169 per_protocol_mtu[i] = ntohl (mp->mtu[i]);
171 vnet_sw_interface_set_protocol_mtu (vnm, sw_if_index, per_protocol_mtu);
173 BAD_SW_IF_INDEX_LABEL;
174 REPLY_MACRO (VL_API_SW_INTERFACE_SET_MTU_REPLY);
178 vl_api_sw_interface_set_ip_directed_broadcast_t_handler
179 (vl_api_sw_interface_set_ip_directed_broadcast_t * mp)
181 vl_api_sw_interface_set_ip_directed_broadcast_reply_t *rmp;
182 u32 sw_if_index = ntohl (mp->sw_if_index);
185 VALIDATE_SW_IF_INDEX (mp);
187 vnet_sw_interface_ip_directed_broadcast (vnet_get_main (),
188 sw_if_index, mp->enable);
190 BAD_SW_IF_INDEX_LABEL;
191 REPLY_MACRO (VL_API_SW_INTERFACE_SET_IP_DIRECTED_BROADCAST_REPLY);
195 send_sw_interface_details (vpe_api_main_t * am,
196 vl_api_registration_t * rp,
197 vnet_sw_interface_t * swif,
198 u8 * interface_name, u32 context)
200 vnet_hw_interface_t *hi =
201 vnet_get_sup_hw_interface (am->vnet_main, swif->sw_if_index);
203 uint32_t if_name_len = strlen ((char *) interface_name);
204 u8 *tag = vnet_get_sw_interface_tag (vnet_get_main (), swif->sw_if_index);
205 uint32_t tag_len = 0;
207 tag_len = strlen ((char *) tag);
208 vl_api_sw_interface_details_t *mp =
209 vl_msg_api_alloc (sizeof (*mp) + if_name_len + tag_len);
210 clib_memset (mp, 0, sizeof (*mp) + if_name_len + tag_len);
211 mp->_vl_msg_id = ntohs (VL_API_SW_INTERFACE_DETAILS);
212 mp->sw_if_index = ntohl (swif->sw_if_index);
213 mp->sup_sw_if_index = ntohl (swif->sup_sw_if_index);
215 mp->flags |= (swif->flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) ?
216 IF_STATUS_API_FLAG_ADMIN_UP : 0;
217 mp->flags |= (hi->flags & VNET_HW_INTERFACE_FLAG_LINK_UP) ?
218 IF_STATUS_API_FLAG_LINK_UP : 0;
219 mp->flags = ntohl (mp->flags);
223 case VNET_SW_INTERFACE_TYPE_SUB:
224 mp->type = IF_API_TYPE_SUB;
226 case VNET_SW_INTERFACE_TYPE_P2P:
227 mp->type = IF_API_TYPE_P2P;
229 case VNET_SW_INTERFACE_TYPE_PIPE:
230 mp->type = IF_API_TYPE_PIPE;
233 mp->type = IF_API_TYPE_HARDWARE;
235 mp->type = ntohl (mp->type);
237 mp->link_duplex = ((hi->flags & VNET_HW_INTERFACE_FLAG_DUPLEX_MASK) >>
238 VNET_HW_INTERFACE_FLAG_DUPLEX_SHIFT);
239 mp->link_speed = ntohl (hi->link_speed);
240 mp->link_mtu = ntohs (hi->max_packet_bytes);
241 mp->mtu[VNET_MTU_L3] = ntohl (swif->mtu[VNET_MTU_L3]);
242 mp->mtu[VNET_MTU_IP4] = ntohl (swif->mtu[VNET_MTU_IP4]);
243 mp->mtu[VNET_MTU_IP6] = ntohl (swif->mtu[VNET_MTU_IP6]);
244 mp->mtu[VNET_MTU_MPLS] = ntohl (swif->mtu[VNET_MTU_MPLS]);
246 mp->context = context;
248 /* Send the L2 address for ethernet physical intfcs */
249 if (swif->sup_sw_if_index == swif->sw_if_index
250 && hi->hw_class_index == ethernet_hw_interface_class.index)
252 ethernet_main_t *em = ethernet_get_main (am->vlib_main);
253 ethernet_interface_t *ei;
255 ei = pool_elt_at_index (em->interfaces, hi->hw_instance);
256 ASSERT (sizeof (mp->l2_address) >= sizeof (ei->address));
257 mac_address_encode ((mac_address_t *) ei->address, mp->l2_address);
259 else if (swif->sup_sw_if_index != swif->sw_if_index)
261 vnet_sub_interface_t *sub = &swif->sub;
262 mp->sub_id = ntohl (sub->id);
263 mp->sub_number_of_tags =
264 sub->eth.flags.one_tag + sub->eth.flags.two_tags * 2;
265 mp->sub_outer_vlan_id = ntohs (sub->eth.outer_vlan_id);
266 mp->sub_inner_vlan_id = ntohs (sub->eth.inner_vlan_id);
268 ntohl (sub->eth.raw_flags & SUB_IF_API_FLAG_MASK_VNET);
270 /* vlan tag rewrite data */
271 u32 vtr_op = L2_VTR_DISABLED;
272 u32 vtr_push_dot1q = 0, vtr_tag1 = 0, vtr_tag2 = 0;
274 if (l2vtr_get (am->vlib_main, am->vnet_main, swif->sw_if_index,
275 &vtr_op, &vtr_push_dot1q, &vtr_tag1, &vtr_tag2) != 0)
277 // error - default to disabled
278 mp->vtr_op = ntohl (L2_VTR_DISABLED);
279 clib_warning ("cannot get vlan tag rewrite for sw_if_index %d",
284 mp->vtr_op = ntohl (vtr_op);
285 mp->vtr_push_dot1q = ntohl (vtr_push_dot1q);
286 mp->vtr_tag1 = ntohl (vtr_tag1);
287 mp->vtr_tag2 = ntohl (vtr_tag2);
291 /* pbb tag rewrite data */
292 ethernet_header_t eth_hdr;
293 u32 pbb_vtr_op = L2_VTR_DISABLED;
297 clib_memset (ð_hdr, 0, sizeof (eth_hdr));
299 if (!l2pbb_get (am->vlib_main, am->vnet_main, swif->sw_if_index,
300 &pbb_vtr_op, &outer_tag, ð_hdr, &b_vlanid, &i_sid))
302 mp->sub_if_flags |= ntohl (SUB_IF_API_FLAG_DOT1AH);
303 mac_address_encode ((mac_address_t *) eth_hdr.dst_address, mp->b_dmac);
304 mac_address_encode ((mac_address_t *) eth_hdr.src_address, mp->b_smac);
305 mp->b_vlanid = b_vlanid;
309 char *p = (char *) &mp->interface_name;
311 vl_api_to_api_string (if_name_len, (char *) interface_name,
312 (vl_api_string_t *) p);
314 vl_api_to_api_string (tag_len, (char *) tag, (vl_api_string_t *) p);
316 vl_api_send_msg (rp, (u8 *) mp);
320 vl_api_sw_interface_dump_t_handler (vl_api_sw_interface_dump_t * mp)
322 vpe_api_main_t *am = &vpe_api_main;
323 vnet_sw_interface_t *swif;
324 vnet_interface_main_t *im = &am->vnet_main->interface_main;
325 vl_api_registration_t *rp;
328 rp = vl_api_client_index_to_registration (mp->client_index);
332 clib_warning ("Client %d AWOL", mp->client_index);
336 u8 *filter = 0, *name = 0;
337 sw_if_index = ntohl (mp->sw_if_index);
339 if (!mp->name_filter_valid && sw_if_index != ~0 && sw_if_index != 0)
341 /* is it a valid sw_if_index? */
342 if (!vnet_sw_if_index_is_api_valid (sw_if_index))
345 swif = vec_elt_at_index (im->sw_interfaces, sw_if_index);
347 vec_reset_length (name);
349 format (name, "%U%c", format_vnet_sw_interface_name, am->vnet_main,
351 send_sw_interface_details (am, rp, swif, name, mp->context);
356 if (mp->name_filter_valid)
359 format (0, "%s%c", vl_api_from_api_string (&mp->name_filter), 0);
362 char *strcasestr (char *, char *); /* lnx hdr file botch */
364 pool_foreach (swif, im->sw_interfaces,
366 if (!vnet_swif_is_api_visible (swif))
368 vec_reset_length(name);
369 name = format (name, "%U%c", format_vnet_sw_interface_name, am->vnet_main,
372 if (filter && !strcasestr((char *) name, (char *) filter))
375 send_sw_interface_details (am, rp, swif, name, mp->context);
384 vl_api_sw_interface_add_del_address_t_handler
385 (vl_api_sw_interface_add_del_address_t * mp)
387 vlib_main_t *vm = vlib_get_main ();
388 vnet_main_t *vnm = vnet_get_main ();
389 vl_api_sw_interface_add_del_address_reply_t *rmp;
392 clib_error_t *error = 0;
393 ip46_address_t address;
395 VALIDATE_SW_IF_INDEX (mp);
397 is_del = mp->is_add == 0;
401 ip_del_all_interface_addresses (vm, ntohl (mp->sw_if_index));
402 else if (ip_address_decode (&mp->prefix.address, &address) == IP46_TYPE_IP6)
403 error = ip6_add_del_interface_address (vm, ntohl (mp->sw_if_index),
404 (void *) &address.ip6,
405 mp->prefix.len, is_del);
407 error = ip4_add_del_interface_address (vm, ntohl (mp->sw_if_index),
408 (void *) &address.ip4,
409 mp->prefix.len, is_del);
414 clib_error_report (error);
418 BAD_SW_IF_INDEX_LABEL;
421 REPLY_MACRO (VL_API_SW_INTERFACE_ADD_DEL_ADDRESS_REPLY);
425 vl_api_sw_interface_set_table_t_handler (vl_api_sw_interface_set_table_t * mp)
427 vl_api_sw_interface_set_table_reply_t *rmp;
428 u32 sw_if_index = ntohl (mp->sw_if_index);
429 u32 table_id = ntohl (mp->vrf_id);
432 VALIDATE_SW_IF_INDEX (mp);
435 rv = ip_table_bind (FIB_PROTOCOL_IP6, sw_if_index, table_id, 1);
437 rv = ip_table_bind (FIB_PROTOCOL_IP4, sw_if_index, table_id, 1);
439 BAD_SW_IF_INDEX_LABEL;
441 REPLY_MACRO (VL_API_SW_INTERFACE_SET_TABLE_REPLY);
445 ip_table_bind (fib_protocol_t fproto,
446 u32 sw_if_index, u32 table_id, u8 is_api)
448 CLIB_UNUSED (ip_interface_address_t * ia);
449 u32 fib_index, mfib_index;
455 src = FIB_SOURCE_API;
456 msrc = MFIB_SOURCE_API;
460 src = FIB_SOURCE_CLI;
461 msrc = MFIB_SOURCE_CLI;
465 * This if table does not exist = error is what we want in the end.
467 fib_index = fib_table_find (fproto, table_id);
468 mfib_index = mfib_table_find (fproto, table_id);
470 if (~0 == fib_index || ~0 == mfib_index)
472 return (VNET_API_ERROR_NO_SUCH_FIB);
475 if (FIB_PROTOCOL_IP6 == fproto)
478 * If the interface already has in IP address, then a change int
479 * VRF is not allowed. The IP address applied must first be removed.
480 * We do not do that automatically here, since VPP has no knowledge
481 * of whether those subnets are valid in the destination VRF.
484 foreach_ip_interface_address (&ip6_main.lookup_main,
486 1 /* honor unnumbered */ ,
488 return (VNET_API_ERROR_ADDRESS_FOUND_FOR_INTERFACE);
492 vec_validate (ip6_main.fib_index_by_sw_if_index, sw_if_index);
493 vec_validate (ip6_main.mfib_index_by_sw_if_index, sw_if_index);
496 * tell those that are interested that the binding is changing.
498 ip6_table_bind_callback_t *cb;
499 vec_foreach (cb, ip6_main.table_bind_callbacks)
500 cb->function (&ip6_main, cb->function_opaque,
503 ip6_main.fib_index_by_sw_if_index[sw_if_index]);
507 /* reset back to default */
508 if (0 != ip6_main.fib_index_by_sw_if_index[sw_if_index])
509 fib_table_unlock (ip6_main.fib_index_by_sw_if_index[sw_if_index],
510 FIB_PROTOCOL_IP6, src);
511 if (0 != ip6_main.mfib_index_by_sw_if_index[sw_if_index])
512 mfib_table_unlock (ip6_main.mfib_index_by_sw_if_index
513 [sw_if_index], FIB_PROTOCOL_IP6, msrc);
518 /* we need to lock the table now it's inuse */
519 fib_table_lock (fib_index, FIB_PROTOCOL_IP6, src);
520 mfib_table_lock (mfib_index, FIB_PROTOCOL_IP6, msrc);
523 ip6_main.fib_index_by_sw_if_index[sw_if_index] = fib_index;
524 ip6_main.mfib_index_by_sw_if_index[sw_if_index] = mfib_index;
529 * If the interface already has in IP address, then a change int
530 * VRF is not allowed. The IP address applied must first be removed.
531 * We do not do that automatically here, since VPP has no knowledge
532 * of whether those subnets are valid in the destination VRF.
535 foreach_ip_interface_address (&ip4_main.lookup_main,
537 1 /* honor unnumbered */ ,
539 return (VNET_API_ERROR_ADDRESS_FOUND_FOR_INTERFACE);
543 vec_validate (ip4_main.fib_index_by_sw_if_index, sw_if_index);
544 vec_validate (ip4_main.mfib_index_by_sw_if_index, sw_if_index);
547 * tell those that are interested that the binding is changing.
549 ip4_table_bind_callback_t *cb;
550 vec_foreach (cb, ip4_main.table_bind_callbacks)
551 cb->function (&ip4_main, cb->function_opaque,
554 ip4_main.fib_index_by_sw_if_index[sw_if_index]);
558 /* reset back to default */
559 if (0 != ip4_main.fib_index_by_sw_if_index[sw_if_index])
560 fib_table_unlock (ip4_main.fib_index_by_sw_if_index[sw_if_index],
561 FIB_PROTOCOL_IP4, src);
562 if (0 != ip4_main.mfib_index_by_sw_if_index[sw_if_index])
563 mfib_table_unlock (ip4_main.mfib_index_by_sw_if_index
564 [sw_if_index], FIB_PROTOCOL_IP4, msrc);
569 /* we need to lock the table now it's inuse */
570 fib_index = fib_table_find_or_create_and_lock (FIB_PROTOCOL_IP4,
573 mfib_index = mfib_table_find_or_create_and_lock (FIB_PROTOCOL_IP4,
577 ip4_main.fib_index_by_sw_if_index[sw_if_index] = fib_index;
578 ip4_main.mfib_index_by_sw_if_index[sw_if_index] = mfib_index;
585 send_sw_interface_get_table_reply (vl_api_registration_t * reg,
586 u32 context, int retval, u32 vrf_id)
588 vl_api_sw_interface_get_table_reply_t *mp;
590 mp = vl_msg_api_alloc (sizeof (*mp));
591 clib_memset (mp, 0, sizeof (*mp));
592 mp->_vl_msg_id = ntohs (VL_API_SW_INTERFACE_GET_TABLE_REPLY);
593 mp->context = context;
594 mp->retval = htonl (retval);
595 mp->vrf_id = htonl (vrf_id);
597 vl_api_send_msg (reg, (u8 *) mp);
601 vl_api_sw_interface_get_table_t_handler (vl_api_sw_interface_get_table_t * mp)
603 vl_api_registration_t *reg;
604 fib_table_t *fib_table = 0;
605 u32 sw_if_index = ~0;
608 fib_protocol_t fib_proto = FIB_PROTOCOL_IP4;
611 reg = vl_api_client_index_to_registration (mp->client_index);
615 VALIDATE_SW_IF_INDEX (mp);
617 sw_if_index = ntohl (mp->sw_if_index);
620 fib_proto = FIB_PROTOCOL_IP6;
622 fib_index = fib_table_get_index_for_sw_if_index (fib_proto, sw_if_index);
625 fib_table = fib_table_get (fib_index, fib_proto);
626 table_id = fib_table->ft_table_id;
629 BAD_SW_IF_INDEX_LABEL;
631 send_sw_interface_get_table_reply (reg, mp->context, rv, table_id);
634 static void vl_api_sw_interface_set_unnumbered_t_handler
635 (vl_api_sw_interface_set_unnumbered_t * mp)
637 vl_api_sw_interface_set_unnumbered_reply_t *rmp;
639 vnet_main_t *vnm = vnet_get_main ();
640 u32 sw_if_index = ntohl (mp->sw_if_index);
641 u32 unnumbered_sw_if_index = ntohl (mp->unnumbered_sw_if_index);
644 * The API message field names are backwards from
645 * the underlying data structure names.
646 * It's not worth changing them now.
648 if (!vnet_sw_interface_is_api_valid (vnm, unnumbered_sw_if_index))
650 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX;
654 /* Only check the "use loop0" field when setting the binding */
655 if (mp->is_add && !vnet_sw_interface_is_api_valid (vnm, sw_if_index))
657 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX_2;
661 vnet_sw_interface_update_unnumbered (unnumbered_sw_if_index,
662 sw_if_index, mp->is_add);
664 REPLY_MACRO (VL_API_SW_INTERFACE_SET_UNNUMBERED_REPLY);
668 vl_api_sw_interface_clear_stats_t_handler (vl_api_sw_interface_clear_stats_t *
671 vl_api_sw_interface_clear_stats_reply_t *rmp;
673 vnet_main_t *vnm = vnet_get_main ();
674 vnet_interface_main_t *im = &vnm->interface_main;
675 vlib_simple_counter_main_t *sm;
676 vlib_combined_counter_main_t *cm;
680 if (mp->sw_if_index != ~0)
681 VALIDATE_SW_IF_INDEX (mp);
683 n_counters = vec_len (im->combined_sw_if_counters);
685 for (j = 0; j < n_counters; j++)
687 im = &vnm->interface_main;
688 cm = im->combined_sw_if_counters + j;
689 if (mp->sw_if_index == (u32) ~ 0)
690 vlib_clear_combined_counters (cm);
692 vlib_zero_combined_counter (cm, ntohl (mp->sw_if_index));
695 n_counters = vec_len (im->sw_if_counters);
697 for (j = 0; j < n_counters; j++)
699 im = &vnm->interface_main;
700 sm = im->sw_if_counters + j;
701 if (mp->sw_if_index == (u32) ~ 0)
702 vlib_clear_simple_counters (sm);
704 vlib_zero_simple_counter (sm, ntohl (mp->sw_if_index));
707 BAD_SW_IF_INDEX_LABEL;
709 REPLY_MACRO (VL_API_SW_INTERFACE_CLEAR_STATS_REPLY);
713 * Events used for sw_interface_events
717 API_LINK_STATE_UP_EVENT = 1 << 1,
718 API_LINK_STATE_DOWN_EVENT = 1 << 2,
719 API_ADMIN_UP_EVENT = 1 << 3,
720 API_ADMIN_DOWN_EVENT = 1 << 4,
721 API_SW_INTERFACE_ADD_EVENT = 1 << 5,
722 API_SW_INTERFACE_DEL_EVENT = 1 << 6,
726 send_sw_interface_event (vpe_api_main_t * am,
727 vpe_client_registration_t * reg,
728 vl_api_registration_t * vl_reg,
729 u32 sw_if_index, enum api_events events)
731 vl_api_sw_interface_event_t *mp;
733 mp = vl_msg_api_alloc (sizeof (*mp));
734 clib_memset (mp, 0, sizeof (*mp));
735 mp->_vl_msg_id = ntohs (VL_API_SW_INTERFACE_EVENT);
736 mp->sw_if_index = ntohl (sw_if_index);
737 mp->client_index = reg->client_index;
738 mp->pid = reg->client_pid;
740 mp->flags |= (events & API_ADMIN_UP_EVENT) ?
741 IF_STATUS_API_FLAG_ADMIN_UP : 0;
742 mp->flags |= (events & API_LINK_STATE_UP_EVENT) ?
743 IF_STATUS_API_FLAG_LINK_UP : 0;
744 mp->flags = ntohl (mp->flags);
745 mp->deleted = events & API_SW_INTERFACE_DEL_EVENT ? true : false;
746 vl_api_send_msg (vl_reg, (u8 *) mp);
750 link_state_process (vlib_main_t * vm,
751 vlib_node_runtime_t * rt, vlib_frame_t * f)
753 vpe_api_main_t *vam = &vpe_api_main;
754 uword *event_by_sw_if_index = 0;
755 vpe_client_registration_t *reg;
757 vl_api_registration_t *vl_reg;
759 uword *event_data = 0;
762 vam->link_state_process_up = 1;
766 vlib_process_wait_for_event (vm);
768 /* Batch up events */
769 while ((event_type = vlib_process_get_events (vm, &event_data)) != ~0)
771 for (i = 0; i < vec_len (event_data); i++)
773 sw_if_index = event_data[i];
774 vec_validate_init_empty (event_by_sw_if_index, sw_if_index, 0);
775 event_by_sw_if_index[sw_if_index] |= event_type;
777 vec_reset_length (event_data);
780 for (i = 0; i < vec_len (event_by_sw_if_index); i++)
782 if (event_by_sw_if_index[i] == 0)
786 pool_foreach(reg, vam->interface_events_registrations,
788 vl_reg = vl_api_client_index_to_registration (reg->client_index);
790 send_sw_interface_event (vam, reg, vl_reg, i, event_by_sw_if_index[i]);
794 vec_reset_length (event_by_sw_if_index);
800 static clib_error_t *link_up_down_function (vnet_main_t * vm, u32 hw_if_index,
802 static clib_error_t *admin_up_down_function (vnet_main_t * vm,
803 u32 hw_if_index, u32 flags);
804 static clib_error_t *sw_interface_add_del_function (vnet_main_t * vm,
809 VLIB_REGISTER_NODE (link_state_process_node,static) = {
810 .function = link_state_process,
811 .type = VLIB_NODE_TYPE_PROCESS,
812 .name = "vpe-link-state-process",
816 VNET_SW_INTERFACE_ADMIN_UP_DOWN_FUNCTION (admin_up_down_function);
817 VNET_HW_INTERFACE_LINK_UP_DOWN_FUNCTION (link_up_down_function);
818 VNET_SW_INTERFACE_ADD_DEL_FUNCTION (sw_interface_add_del_function);
820 static clib_error_t *
821 link_up_down_function (vnet_main_t * vm, u32 hw_if_index, u32 flags)
823 vpe_api_main_t *vam = &vpe_api_main;
824 vnet_hw_interface_t *hi = vnet_get_hw_interface (vm, hw_if_index);
826 if (vam->link_state_process_up)
828 enum api_events event =
829 flags ? API_LINK_STATE_UP_EVENT : API_LINK_STATE_DOWN_EVENT;
830 vlib_process_signal_event (vam->vlib_main,
831 link_state_process_node.index, event,
837 static clib_error_t *
838 admin_up_down_function (vnet_main_t * vm, u32 sw_if_index, u32 flags)
840 vpe_api_main_t *vam = &vpe_api_main;
843 * Note: it's perfectly fair to set a subif admin up / admin down.
844 * Note the subtle distinction between this routine and the previous
847 if (vam->link_state_process_up)
849 enum api_events event =
850 flags ? API_ADMIN_UP_EVENT : API_ADMIN_DOWN_EVENT;
851 vlib_process_signal_event (vam->vlib_main,
852 link_state_process_node.index, event,
858 static clib_error_t *
859 sw_interface_add_del_function (vnet_main_t * vm, u32 sw_if_index, u32 flags)
861 vpe_api_main_t *vam = &vpe_api_main;
863 if (vam->link_state_process_up)
865 enum api_events event =
866 flags ? API_SW_INTERFACE_ADD_EVENT : API_SW_INTERFACE_DEL_EVENT;
867 vlib_process_signal_event (vam->vlib_main,
868 link_state_process_node.index, event,
874 static void vl_api_sw_interface_tag_add_del_t_handler
875 (vl_api_sw_interface_tag_add_del_t * mp)
877 vnet_main_t *vnm = vnet_get_main ();
878 vl_api_sw_interface_tag_add_del_reply_t *rmp;
881 u32 sw_if_index = ntohl (mp->sw_if_index);
883 VALIDATE_SW_IF_INDEX (mp);
887 if (vl_api_from_api_string (&mp->tag)[0] == 0)
889 rv = VNET_API_ERROR_INVALID_VALUE;
893 tag = format (0, "%s%c", vl_api_from_api_string (&mp->tag), 0);
894 vnet_set_sw_interface_tag (vnm, tag, sw_if_index);
897 vnet_clear_sw_interface_tag (vnm, sw_if_index);
899 BAD_SW_IF_INDEX_LABEL;
901 REPLY_MACRO (VL_API_SW_INTERFACE_TAG_ADD_DEL_REPLY);
904 static void vl_api_sw_interface_set_mac_address_t_handler
905 (vl_api_sw_interface_set_mac_address_t * mp)
907 vl_api_sw_interface_set_mac_address_reply_t *rmp;
908 vnet_main_t *vnm = vnet_get_main ();
909 u32 sw_if_index = ntohl (mp->sw_if_index);
910 vnet_sw_interface_t *si;
915 VALIDATE_SW_IF_INDEX (mp);
917 si = vnet_get_sw_interface (vnm, sw_if_index);
918 mac_address_decode (mp->mac_address, &mac);
920 vnet_hw_interface_change_mac_address (vnm, si->hw_if_index, (u8 *) & mac);
923 rv = VNET_API_ERROR_UNIMPLEMENTED;
924 clib_error_report (error);
928 BAD_SW_IF_INDEX_LABEL;
930 REPLY_MACRO (VL_API_SW_INTERFACE_SET_MAC_ADDRESS_REPLY);
933 static void vl_api_sw_interface_get_mac_address_t_handler
934 (vl_api_sw_interface_get_mac_address_t * mp)
936 vl_api_sw_interface_get_mac_address_reply_t *rmp;
937 vl_api_registration_t *reg;
938 vnet_main_t *vnm = vnet_get_main ();
939 u32 sw_if_index = ntohl (mp->sw_if_index);
940 vnet_sw_interface_t *si;
941 ethernet_interface_t *eth_if = 0;
944 VALIDATE_SW_IF_INDEX (mp);
946 si = vnet_get_sup_sw_interface (vnm, sw_if_index);
947 if (si->type == VNET_SW_INTERFACE_TYPE_HARDWARE)
948 eth_if = ethernet_get_interface (ðernet_main, si->hw_if_index);
950 BAD_SW_IF_INDEX_LABEL;
952 reg = vl_api_client_index_to_registration (mp->client_index);
955 rmp = vl_msg_api_alloc (sizeof (*rmp));
956 rmp->_vl_msg_id = htons (VL_API_SW_INTERFACE_GET_MAC_ADDRESS_REPLY);
957 rmp->context = mp->context;
958 rmp->retval = htonl (rv);
960 mac_address_encode ((mac_address_t *) eth_if->address, rmp->mac_address);
961 vl_api_send_msg (reg, (u8 *) rmp);
964 static void vl_api_sw_interface_set_rx_mode_t_handler
965 (vl_api_sw_interface_set_rx_mode_t * mp)
967 vl_api_sw_interface_set_rx_mode_reply_t *rmp;
968 vnet_main_t *vnm = vnet_get_main ();
969 u32 sw_if_index = ntohl (mp->sw_if_index);
970 vnet_sw_interface_t *si;
974 VALIDATE_SW_IF_INDEX (mp);
976 si = vnet_get_sw_interface (vnm, sw_if_index);
977 if (si->type != VNET_SW_INTERFACE_TYPE_HARDWARE)
979 rv = VNET_API_ERROR_INVALID_VALUE;
980 goto bad_sw_if_index;
983 error = set_hw_interface_change_rx_mode (vnm, si->hw_if_index,
985 ntohl (mp->queue_id),
986 (vnet_hw_interface_rx_mode)
991 rv = VNET_API_ERROR_UNIMPLEMENTED;
992 clib_error_report (error);
996 BAD_SW_IF_INDEX_LABEL;
998 REPLY_MACRO (VL_API_SW_INTERFACE_SET_RX_MODE_REPLY);
1002 send_interface_rx_placement_details (vpe_api_main_t * am,
1003 vl_api_registration_t * rp,
1004 u32 sw_if_index, u32 worker_id,
1005 u32 queue_id, u8 mode, u32 context)
1007 vl_api_sw_interface_rx_placement_details_t *mp;
1008 mp = vl_msg_api_alloc (sizeof (*mp));
1009 clib_memset (mp, 0, sizeof (*mp));
1011 mp->_vl_msg_id = htons (VL_API_SW_INTERFACE_RX_PLACEMENT_DETAILS);
1012 mp->sw_if_index = htonl (sw_if_index);
1013 mp->queue_id = htonl (queue_id);
1014 mp->worker_id = htonl (worker_id);
1016 mp->context = context;
1018 vl_api_send_msg (rp, (u8 *) mp);
1021 static void vl_api_sw_interface_rx_placement_dump_t_handler
1022 (vl_api_sw_interface_rx_placement_dump_t * mp)
1024 vnet_main_t *vnm = vnet_get_main ();
1025 vpe_api_main_t *am = &vpe_api_main;
1026 u32 sw_if_index = ntohl (mp->sw_if_index);
1027 vl_api_registration_t *reg;
1029 reg = vl_api_client_index_to_registration (mp->client_index);
1033 if (sw_if_index == ~0)
1035 vnet_device_input_runtime_t *rt;
1036 vnet_device_and_queue_t *dq;
1037 vlib_node_t *pn = vlib_get_node_by_name (am->vlib_main,
1038 (u8 *) "device-input");
1043 foreach_vlib_main (({
1044 clib_bitmap_foreach (si, pn->sibling_bitmap,
1046 rt = vlib_node_get_runtime_data (this_vlib_main, si);
1047 vec_foreach (dq, rt->devices_and_queues)
1049 vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm,
1051 send_interface_rx_placement_details (am, reg, hw->sw_if_index, index,
1052 dq->queue_id, dq->mode, mp->context);
1062 vnet_sw_interface_t *si;
1064 if (!vnet_sw_if_index_is_api_valid (sw_if_index))
1066 clib_warning ("sw_if_index %u does not exist", sw_if_index);
1067 goto bad_sw_if_index;
1070 si = vnet_get_sw_interface (vnm, sw_if_index);
1071 if (si->type != VNET_SW_INTERFACE_TYPE_HARDWARE)
1073 clib_warning ("interface type is not HARDWARE! P2P, PIPE and SUB"
1074 " interfaces are not supported");
1075 goto bad_sw_if_index;
1078 vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, si->hw_if_index);
1080 for (i = 0; i < vec_len (hw->dq_runtime_index_by_queue); i++)
1082 send_interface_rx_placement_details (am, reg, hw->sw_if_index,
1083 hw->input_node_thread_index_by_queue
1085 hw->rx_mode_by_queue[i],
1090 BAD_SW_IF_INDEX_LABEL;
1093 static void vl_api_sw_interface_set_rx_placement_t_handler
1094 (vl_api_sw_interface_set_rx_placement_t * mp)
1096 vl_api_sw_interface_set_rx_placement_reply_t *rmp;
1097 vnet_main_t *vnm = vnet_get_main ();
1098 u32 sw_if_index = ntohl (mp->sw_if_index);
1099 vnet_sw_interface_t *si;
1100 clib_error_t *error = 0;
1103 VALIDATE_SW_IF_INDEX (mp);
1105 si = vnet_get_sw_interface (vnm, sw_if_index);
1106 if (si->type != VNET_SW_INTERFACE_TYPE_HARDWARE)
1108 rv = VNET_API_ERROR_INVALID_VALUE;
1109 goto bad_sw_if_index;
1112 error = set_hw_interface_rx_placement (si->hw_if_index,
1113 ntohl (mp->queue_id),
1114 ntohl (mp->worker_id), mp->is_main);
1117 rv = VNET_API_ERROR_UNIMPLEMENTED;
1118 clib_error_report (error);
1122 BAD_SW_IF_INDEX_LABEL;
1124 REPLY_MACRO (VL_API_SW_INTERFACE_SET_RX_PLACEMENT_REPLY);
1128 vl_api_create_vlan_subif_t_handler (vl_api_create_vlan_subif_t * mp)
1130 vl_api_create_vlan_subif_reply_t *rmp;
1131 vnet_main_t *vnm = vnet_get_main ();
1132 u32 sw_if_index = (u32) ~ 0;
1133 vnet_hw_interface_t *hi;
1136 vnet_sw_interface_t template;
1138 vnet_interface_main_t *im = &vnm->interface_main;
1139 u64 sup_and_sub_key;
1140 vl_api_registration_t *reg;
1141 clib_error_t *error;
1143 VALIDATE_SW_IF_INDEX (mp);
1145 hi = vnet_get_sup_hw_interface (vnm, ntohl (mp->sw_if_index));
1147 if (hi->bond_info == VNET_HW_INTERFACE_BOND_INFO_SLAVE)
1149 rv = VNET_API_ERROR_BOND_SLAVE_NOT_ALLOWED;
1153 id = ntohl (mp->vlan_id);
1154 if (id == 0 || id > 4095)
1156 rv = VNET_API_ERROR_INVALID_VLAN;
1160 sup_and_sub_key = ((u64) (hi->sw_if_index) << 32) | (u64) id;
1162 p = hash_get_mem (im->sw_if_index_by_sup_and_sub, &sup_and_sub_key);
1165 rv = VNET_API_ERROR_VLAN_ALREADY_EXISTS;
1169 clib_memset (&template, 0, sizeof (template));
1170 template.type = VNET_SW_INTERFACE_TYPE_SUB;
1171 template.flood_class = VNET_FLOOD_CLASS_NORMAL;
1172 template.sup_sw_if_index = hi->sw_if_index;
1173 template.sub.id = id;
1174 template.sub.eth.raw_flags = 0;
1175 template.sub.eth.flags.one_tag = 1;
1176 template.sub.eth.outer_vlan_id = id;
1177 template.sub.eth.flags.exact_match = 1;
1179 error = vnet_create_sw_interface (vnm, &template, &sw_if_index);
1182 clib_error_report (error);
1183 rv = VNET_API_ERROR_INVALID_REGISTRATION;
1187 u64 *kp = clib_mem_alloc (sizeof (*kp));
1188 *kp = sup_and_sub_key;
1190 hash_set (hi->sub_interface_sw_if_index_by_id, id, sw_if_index);
1191 hash_set_mem (im->sw_if_index_by_sup_and_sub, kp, sw_if_index);
1193 BAD_SW_IF_INDEX_LABEL;
1196 reg = vl_api_client_index_to_registration (mp->client_index);
1200 rmp = vl_msg_api_alloc (sizeof (*rmp));
1201 rmp->_vl_msg_id = htons (VL_API_CREATE_VLAN_SUBIF_REPLY);
1202 rmp->context = mp->context;
1203 rmp->retval = htonl (rv);
1204 rmp->sw_if_index = htonl (sw_if_index);
1205 vl_api_send_msg (reg, (u8 *) rmp);
1209 vl_api_create_subif_t_handler (vl_api_create_subif_t * mp)
1211 vl_api_create_subif_reply_t *rmp;
1212 vnet_main_t *vnm = vnet_get_main ();
1213 u32 sw_if_index = ~0;
1216 vnet_sw_interface_t *si;
1217 vnet_hw_interface_t *hi;
1218 vnet_sw_interface_t template;
1220 vnet_interface_main_t *im = &vnm->interface_main;
1221 u64 sup_and_sub_key;
1222 clib_error_t *error;
1224 VALIDATE_SW_IF_INDEX (mp);
1226 si = vnet_get_sup_sw_interface (vnm, ntohl (mp->sw_if_index));
1227 hi = vnet_get_sup_hw_interface (vnm, ntohl (mp->sw_if_index));
1229 if (hi->bond_info == VNET_HW_INTERFACE_BOND_INFO_SLAVE)
1231 rv = VNET_API_ERROR_BOND_SLAVE_NOT_ALLOWED;
1235 sw_if_index = si->sw_if_index;
1236 sub_id = ntohl (mp->sub_id);
1238 sup_and_sub_key = ((u64) (sw_if_index) << 32) | (u64) sub_id;
1240 p = hash_get_mem (im->sw_if_index_by_sup_and_sub, &sup_and_sub_key);
1244 clib_warning ("sup sw_if_index %d, sub id %d already exists\n",
1245 sw_if_index, sub_id);
1246 rv = VNET_API_ERROR_SUBIF_ALREADY_EXISTS;
1250 clib_memset (&template, 0, sizeof (template));
1251 template.type = VNET_SW_INTERFACE_TYPE_SUB;
1252 template.flood_class = VNET_FLOOD_CLASS_NORMAL;
1253 template.sup_sw_if_index = sw_if_index;
1254 template.sub.id = sub_id;
1255 template.sub.eth.raw_flags = ntohl (mp->sub_if_flags);
1256 template.sub.eth.outer_vlan_id = ntohs (mp->outer_vlan_id);
1257 template.sub.eth.inner_vlan_id = ntohs (mp->inner_vlan_id);
1259 error = vnet_create_sw_interface (vnm, &template, &sw_if_index);
1262 clib_error_report (error);
1263 rv = VNET_API_ERROR_SUBIF_CREATE_FAILED;
1267 u64 *kp = clib_mem_alloc (sizeof (*kp));
1268 *kp = sup_and_sub_key;
1270 hash_set (hi->sub_interface_sw_if_index_by_id, sub_id, sw_if_index);
1271 hash_set_mem (im->sw_if_index_by_sup_and_sub, kp, sw_if_index);
1273 BAD_SW_IF_INDEX_LABEL;
1278 REPLY_MACRO2(VL_API_CREATE_SUBIF_REPLY,
1280 rmp->sw_if_index = ntohl(sw_if_index);
1286 vl_api_delete_subif_t_handler (vl_api_delete_subif_t * mp)
1288 vl_api_delete_subif_reply_t *rmp;
1291 rv = vnet_delete_sub_interface (ntohl (mp->sw_if_index));
1293 REPLY_MACRO (VL_API_DELETE_SUBIF_REPLY);
1297 vl_api_interface_name_renumber_t_handler (vl_api_interface_name_renumber_t *
1300 vl_api_interface_name_renumber_reply_t *rmp;
1303 VALIDATE_SW_IF_INDEX (mp);
1305 rv = vnet_interface_name_renumber
1306 (ntohl (mp->sw_if_index), ntohl (mp->new_show_dev_instance));
1308 BAD_SW_IF_INDEX_LABEL;
1310 REPLY_MACRO (VL_API_INTERFACE_NAME_RENUMBER_REPLY);
1314 vl_api_create_loopback_t_handler (vl_api_create_loopback_t * mp)
1316 vl_api_create_loopback_reply_t *rmp;
1321 mac_address_decode (mp->mac_address, &mac);
1322 rv = vnet_create_loopback_interface (&sw_if_index, (u8 *) & mac, 0, 0);
1325 REPLY_MACRO2(VL_API_CREATE_LOOPBACK_REPLY,
1327 rmp->sw_if_index = ntohl (sw_if_index);
1332 static void vl_api_create_loopback_instance_t_handler
1333 (vl_api_create_loopback_instance_t * mp)
1335 vl_api_create_loopback_instance_reply_t *rmp;
1337 u8 is_specified = mp->is_specified;
1338 u32 user_instance = ntohl (mp->user_instance);
1342 mac_address_decode (mp->mac_address, &mac);
1343 rv = vnet_create_loopback_interface (&sw_if_index, (u8 *) & mac,
1344 is_specified, user_instance);
1347 REPLY_MACRO2(VL_API_CREATE_LOOPBACK_INSTANCE_REPLY,
1349 rmp->sw_if_index = ntohl (sw_if_index);
1355 vl_api_delete_loopback_t_handler (vl_api_delete_loopback_t * mp)
1357 vl_api_delete_loopback_reply_t *rmp;
1361 sw_if_index = ntohl (mp->sw_if_index);
1362 rv = vnet_delete_loopback_interface (sw_if_index);
1364 REPLY_MACRO (VL_API_DELETE_LOOPBACK_REPLY);
1368 vl_api_collect_detailed_interface_stats_t_handler
1369 (vl_api_collect_detailed_interface_stats_t * mp)
1371 vl_api_collect_detailed_interface_stats_reply_t *rmp;
1375 vnet_sw_interface_stats_collect_enable_disable (ntohl (mp->sw_if_index),
1376 mp->enable_disable);
1378 REPLY_MACRO (VL_API_COLLECT_DETAILED_INTERFACE_STATS_REPLY);
1383 * Add vpe's API message handlers to the table.
1384 * vlib has already mapped shared memory and
1385 * added the client registration handlers.
1386 * See .../vlib-api/vlibmemory/memclnt_vlib.c:memclnt_process()
1388 #define vl_msg_name_crc_list
1389 #include <vnet/interface.api.h>
1390 #undef vl_msg_name_crc_list
1393 setup_message_id_table (api_main_t * am)
1395 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id);
1396 foreach_vl_msg_name_crc_interface;
1400 pub_sub_handler (interface_events, INTERFACE_EVENTS);
1402 static clib_error_t *
1403 interface_api_hookup (vlib_main_t * vm)
1405 api_main_t *am = &api_main;
1408 vl_msg_api_set_handlers(VL_API_##N, #n, \
1409 vl_api_##n##_t_handler, \
1411 vl_api_##n##_t_endian, \
1412 vl_api_##n##_t_print, \
1413 sizeof(vl_api_##n##_t), 1);
1414 foreach_vpe_api_msg;
1417 /* Mark these APIs as mp safe */
1418 am->is_mp_safe[VL_API_SW_INTERFACE_DUMP] = 1;
1419 am->is_mp_safe[VL_API_SW_INTERFACE_DETAILS] = 1;
1420 am->is_mp_safe[VL_API_SW_INTERFACE_TAG_ADD_DEL] = 1;
1422 /* Do not replay VL_API_SW_INTERFACE_DUMP messages */
1423 am->api_trace_cfg[VL_API_SW_INTERFACE_DUMP].replay_enable = 0;
1426 * Set up the (msg_name, crc, message-id) table
1428 setup_message_id_table (am);
1433 VLIB_API_INIT_FUNCTION (interface_api_hookup);
1436 * fd.io coding-style-patch-verification: ON
1439 * eval: (c-set-style "gnu")