From 609eb7dde6d0212741c19651b966dc00213cc86c Mon Sep 17 00:00:00 2001 From: Gaetan Rivet Date: Fri, 7 Jul 2017 02:03:08 +0200 Subject: [PATCH] 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 Acked-by: Bruce Richardson Acked-by: Shreyansh Jain --- lib/librte_eal/common/include/rte_bus.h | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/lib/librte_eal/common/include/rte_bus.h b/lib/librte_eal/common/include/rte_bus.h index 773b0d7af4..aebf57efdd 100644 --- 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 */ }; /** -- 2.20.1