2 *------------------------------------------------------------------
3 * Copyright (c) 2018 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:
8 * http://www.apache.org/licenses/LICENSE-2.0
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 *------------------------------------------------------------------
20 #include <linux/if_link.h>
21 #include <bpf/libbpf.h>
22 #include <vlib/vlib.h>
23 #include <vlib/unix/unix.h>
24 #include <vlib/pci/pci.h>
25 #include <vppinfra/linux/sysfs.h>
26 #include <vppinfra/unix.h>
27 #include <vnet/ethernet/ethernet.h>
30 af_xdp_main_t af_xdp_main;
39 gdb_af_xdp_get_prod (const struct xsk_ring_prod *prod)
41 gdb_af_xdp_pair_t pair = { *prod->producer, *prod->consumer };
46 gdb_af_xdp_get_cons (const struct xsk_ring_cons * cons)
48 gdb_af_xdp_pair_t pair = { *cons->producer, *cons->consumer };
53 af_xdp_mac_change (vnet_hw_interface_t * hw, const u8 * old, const u8 * new)
55 af_xdp_main_t *am = &af_xdp_main;
56 af_xdp_device_t *ad = vec_elt_at_index (am->devices, hw->dev_instance);
57 errno_t err = memcpy_s (ad->hwaddr, sizeof (ad->hwaddr), new, 6);
59 return clib_error_return_code (0, -err, CLIB_ERROR_ERRNO_VALID,
65 af_xdp_flag_change (vnet_main_t * vnm, vnet_hw_interface_t * hw, u32 flags)
67 af_xdp_main_t *am = &af_xdp_main;
68 af_xdp_device_t *ad = vec_elt_at_index (am->devices, hw->dev_instance);
73 af_xdp_log (VLIB_LOG_LEVEL_ERR, ad, "set unicast not supported yet");
75 case ETHERNET_INTERFACE_FLAG_ACCEPT_ALL:
76 af_xdp_log (VLIB_LOG_LEVEL_ERR, ad,
77 "set promiscuous not supported yet");
79 case ETHERNET_INTERFACE_FLAG_MTU:
80 af_xdp_log (VLIB_LOG_LEVEL_ERR, ad, "set mtu not supported yet");
84 af_xdp_log (VLIB_LOG_LEVEL_ERR, ad, "unknown flag %x requested", flags);
89 af_xdp_delete_if (vlib_main_t * vm, af_xdp_device_t * ad)
91 vnet_main_t *vnm = vnet_get_main ();
92 af_xdp_main_t *axm = &af_xdp_main;
93 struct xsk_socket **xsk;
94 struct xsk_umem **umem;
100 vnet_hw_interface_set_flags (vnm, ad->hw_if_index, 0);
101 vnet_hw_interface_unassign_rx_thread (vnm, ad->hw_if_index, 0);
102 ethernet_delete_interface (vnm, ad->hw_if_index);
105 vec_foreach (rxq, ad->rxqs) clib_file_del_by_index (&file_main,
107 vec_foreach (txq, ad->txqs) clib_spinlock_free (&txq->lock);
108 vec_foreach (xsk, ad->xsk) xsk_socket__delete (*xsk);
109 vec_foreach (umem, ad->umem) xsk_umem__delete (*umem);
113 bpf_set_link_xdp_fd (ad->linux_ifindex, -1, 0);
114 bpf_object__unload (ad->bpf_obj);
119 vec_free (ad->buffer_template);
122 clib_error_free (ad->error);
123 pool_put (axm->devices, ad);
127 af_xdp_load_program (af_xdp_create_if_args_t * args, af_xdp_device_t * ad)
131 ad->linux_ifindex = if_nametoindex (ad->linux_ifname);
132 if (!ad->linux_ifindex)
134 args->rv = VNET_API_ERROR_INVALID_VALUE;
136 clib_error_return_unix (0, "if_nametoindex(%s) failed",
141 if (bpf_prog_load (args->prog, BPF_PROG_TYPE_XDP, &ad->bpf_obj, &fd))
143 args->rv = VNET_API_ERROR_SYSCALL_ERROR_5;
145 clib_error_return_unix (0, "bpf_prog_load(%s) failed", args->prog);
149 #ifndef XDP_FLAGS_REPLACE
150 #define XDP_FLAGS_REPLACE 0
152 if (bpf_set_link_xdp_fd (ad->linux_ifindex, fd, XDP_FLAGS_REPLACE))
154 args->rv = VNET_API_ERROR_SYSCALL_ERROR_6;
156 clib_error_return_unix (0, "bpf_set_link_xdp_fd(%s) failed",
164 bpf_object__unload (ad->bpf_obj);
167 ad->linux_ifindex = ~0;
172 af_xdp_create_queue (vlib_main_t * vm, af_xdp_create_if_args_t * args,
173 af_xdp_device_t * ad, int qid, int rxq_num, int txq_num)
175 struct xsk_umem **umem = vec_elt_at_index (ad->umem, qid);
176 struct xsk_socket **xsk = vec_elt_at_index (ad->xsk, qid);
177 af_xdp_rxq_t *rxq = vec_elt_at_index (ad->rxqs, qid);
178 af_xdp_txq_t *txq = vec_elt_at_index (ad->txqs, qid);
179 struct xsk_umem_config umem_config;
180 struct xsk_socket_config sock_config;
181 struct xdp_options opt;
184 * fq and cq must always be allocated even if unused
185 * whereas rx and tx indicates whether we want rxq, txq, or both
187 struct xsk_ring_cons *rx = qid < rxq_num ? &rxq->rx : 0;
188 struct xsk_ring_prod *fq = &rxq->fq;
189 struct xsk_ring_prod *tx = qid < txq_num ? &txq->tx : 0;
190 struct xsk_ring_cons *cq = &txq->cq;
193 memset (&umem_config, 0, sizeof (umem_config));
194 umem_config.fill_size = args->rxq_size;
195 umem_config.comp_size = args->txq_size;
196 umem_config.frame_size =
197 sizeof (vlib_buffer_t) + vlib_buffer_get_default_data_size (vm);
198 umem_config.flags = XDP_UMEM_UNALIGNED_CHUNK_FLAG;
200 (umem, uword_to_pointer (vm->buffer_main->buffer_mem_start, void *),
201 vm->buffer_main->buffer_mem_size, fq, cq, &umem_config))
203 args->rv = VNET_API_ERROR_SYSCALL_ERROR_1;
204 args->error = clib_error_return_unix (0, "xsk_umem__create() failed");
208 memset (&sock_config, 0, sizeof (sock_config));
209 sock_config.rx_size = args->rxq_size;
210 sock_config.tx_size = args->txq_size;
211 sock_config.bind_flags = XDP_USE_NEED_WAKEUP;
214 case AF_XDP_MODE_AUTO:
216 case AF_XDP_MODE_COPY:
217 sock_config.bind_flags |= XDP_COPY;
219 case AF_XDP_MODE_ZERO_COPY:
220 sock_config.bind_flags |= XDP_ZEROCOPY;
223 if (xsk_socket__create
224 (xsk, ad->linux_ifname, qid, *umem, rx, tx, &sock_config))
226 args->rv = VNET_API_ERROR_SYSCALL_ERROR_2;
228 clib_error_return_unix (0,
229 "xsk_socket__create() failed (is linux netdev %s up?)",
234 fd = xsk_socket__fd (*xsk);
235 optlen = sizeof (opt);
236 if (getsockopt (fd, SOL_XDP, XDP_OPTIONS, &opt, &optlen))
238 args->rv = VNET_API_ERROR_SYSCALL_ERROR_3;
240 clib_error_return_unix (0, "getsockopt(XDP_OPTIONS) failed");
243 if (opt.flags & XDP_OPTIONS_ZEROCOPY)
244 ad->flags |= AF_XDP_DEVICE_F_ZEROCOPY;
246 rxq->xsk_fd = qid < rxq_num ? fd : -1;
247 txq->xsk_fd = qid < txq_num ? fd : -1;
252 xsk_socket__delete (*xsk);
254 xsk_umem__delete (*umem);
262 af_xdp_get_numa (const char *ifname)
269 (char *) format (0, "/sys/class/net/%s/device/numa_node%c", ifname, 0);
270 err = clib_sysfs_read (path, "%d", &numa);
274 clib_error_free (err);
279 static clib_error_t *
280 af_xdp_device_rxq_read_ready (clib_file_t * f)
282 vnet_main_t *vnm = vnet_get_main ();
283 const af_xdp_main_t *am = &af_xdp_main;
284 const u32 dev_instance = f->private_data >> 16;
285 const u16 qid = f->private_data & 0xffff;
286 const af_xdp_device_t *ad = vec_elt_at_index (am->devices, dev_instance);
287 vnet_device_input_set_interrupt_pending (vnm, ad->hw_if_index, qid);
292 af_xdp_create_if (vlib_main_t * vm, af_xdp_create_if_args_t * args)
294 vnet_main_t *vnm = vnet_get_main ();
295 vlib_thread_main_t *tm = vlib_get_thread_main ();
296 af_xdp_main_t *am = &af_xdp_main;
298 vnet_sw_interface_t *sw;
299 vnet_hw_interface_t *hw;
300 int rxq_num, txq_num, q_num;
303 args->rxq_size = args->rxq_size ? args->rxq_size : 2 * VLIB_FRAME_SIZE;
304 args->txq_size = args->txq_size ? args->txq_size : 2 * VLIB_FRAME_SIZE;
305 rxq_num = args->rxq_num ? args->rxq_num : 1;
306 txq_num = tm->n_vlib_mains;
308 if (!args->linux_ifname)
310 args->rv = VNET_API_ERROR_INVALID_VALUE;
311 args->error = clib_error_return (0, "missing host interface");
315 if (args->rxq_size < VLIB_FRAME_SIZE || args->txq_size < VLIB_FRAME_SIZE ||
316 args->rxq_size > 65535 || args->txq_size > 65535 ||
317 !is_pow2 (args->rxq_size) || !is_pow2 (args->txq_size))
319 args->rv = VNET_API_ERROR_INVALID_VALUE;
321 clib_error_return (0,
322 "queue size must be a power of two between %i and 65535",
327 pool_get_zero (am->devices, ad);
329 ad->linux_ifname = (char *) format (0, "%s", args->linux_ifname);
330 vec_validate (ad->linux_ifname, IFNAMSIZ - 1); /* libbpf expects ifname to be at least IFNAMSIZ */
332 if (args->prog && af_xdp_load_program (args, ad))
335 q_num = clib_max (rxq_num, txq_num);
336 vec_validate_aligned (ad->rxqs, q_num - 1, CLIB_CACHE_LINE_BYTES);
337 vec_validate_aligned (ad->txqs, q_num - 1, CLIB_CACHE_LINE_BYTES);
338 vec_validate_aligned (ad->umem, q_num - 1, CLIB_CACHE_LINE_BYTES);
339 vec_validate_aligned (ad->xsk, q_num - 1, CLIB_CACHE_LINE_BYTES);
340 ad->txq_num = txq_num;
341 for (i = 0; i < q_num; i++)
343 if (af_xdp_create_queue (vm, args, ad, i, rxq_num, txq_num))
346 * queue creation failed
347 * it is only a fatal error if we could not create the number of rx
348 * queues requested explicitely by the user
349 * we might create less tx queues than workers but this is ok
353 /* fixup vectors length */
354 vec_set_len (ad->umem, i);
355 vec_set_len (ad->xsk, i);
356 vec_set_len (ad->rxqs, i);
357 vec_set_len (ad->txqs, i);
360 goto err1; /* failed creating requested rxq: fatal error, bailing out */
363 * we created all rxq but failed some txq: not an error but
364 * initialize lock for shared txq
367 vec_foreach (txq, ad->txqs) clib_spinlock_init (&txq->lock);
369 clib_error_free (args->error);
374 ad->dev_instance = ad - am->devices;
375 ad->per_interface_next_index = VNET_DEVICE_INPUT_NEXT_ETHERNET_INPUT;
377 vlib_buffer_pool_get_default_for_numa (vm,
382 (char *) format (0, "%s/%d", ad->linux_ifname, ad->dev_instance);
384 ad->name = (char *) format (0, "%s", args->name);
386 ethernet_mac_address_generate (ad->hwaddr);
388 /* create interface */
389 if (ethernet_register_interface (vnm, af_xdp_device_class.index,
390 ad->dev_instance, ad->hwaddr,
391 &ad->hw_if_index, af_xdp_flag_change))
393 args->rv = VNET_API_ERROR_INVALID_INTERFACE;
395 clib_error_return (0, "ethernet_register_interface() failed");
399 sw = vnet_get_hw_sw_interface (vnm, ad->hw_if_index);
400 hw = vnet_get_hw_interface (vnm, ad->hw_if_index);
401 args->sw_if_index = ad->sw_if_index = sw->sw_if_index;
402 hw->flags |= VNET_HW_INTERFACE_FLAG_SUPPORTS_INT_MODE;
404 vnet_hw_interface_set_input_node (vnm, ad->hw_if_index,
405 af_xdp_input_node.index);
407 for (i = 0; i < rxq_num; i++)
409 af_xdp_rxq_t *rxq = vec_elt_at_index (ad->rxqs, i);
411 .file_descriptor = rxq->xsk_fd,
412 .flags = UNIX_FILE_EVENT_EDGE_TRIGGERED,
413 .private_data = (uword) ad->dev_instance << 16 | (uword) i,
414 .read_function = af_xdp_device_rxq_read_ready,
416 format (0, "%U rxq %d", format_af_xdp_device_name, ad->dev_instance,
419 rxq->file_index = clib_file_add (&file_main, &f);
420 vnet_hw_interface_assign_rx_thread (vnm, ad->hw_if_index, i, ~0);
423 /* buffer template */
424 vec_validate_aligned (ad->buffer_template, 1, CLIB_CACHE_LINE_BYTES);
425 ad->buffer_template->flags = VLIB_BUFFER_TOTAL_LENGTH_VALID;
426 ad->buffer_template->ref_count = 1;
427 vnet_buffer (ad->buffer_template)->sw_if_index[VLIB_RX] = ad->sw_if_index;
428 vnet_buffer (ad->buffer_template)->sw_if_index[VLIB_TX] = (u32) ~ 0;
429 ad->buffer_template->buffer_pool_index = ad->pool;
434 af_xdp_delete_if (vm, ad);
436 vlib_log_err (am->log_class, "%U", format_clib_error, args->error);
439 static clib_error_t *
440 af_xdp_interface_admin_up_down (vnet_main_t * vnm, u32 hw_if_index, u32 flags)
442 vnet_hw_interface_t *hi = vnet_get_hw_interface (vnm, hw_if_index);
443 af_xdp_main_t *am = &af_xdp_main;
444 af_xdp_device_t *ad = vec_elt_at_index (am->devices, hi->dev_instance);
445 uword is_up = (flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) != 0;
447 if (ad->flags & AF_XDP_DEVICE_F_ERROR)
448 return clib_error_return (0, "device is in error state");
452 vnet_hw_interface_set_flags (vnm, ad->hw_if_index,
453 VNET_HW_INTERFACE_FLAG_LINK_UP);
454 ad->flags |= AF_XDP_DEVICE_F_ADMIN_UP;
458 vnet_hw_interface_set_flags (vnm, ad->hw_if_index, 0);
459 ad->flags &= ~AF_XDP_DEVICE_F_ADMIN_UP;
465 af_xdp_set_interface_next_node (vnet_main_t * vnm, u32 hw_if_index,
468 af_xdp_main_t *am = &af_xdp_main;
469 vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, hw_if_index);
470 af_xdp_device_t *ad = pool_elt_at_index (am->devices, hw->dev_instance);
472 /* Shut off redirection */
473 if (node_index == ~0)
475 ad->per_interface_next_index = node_index;
479 ad->per_interface_next_index =
480 vlib_node_add_next (vlib_get_main (), af_xdp_input_node.index,
484 static char *af_xdp_tx_func_error_strings[] = {
486 foreach_af_xdp_tx_func_error
491 af_xdp_clear (u32 dev_instance)
493 af_xdp_main_t *am = &af_xdp_main;
494 af_xdp_device_t *ad = pool_elt_at_index (am->devices, dev_instance);
495 clib_error_free (ad->error);
499 VNET_DEVICE_CLASS (af_xdp_device_class) =
501 .name = "AF_XDP interface",
502 .format_device = format_af_xdp_device,
503 .format_device_name = format_af_xdp_device_name,
504 .admin_up_down_function = af_xdp_interface_admin_up_down,
505 .rx_redirect_to_node = af_xdp_set_interface_next_node,
506 .tx_function_n_errors = AF_XDP_TX_N_ERROR,
507 .tx_function_error_strings = af_xdp_tx_func_error_strings,
508 .mac_addr_change_function = af_xdp_mac_change,
509 .clear_counters = af_xdp_clear,
514 af_xdp_init (vlib_main_t * vm)
516 af_xdp_main_t *am = &af_xdp_main;
518 am->log_class = vlib_log_register_class ("af_xdp", 0);
523 VLIB_INIT_FUNCTION (af_xdp_init);
526 * fd.io coding-style-patch-verification: ON
529 * eval: (c-set-style "gnu")