From patchwork Thu May 7 07:06:33 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Phil Yang X-Patchwork-Id: 186287 Delivered-To: patch@linaro.org Received: by 2002:a92:8d81:0:0:0:0:0 with SMTP id w1csp2886449ill; Thu, 7 May 2020 00:08:48 -0700 (PDT) X-Google-Smtp-Source: APiQypIaF9e4ylqONEeb82JdTxnxBjjOLTICngE4FJYT4G2rbzUu04fPVVf9k5Zv2PMDsZKjBEmu X-Received: by 2002:a05:6402:88a:: with SMTP id e10mr10291797edy.252.1588835327949; Thu, 07 May 2020 00:08:47 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1588835327; cv=none; d=google.com; s=arc-20160816; b=OfIxJn3LTDKpEKglmZkszCDpQKHONxJ+VAUqHPWK/H7y+dzetIiCdduBeNjWrKGErq SMq6abyGHkcJkJy/HfIDoNzLAhqVbQdh+QBMOV15RwTMgHrffzF/eOogIaTj7coifB+J +acGJ7BHlySvn1avEXTWbD6T5qKw3/1uULkQqeuani+toMF63jwUigi5ajJXwSXZ2sGD g2h0cDeJiOyC93ClpBvaRFOSeqnsxlDIP0/Gi1egzY/Ki+tDvvyzJsT//9eiWGaurQsv 7WFAOWlf+wJadWPpzHkr1spN8o1NjyMvnAXzuiNzAZwDGhPFubTOSo/OHYM3mqT12w+r qkAA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:message-id:date:cc:to :from; bh=ogjbaVDaoc+NgpwtKAf7ft6OAOiYpdedH+Pa/Vc0Kys=; b=TZGFnawNAzSsY+CREgsbsgNS9ajTBgL5D2bagtz1awvd/tC6FeVcKY7DXsy1bAVeWC 4eNSmzU0ybAdRyi0rLZjdeeppf7EwdkkolIaeBXYzT6ii9KE6zF4shlspIoaqvcaEaVJ Q50PLshGVgPg7wlF/z591F8zCXgNV3WAI0MQU+CM9RyD2r1ZHYwFOkWL57uF9zrNMyIa bidgVfPcgqv1PUTjhMRJ/HsQsr2vvS4lQMq1ui4hdbngYI1e9OPiUi7Pl74FyIuKjHQi tfKi32I4prUqoarBw8DLxJG+q1U4LTzLZWPh+sQCVNLslb62IZziHu1h2dnlkI3adk4E NT9w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id oq26si2658550ejb.105.2020.05.07.00.08.47; Thu, 07 May 2020 00:08:47 -0700 (PDT) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id D5C971DA44; Thu, 7 May 2020 09:08:46 +0200 (CEST) Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by dpdk.org (Postfix) with ESMTP id 94F301DA3F for ; Thu, 7 May 2020 09:08:45 +0200 (CEST) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id CF653D6E; Thu, 7 May 2020 00:08:44 -0700 (PDT) Received: from phil-VirtualBox.shanghai.arm.com (phil-VirtualBox.shanghai.arm.com [10.169.107.150]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 8BE8B3F71F; Thu, 7 May 2020 00:08:40 -0700 (PDT) From: Phil Yang To: dev@dpdk.org Cc: bruce.richardson@intel.com, ferruh.yigit@intel.com, hemant.agrawal@nxp.com, honnappa.nagarahalli@arm.com, jerinj@marvell.com, ktraynor@redhat.com, konstantin.ananyev@intel.com, maxime.coquelin@redhat.com, olivier.matz@6wind.com, stephen@networkplumber.org, thomas@monjalon.net, phil.yang@arm.com, ruifeng.wang@arm.com, nd@arm.com Date: Thu, 7 May 2020 15:06:33 +0800 Message-Id: <1588835193-27550-1-git-send-email-phil.yang@arm.com> X-Mailer: git-send-email 2.7.4 Subject: [dpdk-dev] [PATCH] doc: announce adoption of C11 atomic operations semantics 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" From: Honnappa Nagarahalli As agreed in the DPDK tech board [1], after 20.05 release, patches must use C11 atomic operations semantics with the help of wrappers. [1] http://mails.dpdk.org/archives/dev/2020-April/165143.html Signed-off-by: Honnappa Nagarahalli Reviewed-by: Phil Yang Reviewed-by: Ruifeng Wang --- doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) -- 2.7.4 Acked-by: Jerin Jacob Acked-by: Hemant Agrawal Acked-by: David Christensen diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 20aa745..208708d 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -113,3 +113,15 @@ 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. + +* rte_atomicNN_xxx: These APIs do not take memory order parameter. This does + not allow for writing optimized code for all the CPU architectures supported + in DPDK. DPDK will adopt C11 atomic operations semantics and provide wrappers + using C11 atomic built-ins. These wrappers must be used for patches that + need to be merged in 20.08 onwards. + +* rte_smp_*mb: These APIs provide full barrier functionality. However, many + use cases do not require full barriers. To support such use cases, DPDK will + adopt C11 barrier semantics and provide wrappers using C11 atomic built-ins. + These wrappers must be used for patches that need to be merged in 20.08 + onwards.