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 ADEB9A052B; Thu, 30 Jul 2020 17:10:08 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 632C1E07; Thu, 30 Jul 2020 17:10:07 +0200 (CEST) Received: from mail-pj1-f67.google.com (mail-pj1-f67.google.com [209.85.216.67]) by dpdk.org (Postfix) with ESMTP id A3F65A3 for ; Thu, 30 Jul 2020 17:10:05 +0200 (CEST) Received: by mail-pj1-f67.google.com with SMTP id f9so4777874pju.4 for ; Thu, 30 Jul 2020 08:10:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=d77VTm3IcPxUOdamKS6Dn9D1daz1ReESDkhbPQ+z0No=; b=ESkx3S1Xu/F1EgemU5uxtipG8DMYGzENFkzLs0QOPq9SQAYEMf5O9b+6hv1RRPwbvb agCmd8wEBXyD0MDA7MnhgKv2r7RbMCcX+28kCE9jUd74ukZF82u161DmsFtE8qUWekIy GYX2szKYuyT9uOWIN9ilz6CsvBdjEVRDWW4NIB/FKBawDmdoC8BDtmHPncT6wrIuV3Iv zBiq0I4S59U316z6GG7QqEooRYgpp9ZqlDjX73Uw0BzoNuv9hJM0gKlox3cyUkCe0F11 WAhQ3k7t1ZGM6xjDSurNuXGKrnBzTpkkzu9IVGBkI8zaMKwbEmwXiO6i6JGe7gPBCVHV H/vQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=d77VTm3IcPxUOdamKS6Dn9D1daz1ReESDkhbPQ+z0No=; b=AwFsVBtDnZQIrw4SQF85B4WEbPjyIv0+8aytDLz+3zobdWpzySmDWHnk2UoJphdE20 ez7zK/WvtaN3P2qfX1DwRBWJNs0sDYgqjI+DBG/RTeUNI3zukLK3Xrh4lVDsMJfvDQ6p d5+RZQUKS1loz2wLra66sHA2GcbtAJr6ClVVSf7VqZsB5e0TaL9onnHO+Xztp7q0ii+B ZWauHqMLxCHfwp4opB/4mg3w2LaIfVx4wcxGBA6soR6ASUn90/NKN8Z9S8/nsPVxJUI7 rAUOblvnx83tflf3HsFtSQQ1JZE6PBMuRfz41BF+1RG8mrL99B0C7LmNKpT2lZ2lYnU2 g2+w== X-Gm-Message-State: AOAM530jqN3F7Sysiz8hOsUCDOtA2sJNu0IcbcUSaDYc8M1Z0IvF4ZwI EpqOn1veijI73S2bTv4eD0U/7g== X-Google-Smtp-Source: ABdhPJw2G5txnx41Y3TkT4O8PuZLHkRI68RoQK9ibC4CD+ezMQr3TEykTYq6QeeWhUpn9K1D6dSCHg== X-Received: by 2002:a17:902:d891:: with SMTP id b17mr23178522plz.268.1596121804658; Thu, 30 Jul 2020 08:10:04 -0700 (PDT) Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id t63sm6491632pfb.210.2020.07.30.08.10.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 30 Jul 2020 08:10:04 -0700 (PDT) Date: Thu, 30 Jul 2020 08:10:01 -0700 From: Stephen Hemminger To: Bruce Richardson Cc: dev@dpdk.org Message-ID: <20200730081001.4bd801ea@hermes.lan> In-Reply-To: <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> <20200730084519.GC241@bricha3-MOBL.ger.corp.intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit 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 Thu, 30 Jul 2020 09:45:19 +0100 Bruce Richardson wrote: > 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 If these are internal, we don't need to wrap them in 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? Some message to standard error and keep going. > > Overall, though > > Acked-by: Bruce Richardson