eal: add function to query device status
authorThomas Monjalon <thomas@monjalon.net>
Tue, 25 Sep 2018 20:55:27 +0000 (22:55 +0200)
committerThomas Monjalon <thomas@monjalon.net>
Wed, 17 Oct 2018 23:49:28 +0000 (01:49 +0200)
The function rte_dev_is_probed() is added in order to improve semantic
and enforce proper check of the probing status of a device.

It will answer this rte_device query:
Is it already successfully probed or not?

Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
Reviewed-by: Andrew Rybchenko <arybchenko@solarflare.com>
Tested-by: Andrew Rybchenko <arybchenko@solarflare.com>
drivers/bus/ifpga/ifpga_bus.c
drivers/bus/pci/pci_common.c
drivers/bus/vdev/vdev.c
drivers/bus/vmbus/vmbus_common.c
lib/librte_eal/common/eal_common_dev.c
lib/librte_eal/common/include/rte_dev.h
lib/librte_eal/rte_eal_version.map

index fca2dba..2ca1efa 100644 (file)
@@ -301,7 +301,7 @@ ifpga_probe_all_drivers(struct rte_afu_device *afu_dev)
                return -1;
 
        /* Check if a driver is already loaded */
-       if (afu_dev->device.driver != NULL)
+       if (rte_dev_is_probed(&afu_dev->device))
                return 0;
 
        TAILQ_FOREACH(drv, &ifpga_afu_drv_list, next) {
@@ -325,7 +325,7 @@ ifpga_probe(void)
        int ret = 0;
 
        TAILQ_FOREACH(afu_dev, &ifpga_afu_dev_list, next) {
-               if (afu_dev->device.driver)
+               if (rte_dev_is_probed(&afu_dev->device))
                        continue;
 
                ret = ifpga_probe_all_drivers(afu_dev);
index eb27e79..9069003 100644 (file)
@@ -244,7 +244,7 @@ pci_probe_all_drivers(struct rte_pci_device *dev)
                return -1;
 
        /* Check if a driver is already loaded */
-       if (dev->device.driver != NULL)
+       if (rte_dev_is_probed(&dev->device))
                return 0;
 
        FOREACH_DRIVER_ON_PCIBUS(dr) {
index 3f27f35..f666099 100644 (file)
@@ -481,7 +481,7 @@ vdev_probe(void)
                 * we call each driver probe.
                 */
 
-               if (dev->device.driver)
+               if (rte_dev_is_probed(&dev->device))
                        continue;
 
                if (vdev_probe_all_drivers(dev)) {
index de5548a..48a219f 100644 (file)
@@ -143,7 +143,7 @@ vmbus_probe_all_drivers(struct rte_vmbus_device *dev)
        int rc;
 
        /* Check if a driver is already loaded */
-       if (dev->device.driver != NULL) {
+       if (rte_dev_is_probed(&dev->device)) {
                VMBUS_LOG(DEBUG, "VMBUS driver already loaded");
                return 0;
        }
index 631e174..f6e490a 100644 (file)
@@ -76,6 +76,13 @@ static int cmp_dev_name(const struct rte_device *dev, const void *_name)
        return strcmp(dev->name, name);
 }
 
+int __rte_experimental
+rte_dev_is_probed(const struct rte_device *dev)
+{
+       /* The field driver should be set only when the probe is successful. */
+       return dev->driver != NULL;
+}
+
 int rte_eal_dev_attach(const char *name, const char *devargs)
 {
        struct rte_bus *bus;
@@ -212,7 +219,7 @@ local_dev_probe(const char *devargs, struct rte_device **new_dev)
                goto err_devarg;
        }
 
-       if (dev->driver != NULL) {
+       if (rte_dev_is_probed(dev)) {
                RTE_LOG(ERR, EAL, "Device is already plugged\n");
                return -EEXIST;
        }
@@ -355,11 +362,6 @@ local_dev_remove(struct rte_device *dev)
 {
        int ret;
 
-       if (dev->driver == NULL) {
-               RTE_LOG(ERR, EAL, "Device is already unplugged\n");
-               return -ENOENT;
-       }
-
        if (dev->bus->unplug == NULL) {
                RTE_LOG(ERR, EAL, "Function unplug not supported by bus (%s)\n",
                        dev->bus->name);
@@ -385,6 +387,11 @@ rte_dev_remove(struct rte_device *dev)
        char *devargs;
        int ret;
 
+       if (!rte_dev_is_probed(dev)) {
+               RTE_LOG(ERR, EAL, "Device is not probed\n");
+               return -ENOENT;
+       }
+
        ret = build_devargs(dev->devargs->bus->name, dev->name, "", &devargs);
        if (ret != 0)
                return ret;
index efdd4a2..15a514b 100644 (file)
@@ -162,6 +162,20 @@ struct rte_device {
        struct rte_devargs *devargs;  /**< Device user arguments */
 };
 
+/**
+ * @warning
+ * @b EXPERIMENTAL: this API may change without prior notice
+ *
+ * Query status of a device.
+ *
+ * @param dev
+ *   Generic device pointer.
+ * @return
+ *   (int)true if already probed successfully, 0 otherwise.
+ */
+__rte_experimental
+int rte_dev_is_probed(const struct rte_device *dev);
+
 /**
  * Attach a device to a registered driver.
  *
index ff76c71..08e3bc2 100644 (file)
@@ -282,6 +282,7 @@ EXPERIMENTAL {
        rte_dev_event_monitor_stop;
        rte_dev_hotplug_handle_disable;
        rte_dev_hotplug_handle_enable;
+       rte_dev_is_probed;
        rte_dev_iterator_init;
        rte_dev_iterator_next;
        rte_dev_probe;