From patchwork Wed Jul 15 23:02:48 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 74143 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 1AF42A0540; Thu, 16 Jul 2020 01:03:09 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 641818F96; Thu, 16 Jul 2020 01:03:08 +0200 (CEST) Received: from mail-pl1-f195.google.com (mail-pl1-f195.google.com [209.85.214.195]) by dpdk.org (Postfix) with ESMTP id B15FF3421 for ; Thu, 16 Jul 2020 01:03:07 +0200 (CEST) Received: by mail-pl1-f195.google.com with SMTP id k5so3015232plk.13 for ; Wed, 15 Jul 2020 16:03:07 -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=5jlwIWcx1HusefEclznJWuy8oOLkuoumLhdWXTDNO+4=; b=tCTa3huuOAMOmPJdrOZUqUjSX3eRPcbGk/g3CFTwxH1nVKCZAAiVrCJT2N7ETeFNbx XA2xfsN5zcu7U7/wKPqt90gCOxbMiYkzds2H1o4MyWV/tqQ6Tgd4t0tfaupgrMf5yNFg VxciFW2VB//ouZFFp/wtE0XsIGN/zU/vGgB2t8COOMxCLNTy0JovhuB8Bzn/R4N7XgHU wjPGOq+FUWbwn9mxAHKpnf2i4S4OslU07BTdXFq/Oh9VL+QHzwlfUUmybkil/tkdTUA2 tlbix/P//m5YxOairKgNZBqheApNSOKtjGOXj9pN12OfFpuvVjRcs5FRm4kYyIbWA/Nr tHdQ== 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=5jlwIWcx1HusefEclznJWuy8oOLkuoumLhdWXTDNO+4=; b=BXpliq/ABA5LWeEfcQdnjGVIML5JT1v0bT315hpEfCnBvq9v4+kmAHNm3x5BABkuOo hLgQt+uWz6dYGvzxc+ExpShRpZWBy9B3GXH5DmnEgVHdIr6zywfDAu8CwWILnMM+MrO8 N0RgNx1pvbn1E1MHZO/RYT9j96jBf+r7bz4izTP2YYKaXlp+hKGDcbkMaH/2KyTrXrza xtZSCk+MkAxeig3lKG/faZEGORoRyNMCHtAp4f8v+tQa8Z4Mc0N/qVwIvdBL14ETnnXC WVOIOIhpo9UgNKJSsTeEtgCTIN3ASI9mDULIUz875s9xSiVZ7Mmn5ODLyl4xG9BEKm5g rvjQ== X-Gm-Message-State: AOAM532eXix8AgjzkS3NS5Lfxg4zU5nJHxhJiQvNSwoEYUK34Knvzwsl FC95h16ozkw6Alv8CPynbjuiK2qE/8cWqQ== X-Google-Smtp-Source: ABdhPJw8bLRbGuEPOUwmHu6rhAj2C6Ln4x2mqK+xBI2QvLemulc8Sv2Ou6IEaDsxYNZeijr9ZR3Y/Q== X-Received: by 2002:a17:90a:ee95:: with SMTP id i21mr2025159pjz.77.1594854185590; Wed, 15 Jul 2020 16:03:05 -0700 (PDT) Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id ji2sm2980888pjb.1.2020.07.15.16.03.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Jul 2020 16:03:04 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Date: Wed, 15 Jul 2020 16:02:48 -0700 Message-Id: <20200715230257.30810-1-stephen@networkplumber.org> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20200607170127.15694-1-stephen@networkplumber.org> References: <20200607170127.15694-1-stephen@networkplumber.org> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH v5 0/9] rename blacklist/whitelist to exclude/include 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 terms blacklist and whitelist are often seen as reminders of the privilege in society. Instead, use more exact terms for handling of which devices are used in DPDK. This is a proposed change for DPDK 20.08 to replace the names blacklist and whitelist in API and command lines. The first three patches fix some other unnecessary use of blacklist/whitelist and have no user visible impact. The rest change the blacklsit/whitelist option to new syntax. Thank you for the support and review of this patch. v5 - Minor checkpatch warnings Change to even simpler include/exclude for long options because the option applies to not just PCI devices. Consolidated the documentation changes into one patch. v4 - change to use pci-include/pci-exclude for options incorporate review feedback keep old options (with approporiate deprecation notice) update examples in doc Stephen Hemminger (9): rte_ethdev: change comment to rte_dev_eth_mac_addr_add mk: replace reference to blacklist/whitelist check_maintainers: change variable names eal: replace usage of blacklist/whitelist in enum drivers: replace references to blacklist eal: replace pci-whitelist/pci-blacklist options app/test: use new allowlist and blocklist eal: mark old macros for blacklist/whitelist as deprecated doc: replace references to blacklist/whitelist app/test/autotest.py | 16 ++--- app/test/autotest_runner.py | 18 ++--- app/test/test.c | 2 +- app/test/test_eal_flags.c | 52 +++++++------- devtools/check-maintainers.sh | 8 +-- doc/guides/cryptodevs/dpaa2_sec.rst | 4 +- doc/guides/cryptodevs/dpaa_sec.rst | 4 +- doc/guides/cryptodevs/qat.rst | 6 +- doc/guides/eventdevs/octeontx2.rst | 20 +++--- doc/guides/freebsd_gsg/build_sample_apps.rst | 2 +- doc/guides/linux_gsg/build_sample_apps.rst | 2 +- doc/guides/linux_gsg/eal_args.include.rst | 14 ++-- doc/guides/linux_gsg/linux_drivers.rst | 4 +- doc/guides/mempool/octeontx2.rst | 4 +- doc/guides/nics/bnxt.rst | 6 +- doc/guides/nics/cxgbe.rst | 12 ++-- doc/guides/nics/dpaa.rst | 4 +- doc/guides/nics/dpaa2.rst | 4 +- doc/guides/nics/enic.rst | 12 ++-- doc/guides/nics/fail_safe.rst | 22 +++--- doc/guides/nics/features.rst | 2 +- doc/guides/nics/i40e.rst | 12 ++-- doc/guides/nics/ice.rst | 18 ++--- doc/guides/nics/mlx4.rst | 16 ++--- doc/guides/nics/mlx5.rst | 12 ++-- doc/guides/nics/octeontx2.rst | 22 +++--- doc/guides/nics/sfc_efx.rst | 2 +- doc/guides/nics/tap.rst | 10 +-- doc/guides/nics/thunderx.rst | 4 +- .../prog_guide/env_abstraction_layer.rst | 7 +- doc/guides/prog_guide/multi_proc_support.rst | 4 +- doc/guides/rel_notes/known_issues.rst | 4 +- doc/guides/rel_notes/release_20_08.rst | 6 ++ doc/guides/rel_notes/release_2_1.rst | 2 +- doc/guides/sample_app_ug/bbdev_app.rst | 6 +- doc/guides/sample_app_ug/ipsec_secgw.rst | 6 +- doc/guides/sample_app_ug/l3_forward.rst | 2 +- .../sample_app_ug/l3_forward_access_ctrl.rst | 2 +- .../sample_app_ug/l3_forward_power_man.rst | 2 +- doc/guides/sample_app_ug/vdpa.rst | 2 +- doc/guides/tools/cryptoperf.rst | 6 +- doc/guides/tools/flow-perf.rst | 2 +- drivers/bus/dpaa/dpaa_bus.c | 7 +- drivers/bus/fslmc/fslmc_bus.c | 9 ++- drivers/bus/fslmc/fslmc_vfio.c | 8 +-- drivers/bus/pci/pci_common.c | 24 +++---- drivers/bus/vmbus/vmbus_common.c | 4 +- drivers/crypto/virtio/virtio_pci.c | 2 +- drivers/net/fm10k/fm10k_ethdev.c | 2 +- drivers/net/virtio/virtio_pci.c | 2 +- lib/librte_eal/common/eal_common_devargs.c | 14 ++-- lib/librte_eal/common/eal_common_options.c | 71 ++++++++++++------- lib/librte_eal/common/eal_options.h | 6 ++ lib/librte_eal/include/rte_bus.h | 13 +++- lib/librte_eal/include/rte_dev.h | 12 +++- lib/librte_eal/include/rte_devargs.h | 13 +++- lib/librte_ethdev/rte_ethdev.h | 3 +- mk/rte.sdktest.mk | 14 ++-- 58 files changed, 308 insertions(+), 261 deletions(-)