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 = format (0, "%s%c", mp->host_if_name, 0);
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 = format (0, "%s%c", mp->host_namespace, 0);
96 if (mp->host_bridge_set)
97 ap->host_bridge = format (0, "%s%c", mp->host_bridge, 0);
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);
168 vec_free (ap->host_if_name);
169 vec_free (ap->host_namespace);
170 vec_free (ap->host_bridge);
175 vl_api_tap_delete_v2_t_handler (vl_api_tap_delete_v2_t * mp)
177 vl_api_registration_t *reg;
178 reg = vl_api_client_index_to_registration (mp->client_index);
182 vnet_main_t *vnm = vnet_get_main ();
183 vlib_main_t *vm = vlib_get_main ();
185 vl_api_tap_delete_v2_reply_t *rmp;
187 u32 sw_if_index = ntohl (mp->sw_if_index);
189 rv = tap_delete_if (vm, sw_if_index);
191 rmp = vl_msg_api_alloc (sizeof (*rmp));
192 rmp->_vl_msg_id = ntohs (VL_API_TAP_DELETE_V2_REPLY);
193 rmp->context = mp->context;
194 rmp->retval = ntohl (rv);
196 vl_api_send_msg (reg, (u8 *) rmp);
199 vnet_clear_sw_interface_tag (vnm, sw_if_index);
203 tap_send_sw_interface_details (vpe_api_main_t * am,
204 vl_api_registration_t * reg,
205 tap_interface_details_t * tap_if, u32 context)
207 vl_api_sw_interface_tap_v2_details_t *mp;
208 mp = vl_msg_api_alloc (sizeof (*mp));
209 clib_memset (mp, 0, sizeof (*mp));
210 mp->_vl_msg_id = htons (VL_API_SW_INTERFACE_TAP_V2_DETAILS);
211 mp->id = htonl (tap_if->id);
212 mp->sw_if_index = htonl (tap_if->sw_if_index);
213 mp->tap_flags = htonl (tap_if->tap_flags);
214 clib_memcpy (mp->dev_name, tap_if->dev_name,
215 MIN (ARRAY_LEN (mp->dev_name) - 1,
216 strlen ((const char *) tap_if->dev_name)));
217 mp->rx_ring_sz = htons (tap_if->rx_ring_sz);
218 mp->tx_ring_sz = htons (tap_if->tx_ring_sz);
219 mac_address_encode (&tap_if->host_mac_addr, mp->host_mac_addr);
220 clib_memcpy (mp->host_if_name, tap_if->host_if_name,
221 MIN (ARRAY_LEN (mp->host_if_name) - 1,
222 strlen ((const char *) tap_if->host_if_name)));
223 clib_memcpy (mp->host_namespace, tap_if->host_namespace,
224 MIN (ARRAY_LEN (mp->host_namespace) - 1,
225 strlen ((const char *) tap_if->host_namespace)));
226 clib_memcpy (mp->host_bridge, tap_if->host_bridge,
227 MIN (ARRAY_LEN (mp->host_bridge) - 1,
228 strlen ((const char *) tap_if->host_bridge)));
229 mp->host_mtu_size = htonl (tap_if->host_mtu_size);
230 mac_address_encode (&tap_if->host_mac_addr, mp->host_mac_addr);
232 if (tap_if->host_ip4_prefix_len)
233 ip4_address_encode (&tap_if->host_ip4_addr, mp->host_ip4_prefix.address);
234 mp->host_ip4_prefix.len = tap_if->host_ip4_prefix_len;
235 if (tap_if->host_ip6_prefix_len)
236 ip6_address_encode (&tap_if->host_ip6_addr, mp->host_ip6_prefix.address);
237 mp->host_ip6_prefix.len = tap_if->host_ip6_prefix_len;
239 mp->context = context;
240 vl_api_send_msg (reg, (u8 *) mp);
244 vl_api_sw_interface_tap_v2_dump_t_handler (vl_api_sw_interface_tap_v2_dump_t *
248 vpe_api_main_t *am = &vpe_api_main;
249 vl_api_registration_t *reg;
250 tap_interface_details_t *tapifs = NULL;
251 tap_interface_details_t *tap_if = NULL;
252 u32 filter_sw_if_index;
254 reg = vl_api_client_index_to_registration (mp->client_index);
258 filter_sw_if_index = htonl (mp->sw_if_index);
259 if (mp->sw_if_index != ~0)
260 VALIDATE_SW_IF_INDEX (mp);
262 rv = tap_dump_ifs (&tapifs);
266 vec_foreach (tap_if, tapifs)
268 if ((filter_sw_if_index == ~0)
269 || (tap_if->sw_if_index == filter_sw_if_index))
270 tap_send_sw_interface_details (am, reg, tap_if, mp->context);
272 BAD_SW_IF_INDEX_LABEL;
276 #define vl_msg_name_crc_list
277 #include <vnet/vnet_all_api_h.h>
278 #undef vl_msg_name_crc_list
281 tap_setup_message_id_table (api_main_t * am)
283 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id);
284 foreach_vl_msg_name_crc_tapv2;
288 static clib_error_t *
289 tapv2_api_hookup (vlib_main_t * vm)
291 api_main_t *am = vlibapi_get_main ();
294 vl_msg_api_set_handlers(VL_API_##N, #n, \
295 vl_api_##n##_t_handler, \
297 vl_api_##n##_t_endian, \
298 vl_api_##n##_t_print, \
299 sizeof(vl_api_##n##_t), 1);
300 foreach_tapv2_api_msg;
304 * Set up the (msg_name, crc, message-id) table
306 tap_setup_message_id_table (am);
311 VLIB_API_INIT_FUNCTION (tapv2_api_hookup);
314 * fd.io coding-style-patch-verification: ON
317 * eval: (c-set-style "gnu")