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 F171EA052B; Thu, 30 Jul 2020 02:58:25 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 181D51BFFE; Thu, 30 Jul 2020 02:58:19 +0200 (CEST) Received: from mail-pj1-f41.google.com (mail-pj1-f41.google.com [209.85.216.41]) by dpdk.org (Postfix) with ESMTP id 09FB74C93 for ; Thu, 30 Jul 2020 02:58:16 +0200 (CEST) Received: by mail-pj1-f41.google.com with SMTP id c10so1149232pjn.1 for ; Wed, 29 Jul 2020 17:58:16 -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=bRVyK9zJ3O7EYwRulhRR5sx11SmHsQ2viZX5yVBobuQ=; b=LF224QnSJ6SJTE2tG5c8gr7JqepVmkwQNFwh1eOtJ9PPgaTl0sNnSEreFjRtC93Eox I4hOqMPqlNaCXcwyjr/hr/JroZNzQ/BQHzxxPgQkEiqNBnqc7IgZPamwawTIGYWc5Lt/ a4lZbjFpEd7osdTdKX1AJ6Tmes/X89Wn1QSqB8lhD51DkUzrdGbTfKWrSw26jTV1LroX vNEKLxf8iyHCBRjaNq1H+D60jbjIiFqzejauFAZSmJY50TS2GlWXayUnLe3NnCpQuQLR cNhKdAEQl/EAKUPumeKAwXMvjvPj2LmkwYzk2ZeyFQqwn9C0nGtciAeUX98Eg/PAsU07 4AHA== 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=bRVyK9zJ3O7EYwRulhRR5sx11SmHsQ2viZX5yVBobuQ=; b=irgMH+KCTmvAdPOjWfpEqsUEAqkMnTotBIxyqHNB+eX4TW+fodnf7mIPZZXUz39A0Q X9Rsp0nH1QZfi9YcCW74zFaiQ9Uq6wGE/o7mmXrpTan9L9p9owEdKCW7oDTFS5T2Mluv muRwndkhN0x0NkoANMhQedxUcxgELxA6CeCy6+1EkkygeLHjLcRppVg4Y7dQHiWrc5Ur /rxCUSF8OX+0ZepVUN9feWrszp9qXyuVXJeBX4DBG6aoBHFmXKl1cf9ZtOV1SFbZxeNw aISQ2yKeIifG3JSpex5Y01Zf4wJdFYFaVyZr8hh045RVADvfUz3pJGvd8Nu8eTaKDshS 7kbw== X-Gm-Message-State: AOAM532Xb7MCljM3E2UxP3ldlOAjZCt3cW2mkCnhxaKsYBiV94HKSRJf C6a0fIHXWy6be5mWAG3nUFaE7I0xl+PQMg== X-Google-Smtp-Source: ABdhPJx9Yf79i5eMcHfVRFqI0KNUrLeDXETRyIN+q6C0g3CL6NnJxK48E4/Khfl3lHpLru2cVWcu5g== X-Received: by 2002:a17:902:bd09:: with SMTP id p9mr30261135pls.287.1596070695569; Wed, 29 Jul 2020 17:58:15 -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.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Jul 2020 17:58:13 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Date: Wed, 29 Jul 2020 17:57:59 -0700 Message-Id: <20200730005804.19251-2-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 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v2 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 --- doc/guides/rel_notes/deprecation.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 99c98062ffc2..7c60779f3e68 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -148,3 +148,20 @@ Deprecation Notices Python 2 support will be completely removed in 20.11. In 20.08, explicit deprecation warnings will be displayed when running scripts with Python 2. + +* 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 21.11 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``. -- 2.27.0