ethdev: Tx rate limitation for queue and VF

Add API to support setting TX rate for a queue and a VF.

Signed-off-by: Ouyang Changchun <changchun.ouyang@intel.com>
Acked-by: Jijiang Liu <jijiang.liu@intel.com>
Tested-by: Waterman Cao <waterman.cao@intel.com>
Acked-by: Huawei Xie <huawei.xie@intel.com>

diff --git a/lib/librte_ether/rte_ethdev.c b/lib/librte_ether/rte_ethdev.c
index aac3478..8011b8b 100644 (file)
--- a/lib/librte_ether/rte_ethdev.c
+++ b/lib/librte_ether/rte_ethdev.c
@@ -2113,6 +2113,77 @@ rte_eth_dev_set_vf_vlan_filter(uint8_t port_id, uint16_t vlan_id,
                                                vf_mask,vlan_on);
 }
 
+int rte_eth_set_queue_rate_limit(uint8_t port_id, uint16_t queue_idx,
+                                       uint16_t tx_rate)
+{
+       struct rte_eth_dev *dev;
+       struct rte_eth_dev_info dev_info;
+       struct rte_eth_link link;
+
+       if (port_id >= nb_ports) {
+               PMD_DEBUG_TRACE("set queue rate limit:invalid port id=%d\n",
+                               port_id);
+               return -ENODEV;
+       }
+
+       dev = &rte_eth_devices[port_id];
+       rte_eth_dev_info_get(port_id, &dev_info);
+       link = dev->data->dev_link;
+
+       if (queue_idx > dev_info.max_tx_queues) {
+               PMD_DEBUG_TRACE("set queue rate limit:port %d: "
+                               "invalid queue id=%d\n", port_id, queue_idx);
+               return -EINVAL;
+       }
+
+       if (tx_rate > link.link_speed) {
+               PMD_DEBUG_TRACE("set queue rate limit:invalid tx_rate=%d, "
+                               "bigger than link speed= %d\n",
+                       tx_rate, link_speed);
+               return -EINVAL;
+       }
+
+       FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_queue_rate_limit, -ENOTSUP);
+       return (*dev->dev_ops->set_queue_rate_limit)(dev, queue_idx, tx_rate);
+}
+
+int rte_eth_set_vf_rate_limit(uint8_t port_id, uint16_t vf, uint16_t tx_rate,
+                               uint64_t q_msk)
+{
+       struct rte_eth_dev *dev;
+       struct rte_eth_dev_info dev_info;
+       struct rte_eth_link link;
+
+       if (q_msk == 0)
+               return 0;
+
+       if (port_id >= nb_ports) {
+               PMD_DEBUG_TRACE("set VF rate limit:invalid port id=%d\n",
+                               port_id);
+               return -ENODEV;
+       }
+
+       dev = &rte_eth_devices[port_id];
+       rte_eth_dev_info_get(port_id, &dev_info);
+       link = dev->data->dev_link;
+
+       if (vf > dev_info.max_vfs) {
+               PMD_DEBUG_TRACE("set VF rate limit:port %d: "
+                               "invalid vf id=%d\n", port_id, vf);
+               return -EINVAL;
+       }
+
+       if (tx_rate > link.link_speed) {
+               PMD_DEBUG_TRACE("set VF rate limit:invalid tx_rate=%d, "
+                               "bigger than link speed= %d\n",
+                               tx_rate, link_speed);
+               return -EINVAL;
+       }
+
+       FUNC_PTR_OR_ERR_RET(*dev->dev_ops->set_vf_rate_limit, -ENOTSUP);
+       return (*dev->dev_ops->set_vf_rate_limit)(dev, vf, tx_rate, q_msk);
+}
+
 int
 rte_eth_mirror_rule_set(uint8_t port_id,
                        struct rte_eth_vmdq_mirror_conf *mirror_conf,

diff --git a/lib/librte_ether/rte_ethdev.h b/lib/librte_ether/rte_ethdev.h
index 6dc9c08..67eda50 100644 (file)
--- a/lib/librte_ether/rte_ethdev.h
+++ b/lib/librte_ether/rte_ethdev.h
@@ -1039,6 +1039,17 @@ typedef int (*eth_set_vf_vlan_filter_t)(struct rte_eth_dev *dev,
                                  uint8_t vlan_on);
 /**< @internal Set VF VLAN pool filter */
 
+typedef int (*eth_set_queue_rate_limit_t)(struct rte_eth_dev *dev,
+                               uint16_t queue_idx,
+                               uint16_t tx_rate);
+/**< @internal Set queue TX rate */
+
+typedef int (*eth_set_vf_rate_limit_t)(struct rte_eth_dev *dev,
+                               uint16_t vf,
+                               uint16_t tx_rate,
+                               uint64_t q_msk);
+/**< @internal Set VF TX rate */
+
 typedef int (*eth_mirror_rule_set_t)(struct rte_eth_dev *dev,
                                  struct rte_eth_vmdq_mirror_conf *mirror_conf,
                                  uint8_t rule_id,
@@ -1152,6 +1163,8 @@ struct eth_dev_ops {
        eth_set_vf_rx_t            set_vf_rx;  /**< enable/disable a VF receive */
        eth_set_vf_tx_t            set_vf_tx;  /**< enable/disable a VF transmit */
        eth_set_vf_vlan_filter_t   set_vf_vlan_filter;  /**< Set VF VLAN filter */
+       eth_set_queue_rate_limit_t set_queue_rate_limit;   /**< Set queue rate limit */
+       eth_set_vf_rate_limit_t    set_vf_rate_limit;   /**< Set VF rate limit */
 
        /** Add a signature filter. */
        fdir_add_signature_filter_t fdir_add_signature_filter;
@@ -2688,6 +2701,44 @@ int rte_eth_mirror_rule_set(uint8_t port_id,
 int rte_eth_mirror_rule_reset(uint8_t port_id,
                                         uint8_t rule_id);
 
+/**
+ * Set the rate limitation for a queue on an Ethernet device.
+ *
+ * @param port_id
+ *   The port identifier of the Ethernet device.
+ * @param queue_idx
+ *   The queue id.
+ * @param tx_rate
+ *   The tx rate allocated from the total link speed for this queue.
+ * @return
+ *   - (0) if successful.
+ *   - (-ENOTSUP) if hardware doesn't support this feature.
+ *   - (-ENODEV) if *port_id* invalid.
+ *   - (-EINVAL) if bad parameter.
+ */
+int rte_eth_set_queue_rate_limit(uint8_t port_id, uint16_t queue_idx,
+                       uint16_t tx_rate);
+
+/**
+ * Set the rate limitation for a vf on an Ethernet device.
+ *
+ * @param port_id
+ *   The port identifier of the Ethernet device.
+ * @param vf
+ *   VF id.
+ * @param tx_rate
+ *   The tx rate allocated from the total link speed for this VF id.
+ * @param q_msk
+ *   The queue mask which need to set the rate.
+ * @return
+ *   - (0) if successful.
+ *   - (-ENOTSUP) if hardware doesn't support this feature.
+ *   - (-ENODEV) if *port_id* invalid.
+ *   - (-EINVAL) if bad parameter.
+ */
+int rte_eth_set_vf_rate_limit(uint8_t port_id, uint16_t vf,
+                       uint16_t tx_rate, uint64_t q_msk);
+
 /**
  * Initialize bypass logic. This function needs to be called before
  * executing any other bypass API.