From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id EF8DAA0C41 for ; Sat, 17 Jul 2021 20:48:09 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 631154115E; Sat, 17 Jul 2021 20:48:09 +0200 (CEST) Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-eopbgr140089.outbound.protection.outlook.com [40.107.14.89]) by mails.dpdk.org (Postfix) with ESMTP id 214614003C; Sat, 17 Jul 2021 20:48:07 +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=/9nxjrqtsdgmXw+AzA6WmPeoDL5u2N9yluxNf7psp8Y=; b=J1EEBNsi1TfbWKmm6ZaXObhp5856s5+70jZE4YnhuRew6uXzJm04q0bfuPfLRejVMleOtd0HasV/YPu8XxNcRpM8qnjT2zPz+oOl8H+t66foV6fjKdtsCx6IyOCRsHa+hnUafMCcicSOmPA0+WoB3UZAJZsWFMuV8B3UVpcoNqs= Received: from AM6PR01CA0048.eurprd01.prod.exchangelabs.com (2603:10a6:20b:e0::25) by HE1PR0802MB2586.eurprd08.prod.outlook.com (2603:10a6:3:df::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4331.26; Sat, 17 Jul 2021 18:48:04 +0000 Received: from AM5EUR03FT009.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:e0:cafe::41) by AM6PR01CA0048.outlook.office365.com (2603:10a6:20b:e0::25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4331.21 via Frontend Transport; Sat, 17 Jul 2021 18:48:04 +0000 X-MS-Exchange-Authentication-Results: spf=temperror (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=temperror action=none header.from=arm.com; Received-SPF: TempError (protection.outlook.com: error in processing during lookup of arm.com: DNS Timeout) Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by AM5EUR03FT009.mail.protection.outlook.com (10.152.16.110) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4331.21 via Frontend Transport; Sat, 17 Jul 2021 18:48:02 +0000 Received: ("Tessian outbound bbfc4df8f27e:v99"); Sat, 17 Jul 2021 18:48:02 +0000 X-CR-MTA-TID: 64aa7808 Received: from 128db41288cd.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id FFEF7370-4333-45CD-82F7-799244E07037.1; Sat, 17 Jul 2021 18:47:56 +0000 Received: from EUR04-DB3-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 128db41288cd.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Sat, 17 Jul 2021 18:47:56 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=gxZCo6qRskn224wcFB/irrLptpLT72tQmXaEKgQ3aa5Z4sDgGqm02kXpPTvT3pnws6FaXDBqQC6AigsAYZ4fdVavP25Uxi/4cGGpPsLAMVjQRBkDSMoGrMjU9ZFT2RMKolnK9K3C7VasbTVF7VIxFg+cIF2YxOmVzorULYnz5Jhfx8+0rFf168QzvvR726FuCMWNUSvY1Z5YYqzBHqghBaMOhwOeCHSaG7uE56rGEwhzi84g8xNbx2mmIUmGxDmFCjpDWOax5ZDWWoFTrZtlkVpsSExK6aGjA9OsAt1fWtBS66xrVBbcNC7yERS9WJ97HoaG20nn0Tf3aKtEVX+KmA== 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=/9nxjrqtsdgmXw+AzA6WmPeoDL5u2N9yluxNf7psp8Y=; b=XMsORlchmch/6tJnO+HCyn1s5xEqp4f/JVRPkzNG8VtZDI7NhdI5c3DP7r9njIbFgxKgD0bpRrf3cO6m5Xg8pUITdlvYFh69ViLHwbs5h0dsbzBCFu2k/NnshbHfxDMp6mfxkBNm6Dpm8D1D/rQZjBPCtQ9JxRRLOkxlFiL6XwZB12G5upP6fEWp69yg303cYWOnwOgXtJkM4FjCCqN/mcL3/v4rIz6PPsdfP2VsQB1RJmktgLsR1T/v7yDHyLpE0aTN0fVN9CnrHlLrrIAf/v/0wc3lRKa2LBOiFK/LyFkUOLVLXQUuLqfHyBx1ktdKZr+0I1/oHBFdb8JvXUy/aA== 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=/9nxjrqtsdgmXw+AzA6WmPeoDL5u2N9yluxNf7psp8Y=; b=J1EEBNsi1TfbWKmm6ZaXObhp5856s5+70jZE4YnhuRew6uXzJm04q0bfuPfLRejVMleOtd0HasV/YPu8XxNcRpM8qnjT2zPz+oOl8H+t66foV6fjKdtsCx6IyOCRsHa+hnUafMCcicSOmPA0+WoB3UZAJZsWFMuV8B3UVpcoNqs= Received: from DBAPR08MB5814.eurprd08.prod.outlook.com (2603:10a6:10:1b1::6) by DB9PR08MB6682.eurprd08.prod.outlook.com (2603:10a6:10:2a2::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4331.28; Sat, 17 Jul 2021 18:47:48 +0000 Received: from DBAPR08MB5814.eurprd08.prod.outlook.com ([fe80::5584:cefa:9ad:e028]) by DBAPR08MB5814.eurprd08.prod.outlook.com ([fe80::5584:cefa:9ad:e028%6]) with mapi id 15.20.4331.030; Sat, 17 Jul 2021 18:47:48 +0000 From: Honnappa Nagarahalli To: Joyce Kong , "thomas@monjalon.net" , "stephen@networkplumber.org" , Ruifeng Wang , "mdr@ashroe.eu" CC: "dev@dpdk.org" , nd , "stable@dpdk.org" , Honnappa Nagarahalli , nd Thread-Topic: [PATCH v1] doc: update atomic operation deprecation Thread-Index: AQHXdvR4fg1gYrs54EKv4mpDi2rzYatHhkkQ Date: Sat, 17 Jul 2021 18:47:47 +0000 Message-ID: References: <20210712080237.19920-1-joyce.kong@arm.com> In-Reply-To: <20210712080237.19920-1-joyce.kong@arm.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ts-tracking-id: 2E9AA39C78915C408DBFD248C3637317.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-ms-publictraffictype: Email X-MS-Office365-Filtering-Correlation-Id: 6d5ae605-5d70-4998-b914-08d94953684d x-ms-traffictypediagnostic: DB9PR08MB6682:|HE1PR0802MB2586: 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:8882;OLM:8882; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: QsJWtvs4RzVGclm9G3wBLNG4XBi3y4yh5hSDFnNs02zuNuW2NsxSZLrmL8uc9fuXlhwUdKy3X/rLrXtT7L1oOil8Ube5F4vQeXxP9sXL7uMkPzCqAYXDy9eiXLwjGX4dlDDPDNsWVGVAUC+jPGBXn7ARMIzTEVzYox4ytflXMt1Pe4ijsjq3HkLUATVg4sLTacbmxszyEA0vZSPi/RjKEd4e9DbUYUaCC3Us4SyXEx8ujtDy/qwXPZ0vKSP9D6zCpeIsIwntTbwiT/L/UriHEbEitPCA5C27Ya5vD+ODhT47ysdKoiNqUJN9QB8nxOkf3+ZeiHDwKSAjA1S+i2MyZIXgH/7b5br78DXUh/09i+xmPFFfKp+vSAM9TKWi4GLsWieyTIgHN+FV3XpAa0BeOAcXXUTkTfGPc+5F05joeKFjck8mw02kGMEJpJe65q8QQ24NywvXcQJixVP1zW3K/Cwk5qw6lKyXKqMoQZwP5wlLohVJPxnL17uWhg4jsBXJFW4M3OQdWRxCh4J6SqQbIb99HMMBalnflSNo+R3+/SswU6l7bUKBEtDhKNyukh3G1hv4K7b/oGWJ96v0d+7s/OLhzoyEsE84cDVpRpOCxdfTCE3LU87IkkYFkF3QBvX52v3UZ3xSlD4CvmLkhZGGOAZKafg652/Zd6UCc9ZPOk9tOiOsawb3fYSahDr1uIhSUZrKzwrkqNcsA5JJvGZ52EZyMTrgDZlrRZ21r/9DBJN+edRSk7ozSs6yLMg5sgxDoHIexXqZ/wMjR3JRFacNIyVjKwoVb8CKn57N6RZi8WL62Af6T7F443mUeZ3Eqnh7c/aUZLgpK6whsra/88TxQMHuu9+AnWtv0qND8Zi0cbw= X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DBAPR08MB5814.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(136003)(346002)(376002)(396003)(366004)(39850400004)(33656002)(86362001)(110136005)(54906003)(6506007)(66476007)(71200400001)(8676002)(66946007)(15650500001)(66446008)(7696005)(38100700002)(122000001)(2906002)(66556008)(83380400001)(64756008)(316002)(478600001)(186003)(966005)(5660300002)(26005)(55016002)(9686003)(8936002)(4326008)(52536014)(76116006)(21314003)(38070700004); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?p5xZ8f3VYY05Xv+vhFT2HPGRWMWWsaO+m+lC8B+B6sOs3FU7irA0h3s/o+bC?= =?us-ascii?Q?BwzZx4Yi28CgrfcFDhgL3AWEfEzAEBIPtPzVu+Fh7ThZAQW5UWmZqYkqAixW?= =?us-ascii?Q?e5Xg+u8N2bqFt/K/i/5mYiFcfV1iKXQWfRq5rWraA1tUdVlvdDaeszlX3XQV?= =?us-ascii?Q?Gwmtr6kh8W67IFm6nfv+NE9udjMIfpCCJe22xtHmHr+7t76tXDxCPHLXxNDw?= =?us-ascii?Q?ak8vkp0R4rq+Qz1Mw3H4eEbZ8b8melSoOgtlrrGPqDcGihd2IpfBOvk/rPpr?= =?us-ascii?Q?CB80+pVvhFlYBySa2QZfj/0R/mi2MsuqVpU/wHkd8ld+kCCOkw4CHJSo+KWa?= =?us-ascii?Q?Wqs8w1VAklcyoim/LBZITEKa2uPhsa+cK5QRw9X1UdReM97dpjsXZ1EclDg5?= =?us-ascii?Q?VOn7vxBAGejt8ZinRPTgai8hZAiBYtG03/lollUf4m8NWJDCCklkOQdVCqeD?= =?us-ascii?Q?B0/n1fJD9Nr/T8Gvw6un8ERepI59PXHXjYTC3izpM/YoyqjvpfLWtEuvCGyR?= =?us-ascii?Q?9onMNLRCKzzEtt2uZvgh2rzyVC3cZBFilGRXzWFOZXhyjHi1vLwXa4cfikIX?= =?us-ascii?Q?YuLQqm2r3ssni2oicNH0+XMikSX8L7wF2kfIC1ykAMor0zwJDdvSTbOFPgBc?= =?us-ascii?Q?+KEiL2jw2L7HwxPNf9wuaomta/UUvMFMYqdSC16TdU1nDqdeYcBXpA36ZimT?= =?us-ascii?Q?TAaooc/6EKDOYysZgjzQWVOxA+3cyVvsCD8axMh5PNKw7AUoh13uZYsI0zdT?= =?us-ascii?Q?/jCsD8qQVnGndBk1ZYM7mdsHKpvksTb9GQmqbjJQCKnCyoSxgibBRAoW4SUl?= =?us-ascii?Q?eSSE2eqecLm2+ceQctn+8K9HQHOOXLvph0RRFSQ9uKpPzkj1SLM9vjGZzgy1?= =?us-ascii?Q?YA15ueNhSTgMZzPA5SLqtLrU345HEefa+xrSEjxnCk/rEar5NEQDKgbm8KQX?= =?us-ascii?Q?/wMEzAxKY7eln5VPZjzXDspxN+/C6UvmOIv4x6y8KMEAwSa0trq5XRHyr+Fg?= =?us-ascii?Q?PzNfPohaNpJRUVYMW9xXTPHZ90yhRtNy0grJH4tBolOe+xVT4/eURbSMxHFK?= =?us-ascii?Q?YO7vvhbXJqbJW0W+uyTa9D5jveVpKxrqHvdKy73YbFDTBAawoOQ281j13atu?= =?us-ascii?Q?2TZMZV7/H2CKJckpoH7k+zBZwWEm3DrTPi9zd9rzbazoNBwM2OMpFNbPeWLJ?= =?us-ascii?Q?wM2WEC/DdZ/TL+6Zg1vb/nvNJwPmt58QYRvFK0QUHVPtiROY1tJ+i8AsRKky?= =?us-ascii?Q?7Mtn9sUN4iIqU+xUaCVPb48QYXpFlZfW+Nxnu5g0kxuSuKFSfCWPSzy9SLdx?= =?us-ascii?Q?3iIchU2ivS5rQAm83Vw+o55Z?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB9PR08MB6682 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: AM5EUR03FT009.eop-EUR03.prod.protection.outlook.com X-MS-Office365-Filtering-Correlation-Id-Prvs: 04bec999-f084-4739-a940-08d949535f6d X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: ZsUsGVRnspDPIqXI4BMvKJ/7vo1XDeKw2ECP50tBVyDHXmGOJTPDq5P1a1nOSk55jIu+APEvLKoinNtjzZyCRWt+ovYMK37/qNUCTcVKuU7cbFYX7cNs6YZ4Qa4QXryN6z4VTGluwfjH6XrUhIJSdIpv8/Egt8G222t3UyBg7Zr9HRG8tzxmaPQi2PIDiZPUJ7bTswt63cLEP3NnR/wnWPBf6pjSjFNTKzachUsRVzF9mvhu+U16LyTzzpIF1GkA447/DtmAaVXbWjiTWPWmhlLueYPVG2Nuf9Dz3Or562NGHcFKxW3EZQ4zw/6/sz4pcRSLsRYbDDpfTnuUVONkHuXW7O4ujYXIg0AhUS+fNdUgpx9TvJ19c4s/HxEUmOuAIxy1VQL4lhNBom/9ZmHUCE3JdBXq2dxeK++/H2i8I/QJQRc6myPT9n5M2GnWQ5Ye3nEWo/hFrtnLham/IWgirMLR4Kv8Ll+ov6GFQmwywuY37gGOOqyT41dICSVOrryDoc7Mq5ahwobgQrRhc8AnC105Sp6aL2Y1W062YjakEe1cHI++nGE7SjlHn/7hATolY2hFGH/+BYzgnGb/Z8MRtHBtPzQN/ZO8c8orh4T8CLP9asr5RmDhjCvTaCkxNZTrSFKNyrxz54aWHWuHmuSeJV22MlMUc+IDbf+JeIADq01b+xqWNUPohDNyYic/QApR9pL73vXd2c6gb8a2c3+tkmKiaBRVDuyrlC3j+xRrnpkYfYckmz1bZLVOfSCofENRZnbuDkQdMS/+DCpdTYAqUyMpuuTVbYMtztqNKljqFCMocA81AKFKlj4YbN77Dicb45k/hcdVy+AyLYJ2WWtPnobCznUpb6Fq0ztwgAIvQ7k= 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; SFS:(4636009)(396003)(39850400004)(136003)(376002)(346002)(36840700001)(46966006)(966005)(47076005)(26005)(6506007)(33656002)(110136005)(2906002)(336012)(316002)(478600001)(9686003)(83380400001)(82310400003)(55016002)(36860700001)(8936002)(186003)(54906003)(7696005)(15650500001)(5660300002)(63350400001)(86362001)(81166007)(63370400001)(70586007)(8676002)(450100002)(4326008)(70206006)(82740400003)(52536014)(356005)(21314003); DIR:OUT; SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Jul 2021 18:48:02.9863 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 6d5ae605-5d70-4998-b914-08d94953684d 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-AuthSource: AM5EUR03FT009.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0802MB2586 Subject: Re: [dpdk-stable] [PATCH v1] doc: update atomic operation deprecation X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Sender: "stable" >=20 > Update the incorrect description about atomic operations with provided > wrappers in deprecation doc[1]. >=20 > [1]https://mails.dpdk.org/archives/dev/2021-July/213333.html >=20 > Fixes: 7518c5c4ae6a ("doc: announce adoption of C11 atomic operations > semantics") > Cc: stable@dpdk.org >=20 > Signed-off-by: Joyce Kong > Reviewed-by: Ruifeng Wang > --- > doc/guides/rel_notes/deprecation.rst | 16 ++++++++-------- > 1 file changed, 8 insertions(+), 8 deletions(-) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 9584d6bfd7..4142315842 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -19,16 +19,16 @@ Deprecation Notices >=20 > * rte_atomicNN_xxx: These APIs do not take memory order parameter. This > does > not allow for writing optimized code for all the CPU architectures sup= ported > - in DPDK. DPDK will adopt C11 atomic operations semantics and provide > wrappers > - using C11 atomic built-ins. These wrappers must be used for patches th= at > - need to be merged in 20.08 onwards. This change will not introduce any > - performance degradation. > + in DPDK. DPDK has adopted atomic operations semantics. GCC atomic > + built-ins must be used for patches that need to be merged in 20.08 > + onwards. This change will not introduce any performance degradation. Since there have been objections to the language used to refer to GCC C11 a= tomic built-ins, may be we add a reference to the GCC pages? DPDK has adopted the atomic operations from https://gcc.gnu.org/onlinedocs/= gcc/_005f_005fatomic-Builtins.html. These operations must be used for patch= es that need to be merged in 20.08 onwards. This change will not introduce= any performance degradation. >=20 > * rte_smp_*mb: These APIs provide full barrier functionality. However, m= any > - use cases do not require full barriers. To support such use cases, DPD= K 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.0= 8 > - onwards. This change will not introduce any performance degradation. > + use cases do not require full barriers. To support such use cases, > + DPDK has adopted atomic barrier semantics. GCC atomic built-ins and a > + new wrapper ``rte_atomic_thread_fence`` instead of > + ``__atomic_thread_fence`` must be used for patches that need to be > + merged in 20.08 onwards. This change will not introduce any performanc= e > degradation. Same here. To support such use cases, DPDK has adopted atomic operations from https:/= /gcc.gnu.org/onlinedocs/gcc/_005f_005fatomic-Builtins.html. A new wrapper = ``rte_atomic_thread_fence`` instead of ``__atomic_thread_fence`` must be u= sed for patches that need to be merged in 20.08 onwards. This change will = not introduce any performance degradation. >=20 > * lib: will fix extending some enum/define breaking the ABI. There are > multiple > samples in DPDK that enum/define terminated with a ``.*MAX.*`` value > which is > -- > 2.17.1