1 /* SPDX-License-Identifier: BSD-3-Clause 2 * Copyright(c) 2017 Intel Corporation 3 */ 4 5 #ifndef _RTE_ETHDEV_DRIVER_H_ 6 #define _RTE_ETHDEV_DRIVER_H_ 7 8 /** 9 * @file 10 * 11 * RTE Ethernet Device PMD API 12 * 13 * These APIs for the use from Ethernet drivers, user applications shouldn't 14 * use them. 15 * 16 */ 17 18 #include <rte_ethdev.h> 19 20 /** 21 * @internal 22 * Structure used to hold information about the callbacks to be called for a 23 * queue on Rx and Tx. 24 */ 25 struct rte_eth_rxtx_callback { 26 struct rte_eth_rxtx_callback *next; 27 union{ 28 rte_rx_callback_fn rx; 29 rte_tx_callback_fn tx; 30 } fn; 31 void *param; 32 }; 33 34 /** 35 * @internal 36 * The generic data structure associated with each Ethernet device. 37 * 38 * Pointers to burst-oriented packet receive and transmit functions are 39 * located at the beginning of the structure, along with the pointer to 40 * where all the data elements for the particular device are stored in shared 41 * memory. This split allows the function pointer and driver data to be per- 42 * process, while the actual configuration data for the device is shared. 43 */ 44 struct rte_eth_dev { 45 eth_rx_burst_t rx_pkt_burst; /**< Pointer to PMD receive function */ 46 eth_tx_burst_t tx_pkt_burst; /**< Pointer to PMD transmit function */ 47 48 /** Pointer to PMD transmit prepare function */ 49 eth_tx_prep_t tx_pkt_prepare; 50 /** Get the number of used Rx descriptors */ 51 eth_rx_queue_count_t rx_queue_count; 52 /** Check the status of a Rx descriptor */ 53 eth_rx_descriptor_status_t rx_descriptor_status; 54 /** Check the status of a Tx descriptor */ 55 eth_tx_descriptor_status_t tx_descriptor_status; 56 57 /** 58 * Device data that is shared between primary and secondary processes 59 */ 60 struct rte_eth_dev_data *data; 61 void *process_private; /**< Pointer to per-process device data */ 62 const struct eth_dev_ops *dev_ops; /**< Functions exported by PMD */ 63 struct rte_device *device; /**< Backing device */ 64 struct rte_intr_handle *intr_handle; /**< Device interrupt handle */ 65 66 /** User application callbacks for NIC interrupts */ 67 struct rte_eth_dev_cb_list link_intr_cbs; 68 /** 69 * User-supplied functions called from rx_burst to post-process 70 * received packets before passing them to the user 71 */ 72 struct rte_eth_rxtx_callback *post_rx_burst_cbs[RTE_MAX_QUEUES_PER_PORT]; 73 /** 74 * User-supplied functions called from tx_burst to pre-process 75 * received packets before passing them to the driver for transmission 76 */ 77 struct rte_eth_rxtx_callback *pre_tx_burst_cbs[RTE_MAX_QUEUES_PER_PORT]; 78 79 enum rte_eth_dev_state state; /**< Flag indicating the port state */ 80 void *security_ctx; /**< Context for security ops */ 81 } __rte_cache_aligned; 82 83 struct rte_eth_dev_sriov; 84 struct rte_eth_dev_owner; 85 86 /** 87 * @internal 88 * The data part, with no function pointers, associated with each Ethernet 89 * device. This structure is safe to place in shared memory to be common 90 * among different processes in a multi-process configuration. 91 */ 92 struct rte_eth_dev_data { 93 char name[RTE_ETH_NAME_MAX_LEN]; /**< Unique identifier name */ 94 95 void **rx_queues; /**< Array of pointers to Rx queues */ 96 void **tx_queues; /**< Array of pointers to Tx queues */ 97 uint16_t nb_rx_queues; /**< Number of Rx queues */ 98 uint16_t nb_tx_queues; /**< Number of Tx queues */ 99 100 struct rte_eth_dev_sriov sriov; /**< SRIOV data */ 101 102 /** PMD-specific private data. @see rte_eth_dev_release_port() */ 103 void *dev_private; 104 105 struct rte_eth_link dev_link; /**< Link-level information & status */ 106 struct rte_eth_conf dev_conf; /**< Configuration applied to device */ 107 uint16_t mtu; /**< Maximum Transmission Unit */ 108 109 /** Common Rx buffer size handled by all queues */ 110 uint32_t min_rx_buf_size; 111 112 uint64_t rx_mbuf_alloc_failed; /**< Rx ring mbuf allocation failures */ 113 114 /** Device Ethernet link address. @see rte_eth_dev_release_port() */ 115 struct rte_ether_addr *mac_addrs; 116 /** Bitmap associating MAC addresses to pools */ 117 uint64_t mac_pool_sel[RTE_ETH_NUM_RECEIVE_MAC_ADDR]; 118 /** 119 * Device Ethernet MAC addresses of hash filtering. 120 * @see rte_eth_dev_release_port() 121 */ 122 struct rte_ether_addr *hash_mac_addrs; 123 124 uint16_t port_id; /**< Device [external] port identifier */ 125 126 __extension__ 127 uint8_t /** Rx promiscuous mode ON(1) / OFF(0) */ 128 promiscuous : 1, 129 /** Rx of scattered packets is ON(1) / OFF(0) */ 130 scattered_rx : 1, 131 /** Rx all multicast mode ON(1) / OFF(0) */ 132 all_multicast : 1, 133 /** Device state: STARTED(1) / STOPPED(0) */ 134 dev_started : 1, 135 /** Rx LRO is ON(1) / OFF(0) */ 136 lro : 1, 137 /** 138 * Indicates whether the device is configured: 139 * CONFIGURED(1) / NOT CONFIGURED(0) 140 */ 141 dev_configured : 1; 142 143 /** Queues state: HAIRPIN(2) / STARTED(1) / STOPPED(0) */ 144 uint8_t rx_queue_state[RTE_MAX_QUEUES_PER_PORT]; 145 /** Queues state: HAIRPIN(2) / STARTED(1) / STOPPED(0) */ 146 uint8_t tx_queue_state[RTE_MAX_QUEUES_PER_PORT]; 147 148 uint32_t dev_flags; /**< Capabilities */ 149 int numa_node; /**< NUMA node connection */ 150 151 /** VLAN filter configuration */ 152 struct rte_vlan_filter_conf vlan_filter_conf; 153 154 struct rte_eth_dev_owner owner; /**< The port owner */ 155 156 /** 157 * Switch-specific identifier. 158 * Valid if RTE_ETH_DEV_REPRESENTOR in dev_flags. 159 */ 160 uint16_t representor_id; 161 /** 162 * Port ID of the backing device. 163 * This device will be used to query representor info and calculate 164 * representor IDs. Valid if RTE_ETH_DEV_REPRESENTOR in dev_flags. 165 */ 166 uint16_t backer_port_id; 167 168 pthread_mutex_t flow_ops_mutex; /**< rte_flow ops mutex */ 169 } __rte_cache_aligned; 170 171 /** 172 * @internal 173 * The pool of *rte_eth_dev* structures. The size of the pool 174 * is configured at compile-time in the <rte_ethdev.c> file. 175 */ 176 extern struct rte_eth_dev rte_eth_devices[]; 177 178 /** @internal Declaration of the hairpin peer queue information structure. */ 179 struct rte_hairpin_peer_info; 180 181 /* 182 * Definitions of all functions exported by an Ethernet driver through the 183 * generic structure of type *eth_dev_ops* supplied in the *rte_eth_dev* 184 * structure associated with an Ethernet device. 185 */ 186 187 /** @internal Ethernet device configuration. */ 188 typedef int (*eth_dev_configure_t)(struct rte_eth_dev *dev); 189 190 /** @internal Function used to start a configured Ethernet device. */ 191 typedef int (*eth_dev_start_t)(struct rte_eth_dev *dev); 192 193 /** @internal Function used to stop a configured Ethernet device. */ 194 typedef int (*eth_dev_stop_t)(struct rte_eth_dev *dev); 195 196 /** @internal Function used to link up a configured Ethernet device. */ 197 typedef int (*eth_dev_set_link_up_t)(struct rte_eth_dev *dev); 198 199 /** @internal Function used to link down a configured Ethernet device. */ 200 typedef int (*eth_dev_set_link_down_t)(struct rte_eth_dev *dev); 201 202 /** @internal Function used to close a configured Ethernet device. */ 203 typedef int (*eth_dev_close_t)(struct rte_eth_dev *dev); 204 205 /** @internal Function used to reset a configured Ethernet device. */ 206 typedef int (*eth_dev_reset_t)(struct rte_eth_dev *dev); 207 208 /** @internal Function used to detect an Ethernet device removal. */ 209 typedef int (*eth_is_removed_t)(struct rte_eth_dev *dev); 210 211 /** 212 * @internal 213 * Function used to enable the Rx promiscuous mode of an Ethernet device. 214 * 215 * @param dev 216 * ethdev handle of port. 217 * 218 * @return 219 * Negative errno value on error, 0 on success. 220 * 221 * @retval 0 222 * Success, promiscuous mode is enabled. 223 * @retval -ENOTSUP 224 * Promiscuous mode is not supported. 225 * @retval -ENODEV 226 * Device is gone. 227 * @retval -E_RTE_SECONDARY 228 * Function was called from a secondary process instance and not supported. 229 * @retval -ETIMEDOUT 230 * Attempt to enable promiscuous mode failed because of timeout. 231 * @retval -EAGAIN 232 * Failed to enable promiscuous mode. 233 */ 234 typedef int (*eth_promiscuous_enable_t)(struct rte_eth_dev *dev); 235 236 /** 237 * @internal 238 * Function used to disable the Rx promiscuous mode of an Ethernet device. 239 * 240 * @param dev 241 * ethdev handle of port. 242 * 243 * @return 244 * Negative errno value on error, 0 on success. 245 * 246 * @retval 0 247 * Success, promiscuous mode is disabled. 248 * @retval -ENOTSUP 249 * Promiscuous mode disabling is not supported. 250 * @retval -ENODEV 251 * Device is gone. 252 * @retval -E_RTE_SECONDARY 253 * Function was called from a secondary process instance and not supported. 254 * @retval -ETIMEDOUT 255 * Attempt to disable promiscuous mode failed because of timeout. 256 * @retval -EAGAIN 257 * Failed to disable promiscuous mode. 258 */ 259 typedef int (*eth_promiscuous_disable_t)(struct rte_eth_dev *dev); 260 261 /** 262 * @internal 263 * Enable the receipt of all multicast packets by an Ethernet device. 264 * 265 * @param dev 266 * ethdev handle of port. 267 * 268 * @return 269 * Negative errno value on error, 0 on success. 270 * 271 * @retval 0 272 * Success, all-multicast mode is enabled. 273 * @retval -ENOTSUP 274 * All-multicast mode is not supported. 275 * @retval -ENODEV 276 * Device is gone. 277 * @retval -E_RTE_SECONDARY 278 * Function was called from a secondary process instance and not supported. 279 * @retval -ETIMEDOUT 280 * Attempt to enable all-multicast mode failed because of timeout. 281 * @retval -EAGAIN 282 * Failed to enable all-multicast mode. 283 */ 284 typedef int (*eth_allmulticast_enable_t)(struct rte_eth_dev *dev); 285 286 /** 287 * @internal 288 * Disable the receipt of all multicast packets by an Ethernet device. 289 * 290 * @param dev 291 * ethdev handle of port. 292 * 293 * @return 294 * Negative errno value on error, 0 on success. 295 * 296 * @retval 0 297 * Success, all-multicast mode is disabled. 298 * @retval -ENOTSUP 299 * All-multicast mode disabling is not supported. 300 * @retval -ENODEV 301 * Device is gone. 302 * @retval -E_RTE_SECONDARY 303 * Function was called from a secondary process instance and not supported. 304 * @retval -ETIMEDOUT 305 * Attempt to disable all-multicast mode failed because of timeout. 306 * @retval -EAGAIN 307 * Failed to disable all-multicast mode. 308 */ 309 typedef int (*eth_allmulticast_disable_t)(struct rte_eth_dev *dev); 310 311 /** 312 * @internal 313 * Get link speed, duplex mode and state (up/down) of an Ethernet device. 314 */ 315 typedef int (*eth_link_update_t)(struct rte_eth_dev *dev, 316 int wait_to_complete); 317 318 /** @internal Get global I/O statistics of an Ethernet device. */ 319 typedef int (*eth_stats_get_t)(struct rte_eth_dev *dev, 320 struct rte_eth_stats *igb_stats); 321 322 /** 323 * @internal 324 * Reset global I/O statistics of an Ethernet device to 0. 325 * 326 * @param dev 327 * ethdev handle of port. 328 * 329 * @return 330 * Negative errno value on error, 0 on success. 331 * 332 * @retval 0 333 * Success, statistics has been reset. 334 * @retval -ENOTSUP 335 * Resetting statistics is not supported. 336 * @retval -EINVAL 337 * Resetting statistics is not valid. 338 * @retval -ENOMEM 339 * Not enough memory to get the stats. 340 */ 341 typedef int (*eth_stats_reset_t)(struct rte_eth_dev *dev); 342 343 /** @internal Get extended stats of an Ethernet device. */ 344 typedef int (*eth_xstats_get_t)(struct rte_eth_dev *dev, 345 struct rte_eth_xstat *stats, unsigned int n); 346 347 /** 348 * @internal 349 * Get extended stats of an Ethernet device. 350 * 351 * @param dev 352 * ethdev handle of port. 353 * @param ids 354 * IDs array to retrieve specific statistics. Must not be NULL. 355 * @param values 356 * A pointer to a table to be filled with device statistics values. 357 * Must not be NULL. 358 * @param n 359 * Element count in @p ids and @p values. 360 * 361 * @return 362 * - A number of filled in stats. 363 * - A negative value on error. 364 */ 365 typedef int (*eth_xstats_get_by_id_t)(struct rte_eth_dev *dev, 366 const uint64_t *ids, 367 uint64_t *values, 368 unsigned int n); 369 370 /** 371 * @internal 372 * Reset extended stats of an Ethernet device. 373 * 374 * @param dev 375 * ethdev handle of port. 376 * 377 * @return 378 * Negative errno value on error, 0 on success. 379 * 380 * @retval 0 381 * Success, statistics has been reset. 382 * @retval -ENOTSUP 383 * Resetting statistics is not supported. 384 * @retval -EINVAL 385 * Resetting statistics is not valid. 386 * @retval -ENOMEM 387 * Not enough memory to get the stats. 388 */ 389 typedef int (*eth_xstats_reset_t)(struct rte_eth_dev *dev); 390 391 /** @internal Get names of extended stats of an Ethernet device. */ 392 typedef int (*eth_xstats_get_names_t)(struct rte_eth_dev *dev, 393 struct rte_eth_xstat_name *xstats_names, unsigned int size); 394 395 /** 396 * @internal 397 * Get names of extended stats of an Ethernet device. 398 * 399 * @param dev 400 * ethdev handle of port. 401 * @param ids 402 * IDs array to retrieve specific statistics. Must not be NULL. 403 * @param xstats_names 404 * An rte_eth_xstat_name array of at least @p size elements to be filled. 405 * Must not be NULL. 406 * @param size 407 * Element count in @p ids and @p xstats_names. 408 * 409 * @return 410 * - A number of filled in stats. 411 * - A negative value on error. 412 */ 413 typedef int (*eth_xstats_get_names_by_id_t)(struct rte_eth_dev *dev, 414 const uint64_t *ids, struct rte_eth_xstat_name *xstats_names, 415 unsigned int size); 416 417 /** 418 * @internal 419 * Set a queue statistics mapping for a Tx/Rx queue of an Ethernet device. 420 */ 421 typedef int (*eth_queue_stats_mapping_set_t)(struct rte_eth_dev *dev, 422 uint16_t queue_id, 423 uint8_t stat_idx, 424 uint8_t is_rx); 425 426 /** @internal Get specific information of an Ethernet device. */ 427 typedef int (*eth_dev_infos_get_t)(struct rte_eth_dev *dev, 428 struct rte_eth_dev_info *dev_info); 429 430 /** @internal Get supported ptypes of an Ethernet device. */ 431 typedef const uint32_t *(*eth_dev_supported_ptypes_get_t)(struct rte_eth_dev *dev); 432 433 /** 434 * @internal 435 * Inform Ethernet device about reduced range of packet types to handle. 436 * 437 * @param dev 438 * The Ethernet device identifier. 439 * @param ptype_mask 440 * The ptype family that application is interested in should be bitwise OR of 441 * RTE_PTYPE_*_MASK or 0. 442 * @return 443 * - (0) if Success. 444 */ 445 typedef int (*eth_dev_ptypes_set_t)(struct rte_eth_dev *dev, 446 uint32_t ptype_mask); 447 448 /** @internal Start Rx and Tx of a queue of an Ethernet device. */ 449 typedef int (*eth_queue_start_t)(struct rte_eth_dev *dev, 450 uint16_t queue_id); 451 452 /** @internal Stop Rx and Tx of a queue of an Ethernet device. */ 453 typedef int (*eth_queue_stop_t)(struct rte_eth_dev *dev, 454 uint16_t queue_id); 455 456 /** @internal Set up a receive queue of an Ethernet device. */ 457 typedef int (*eth_rx_queue_setup_t)(struct rte_eth_dev *dev, 458 uint16_t rx_queue_id, 459 uint16_t nb_rx_desc, 460 unsigned int socket_id, 461 const struct rte_eth_rxconf *rx_conf, 462 struct rte_mempool *mb_pool); 463 464 /** @internal Setup a transmit queue of an Ethernet device. */ 465 typedef int (*eth_tx_queue_setup_t)(struct rte_eth_dev *dev, 466 uint16_t tx_queue_id, 467 uint16_t nb_tx_desc, 468 unsigned int socket_id, 469 const struct rte_eth_txconf *tx_conf); 470 471 /** @internal Enable interrupt of a receive queue of an Ethernet device. */ 472 typedef int (*eth_rx_enable_intr_t)(struct rte_eth_dev *dev, 473 uint16_t rx_queue_id); 474 475 /** @internal Disable interrupt of a receive queue of an Ethernet device. */ 476 typedef int (*eth_rx_disable_intr_t)(struct rte_eth_dev *dev, 477 uint16_t rx_queue_id); 478 479 /** @internal Release memory resources allocated by given Rx/Tx queue. */ 480 typedef void (*eth_queue_release_t)(struct rte_eth_dev *dev, 481 uint16_t queue_id); 482 483 /** @internal Get firmware information of an Ethernet device. */ 484 typedef int (*eth_fw_version_get_t)(struct rte_eth_dev *dev, 485 char *fw_version, size_t fw_size); 486 487 /** @internal Force mbufs to be from Tx ring. */ 488 typedef int (*eth_tx_done_cleanup_t)(void *txq, uint32_t free_cnt); 489 490 typedef void (*eth_rxq_info_get_t)(struct rte_eth_dev *dev, 491 uint16_t rx_queue_id, struct rte_eth_rxq_info *qinfo); 492 493 typedef void (*eth_txq_info_get_t)(struct rte_eth_dev *dev, 494 uint16_t tx_queue_id, struct rte_eth_txq_info *qinfo); 495 496 typedef int (*eth_burst_mode_get_t)(struct rte_eth_dev *dev, 497 uint16_t queue_id, struct rte_eth_burst_mode *mode); 498 499 /** @internal Set MTU. */ 500 typedef int (*mtu_set_t)(struct rte_eth_dev *dev, uint16_t mtu); 501 502 /** @internal Filtering of a VLAN Tag Identifier by an Ethernet device. */ 503 typedef int (*vlan_filter_set_t)(struct rte_eth_dev *dev, 504 uint16_t vlan_id, 505 int on); 506 507 /** @internal Set the outer/inner VLAN-TPID by an Ethernet device. */ 508 typedef int (*vlan_tpid_set_t)(struct rte_eth_dev *dev, 509 enum rte_vlan_type type, uint16_t tpid); 510 511 /** @internal Set VLAN offload function by an Ethernet device. */ 512 typedef int (*vlan_offload_set_t)(struct rte_eth_dev *dev, int mask); 513 514 /** @internal Set port based Tx VLAN insertion by an Ethernet device. */ 515 typedef int (*vlan_pvid_set_t)(struct rte_eth_dev *dev, 516 uint16_t vlan_id, 517 int on); 518 519 /** @internal VLAN stripping enable/disable by an queue of Ethernet device. */ 520 typedef void (*vlan_strip_queue_set_t)(struct rte_eth_dev *dev, 521 uint16_t rx_queue_id, 522 int on); 523 524 /** @internal Get current flow control parameter on an Ethernet device. */ 525 typedef int (*flow_ctrl_get_t)(struct rte_eth_dev *dev, 526 struct rte_eth_fc_conf *fc_conf); 527 528 /** @internal Setup flow control parameter on an Ethernet device. */ 529 typedef int (*flow_ctrl_set_t)(struct rte_eth_dev *dev, 530 struct rte_eth_fc_conf *fc_conf); 531 532 /** @internal Setup priority flow control parameter on an Ethernet device. */ 533 typedef int (*priority_flow_ctrl_set_t)(struct rte_eth_dev *dev, 534 struct rte_eth_pfc_conf *pfc_conf); 535 536 /** @internal Get info for queue based PFC on an Ethernet device. */ 537 typedef int (*priority_flow_ctrl_queue_info_get_t)(struct rte_eth_dev *dev, 538 struct rte_eth_pfc_queue_info *pfc_queue_info); 539 /** @internal Configure queue based PFC parameter on an Ethernet device. */ 540 typedef int (*priority_flow_ctrl_queue_config_t)(struct rte_eth_dev *dev, 541 struct rte_eth_pfc_queue_conf *pfc_queue_conf); 542 543 /** @internal Update RSS redirection table on an Ethernet device. */ 544 typedef int (*reta_update_t)(struct rte_eth_dev *dev, 545 struct rte_eth_rss_reta_entry64 *reta_conf, 546 uint16_t reta_size); 547 548 /** @internal Query RSS redirection table on an Ethernet device. */ 549 typedef int (*reta_query_t)(struct rte_eth_dev *dev, 550 struct rte_eth_rss_reta_entry64 *reta_conf, 551 uint16_t reta_size); 552 553 /** @internal Update RSS hash configuration of an Ethernet device. */ 554 typedef int (*rss_hash_update_t)(struct rte_eth_dev *dev, 555 struct rte_eth_rss_conf *rss_conf); 556 557 /** @internal Get current RSS hash configuration of an Ethernet device. */ 558 typedef int (*rss_hash_conf_get_t)(struct rte_eth_dev *dev, 559 struct rte_eth_rss_conf *rss_conf); 560 561 /** @internal Turn on SW controllable LED on an Ethernet device. */ 562 typedef int (*eth_dev_led_on_t)(struct rte_eth_dev *dev); 563 564 /** @internal Turn off SW controllable LED on an Ethernet device. */ 565 typedef int (*eth_dev_led_off_t)(struct rte_eth_dev *dev); 566 567 /** @internal Remove MAC address from receive address register. */ 568 typedef void (*eth_mac_addr_remove_t)(struct rte_eth_dev *dev, uint32_t index); 569 570 /** @internal Set a MAC address into Receive Address Register. */ 571 typedef int (*eth_mac_addr_add_t)(struct rte_eth_dev *dev, 572 struct rte_ether_addr *mac_addr, 573 uint32_t index, 574 uint32_t vmdq); 575 576 /** @internal Set a MAC address into Receive Address Register. */ 577 typedef int (*eth_mac_addr_set_t)(struct rte_eth_dev *dev, 578 struct rte_ether_addr *mac_addr); 579 580 /** @internal Set a Unicast Hash bitmap. */ 581 typedef int (*eth_uc_hash_table_set_t)(struct rte_eth_dev *dev, 582 struct rte_ether_addr *mac_addr, 583 uint8_t on); 584 585 /** @internal Set all Unicast Hash bitmap. */ 586 typedef int (*eth_uc_all_hash_table_set_t)(struct rte_eth_dev *dev, 587 uint8_t on); 588 589 /** @internal Set queue Tx rate. */ 590 typedef int (*eth_set_queue_rate_limit_t)(struct rte_eth_dev *dev, 591 uint16_t queue_idx, 592 uint16_t tx_rate); 593 594 /** @internal Add tunneling UDP port. */ 595 typedef int (*eth_udp_tunnel_port_add_t)(struct rte_eth_dev *dev, 596 struct rte_eth_udp_tunnel *tunnel_udp); 597 598 /** @internal Delete tunneling UDP port. */ 599 typedef int (*eth_udp_tunnel_port_del_t)(struct rte_eth_dev *dev, 600 struct rte_eth_udp_tunnel *tunnel_udp); 601 602 /** @internal set the list of multicast addresses on an Ethernet device. */ 603 typedef int (*eth_set_mc_addr_list_t)(struct rte_eth_dev *dev, 604 struct rte_ether_addr *mc_addr_set, 605 uint32_t nb_mc_addr); 606 607 /** @internal Function used to enable IEEE1588/802.1AS timestamping. */ 608 typedef int (*eth_timesync_enable_t)(struct rte_eth_dev *dev); 609 610 /** @internal Function used to disable IEEE1588/802.1AS timestamping. */ 611 typedef int (*eth_timesync_disable_t)(struct rte_eth_dev *dev); 612 613 /** @internal Function used to read an Rx IEEE1588/802.1AS timestamp. */ 614 typedef int (*eth_timesync_read_rx_timestamp_t)(struct rte_eth_dev *dev, 615 struct timespec *timestamp, 616 uint32_t flags); 617 618 /** @internal Function used to read a Tx IEEE1588/802.1AS timestamp. */ 619 typedef int (*eth_timesync_read_tx_timestamp_t)(struct rte_eth_dev *dev, 620 struct timespec *timestamp); 621 622 /** @internal Function used to adjust the device clock. */ 623 typedef int (*eth_timesync_adjust_time)(struct rte_eth_dev *dev, int64_t); 624 625 /** @internal Function used to get time from the device clock. */ 626 typedef int (*eth_timesync_read_time)(struct rte_eth_dev *dev, 627 struct timespec *timestamp); 628 629 /** @internal Function used to get time from the device clock. */ 630 typedef int (*eth_timesync_write_time)(struct rte_eth_dev *dev, 631 const struct timespec *timestamp); 632 633 /** @internal Function used to get the current value of the device clock. */ 634 typedef int (*eth_read_clock)(struct rte_eth_dev *dev, 635 uint64_t *timestamp); 636 637 /** @internal Retrieve registers. */ 638 typedef int (*eth_get_reg_t)(struct rte_eth_dev *dev, 639 struct rte_dev_reg_info *info); 640 641 /** @internal Retrieve EEPROM size. */ 642 typedef int (*eth_get_eeprom_length_t)(struct rte_eth_dev *dev); 643 644 /** @internal Retrieve EEPROM data. */ 645 typedef int (*eth_get_eeprom_t)(struct rte_eth_dev *dev, 646 struct rte_dev_eeprom_info *info); 647 648 /** @internal Program EEPROM data. */ 649 typedef int (*eth_set_eeprom_t)(struct rte_eth_dev *dev, 650 struct rte_dev_eeprom_info *info); 651 652 /** @internal Retrieve type and size of plugin module EEPROM. */ 653 typedef int (*eth_get_module_info_t)(struct rte_eth_dev *dev, 654 struct rte_eth_dev_module_info *modinfo); 655 656 /** @internal Retrieve plugin module EEPROM data. */ 657 typedef int (*eth_get_module_eeprom_t)(struct rte_eth_dev *dev, 658 struct rte_dev_eeprom_info *info); 659 660 struct rte_flow_ops; 661 /** 662 * @internal 663 * Get flow operations. 664 * 665 * If the flow API is not supported for the specified device, 666 * the driver can return NULL. 667 */ 668 typedef int (*eth_flow_ops_get_t)(struct rte_eth_dev *dev, 669 const struct rte_flow_ops **ops); 670 671 /** @internal Get Traffic Management (TM) operations on an Ethernet device. */ 672 typedef int (*eth_tm_ops_get_t)(struct rte_eth_dev *dev, void *ops); 673 674 /** @internal Get Traffic Metering and Policing (MTR) operations. */ 675 typedef int (*eth_mtr_ops_get_t)(struct rte_eth_dev *dev, void *ops); 676 677 /** @internal Get DCB information on an Ethernet device. */ 678 typedef int (*eth_get_dcb_info)(struct rte_eth_dev *dev, 679 struct rte_eth_dcb_info *dcb_info); 680 681 /** @internal Test if a port supports specific mempool ops. */ 682 typedef int (*eth_pool_ops_supported_t)(struct rte_eth_dev *dev, 683 const char *pool); 684 685 /** 686 * @internal 687 * Get the hairpin capabilities. 688 * 689 * @param dev 690 * ethdev handle of port. 691 * @param cap 692 * returns the hairpin capabilities from the device. 693 * 694 * @return 695 * Negative errno value on error, 0 on success. 696 * 697 * @retval 0 698 * Success, hairpin is supported. 699 * @retval -ENOTSUP 700 * Hairpin is not supported. 701 */ 702 typedef int (*eth_hairpin_cap_get_t)(struct rte_eth_dev *dev, 703 struct rte_eth_hairpin_cap *cap); 704 705 /** 706 * @internal 707 * Setup Rx hairpin queue. 708 * 709 * @param dev 710 * ethdev handle of port. 711 * @param rx_queue_id 712 * the selected Rx queue index. 713 * @param nb_rx_desc 714 * the requested number of descriptors for this queue. 0 - use PMD default. 715 * @param conf 716 * the Rx hairpin configuration structure. 717 * 718 * @return 719 * Negative errno value on error, 0 on success. 720 * 721 * @retval 0 722 * Success, hairpin is supported. 723 * @retval -ENOTSUP 724 * Hairpin is not supported. 725 * @retval -EINVAL 726 * One of the parameters is invalid. 727 * @retval -ENOMEM 728 * Unable to allocate resources. 729 */ 730 typedef int (*eth_rx_hairpin_queue_setup_t) 731 (struct rte_eth_dev *dev, uint16_t rx_queue_id, 732 uint16_t nb_rx_desc, 733 const struct rte_eth_hairpin_conf *conf); 734 735 /** 736 * @internal 737 * Setup Tx hairpin queue. 738 * 739 * @param dev 740 * ethdev handle of port. 741 * @param tx_queue_id 742 * the selected Tx queue index. 743 * @param nb_tx_desc 744 * the requested number of descriptors for this queue. 0 - use PMD default. 745 * @param conf 746 * the Tx hairpin configuration structure. 747 * 748 * @return 749 * Negative errno value on error, 0 on success. 750 * 751 * @retval 0 752 * Success, hairpin is supported. 753 * @retval -ENOTSUP 754 * Hairpin is not supported. 755 * @retval -EINVAL 756 * One of the parameters is invalid. 757 * @retval -ENOMEM 758 * Unable to allocate resources. 759 */ 760 typedef int (*eth_tx_hairpin_queue_setup_t) 761 (struct rte_eth_dev *dev, uint16_t tx_queue_id, 762 uint16_t nb_tx_desc, 763 const struct rte_eth_hairpin_conf *hairpin_conf); 764 765 /** 766 * @internal 767 * Get Forward Error Correction(FEC) capability. 768 * 769 * @param dev 770 * ethdev handle of port. 771 * @param speed_fec_capa 772 * speed_fec_capa is out only with per-speed capabilities. 773 * @param num 774 * a number of elements in an speed_fec_capa array. 775 * 776 * @return 777 * Negative errno value on error, positive value on success. 778 * 779 * @retval positive value 780 * A non-negative value lower or equal to num: success. The return value 781 * is the number of entries filled in the fec capa array. 782 * A non-negative value higher than num: error, the given fec capa array 783 * is too small. The return value corresponds to the num that should 784 * be given to succeed. The entries in the fec capa array are not valid 785 * and shall not be used by the caller. 786 * @retval -ENOTSUP 787 * Operation is not supported. 788 * @retval -EIO 789 * Device is removed. 790 * @retval -EINVAL 791 * *num* or *speed_fec_capa* invalid. 792 */ 793 typedef int (*eth_fec_get_capability_t)(struct rte_eth_dev *dev, 794 struct rte_eth_fec_capa *speed_fec_capa, unsigned int num); 795 796 /** 797 * @internal 798 * Get Forward Error Correction(FEC) mode. 799 * 800 * @param dev 801 * ethdev handle of port. 802 * @param fec_capa 803 * a bitmask of enabled FEC modes. If AUTO bit is set, other 804 * bits specify FEC modes which may be negotiated. If AUTO 805 * bit is clear, specify FEC modes to be used (only one valid 806 * mode per speed may be set). 807 * 808 * @return 809 * Negative errno value on error, 0 on success. 810 * 811 * @retval 0 812 * Success, get FEC success. 813 * @retval -ENOTSUP 814 * Operation is not supported. 815 * @retval -EIO 816 * Device is removed. 817 */ 818 typedef int (*eth_fec_get_t)(struct rte_eth_dev *dev, 819 uint32_t *fec_capa); 820 821 /** 822 * @internal 823 * Set Forward Error Correction(FEC) mode. 824 * 825 * @param dev 826 * ethdev handle of port. 827 * @param fec_capa 828 * bitmask of allowed FEC modes. It must be only one 829 * if AUTO is disabled. If AUTO is enabled, other 830 * bits specify FEC modes which may be negotiated. 831 * 832 * @return 833 * Negative errno value on error, 0 on success. 834 * 835 * @retval 0 836 * Success, set FEC success. 837 * @retval -ENOTSUP 838 * Operation is not supported. 839 * @retval -EINVAL 840 * Unsupported FEC mode requested. 841 * @retval -EIO 842 * Device is removed. 843 */ 844 typedef int (*eth_fec_set_t)(struct rte_eth_dev *dev, uint32_t fec_capa); 845 846 /** 847 * @internal 848 * Get all hairpin Tx/Rx peer ports of the current device, if any. 849 * 850 * @param dev 851 * ethdev handle of port. 852 * @param peer_ports 853 * array to save the ports list. 854 * @param len 855 * array length. 856 * @param direction 857 * value to decide the current to peer direction 858 * positive - used as Tx to get all peer Rx ports. 859 * zero - used as Rx to get all peer Tx ports. 860 * 861 * @return 862 * Negative errno value on error, 0 or positive on success. 863 * 864 * @retval 0 865 * Success, no peer ports. 866 * @retval >0 867 * Actual number of the peer ports. 868 * @retval -ENOTSUP 869 * Get peer ports API is not supported. 870 * @retval -EINVAL 871 * One of the parameters is invalid. 872 */ 873 typedef int (*hairpin_get_peer_ports_t)(struct rte_eth_dev *dev, 874 uint16_t *peer_ports, size_t len, 875 uint32_t direction); 876 877 /** 878 * @internal 879 * Bind all hairpin Tx queues of one port to the Rx queues of the peer port. 880 * 881 * @param dev 882 * ethdev handle of port. 883 * @param rx_port 884 * the peer Rx port. 885 * 886 * @return 887 * Negative errno value on error, 0 on success. 888 * 889 * @retval 0 890 * Success, bind successfully. 891 * @retval -ENOTSUP 892 * Bind API is not supported. 893 * @retval -EINVAL 894 * One of the parameters is invalid. 895 * @retval -EBUSY 896 * Device is not started. 897 */ 898 typedef int (*eth_hairpin_bind_t)(struct rte_eth_dev *dev, 899 uint16_t rx_port); 900 901 /** 902 * @internal 903 * Unbind all hairpin Tx queues of one port from the Rx queues of the peer port. 904 * 905 * @param dev 906 * ethdev handle of port. 907 * @param rx_port 908 * the peer Rx port. 909 * 910 * @return 911 * Negative errno value on error, 0 on success. 912 * 913 * @retval 0 914 * Success, unbind successfully. 915 * @retval -ENOTSUP 916 * Bind API is not supported. 917 * @retval -EINVAL 918 * One of the parameters is invalid. 919 * @retval -EBUSY 920 * Device is already stopped. 921 */ 922 typedef int (*eth_hairpin_unbind_t)(struct rte_eth_dev *dev, 923 uint16_t rx_port); 924 925 /** @internal Update and fetch peer queue information. */ 926 typedef int (*eth_hairpin_queue_peer_update_t) 927 (struct rte_eth_dev *dev, uint16_t peer_queue, 928 struct rte_hairpin_peer_info *current_info, 929 struct rte_hairpin_peer_info *peer_info, uint32_t direction); 930 931 /** @internal Bind peer queue to the current queue with fetched information. */ 932 typedef int (*eth_hairpin_queue_peer_bind_t) 933 (struct rte_eth_dev *dev, uint16_t cur_queue, 934 struct rte_hairpin_peer_info *peer_info, uint32_t direction); 935 936 /** @internal Unbind peer queue from the current queue. */ 937 typedef int (*eth_hairpin_queue_peer_unbind_t) 938 (struct rte_eth_dev *dev, uint16_t cur_queue, uint32_t direction); 939 940 /** 941 * @internal 942 * Get address of memory location whose contents will change whenever there is 943 * new data to be received on an Rx queue. 944 * 945 * @param rxq 946 * Ethdev queue pointer. 947 * @param pmc 948 * The pointer to power-optimized monitoring condition structure. 949 * @return 950 * Negative errno value on error, 0 on success. 951 * 952 * @retval 0 953 * Success 954 * @retval -EINVAL 955 * Invalid parameters 956 */ 957 typedef int (*eth_get_monitor_addr_t)(void *rxq, 958 struct rte_power_monitor_cond *pmc); 959 960 /** 961 * @internal 962 * Get representor info to be able to calculate the unique representor ID. 963 * 964 * Caller should pass NULL as pointer of info to get number of entries, 965 * allocate info buffer according to returned entry number, then call 966 * again with buffer to get real info. 967 * 968 * To calculate the representor ID, caller should iterate each entry, 969 * match controller index, pf index, vf or sf start index and range, 970 * then calculate representor ID from offset to vf/sf start index. 971 * @see rte_eth_representor_id_get. 972 * 973 * @param dev 974 * Ethdev handle of port. 975 * @param [out] info 976 * Pointer to memory to save device representor info. 977 * @return 978 * Negative errno value on error, number of info entries otherwise. 979 */ 980 981 typedef int (*eth_representor_info_get_t)(struct rte_eth_dev *dev, 982 struct rte_eth_representor_info *info); 983 984 /** 985 * @internal 986 * Negotiate the NIC's ability to deliver specific kinds of metadata to the PMD. 987 * 988 * @param dev 989 * Port (ethdev) handle 990 * 991 * @param[inout] features 992 * Feature selection buffer 993 * 994 * @return 995 * Negative errno value on error, zero otherwise 996 */ 997 typedef int (*eth_rx_metadata_negotiate_t)(struct rte_eth_dev *dev, 998 uint64_t *features); 999 1000 /** 1001 * @internal 1002 * Get IP reassembly offload capability of a PMD. 1003 * 1004 * @param dev 1005 * Port (ethdev) handle 1006 * 1007 * @param[out] conf 1008 * IP reassembly capability supported by the PMD 1009 * 1010 * @return 1011 * Negative errno value on error, zero otherwise 1012 */ 1013 typedef int (*eth_ip_reassembly_capability_get_t)(struct rte_eth_dev *dev, 1014 struct rte_eth_ip_reassembly_params *capa); 1015 1016 /** 1017 * @internal 1018 * Get IP reassembly offload configuration parameters set in PMD. 1019 * 1020 * @param dev 1021 * Port (ethdev) handle 1022 * 1023 * @param[out] conf 1024 * Configuration parameters for IP reassembly. 1025 * 1026 * @return 1027 * Negative errno value on error, zero otherwise 1028 */ 1029 typedef int (*eth_ip_reassembly_conf_get_t)(struct rte_eth_dev *dev, 1030 struct rte_eth_ip_reassembly_params *conf); 1031 1032 /** 1033 * @internal 1034 * Set configuration parameters for enabling IP reassembly offload in hardware. 1035 * 1036 * @param dev 1037 * Port (ethdev) handle 1038 * 1039 * @param[in] conf 1040 * Configuration parameters for IP reassembly. 1041 * 1042 * @return 1043 * Negative errno value on error, zero otherwise 1044 */ 1045 typedef int (*eth_ip_reassembly_conf_set_t)(struct rte_eth_dev *dev, 1046 const struct rte_eth_ip_reassembly_params *conf); 1047 1048 /** 1049 * @internal A structure containing the functions exported by an Ethernet driver. 1050 */ 1051 struct eth_dev_ops { 1052 eth_dev_configure_t dev_configure; /**< Configure device */ 1053 eth_dev_start_t dev_start; /**< Start device */ 1054 eth_dev_stop_t dev_stop; /**< Stop device */ 1055 eth_dev_set_link_up_t dev_set_link_up; /**< Device link up */ 1056 eth_dev_set_link_down_t dev_set_link_down; /**< Device link down */ 1057 eth_dev_close_t dev_close; /**< Close device */ 1058 eth_dev_reset_t dev_reset; /**< Reset device */ 1059 eth_link_update_t link_update; /**< Get device link state */ 1060 /** Check if the device was physically removed */ 1061 eth_is_removed_t is_removed; 1062 1063 eth_promiscuous_enable_t promiscuous_enable; /**< Promiscuous ON */ 1064 eth_promiscuous_disable_t promiscuous_disable;/**< Promiscuous OFF */ 1065 eth_allmulticast_enable_t allmulticast_enable;/**< Rx multicast ON */ 1066 eth_allmulticast_disable_t allmulticast_disable;/**< Rx multicast OFF */ 1067 eth_mac_addr_remove_t mac_addr_remove; /**< Remove MAC address */ 1068 eth_mac_addr_add_t mac_addr_add; /**< Add a MAC address */ 1069 eth_mac_addr_set_t mac_addr_set; /**< Set a MAC address */ 1070 /** Set list of multicast addresses */ 1071 eth_set_mc_addr_list_t set_mc_addr_list; 1072 mtu_set_t mtu_set; /**< Set MTU */ 1073 1074 /** Get generic device statistics */ 1075 eth_stats_get_t stats_get; 1076 /** Reset generic device statistics */ 1077 eth_stats_reset_t stats_reset; 1078 /** Get extended device statistics */ 1079 eth_xstats_get_t xstats_get; 1080 /** Reset extended device statistics */ 1081 eth_xstats_reset_t xstats_reset; 1082 /** Get names of extended statistics */ 1083 eth_xstats_get_names_t xstats_get_names; 1084 /** Configure per queue stat counter mapping */ 1085 eth_queue_stats_mapping_set_t queue_stats_mapping_set; 1086 1087 eth_dev_infos_get_t dev_infos_get; /**< Get device info */ 1088 /** Retrieve Rx queue information */ 1089 eth_rxq_info_get_t rxq_info_get; 1090 /** Retrieve Tx queue information */ 1091 eth_txq_info_get_t txq_info_get; 1092 eth_burst_mode_get_t rx_burst_mode_get; /**< Get Rx burst mode */ 1093 eth_burst_mode_get_t tx_burst_mode_get; /**< Get Tx burst mode */ 1094 eth_fw_version_get_t fw_version_get; /**< Get firmware version */ 1095 1096 /** Get packet types supported and identified by device */ 1097 eth_dev_supported_ptypes_get_t dev_supported_ptypes_get; 1098 /** 1099 * Inform Ethernet device about reduced range of packet types to 1100 * handle 1101 */ 1102 eth_dev_ptypes_set_t dev_ptypes_set; 1103 1104 /** Filter VLAN Setup */ 1105 vlan_filter_set_t vlan_filter_set; 1106 /** Outer/Inner VLAN TPID Setup */ 1107 vlan_tpid_set_t vlan_tpid_set; 1108 /** VLAN Stripping on queue */ 1109 vlan_strip_queue_set_t vlan_strip_queue_set; 1110 /** Set VLAN Offload */ 1111 vlan_offload_set_t vlan_offload_set; 1112 /** Set port based Tx VLAN insertion */ 1113 vlan_pvid_set_t vlan_pvid_set; 1114 1115 eth_queue_start_t rx_queue_start;/**< Start Rx for a queue */ 1116 eth_queue_stop_t rx_queue_stop; /**< Stop Rx for a queue */ 1117 eth_queue_start_t tx_queue_start;/**< Start Tx for a queue */ 1118 eth_queue_stop_t tx_queue_stop; /**< Stop Tx for a queue */ 1119 eth_rx_queue_setup_t rx_queue_setup;/**< Set up device Rx queue */ 1120 eth_queue_release_t rx_queue_release; /**< Release Rx queue */ 1121 1122 /** Enable Rx queue interrupt */ 1123 eth_rx_enable_intr_t rx_queue_intr_enable; 1124 /** Disable Rx queue interrupt */ 1125 eth_rx_disable_intr_t rx_queue_intr_disable; 1126 1127 eth_tx_queue_setup_t tx_queue_setup;/**< Set up device Tx queue */ 1128 eth_queue_release_t tx_queue_release; /**< Release Tx queue */ 1129 eth_tx_done_cleanup_t tx_done_cleanup;/**< Free Tx ring mbufs */ 1130 1131 eth_dev_led_on_t dev_led_on; /**< Turn on LED */ 1132 eth_dev_led_off_t dev_led_off; /**< Turn off LED */ 1133 1134 flow_ctrl_get_t flow_ctrl_get; /**< Get flow control */ 1135 flow_ctrl_set_t flow_ctrl_set; /**< Setup flow control */ 1136 /** Setup priority flow control */ 1137 priority_flow_ctrl_set_t priority_flow_ctrl_set; 1138 /** Priority flow control queue info get */ 1139 priority_flow_ctrl_queue_info_get_t priority_flow_ctrl_queue_info_get; 1140 /** Priority flow control queue configure */ 1141 priority_flow_ctrl_queue_config_t priority_flow_ctrl_queue_config; 1142 1143 /** Set Unicast Table Array */ 1144 eth_uc_hash_table_set_t uc_hash_table_set; 1145 /** Set Unicast hash bitmap */ 1146 eth_uc_all_hash_table_set_t uc_all_hash_table_set; 1147 1148 /** Add UDP tunnel port */ 1149 eth_udp_tunnel_port_add_t udp_tunnel_port_add; 1150 /** Delete UDP tunnel port */ 1151 eth_udp_tunnel_port_del_t udp_tunnel_port_del; 1152 1153 /** Set queue rate limit */ 1154 eth_set_queue_rate_limit_t set_queue_rate_limit; 1155 1156 /** Configure RSS hash protocols and hashing key */ 1157 rss_hash_update_t rss_hash_update; 1158 /** Get current RSS hash configuration */ 1159 rss_hash_conf_get_t rss_hash_conf_get; 1160 /** Update redirection table */ 1161 reta_update_t reta_update; 1162 /** Query redirection table */ 1163 reta_query_t reta_query; 1164 1165 eth_get_reg_t get_reg; /**< Get registers */ 1166 eth_get_eeprom_length_t get_eeprom_length; /**< Get EEPROM length */ 1167 eth_get_eeprom_t get_eeprom; /**< Get EEPROM data */ 1168 eth_set_eeprom_t set_eeprom; /**< Set EEPROM */ 1169 1170 /** Get plugin module EEPROM attribute */ 1171 eth_get_module_info_t get_module_info; 1172 /** Get plugin module EEPROM data */ 1173 eth_get_module_eeprom_t get_module_eeprom; 1174 1175 eth_flow_ops_get_t flow_ops_get; /**< Get flow operations */ 1176 1177 eth_get_dcb_info get_dcb_info; /**< Get DCB information */ 1178 1179 /** Turn IEEE1588/802.1AS timestamping on */ 1180 eth_timesync_enable_t timesync_enable; 1181 /** Turn IEEE1588/802.1AS timestamping off */ 1182 eth_timesync_disable_t timesync_disable; 1183 /** Read the IEEE1588/802.1AS Rx timestamp */ 1184 eth_timesync_read_rx_timestamp_t timesync_read_rx_timestamp; 1185 /** Read the IEEE1588/802.1AS Tx timestamp */ 1186 eth_timesync_read_tx_timestamp_t timesync_read_tx_timestamp; 1187 /** Adjust the device clock */ 1188 eth_timesync_adjust_time timesync_adjust_time; 1189 /** Get the device clock time */ 1190 eth_timesync_read_time timesync_read_time; 1191 /** Set the device clock time */ 1192 eth_timesync_write_time timesync_write_time; 1193 1194 eth_read_clock read_clock; 1195 1196 /** Get extended device statistic values by ID */ 1197 eth_xstats_get_by_id_t xstats_get_by_id; 1198 /** Get name of extended device statistics by ID */ 1199 eth_xstats_get_names_by_id_t xstats_get_names_by_id; 1200 1201 /** Get Traffic Management (TM) operations */ 1202 eth_tm_ops_get_t tm_ops_get; 1203 1204 /** Get Traffic Metering and Policing (MTR) operations */ 1205 eth_mtr_ops_get_t mtr_ops_get; 1206 1207 /** Test if a port supports specific mempool ops */ 1208 eth_pool_ops_supported_t pool_ops_supported; 1209 1210 /** Returns the hairpin capabilities */ 1211 eth_hairpin_cap_get_t hairpin_cap_get; 1212 /** Set up device Rx hairpin queue */ 1213 eth_rx_hairpin_queue_setup_t rx_hairpin_queue_setup; 1214 /** Set up device Tx hairpin queue */ 1215 eth_tx_hairpin_queue_setup_t tx_hairpin_queue_setup; 1216 1217 /** Get Forward Error Correction(FEC) capability */ 1218 eth_fec_get_capability_t fec_get_capability; 1219 /** Get Forward Error Correction(FEC) mode */ 1220 eth_fec_get_t fec_get; 1221 /** Set Forward Error Correction(FEC) mode */ 1222 eth_fec_set_t fec_set; 1223 1224 /** Get hairpin peer ports list */ 1225 hairpin_get_peer_ports_t hairpin_get_peer_ports; 1226 /** Bind all hairpin Tx queues of device to the peer port Rx queues */ 1227 eth_hairpin_bind_t hairpin_bind; 1228 /** Unbind all hairpin Tx queues from the peer port Rx queues */ 1229 eth_hairpin_unbind_t hairpin_unbind; 1230 /** Pass the current queue info and get the peer queue info */ 1231 eth_hairpin_queue_peer_update_t hairpin_queue_peer_update; 1232 /** Set up the connection between the pair of hairpin queues */ 1233 eth_hairpin_queue_peer_bind_t hairpin_queue_peer_bind; 1234 /** Disconnect the hairpin queues of a pair from each other */ 1235 eth_hairpin_queue_peer_unbind_t hairpin_queue_peer_unbind; 1236 1237 /** Get power monitoring condition for Rx queue */ 1238 eth_get_monitor_addr_t get_monitor_addr; 1239 1240 /** Get representor info */ 1241 eth_representor_info_get_t representor_info_get; 1242 1243 /** 1244 * Negotiate the NIC's ability to deliver specific 1245 * kinds of metadata to the PMD 1246 */ 1247 eth_rx_metadata_negotiate_t rx_metadata_negotiate; 1248 1249 /** Get IP reassembly capability */ 1250 eth_ip_reassembly_capability_get_t ip_reassembly_capability_get; 1251 /** Get IP reassembly configuration */ 1252 eth_ip_reassembly_conf_get_t ip_reassembly_conf_get; 1253 /** Set IP reassembly configuration */ 1254 eth_ip_reassembly_conf_set_t ip_reassembly_conf_set; 1255 }; 1256 1257 /** 1258 * @internal 1259 * Check if the selected Rx queue is hairpin queue. 1260 * 1261 * @param dev 1262 * Pointer to the selected device. 1263 * @param queue_id 1264 * The selected queue. 1265 * 1266 * @return 1267 * - (1) if the queue is hairpin queue, 0 otherwise. 1268 */ 1269 __rte_internal 1270 int rte_eth_dev_is_rx_hairpin_queue(struct rte_eth_dev *dev, uint16_t queue_id); 1271 1272 /** 1273 * @internal 1274 * Check if the selected Tx queue is hairpin queue. 1275 * 1276 * @param dev 1277 * Pointer to the selected device. 1278 * @param queue_id 1279 * The selected queue. 1280 * 1281 * @return 1282 * - (1) if the queue is hairpin queue, 0 otherwise. 1283 */ 1284 __rte_internal 1285 int rte_eth_dev_is_tx_hairpin_queue(struct rte_eth_dev *dev, uint16_t queue_id); 1286 1287 /** 1288 * @internal 1289 * Returns a ethdev slot specified by the unique identifier name. 1290 * 1291 * @param name 1292 * The pointer to the Unique identifier name for each Ethernet device 1293 * @return 1294 * - The pointer to the ethdev slot, on success. NULL on error 1295 */ 1296 __rte_internal 1297 struct rte_eth_dev *rte_eth_dev_allocated(const char *name); 1298 1299 /** 1300 * @internal 1301 * Allocates a new ethdev slot for an Ethernet device and returns the pointer 1302 * to that slot for the driver to use. 1303 * 1304 * @param name Unique identifier name for each Ethernet device 1305 * @return 1306 * - Slot in the rte_dev_devices array for a new device; 1307 */ 1308 __rte_internal 1309 struct rte_eth_dev *rte_eth_dev_allocate(const char *name); 1310 1311 /** 1312 * @internal 1313 * Attach to the ethdev already initialized by the primary 1314 * process. 1315 * 1316 * @param name Ethernet device's name. 1317 * @return 1318 * - Success: Slot in the rte_dev_devices array for attached 1319 * device. 1320 * - Error: Null pointer. 1321 */ 1322 __rte_internal 1323 struct rte_eth_dev *rte_eth_dev_attach_secondary(const char *name); 1324 1325 /** 1326 * @internal 1327 * Notify RTE_ETH_EVENT_DESTROY and release the specified ethdev port. 1328 * 1329 * The following PMD-managed data fields will be freed: 1330 * - dev_private 1331 * - mac_addrs 1332 * - hash_mac_addrs 1333 * If one of these fields should not be freed, 1334 * it must be reset to NULL by the PMD, typically in dev_close method. 1335 * 1336 * @param eth_dev 1337 * Device to be detached. 1338 * @return 1339 * - 0 on success, negative on error 1340 */ 1341 __rte_internal 1342 int rte_eth_dev_release_port(struct rte_eth_dev *eth_dev); 1343 1344 /** 1345 * @internal 1346 * Release device queues and clear its configuration to force the user 1347 * application to reconfigure it. It is for internal use only. 1348 * 1349 * @param dev 1350 * Pointer to struct rte_eth_dev. 1351 * 1352 * @return 1353 * void 1354 */ 1355 __rte_internal 1356 void rte_eth_dev_internal_reset(struct rte_eth_dev *dev); 1357 1358 /** 1359 * @internal Executes all the user application registered callbacks for 1360 * the specific device. It is for DPDK internal user only. User 1361 * application should not call it directly. 1362 * 1363 * @param dev 1364 * Pointer to struct rte_eth_dev. 1365 * @param event 1366 * Eth device interrupt event type. 1367 * @param ret_param 1368 * To pass data back to user application. 1369 * This allows the user application to decide if a particular function 1370 * is permitted or not. 1371 * 1372 * @return 1373 * int 1374 */ 1375 __rte_internal 1376 int rte_eth_dev_callback_process(struct rte_eth_dev *dev, 1377 enum rte_eth_event_type event, void *ret_param); 1378 1379 /** 1380 * @internal 1381 * This is the last step of device probing. 1382 * It must be called after a port is allocated and initialized successfully. 1383 * 1384 * The notification RTE_ETH_EVENT_NEW is sent to other entities 1385 * (libraries and applications). 1386 * The state is set as RTE_ETH_DEV_ATTACHED. 1387 * 1388 * @param dev 1389 * New ethdev port. 1390 */ 1391 __rte_internal 1392 void rte_eth_dev_probing_finish(struct rte_eth_dev *dev); 1393 1394 /** 1395 * Create memzone for HW rings. 1396 * malloc can't be used as the physical address is needed. 1397 * If the memzone is already created, then this function returns a ptr 1398 * to the old one. 1399 * 1400 * @param eth_dev 1401 * The *eth_dev* pointer is the address of the *rte_eth_dev* structure 1402 * @param name 1403 * The name of the memory zone 1404 * @param queue_id 1405 * The index of the queue to add to name 1406 * @param size 1407 * The sizeof of the memory area 1408 * @param align 1409 * Alignment for resulting memzone. Must be a power of 2. 1410 * @param socket_id 1411 * The *socket_id* argument is the socket identifier in case of NUMA. 1412 */ 1413 __rte_internal 1414 const struct rte_memzone * 1415 rte_eth_dma_zone_reserve(const struct rte_eth_dev *eth_dev, const char *name, 1416 uint16_t queue_id, size_t size, 1417 unsigned align, int socket_id); 1418 1419 /** 1420 * Free previously allocated memzone for HW rings. 1421 * 1422 * @param eth_dev 1423 * The *eth_dev* pointer is the address of the *rte_eth_dev* structure 1424 * @param name 1425 * The name of the memory zone 1426 * @param queue_id 1427 * The index of the queue to add to name 1428 * @return 1429 * Negative errno value on error, 0 on success. 1430 */ 1431 __rte_internal 1432 int 1433 rte_eth_dma_zone_free(const struct rte_eth_dev *eth_dev, const char *name, 1434 uint16_t queue_id); 1435 1436 /** 1437 * @internal 1438 * Atomically set the link status for the specific device. 1439 * It is for use by DPDK device driver use only. 1440 * User applications should not call it 1441 * 1442 * @param dev 1443 * Pointer to struct rte_eth_dev. 1444 * @param link 1445 * New link status value. 1446 * @return 1447 * Same convention as eth_link_update operation. 1448 * 0 if link up status has changed 1449 * -1 if link up status was unchanged 1450 */ 1451 static inline int 1452 rte_eth_linkstatus_set(struct rte_eth_dev *dev, 1453 const struct rte_eth_link *new_link) 1454 { 1455 uint64_t *dev_link = (uint64_t *)&(dev->data->dev_link); 1456 union { 1457 uint64_t val64; 1458 struct rte_eth_link link; 1459 } orig; 1460 1461 RTE_BUILD_BUG_ON(sizeof(*new_link) != sizeof(uint64_t)); 1462 1463 orig.val64 = __atomic_exchange_n(dev_link, *(const uint64_t *)new_link, 1464 __ATOMIC_SEQ_CST); 1465 1466 return (orig.link.link_status == new_link->link_status) ? -1 : 0; 1467 } 1468 1469 /** 1470 * @internal 1471 * Atomically get the link speed and status. 1472 * 1473 * @param dev 1474 * Pointer to struct rte_eth_dev. 1475 * @param link 1476 * link status value. 1477 */ 1478 static inline void 1479 rte_eth_linkstatus_get(const struct rte_eth_dev *dev, 1480 struct rte_eth_link *link) 1481 { 1482 uint64_t *src = (uint64_t *)&(dev->data->dev_link); 1483 uint64_t *dst = (uint64_t *)link; 1484 1485 RTE_BUILD_BUG_ON(sizeof(*link) != sizeof(uint64_t)); 1486 1487 *dst = __atomic_load_n(src, __ATOMIC_SEQ_CST); 1488 } 1489 1490 /** 1491 * Allocate an unique switch domain identifier. 1492 * 1493 * A pool of switch domain identifiers which can be allocated on request. This 1494 * will enabled devices which support the concept of switch domains to request 1495 * a switch domain ID which is guaranteed to be unique from other devices 1496 * running in the same process. 1497 * 1498 * @param domain_id 1499 * switch domain identifier parameter to pass back to application 1500 * 1501 * @return 1502 * Negative errno value on error, 0 on success. 1503 */ 1504 __rte_internal 1505 int 1506 rte_eth_switch_domain_alloc(uint16_t *domain_id); 1507 1508 /** 1509 * Free switch domain. 1510 * 1511 * Return a switch domain identifier to the pool of free identifiers after it is 1512 * no longer in use by device. 1513 * 1514 * @param domain_id 1515 * switch domain identifier to free 1516 * 1517 * @return 1518 * Negative errno value on error, 0 on success. 1519 */ 1520 __rte_internal 1521 int 1522 rte_eth_switch_domain_free(uint16_t domain_id); 1523 1524 /** 1525 * Generic Ethernet device arguments 1526 * 1527 * One type of representor each structure. 1528 */ 1529 struct rte_eth_devargs { 1530 uint16_t mh_controllers[RTE_MAX_MULTI_HOST_CTRLS]; 1531 /** controller/s number in case of multi-host */ 1532 uint16_t nb_mh_controllers; 1533 /** number of controllers in multi-host controllers field */ 1534 uint16_t ports[RTE_MAX_ETHPORTS]; 1535 /** port/s number to enable on a multi-port single function */ 1536 uint16_t nb_ports; 1537 /** number of ports in ports field */ 1538 uint16_t representor_ports[RTE_MAX_ETHPORTS]; 1539 /** representor port/s identifier to enable on device */ 1540 uint16_t nb_representor_ports; 1541 /** number of ports in representor port field */ 1542 enum rte_eth_representor_type type; /* type of representor */ 1543 }; 1544 1545 /** 1546 * PMD helper function to get representor ID from location detail. 1547 * 1548 * Get representor ID from controller, pf and (sf or vf). 1549 * The mapping is retrieved from rte_eth_representor_info_get(). 1550 * 1551 * For backward compatibility, if no representor info, direct 1552 * map legacy VF (no controller and pf). 1553 * 1554 * @param port_id 1555 * Port ID of the backing device. 1556 * @param type 1557 * Representor type. 1558 * @param controller 1559 * Controller ID, -1 if unspecified. 1560 * @param pf 1561 * PF port ID, -1 if unspecified. 1562 * @param representor_port 1563 * VF or SF representor port number, -1 if unspecified. 1564 * @param repr_id 1565 * Pointer to output representor ID. 1566 * 1567 * @return 1568 * Negative errno value on error, 0 on success. 1569 */ 1570 __rte_internal 1571 int 1572 rte_eth_representor_id_get(uint16_t port_id, 1573 enum rte_eth_representor_type type, 1574 int controller, int pf, int representor_port, 1575 uint16_t *repr_id); 1576 1577 /** 1578 * PMD helper function to parse ethdev arguments 1579 * 1580 * @param devargs 1581 * device arguments 1582 * @param eth_devargs 1583 * parsed ethdev specific arguments. 1584 * 1585 * @return 1586 * Negative errno value on error, 0 on success. 1587 */ 1588 __rte_internal 1589 int 1590 rte_eth_devargs_parse(const char *devargs, struct rte_eth_devargs *eth_devargs); 1591 1592 1593 typedef int (*ethdev_init_t)(struct rte_eth_dev *ethdev, void *init_params); 1594 typedef int (*ethdev_bus_specific_init)(struct rte_eth_dev *ethdev, 1595 void *bus_specific_init_params); 1596 1597 /** 1598 * PMD helper function for the creation of a new ethdev ports. 1599 * 1600 * @param device 1601 * rte_device handle. 1602 * @param name 1603 * port name. 1604 * @param priv_data_size 1605 * size of private data required for port. 1606 * @param bus_specific_init 1607 * port bus specific initialisation callback function 1608 * @param bus_init_params 1609 * port bus specific initialisation parameters 1610 * @param ethdev_init 1611 * device specific port initialization callback function 1612 * @param init_params 1613 * port initialisation parameters 1614 * 1615 * @return 1616 * Negative errno value on error, 0 on success. 1617 */ 1618 __rte_internal 1619 int 1620 rte_eth_dev_create(struct rte_device *device, const char *name, 1621 size_t priv_data_size, 1622 ethdev_bus_specific_init bus_specific_init, void *bus_init_params, 1623 ethdev_init_t ethdev_init, void *init_params); 1624 1625 1626 typedef int (*ethdev_uninit_t)(struct rte_eth_dev *ethdev); 1627 1628 /** 1629 * PMD helper function for cleaning up the resources of a ethdev port on it's 1630 * destruction. 1631 * 1632 * @param ethdev 1633 * ethdev handle of port. 1634 * @param ethdev_uninit 1635 * device specific port un-initialise callback function 1636 * 1637 * @return 1638 * Negative errno value on error, 0 on success. 1639 */ 1640 __rte_internal 1641 int 1642 rte_eth_dev_destroy(struct rte_eth_dev *ethdev, ethdev_uninit_t ethdev_uninit); 1643 1644 /** 1645 * @internal 1646 * Pass the current hairpin queue HW and/or SW information to the peer queue 1647 * and fetch back the information of the peer queue. 1648 * 1649 * @param peer_port 1650 * Peer port identifier of the Ethernet device. 1651 * @param peer_queue 1652 * Peer queue index of the port. 1653 * @param cur_info 1654 * Pointer to the current information structure. 1655 * @param peer_info 1656 * Pointer to the peer information, output. 1657 * @param direction 1658 * Direction to pass the information. 1659 * positive - pass Tx queue information and get peer Rx queue information 1660 * zero - pass Rx queue information and get peer Tx queue information 1661 * 1662 * @return 1663 * Negative errno value on error, 0 on success. 1664 */ 1665 __rte_internal 1666 int 1667 rte_eth_hairpin_queue_peer_update(uint16_t peer_port, uint16_t peer_queue, 1668 struct rte_hairpin_peer_info *cur_info, 1669 struct rte_hairpin_peer_info *peer_info, 1670 uint32_t direction); 1671 1672 /** 1673 * @internal 1674 * Configure current hairpin queue with the peer information fetched to create 1675 * the connection (bind) with peer queue in the specified direction. 1676 * This function might need to be called twice to fully create the connections. 1677 * 1678 * @param cur_port 1679 * Current port identifier of the Ethernet device. 1680 * @param cur_queue 1681 * Current queue index of the port. 1682 * @param peer_info 1683 * Pointer to the peer information, input. 1684 * @param direction 1685 * Direction to create the connection. 1686 * positive - bind current Tx queue to peer Rx queue 1687 * zero - bind current Rx queue to peer Tx queue 1688 * 1689 * @return 1690 * Negative errno value on error, 0 on success. 1691 */ 1692 __rte_internal 1693 int 1694 rte_eth_hairpin_queue_peer_bind(uint16_t cur_port, uint16_t cur_queue, 1695 struct rte_hairpin_peer_info *peer_info, 1696 uint32_t direction); 1697 1698 /** 1699 * @internal 1700 * Get rte_eth_dev from device name. The device name should be specified 1701 * as below: 1702 * - PCIe address (Domain:Bus:Device.Function), for example 0000:2:00.0 1703 * - SoC device name, for example fsl-gmac0 1704 * - vdev dpdk name, for example net_[pcap0|null0|tap0] 1705 * 1706 * @param name 1707 * PCI address or name of the device 1708 * @return 1709 * - rte_eth_dev if successful 1710 * - NULL on failure 1711 */ 1712 __rte_internal 1713 struct rte_eth_dev* 1714 rte_eth_dev_get_by_name(const char *name); 1715 1716 /** 1717 * @internal 1718 * Reset the current queue state and configuration to disconnect (unbind) it 1719 * from the peer queue. 1720 * This function might need to be called twice to disconnect each other. 1721 * 1722 * @param cur_port 1723 * Current port identifier of the Ethernet device. 1724 * @param cur_queue 1725 * Current queue index of the port. 1726 * @param direction 1727 * Direction to destroy the connection. 1728 * positive - unbind current Tx queue from peer Rx queue 1729 * zero - unbind current Rx queue from peer Tx queue 1730 * 1731 * @return 1732 * Negative errno value on error, 0 on success. 1733 */ 1734 __rte_internal 1735 int 1736 rte_eth_hairpin_queue_peer_unbind(uint16_t cur_port, uint16_t cur_queue, 1737 uint32_t direction); 1738 1739 /** 1740 * @internal 1741 * Register mbuf dynamic field and flag for IP reassembly incomplete case. 1742 */ 1743 __rte_internal 1744 int 1745 rte_eth_ip_reassembly_dynfield_register(int *field_offset, int *flag); 1746 1747 1748 /* 1749 * Legacy ethdev API used internally by drivers. 1750 */ 1751 1752 enum rte_filter_type { 1753 RTE_ETH_FILTER_NONE = 0, 1754 RTE_ETH_FILTER_ETHERTYPE, 1755 RTE_ETH_FILTER_FLEXIBLE, 1756 RTE_ETH_FILTER_SYN, 1757 RTE_ETH_FILTER_NTUPLE, 1758 RTE_ETH_FILTER_TUNNEL, 1759 RTE_ETH_FILTER_FDIR, 1760 RTE_ETH_FILTER_HASH, 1761 RTE_ETH_FILTER_L2_TUNNEL, 1762 }; 1763 1764 /** 1765 * Define all structures for Ethertype Filter type. 1766 */ 1767 1768 #define RTE_ETHTYPE_FLAGS_MAC 0x0001 /**< If set, compare mac */ 1769 #define RTE_ETHTYPE_FLAGS_DROP 0x0002 /**< If set, drop packet when match */ 1770 1771 /** 1772 * A structure used to define the ethertype filter entry 1773 * to support RTE_ETH_FILTER_ETHERTYPE data representation. 1774 */ 1775 struct rte_eth_ethertype_filter { 1776 struct rte_ether_addr mac_addr; /**< Mac address to match */ 1777 uint16_t ether_type; /**< Ether type to match */ 1778 uint16_t flags; /**< Flags from RTE_ETHTYPE_FLAGS_* */ 1779 uint16_t queue; /**< Queue assigned to when match */ 1780 }; 1781 1782 /** 1783 * A structure used to define the TCP syn filter entry 1784 * to support RTE_ETH_FILTER_SYN data representation. 1785 */ 1786 struct rte_eth_syn_filter { 1787 /** 1 - higher priority than other filters, 0 - lower priority */ 1788 uint8_t hig_pri; 1789 uint16_t queue; /**< Queue assigned to when match */ 1790 }; 1791 1792 /** 1793 * filter type of tunneling packet 1794 */ 1795 #define RTE_ETH_TUNNEL_FILTER_OMAC 0x01 /**< filter by outer MAC addr */ 1796 #define RTE_ETH_TUNNEL_FILTER_OIP 0x02 /**< filter by outer IP Addr */ 1797 #define RTE_ETH_TUNNEL_FILTER_TENID 0x04 /**< filter by tenant ID */ 1798 #define RTE_ETH_TUNNEL_FILTER_IMAC 0x08 /**< filter by inner MAC addr */ 1799 #define RTE_ETH_TUNNEL_FILTER_IVLAN 0x10 /**< filter by inner VLAN ID */ 1800 #define RTE_ETH_TUNNEL_FILTER_IIP 0x20 /**< filter by inner IP addr */ 1801 1802 #define RTE_ETH_TUNNEL_FILTER_IMAC_IVLAN (RTE_ETH_TUNNEL_FILTER_IMAC | \ 1803 RTE_ETH_TUNNEL_FILTER_IVLAN) 1804 #define RTE_ETH_TUNNEL_FILTER_IMAC_IVLAN_TENID (RTE_ETH_TUNNEL_FILTER_IMAC | \ 1805 RTE_ETH_TUNNEL_FILTER_IVLAN | \ 1806 RTE_ETH_TUNNEL_FILTER_TENID) 1807 #define RTE_ETH_TUNNEL_FILTER_IMAC_TENID (RTE_ETH_TUNNEL_FILTER_IMAC | \ 1808 RTE_ETH_TUNNEL_FILTER_TENID) 1809 #define RTE_ETH_TUNNEL_FILTER_OMAC_TENID_IMAC (RTE_ETH_TUNNEL_FILTER_OMAC | \ 1810 RTE_ETH_TUNNEL_FILTER_TENID | \ 1811 RTE_ETH_TUNNEL_FILTER_IMAC) 1812 1813 /** 1814 * Select IPv4 or IPv6 for tunnel filters. 1815 */ 1816 enum rte_tunnel_iptype { 1817 RTE_TUNNEL_IPTYPE_IPV4 = 0, /**< IPv4 */ 1818 RTE_TUNNEL_IPTYPE_IPV6, /**< IPv6 */ 1819 }; 1820 1821 /** 1822 * Tunneling Packet filter configuration. 1823 */ 1824 struct rte_eth_tunnel_filter_conf { 1825 struct rte_ether_addr outer_mac; /**< Outer MAC address to match */ 1826 struct rte_ether_addr inner_mac; /**< Inner MAC address to match */ 1827 uint16_t inner_vlan; /**< Inner VLAN to match */ 1828 enum rte_tunnel_iptype ip_type; /**< IP address type */ 1829 /** 1830 * Outer destination IP address to match if ETH_TUNNEL_FILTER_OIP 1831 * is set in filter_type, or inner destination IP address to match 1832 * if ETH_TUNNEL_FILTER_IIP is set in filter_type. 1833 */ 1834 union { 1835 uint32_t ipv4_addr; /**< IPv4 address in big endian */ 1836 uint32_t ipv6_addr[4]; /**< IPv6 address in big endian */ 1837 } ip_addr; 1838 /** Flags from ETH_TUNNEL_FILTER_XX - see above */ 1839 uint16_t filter_type; 1840 enum rte_eth_tunnel_type tunnel_type; /**< Tunnel Type */ 1841 uint32_t tenant_id; /**< Tenant ID to match: VNI, GRE key... */ 1842 uint16_t queue_id; /**< Queue assigned to if match */ 1843 }; 1844 1845 #endif /* _RTE_ETHDEV_DRIVER_H_ */ 1846