* [dpdk-dev] [PATCH] doc: announce library refactor for ABI improvement
@ 2021-08-26 10:35 Ferruh Yigit
2021-08-26 10:46 ` [dpdk-dev] [EXT] " Akhil Goyal
0 siblings, 1 reply; 6+ messages in thread
From: Ferruh Yigit @ 2021-08-26 10:35 UTC (permalink / raw)
To: Ray Kinsella
Cc: Ferruh Yigit, dev, Konstantin Ananyev, Jerin Jacob Kollanukkaran,
Akhil Goyal
Target is to reduce the public interface surface to improve the ABI
stability and this is preparation for the longer term stable ABI
support.
Mainly device abstraction layer libraries are impacted because they have
two interfaces, one is public interface to the applications and other is
internal interface to the drivers. Some driver/internal interface
structures/symbols are in the public interface by mistake, this work is
to clean them.
Also some libraries has 'static inline' functions for performance
reasons (like ones in the ethdev), this work plans to split the
structures and hide the part that is not used by inline functions.
The need of the work for the stable ABI already discussed and planned by
the DPDK technical board:
https://mails.dpdk.org/archives/dev/2021-July/214662.html
Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
---
Cc: Konstantin Ananyev <konstantin.ananyev@intel.com>
Cc: Jerin Jacob Kollanukkaran <jerinj@marvell.com>
Cc: Akhil Goyal <gakhil@marvell.com>
CC: Ray Kinsella <mdr@ashroe.eu>
---
doc/guides/rel_notes/deprecation.rst | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 76a4abfd6b0b..1f02d9e14501 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -63,6 +63,11 @@ Deprecation Notices
us extending existing enum/define.
One solution can be using a fixed size array instead of ``.*MAX.*`` value.
+* lib: Will hide internal data structures and symbols from the public interfaces
+ as much as possible in v21.11.
+ This ABI break is done to improve the ABI stability in the long term and will
+ be done mainly, but not limited to, in device abstraction layer libraries.
+
* ethdev: Will add ``RTE_ETH_`` prefix to all ethdev macros/enums in v21.11.
Macros will be added for backward compatibility.
Backward compatibility macros will be removed on v22.11.
--
2.31.1
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [EXT] [PATCH] doc: announce library refactor for ABI improvement
2021-08-26 10:35 [dpdk-dev] [PATCH] doc: announce library refactor for ABI improvement Ferruh Yigit
@ 2021-08-26 10:46 ` Akhil Goyal
2021-08-26 10:47 ` Jerin Jacob
2021-08-26 11:04 ` Bruce Richardson
0 siblings, 2 replies; 6+ messages in thread
From: Akhil Goyal @ 2021-08-26 10:46 UTC (permalink / raw)
To: Ferruh Yigit, Ray Kinsella
Cc: dev, Konstantin Ananyev, Jerin Jacob Kollanukkaran
> Target is to reduce the public interface surface to improve the ABI
> stability and this is preparation for the longer term stable ABI
> support.
>
> Mainly device abstraction layer libraries are impacted because they have
> two interfaces, one is public interface to the applications and other is
> internal interface to the drivers. Some driver/internal interface
> structures/symbols are in the public interface by mistake, this work is
> to clean them.
> Also some libraries has 'static inline' functions for performance
> reasons (like ones in the ethdev), this work plans to split the
> structures and hide the part that is not used by inline functions.
>
> The need of the work for the stable ABI already discussed and planned by
> the DPDK technical board:
> https://mails.dpdk.org/archives/dev/2021-July/214662.html
>
> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
> ---
Acked-by: Akhil Goyal <gakhil@marvell.com>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [EXT] [PATCH] doc: announce library refactor for ABI improvement
2021-08-26 10:46 ` [dpdk-dev] [EXT] " Akhil Goyal
@ 2021-08-26 10:47 ` Jerin Jacob
2021-08-26 11:04 ` Bruce Richardson
1 sibling, 0 replies; 6+ messages in thread
From: Jerin Jacob @ 2021-08-26 10:47 UTC (permalink / raw)
To: Akhil Goyal
Cc: Ferruh Yigit, Ray Kinsella, dev, Konstantin Ananyev,
Jerin Jacob Kollanukkaran
On Thu, Aug 26, 2021 at 4:16 PM Akhil Goyal <gakhil@marvell.com> wrote:
>
> > Target is to reduce the public interface surface to improve the ABI
> > stability and this is preparation for the longer term stable ABI
> > support.
> >
> > Mainly device abstraction layer libraries are impacted because they have
> > two interfaces, one is public interface to the applications and other is
> > internal interface to the drivers. Some driver/internal interface
> > structures/symbols are in the public interface by mistake, this work is
> > to clean them.
> > Also some libraries has 'static inline' functions for performance
> > reasons (like ones in the ethdev), this work plans to split the
> > structures and hide the part that is not used by inline functions.
> >
> > The need of the work for the stable ABI already discussed and planned by
> > the DPDK technical board:
> > https://mails.dpdk.org/archives/dev/2021-July/214662.html
> >
> > Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
> > ---
> Acked-by: Akhil Goyal <gakhil@marvell.com>
Acked-by: Jerin Jacob <jerinj@marvell.com>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [EXT] [PATCH] doc: announce library refactor for ABI improvement
2021-08-26 10:46 ` [dpdk-dev] [EXT] " Akhil Goyal
2021-08-26 10:47 ` Jerin Jacob
@ 2021-08-26 11:04 ` Bruce Richardson
2021-08-26 15:44 ` Andrew Rybchenko
1 sibling, 1 reply; 6+ messages in thread
From: Bruce Richardson @ 2021-08-26 11:04 UTC (permalink / raw)
To: Akhil Goyal
Cc: Ferruh Yigit, Ray Kinsella, dev, Konstantin Ananyev,
Jerin Jacob Kollanukkaran
On Thu, Aug 26, 2021 at 10:46:35AM +0000, Akhil Goyal wrote:
> > Target is to reduce the public interface surface to improve the ABI
> > stability and this is preparation for the longer term stable ABI
> > support.
> >
> > Mainly device abstraction layer libraries are impacted because they have
> > two interfaces, one is public interface to the applications and other is
> > internal interface to the drivers. Some driver/internal interface
> > structures/symbols are in the public interface by mistake, this work is
> > to clean them.
> > Also some libraries has 'static inline' functions for performance
> > reasons (like ones in the ethdev), this work plans to split the
> > structures and hide the part that is not used by inline functions.
> >
> > The need of the work for the stable ABI already discussed and planned by
> > the DPDK technical board:
> > https://mails.dpdk.org/archives/dev/2021-July/214662.html
> >
> > Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
> > ---
> Acked-by: Akhil Goyal <gakhil@marvell.com>
Acked-by: Bruce Richardson <bruce.richardson@intel.com>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [EXT] [PATCH] doc: announce library refactor for ABI improvement
2021-08-26 11:04 ` Bruce Richardson
@ 2021-08-26 15:44 ` Andrew Rybchenko
2021-08-31 15:48 ` Kinsella, Ray
0 siblings, 1 reply; 6+ messages in thread
From: Andrew Rybchenko @ 2021-08-26 15:44 UTC (permalink / raw)
To: Bruce Richardson, Akhil Goyal
Cc: Ferruh Yigit, Ray Kinsella, dev, Konstantin Ananyev,
Jerin Jacob Kollanukkaran
On 8/26/21 2:04 PM, Bruce Richardson wrote:
> On Thu, Aug 26, 2021 at 10:46:35AM +0000, Akhil Goyal wrote:
>>> Target is to reduce the public interface surface to improve the ABI
>>> stability and this is preparation for the longer term stable ABI
>>> support.
>>>
>>> Mainly device abstraction layer libraries are impacted because they have
>>> two interfaces, one is public interface to the applications and other is
>>> internal interface to the drivers. Some driver/internal interface
>>> structures/symbols are in the public interface by mistake, this work is
>>> to clean them.
>>> Also some libraries has 'static inline' functions for performance
>>> reasons (like ones in the ethdev), this work plans to split the
>>> structures and hide the part that is not used by inline functions.
>>>
>>> The need of the work for the stable ABI already discussed and planned by
>>> the DPDK technical board:
>>> https://mails.dpdk.org/archives/dev/2021-July/214662.html
>>>
>>> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
>>> ---
>> Acked-by: Akhil Goyal <gakhil@marvell.com>
>
> Acked-by: Bruce Richardson <bruce.richardson@intel.com>
>
Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [dpdk-dev] [EXT] [PATCH] doc: announce library refactor for ABI improvement
2021-08-26 15:44 ` Andrew Rybchenko
@ 2021-08-31 15:48 ` Kinsella, Ray
0 siblings, 0 replies; 6+ messages in thread
From: Kinsella, Ray @ 2021-08-31 15:48 UTC (permalink / raw)
To: Andrew Rybchenko, Bruce Richardson, Akhil Goyal
Cc: Ferruh Yigit, dev, Konstantin Ananyev, Jerin Jacob Kollanukkaran
On 26/08/2021 16:44, Andrew Rybchenko wrote:
> On 8/26/21 2:04 PM, Bruce Richardson wrote:
>> On Thu, Aug 26, 2021 at 10:46:35AM +0000, Akhil Goyal wrote:
>>>> Target is to reduce the public interface surface to improve the ABI
>>>> stability and this is preparation for the longer term stable ABI
>>>> support.
>>>>
>>>> Mainly device abstraction layer libraries are impacted because they have
>>>> two interfaces, one is public interface to the applications and other is
>>>> internal interface to the drivers. Some driver/internal interface
>>>> structures/symbols are in the public interface by mistake, this work is
>>>> to clean them.
>>>> Also some libraries has 'static inline' functions for performance
>>>> reasons (like ones in the ethdev), this work plans to split the
>>>> structures and hide the part that is not used by inline functions.
>>>>
>>>> The need of the work for the stable ABI already discussed and planned by
>>>> the DPDK technical board:
>>>> https://mails.dpdk.org/archives/dev/2021-July/214662.html
>>>>
>>>> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
>>>> ---
>>> Acked-by: Akhil Goyal <gakhil@marvell.com>
>>
>> Acked-by: Bruce Richardson <bruce.richardson@intel.com>
>>
>
> Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
>
Acked-by: Ray Kinsella <mdr@ashroe.eu>
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2021-08-31 15:48 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-08-26 10:35 [dpdk-dev] [PATCH] doc: announce library refactor for ABI improvement Ferruh Yigit
2021-08-26 10:46 ` [dpdk-dev] [EXT] " Akhil Goyal
2021-08-26 10:47 ` Jerin Jacob
2021-08-26 11:04 ` Bruce Richardson
2021-08-26 15:44 ` Andrew Rybchenko
2021-08-31 15:48 ` Kinsella, Ray
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).