src/plugins/af_xdp/af_xdp.h

   1 /*
   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:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  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  *------------------------------------------------------------------
  16  */
  17
  18 #ifndef _AF_XDP_H_
  19 #define _AF_XDP_H_
  20
  21 #include <vlib/log.h>
  22 #include <vnet/interface.h>
  23 #include <bpf/xsk.h>
  24
  25 #define AF_XDP_NUM_RX_QUEUES_ALL        ((u16)-1)
  26
  27 #define af_xdp_log(lvl, dev, f, ...) \
  28   vlib_log(lvl, af_xdp_main.log_class, "%v: " f, (dev)->name, ##__VA_ARGS__)
  29
  30 #define foreach_af_xdp_device_flags                                           \
  31   _ (0, INITIALIZED, "initialized")                                           \
  32   _ (1, ERROR, "error")                                                       \
  33   _ (2, ADMIN_UP, "admin-up")                                                 \
  34   _ (3, LINK_UP, "link-up")                                                   \
  35   _ (4, ZEROCOPY, "zero-copy")                                                \
  36   _ (5, SYSCALL_LOCK, "syscall-lock")
  37
  38 enum
  39 {
  40 #define _(a, b, c) AF_XDP_DEVICE_F_##b = (1 << a),
  41   foreach_af_xdp_device_flags
  42 #undef _
  43 };
  44
  45 #define af_xdp_device_error(dev, fmt, ...) \
  46   if (!(dev)->error) \
  47     { \
  48       clib_error_t *err_ = clib_error_return_unix (0, fmt, ## __VA_ARGS__); \
  49       if (!clib_atomic_bool_cmp_and_swap (&(dev)->error, 0, err_)) \
  50         clib_error_free(err_); \
  51     }
  52
  53 typedef enum
  54 {
  55   AF_XDP_RXQ_MODE_UNKNOWN,
  56   AF_XDP_RXQ_MODE_POLLING,
  57   AF_XDP_RXQ_MODE_INTERRUPT,
  58 } __clib_packed af_xdp_rxq_mode_t;
  59
  60 typedef struct
  61 {
  62   CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
  63
  64   /* fields below are accessed in data-plane (hot) */
  65
  66   clib_spinlock_t syscall_lock;
  67   struct xsk_ring_cons rx;
  68   struct xsk_ring_prod fq;
  69   int xsk_fd;
  70
  71   /* fields below are accessed in control-plane only (cold) */
  72
  73   uword file_index;
  74   u32 queue_index;
  75   af_xdp_rxq_mode_t mode;
  76 } af_xdp_rxq_t;
  77
  78 typedef struct
  79 {
  80   CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
  81
  82   /* fields below are accessed in data-plane (hot) */
  83
  84   clib_spinlock_t lock;
  85   clib_spinlock_t syscall_lock;
  86   struct xsk_ring_prod tx;
  87   struct xsk_ring_cons cq;
  88   int xsk_fd;
  89 } af_xdp_txq_t;
  90
  91 typedef struct
  92 {
  93   CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
  94
  95   /* fields below are accessed in data-plane (hot) */
  96
  97   af_xdp_rxq_t *rxqs;
  98   af_xdp_txq_t *txqs;
  99   vlib_buffer_t *buffer_template;
 100   u32 per_interface_next_index;
 101   u32 sw_if_index;
 102   u32 hw_if_index;
 103   u32 flags;
 104   u8 pool;                      /* buffer pool index */
 105   u8 txq_num;
 106
 107   /* fields below are accessed in control-plane only (cold) */
 108
 109   char *name;
 110   char *linux_ifname;
 111   u32 dev_instance;
 112   u8 hwaddr[6];
 113
 114   u8 rxq_num;
 115
 116   char *netns;
 117
 118   struct xsk_umem **umem;
 119   struct xsk_socket **xsk;
 120
 121   struct bpf_object *bpf_obj;
 122   unsigned linux_ifindex;
 123
 124   /* error */
 125   clib_error_t *error;
 126 } af_xdp_device_t;
 127
 128 typedef struct
 129 {
 130   af_xdp_device_t *devices;
 131   vlib_log_class_t log_class;
 132   u16 msg_id_base;
 133 } af_xdp_main_t;
 134
 135 extern af_xdp_main_t af_xdp_main;
 136
 137 typedef enum
 138 {
 139   AF_XDP_MODE_AUTO = 0,
 140   AF_XDP_MODE_COPY = 1,
 141   AF_XDP_MODE_ZERO_COPY = 2,
 142 } af_xdp_mode_t;
 143
 144 typedef enum
 145 {
 146   AF_XDP_CREATE_FLAGS_NO_SYSCALL_LOCK = 1,
 147 } af_xdp_create_flag_t;
 148
 149 typedef struct
 150 {
 151   char *linux_ifname;
 152   char *name;
 153   char *prog;
 154   char *netns;
 155   af_xdp_mode_t mode;
 156   af_xdp_create_flag_t flags;
 157   u32 rxq_size;
 158   u32 txq_size;
 159   u32 rxq_num;
 160
 161   /* return */
 162   int rv;
 163   u32 sw_if_index;
 164   clib_error_t *error;
 165 } af_xdp_create_if_args_t;
 166
 167 void af_xdp_create_if (vlib_main_t * vm, af_xdp_create_if_args_t * args);
 168 void af_xdp_delete_if (vlib_main_t * vm, af_xdp_device_t * ad);
 169
 170 void af_xdp_device_input_refill (af_xdp_device_t *ad);
 171
 172 extern vlib_node_registration_t af_xdp_input_node;
 173 extern vnet_device_class_t af_xdp_device_class;
 174
 175 /* format.c */
 176 format_function_t format_af_xdp_device;
 177 format_function_t format_af_xdp_device_name;
 178 format_function_t format_af_xdp_input_trace;
 179
 180 /* unformat.c */
 181 unformat_function_t unformat_af_xdp_create_if_args;
 182
 183 typedef struct
 184 {
 185   u32 next_index;
 186   u32 hw_if_index;
 187 } af_xdp_input_trace_t;
 188
 189 #define foreach_af_xdp_tx_func_error                                          \
 190   _ (NO_FREE_SLOTS, "no free tx slots")                                       \
 191   _ (SYSCALL_REQUIRED, "syscall required")                                    \
 192   _ (SYSCALL_FAILURES, "syscall failures")
 193
 194 typedef enum
 195 {
 196 #define _(f,s) AF_XDP_TX_ERROR_##f,
 197   foreach_af_xdp_tx_func_error
 198 #undef _
 199     AF_XDP_TX_N_ERROR,
 200 } af_xdp_tx_func_error_t;
 201
 202 #endif /* _AF_XDP_H_ */
 203
 204 /*
 205  * fd.io coding-style-patch-verification: ON
 206  *
 207  * Local Variables:
 208  * eval: (c-set-style "gnu")
 209  * End:
 210  */