2 *------------------------------------------------------------------
3 * tap_api.c - vnet tap device driver API support
5 * Copyright (c) 2017 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>
28 #include <vnet/ethernet/ethernet_types_api.h>
29 #include <vnet/ip/ip_types_api.h>
31 #include <vnet/vnet_msg_enum.h>
33 #define vl_typedefs /* define message structures */
34 #include <vnet/vnet_all_api_h.h>
37 #define vl_endianfun /* define message structures */
38 #include <vnet/vnet_all_api_h.h>
41 /* instantiate all the print functions we know about */
42 #define vl_print(handle, ...) vlib_cli_output (handle, __VA_ARGS__)
44 #include <vnet/vnet_all_api_h.h>
47 #include <vlibapi/api_helper_macros.h>
48 #include <vnet/devices/tap/tap.h>
50 #define foreach_tapv2_api_msg \
51 _(TAP_CREATE_V2, tap_create_v2) \
52 _(TAP_DELETE_V2, tap_delete_v2) \
53 _(SW_INTERFACE_TAP_V2_DUMP, sw_interface_tap_v2_dump)
56 vl_api_tap_create_v2_t_handler (vl_api_tap_create_v2_t * mp)
58 vl_api_registration_t *reg;
59 reg = vl_api_client_index_to_registration (mp->client_index);
63 vnet_main_t *vnm = vnet_get_main ();
64 vlib_main_t *vm = vlib_get_main ();
65 vl_api_tap_create_v2_reply_t *rmp;
67 tap_create_if_args_t _a, *ap = &_a;
69 clib_memset (ap, 0, sizeof (*ap));
71 ap->id = ntohl (mp->id);
72 if (!mp->use_random_mac)
74 mac_address_decode (mp->mac_address, &ap->mac_addr);
77 ap->rx_ring_sz = ntohs (mp->rx_ring_sz);
78 ap->tx_ring_sz = ntohs (mp->tx_ring_sz);
79 ap->sw_if_index = (u32) ~ 0;
80 ap->num_rx_queues = 1;
82 if (mp->num_rx_queues > 1)
83 ap->num_rx_queues = mp->num_rx_queues;
85 if (mp->host_if_name_set)
86 ap->host_if_name = mp->host_if_name;
88 if (mp->host_mac_addr_set)
90 mac_address_decode (mp->host_mac_addr, &ap->host_mac_addr);
93 if (mp->host_namespace_set)
94 ap->host_namespace = mp->host_namespace;
96 if (mp->host_bridge_set)
97 ap->host_bridge = mp->host_bridge;
99 if (mp->host_ip4_prefix_set)
101 ip4_address_decode (mp->host_ip4_prefix.address, &ap->host_ip4_addr);
102 ap->host_ip4_prefix_len = mp->host_ip4_prefix.len;
105 if (mp->host_ip6_prefix_set)
107 ip6_address_decode (mp->host_ip6_prefix.address, &ap->host_ip6_addr);
108 ap->host_ip6_prefix_len = mp->host_ip6_prefix.len;
111 if (mp->host_ip4_gw_set)
113 ip4_address_decode (mp->host_ip4_gw, &ap->host_ip4_gw);
114 ap->host_ip4_gw_set = 1;
117 if (mp->host_ip6_gw_set)
119 ip6_address_decode (mp->host_ip6_gw, &ap->host_ip6_gw);
120 ap->host_ip6_gw_set = 1;
123 if (mp->host_mtu_set)
125 ap->host_mtu_size = ntohl (mp->host_mtu_size);
126 ap->host_mtu_set = 1;
129 STATIC_ASSERT (((int) TAP_API_FLAG_GSO == (int) TAP_FLAG_GSO),
130 "tap gso api flag mismatch");
131 STATIC_ASSERT (((int) TAP_API_FLAG_CSUM_OFFLOAD ==
132 (int) TAP_FLAG_CSUM_OFFLOAD),
133 "tap checksum offload api flag mismatch");
134 STATIC_ASSERT (((int) TAP_API_FLAG_PERSIST == (int) TAP_FLAG_PERSIST),
135 "tap persist api flag mismatch");
136 STATIC_ASSERT (((int) TAP_API_FLAG_ATTACH == (int) TAP_FLAG_ATTACH),
137 "tap attach api flag mismatch");
138 STATIC_ASSERT (((int) TAP_API_FLAG_TUN == (int) TAP_FLAG_TUN),
139 "tap tun api flag mismatch");
140 STATIC_ASSERT (((int) TAP_API_FLAG_GRO_COALESCE ==
141 (int) TAP_FLAG_GRO_COALESCE),
142 "tap gro coalesce api flag mismatch");
143 STATIC_ASSERT (((int) TAP_API_FLAG_PACKED == (int) TAP_FLAG_PACKED),
144 "tap packed api flag mismatch");
145 STATIC_ASSERT (((int) TAP_API_FLAG_IN_ORDER ==
146 (int) TAP_FLAG_IN_ORDER), "tap in-order api flag mismatch");
148 ap->tap_flags = ntohl (mp->tap_flags);
150 tap_create_if (vm, ap);
153 /* If a tag was supplied... */
154 if (vl_api_string_len (&mp->tag))
156 u8 *tag = vl_api_from_api_to_new_vec (mp, &mp->tag);
157 vnet_set_sw_interface_tag (vnm, tag, ap->sw_if_index);
160 rmp = vl_msg_api_alloc (sizeof (*rmp));
161 rmp->_vl_msg_id = ntohs (VL_API_TAP_CREATE_V2_REPLY);
162 rmp->context = mp->context;
163 rmp->retval = ntohl (ap->rv);
164 rmp->sw_if_index = ntohl (ap->sw_if_index);
166 vl_api_send_msg (reg, (u8 *) rmp);
170 vl_api_tap_delete_v2_t_handler (vl_api_tap_delete_v2_t * mp)
172 vl_api_registration_t *reg;
173 reg = vl_api_client_index_to_registration (mp->client_index);
177 vnet_main_t *vnm = vnet_get_main ();
178 vlib_main_t *vm = vlib_get_main ();
180 vl_api_tap_delete_v2_reply_t *rmp;
182 u32 sw_if_index = ntohl (mp->sw_if_index);
184 rv = tap_delete_if (vm, sw_if_index);
186 rmp = vl_msg_api_alloc (sizeof (*rmp));
187 rmp->_vl_msg_id = ntohs (VL_API_TAP_DELETE_V2_REPLY);
188 rmp->context = mp->context;
189 rmp->retval = ntohl (rv);
191 vl_api_send_msg (reg, (u8 *) rmp);
194 vnet_clear_sw_interface_tag (vnm, sw_if_index);
198 tap_send_sw_interface_details (vpe_api_main_t * am,
199 vl_api_registration_t * reg,
200 tap_interface_details_t * tap_if, u32 context)
202 vl_api_sw_interface_tap_v2_details_t *mp;
203 mp = vl_msg_api_alloc (sizeof (*mp));
204 clib_memset (mp, 0, sizeof (*mp));
205 mp->_vl_msg_id = htons (VL_API_SW_INTERFACE_TAP_V2_DETAILS);
206 mp->id = htonl (tap_if->id);
207 mp->sw_if_index = htonl (tap_if->sw_if_index);
208 mp->tap_flags = htonl (tap_if->tap_flags);
209 clib_memcpy (mp->dev_name, tap_if->dev_name,
210 MIN (ARRAY_LEN (mp->dev_name) - 1,
211 strlen ((const char *) tap_if->dev_name)));
212 mp->rx_ring_sz = htons (tap_if->rx_ring_sz);
213 mp->tx_ring_sz = htons (tap_if->tx_ring_sz);
214 mac_address_encode (&tap_if->host_mac_addr, mp->host_mac_addr);
215 clib_memcpy (mp->host_if_name, tap_if->host_if_name,
216 MIN (ARRAY_LEN (mp->host_if_name) - 1,
217 strlen ((const char *) tap_if->host_if_name)));
218 clib_memcpy (mp->host_namespace, tap_if->host_namespace,
219 MIN (ARRAY_LEN (mp->host_namespace) - 1,
220 strlen ((const char *) tap_if->host_namespace)));
221 clib_memcpy (mp->host_bridge, tap_if->host_bridge,
222 MIN (ARRAY_LEN (mp->host_bridge) - 1,
223 strlen ((const char *) tap_if->host_bridge)));
224 mp->host_mtu_size = htonl (tap_if->host_mtu_size);
225 mac_address_encode (&tap_if->host_mac_addr, mp->host_mac_addr);
227 if (tap_if->host_ip4_prefix_len)
228 ip4_address_encode (&tap_if->host_ip4_addr, mp->host_ip4_prefix.address);
229 mp->host_ip4_prefix.len = tap_if->host_ip4_prefix_len;
230 if (tap_if->host_ip6_prefix_len)
231 ip6_address_encode (&tap_if->host_ip6_addr, mp->host_ip6_prefix.address);
232 mp->host_ip6_prefix.len = tap_if->host_ip6_prefix_len;
234 mp->context = context;
235 vl_api_send_msg (reg, (u8 *) mp);
239 vl_api_sw_interface_tap_v2_dump_t_handler (vl_api_sw_interface_tap_v2_dump_t *
243 vpe_api_main_t *am = &vpe_api_main;
244 vl_api_registration_t *reg;
245 tap_interface_details_t *tapifs = NULL;
246 tap_interface_details_t *tap_if = NULL;
247 u32 filter_sw_if_index;
249 reg = vl_api_client_index_to_registration (mp->client_index);
253 filter_sw_if_index = htonl (mp->sw_if_index);
254 if (mp->sw_if_index != ~0)
255 VALIDATE_SW_IF_INDEX (mp);
257 rv = tap_dump_ifs (&tapifs);
261 vec_foreach (tap_if, tapifs)
263 if ((filter_sw_if_index == ~0)
264 || (tap_if->sw_if_index == filter_sw_if_index))
265 tap_send_sw_interface_details (am, reg, tap_if, mp->context);
267 BAD_SW_IF_INDEX_LABEL;
271 #define vl_msg_name_crc_list
272 #include <vnet/vnet_all_api_h.h>
273 #undef vl_msg_name_crc_list
276 tap_setup_message_id_table (api_main_t * am)
278 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id);
279 foreach_vl_msg_name_crc_tapv2;
283 static clib_error_t *
284 tapv2_api_hookup (vlib_main_t * vm)
286 api_main_t *am = vlibapi_get_main ();
289 vl_msg_api_set_handlers(VL_API_##N, #n, \
290 vl_api_##n##_t_handler, \
292 vl_api_##n##_t_endian, \
293 vl_api_##n##_t_print, \
294 sizeof(vl_api_##n##_t), 1);
295 foreach_tapv2_api_msg;
299 * Set up the (msg_name, crc, message-id) table
301 tap_setup_message_id_table (am);
306 VLIB_API_INIT_FUNCTION (tapv2_api_hookup);
309 * fd.io coding-style-patch-verification: ON
312 * eval: (c-set-style "gnu")