bus: introduce parsing functionality

This operation can be used either to validate that a device
representation can be understood by a bus, as well as store the resulting
specialized device representation in any format determined by the bus.

Implementing this function allows EAL initialization routines to infer
which bus should handle a device. This is used as a way to respect
backward compatibility.

This API will disappear once this compatibility is not enforced anymore.

Signed-off-by: Gaetan Rivet <gaetan.rivet@6wind.com>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
Acked-by: Shreyansh Jain <shreyansh.jain@nxp.com>

diff --git a/lib/librte_eal/common/include/rte_bus.h b/lib/librte_eal/common/include/rte_bus.h
index 773b0d7..aebf57e 100644 (file)
--- a/lib/librte_eal/common/include/rte_bus.h
+++ b/lib/librte_eal/common/include/rte_bus.h
@@ -137,6 +137,26 @@ typedef int (*rte_bus_plug_t)(struct rte_device *dev,
  */
 typedef int (*rte_bus_unplug_t)(struct rte_device *dev);
 
+/**
+ * Bus specific parsing function.
+ * Validates the syntax used in the textual representation of a device,
+ * If the syntax is valid and ``addr`` is not NULL, writes the bus-specific
+ * device representation to ``addr``.
+ *
+ * @param[in] name
+ *     device textual description
+ *
+ * @param[out] addr
+ *     device information location address, into which parsed info
+ *     should be written. If NULL, nothing should be written, which
+ *     is not an error.
+ *
+ * @return
+ *     0 if parsing was successful.
+ *     !0 for any error.
+ */
+typedef int (*rte_bus_parse_t)(const char *name, void *addr);
+
 /**
  * A structure describing a generic bus.
  */
@@ -148,6 +168,7 @@ struct rte_bus {
        rte_bus_find_device_t find_device; /**< Find a device on the bus */
        rte_bus_plug_t plug;         /**< Probe single device for drivers */
        rte_bus_unplug_t unplug;     /**< Remove single device from driver */
+       rte_bus_parse_t parse;       /**< Parse a device name */
 };
 
 /**