From patchwork Thu Aug 6 17:19:42 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75257 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 159C0A0353; Thu, 6 Aug 2020 19:20:03 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 708B71C042; Thu, 6 Aug 2020 19:19:59 +0200 (CEST) Received: from mail-pf1-f169.google.com (mail-pf1-f169.google.com [209.85.210.169]) by dpdk.org (Postfix) with ESMTP id 573681BFF7 for ; Thu, 6 Aug 2020 19:19:57 +0200 (CEST) Received: by mail-pf1-f169.google.com with SMTP id 17so5061623pfw.9 for ; Thu, 06 Aug 2020 10:19:57 -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=V6uno1QJywPZwhMA0NA9QiVe8+8g9RA8/wIq+Uc3FtA=; b=hlbN4LuSuCnMbV7J2IAsfIhy+TSUNdqGDbUTgarTVMsio0K8FuD71oywqgn/Yqv65k QmLDG6kSXbuuU7IoRWZSZzYoP/qALe6FwFWiaZ+lVvKg+94wUK/5VE+BQKvzw/E+aQUW N1FVVEe+yElPRiPegetwEJ8sCdx4SMSWyPWzfcOM8IMk9AIUljaHYOgf2F8wnANcbctt sX+ChpaVr6T6QR0aFf6epHL4tB/Ty5Q+iTCtKcVSKX39SmP4xcNJQJ3C3K8y/RpWbHKZ QMBB0c6FDYgpbGuQn7QiVr5QA4r6aLT6FJTfxGr64d1s91ebr7PuqvCQRlBciwS5pR1b 6kDQ== 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=V6uno1QJywPZwhMA0NA9QiVe8+8g9RA8/wIq+Uc3FtA=; b=aDqUnhajU8PfjvBSsZ3MvrUHof1L7VAZ1YVGIWqeRzAva1guAYdwrGK96c7hWikLif NosHqwlIxF7o8ZitF03chavRAAiz/nbTCU8LtCwW9aqGZc3Q0wywsUY8tZauj1zg9P4o X+eSronWDnlYQu3z2Syr8S3Mt14d8YR2IVRsInC0j6Q8iFy6rlhpmpiKTIMv1n5x/ZUN Fp8K4T+v0L5ATMTsC6pUcniwjQA9SRXzWiFILuzKZWBMVAg41YResCc1YIGx39miPsmN WomgCw7cwq/MUyH9Rq0uwmlusnOy5lG8OTfTzFiPP46aZMLHx0FsQLBNSvDGlZt9AHoQ 1idw== X-Gm-Message-State: AOAM530IksLlBiIupL1r/vUpZZqG8UO5/se9dnLoI6QGRraAuvElBrPr kIW4Na3ipWg++QzlLmqOr69w6KTacOY= X-Google-Smtp-Source: ABdhPJwoRlGngUaAGiZbcwefdaqA4lhwIMPh5EB5yOf68S3M28Z+oqn/fpgbShs5ZBQVf70I2L7L7Q== X-Received: by 2002:a62:6302:: with SMTP id x2mr9203767pfb.26.1596734395920; Thu, 06 Aug 2020 10:19:55 -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.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Aug 2020 10:19:55 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Bruce Richardson Date: Thu, 6 Aug 2020 10:19:42 -0700 Message-Id: <20200806171947.6609-2-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 Subject: [dpdk-dev] [PATCH v3 20.08 1/6] doc: announce deprecation of master lcore 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 related to master/slave in reference to lcore. Signed-off-by: Stephen Hemminger Acked-by: Bruce Richardson Acked-by: Thomas Monjalon --- doc/guides/rel_notes/deprecation.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 299e30d92184..47badff6119a 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -252,3 +252,23 @@ Deprecation Notices ``make``. Given environments are too much variables for such a simple script, it will be removed in DPDK 20.11. Some useful parts may be converted into specific scripts. + +* eal: To be more inclusive in choice of naming, the DPDK project + will replace uses of master/slave in the API's and command line arguments. + + References to master/slave in relation to lcore will be renamed + to initial/worker. The function ``rte_get_master_lcore()`` + will be renamed to ``rte_get_initial_lcore()``. + For the 20.11 release, both names will be present and the + old function will be marked with the deprecated tag. + The old function will be removed in a future version. + + The iterator for worker lcores will also change: + ``RTE_LCORE_FOREACH_SLAVE`` will be replaced with + ``RTE_LCORE_FOREACH_WORKER``. + + The ``master-lcore`` argument to testpmd will be replaced + with ``initial-lcore``. The old ``master-lcore`` argument + will produce a runtime notification in 20.11 release, and + be remove completely in a future release. + From patchwork Thu Aug 6 17:19:43 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75258 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 812EBA0353; Thu, 6 Aug 2020 19:20:11 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id C6B7B1C0AF; Thu, 6 Aug 2020 19:20:00 +0200 (CEST) Received: from mail-pf1-f194.google.com (mail-pf1-f194.google.com [209.85.210.194]) by dpdk.org (Postfix) with ESMTP id 97C9F1C042 for ; Thu, 6 Aug 2020 19:19:58 +0200 (CEST) Received: by mail-pf1-f194.google.com with SMTP id u185so25432574pfu.1 for ; Thu, 06 Aug 2020 10:19:58 -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=81pYxq5/+eT/Pq9XswZe0EtZmmwug2HifJ5+0N5HMcc=; b=VRtmN+0ZGf2yK1HjxZVxMxK5Vu/+sxJHxPC4z1c8uFTYCEWFOGD62kt5lFuykRaLlU IBDX0u6S3R9RMZ75Sp+J+sVr95pBGxlwSv1Ovjz4HyD196YrocdE5/DuEhp1aKpdeYMd L6CesIT8b6f1QI1HaO8kyYZIlFIXufo6PgtG5KEPP1Oncc2gXd8O9lVKDSaFhkgQ6FTu 6UrAxXrpI52DerrDWKfvcXPR6sRiJ6OIq2CklduaeX97Zg0qvvt6S18Ge3Ugg7uemL1B KDJsEtserqZd54OGhdpARDxFVTcNjuspWfjdPi5vldbeIswcc3DrUv4VNatyGEOif+3W x2oQ== 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=81pYxq5/+eT/Pq9XswZe0EtZmmwug2HifJ5+0N5HMcc=; b=UtLkfueKD0UviF54ltBNg367yxp/LjuDbmo4Xg5YQ3adxbbiQHPgACCMOVbOJ/PZqu hQupGO7WzDtssxn6LaTEuV3YXfrD3MWJ6Jtllmme5v7DHjWhRMR77zMosnbR6c0NCwMx 9fPDKcb+32tSisxnmO/aTM2ivuc1LA4t46HfM2gTf5RFj4otkc8YJJ2TNwbE5JViw4Zb UJj5Ln+c9oJzLiPNWyH6AVAPs/NGr3S3U4x9gm1PBvgI2hslEV8YR4IbaN+/EWh9190z my/p5gBszjeWfwgor74BeFkongJzMstJN/dMtT1Jp/RGrDhtGIawFY6rtRIF3DTNh7E/ QJ1A== X-Gm-Message-State: AOAM533FEmpJYyfE/Q91zRSvDHfJw+D2LnJj9v6ykahgstqFVlWqFbAB +HeUgSxI6mQMUnayb0XiJ59JW8cokOY= X-Google-Smtp-Source: ABdhPJwFrgAJ7m6FusSi0lAZtSDi4FdcJi2UqHNrv8vhnIIYiLnITBC9XbN6XSya38+cQ58VUZ01tA== X-Received: by 2002:a62:647:: with SMTP id 68mr9758830pfg.45.1596734397470; Thu, 06 Aug 2020 10:19:57 -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.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Aug 2020 10:19:56 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Bruce Richardson Date: Thu, 6 Aug 2020 10:19:43 -0700 Message-Id: <20200806171947.6609-3-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 Subject: [dpdk-dev] [PATCH v3 20.08 2/6] kni: fix reference to master/slave process 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" In DPDK, the correct terms for process are primary/secondary. This is bugfix, not a change in terms for new release. Fixes: f2e7592c474c ("kni: fix multi-process support") Signed-off-by: Stephen Hemminger Acked-by: Bruce Richardson --- lib/librte_kni/rte_kni.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/librte_kni/rte_kni.h b/lib/librte_kni/rte_kni.h index f1bb782c68ea..855facd1a319 100644 --- a/lib/librte_kni/rte_kni.h +++ b/lib/librte_kni/rte_kni.h @@ -212,7 +212,7 @@ const char *rte_kni_get_name(const struct rte_kni *kni); /** * Register KNI request handling for a specified port,and it can - * be called by master process or slave process. + * be called by primary process or secondary process. * * @param kni * pointer to struct rte_kni. From patchwork Thu Aug 6 17:19:44 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75259 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 563C6A0353; Thu, 6 Aug 2020 19:20:19 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 196541C0B5; Thu, 6 Aug 2020 19:20:02 +0200 (CEST) Received: from mail-pf1-f194.google.com (mail-pf1-f194.google.com [209.85.210.194]) by dpdk.org (Postfix) with ESMTP id 117931C0AD for ; Thu, 6 Aug 2020 19:20:00 +0200 (CEST) Received: by mail-pf1-f194.google.com with SMTP id d188so19365979pfd.2 for ; Thu, 06 Aug 2020 10:19:59 -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=pFRm7furItAeHvQLUIUdFtDjcN3CMaKG39D+OeMOgg4=; b=Pn5z6YQqLc3gr6WoN4gtom/6PXtxlGibKyJqAt1rBJoaSKLH9jAyLFIn0ID6uP99uD Pxb50n2+FfgQ28tEdIfoKLPmQo/kpuX6+RwoDqpM6lTfksA82yJvTG2Gl2soSjirgljn CDfLY/791pWH/RRamGk2vMMzXjREK+d17UsIQjn5EVVml0C0DgdQrFn1GIFf+GWHjzvf s2Zq9PwVjbR244aPjLWBOecYf5FxMBLiUgFUrfOEY5rPclp3f29x7el4s2HeCx6uAtPN 7tge7/P96BVvOBTA6dkJfHPcPWEFBktmc9ac/OvsjPAUmw1IlrQU9IKPyMEtMgOs9OWY YwNQ== 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=pFRm7furItAeHvQLUIUdFtDjcN3CMaKG39D+OeMOgg4=; b=AuKOJ2gRmKqlsUdONa8IybGJUmnBDfF+pdM9PeuSgqZ1FxY/FfqG7cUi526Q41XpOU CiiTK/s4T9bhIfx8jSdSN5DH4Q823wbReqwjI7ZEUp7d+CKqcjoku6ODLv+feZshfIs4 yYJgdvS+0Eu0IRLzzNme/S20TsUt7I6ARoMfVwHyYKDPLZWVQuZkqshF/TfjkPb4kbBo nXSC9lug4dT5XEF+fIfHkr1+XlV8FONqpI88Xq7OZrTBwN6XXC9twN9ZwCXeFWY5NX4V RNAdf9lvYl0JkYaBI4wytlpwFEMgDftQcBuSaOSv/XqkdxY3zJrjKpWhO03JeJSKbSR1 9vGQ== X-Gm-Message-State: AOAM532xz74a355IDPPEdfEQAh/4L7TCaxG8B4h4uGMFtYZKN0V7aVUz EGTwOaNAZxQwtWj79g69t4bokji9MCo= X-Google-Smtp-Source: ABdhPJw7Qlv8OxX8uv1qEd89SLLFpn65xs1L5AtqNNKkCH7CJmZ4diDlWL8zHC45RjvmcXBBST8waw== X-Received: by 2002:aa7:9569:: with SMTP id x9mr9331628pfq.16.1596734398919; Thu, 06 Aug 2020 10:19:58 -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.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Aug 2020 10:19:58 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Anatoly Burakov Date: Thu, 6 Aug 2020 10:19:44 -0700 Message-Id: <20200806171947.6609-4-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 Subject: [dpdk-dev] [PATCH v3 20.08 3/6] doc: fix incorrect reference to master process 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" Correct terminolgy here is primary process. This is a bug in original doc. Fixes: fc1f2750a3ec ("doc: programmers guide") Signed-off-by: Stephen Hemminger Acked-by: Anatoly Burakov --- doc/guides/prog_guide/thread_safety_dpdk_functions.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/guides/prog_guide/thread_safety_dpdk_functions.rst b/doc/guides/prog_guide/thread_safety_dpdk_functions.rst index 0f539db2b869..5618e25e47fb 100644 --- a/doc/guides/prog_guide/thread_safety_dpdk_functions.rst +++ b/doc/guides/prog_guide/thread_safety_dpdk_functions.rst @@ -61,8 +61,8 @@ rather than subsequently in the forwarding threads. However, the DPDK performs checks to ensure that libraries are only initialized once. If initialization is attempted more than once, an error is returned. -In the multi-process case, the configuration information of shared memory will only be initialized by the master process. -Thereafter, both master and secondary processes can allocate/release any objects of memory that finally rely on rte_malloc or memzones. +In the multi-process case, the configuration information of shared memory will only be initialized by the primary process. +Thereafter, both primary and secondary processes can allocate/release any objects of memory that finally rely on rte_malloc or memzones. Interrupt Thread ---------------- From patchwork Thu Aug 6 17:19:45 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75260 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 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 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 Acked-by: Thomas Monjalon Acked-by: Gaetan Rivet --- 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. + From patchwork Thu Aug 6 17:19:46 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75261 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 54E3FA0353; Thu, 6 Aug 2020 19:20:34 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 201F51C0C6; Thu, 6 Aug 2020 19:20:05 +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 802A61C0B8 for ; Thu, 6 Aug 2020 19:20:02 +0200 (CEST) Received: by mail-pl1-f196.google.com with SMTP id f10so3109752plj.8 for ; Thu, 06 Aug 2020 10:20:02 -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=yRS5EX28Q2QeWiBu2t0QCmPakOZkRfkujDorY6viupM=; b=J1iDgHqn25B8OyhlE4yg43HXRlbrA4kaFcJD2nUO01mp5oWYKIBL9S4T6yE/L67uu+ XjPA0QOjPIo0tUxo7xRJRf5pOir0tIpAlppGiPIFEdtpgRL0/rCTrtZgCrDwPKYxKTPi w/VTYsI1zJZf6h9ZUqnY8V1viiI3rwt6gyiumNvHQd02eijTrZOIhrxddKd7jVwFmY0a dOjZLEJ1j1ksoRDXYmErpHNvuBraP6DdTEveVQKwMId9c0/URw8riewjvAVXmbbuzm9x wwqUr2aS5tK1KWQ6+3IxeZC9wQGpSCG4qK/fh4vN5w2fHDHPibSJ3Qxv/wDdflkZnHr9 TEXg== 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=yRS5EX28Q2QeWiBu2t0QCmPakOZkRfkujDorY6viupM=; b=C83jwn9jcTzCCp4ENeomkrbkiEKSSbqzcOWSEBhypTkOjZtbO4uzqryXFZrgNTdb5I 13GlhdTlKd5f/mqq87h78L+4pEYmCGhTXdRALq6pjmP1EYa/JZchYwwO3uCsufy2kHYy Gzh3/oA7Qe4iOOh36o+y2LzlO+WtLNy0oroaFWduo6oVf/VxRA/OEOZ8YuvghGeWUn1b xZqcPgruHGL89uyFkyTaiNeI41cZ1lqP/1sYGMbtvR4jO5ElkQuiOaklekEAqGiKp6tE DQK7YkyembUrbKZVciOG7O0oh0R5fEOwg+a3IPrh10WpgD1kaW67vziDQUVLbaP2f1Jk EwOA== X-Gm-Message-State: AOAM530cr+rEdlhsh44n9l2IJygwPfECA0k/xoAwgmtqkGAl9mZVN9rn DJ4S0Whe8tWniJbz2Kky/n7AqCcMYr0= X-Google-Smtp-Source: ABdhPJyGQI0bEW7nwNPebpus5Z9r1smbeLxLt7nlc0MdoXJD+LcHZA3S2QrAttcLJ762J7bIwwDw6g== X-Received: by 2002:a17:90a:22a3:: with SMTP id s32mr9541708pjc.49.1596734401383; Thu, 06 Aug 2020 10:20:01 -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.20.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Aug 2020 10:20:00 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Luca Boccassi Date: Thu, 6 Aug 2020 10:19:46 -0700 Message-Id: <20200806171947.6609-6-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 Subject: [dpdk-dev] [PATCH v3 20.08 5/6] rte_ethdev: change comment to rte_dev_eth_mac_addr_add 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" The comment used the term whitelist and was awkardly written. Replace it with simpler direct description of adding a new address. No code or API changes for this. Signed-off-by: Stephen Hemminger Acked-by: Luca Boccassi --- lib/librte_ethdev/rte_ethdev.h | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/lib/librte_ethdev/rte_ethdev.h b/lib/librte_ethdev/rte_ethdev.h index d29930fd847e..70295d7ab7a2 100644 --- a/lib/librte_ethdev/rte_ethdev.h +++ b/lib/librte_ethdev/rte_ethdev.h @@ -3379,8 +3379,7 @@ int rte_eth_dev_priority_flow_ctrl_set(uint16_t port_id, struct rte_eth_pfc_conf *pfc_conf); /** - * Add a MAC address to an internal array of addresses used to enable whitelist - * filtering to accept packets only if the destination MAC address matches. + * Add a MAC address to the set used for filtering incoming packets. * * @param port_id * The port identifier of the Ethernet device. From patchwork Thu Aug 6 17:19:47 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 75262 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 811DFA0353; Thu, 6 Aug 2020 19:20:45 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 2466C1C0CD; Thu, 6 Aug 2020 19:20:06 +0200 (CEST) Received: from mail-pg1-f194.google.com (mail-pg1-f194.google.com [209.85.215.194]) by dpdk.org (Postfix) with ESMTP id C3CF71C0C3 for ; Thu, 6 Aug 2020 19:20:04 +0200 (CEST) Received: by mail-pg1-f194.google.com with SMTP id x6so12065190pgx.12 for ; Thu, 06 Aug 2020 10:20:04 -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=YYRrxwxLEI7CVkNUbLhhY7kjAfRCgfJG0q+VtDkUPtI=; b=Rjgog5jbUNbWXn9Zsx6/NPy55Tvm5XJDl4+4xsxwQYzgbozVOtTEmHqfLongT40YtA iFyrDGCHfySH/08oO3ZVRfthezELsv7dqGsXjosDYqinFKXd1uSe4ftbmczM/dRN8bE3 oby09HRMygLFB+W1UE2XSj/V1EaVKTDTfsyE/pEGoS/6x2utxePSNcXjBmUE9xU2S+ZI 8nTrX8ndgyvLJ9o43UsdBrmbijeCXEzBJGUnRo5a8dH8rYWgw/pxg3lL+DveI0+xpxHg xxyIb1dZcODyQkpEhKlK6bkYzfbRiBH1T9qsNaPkFMPnY07Ez8vfpCokyTwhquS0oKTs BewQ== 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=YYRrxwxLEI7CVkNUbLhhY7kjAfRCgfJG0q+VtDkUPtI=; b=eE0oqZ4+b0tayE/oxM53PUKb3sPz9p2o0nwdVCNQ+2undssGJbG5TxYYbRT0cNYRvj YbBNeJcH2xrxq9BnvOqM/IyEhLJogcOXzWPzWCNu6XQ2vbSggruzE7owrY4zBRGlbmng Kq4w6m9sDJ6PRNdc2US6N6q4maZAD1l8cIm+JnG5nginBtwaToxbLfPGejN3wgelmHlW Fi6Iu9+iL+72qnaI+a69ej0zsU9yjcf0HgQ7IXDdIVxxEEqe3PIRm++aGFRbN7hqwOa5 mxFUsYfDh9bGv16wo2OWUG08wtbJvTIZIf2Nysi5elCTMTRQgTn92cM/41hFJbgqOttd 7UkQ== X-Gm-Message-State: AOAM530PLszHzHn7HsywFwU9rrCzRgmr7ogxGHE99Qkf0KVH2e34nUC6 rfdWseJc3YwAoFrVBaE8q/uX18tK4vQ= X-Google-Smtp-Source: ABdhPJyWO7NOy7NlzCTnhBHh+mLrQHM8DCrE9QNdLz2qayYCLYTHN9fX457gJsBrwfrWut8draZ86A== X-Received: by 2002:aa7:9f1b:: with SMTP id g27mr9076298pfr.215.1596734403600; Thu, 06 Aug 2020 10:20:03 -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.20.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 06 Aug 2020 10:20:02 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Luca Boccassi , Thomas Monjalon Date: Thu, 6 Aug 2020 10:19:47 -0700 Message-Id: <20200806171947.6609-7-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 Subject: [dpdk-dev] [PATCH v3 20.08 6/6] check_maintainers: change variable names 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" Change variable names in the shell script. Replace whitelist with include_files and blacklist with exclude_files. Signed-off-by: Stephen Hemminger Acked-by: Luca Boccassi Acked-by: Thomas Monjalon --- devtools/check-maintainers.sh | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/devtools/check-maintainers.sh b/devtools/check-maintainers.sh index 85a300f0a029..df3f740b6e84 100755 --- a/devtools/check-maintainers.sh +++ b/devtools/check-maintainers.sh @@ -42,10 +42,10 @@ parse_fx () # for line in $( (sed '/^-\+$/d' $1 ; echo) | sed 's,^$,§,') ; do if echo "$line" | grep -q '^§$' ; then # empty line delimit end of section - whitelist=$(files $flines) - blacklist=$(files $xlines) - match=$(aminusb "$whitelist" "$blacklist") - if [ -n "$whitelist" ] ; then + include_files=$(files $flines) + exclude_files=$(files $xlines) + match=$(aminusb "$include_files" "$exclude_files") + if [ -n "$include_files" ] ; then printf "# $title " maintainers=$(echo "$maintainers" | sed -r 's,.*<(.*)>.*,\1,') maintainers=$(printf "$maintainers" | sed -e 's,^,<,' -e 's,$,>,')