On Wed, Jul 29, 2020 at 05:58:02PM -0700, Stephen Hemminger wrote: > Announce upcoming changes for 20.11. > > Signed-off-by: Stephen Hemminger <step...@networkplumber.org> > --- > doc/guides/rel_notes/deprecation.rst | 21 +++++++++++++++++++++ > 1 file changed, 21 insertions(+) > > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 7c60779f3e68..abfec0aeaa4b 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -165,3 +165,24 @@ Deprecation Notices > > The ``master-lcore`` argument to testpmd will be replaced > with ``initial-lcore``. > + > +* eal: The terms blacklist and whitelist to describe devices used > + by DPDK will be replaced in the 20.11 relase. > + This will apply to command line arguments as well as macros. > + > + The macro ``RTE_DEV_BLACKLISTED`` will be replaced with > ``RTE_DEV_EXCLUDED`` > + and ``RTE_DEV_WHITELISTED`` will be replaced with ``RTE_DEV_INCLUDED`` > + ``RTE_BUS_SCAN_BLACKLIST`` and ``RTE_BUS_SCAN_WHITELIST`` will be > + replaced with ``RTE_BUS_SCAN_EXCLUDED`` and ``RTE_BUS_SCAN_INCLUDED`` > + respectively. Likewise ``RTE_DEVTYPE_BLACKLISTED_PCI`` and > + ``RTE_DEVTYPE_WHITELISTED_PCI`` will be replaced with > + ``RTE_DEVTYPE_EXCLUDED`` and ``RTE_DEVTYPE_INCLUDED``. > + > + The old macros will be marked as deprecated in 20.11 and removed > + in the 21.11 release. > +
Since these are macros and therefore not part of the ABI I think we can remove them sooner than 21.11. Therefore similar to the previous patch can we just use "future" relase rather than 21.11 > + The command line arguments to ``rte_eal_init`` will change from > + ``-b, --pci-blacklist`` to ``-x, --exclude`` and > + ``-w, --pci-whitelist`` to ``-i, --include``. > + The old command line arguments will continue to be accepted in 20.11 > + but will cause a runtime error message. > -- Error message, or warning message? Overall, though Acked-by: Bruce Richardson <bruce.richard...@intel.com>