ethdev: add internal function to device struct from name
authorKumara Parameshwaran <kparameshwar@vmware.com>
Mon, 31 Jan 2022 14:32:33 +0000 (20:02 +0530)
committerFerruh Yigit <ferruh.yigit@intel.com>
Tue, 1 Feb 2022 17:15:04 +0000 (18:15 +0100)
The PMDs would need a function to access the rte_eth_devices
without accessing the global rte_eth_device array.

Cc: stable@dpdk.org
Signed-off-by: Kumara Parameshwaran <kparameshwar@vmware.com>
Reviewed-by: Ferruh Yigit <ferruh.yigit@intel.com>
lib/ethdev/ethdev_driver.h
lib/ethdev/rte_ethdev.c
lib/ethdev/version.map

index d95605a..0dac55f 100644 (file)
@@ -1629,6 +1629,24 @@ rte_eth_hairpin_queue_peer_bind(uint16_t cur_port, uint16_t cur_queue,
                                struct rte_hairpin_peer_info *peer_info,
                                uint32_t direction);
 
+/**
+ * @internal
+ * Get rte_eth_dev from device name. The device name should be specified
+ * as below:
+ * - PCIe address (Domain:Bus:Device.Function), for example 0000:2:00.0
+ * - SoC device name, for example fsl-gmac0
+ * - vdev dpdk name, for example net_[pcap0|null0|tap0]
+ *
+ * @param name
+ *   PCI address or name of the device
+ * @return
+ *   - rte_eth_dev if successful
+ *   - NULL on failure
+ */
+__rte_internal
+struct rte_eth_dev*
+rte_eth_dev_get_by_name(const char *name);
+
 /**
  * @internal
  * Reset the current queue state and configuration to disconnect (unbind) it
index 29e21ad..917a320 100644 (file)
@@ -894,6 +894,17 @@ rte_eth_dev_get_port_by_name(const char *name, uint16_t *port_id)
        return -ENODEV;
 }
 
+struct rte_eth_dev *
+rte_eth_dev_get_by_name(const char *name)
+{
+       uint16_t pid;
+
+       if (rte_eth_dev_get_port_by_name(name, &pid))
+               return NULL;
+
+       return &rte_eth_devices[pid];
+}
+
 static int
 eth_err(uint16_t port_id, int ret)
 {
index c2fb066..1f7359c 100644 (file)
@@ -267,6 +267,7 @@ INTERNAL {
        rte_eth_dev_callback_process;
        rte_eth_dev_create;
        rte_eth_dev_destroy;
+       rte_eth_dev_get_by_name;
        rte_eth_dev_is_rx_hairpin_queue;
        rte_eth_dev_is_tx_hairpin_queue;
        rte_eth_dev_probing_finish;