From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 9FDB3A052B; Thu, 30 Jul 2020 10:45:27 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7BC3511A2; Thu, 30 Jul 2020 10:45:26 +0200 (CEST) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 3E800255 for ; Thu, 30 Jul 2020 10:45:25 +0200 (CEST) IronPort-SDR: jrBwk33k08DNTZ0xPPdZ9Hby4UpL7c213BBtt6pz9rfzTS7SskkaNMpxzJDy1PAfyzv8wHxyxr rcGoQgPalvkQ== X-IronPort-AV: E=McAfee;i="6000,8403,9697"; a="213095005" X-IronPort-AV: E=Sophos;i="5.75,413,1589266800"; d="scan'208";a="213095005" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga005.jf.intel.com ([10.7.209.41]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 30 Jul 2020 01:45:24 -0700 IronPort-SDR: iL9M8i47cYkquACOmKe8JFYqXzOqi1hwFfOvl+9HN2dYUagOlwCtdBXmTH1J98OWd6ea3IC+J+ n65Q+OK4yeyw== X-IronPort-AV: E=Sophos;i="5.75,413,1589266800"; d="scan'208";a="465171081" Received: from bricha3-mobl.ger.corp.intel.com ([10.249.40.75]) by orsmga005-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-SHA; 30 Jul 2020 01:45:23 -0700 Date: Thu, 30 Jul 2020 09:45:19 +0100 From: Bruce Richardson To: Stephen Hemminger Cc: dev@dpdk.org Message-ID: <20200730084519.GC241@bricha3-MOBL.ger.corp.intel.com> References: <20200604210200.25405-1-stephen@networkplumber.org> <20200730005804.19251-1-stephen@networkplumber.org> <20200730005804.19251-5-stephen@networkplumber.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200730005804.19251-5-stephen@networkplumber.org> Subject: Re: [dpdk-dev] [PATCH v2 20.08 4/6] doc: announce deprecation blacklist/whitelist X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On Wed, Jul 29, 2020 at 05:58:02PM -0700, Stephen Hemminger wrote: > Announce upcoming changes for 20.11. > > Signed-off-by: Stephen Hemminger > --- > 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