[dpdk-dev] [PATCH v2 20.08 1/6] doc: announce deprecation of master lcore
Thomas Monjalon
thomas at monjalon.net
Thu Aug 6 19:14:32 CEST 2020
06/08/2020 19:00, Stephen Hemminger:
> On Thu, 06 Aug 2020 18:49:28 +0200
> Thomas Monjalon <thomas at monjalon.net> wrote:
>
> > 30/07/2020 02:57, Stephen Hemminger:
> > > Announce upcoming changes related to master/slave in reference
> > > to lcore.
> > >
> > > Signed-off-by: Stephen Hemminger <stephen at networkplumber.org>
> > > ---
> > > doc/guides/rel_notes/deprecation.rst | 17 +++++++++++++++++
> > > 1 file changed, 17 insertions(+)
> > >
> > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> > > index 99c98062ffc2..7c60779f3e68 100644
> > > --- a/doc/guides/rel_notes/deprecation.rst
> > > +++ b/doc/guides/rel_notes/deprecation.rst
> > > @@ -148,3 +148,20 @@ Deprecation Notices
> > > Python 2 support will be completely removed in 20.11.
> > > In 20.08, explicit deprecation warnings will be displayed when running
> > > scripts with Python 2.
> > > +
> > > +* eal: To be more inclusive in choice of naming, the DPDK project
> > > + will replace uses of master/slave in the API's and command line arguments.
> >
> > nit: double space
> > > +
> > > + References to master/slave in relation to lcore will be renamed
> > > + to initial/worker. The function ``rte_get_master_lcore()``
> > > + will be renamed to ``rte_get_initial_lcore()``.
> > > + For the 20.11, release both names will be present and the
> >
> > nit: comma misplaced
> >
> > > + old function will be marked with the deprecated tag.
> > > + The old function will be removed in 21.11 version.
> > > +
> > > + The iterator for worker lcores will also change:
> > > + ``RTE_LCORE_FOREACH_SLAVE`` will be replaced with
> > > + ``RTE_LCORE_FOREACH_WORKER``.
> > > +
> > > + The ``master-lcore`` argument to testpmd will be replaced
> > > + with ``initial-lcore``.
> >
> > It doesn't say that the old argument will be kept for compatibility in 20.11.
>
> Testpmd is not part of API/ABI compatibility area so it is not a hard
> requirement.
Not really hard, but I would say it is annoying enough to consider
maintaining compatibility in testpmd for some time.
More information about the dev
mailing list