On Sun, Jul 10, 2022 at 11:48 AM David Marchand <david.march...@redhat.com> wrote: > > rte_driver and rte_device are unnecessarily exposed in the public API/ABI. > Announce that they will be made opaque in the public API and mark > associated API as internal. > This impacts all bus, as their driver registration mechanism will be > made internal. > > Note: the PCI bus had a similar deprecation notice that we can remove as > the new one is more generic. > > Signed-off-by: David Marchand <david.march...@redhat.com>
Acked-by: Jerin Jacob <jer...@marvell.com> > --- > doc/guides/rel_notes/deprecation.rst | 12 +++++++----- > 1 file changed, 7 insertions(+), 5 deletions(-) > > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index a9fd6676be..b9cc267b30 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -38,6 +38,13 @@ Deprecation Notices > external users may still register their bus using a new driver header (see > ``enable_driver_sdk`` meson option). > > +* drivers: As a followup on the work on the ``rte_bus`` object, the > + ``rte_driver`` and ``rte_device`` objects (and as a domino effect, their > + bus-specific counterparts) will be made opaque in DPDK 22.11. > + Registering a driver on a bus will be marked as an internal API: > + external users may still register their drivers using the bus specific > + driver header (see ``enable_driver_sdk`` meson option). > + > * mempool: Helper macro ``MEMPOOL_HEADER_SIZE()`` is deprecated and will > be removed in DPDK 22.11. The replacement macro > ``RTE_MEMPOOL_HEADER_SIZE()`` is internal only. > @@ -49,11 +56,6 @@ Deprecation Notices > * mempool: The mempool API macros ``MEMPOOL_PG_*`` are deprecated and > will be removed in DPDK 22.11. > > -* pci: To reduce unnecessary ABIs exposed by DPDK bus driver, "rte_bus_pci.h" > - will be made internal in 21.11 and macros/data structures/functions defined > - in the header will not be considered as ABI anymore. This change is > inspired > - by the RFC https://patchwork.dpdk.org/project/dpdk/list/?series=17176. > - > * lib: will fix extending some enum/define breaking the ABI. There are > multiple > samples in DPDK that enum/define terminated with a ``.*MAX.*`` value which > is > used by iterators, and arrays holding these values are sized with this > -- > 2.36.1 >
