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 9F6F8A0093; Thu, 21 May 2020 06:31:47 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 801DC1C221; Thu, 21 May 2020 06:31:46 +0200 (CEST) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2062.outbound.protection.outlook.com [40.107.21.62]) by dpdk.org (Postfix) with ESMTP id 8F0A71C211 for ; Thu, 21 May 2020 06:31:44 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nasOF0DwzUfiPLJKnrAlW54Xp18ATgkHkHrLl7nfBRk=; b=fsHne3phz4vsoBIPjvB2SHV+gG/VY61JSXd/OVit00EGYW0CUsIWskKvQteMuPgbowtPlPsnxSYuwq5QDdokjPK9/pZ6Jz7LshbyjbM3voJM1aHRPEDhKFq1wJNYkHwa7OFJwb+EmhZQG4PwGjLAMG5c9An660kASR++wsYaEbE= Received: from DB6PR0301CA0033.eurprd03.prod.outlook.com (2603:10a6:4:3e::43) by AM0PR08MB3026.eurprd08.prod.outlook.com (2603:10a6:208:65::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3000.25; Thu, 21 May 2020 04:31:41 +0000 Received: from DB5EUR03FT043.eop-EUR03.prod.protection.outlook.com (2603:10a6:4:3e:cafe::cf) by DB6PR0301CA0033.outlook.office365.com (2603:10a6:4:3e::43) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3021.23 via Frontend Transport; Thu, 21 May 2020 04:31:41 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dpdk.org; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;dpdk.org; dmarc=bestguesspass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by DB5EUR03FT043.mail.protection.outlook.com (10.152.20.236) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3021.23 via Frontend Transport; Thu, 21 May 2020 04:31:41 +0000 Received: ("Tessian outbound d078647f4174:v57"); Thu, 21 May 2020 04:31:41 +0000 X-CR-MTA-TID: 64aa7808 Received: from 43b234c7bd9d.3 by 64aa7808-outbound-1.mta.getcheckrecipient.com id D00DC411-7871-48D3-B661-0BFA966A150B.1; Thu, 21 May 2020 04:31:36 +0000 Received: from EUR05-DB8-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 43b234c7bd9d.3 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Thu, 21 May 2020 04:31:36 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=KO+Pnhq1ucttPzUIx3ZQF4wenA7UV6LWXx/jRs87kXU/+et0yQ0twRhj3AOSVtdlxMExH5x+Yrn3hYBOB8VDZWoq/MEk8J5soJ/UFtZtPuzE0mCAMlIySKdMN0ez2tpb2gJy/0LwL3tQOJSW7MNAmQ1T2ca6OWPB73E2+mw2IK6JyXHIQ8CabUINwoM5P/Unb8o2slnLtsrg5LwJcS++7k+L5psP3X8VNOhY9DNua5wKDFbZXLhxJfNz7JxirMYQ9jdipdmDQcDr70PU1A2Nax3CvI9VCR6pZglfHRUfiGZQJbg/qzV2mrjgKzeC0LwrGfpnwOvXu88zUpOhiHSMTQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nasOF0DwzUfiPLJKnrAlW54Xp18ATgkHkHrLl7nfBRk=; b=QUvNlVPnajPopOjFfz42L5d7UwmYh735PDorc01vfWmNEf50SWfnbzRqu3GVgVj4NTlsZqnNtpIr0DmSWbuf6Vxk+BuAAPqYNrvXqvQNw9oTSRUgUD42fHsV6Fo+HdqWXd1u4K9UItIm1TWz5S/EPgxbwjrojl16ldHvEPQweyzgfe6vKOBAVj+GOwhlWSxML7f4MGTw93j5NZ9iGCKuyZFzPv/tpqg8lyiZ0KnDGbR7tgMEsnTHOjWEaOgAwQPvxHS8u/qkV1jQLqbwMHCxV+sbMMizMbIKcg1m/ngQvu3SRMdwRRDty3vaDTZEKgDyulW2jg5ePS1N2/X7cJ+AvA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nasOF0DwzUfiPLJKnrAlW54Xp18ATgkHkHrLl7nfBRk=; b=fsHne3phz4vsoBIPjvB2SHV+gG/VY61JSXd/OVit00EGYW0CUsIWskKvQteMuPgbowtPlPsnxSYuwq5QDdokjPK9/pZ6Jz7LshbyjbM3voJM1aHRPEDhKFq1wJNYkHwa7OFJwb+EmhZQG4PwGjLAMG5c9An660kASR++wsYaEbE= Received: from DBBPR08MB4646.eurprd08.prod.outlook.com (2603:10a6:10:f5::16) by DBBPR08MB4663.eurprd08.prod.outlook.com (2603:10a6:10:d8::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3000.27; Thu, 21 May 2020 04:31:34 +0000 Received: from DBBPR08MB4646.eurprd08.prod.outlook.com ([fe80::1870:afc4:b90f:609d]) by DBBPR08MB4646.eurprd08.prod.outlook.com ([fe80::1870:afc4:b90f:609d%5]) with mapi id 15.20.3021.024; Thu, 21 May 2020 04:31:34 +0000 From: Honnappa Nagarahalli To: Phil Yang , "dev@dpdk.org" CC: "bruce.richardson@intel.com" , "ferruh.yigit@intel.com" , "hemant.agrawal@nxp.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 , Ruifeng Wang , nd , Honnappa Nagarahalli , nd Thread-Topic: [PATCH] doc: announce adoption of C11 atomic operations semantics Thread-Index: AQHWJD+GdX4DY5fFHEi/NHacACs1oaiyCHrg Date: Thu, 21 May 2020 04:31:34 +0000 Message-ID: References: <1588835193-27550-1-git-send-email-phil.yang@arm.com> In-Reply-To: <1588835193-27550-1-git-send-email-phil.yang@arm.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ts-tracking-id: 35fbd9ce-742b-43fe-bfed-7a3b4476818a.0 x-checkrecipientchecked: true Authentication-Results-Original: arm.com; dkim=none (message not signed) header.d=none;arm.com; dmarc=none action=none header.from=arm.com; x-originating-ip: [70.113.25.165] x-ms-publictraffictype: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: a8ddb24d-c6f2-4651-0ce1-08d7fd3fdc59 x-ms-traffictypediagnostic: DBBPR08MB4663:|AM0PR08MB3026: x-ld-processed: f34e5979-57d9-4aaa-ad4d-b122a662184d,ExtAddr x-ms-exchange-transport-forked: True X-Microsoft-Antispam-PRVS: x-checkrecipientrouted: true nodisclaimer: true x-ms-oob-tlc-oobclassifiers: OLM:7691;OLM:7691; x-forefront-prvs: 041032FF37 X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: 2ESkQNJpBFvjUQyUUfmIy+HlKFEj3qAQyYkFczc9zGeD8y/06BZkn8loqf1PAAWNVddV0fULm+LD7v+fGGpixVtaHeZzEyVvmuE6h3KS3WcK+D0afMqYTxxAmWJR0O7o64uhiYs0pYmjOPH4w/EG8O0dRY7Yia4zrzt7PKjCG6uKFabXybf9oc/i4EFlehFnm/Ub8YhUvqVID+iCdn5Ebdc289Uv32WinkelqIlgx+RSf1uXVCZZK3xjyvjlauCEFxJmkMreuHFBPaGG7F6nXFiLuOJ/wUNAzUGfRiyPjp84gw/cqiQ06AhVLE5Ye4ixMeNrsGdEmjnbQ+6HffNY4ReQhJYWKDtgrcZwvz/5XfFhejuWqH7v/xPynoQXCKmkdxCwsB8e7TPIoMAmB4mJPIHGvQImj1LB9lB3X/rPfP3/jG2xJ/SIhh8hAHGJGZJtDujEkTun/KKPga945ssMeHNTgm8KnncwZIKcuhu/8WkXc814/ey0UV668wAk6c7RjjZS+Nb9zekQ/71q2vKqvV7/CcxHg0aBWM5Tct06orIUBnqRjl+jVepGe+3IJDxl X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DBBPR08MB4646.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(39860400002)(366004)(136003)(396003)(376002)(346002)(54906003)(86362001)(316002)(110136005)(64756008)(7696005)(26005)(52536014)(6506007)(71200400001)(66446008)(66946007)(66556008)(76116006)(66476007)(478600001)(55016002)(8676002)(9686003)(33656002)(8936002)(966005)(186003)(4326008)(5660300002)(2906002)(7416002)(21314003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: HHN70WMnyTWY9/D0945nYIZZS1NfRAVcpc+rxeeNP6LiuROFnC+h0wUEAkBgg32+yZ6bJg80Samb4hLsPoadmp9aMi2Z5u5Zl5MmnEMqkHcr1v9izaimSfYVKSEc17l4KPoluBFPJqJjOWkPTiEwWXbCE+F/EHA485bj2dwvvnEDoAN/33ncHa2msGuxwLqkenvYKW95CKxqaujseLCRhdR7z0QkrScuRT0iB8+0M/IFRNDgCoZi7uWQAAFHi+hkn55JIZFM2vHgiQJeLJflHQ1M09BoPSY61fHnq2aNHG3tnMLWyKdliGvFRE44AjwE/8D/GtyCmV2dbXIsIBMWYOQpQzr81uV34C28dSkkGQhw0Y32/gsgrPJPQM7zWKGrcyqcn6xmK0iDp2sXBFkhjtuYkRczm4vsdDXCg9p4rpV28mUq2pkxTsBZ3KoNC7KvJbJld226lbqGkIfvHXuFr9VCz3n4Z36e0j7QULRxwOnTiPD6xby/epKPlz7AZOxx Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBBPR08MB4663 Original-Authentication-Results: arm.com; dkim=none (message not signed) header.d=none;arm.com; dmarc=none action=none header.from=arm.com; X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: DB5EUR03FT043.eop-EUR03.prod.protection.outlook.com X-Forefront-Antispam-Report: CIP:63.35.35.123; CTRY:IE; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:64aa7808-outbound-1.mta.getcheckrecipient.com; PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com; CAT:NONE; SFTY:; SFS:(4636009)(136003)(346002)(376002)(396003)(39860400002)(46966005)(52536014)(8676002)(70206006)(70586007)(336012)(2906002)(81166007)(356005)(9686003)(82740400003)(478600001)(33656002)(55016002)(26005)(86362001)(186003)(316002)(6506007)(82310400002)(966005)(47076004)(7696005)(8936002)(54906003)(110136005)(5660300002)(4326008)(21314003); DIR:OUT; SFP:1101; X-MS-Office365-Filtering-Correlation-Id-Prvs: 15ecd331-8832-4cbb-ba9c-08d7fd3fd7da X-Forefront-PRVS: 041032FF37 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: j8ZqDQ/8dnhW9HDZh/pmrNFTkBdpYbYNaMddGX8TbHZ8RRlhqYNXcsWhgIKv1pF4on8tY1XjR5HX944FqcqHILaxNaqFOs2Lpe/+8U/WJD13/BqQ2nSBs5WdmRNE3H/DSYBd2k3gipbkqAwn5ZdnMmkJVmEp5N7KW2Z2hmVa0DTHYTB2CwlvUlY0kPF+m3KuqITfd8Bi662MUYsDkIlfa01Dxije2bL6LoCXdVrpzCFfidDL4rS++zhFbjlB7DtWn3h7AIedXeHnHrTlXSFDv3/Qi8Ewm6yALeQWeHLToY8DHr7hs7Q72QfImuYyOexvA/+Gu+HzDTqys1AyNQHGLsOOwiD8UUdsnmEreyTo7UNI6th9H5LFzogseKL3wO1tpESNbTIvS91U3rPGX3B6k68sFbTo/drA/Nd37TU/HC7JCkvzsJDk0PkUKjIRGZ95MLk3uoQEGjhWjXviNmzJtMsKI/7l8D/8Cvl6VAKz1FSC1Zcw5eTXsMPtPOiwFi4WJP1OZdP8HzfvZfZCDa8XzXmOROko9ndN54ao+K6sxlDvubJ+XjswmjaV48JICCdCkjKM587RNHriN+N2izTsIFDkc8T4vcRHS96M8TM/CRVB7VPDgHiVAjDxODnl1BQ4 X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 May 2020 04:31:41.7745 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: a8ddb24d-c6f2-4651-0ce1-08d7fd3fdc59 X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d; Ip=[63.35.35.123]; Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR08MB3026 Subject: Re: [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" > Subject: [PATCH] doc: announce adoption of C11 atomic operations semantic= s >=20 > From: Honnappa Nagarahalli >=20 > As agreed in the DPDK tech board [1], after 20.05 release, patches must u= se > C11 atomic operations semantics with the help of wrappers. >=20 > [1] http://mails.dpdk.org/archives/dev/2020-April/165143.html As noted in the minutes, this has been approved in the tech-board. Can I ge= t some ACKs for this patch? >=20 > 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(+) >=20 > 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 buil= t- > ins. > + These wrappers must be used for patches that need to be merged in > +20.08 > + onwards. > -- > 2.7.4