* [dpdk-dev] [PATCH] mbuf: promote some helpers to stable
@ 2021-10-02 14:16 David Marchand
2021-10-04 19:29 ` Stephen Hemminger
0 siblings, 1 reply; 5+ messages in thread
From: David Marchand @ 2021-10-02 14:16 UTC (permalink / raw)
To: dev; +Cc: olivier.matz
Those accessors have been introduced more than two years ago
(rte_mbuf_to_priv in v18.05, rte_mbuf_*_addr* in v19.02).
Time to mark them stable.
rte_mbuf_to_baddr() could be removed, but since we lack a deprecation
notice, keep it as a simple wrapper.
Signed-off-by: David Marchand <david.marchand@redhat.com>
---
lib/mbuf/rte_mbuf.h | 26 +-------------------------
1 file changed, 1 insertion(+), 25 deletions(-)
diff --git a/lib/mbuf/rte_mbuf.h b/lib/mbuf/rte_mbuf.h
index a555f216ae..756a0462a2 100644
--- a/lib/mbuf/rte_mbuf.h
+++ b/lib/mbuf/rte_mbuf.h
@@ -191,11 +191,6 @@ rte_mbuf_from_indirect(struct rte_mbuf *mi)
* mbuf is already known because it doesn't need to access mbuf contents in
* order to get the mempool pointer.
*
- * @warning
- * @b EXPERIMENTAL: This API may change without prior notice.
- * This will be used by rte_mbuf_to_baddr() which has redundant code once
- * experimental tag is removed.
- *
* @param mb
* The pointer to the mbuf.
* @param mp
@@ -203,7 +198,6 @@ rte_mbuf_from_indirect(struct rte_mbuf *mi)
* @return
* The pointer of the mbuf buffer.
*/
-__rte_experimental
static inline char *
rte_mbuf_buf_addr(struct rte_mbuf *mb, struct rte_mempool *mp)
{
@@ -213,26 +207,15 @@ rte_mbuf_buf_addr(struct rte_mbuf *mb, struct rte_mempool *mp)
/**
* Return the default address of the beginning of the mbuf data.
*
- * @warning
- * @b EXPERIMENTAL: This API may change without prior notice.
- *
* @param mb
* The pointer to the mbuf.
* @return
* The pointer of the beginning of the mbuf data.
*/
-__rte_experimental
static inline char *
-rte_mbuf_data_addr_default(__rte_unused struct rte_mbuf *mb)
+rte_mbuf_data_addr_default(struct rte_mbuf *mb)
{
- /* gcc complains about calling this experimental function even
- * when not using it. Hide it with ALLOW_EXPERIMENTAL_API.
- */
-#ifdef ALLOW_EXPERIMENTAL_API
return rte_mbuf_buf_addr(mb, mb->pool) + RTE_PKTMBUF_HEADROOM;
-#else
- return NULL;
-#endif
}
/**
@@ -251,13 +234,7 @@ rte_mbuf_data_addr_default(__rte_unused struct rte_mbuf *mb)
static inline char *
rte_mbuf_to_baddr(struct rte_mbuf *md)
{
-#ifdef ALLOW_EXPERIMENTAL_API
return rte_mbuf_buf_addr(md, md->pool);
-#else
- char *buffer_addr;
- buffer_addr = (char *)md + sizeof(*md) + rte_pktmbuf_priv_size(md->pool);
- return buffer_addr;
-#endif
}
/**
@@ -272,7 +249,6 @@ rte_mbuf_to_baddr(struct rte_mbuf *md)
* @return
* The starting address of the private data area of the given mbuf.
*/
-__rte_experimental
static inline void *
rte_mbuf_to_priv(struct rte_mbuf *m)
{
--
2.23.0
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [dpdk-dev] [PATCH] mbuf: promote some helpers to stable
2021-10-02 14:16 [dpdk-dev] [PATCH] mbuf: promote some helpers to stable David Marchand
@ 2021-10-04 19:29 ` Stephen Hemminger
2021-10-05 7:33 ` Olivier Matz
0 siblings, 1 reply; 5+ messages in thread
From: Stephen Hemminger @ 2021-10-04 19:29 UTC (permalink / raw)
To: David Marchand; +Cc: dev, olivier.matz
On Sat, 2 Oct 2021 16:16:14 +0200
David Marchand <david.marchand@redhat.com> wrote:
> Those accessors have been introduced more than two years ago
> (rte_mbuf_to_priv in v18.05, rte_mbuf_*_addr* in v19.02).
> Time to mark them stable.
>
> rte_mbuf_to_baddr() could be removed, but since we lack a deprecation
> notice, keep it as a simple wrapper.
>
> Signed-off-by: David Marchand <david.marchand@redhat.com>
Acked-by: Stephen Hemminger <stephen@networkplumber.org>
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [dpdk-dev] [PATCH] mbuf: promote some helpers to stable
2021-10-04 19:29 ` Stephen Hemminger
@ 2021-10-05 7:33 ` Olivier Matz
2021-10-05 7:34 ` Andrew Rybchenko
0 siblings, 1 reply; 5+ messages in thread
From: Olivier Matz @ 2021-10-05 7:33 UTC (permalink / raw)
To: Stephen Hemminger; +Cc: David Marchand, dev
On Mon, Oct 04, 2021 at 12:29:42PM -0700, Stephen Hemminger wrote:
> On Sat, 2 Oct 2021 16:16:14 +0200
> David Marchand <david.marchand@redhat.com> wrote:
>
> > Those accessors have been introduced more than two years ago
> > (rte_mbuf_to_priv in v18.05, rte_mbuf_*_addr* in v19.02).
> > Time to mark them stable.
> >
> > rte_mbuf_to_baddr() could be removed, but since we lack a deprecation
> > notice, keep it as a simple wrapper.
> >
> > Signed-off-by: David Marchand <david.marchand@redhat.com>
>
> Acked-by: Stephen Hemminger <stephen@networkplumber.org>
Acked-by: Olivier Matz <olivier.matz@6wind.com>
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [dpdk-dev] [PATCH] mbuf: promote some helpers to stable
2021-10-05 7:33 ` Olivier Matz
@ 2021-10-05 7:34 ` Andrew Rybchenko
2021-10-05 8:20 ` David Marchand
0 siblings, 1 reply; 5+ messages in thread
From: Andrew Rybchenko @ 2021-10-05 7:34 UTC (permalink / raw)
To: Olivier Matz, Stephen Hemminger; +Cc: David Marchand, dev
On 10/5/21 10:33 AM, Olivier Matz wrote:
> On Mon, Oct 04, 2021 at 12:29:42PM -0700, Stephen Hemminger wrote:
>> On Sat, 2 Oct 2021 16:16:14 +0200
>> David Marchand <david.marchand@redhat.com> wrote:
>>
>>> Those accessors have been introduced more than two years ago
>>> (rte_mbuf_to_priv in v18.05, rte_mbuf_*_addr* in v19.02).
>>> Time to mark them stable.
>>>
>>> rte_mbuf_to_baddr() could be removed, but since we lack a deprecation
>>> notice, keep it as a simple wrapper.
>>>
>>> Signed-off-by: David Marchand <david.marchand@redhat.com>
>>
>> Acked-by: Stephen Hemminger <stephen@networkplumber.org>
>
> Acked-by: Olivier Matz <olivier.matz@6wind.com>
>
Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [dpdk-dev] [PATCH] mbuf: promote some helpers to stable
2021-10-05 7:34 ` Andrew Rybchenko
@ 2021-10-05 8:20 ` David Marchand
0 siblings, 0 replies; 5+ messages in thread
From: David Marchand @ 2021-10-05 8:20 UTC (permalink / raw)
To: David Marchand; +Cc: Olivier Matz, Stephen Hemminger, dev, Andrew Rybchenko
On Tue, Oct 5, 2021 at 9:34 AM Andrew Rybchenko
<andrew.rybchenko@oktetlabs.ru> wrote:
>
> On 10/5/21 10:33 AM, Olivier Matz wrote:
> > On Mon, Oct 04, 2021 at 12:29:42PM -0700, Stephen Hemminger wrote:
> >> On Sat, 2 Oct 2021 16:16:14 +0200
> >> David Marchand <david.marchand@redhat.com> wrote:
> >>
> >>> Those accessors have been introduced more than two years ago
> >>> (rte_mbuf_to_priv in v18.05, rte_mbuf_*_addr* in v19.02).
rte_mbuf_to_priv was introduced in v18.08. Fixed when applying.
> >>> Time to mark them stable.
> >>>
> >>> rte_mbuf_to_baddr() could be removed, but since we lack a deprecation
> >>> notice, keep it as a simple wrapper.
> >>>
> >>> Signed-off-by: David Marchand <david.marchand@redhat.com>
> >> Acked-by: Stephen Hemminger <stephen@networkplumber.org>
> > Acked-by: Olivier Matz <olivier.matz@6wind.com>
> Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
Applied.
--
David Marchand
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2021-10-05 8:20 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-10-02 14:16 [dpdk-dev] [PATCH] mbuf: promote some helpers to stable David Marchand
2021-10-04 19:29 ` Stephen Hemminger
2021-10-05 7:33 ` Olivier Matz
2021-10-05 7:34 ` Andrew Rybchenko
2021-10-05 8:20 ` David Marchand
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).