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 7272DA0521; Thu, 5 Nov 2020 23:37:48 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 6B2182E8F; Thu, 5 Nov 2020 23:36:23 +0100 (CET) Received: from mail-pg1-f196.google.com (mail-pg1-f196.google.com [209.85.215.196]) by dpdk.org (Postfix) with ESMTP id 3EA162C15 for ; Thu, 5 Nov 2020 23:36:20 +0100 (CET) Received: by mail-pg1-f196.google.com with SMTP id e21so2353218pgr.11 for ; Thu, 05 Nov 2020 14:36:20 -0800 (PST) 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=StbT9fbv6XwLdKGUIWXJcywtHoJ5yTw2p7C78pANLMg=; b=lfdmhvXODAYpZgaulcL4GQo+/F5/1IoRUilCTezT9gVhYJU0+z01K6vA77O/xxx9GO q6qJRFVeaDMXYQkqOl/pnKPpIU5WmiaipXgKT+DAtyXawzSy2Gr/ZQUDvl/r7TVzq380 N5IJ09SXb/5wpX0S6dkjahAJc56TcE2sJVW0q57tB1C4s6cFKbpaJ5ZNMdMuL/5AjQn1 H2SfiR+Q6+y3C/0+gNPvaXaebwlLgsoYwSmHGtkX6w/GZzPuDv83X8+6ggrgO+KY8eA1 1f+s6g7o83CG7oUhUz8upMPu8mVSgWYxPxFToa40p8V9dcogwS6gHFGaryfIfbYsIeVQ TD3g== 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=StbT9fbv6XwLdKGUIWXJcywtHoJ5yTw2p7C78pANLMg=; b=ny6N2q6eHU2/irkOlKzAtD5wBc1yiYCn1Q97+OykQCjFdduXzMwb3e7EKTbu2bNpdP C3jgEeqV6qrQQ8wU8qQjoHKVCibUPxbsgDz56JtplS6skCWMYs5croA8O1qKc4UHXju/ INQDabJT8aud52VuCU5sQN8qgOsZJf+oP+ejjNSvj0wKfjXYFJ8S7NuinIqsl7fCrPS5 QcKvRJBXGxxmdc75wH1i6tK3QzjfA2cwjZptoUgyMr3CK/G2yaTsay70tYt3cpINT/C6 Dkf0pGT0Hs1X0ljQbCCxSJYoUOLAlUS8YE/chPOCMDhEoZYzLWRYmFIHbjMK9of8/VbT ckiA== X-Gm-Message-State: AOAM530QOI6Brqk7vkoaR/Pe9GUH7SIE5ITzHBmwkj/zb6Ff5yd7rCec i5QN+oHni81S642LTAMPsOfZ/2x8NsUedDFv X-Google-Smtp-Source: ABdhPJwsU52UZvcBsWRX7CHQg7NkRLoX5NxNO7xJOtSZDDZtiW5fSHqCZnS9KT+4LTjFbn4Lh1BN8Q== X-Received: by 2002:aa7:9341:0:b029:18b:b43:6c7 with SMTP id 1-20020aa793410000b029018b0b4306c7mr4526635pfn.7.1604615779086; Thu, 05 Nov 2020 14:36:19 -0800 (PST) Received: from hermes.corp.microsoft.com (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id u5sm1026756pgj.28.2020.11.05.14.36.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Nov 2020 14:36:18 -0800 (PST) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Date: Thu, 5 Nov 2020 14:36:02 -0800 Message-Id: <20201105223602.5965-7-stephen@networkplumber.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20201105223602.5965-1-stephen@networkplumber.org> References: <20200922143202.8755-1-stephen@networkplumber.org> <20201105223602.5965-1-stephen@networkplumber.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v9 6/6] doc: update release notes now for block allow changes 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" Remove the deprecation notice and add description to the release notes. Signed-off-by: Stephen Hemminger --- doc/guides/rel_notes/deprecation.rst | 23 ----------------------- doc/guides/rel_notes/release_20_11.rst | 11 +++++++++++ 2 files changed, 11 insertions(+), 23 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index f3258eb3f725..d459a25eabe3 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -28,29 +28,6 @@ Deprecation Notices * kvargs: The function ``rte_kvargs_process`` will get a new parameter for returning key match count. It will ease handling of no-match case. -* 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. - * eal: The function ``rte_eal_remote_launch`` will return new error codes after read or write error on the pipe, instead of calling ``rte_panic``. diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst index 6bbd6ee93922..df955e2214c4 100644 --- a/doc/guides/rel_notes/release_20_11.rst +++ b/doc/guides/rel_notes/release_20_11.rst @@ -644,6 +644,17 @@ API Changes * sched: Removed ``tb_rate``, ``tc_rate``, ``tc_period`` and ``tb_size`` from ``struct rte_sched_subport_params``. +* eal: The selection of devices on the EAL command line has been + changed from ``--pci-blacklist`` and ``--pci-whitelist`` + to ``--block`` and ``--allow``. The short form option for + using a device is now ``-a`` instead of ``-w``. + + The internal macros for ``RTE_DEV_BLACKLISTED`` and ``RTE_DEV_WHITELISTED`` + have been replaced with ``RTE_DEV_BLOCKED`` and ``RTE_DEV_ALLOWED``. + + There are compatibility macros and command line mappings to accept + the old values but applications and scripts are strongly encouraged + to migrate to the new names. ABI Changes ----------- -- 2.27.0