From: David Marchand <david.marchand@redhat.com>
To: dev@dpdk.org, techboard@dpdk.org
Cc: Ray Kinsella <mdr@ashroe.eu>
Subject: [PATCH] doc: announce marking device and driver objects as internal
Date: Sun, 10 Jul 2022 08:17:36 +0200 [thread overview]
Message-ID: <20220710061736.973563-1-david.marchand@redhat.com> (raw)
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.marchand@redhat.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
next reply other threads:[~2022-07-10 6:17 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-07-10 6:17 David Marchand [this message]
2022-07-10 8:25 ` Andrew Rybchenko
2022-07-11 2:16 ` Xia, Chenbo
2022-07-11 12:36 ` Thomas Monjalon
2022-07-11 15:01 ` Jerin Jacob
2022-07-12 4:25 ` Hemant Agrawal
2022-07-12 8:24 ` Kevin Laatz
2022-07-12 11:38 ` Andrew Rybchenko
2022-07-15 16:22 ` Thomas Monjalon
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220710061736.973563-1-david.marchand@redhat.com \
--to=david.marchand@redhat.com \
--cc=dev@dpdk.org \
--cc=mdr@ashroe.eu \
--cc=techboard@dpdk.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).