4 * Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
11 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in
15 * the documentation and/or other materials provided with the
17 * * Neither the name of Intel Corporation nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34 #include <sys/types.h>
35 #include <sys/queue.h>
44 #include <netinet/in.h>
46 #include <rte_byteorder.h>
48 #include <rte_debug.h>
49 #include <rte_interrupts.h>
51 #include <rte_memory.h>
52 #include <rte_memcpy.h>
53 #include <rte_memzone.h>
54 #include <rte_launch.h>
55 #include <rte_tailq.h>
57 #include <rte_per_lcore.h>
58 #include <rte_lcore.h>
59 #include <rte_atomic.h>
60 #include <rte_branch_prediction.h>
61 #include <rte_common.h>
63 #include <rte_mempool.h>
64 #include <rte_malloc.h>
66 #include <rte_errno.h>
67 #include <rte_spinlock.h>
69 #include "rte_ether.h"
70 #include "rte_ethdev.h"
72 #ifdef RTE_LIBRTE_ETHDEV_DEBUG
73 #define PMD_DEBUG_TRACE(fmt, args...) do { \
74 RTE_LOG(ERR, PMD, "%s: " fmt, __func__, ## args); \
77 #define PMD_DEBUG_TRACE(fmt, args...)
80 /* Macros for checking for restricting functions to primary instance only */
81 #define PROC_PRIMARY_OR_ERR_RET(retval) do { \
82 if (rte_eal_process_type() != RTE_PROC_PRIMARY) { \
83 PMD_DEBUG_TRACE("Cannot run in secondary processes\n"); \
87 #define PROC_PRIMARY_OR_RET() do { \
88 if (rte_eal_process_type() != RTE_PROC_PRIMARY) { \
89 PMD_DEBUG_TRACE("Cannot run in secondary processes\n"); \
94 /* Macros to check for invlaid function pointers in dev_ops structure */
95 #define FUNC_PTR_OR_ERR_RET(func, retval) do { \
96 if ((func) == NULL) { \
97 PMD_DEBUG_TRACE("Function not supported\n"); \
101 #define FUNC_PTR_OR_RET(func) do { \
102 if ((func) == NULL) { \
103 PMD_DEBUG_TRACE("Function not supported\n"); \
108 static const char *MZ_RTE_ETH_DEV_DATA = "rte_eth_dev_data";
109 struct rte_eth_dev rte_eth_devices[RTE_MAX_ETHPORTS];
110 static struct rte_eth_dev_data *rte_eth_dev_data = NULL;
111 static uint8_t nb_ports = 0;
113 /* spinlock for eth device callbacks */
114 static rte_spinlock_t rte_eth_dev_cb_lock = RTE_SPINLOCK_INITIALIZER;
117 * The user application callback description.
119 * It contains callback address to be registered by user application,
120 * the pointer to the parameters for callback, and the event type.
122 struct rte_eth_dev_callback {
123 TAILQ_ENTRY(rte_eth_dev_callback) next; /**< Callbacks list */
124 rte_eth_dev_cb_fn cb_fn; /**< Callback address */
125 void *cb_arg; /**< Parameter for callback */
126 enum rte_eth_event_type event; /**< Interrupt event type */
127 uint32_t active; /**< Callback is executing */
136 rte_eth_dev_data_alloc(void)
138 const unsigned flags = 0;
139 const struct rte_memzone *mz;
141 if (rte_eal_process_type() == RTE_PROC_PRIMARY){
142 mz = rte_memzone_reserve(MZ_RTE_ETH_DEV_DATA,
143 RTE_MAX_ETHPORTS * sizeof(*rte_eth_dev_data),
144 rte_socket_id(), flags);
146 mz = rte_memzone_lookup(MZ_RTE_ETH_DEV_DATA);
148 rte_panic("Cannot allocate memzone for ethernet port data\n");
150 rte_eth_dev_data = mz->addr;
151 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
152 memset(rte_eth_dev_data, 0,
153 RTE_MAX_ETHPORTS * sizeof(*rte_eth_dev_data));
157 rte_eth_dev_allocate(void)
159 struct rte_eth_dev *eth_dev;
161 if (nb_ports == RTE_MAX_ETHPORTS) {
162 PMD_DEBUG_TRACE("Reached maximum number of ethernet ports\n");
166 if (rte_eth_dev_data == NULL)
167 rte_eth_dev_data_alloc();
169 eth_dev = &rte_eth_devices[nb_ports];
170 eth_dev->data = &rte_eth_dev_data[nb_ports];
171 eth_dev->data->port_id = nb_ports++;
176 rte_eth_dev_init(struct rte_pci_driver *pci_drv,
177 struct rte_pci_device *pci_dev)
179 struct eth_driver *eth_drv;
180 struct rte_eth_dev *eth_dev;
183 eth_drv = (struct eth_driver *)pci_drv;
185 eth_dev = rte_eth_dev_allocate();
189 if (rte_eal_process_type() == RTE_PROC_PRIMARY){
190 eth_dev->data->dev_private = rte_zmalloc("ethdev private structure",
191 eth_drv->dev_private_size,
193 if (eth_dev->data->dev_private == NULL)
194 rte_panic("Cannot allocate memzone for private port data\n");
196 eth_dev->pci_dev = pci_dev;
197 eth_dev->driver = eth_drv;
198 eth_dev->data->rx_mbuf_alloc_failed = 0;
200 /* init user callbacks */
201 TAILQ_INIT(&(eth_dev->callbacks));
204 * Set the default maximum frame size.
206 eth_dev->data->max_frame_size = ETHER_MAX_LEN;
208 /* Invoke PMD device initialization function */
209 diag = (*eth_drv->eth_dev_init)(eth_drv, eth_dev);
213 PMD_DEBUG_TRACE("driver %s: eth_dev_init(vendor_id=0x%u device_id=0x%x)"
214 " failed\n", pci_drv->name,
215 (unsigned) pci_dev->id.vendor_id,
216 (unsigned) pci_dev->id.device_id);
217 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
218 rte_free(eth_dev->data->dev_private);
224 * Register an Ethernet [Poll Mode] driver.
226 * Function invoked by the initialization function of an Ethernet driver
227 * to simultaneously register itself as a PCI driver and as an Ethernet
229 * Invokes the rte_eal_pci_register() function to register the *pci_drv*
230 * structure embedded in the *eth_drv* structure, after having stored the
231 * address of the rte_eth_dev_init() function in the *devinit* field of
232 * the *pci_drv* structure.
233 * During the PCI probing phase, the rte_eth_dev_init() function is
234 * invoked for each PCI [Ethernet device] matching the embedded PCI
235 * identifiers provided by the driver.
238 rte_eth_driver_register(struct eth_driver *eth_drv)
240 eth_drv->pci_drv.devinit = rte_eth_dev_init;
241 rte_eal_pci_register(ð_drv->pci_drv);
245 rte_eth_dev_socket_id(uint8_t port_id)
247 if (port_id >= nb_ports)
249 return rte_eth_devices[port_id].pci_dev->numa_node;
253 rte_eth_dev_count(void)
259 rte_eth_dev_rx_queue_config(struct rte_eth_dev *dev, uint16_t nb_queues)
261 uint16_t old_nb_queues = dev->data->nb_rx_queues;
265 if (dev->data->rx_queues == NULL) { /* first time configuration */
266 dev->data->rx_queues = rte_zmalloc("ethdev->rx_queues",
267 sizeof(dev->data->rx_queues[0]) * nb_queues,
269 if (dev->data->rx_queues == NULL) {
270 dev->data->nb_rx_queues = 0;
273 } else { /* re-configure */
274 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_release, -ENOTSUP);
276 rxq = dev->data->rx_queues;
278 for (i = nb_queues; i < old_nb_queues; i++)
279 (*dev->dev_ops->rx_queue_release)(rxq[i]);
280 rxq = rte_realloc(rxq, sizeof(rxq[0]) * nb_queues,
285 if (nb_queues > old_nb_queues)
286 memset(rxq + old_nb_queues, 0,
287 sizeof(rxq[0]) * (nb_queues - old_nb_queues));
289 dev->data->rx_queues = rxq;
292 dev->data->nb_rx_queues = nb_queues;
297 rte_eth_dev_rx_queue_start(uint8_t port_id, uint16_t rx_queue_id)
299 struct rte_eth_dev *dev;
301 /* This function is only safe when called from the primary process
302 * in a multi-process setup*/
303 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
305 if (port_id >= nb_ports) {
306 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
310 dev = &rte_eth_devices[port_id];
311 if (rx_queue_id >= dev->data->nb_rx_queues) {
312 PMD_DEBUG_TRACE("Invalid RX queue_id=%d\n", rx_queue_id);
316 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_start, -ENOTSUP);
318 return dev->dev_ops->rx_queue_start(dev, rx_queue_id);
323 rte_eth_dev_rx_queue_stop(uint8_t port_id, uint16_t rx_queue_id)
325 struct rte_eth_dev *dev;
327 /* This function is only safe when called from the primary process
328 * in a multi-process setup*/
329 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
331 if (port_id >= nb_ports) {
332 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
336 dev = &rte_eth_devices[port_id];
337 if (rx_queue_id >= dev->data->nb_rx_queues) {
338 PMD_DEBUG_TRACE("Invalid RX queue_id=%d\n", rx_queue_id);
342 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_stop, -ENOTSUP);
344 return dev->dev_ops->rx_queue_stop(dev, rx_queue_id);
349 rte_eth_dev_tx_queue_start(uint8_t port_id, uint16_t tx_queue_id)
351 struct rte_eth_dev *dev;
353 /* This function is only safe when called from the primary process
354 * in a multi-process setup*/
355 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
357 if (port_id >= nb_ports) {
358 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
362 dev = &rte_eth_devices[port_id];
363 if (tx_queue_id >= dev->data->nb_tx_queues) {
364 PMD_DEBUG_TRACE("Invalid TX queue_id=%d\n", tx_queue_id);
368 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->tx_queue_start, -ENOTSUP);
370 return dev->dev_ops->tx_queue_start(dev, tx_queue_id);
375 rte_eth_dev_tx_queue_stop(uint8_t port_id, uint16_t tx_queue_id)
377 struct rte_eth_dev *dev;
379 /* This function is only safe when called from the primary process
380 * in a multi-process setup*/
381 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
383 if (port_id >= nb_ports) {
384 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
388 dev = &rte_eth_devices[port_id];
389 if (tx_queue_id >= dev->data->nb_tx_queues) {
390 PMD_DEBUG_TRACE("Invalid TX queue_id=%d\n", tx_queue_id);
394 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->tx_queue_stop, -ENOTSUP);
396 return dev->dev_ops->tx_queue_stop(dev, tx_queue_id);
401 rte_eth_dev_tx_queue_config(struct rte_eth_dev *dev, uint16_t nb_queues)
403 uint16_t old_nb_queues = dev->data->nb_tx_queues;
407 if (dev->data->tx_queues == NULL) { /* first time configuration */
408 dev->data->tx_queues = rte_zmalloc("ethdev->tx_queues",
409 sizeof(dev->data->tx_queues[0]) * nb_queues,
411 if (dev->data->tx_queues == NULL) {
412 dev->data->nb_tx_queues = 0;
415 } else { /* re-configure */
416 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->tx_queue_release, -ENOTSUP);
418 txq = dev->data->tx_queues;
420 for (i = nb_queues; i < old_nb_queues; i++)
421 (*dev->dev_ops->tx_queue_release)(txq[i]);
422 txq = rte_realloc(txq, sizeof(txq[0]) * nb_queues,
427 if (nb_queues > old_nb_queues)
428 memset(txq + old_nb_queues, 0,
429 sizeof(txq[0]) * (nb_queues - old_nb_queues));
431 dev->data->tx_queues = txq;
434 dev->data->nb_tx_queues = nb_queues;
439 rte_eth_dev_check_mq_mode(uint8_t port_id, uint16_t nb_rx_q, uint16_t nb_tx_q,
440 const struct rte_eth_conf *dev_conf)
442 struct rte_eth_dev *dev = &rte_eth_devices[port_id];
444 if (RTE_ETH_DEV_SRIOV(dev).active != 0) {
445 /* check multi-queue mode */
446 if ((dev_conf->rxmode.mq_mode == ETH_MQ_RX_RSS) ||
447 (dev_conf->rxmode.mq_mode == ETH_MQ_RX_DCB) ||
448 (dev_conf->rxmode.mq_mode == ETH_MQ_RX_DCB_RSS) ||
449 (dev_conf->txmode.mq_mode == ETH_MQ_TX_DCB)) {
450 /* SRIOV only works in VMDq enable mode */
451 PMD_DEBUG_TRACE("ethdev port_id=%" PRIu8
453 "wrong VMDQ mq_mode rx %u tx %u\n",
455 dev_conf->rxmode.mq_mode,
456 dev_conf->txmode.mq_mode);
460 switch (dev_conf->rxmode.mq_mode) {
461 case ETH_MQ_RX_VMDQ_RSS:
462 case ETH_MQ_RX_VMDQ_DCB:
463 case ETH_MQ_RX_VMDQ_DCB_RSS:
464 /* DCB/RSS VMDQ in SRIOV mode, not implement yet */
465 PMD_DEBUG_TRACE("ethdev port_id=%" PRIu8
467 "unsupported VMDQ mq_mode rx %u\n",
468 port_id, dev_conf->rxmode.mq_mode);
470 default: /* ETH_MQ_RX_VMDQ_ONLY or ETH_MQ_RX_NONE */
471 /* if nothing mq mode configure, use default scheme */
472 dev->data->dev_conf.rxmode.mq_mode = ETH_MQ_RX_VMDQ_ONLY;
473 if (RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool > 1)
474 RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool = 1;
478 switch (dev_conf->txmode.mq_mode) {
479 case ETH_MQ_TX_VMDQ_DCB:
480 /* DCB VMDQ in SRIOV mode, not implement yet */
481 PMD_DEBUG_TRACE("ethdev port_id=%" PRIu8
483 "unsupported VMDQ mq_mode tx %u\n",
484 port_id, dev_conf->txmode.mq_mode);
486 default: /* ETH_MQ_TX_VMDQ_ONLY or ETH_MQ_TX_NONE */
487 /* if nothing mq mode configure, use default scheme */
488 dev->data->dev_conf.txmode.mq_mode = ETH_MQ_TX_VMDQ_ONLY;
489 if (RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool > 1)
490 RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool = 1;
494 /* check valid queue number */
495 if ((nb_rx_q > RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool) ||
496 (nb_tx_q > RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool)) {
497 PMD_DEBUG_TRACE("ethdev port_id=%d SRIOV active, "
498 "queue number must less equal to %d\n",
499 port_id, RTE_ETH_DEV_SRIOV(dev).nb_q_per_pool);
503 /* For vmdb+dcb mode check our configuration before we go further */
504 if (dev_conf->rxmode.mq_mode == ETH_MQ_RX_VMDQ_DCB) {
505 const struct rte_eth_vmdq_dcb_conf *conf;
507 if (nb_rx_q != ETH_VMDQ_DCB_NUM_QUEUES) {
508 PMD_DEBUG_TRACE("ethdev port_id=%d VMDQ+DCB, nb_rx_q "
510 port_id, ETH_VMDQ_DCB_NUM_QUEUES);
513 conf = &(dev_conf->rx_adv_conf.vmdq_dcb_conf);
514 if (! (conf->nb_queue_pools == ETH_16_POOLS ||
515 conf->nb_queue_pools == ETH_32_POOLS)) {
516 PMD_DEBUG_TRACE("ethdev port_id=%d VMDQ+DCB selected, "
517 "nb_queue_pools must be %d or %d\n",
518 port_id, ETH_16_POOLS, ETH_32_POOLS);
522 if (dev_conf->txmode.mq_mode == ETH_MQ_TX_VMDQ_DCB) {
523 const struct rte_eth_vmdq_dcb_tx_conf *conf;
525 if (nb_tx_q != ETH_VMDQ_DCB_NUM_QUEUES) {
526 PMD_DEBUG_TRACE("ethdev port_id=%d VMDQ+DCB, nb_tx_q "
528 port_id, ETH_VMDQ_DCB_NUM_QUEUES);
531 conf = &(dev_conf->tx_adv_conf.vmdq_dcb_tx_conf);
532 if (! (conf->nb_queue_pools == ETH_16_POOLS ||
533 conf->nb_queue_pools == ETH_32_POOLS)) {
534 PMD_DEBUG_TRACE("ethdev port_id=%d VMDQ+DCB selected, "
535 "nb_queue_pools != %d or nb_queue_pools "
537 port_id, ETH_16_POOLS, ETH_32_POOLS);
542 /* For DCB mode check our configuration before we go further */
543 if (dev_conf->rxmode.mq_mode == ETH_MQ_RX_DCB) {
544 const struct rte_eth_dcb_rx_conf *conf;
546 if (nb_rx_q != ETH_DCB_NUM_QUEUES) {
547 PMD_DEBUG_TRACE("ethdev port_id=%d DCB, nb_rx_q "
549 port_id, ETH_DCB_NUM_QUEUES);
552 conf = &(dev_conf->rx_adv_conf.dcb_rx_conf);
553 if (! (conf->nb_tcs == ETH_4_TCS ||
554 conf->nb_tcs == ETH_8_TCS)) {
555 PMD_DEBUG_TRACE("ethdev port_id=%d DCB selected, "
556 "nb_tcs != %d or nb_tcs "
558 port_id, ETH_4_TCS, ETH_8_TCS);
563 if (dev_conf->txmode.mq_mode == ETH_MQ_TX_DCB) {
564 const struct rte_eth_dcb_tx_conf *conf;
566 if (nb_tx_q != ETH_DCB_NUM_QUEUES) {
567 PMD_DEBUG_TRACE("ethdev port_id=%d DCB, nb_tx_q "
569 port_id, ETH_DCB_NUM_QUEUES);
572 conf = &(dev_conf->tx_adv_conf.dcb_tx_conf);
573 if (! (conf->nb_tcs == ETH_4_TCS ||
574 conf->nb_tcs == ETH_8_TCS)) {
575 PMD_DEBUG_TRACE("ethdev port_id=%d DCB selected, "
576 "nb_tcs != %d or nb_tcs "
578 port_id, ETH_4_TCS, ETH_8_TCS);
587 rte_eth_dev_configure(uint8_t port_id, uint16_t nb_rx_q, uint16_t nb_tx_q,
588 const struct rte_eth_conf *dev_conf)
590 struct rte_eth_dev *dev;
591 struct rte_eth_dev_info dev_info;
594 /* This function is only safe when called from the primary process
595 * in a multi-process setup*/
596 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
598 if (port_id >= nb_ports || port_id >= RTE_MAX_ETHPORTS) {
599 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
602 dev = &rte_eth_devices[port_id];
604 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
605 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP);
607 if (dev->data->dev_started) {
609 "port %d must be stopped to allow configuration\n", port_id);
614 * Check that the numbers of RX and TX queues are not greater
615 * than the maximum number of RX and TX queues supported by the
618 (*dev->dev_ops->dev_infos_get)(dev, &dev_info);
619 if (nb_rx_q > dev_info.max_rx_queues) {
620 PMD_DEBUG_TRACE("ethdev port_id=%d nb_rx_queues=%d > %d\n",
621 port_id, nb_rx_q, dev_info.max_rx_queues);
625 PMD_DEBUG_TRACE("ethdev port_id=%d nb_rx_q == 0\n", port_id);
629 if (nb_tx_q > dev_info.max_tx_queues) {
630 PMD_DEBUG_TRACE("ethdev port_id=%d nb_tx_queues=%d > %d\n",
631 port_id, nb_tx_q, dev_info.max_tx_queues);
635 PMD_DEBUG_TRACE("ethdev port_id=%d nb_tx_q == 0\n", port_id);
639 /* Copy the dev_conf parameter into the dev structure */
640 memcpy(&dev->data->dev_conf, dev_conf, sizeof(dev->data->dev_conf));
643 * If jumbo frames are enabled, check that the maximum RX packet
644 * length is supported by the configured device.
646 if (dev_conf->rxmode.jumbo_frame == 1) {
647 if (dev_conf->rxmode.max_rx_pkt_len >
648 dev_info.max_rx_pktlen) {
649 PMD_DEBUG_TRACE("ethdev port_id=%d max_rx_pkt_len %u"
650 " > max valid value %u\n",
652 (unsigned)dev_conf->rxmode.max_rx_pkt_len,
653 (unsigned)dev_info.max_rx_pktlen);
656 else if (dev_conf->rxmode.max_rx_pkt_len < ETHER_MIN_LEN) {
657 PMD_DEBUG_TRACE("ethdev port_id=%d max_rx_pkt_len %u"
658 " < min valid value %u\n",
660 (unsigned)dev_conf->rxmode.max_rx_pkt_len,
661 (unsigned)ETHER_MIN_LEN);
665 if (dev_conf->rxmode.max_rx_pkt_len < ETHER_MIN_LEN ||
666 dev_conf->rxmode.max_rx_pkt_len > ETHER_MAX_LEN)
667 /* Use default value */
668 dev->data->dev_conf.rxmode.max_rx_pkt_len =
672 /* multipe queue mode checking */
673 diag = rte_eth_dev_check_mq_mode(port_id, nb_rx_q, nb_tx_q, dev_conf);
675 PMD_DEBUG_TRACE("port%d rte_eth_dev_check_mq_mode = %d\n",
681 * Setup new number of RX/TX queues and reconfigure device.
683 diag = rte_eth_dev_rx_queue_config(dev, nb_rx_q);
685 PMD_DEBUG_TRACE("port%d rte_eth_dev_rx_queue_config = %d\n",
690 diag = rte_eth_dev_tx_queue_config(dev, nb_tx_q);
692 PMD_DEBUG_TRACE("port%d rte_eth_dev_tx_queue_config = %d\n",
694 rte_eth_dev_rx_queue_config(dev, 0);
698 diag = (*dev->dev_ops->dev_configure)(dev);
700 PMD_DEBUG_TRACE("port%d dev_configure = %d\n",
702 rte_eth_dev_rx_queue_config(dev, 0);
703 rte_eth_dev_tx_queue_config(dev, 0);
711 rte_eth_dev_config_restore(uint8_t port_id)
713 struct rte_eth_dev *dev;
714 struct rte_eth_dev_info dev_info;
715 struct ether_addr addr;
719 dev = &rte_eth_devices[port_id];
721 rte_eth_dev_info_get(port_id, &dev_info);
723 if (RTE_ETH_DEV_SRIOV(dev).active)
724 pool = RTE_ETH_DEV_SRIOV(dev).def_vmdq_idx;
726 /* replay MAC address configuration */
727 for (i = 0; i < dev_info.max_mac_addrs; i++) {
728 addr = dev->data->mac_addrs[i];
730 /* skip zero address */
731 if (is_zero_ether_addr(&addr))
734 /* add address to the hardware */
735 if (*dev->dev_ops->mac_addr_add)
736 (*dev->dev_ops->mac_addr_add)(dev, &addr, i, pool);
738 PMD_DEBUG_TRACE("port %d: MAC address array not supported\n",
740 /* exit the loop but not return an error */
745 /* replay promiscuous configuration */
746 if (rte_eth_promiscuous_get(port_id) == 1)
747 rte_eth_promiscuous_enable(port_id);
748 else if (rte_eth_promiscuous_get(port_id) == 0)
749 rte_eth_promiscuous_disable(port_id);
751 /* replay allmulticast configuration */
752 if (rte_eth_allmulticast_get(port_id) == 1)
753 rte_eth_allmulticast_enable(port_id);
754 else if (rte_eth_allmulticast_get(port_id) == 0)
755 rte_eth_allmulticast_disable(port_id);
759 rte_eth_dev_start(uint8_t port_id)
761 struct rte_eth_dev *dev;
764 /* This function is only safe when called from the primary process
765 * in a multi-process setup*/
766 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
768 if (port_id >= nb_ports) {
769 PMD_DEBUG_TRACE("Invalid port_id=%" PRIu8 "\n", port_id);
772 dev = &rte_eth_devices[port_id];
774 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP);
776 if (dev->data->dev_started != 0) {
777 PMD_DEBUG_TRACE("Device with port_id=%" PRIu8
778 " already started\n",
783 diag = (*dev->dev_ops->dev_start)(dev);
785 dev->data->dev_started = 1;
789 rte_eth_dev_config_restore(port_id);
795 rte_eth_dev_stop(uint8_t port_id)
797 struct rte_eth_dev *dev;
799 /* This function is only safe when called from the primary process
800 * in a multi-process setup*/
801 PROC_PRIMARY_OR_RET();
803 if (port_id >= nb_ports) {
804 PMD_DEBUG_TRACE("Invalid port_id=%" PRIu8 "\n", port_id);
807 dev = &rte_eth_devices[port_id];
809 FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop);
811 if (dev->data->dev_started == 0) {
812 PMD_DEBUG_TRACE("Device with port_id=%" PRIu8
813 " already stopped\n",
818 dev->data->dev_started = 0;
819 (*dev->dev_ops->dev_stop)(dev);
823 rte_eth_dev_set_link_up(uint8_t port_id)
825 struct rte_eth_dev *dev;
827 /* This function is only safe when called from the primary process
828 * in a multi-process setup*/
829 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
831 if (port_id >= nb_ports) {
832 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
835 dev = &rte_eth_devices[port_id];
837 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_set_link_up, -ENOTSUP);
838 return (*dev->dev_ops->dev_set_link_up)(dev);
842 rte_eth_dev_set_link_down(uint8_t port_id)
844 struct rte_eth_dev *dev;
846 /* This function is only safe when called from the primary process
847 * in a multi-process setup*/
848 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
850 if (port_id >= nb_ports) {
851 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
854 dev = &rte_eth_devices[port_id];
856 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_set_link_down, -ENOTSUP);
857 return (*dev->dev_ops->dev_set_link_down)(dev);
861 rte_eth_dev_close(uint8_t port_id)
863 struct rte_eth_dev *dev;
865 /* This function is only safe when called from the primary process
866 * in a multi-process setup*/
867 PROC_PRIMARY_OR_RET();
869 if (port_id >= nb_ports) {
870 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
874 dev = &rte_eth_devices[port_id];
876 FUNC_PTR_OR_RET(*dev->dev_ops->dev_close);
877 dev->data->dev_started = 0;
878 (*dev->dev_ops->dev_close)(dev);
882 rte_eth_rx_queue_setup(uint8_t port_id, uint16_t rx_queue_id,
883 uint16_t nb_rx_desc, unsigned int socket_id,
884 const struct rte_eth_rxconf *rx_conf,
885 struct rte_mempool *mp)
887 struct rte_eth_dev *dev;
888 struct rte_pktmbuf_pool_private *mbp_priv;
889 struct rte_eth_dev_info dev_info;
891 /* This function is only safe when called from the primary process
892 * in a multi-process setup*/
893 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
895 if (port_id >= nb_ports) {
896 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
899 dev = &rte_eth_devices[port_id];
900 if (rx_queue_id >= dev->data->nb_rx_queues) {
901 PMD_DEBUG_TRACE("Invalid RX queue_id=%d\n", rx_queue_id);
905 if (dev->data->dev_started) {
907 "port %d must be stopped to allow configuration\n", port_id);
911 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);
912 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_setup, -ENOTSUP);
915 * Check the size of the mbuf data buffer.
916 * This value must be provided in the private data of the memory pool.
917 * First check that the memory pool has a valid private data.
919 (*dev->dev_ops->dev_infos_get)(dev, &dev_info);
920 if (mp->private_data_size < sizeof(struct rte_pktmbuf_pool_private)) {
921 PMD_DEBUG_TRACE("%s private_data_size %d < %d\n",
922 mp->name, (int) mp->private_data_size,
923 (int) sizeof(struct rte_pktmbuf_pool_private));
926 mbp_priv = rte_mempool_get_priv(mp);
927 if ((uint32_t) (mbp_priv->mbuf_data_room_size - RTE_PKTMBUF_HEADROOM) <
928 dev_info.min_rx_bufsize) {
929 PMD_DEBUG_TRACE("%s mbuf_data_room_size %d < %d "
930 "(RTE_PKTMBUF_HEADROOM=%d + min_rx_bufsize(dev)"
933 (int)mbp_priv->mbuf_data_room_size,
934 (int)(RTE_PKTMBUF_HEADROOM +
935 dev_info.min_rx_bufsize),
936 (int)RTE_PKTMBUF_HEADROOM,
937 (int)dev_info.min_rx_bufsize);
941 return (*dev->dev_ops->rx_queue_setup)(dev, rx_queue_id, nb_rx_desc,
942 socket_id, rx_conf, mp);
946 rte_eth_tx_queue_setup(uint8_t port_id, uint16_t tx_queue_id,
947 uint16_t nb_tx_desc, unsigned int socket_id,
948 const struct rte_eth_txconf *tx_conf)
950 struct rte_eth_dev *dev;
952 /* This function is only safe when called from the primary process
953 * in a multi-process setup*/
954 PROC_PRIMARY_OR_ERR_RET(-E_RTE_SECONDARY);
956 if (port_id >= RTE_MAX_ETHPORTS || port_id >= nb_ports) {
957 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
960 dev = &rte_eth_devices[port_id];
961 if (tx_queue_id >= dev->data->nb_tx_queues) {
962 PMD_DEBUG_TRACE("Invalid TX queue_id=%d\n", tx_queue_id);
966 if (dev->data->dev_started) {
968 "port %d must be stopped to allow configuration\n", port_id);
972 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->tx_queue_setup, -ENOTSUP);
973 return (*dev->dev_ops->tx_queue_setup)(dev, tx_queue_id, nb_tx_desc,
978 rte_eth_promiscuous_enable(uint8_t port_id)
980 struct rte_eth_dev *dev;
982 if (port_id >= nb_ports) {
983 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
986 dev = &rte_eth_devices[port_id];
988 FUNC_PTR_OR_RET(*dev->dev_ops->promiscuous_enable);
989 (*dev->dev_ops->promiscuous_enable)(dev);
990 dev->data->promiscuous = 1;
994 rte_eth_promiscuous_disable(uint8_t port_id)
996 struct rte_eth_dev *dev;
998 if (port_id >= nb_ports) {
999 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1002 dev = &rte_eth_devices[port_id];
1004 FUNC_PTR_OR_RET(*dev->dev_ops->promiscuous_disable);
1005 dev->data->promiscuous = 0;
1006 (*dev->dev_ops->promiscuous_disable)(dev);
1010 rte_eth_promiscuous_get(uint8_t port_id)
1012 struct rte_eth_dev *dev;
1014 if (port_id >= nb_ports) {
1015 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1019 dev = &rte_eth_devices[port_id];
1020 return dev->data->promiscuous;
1024 rte_eth_allmulticast_enable(uint8_t port_id)
1026 struct rte_eth_dev *dev;
1028 if (port_id >= nb_ports) {
1029 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1032 dev = &rte_eth_devices[port_id];
1034 FUNC_PTR_OR_RET(*dev->dev_ops->allmulticast_enable);
1035 (*dev->dev_ops->allmulticast_enable)(dev);
1036 dev->data->all_multicast = 1;
1040 rte_eth_allmulticast_disable(uint8_t port_id)
1042 struct rte_eth_dev *dev;
1044 if (port_id >= nb_ports) {
1045 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1048 dev = &rte_eth_devices[port_id];
1050 FUNC_PTR_OR_RET(*dev->dev_ops->allmulticast_disable);
1051 dev->data->all_multicast = 0;
1052 (*dev->dev_ops->allmulticast_disable)(dev);
1056 rte_eth_allmulticast_get(uint8_t port_id)
1058 struct rte_eth_dev *dev;
1060 if (port_id >= nb_ports) {
1061 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1065 dev = &rte_eth_devices[port_id];
1066 return dev->data->all_multicast;
1070 rte_eth_dev_atomic_read_link_status(struct rte_eth_dev *dev,
1071 struct rte_eth_link *link)
1073 struct rte_eth_link *dst = link;
1074 struct rte_eth_link *src = &(dev->data->dev_link);
1076 if (rte_atomic64_cmpset((uint64_t *)dst, *(uint64_t *)dst,
1077 *(uint64_t *)src) == 0)
1084 rte_eth_link_get(uint8_t port_id, struct rte_eth_link *eth_link)
1086 struct rte_eth_dev *dev;
1088 if (port_id >= nb_ports) {
1089 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1092 dev = &rte_eth_devices[port_id];
1093 FUNC_PTR_OR_RET(*dev->dev_ops->link_update);
1095 if (dev->data->dev_conf.intr_conf.lsc != 0)
1096 rte_eth_dev_atomic_read_link_status(dev, eth_link);
1098 (*dev->dev_ops->link_update)(dev, 1);
1099 *eth_link = dev->data->dev_link;
1104 rte_eth_link_get_nowait(uint8_t port_id, struct rte_eth_link *eth_link)
1106 struct rte_eth_dev *dev;
1108 if (port_id >= nb_ports) {
1109 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1112 dev = &rte_eth_devices[port_id];
1113 FUNC_PTR_OR_RET(*dev->dev_ops->link_update);
1115 if (dev->data->dev_conf.intr_conf.lsc != 0)
1116 rte_eth_dev_atomic_read_link_status(dev, eth_link);
1118 (*dev->dev_ops->link_update)(dev, 0);
1119 *eth_link = dev->data->dev_link;
1124 rte_eth_stats_get(uint8_t port_id, struct rte_eth_stats *stats)
1126 struct rte_eth_dev *dev;
1128 if (port_id >= nb_ports) {
1129 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1132 dev = &rte_eth_devices[port_id];
1133 memset(stats, 0, sizeof(*stats));
1135 FUNC_PTR_OR_RET(*dev->dev_ops->stats_get);
1136 (*dev->dev_ops->stats_get)(dev, stats);
1137 stats->rx_nombuf = dev->data->rx_mbuf_alloc_failed;
1141 rte_eth_stats_reset(uint8_t port_id)
1143 struct rte_eth_dev *dev;
1145 if (port_id >= nb_ports) {
1146 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1149 dev = &rte_eth_devices[port_id];
1151 FUNC_PTR_OR_RET(*dev->dev_ops->stats_reset);
1152 (*dev->dev_ops->stats_reset)(dev);
1157 set_queue_stats_mapping(uint8_t port_id, uint16_t queue_id, uint8_t stat_idx,
1160 struct rte_eth_dev *dev;
1162 if (port_id >= nb_ports) {
1163 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1166 dev = &rte_eth_devices[port_id];
1168 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_stats_mapping_set, -ENOTSUP);
1169 return (*dev->dev_ops->queue_stats_mapping_set)
1170 (dev, queue_id, stat_idx, is_rx);
1175 rte_eth_dev_set_tx_queue_stats_mapping(uint8_t port_id, uint16_t tx_queue_id,
1178 return set_queue_stats_mapping(port_id, tx_queue_id, stat_idx,
1184 rte_eth_dev_set_rx_queue_stats_mapping(uint8_t port_id, uint16_t rx_queue_id,
1187 return set_queue_stats_mapping(port_id, rx_queue_id, stat_idx,
1193 rte_eth_dev_info_get(uint8_t port_id, struct rte_eth_dev_info *dev_info)
1195 struct rte_eth_dev *dev;
1197 if (port_id >= nb_ports) {
1198 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1201 dev = &rte_eth_devices[port_id];
1203 /* Default device offload capabilities to zero */
1204 dev_info->rx_offload_capa = 0;
1205 dev_info->tx_offload_capa = 0;
1206 dev_info->if_index = 0;
1207 FUNC_PTR_OR_RET(*dev->dev_ops->dev_infos_get);
1208 (*dev->dev_ops->dev_infos_get)(dev, dev_info);
1209 dev_info->pci_dev = dev->pci_dev;
1211 dev_info->driver_name = dev->driver->pci_drv.name;
1215 rte_eth_macaddr_get(uint8_t port_id, struct ether_addr *mac_addr)
1217 struct rte_eth_dev *dev;
1219 if (port_id >= nb_ports) {
1220 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1223 dev = &rte_eth_devices[port_id];
1224 ether_addr_copy(&dev->data->mac_addrs[0], mac_addr);
1228 rte_eth_dev_vlan_filter(uint8_t port_id, uint16_t vlan_id, int on)
1230 struct rte_eth_dev *dev;
1232 if (port_id >= nb_ports) {
1233 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1236 dev = &rte_eth_devices[port_id];
1237 if (! (dev->data->dev_conf.rxmode.hw_vlan_filter)) {
1238 PMD_DEBUG_TRACE("port %d: vlan-filtering disabled\n", port_id);
1242 if (vlan_id > 4095) {
1243 PMD_DEBUG_TRACE("(port_id=%d) invalid vlan_id=%u > 4095\n",
1244 port_id, (unsigned) vlan_id);
1247 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->vlan_filter_set, -ENOTSUP);
1248 (*dev->dev_ops->vlan_filter_set)(dev, vlan_id, on);
1253 rte_eth_dev_set_vlan_strip_on_queue(uint8_t port_id, uint16_t rx_queue_id, int on)
1255 struct rte_eth_dev *dev;
1257 if (port_id >= nb_ports) {
1258 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1262 dev = &rte_eth_devices[port_id];
1263 if (rx_queue_id >= dev->data->nb_rx_queues) {
1264 PMD_DEBUG_TRACE("Invalid rx_queue_id=%d\n", port_id);
1268 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->vlan_strip_queue_set, -ENOTSUP);
1269 (*dev->dev_ops->vlan_strip_queue_set)(dev, rx_queue_id, on);
1275 rte_eth_dev_set_vlan_ether_type(uint8_t port_id, uint16_t tpid)
1277 struct rte_eth_dev *dev;
1279 if (port_id >= nb_ports) {
1280 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1284 dev = &rte_eth_devices[port_id];
1285 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->vlan_tpid_set, -ENOTSUP);
1286 (*dev->dev_ops->vlan_tpid_set)(dev, tpid);
1292 rte_eth_dev_set_vlan_offload(uint8_t port_id, int offload_mask)
1294 struct rte_eth_dev *dev;
1299 if (port_id >= nb_ports) {
1300 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1304 dev = &rte_eth_devices[port_id];
1306 /*check which option changed by application*/
1307 cur = !!(offload_mask & ETH_VLAN_STRIP_OFFLOAD);
1308 org = !!(dev->data->dev_conf.rxmode.hw_vlan_strip);
1310 dev->data->dev_conf.rxmode.hw_vlan_strip = (uint8_t)cur;
1311 mask |= ETH_VLAN_STRIP_MASK;
1314 cur = !!(offload_mask & ETH_VLAN_FILTER_OFFLOAD);
1315 org = !!(dev->data->dev_conf.rxmode.hw_vlan_filter);
1317 dev->data->dev_conf.rxmode.hw_vlan_filter = (uint8_t)cur;
1318 mask |= ETH_VLAN_FILTER_MASK;
1321 cur = !!(offload_mask & ETH_VLAN_EXTEND_OFFLOAD);
1322 org = !!(dev->data->dev_conf.rxmode.hw_vlan_extend);
1324 dev->data->dev_conf.rxmode.hw_vlan_extend = (uint8_t)cur;
1325 mask |= ETH_VLAN_EXTEND_MASK;
1332 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->vlan_offload_set, -ENOTSUP);
1333 (*dev->dev_ops->vlan_offload_set)(dev, mask);
1339 rte_eth_dev_get_vlan_offload(uint8_t port_id)
1341 struct rte_eth_dev *dev;
1344 if (port_id >= nb_ports) {
1345 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1349 dev = &rte_eth_devices[port_id];
1351 if (dev->data->dev_conf.rxmode.hw_vlan_strip)
1352 ret |= ETH_VLAN_STRIP_OFFLOAD ;
1354 if (dev->data->dev_conf.rxmode.hw_vlan_filter)
1355 ret |= ETH_VLAN_FILTER_OFFLOAD ;
1357 if (dev->data->dev_conf.rxmode.hw_vlan_extend)
1358 ret |= ETH_VLAN_EXTEND_OFFLOAD ;
1364 rte_eth_dev_set_vlan_pvid(uint8_t port_id, uint16_t pvid, int on)
1366 struct rte_eth_dev *dev;
1368 if (port_id >= nb_ports) {
1369 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1372 dev = &rte_eth_devices[port_id];
1373 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->vlan_pvid_set, -ENOTSUP);
1374 (*dev->dev_ops->vlan_pvid_set)(dev, pvid, on);
1380 rte_eth_dev_fdir_add_signature_filter(uint8_t port_id,
1381 struct rte_fdir_filter *fdir_filter,
1384 struct rte_eth_dev *dev;
1386 if (port_id >= nb_ports) {
1387 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1391 dev = &rte_eth_devices[port_id];
1393 if (dev->data->dev_conf.fdir_conf.mode != RTE_FDIR_MODE_SIGNATURE) {
1394 PMD_DEBUG_TRACE("port %d: invalid FDIR mode=%u\n",
1395 port_id, dev->data->dev_conf.fdir_conf.mode);
1399 if ((fdir_filter->l4type == RTE_FDIR_L4TYPE_SCTP
1400 || fdir_filter->l4type == RTE_FDIR_L4TYPE_NONE)
1401 && (fdir_filter->port_src || fdir_filter->port_dst)) {
1402 PMD_DEBUG_TRACE(" Port are meaningless for SCTP and " \
1403 "None l4type, source & destinations ports " \
1404 "should be null!\n");
1408 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_add_signature_filter, -ENOTSUP);
1409 return (*dev->dev_ops->fdir_add_signature_filter)(dev, fdir_filter,
1414 rte_eth_dev_fdir_update_signature_filter(uint8_t port_id,
1415 struct rte_fdir_filter *fdir_filter,
1418 struct rte_eth_dev *dev;
1420 if (port_id >= nb_ports) {
1421 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1425 dev = &rte_eth_devices[port_id];
1427 if (dev->data->dev_conf.fdir_conf.mode != RTE_FDIR_MODE_SIGNATURE) {
1428 PMD_DEBUG_TRACE("port %d: invalid FDIR mode=%u\n",
1429 port_id, dev->data->dev_conf.fdir_conf.mode);
1433 if ((fdir_filter->l4type == RTE_FDIR_L4TYPE_SCTP
1434 || fdir_filter->l4type == RTE_FDIR_L4TYPE_NONE)
1435 && (fdir_filter->port_src || fdir_filter->port_dst)) {
1436 PMD_DEBUG_TRACE(" Port are meaningless for SCTP and " \
1437 "None l4type, source & destinations ports " \
1438 "should be null!\n");
1442 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_update_signature_filter, -ENOTSUP);
1443 return (*dev->dev_ops->fdir_update_signature_filter)(dev, fdir_filter,
1449 rte_eth_dev_fdir_remove_signature_filter(uint8_t port_id,
1450 struct rte_fdir_filter *fdir_filter)
1452 struct rte_eth_dev *dev;
1454 if (port_id >= nb_ports) {
1455 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1459 dev = &rte_eth_devices[port_id];
1461 if (dev->data->dev_conf.fdir_conf.mode != RTE_FDIR_MODE_SIGNATURE) {
1462 PMD_DEBUG_TRACE("port %d: invalid FDIR mode=%u\n",
1463 port_id, dev->data->dev_conf.fdir_conf.mode);
1467 if ((fdir_filter->l4type == RTE_FDIR_L4TYPE_SCTP
1468 || fdir_filter->l4type == RTE_FDIR_L4TYPE_NONE)
1469 && (fdir_filter->port_src || fdir_filter->port_dst)) {
1470 PMD_DEBUG_TRACE(" Port are meaningless for SCTP and " \
1471 "None l4type source & destinations ports " \
1472 "should be null!\n");
1476 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_remove_signature_filter, -ENOTSUP);
1477 return (*dev->dev_ops->fdir_remove_signature_filter)(dev, fdir_filter);
1481 rte_eth_dev_fdir_get_infos(uint8_t port_id, struct rte_eth_fdir *fdir)
1483 struct rte_eth_dev *dev;
1485 if (port_id >= nb_ports) {
1486 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1490 dev = &rte_eth_devices[port_id];
1491 if (! (dev->data->dev_conf.fdir_conf.mode)) {
1492 PMD_DEBUG_TRACE("port %d: pkt-filter disabled\n", port_id);
1496 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_infos_get, -ENOTSUP);
1498 (*dev->dev_ops->fdir_infos_get)(dev, fdir);
1503 rte_eth_dev_fdir_add_perfect_filter(uint8_t port_id,
1504 struct rte_fdir_filter *fdir_filter,
1505 uint16_t soft_id, uint8_t queue,
1508 struct rte_eth_dev *dev;
1510 if (port_id >= nb_ports) {
1511 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1515 dev = &rte_eth_devices[port_id];
1517 if (dev->data->dev_conf.fdir_conf.mode != RTE_FDIR_MODE_PERFECT) {
1518 PMD_DEBUG_TRACE("port %d: invalid FDIR mode=%u\n",
1519 port_id, dev->data->dev_conf.fdir_conf.mode);
1523 if ((fdir_filter->l4type == RTE_FDIR_L4TYPE_SCTP
1524 || fdir_filter->l4type == RTE_FDIR_L4TYPE_NONE)
1525 && (fdir_filter->port_src || fdir_filter->port_dst)) {
1526 PMD_DEBUG_TRACE(" Port are meaningless for SCTP and " \
1527 "None l4type, source & destinations ports " \
1528 "should be null!\n");
1532 /* For now IPv6 is not supported with perfect filter */
1533 if (fdir_filter->iptype == RTE_FDIR_IPTYPE_IPV6)
1536 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_add_perfect_filter, -ENOTSUP);
1537 return (*dev->dev_ops->fdir_add_perfect_filter)(dev, fdir_filter,
1543 rte_eth_dev_fdir_update_perfect_filter(uint8_t port_id,
1544 struct rte_fdir_filter *fdir_filter,
1545 uint16_t soft_id, uint8_t queue,
1548 struct rte_eth_dev *dev;
1550 if (port_id >= nb_ports) {
1551 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1555 dev = &rte_eth_devices[port_id];
1557 if (dev->data->dev_conf.fdir_conf.mode != RTE_FDIR_MODE_PERFECT) {
1558 PMD_DEBUG_TRACE("port %d: invalid FDIR mode=%u\n",
1559 port_id, dev->data->dev_conf.fdir_conf.mode);
1563 if ((fdir_filter->l4type == RTE_FDIR_L4TYPE_SCTP
1564 || fdir_filter->l4type == RTE_FDIR_L4TYPE_NONE)
1565 && (fdir_filter->port_src || fdir_filter->port_dst)) {
1566 PMD_DEBUG_TRACE(" Port are meaningless for SCTP and " \
1567 "None l4type, source & destinations ports " \
1568 "should be null!\n");
1572 /* For now IPv6 is not supported with perfect filter */
1573 if (fdir_filter->iptype == RTE_FDIR_IPTYPE_IPV6)
1576 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_update_perfect_filter, -ENOTSUP);
1577 return (*dev->dev_ops->fdir_update_perfect_filter)(dev, fdir_filter,
1578 soft_id, queue, drop);
1582 rte_eth_dev_fdir_remove_perfect_filter(uint8_t port_id,
1583 struct rte_fdir_filter *fdir_filter,
1586 struct rte_eth_dev *dev;
1588 if (port_id >= nb_ports) {
1589 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1593 dev = &rte_eth_devices[port_id];
1595 if (dev->data->dev_conf.fdir_conf.mode != RTE_FDIR_MODE_PERFECT) {
1596 PMD_DEBUG_TRACE("port %d: invalid FDIR mode=%u\n",
1597 port_id, dev->data->dev_conf.fdir_conf.mode);
1601 if ((fdir_filter->l4type == RTE_FDIR_L4TYPE_SCTP
1602 || fdir_filter->l4type == RTE_FDIR_L4TYPE_NONE)
1603 && (fdir_filter->port_src || fdir_filter->port_dst)) {
1604 PMD_DEBUG_TRACE(" Port are meaningless for SCTP and " \
1605 "None l4type, source & destinations ports " \
1606 "should be null!\n");
1610 /* For now IPv6 is not supported with perfect filter */
1611 if (fdir_filter->iptype == RTE_FDIR_IPTYPE_IPV6)
1614 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_remove_perfect_filter, -ENOTSUP);
1615 return (*dev->dev_ops->fdir_remove_perfect_filter)(dev, fdir_filter,
1620 rte_eth_dev_fdir_set_masks(uint8_t port_id, struct rte_fdir_masks *fdir_mask)
1622 struct rte_eth_dev *dev;
1624 if (port_id >= nb_ports) {
1625 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1629 dev = &rte_eth_devices[port_id];
1630 if (! (dev->data->dev_conf.fdir_conf.mode)) {
1631 PMD_DEBUG_TRACE("port %d: pkt-filter disabled\n", port_id);
1635 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->fdir_set_masks, -ENOTSUP);
1636 return (*dev->dev_ops->fdir_set_masks)(dev, fdir_mask);
1640 rte_eth_dev_flow_ctrl_get(uint8_t port_id, struct rte_eth_fc_conf *fc_conf)
1642 struct rte_eth_dev *dev;
1644 if (port_id >= nb_ports) {
1645 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1649 dev = &rte_eth_devices[port_id];
1650 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->flow_ctrl_get, -ENOTSUP);
1651 memset(fc_conf, 0, sizeof(*fc_conf));
1652 return (*dev->dev_ops->flow_ctrl_get)(dev, fc_conf);
1656 rte_eth_dev_flow_ctrl_set(uint8_t port_id, struct rte_eth_fc_conf *fc_conf)
1658 struct rte_eth_dev *dev;
1660 if (port_id >= nb_ports) {
1661 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1665 if ((fc_conf->send_xon != 0) && (fc_conf->send_xon != 1)) {
1666 PMD_DEBUG_TRACE("Invalid send_xon, only 0/1 allowed\n");
1670 dev = &rte_eth_devices[port_id];
1671 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->flow_ctrl_set, -ENOTSUP);
1672 return (*dev->dev_ops->flow_ctrl_set)(dev, fc_conf);
1676 rte_eth_dev_priority_flow_ctrl_set(uint8_t port_id, struct rte_eth_pfc_conf *pfc_conf)
1678 struct rte_eth_dev *dev;
1680 if (port_id >= nb_ports) {
1681 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1685 if (pfc_conf->priority > (ETH_DCB_NUM_USER_PRIORITIES - 1)) {
1686 PMD_DEBUG_TRACE("Invalid priority, only 0-7 allowed\n");
1690 dev = &rte_eth_devices[port_id];
1691 /* High water, low water validation are device specific */
1692 if (*dev->dev_ops->priority_flow_ctrl_set)
1693 return (*dev->dev_ops->priority_flow_ctrl_set)(dev, pfc_conf);
1698 rte_eth_dev_rss_reta_update(uint8_t port_id, struct rte_eth_rss_reta *reta_conf)
1700 struct rte_eth_dev *dev;
1704 if (port_id >= nb_ports) {
1705 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1709 /* Invalid mask bit(s) setting */
1710 if ((reta_conf->mask_lo == 0) && (reta_conf->mask_hi == 0)) {
1711 PMD_DEBUG_TRACE("Invalid update mask bits for port=%d\n",port_id);
1715 dev = &rte_eth_devices[port_id];
1716 max_rxq = (dev->data->nb_rx_queues <= ETH_RSS_RETA_MAX_QUEUE) ?
1717 dev->data->nb_rx_queues : ETH_RSS_RETA_MAX_QUEUE;
1718 if (reta_conf->mask_lo != 0) {
1719 for (i = 0; i < ETH_RSS_RETA_NUM_ENTRIES/2; i++) {
1720 if ((reta_conf->mask_lo & (1ULL << i)) &&
1721 (reta_conf->reta[i] >= max_rxq)) {
1722 PMD_DEBUG_TRACE("RETA hash index output"
1723 "configration for port=%d,invalid"
1724 "queue=%d\n",port_id,reta_conf->reta[i]);
1731 if (reta_conf->mask_hi != 0) {
1732 for (i = 0; i< ETH_RSS_RETA_NUM_ENTRIES/2; i++) {
1733 j = (uint8_t)(i + ETH_RSS_RETA_NUM_ENTRIES/2);
1735 /* Check if the max entry >= 128 */
1736 if ((reta_conf->mask_hi & (1ULL << i)) &&
1737 (reta_conf->reta[j] >= max_rxq)) {
1738 PMD_DEBUG_TRACE("RETA hash index output"
1739 "configration for port=%d,invalid"
1740 "queue=%d\n",port_id,reta_conf->reta[j]);
1747 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->reta_update, -ENOTSUP);
1748 return (*dev->dev_ops->reta_update)(dev, reta_conf);
1752 rte_eth_dev_rss_reta_query(uint8_t port_id, struct rte_eth_rss_reta *reta_conf)
1754 struct rte_eth_dev *dev;
1756 if (port_id >= nb_ports) {
1757 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1761 if((reta_conf->mask_lo == 0) && (reta_conf->mask_hi == 0)) {
1762 PMD_DEBUG_TRACE("Invalid update mask bits for the port=%d\n",port_id);
1766 dev = &rte_eth_devices[port_id];
1767 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->reta_query, -ENOTSUP);
1768 return (*dev->dev_ops->reta_query)(dev, reta_conf);
1772 rte_eth_dev_rss_hash_update(uint8_t port_id, struct rte_eth_rss_conf *rss_conf)
1774 struct rte_eth_dev *dev;
1775 uint16_t rss_hash_protos;
1777 if (port_id >= nb_ports) {
1778 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1781 rss_hash_protos = rss_conf->rss_hf;
1782 if ((rss_hash_protos != 0) &&
1783 ((rss_hash_protos & ETH_RSS_PROTO_MASK) == 0)) {
1784 PMD_DEBUG_TRACE("Invalid rss_hash_protos=0x%x\n",
1788 dev = &rte_eth_devices[port_id];
1789 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rss_hash_update, -ENOTSUP);
1790 return (*dev->dev_ops->rss_hash_update)(dev, rss_conf);
1794 rte_eth_dev_rss_hash_conf_get(uint8_t port_id,
1795 struct rte_eth_rss_conf *rss_conf)
1797 struct rte_eth_dev *dev;
1799 if (port_id >= nb_ports) {
1800 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1803 dev = &rte_eth_devices[port_id];
1804 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rss_hash_conf_get, -ENOTSUP);
1805 return (*dev->dev_ops->rss_hash_conf_get)(dev, rss_conf);
1809 rte_eth_led_on(uint8_t port_id)
1811 struct rte_eth_dev *dev;
1813 if (port_id >= nb_ports) {
1814 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1818 dev = &rte_eth_devices[port_id];
1819 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_led_on, -ENOTSUP);
1820 return ((*dev->dev_ops->dev_led_on)(dev));
1824 rte_eth_led_off(uint8_t port_id)
1826 struct rte_eth_dev *dev;
1828 if (port_id >= nb_ports) {
1829 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1833 dev = &rte_eth_devices[port_id];
1834 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_led_off, -ENOTSUP);
1835 return ((*dev->dev_ops->dev_led_off)(dev));
1839 * Returns index into MAC address array of addr. Use 00:00:00:00:00:00 to find
1843 get_mac_addr_index(uint8_t port_id, struct ether_addr *addr)
1845 struct rte_eth_dev_info dev_info;
1846 struct rte_eth_dev *dev = &rte_eth_devices[port_id];
1849 rte_eth_dev_info_get(port_id, &dev_info);
1851 for (i = 0; i < dev_info.max_mac_addrs; i++)
1852 if (memcmp(addr, &dev->data->mac_addrs[i], ETHER_ADDR_LEN) == 0)
1858 static struct ether_addr null_mac_addr = {{0, 0, 0, 0, 0, 0}};
1861 rte_eth_dev_mac_addr_add(uint8_t port_id, struct ether_addr *addr,
1864 struct rte_eth_dev *dev;
1868 if (port_id >= nb_ports) {
1869 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1872 dev = &rte_eth_devices[port_id];
1873 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->mac_addr_add, -ENOTSUP);
1875 if (is_zero_ether_addr(addr)) {
1876 PMD_DEBUG_TRACE("port %d: Cannot add NULL MAC address\n",
1880 if (pool >= ETH_64_POOLS) {
1881 PMD_DEBUG_TRACE("pool id must be 0-%d\n",ETH_64_POOLS - 1);
1885 index = get_mac_addr_index(port_id, addr);
1887 index = get_mac_addr_index(port_id, &null_mac_addr);
1889 PMD_DEBUG_TRACE("port %d: MAC address array full\n",
1894 pool_mask = dev->data->mac_pool_sel[index];
1896 /* Check if both MAC address and pool is alread there, and do nothing */
1897 if (pool_mask & (1ULL << pool))
1902 (*dev->dev_ops->mac_addr_add)(dev, addr, index, pool);
1904 /* Update address in NIC data structure */
1905 ether_addr_copy(addr, &dev->data->mac_addrs[index]);
1907 /* Update pool bitmap in NIC data structure */
1908 dev->data->mac_pool_sel[index] |= (1ULL << pool);
1914 rte_eth_dev_mac_addr_remove(uint8_t port_id, struct ether_addr *addr)
1916 struct rte_eth_dev *dev;
1919 if (port_id >= nb_ports) {
1920 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
1923 dev = &rte_eth_devices[port_id];
1924 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->mac_addr_remove, -ENOTSUP);
1926 index = get_mac_addr_index(port_id, addr);
1928 PMD_DEBUG_TRACE("port %d: Cannot remove default MAC address\n", port_id);
1929 return (-EADDRINUSE);
1930 } else if (index < 0)
1931 return 0; /* Do nothing if address wasn't found */
1934 (*dev->dev_ops->mac_addr_remove)(dev, index);
1936 /* Update address in NIC data structure */
1937 ether_addr_copy(&null_mac_addr, &dev->data->mac_addrs[index]);
1943 rte_eth_dev_set_vf_rxmode(uint8_t port_id, uint16_t vf,
1944 uint16_t rx_mode, uint8_t on)
1947 struct rte_eth_dev *dev;
1948 struct rte_eth_dev_info dev_info;
1950 if (port_id >= nb_ports) {
1951 PMD_DEBUG_TRACE("set VF RX mode:Invalid port_id=%d\n",
1956 dev = &rte_eth_devices[port_id];
1957 rte_eth_dev_info_get(port_id, &dev_info);
1959 num_vfs = dev_info.max_vfs;
1962 PMD_DEBUG_TRACE("set VF RX mode:invalid VF id %d\n", vf);
1967 PMD_DEBUG_TRACE("set VF RX mode:mode mask ca not be zero\n");
1970 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_vf_rx_mode, -ENOTSUP);
1971 return (*dev->dev_ops->set_vf_rx_mode)(dev, vf, rx_mode, on);
1975 * Returns index into MAC address array of addr. Use 00:00:00:00:00:00 to find
1979 get_hash_mac_addr_index(uint8_t port_id, struct ether_addr *addr)
1981 struct rte_eth_dev_info dev_info;
1982 struct rte_eth_dev *dev = &rte_eth_devices[port_id];
1985 rte_eth_dev_info_get(port_id, &dev_info);
1986 if (!dev->data->hash_mac_addrs)
1989 for (i = 0; i < dev_info.max_hash_mac_addrs; i++)
1990 if (memcmp(addr, &dev->data->hash_mac_addrs[i],
1991 ETHER_ADDR_LEN) == 0)
1998 rte_eth_dev_uc_hash_table_set(uint8_t port_id, struct ether_addr *addr,
2003 struct rte_eth_dev *dev;
2005 if (port_id >= nb_ports) {
2006 PMD_DEBUG_TRACE("unicast hash setting:Invalid port_id=%d\n",
2011 dev = &rte_eth_devices[port_id];
2012 if (is_zero_ether_addr(addr)) {
2013 PMD_DEBUG_TRACE("port %d: Cannot add NULL MAC address\n",
2018 index = get_hash_mac_addr_index(port_id, addr);
2019 /* Check if it's already there, and do nothing */
2020 if ((index >= 0) && (on))
2025 PMD_DEBUG_TRACE("port %d: the MAC address was not"
2026 "set in UTA\n", port_id);
2030 index = get_hash_mac_addr_index(port_id, &null_mac_addr);
2032 PMD_DEBUG_TRACE("port %d: MAC address array full\n",
2038 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->uc_hash_table_set, -ENOTSUP);
2039 ret = (*dev->dev_ops->uc_hash_table_set)(dev, addr, on);
2041 /* Update address in NIC data structure */
2043 ether_addr_copy(addr,
2044 &dev->data->hash_mac_addrs[index]);
2046 ether_addr_copy(&null_mac_addr,
2047 &dev->data->hash_mac_addrs[index]);
2054 rte_eth_dev_uc_all_hash_table_set(uint8_t port_id, uint8_t on)
2056 struct rte_eth_dev *dev;
2058 if (port_id >= nb_ports) {
2059 PMD_DEBUG_TRACE("unicast hash setting:Invalid port_id=%d\n",
2064 dev = &rte_eth_devices[port_id];
2066 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->uc_all_hash_table_set, -ENOTSUP);
2067 return (*dev->dev_ops->uc_all_hash_table_set)(dev, on);
2071 rte_eth_dev_set_vf_rx(uint8_t port_id,uint16_t vf, uint8_t on)
2074 struct rte_eth_dev *dev;
2075 struct rte_eth_dev_info dev_info;
2077 if (port_id >= nb_ports) {
2078 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2082 dev = &rte_eth_devices[port_id];
2083 rte_eth_dev_info_get(port_id, &dev_info);
2085 num_vfs = dev_info.max_vfs;
2088 PMD_DEBUG_TRACE("port %d: invalid vf id\n", port_id);
2092 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_vf_rx, -ENOTSUP);
2093 return (*dev->dev_ops->set_vf_rx)(dev, vf,on);
2097 rte_eth_dev_set_vf_tx(uint8_t port_id,uint16_t vf, uint8_t on)
2100 struct rte_eth_dev *dev;
2101 struct rte_eth_dev_info dev_info;
2103 if (port_id >= nb_ports) {
2104 PMD_DEBUG_TRACE("set pool tx:Invalid port_id=%d\n", port_id);
2108 dev = &rte_eth_devices[port_id];
2109 rte_eth_dev_info_get(port_id, &dev_info);
2111 num_vfs = dev_info.max_vfs;
2114 PMD_DEBUG_TRACE("set pool tx:invalid pool id=%d\n", vf);
2118 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_vf_tx, -ENOTSUP);
2119 return (*dev->dev_ops->set_vf_tx)(dev, vf,on);
2123 rte_eth_dev_set_vf_vlan_filter(uint8_t port_id, uint16_t vlan_id,
2124 uint64_t vf_mask,uint8_t vlan_on)
2126 struct rte_eth_dev *dev;
2128 if (port_id >= nb_ports) {
2129 PMD_DEBUG_TRACE("VF VLAN filter:invalid port id=%d\n",
2133 dev = &rte_eth_devices[port_id];
2135 if(vlan_id > ETHER_MAX_VLAN_ID)
2137 PMD_DEBUG_TRACE("VF VLAN filter:invalid VLAN id=%d\n",
2143 PMD_DEBUG_TRACE("VF VLAN filter:pool_mask can not be 0\n");
2147 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_vf_vlan_filter, -ENOTSUP);
2148 return (*dev->dev_ops->set_vf_vlan_filter)(dev, vlan_id,
2152 int rte_eth_set_queue_rate_limit(uint8_t port_id, uint16_t queue_idx,
2155 struct rte_eth_dev *dev;
2156 struct rte_eth_dev_info dev_info;
2157 struct rte_eth_link link;
2159 if (port_id >= nb_ports) {
2160 PMD_DEBUG_TRACE("set queue rate limit:invalid port id=%d\n",
2165 dev = &rte_eth_devices[port_id];
2166 rte_eth_dev_info_get(port_id, &dev_info);
2167 link = dev->data->dev_link;
2169 if (queue_idx > dev_info.max_tx_queues) {
2170 PMD_DEBUG_TRACE("set queue rate limit:port %d: "
2171 "invalid queue id=%d\n", port_id, queue_idx);
2175 if (tx_rate > link.link_speed) {
2176 PMD_DEBUG_TRACE("set queue rate limit:invalid tx_rate=%d, "
2177 "bigger than link speed= %d\n",
2178 tx_rate, link_speed);
2182 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_queue_rate_limit, -ENOTSUP);
2183 return (*dev->dev_ops->set_queue_rate_limit)(dev, queue_idx, tx_rate);
2186 int rte_eth_set_vf_rate_limit(uint8_t port_id, uint16_t vf, uint16_t tx_rate,
2189 struct rte_eth_dev *dev;
2190 struct rte_eth_dev_info dev_info;
2191 struct rte_eth_link link;
2196 if (port_id >= nb_ports) {
2197 PMD_DEBUG_TRACE("set VF rate limit:invalid port id=%d\n",
2202 dev = &rte_eth_devices[port_id];
2203 rte_eth_dev_info_get(port_id, &dev_info);
2204 link = dev->data->dev_link;
2206 if (vf > dev_info.max_vfs) {
2207 PMD_DEBUG_TRACE("set VF rate limit:port %d: "
2208 "invalid vf id=%d\n", port_id, vf);
2212 if (tx_rate > link.link_speed) {
2213 PMD_DEBUG_TRACE("set VF rate limit:invalid tx_rate=%d, "
2214 "bigger than link speed= %d\n",
2215 tx_rate, link_speed);
2219 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_vf_rate_limit, -ENOTSUP);
2220 return (*dev->dev_ops->set_vf_rate_limit)(dev, vf, tx_rate, q_msk);
2224 rte_eth_mirror_rule_set(uint8_t port_id,
2225 struct rte_eth_vmdq_mirror_conf *mirror_conf,
2226 uint8_t rule_id, uint8_t on)
2228 struct rte_eth_dev *dev = &rte_eth_devices[port_id];
2230 if (port_id >= nb_ports) {
2231 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2235 if (mirror_conf->rule_type_mask == 0) {
2236 PMD_DEBUG_TRACE("mirror rule type can not be 0.\n");
2240 if (mirror_conf->dst_pool >= ETH_64_POOLS) {
2241 PMD_DEBUG_TRACE("Invalid dst pool, pool id must"
2242 "be 0-%d\n",ETH_64_POOLS - 1);
2246 if ((mirror_conf->rule_type_mask & ETH_VMDQ_POOL_MIRROR) &&
2247 (mirror_conf->pool_mask == 0)) {
2248 PMD_DEBUG_TRACE("Invalid mirror pool, pool mask can not"
2253 if(rule_id >= ETH_VMDQ_NUM_MIRROR_RULE)
2255 PMD_DEBUG_TRACE("Invalid rule_id, rule_id must be 0-%d\n",
2256 ETH_VMDQ_NUM_MIRROR_RULE - 1);
2260 dev = &rte_eth_devices[port_id];
2261 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->mirror_rule_set, -ENOTSUP);
2263 return (*dev->dev_ops->mirror_rule_set)(dev, mirror_conf, rule_id, on);
2267 rte_eth_mirror_rule_reset(uint8_t port_id, uint8_t rule_id)
2269 struct rte_eth_dev *dev = &rte_eth_devices[port_id];
2271 if (port_id >= nb_ports) {
2272 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2276 if(rule_id >= ETH_VMDQ_NUM_MIRROR_RULE)
2278 PMD_DEBUG_TRACE("Invalid rule_id, rule_id must be 0-%d\n",
2279 ETH_VMDQ_NUM_MIRROR_RULE-1);
2283 dev = &rte_eth_devices[port_id];
2284 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->mirror_rule_reset, -ENOTSUP);
2286 return (*dev->dev_ops->mirror_rule_reset)(dev, rule_id);
2289 #ifdef RTE_LIBRTE_ETHDEV_DEBUG
2291 rte_eth_rx_burst(uint8_t port_id, uint16_t queue_id,
2292 struct rte_mbuf **rx_pkts, uint16_t nb_pkts)
2294 struct rte_eth_dev *dev;
2296 if (port_id >= nb_ports) {
2297 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2300 dev = &rte_eth_devices[port_id];
2301 FUNC_PTR_OR_ERR_RET(*dev->rx_pkt_burst, -ENOTSUP);
2302 if (queue_id >= dev->data->nb_rx_queues) {
2303 PMD_DEBUG_TRACE("Invalid RX queue_id=%d\n", queue_id);
2306 return (*dev->rx_pkt_burst)(dev->data->rx_queues[queue_id],
2311 rte_eth_tx_burst(uint8_t port_id, uint16_t queue_id,
2312 struct rte_mbuf **tx_pkts, uint16_t nb_pkts)
2314 struct rte_eth_dev *dev;
2316 if (port_id >= nb_ports) {
2317 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2320 dev = &rte_eth_devices[port_id];
2322 FUNC_PTR_OR_ERR_RET(*dev->tx_pkt_burst, -ENOTSUP);
2323 if (queue_id >= dev->data->nb_tx_queues) {
2324 PMD_DEBUG_TRACE("Invalid TX queue_id=%d\n", queue_id);
2327 return (*dev->tx_pkt_burst)(dev->data->tx_queues[queue_id],
2332 rte_eth_rx_queue_count(uint8_t port_id, uint16_t queue_id)
2334 struct rte_eth_dev *dev;
2336 if (port_id >= nb_ports) {
2337 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2340 dev = &rte_eth_devices[port_id];
2341 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_count, -ENOTSUP);
2342 return (*dev->dev_ops->rx_queue_count)(dev, queue_id);
2346 rte_eth_rx_descriptor_done(uint8_t port_id, uint16_t queue_id, uint16_t offset)
2348 struct rte_eth_dev *dev;
2350 if (port_id >= nb_ports) {
2351 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2354 dev = &rte_eth_devices[port_id];
2355 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_descriptor_done, -ENOTSUP);
2356 return (*dev->dev_ops->rx_descriptor_done)( \
2357 dev->data->rx_queues[queue_id], offset);
2362 rte_eth_dev_callback_register(uint8_t port_id,
2363 enum rte_eth_event_type event,
2364 rte_eth_dev_cb_fn cb_fn, void *cb_arg)
2366 struct rte_eth_dev *dev;
2367 struct rte_eth_dev_callback *user_cb;
2371 if (port_id >= nb_ports) {
2372 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2376 dev = &rte_eth_devices[port_id];
2377 rte_spinlock_lock(&rte_eth_dev_cb_lock);
2379 TAILQ_FOREACH(user_cb, &(dev->callbacks), next) {
2380 if (user_cb->cb_fn == cb_fn &&
2381 user_cb->cb_arg == cb_arg &&
2382 user_cb->event == event) {
2387 /* create a new callback. */
2388 if (user_cb == NULL && (user_cb = rte_zmalloc("INTR_USER_CALLBACK",
2389 sizeof(struct rte_eth_dev_callback), 0)) != NULL) {
2390 user_cb->cb_fn = cb_fn;
2391 user_cb->cb_arg = cb_arg;
2392 user_cb->event = event;
2393 TAILQ_INSERT_TAIL(&(dev->callbacks), user_cb, next);
2396 rte_spinlock_unlock(&rte_eth_dev_cb_lock);
2397 return ((user_cb == NULL) ? -ENOMEM : 0);
2401 rte_eth_dev_callback_unregister(uint8_t port_id,
2402 enum rte_eth_event_type event,
2403 rte_eth_dev_cb_fn cb_fn, void *cb_arg)
2406 struct rte_eth_dev *dev;
2407 struct rte_eth_dev_callback *cb, *next;
2411 if (port_id >= nb_ports) {
2412 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2416 dev = &rte_eth_devices[port_id];
2417 rte_spinlock_lock(&rte_eth_dev_cb_lock);
2420 for (cb = TAILQ_FIRST(&dev->callbacks); cb != NULL; cb = next) {
2422 next = TAILQ_NEXT(cb, next);
2424 if (cb->cb_fn != cb_fn || cb->event != event ||
2425 (cb->cb_arg != (void *)-1 &&
2426 cb->cb_arg != cb_arg))
2430 * if this callback is not executing right now,
2433 if (cb->active == 0) {
2434 TAILQ_REMOVE(&(dev->callbacks), cb, next);
2441 rte_spinlock_unlock(&rte_eth_dev_cb_lock);
2446 _rte_eth_dev_callback_process(struct rte_eth_dev *dev,
2447 enum rte_eth_event_type event)
2449 struct rte_eth_dev_callback *cb_lst;
2450 struct rte_eth_dev_callback dev_cb;
2452 rte_spinlock_lock(&rte_eth_dev_cb_lock);
2453 TAILQ_FOREACH(cb_lst, &(dev->callbacks), next) {
2454 if (cb_lst->cb_fn == NULL || cb_lst->event != event)
2458 rte_spinlock_unlock(&rte_eth_dev_cb_lock);
2459 dev_cb.cb_fn(dev->data->port_id, dev_cb.event,
2461 rte_spinlock_lock(&rte_eth_dev_cb_lock);
2464 rte_spinlock_unlock(&rte_eth_dev_cb_lock);
2466 #ifdef RTE_NIC_BYPASS
2467 int rte_eth_dev_bypass_init(uint8_t port_id)
2469 struct rte_eth_dev *dev;
2471 if (port_id >= nb_ports) {
2472 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2476 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2477 PMD_DEBUG_TRACE("Invalid port device\n");
2481 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_init, -ENOTSUP);
2482 (*dev->dev_ops->bypass_init)(dev);
2487 rte_eth_dev_bypass_state_show(uint8_t port_id, uint32_t *state)
2489 struct rte_eth_dev *dev;
2491 if (port_id >= nb_ports) {
2492 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2496 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2497 PMD_DEBUG_TRACE("Invalid port device\n");
2500 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_state_show, -ENOTSUP);
2501 (*dev->dev_ops->bypass_state_show)(dev, state);
2506 rte_eth_dev_bypass_state_set(uint8_t port_id, uint32_t *new_state)
2508 struct rte_eth_dev *dev;
2510 if (port_id >= nb_ports) {
2511 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2515 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2516 PMD_DEBUG_TRACE("Invalid port device\n");
2520 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_state_set, -ENOTSUP);
2521 (*dev->dev_ops->bypass_state_set)(dev, new_state);
2526 rte_eth_dev_bypass_event_show(uint8_t port_id, uint32_t event, uint32_t *state)
2528 struct rte_eth_dev *dev;
2530 if (port_id >= nb_ports) {
2531 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2535 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2536 PMD_DEBUG_TRACE("Invalid port device\n");
2540 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_state_show, -ENOTSUP);
2541 (*dev->dev_ops->bypass_event_show)(dev, event, state);
2546 rte_eth_dev_bypass_event_store(uint8_t port_id, uint32_t event, uint32_t state)
2548 struct rte_eth_dev *dev;
2550 if (port_id >= nb_ports) {
2551 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2555 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2556 PMD_DEBUG_TRACE("Invalid port device\n");
2560 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_event_set, -ENOTSUP);
2561 (*dev->dev_ops->bypass_event_set)(dev, event, state);
2566 rte_eth_dev_wd_timeout_store(uint8_t port_id, uint32_t timeout)
2568 struct rte_eth_dev *dev;
2570 if (port_id >= nb_ports) {
2571 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2575 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2576 PMD_DEBUG_TRACE("Invalid port device\n");
2580 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_wd_timeout_set, -ENOTSUP);
2581 (*dev->dev_ops->bypass_wd_timeout_set)(dev, timeout);
2586 rte_eth_dev_bypass_ver_show(uint8_t port_id, uint32_t *ver)
2588 struct rte_eth_dev *dev;
2590 if (port_id >= nb_ports) {
2591 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2595 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2596 PMD_DEBUG_TRACE("Invalid port device\n");
2600 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_ver_show, -ENOTSUP);
2601 (*dev->dev_ops->bypass_ver_show)(dev, ver);
2606 rte_eth_dev_bypass_wd_timeout_show(uint8_t port_id, uint32_t *wd_timeout)
2608 struct rte_eth_dev *dev;
2610 if (port_id >= nb_ports) {
2611 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2615 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2616 PMD_DEBUG_TRACE("Invalid port device\n");
2620 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_wd_timeout_show, -ENOTSUP);
2621 (*dev->dev_ops->bypass_wd_timeout_show)(dev, wd_timeout);
2626 rte_eth_dev_bypass_wd_reset(uint8_t port_id)
2628 struct rte_eth_dev *dev;
2630 if (port_id >= nb_ports) {
2631 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2635 if ((dev= &rte_eth_devices[port_id]) == NULL) {
2636 PMD_DEBUG_TRACE("Invalid port device\n");
2640 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->bypass_wd_reset, -ENOTSUP);
2641 (*dev->dev_ops->bypass_wd_reset)(dev);
2647 rte_eth_dev_add_syn_filter(uint8_t port_id,
2648 struct rte_syn_filter *filter, uint16_t rx_queue)
2650 struct rte_eth_dev *dev;
2652 if (port_id >= nb_ports) {
2653 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2657 dev = &rte_eth_devices[port_id];
2658 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->add_syn_filter, -ENOTSUP);
2659 return (*dev->dev_ops->add_syn_filter)(dev, filter, rx_queue);
2663 rte_eth_dev_remove_syn_filter(uint8_t port_id)
2665 struct rte_eth_dev *dev;
2667 if (port_id >= nb_ports) {
2668 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2672 dev = &rte_eth_devices[port_id];
2673 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->remove_syn_filter, -ENOTSUP);
2674 return (*dev->dev_ops->remove_syn_filter)(dev);
2678 rte_eth_dev_get_syn_filter(uint8_t port_id,
2679 struct rte_syn_filter *filter, uint16_t *rx_queue)
2681 struct rte_eth_dev *dev;
2683 if (filter == NULL || rx_queue == NULL)
2686 if (port_id >= nb_ports) {
2687 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2691 dev = &rte_eth_devices[port_id];
2692 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->get_syn_filter, -ENOTSUP);
2693 return (*dev->dev_ops->get_syn_filter)(dev, filter, rx_queue);
2697 rte_eth_dev_add_ethertype_filter(uint8_t port_id, uint16_t index,
2698 struct rte_ethertype_filter *filter, uint16_t rx_queue)
2700 struct rte_eth_dev *dev;
2702 if (port_id >= nb_ports) {
2703 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2706 if (filter->ethertype == ETHER_TYPE_IPv4 ||
2707 filter->ethertype == ETHER_TYPE_IPv6){
2708 PMD_DEBUG_TRACE("IP and IPv6 are not supported"
2709 " in ethertype filter\n");
2712 dev = &rte_eth_devices[port_id];
2713 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->add_ethertype_filter, -ENOTSUP);
2714 return (*dev->dev_ops->add_ethertype_filter)(dev, index,
2719 rte_eth_dev_remove_ethertype_filter(uint8_t port_id, uint16_t index)
2721 struct rte_eth_dev *dev;
2723 if (port_id >= nb_ports) {
2724 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2728 dev = &rte_eth_devices[port_id];
2729 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->remove_ethertype_filter, -ENOTSUP);
2730 return (*dev->dev_ops->remove_ethertype_filter)(dev, index);
2734 rte_eth_dev_get_ethertype_filter(uint8_t port_id, uint16_t index,
2735 struct rte_ethertype_filter *filter, uint16_t *rx_queue)
2737 struct rte_eth_dev *dev;
2739 if (filter == NULL || rx_queue == NULL)
2742 if (port_id >= nb_ports) {
2743 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2747 dev = &rte_eth_devices[port_id];
2748 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->get_ethertype_filter, -ENOTSUP);
2749 return (*dev->dev_ops->get_ethertype_filter)(dev, index,
2754 rte_eth_dev_add_2tuple_filter(uint8_t port_id, uint16_t index,
2755 struct rte_2tuple_filter *filter, uint16_t rx_queue)
2757 struct rte_eth_dev *dev;
2759 if (port_id >= nb_ports) {
2760 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2763 if (filter->protocol != IPPROTO_TCP &&
2764 filter->tcp_flags != 0){
2765 PMD_DEBUG_TRACE("tcp flags is 0x%x, but the protocol value"
2771 dev = &rte_eth_devices[port_id];
2772 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->add_2tuple_filter, -ENOTSUP);
2773 return (*dev->dev_ops->add_2tuple_filter)(dev, index, filter, rx_queue);
2777 rte_eth_dev_remove_2tuple_filter(uint8_t port_id, uint16_t index)
2779 struct rte_eth_dev *dev;
2781 if (port_id >= nb_ports) {
2782 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2786 dev = &rte_eth_devices[port_id];
2787 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->remove_2tuple_filter, -ENOTSUP);
2788 return (*dev->dev_ops->remove_2tuple_filter)(dev, index);
2792 rte_eth_dev_get_2tuple_filter(uint8_t port_id, uint16_t index,
2793 struct rte_2tuple_filter *filter, uint16_t *rx_queue)
2795 struct rte_eth_dev *dev;
2797 if (filter == NULL || rx_queue == NULL)
2800 if (port_id >= nb_ports) {
2801 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2805 dev = &rte_eth_devices[port_id];
2806 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->get_2tuple_filter, -ENOTSUP);
2807 return (*dev->dev_ops->get_2tuple_filter)(dev, index, filter, rx_queue);
2811 rte_eth_dev_add_5tuple_filter(uint8_t port_id, uint16_t index,
2812 struct rte_5tuple_filter *filter, uint16_t rx_queue)
2814 struct rte_eth_dev *dev;
2816 if (port_id >= nb_ports) {
2817 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2821 if (filter->protocol != IPPROTO_TCP &&
2822 filter->tcp_flags != 0){
2823 PMD_DEBUG_TRACE("tcp flags is 0x%x, but the protocol value"
2829 dev = &rte_eth_devices[port_id];
2830 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->add_5tuple_filter, -ENOTSUP);
2831 return (*dev->dev_ops->add_5tuple_filter)(dev, index, filter, rx_queue);
2835 rte_eth_dev_remove_5tuple_filter(uint8_t port_id, uint16_t index)
2837 struct rte_eth_dev *dev;
2839 if (port_id >= nb_ports) {
2840 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2844 dev = &rte_eth_devices[port_id];
2845 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->remove_5tuple_filter, -ENOTSUP);
2846 return (*dev->dev_ops->remove_5tuple_filter)(dev, index);
2850 rte_eth_dev_get_5tuple_filter(uint8_t port_id, uint16_t index,
2851 struct rte_5tuple_filter *filter, uint16_t *rx_queue)
2853 struct rte_eth_dev *dev;
2855 if (filter == NULL || rx_queue == NULL)
2858 if (port_id >= nb_ports) {
2859 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2863 dev = &rte_eth_devices[port_id];
2864 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->get_5tuple_filter, -ENOTSUP);
2865 return (*dev->dev_ops->get_5tuple_filter)(dev, index, filter,
2870 rte_eth_dev_add_flex_filter(uint8_t port_id, uint16_t index,
2871 struct rte_flex_filter *filter, uint16_t rx_queue)
2873 struct rte_eth_dev *dev;
2875 if (port_id >= nb_ports) {
2876 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2880 dev = &rte_eth_devices[port_id];
2881 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->add_flex_filter, -ENOTSUP);
2882 return (*dev->dev_ops->add_flex_filter)(dev, index, filter, rx_queue);
2886 rte_eth_dev_remove_flex_filter(uint8_t port_id, uint16_t index)
2888 struct rte_eth_dev *dev;
2890 if (port_id >= nb_ports) {
2891 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2895 dev = &rte_eth_devices[port_id];
2896 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->remove_flex_filter, -ENOTSUP);
2897 return (*dev->dev_ops->remove_flex_filter)(dev, index);
2901 rte_eth_dev_get_flex_filter(uint8_t port_id, uint16_t index,
2902 struct rte_flex_filter *filter, uint16_t *rx_queue)
2904 struct rte_eth_dev *dev;
2906 if (filter == NULL || rx_queue == NULL)
2909 if (port_id >= nb_ports) {
2910 PMD_DEBUG_TRACE("Invalid port_id=%d\n", port_id);
2914 dev = &rte_eth_devices[port_id];
2915 FUNC_PTR_OR_ERR_RET(*dev->dev_ops->get_flex_filter, -ENOTSUP);
2916 return (*dev->dev_ops->get_flex_filter)(dev, index, filter,