From patchwork Thu Jul 30 00:58:02 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75019 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 51078A052B; Thu, 30 Jul 2020 02:58:52 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 4C9E21C042; Thu, 30 Jul 2020 02:58:28 +0200 (CEST) Received: from mail-pf1-f195.google.com (mail-pf1-f195.google.com [209.85.210.195]) by dpdk.org (Postfix) with ESMTP id CA4DC1C00F for ; Thu, 30 Jul 2020 02:58:21 +0200 (CEST) Received: by mail-pf1-f195.google.com with SMTP id 74so5798915pfx.13 for ; Wed, 29 Jul 2020 17:58:21 -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=8DONJcb+B0Kct3z8WtmzrtzO54xMfxHpmxzUirtqFZA=; b=NWXvHfHwp2qFGBvJNC3cY+IcA0aXPnurXJ9F+Af8N62Yiny6Q3ixmc/ZWapFtSEN02 cHNt/Fdn23PcrEq5ZmPoqFNH1TeE6qoXel4dQt9yV3o3RINIeIW+qRMaoiFHMAh4BghB U9KcYKyWbhUzGQZFjZrBsFg/vBKbflibKUAwXOwlLWQEn05SvEO3/ZN5Y/EwinDX2kaw kbpWbhBxSSfU9e9bepvyC25y6pmm8gvVsLQiLb/U8oB/CAj2HYCda0yg0Ozg9y1EYfdS Gcs5zlq+35ADQhGyFQgsRo6uvim6v/wcupyzTeXTsXgfpvO9onOu4SDGLS5tNM1T0nzH +x/g== 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=8DONJcb+B0Kct3z8WtmzrtzO54xMfxHpmxzUirtqFZA=; b=MEGOSjI+GjihVlAHN0UYoZPpbYV0e/AQ1oJ+cdbxbpO4W9uBe5TPdWlAwdrmkXmZGX FGQ9rmDGmjQpQL7ZinwGoJxunaOpKXPTbabTzGyipj28FAp3OH1pxqqvEGoZIu3tax+4 qkoC8jBYLXw16GHAPQmDuvGx2Ksn25RBXyMxnmoKd4xdrNMtzhx/Zqo5UFEyzTPyH+nc 3OrKYBhltcRZxk6qxvEkz6qwKvE/TzuAczZNwFfozceSPFkDyO5edlkcc374XVc5pqES WxVqITbUUUOSXQni6xNSzdvm3q/eQvbkHQX0PKPJ5jkXMFkCbwGDPCN4ffbQxLxTJCGM itEg== X-Gm-Message-State: AOAM532SnRx02g8AXWEMoL0EkPonx2g60X/aiW21ARy5tzPVx5r2D3xS Mp73t/uB27Maw52Sv4/2CLCj1z0DEfvCHg== X-Google-Smtp-Source: ABdhPJyCtG4ywjUAHnFqGNRdUK1MM6AFS2XNHgMTcqgf8oEpl/Fr3YXteRLAyFcO+HZNba0b5YT+NA== X-Received: by 2002:aa7:9219:: with SMTP id 25mr746263pfo.4.1596070700486; Wed, 29 Jul 2020 17:58:20 -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 s4sm3630423pfh.128.2020.07.29.17.58.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Jul 2020 17:58:19 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Date: Wed, 29 Jul 2020 17:58:02 -0700 Message-Id: <20200730005804.19251-5-stephen@networkplumber.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20200730005804.19251-1-stephen@networkplumber.org> References: <20200604210200.25405-1-stephen@networkplumber.org> <20200730005804.19251-1-stephen@networkplumber.org> MIME-Version: 1.0 Subject: [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" Announce upcoming changes for 20.11. Signed-off-by: Stephen Hemminger Acked-by: Bruce Richardson --- 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. + + 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.