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 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 Content-Transfer-Encoding: 8bit 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 --- 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. + -- 2.27.0