From: Gaetan Rivet Date: Wed, 10 May 2017 15:46:10 +0000 (+0200) Subject: doc: announce ABI change for device parameters X-Git-Tag: spdx-start~3217 X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=2ee10c8a56296ad1441b81be5ab35e2de1f65aea;p=dpdk.git doc: announce ABI change for device parameters The PCI and virtual bus are planned to be moved to the generic drivers/bus directory in v17.08. For this change to be possible, the EAL must be made completely independent. The rte_devargs structure currently holds device representation internal to those two busses. It must be made generic before this work can be completed. Instead of using either a driver name for a vdev or a PCI address for a PCI device, a devargs structure will have to be able to describe any possible device on all busses, without introducing dependencies on any bus-specific device representation. This will break the ABI for this structure. Additionally, an evolution will occur regarding the device parsing from the command-line. A user must be able to set which bus will handle which device, and this setting is integral to the definition of a device. The format has not yet been formally defined, but a proposition will follow soon for a new command line parameter format for all devices. Signed-off-by: Gaetan Rivet Acked-by: Jerin Jacob Acked-by: David Marchand Acked-by: Maxime Coquelin Acked-by: Thomas Monjalon --- diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index a3e7c720ce..67324a2a9c 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -16,6 +16,13 @@ Deprecation Notices - ``rte_set_log_type``, replaced by ``rte_log_set_level`` - ``rte_get_log_type``, replaced by ``rte_log_get_level`` +* devargs: An ABI change is planned for 17.08 for the structure ``rte_devargs``. + The current version is dependent on bus-specific device identifier, which will + be made generic and abstracted, in order to make the EAL bus-agnostic. + + Accompanying this evolution, device command line parameters will thus support + explicit bus definition in a device declaration. + * igb_uio: iomem mapping and sysfs files created for iomem and ioport in igb_uio will be removed, because we are able to detect these from what Linux has exposed, like the way we have done with uio-pci-generic. This change