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 896D6A0353; Thu, 6 Aug 2020 19:20:27 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 02A4B1C0BD; Thu, 6 Aug 2020 19:20:04 +0200 (CEST) Received: from mail-pl1-f196.google.com (mail-pl1-f196.google.com [209.85.214.196]) by dpdk.org (Postfix) with ESMTP id 4ED851C0B2 for ; Thu, 6 Aug 2020 19:20:01 +0200 (CEST) Received: by mail-pl1-f196.google.com with SMTP id q17so28029715pls.9 for ; Thu, 06 Aug 2020 10:20:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=I8qHAX4JH6m6HoUx1zczNRSkrNYGOfVelV3Cb/tWcmY=; b=qbPugeGQfw9667oGkoLm9/LYsj6aJJ3IAFkl3ioWxUA8H5tE3YBx6D8e9eRCTYXGD8 8S398COvDaaNvstffr8aXtKMdC+gpFzyyF+mXtwJcQFDoVtthc/xbMPl0v63bXGmek+a dKISErcpXdUFAMM8RpdTVMNErU7pQFAEnoiM72jhEkH6YgscaZebZSBMfmd279Ak3pH9 bDhNfaYE0/j26nyOXTCx8AfcAGNuEROgJDLyV3Gfe8OqffVVND3XtkYg/qgLY0fsn9XM EmAGAqCJZxJMM8SSYbqykYz/5UXhM2FW5znl7mrm7YX7B/phVpgWdZ94rBrr9GbIlFxh vlqw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=I8qHAX4JH6m6HoUx1zczNRSkrNYGOfVelV3Cb/tWcmY=; b=Y2PqTUujnMHglO8l4WpR1CIhBGxS8mcIwTFxzaPwF9/em5iM14UboAtJQTOKlHz/S8 2IBGD4R8IGbUgjLNUK3Hc9xuw1Rcg7ZsMGp1uSH1S9AyQNFidJ+x3ktgneOFxP9vI9Cw EXpJ0NqK1YH5clDVH+WAv9jM7PjC5XfO972pFi4wrecEs2chuwYfU9WcKtYg/4IApgiY pWZLak4EkdT51wYUoX8Q4+oSNN6LH7WMvnLVKBcuE6r8DkOXumKXEmhKBxQmfgJNylsP u51EoLEY83E0Rr3sJGU0XxlB8AHqV1g4tRoALiRyvnNXMbau9uUBe70h9r9Y9d2NEdtU higA== X-Gm-Message-State: AOAM5310hU/1UxM7wKWPkiWCHYeWFvcSAMa23HQIUtNabjyAPdtyMH8O BrKrO4wsyc/F5XcmfDCfpr5e0eSQOTk= X-Google-Smtp-Source: ABdhPJwcqd4CmiU4FHUuTl/VS6na8reIAK7LpOLpJsDNTKGkSNqS1JKk3lnaWh9CqujArogwi38IDw== X-Received: by 2002:a17:90a:ca87:: with SMTP id y7mr9171360pjt.102.1596734400109; Thu, 06 Aug 2020 10:20:00 -0700 (PDT) Received: from hermes.corp.microsoft.com (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id h15sm9042821pfo.192.2020.08.06.10.19.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Aug 2020 10:19:59 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Bruce Richardson Date: Thu, 6 Aug 2020 10:19:45 -0700 Message-Id: <20200806171947.6609-5-stephen@networkplumber.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20200806171947.6609-1-stephen@networkplumber.org> References: <20200604210200.25405-1-stephen@networkplumber.org> <20200806171947.6609-1-stephen@networkplumber.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v3 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" Announce upcoming changes for 20.11. Signed-off-by: Stephen Hemminger Acked-by: Bruce Richardson --- doc/guides/rel_notes/deprecation.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 47badff6119a..dad939a7f87e 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -272,3 +272,26 @@ Deprecation Notices will produce a runtime notification in 20.11 release, and be remove completely in a future release. +* 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 any + usage will cause a compile warning. They will be removed in + a future release. + + 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 warning message. The old arguments will + be removed in a future release. + -- 2.27.0