1 /* 2 * Copyright (C) 2017 Netronome Systems, Inc. 3 * 4 * This software is dual licensed under the GNU General License Version 2, 5 * June 1991 as shown in the file COPYING in the top-level directory of this 6 * source tree or the BSD 2-Clause License provided below. You have the 7 * option to license this software under the complete terms of either license. 8 * 9 * The BSD 2-Clause License: 10 * 11 * Redistribution and use in source and binary forms, with or 12 * without modification, are permitted provided that the following 13 * conditions are met: 14 * 15 * 1. Redistributions of source code must retain the above 16 * copyright notice, this list of conditions and the following 17 * disclaimer. 18 * 19 * 2. Redistributions in binary form must reproduce the above 20 * copyright notice, this list of conditions and the following 21 * disclaimer in the documentation and/or other materials 22 * provided with the distribution. 23 * 24 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 25 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 26 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 27 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS 28 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN 29 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 30 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 31 * SOFTWARE. 32 */ 33 34 #ifndef _NFP_APP_H 35 #define _NFP_APP_H 1 36 37 #include <net/devlink.h> 38 39 #include <trace/events/devlink.h> 40 41 #include "nfp_net_repr.h" 42 43 struct bpf_prog; 44 struct net_device; 45 struct netdev_bpf; 46 struct netlink_ext_ack; 47 struct pci_dev; 48 struct sk_buff; 49 struct sk_buff; 50 struct nfp_app; 51 struct nfp_cpp; 52 struct nfp_pf; 53 struct nfp_repr; 54 struct nfp_net; 55 56 enum nfp_app_id { 57 NFP_APP_CORE_NIC = 0x1, 58 NFP_APP_BPF_NIC = 0x2, 59 NFP_APP_FLOWER_NIC = 0x3, 60 }; 61 62 extern const struct nfp_app_type app_nic; 63 extern const struct nfp_app_type app_bpf; 64 extern const struct nfp_app_type app_flower; 65 66 /** 67 * struct nfp_app_type - application definition 68 * @id: application ID 69 * @name: application name 70 * @ctrl_cap_mask: ctrl vNIC capability mask, allows disabling features like 71 * IRQMOD which are on by default but counter-productive for 72 * control messages which are often latency-sensitive 73 * @ctrl_has_meta: control messages have prepend of type:5/port:CTRL 74 * 75 * Callbacks 76 * @init: perform basic app checks and init 77 * @clean: clean app state 78 * @extra_cap: extra capabilities string 79 * @vnic_alloc: allocate vNICs (assign port types, etc.) 80 * @vnic_free: free up app's vNIC state 81 * @vnic_init: vNIC netdev was registered 82 * @vnic_clean: vNIC netdev about to be unregistered 83 * @repr_init: representor about to be registered 84 * @repr_preclean: representor about to unregistered, executed before app 85 * reference to the it is removed 86 * @repr_clean: representor about to be unregistered 87 * @repr_open: representor netdev open callback 88 * @repr_stop: representor netdev stop callback 89 * @check_mtu: MTU change request on a netdev (verify it is valid) 90 * @repr_change_mtu: MTU change request on repr (make and verify change) 91 * @start: start application logic 92 * @stop: stop application logic 93 * @ctrl_msg_rx: control message handler 94 * @setup_tc: setup TC ndo 95 * @bpf: BPF ndo offload-related calls 96 * @xdp_offload: offload an XDP program 97 * @eswitch_mode_get: get SR-IOV eswitch mode 98 * @sriov_enable: app-specific sriov initialisation 99 * @sriov_disable: app-specific sriov clean-up 100 * @repr_get: get representor netdev 101 */ 102 struct nfp_app_type { 103 enum nfp_app_id id; 104 const char *name; 105 106 u32 ctrl_cap_mask; 107 bool ctrl_has_meta; 108 109 int (*init)(struct nfp_app *app); 110 void (*clean)(struct nfp_app *app); 111 112 const char *(*extra_cap)(struct nfp_app *app, struct nfp_net *nn); 113 114 int (*vnic_alloc)(struct nfp_app *app, struct nfp_net *nn, 115 unsigned int id); 116 void (*vnic_free)(struct nfp_app *app, struct nfp_net *nn); 117 int (*vnic_init)(struct nfp_app *app, struct nfp_net *nn); 118 void (*vnic_clean)(struct nfp_app *app, struct nfp_net *nn); 119 120 int (*repr_init)(struct nfp_app *app, struct net_device *netdev); 121 void (*repr_preclean)(struct nfp_app *app, struct net_device *netdev); 122 void (*repr_clean)(struct nfp_app *app, struct net_device *netdev); 123 124 int (*repr_open)(struct nfp_app *app, struct nfp_repr *repr); 125 int (*repr_stop)(struct nfp_app *app, struct nfp_repr *repr); 126 127 int (*check_mtu)(struct nfp_app *app, struct net_device *netdev, 128 int new_mtu); 129 int (*repr_change_mtu)(struct nfp_app *app, struct net_device *netdev, 130 int new_mtu); 131 132 int (*start)(struct nfp_app *app); 133 void (*stop)(struct nfp_app *app); 134 135 void (*ctrl_msg_rx)(struct nfp_app *app, struct sk_buff *skb); 136 137 int (*setup_tc)(struct nfp_app *app, struct net_device *netdev, 138 enum tc_setup_type type, void *type_data); 139 int (*bpf)(struct nfp_app *app, struct nfp_net *nn, 140 struct netdev_bpf *xdp); 141 int (*xdp_offload)(struct nfp_app *app, struct nfp_net *nn, 142 struct bpf_prog *prog, 143 struct netlink_ext_ack *extack); 144 145 int (*sriov_enable)(struct nfp_app *app, int num_vfs); 146 void (*sriov_disable)(struct nfp_app *app); 147 148 enum devlink_eswitch_mode (*eswitch_mode_get)(struct nfp_app *app); 149 struct net_device *(*repr_get)(struct nfp_app *app, u32 id); 150 }; 151 152 /** 153 * struct nfp_app - NFP application container 154 * @pdev: backpointer to PCI device 155 * @pf: backpointer to NFP PF structure 156 * @cpp: pointer to the CPP handle 157 * @ctrl: pointer to ctrl vNIC struct 158 * @reprs: array of pointers to representors 159 * @type: pointer to const application ops and info 160 * @priv: app-specific priv data 161 */ 162 struct nfp_app { 163 struct pci_dev *pdev; 164 struct nfp_pf *pf; 165 struct nfp_cpp *cpp; 166 167 struct nfp_net *ctrl; 168 struct nfp_reprs __rcu *reprs[NFP_REPR_TYPE_MAX + 1]; 169 170 const struct nfp_app_type *type; 171 void *priv; 172 }; 173 174 bool __nfp_ctrl_tx(struct nfp_net *nn, struct sk_buff *skb); 175 bool nfp_ctrl_tx(struct nfp_net *nn, struct sk_buff *skb); 176 177 static inline int nfp_app_init(struct nfp_app *app) 178 { 179 if (!app->type->init) 180 return 0; 181 return app->type->init(app); 182 } 183 184 static inline void nfp_app_clean(struct nfp_app *app) 185 { 186 if (app->type->clean) 187 app->type->clean(app); 188 } 189 190 static inline int nfp_app_vnic_alloc(struct nfp_app *app, struct nfp_net *nn, 191 unsigned int id) 192 { 193 return app->type->vnic_alloc(app, nn, id); 194 } 195 196 static inline void nfp_app_vnic_free(struct nfp_app *app, struct nfp_net *nn) 197 { 198 if (app->type->vnic_free) 199 app->type->vnic_free(app, nn); 200 } 201 202 static inline int nfp_app_vnic_init(struct nfp_app *app, struct nfp_net *nn) 203 { 204 if (!app->type->vnic_init) 205 return 0; 206 return app->type->vnic_init(app, nn); 207 } 208 209 static inline void nfp_app_vnic_clean(struct nfp_app *app, struct nfp_net *nn) 210 { 211 if (app->type->vnic_clean) 212 app->type->vnic_clean(app, nn); 213 } 214 215 static inline int nfp_app_repr_open(struct nfp_app *app, struct nfp_repr *repr) 216 { 217 if (!app->type->repr_open) 218 return -EINVAL; 219 return app->type->repr_open(app, repr); 220 } 221 222 static inline int nfp_app_repr_stop(struct nfp_app *app, struct nfp_repr *repr) 223 { 224 if (!app->type->repr_stop) 225 return -EINVAL; 226 return app->type->repr_stop(app, repr); 227 } 228 229 static inline int 230 nfp_app_repr_init(struct nfp_app *app, struct net_device *netdev) 231 { 232 if (!app->type->repr_init) 233 return 0; 234 return app->type->repr_init(app, netdev); 235 } 236 237 static inline void 238 nfp_app_repr_preclean(struct nfp_app *app, struct net_device *netdev) 239 { 240 if (app->type->repr_preclean) 241 app->type->repr_preclean(app, netdev); 242 } 243 244 static inline void 245 nfp_app_repr_clean(struct nfp_app *app, struct net_device *netdev) 246 { 247 if (app->type->repr_clean) 248 app->type->repr_clean(app, netdev); 249 } 250 251 static inline int 252 nfp_app_check_mtu(struct nfp_app *app, struct net_device *netdev, int new_mtu) 253 { 254 if (!app || !app->type->check_mtu) 255 return 0; 256 return app->type->check_mtu(app, netdev, new_mtu); 257 } 258 259 static inline int 260 nfp_app_repr_change_mtu(struct nfp_app *app, struct net_device *netdev, 261 int new_mtu) 262 { 263 if (!app || !app->type->repr_change_mtu) 264 return 0; 265 return app->type->repr_change_mtu(app, netdev, new_mtu); 266 } 267 268 static inline int nfp_app_start(struct nfp_app *app, struct nfp_net *ctrl) 269 { 270 app->ctrl = ctrl; 271 if (!app->type->start) 272 return 0; 273 return app->type->start(app); 274 } 275 276 static inline void nfp_app_stop(struct nfp_app *app) 277 { 278 if (!app->type->stop) 279 return; 280 app->type->stop(app); 281 } 282 283 static inline const char *nfp_app_name(struct nfp_app *app) 284 { 285 if (!app) 286 return ""; 287 return app->type->name; 288 } 289 290 static inline bool nfp_app_needs_ctrl_vnic(struct nfp_app *app) 291 { 292 return app && app->type->ctrl_msg_rx; 293 } 294 295 static inline bool nfp_app_ctrl_has_meta(struct nfp_app *app) 296 { 297 return app->type->ctrl_has_meta; 298 } 299 300 static inline const char *nfp_app_extra_cap(struct nfp_app *app, 301 struct nfp_net *nn) 302 { 303 if (!app || !app->type->extra_cap) 304 return ""; 305 return app->type->extra_cap(app, nn); 306 } 307 308 static inline bool nfp_app_has_tc(struct nfp_app *app) 309 { 310 return app && app->type->setup_tc; 311 } 312 313 static inline int nfp_app_setup_tc(struct nfp_app *app, 314 struct net_device *netdev, 315 enum tc_setup_type type, void *type_data) 316 { 317 if (!app || !app->type->setup_tc) 318 return -EOPNOTSUPP; 319 return app->type->setup_tc(app, netdev, type, type_data); 320 } 321 322 static inline int nfp_app_bpf(struct nfp_app *app, struct nfp_net *nn, 323 struct netdev_bpf *bpf) 324 { 325 if (!app || !app->type->bpf) 326 return -EINVAL; 327 return app->type->bpf(app, nn, bpf); 328 } 329 330 static inline int nfp_app_xdp_offload(struct nfp_app *app, struct nfp_net *nn, 331 struct bpf_prog *prog, 332 struct netlink_ext_ack *extack) 333 { 334 if (!app || !app->type->xdp_offload) 335 return -EOPNOTSUPP; 336 return app->type->xdp_offload(app, nn, prog, extack); 337 } 338 339 static inline bool __nfp_app_ctrl_tx(struct nfp_app *app, struct sk_buff *skb) 340 { 341 trace_devlink_hwmsg(priv_to_devlink(app->pf), false, 0, 342 skb->data, skb->len); 343 344 return __nfp_ctrl_tx(app->ctrl, skb); 345 } 346 347 static inline bool nfp_app_ctrl_tx(struct nfp_app *app, struct sk_buff *skb) 348 { 349 trace_devlink_hwmsg(priv_to_devlink(app->pf), false, 0, 350 skb->data, skb->len); 351 352 return nfp_ctrl_tx(app->ctrl, skb); 353 } 354 355 static inline void nfp_app_ctrl_rx(struct nfp_app *app, struct sk_buff *skb) 356 { 357 trace_devlink_hwmsg(priv_to_devlink(app->pf), true, 0, 358 skb->data, skb->len); 359 360 app->type->ctrl_msg_rx(app, skb); 361 } 362 363 static inline int nfp_app_eswitch_mode_get(struct nfp_app *app, u16 *mode) 364 { 365 if (!app->type->eswitch_mode_get) 366 return -EOPNOTSUPP; 367 368 *mode = app->type->eswitch_mode_get(app); 369 370 return 0; 371 } 372 373 static inline int nfp_app_sriov_enable(struct nfp_app *app, int num_vfs) 374 { 375 if (!app || !app->type->sriov_enable) 376 return -EOPNOTSUPP; 377 return app->type->sriov_enable(app, num_vfs); 378 } 379 380 static inline void nfp_app_sriov_disable(struct nfp_app *app) 381 { 382 if (app && app->type->sriov_disable) 383 app->type->sriov_disable(app); 384 } 385 386 static inline struct net_device *nfp_app_repr_get(struct nfp_app *app, u32 id) 387 { 388 if (unlikely(!app || !app->type->repr_get)) 389 return NULL; 390 391 return app->type->repr_get(app, id); 392 } 393 394 struct nfp_app *nfp_app_from_netdev(struct net_device *netdev); 395 396 struct nfp_reprs * 397 nfp_reprs_get_locked(struct nfp_app *app, enum nfp_repr_type type); 398 struct nfp_reprs * 399 nfp_app_reprs_set(struct nfp_app *app, enum nfp_repr_type type, 400 struct nfp_reprs *reprs); 401 402 const char *nfp_app_mip_name(struct nfp_app *app); 403 struct sk_buff * 404 nfp_app_ctrl_msg_alloc(struct nfp_app *app, unsigned int size, gfp_t priority); 405 406 struct nfp_app *nfp_app_alloc(struct nfp_pf *pf, enum nfp_app_id id); 407 void nfp_app_free(struct nfp_app *app); 408 409 /* Callbacks shared between apps */ 410 411 int nfp_app_nic_vnic_alloc(struct nfp_app *app, struct nfp_net *nn, 412 unsigned int id); 413 414 #endif 415