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 31C0BA0093; Fri, 22 May 2020 10:37:13 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 1CD381D928; Fri, 22 May 2020 10:37:12 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id E3A131D927 for ; Fri, 22 May 2020 10:37:09 +0200 (CEST) IronPort-SDR: tyy+cZI2ValF29PpSRiI5FMTly1/zgwayjs3IlKASsb7YEZfC3q19U+DeloGM/jLcXt92d8ggS jmjjmCYZhlIg== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 May 2020 01:37:09 -0700 IronPort-SDR: QgoRYg1Pv/YWAeIP9+onoBrWc4hcjTbKjiZmyCuay+kqrvFTWxeFoEG9tyUmj4GqbvXKnt+s2T 34IyyXMTwHxg== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.73,421,1583222400"; d="scan'208";a="254226908" Received: from fmsmsx105.amr.corp.intel.com ([10.18.124.203]) by fmsmga007.fm.intel.com with ESMTP; 22 May 2020 01:37:08 -0700 Received: from fmsmsx123.amr.corp.intel.com (10.18.125.38) by FMSMSX105.amr.corp.intel.com (10.18.124.203) with Microsoft SMTP Server (TLS) id 14.3.439.0; Fri, 22 May 2020 01:37:07 -0700 Received: from FMSEDG002.ED.cps.intel.com (10.1.192.134) by fmsmsx123.amr.corp.intel.com (10.18.125.38) with Microsoft SMTP Server (TLS) id 14.3.439.0; Fri, 22 May 2020 01:37:08 -0700 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (104.47.66.46) by edgegateway.intel.com (192.55.55.69) with Microsoft SMTP Server (TLS) id 14.3.439.0; Fri, 22 May 2020 01:37:07 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=RBkGMv0+bCWF8m0P+ltqQ899kPsyIwvUHBsH5Fd9CxrkewMfCeV39hQQkSiiyDXk/RtxNjgQ27hhweq501/ZXvmN6jVyzauv7HN4PqiuiRvdUQEZO/Nvoydq+/RCnFn0EdRXMHNE4XQOBRBwwkGXpTOqGpgKhXLtJAO+H5lCmbCS61SU/cpLHvr1EZmKHiUGorqirJqHpt1bHEaHkAsZZtHQIRpWT0X88KL0hz4l5++nMxFcW02TDS50f8oMWL/JmzUiUSdD5nK1DtWjHZMAt/LzysVNICKiDGDYwtjmNHT8GVm3+NZ7Cu37fVKEWG2a+qo2TrDqCcQawV9NIGCqpA== 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=Uh5M+tb4n/ZGpDlbDJfD3CxuZEo+b5mrvNXMflgw3Uk=; b=CIYQi3Fy4KAQl/WHb65nEggTg49HaW1t1P2b6ydUS+ABUhnIR4yeUI5+phMhOUOsQOC7dLLcCrE5yD79R6clD8R6IKvxfak3G3oJmrZjtxu2PIs6bf3xNE74qxCIm0mTJlALVcsfZz4RnoTtblN+SadWqqXDs7biaBodiGDXH8W1ZxkATYA45QVmSnyLTrlfm4O8BqlE6bfhPd/Um9X/YFIqL1kGgSDFS6DzBNY+Ix2pcb06j2Mur0dJfkLF80wmw+HMZp5PwV4IU0tyk2nRGepANzZoVbn27pnNfc+nYpNWmD45f3LgqKCaUnuIZGhvekoJADrgLbfLsU8EIRiI0g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Uh5M+tb4n/ZGpDlbDJfD3CxuZEo+b5mrvNXMflgw3Uk=; b=Pqq06XJIqqOGhLac/2M3ay+2uLM7PNAb6ByWXNRRcOi2OACVcj7YfUNgw1DXqVZn8ik8TvBABg2CC7r2xBDPcpi1xYz6fy6K2SkeCUoH85DcDMk7weUOdViePF6xamHx26muoxHtzhB3lFFCaUWZW29MgbHhaZvcnpN1Q6UObRk= Received: from BYAPR11MB3301.namprd11.prod.outlook.com (2603:10b6:a03:7f::26) by BYAPR11MB2535.namprd11.prod.outlook.com (2603:10b6:a02:be::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3021.23; Fri, 22 May 2020 08:37:05 +0000 Received: from BYAPR11MB3301.namprd11.prod.outlook.com ([fe80::f160:29ab:b8f9:4189]) by BYAPR11MB3301.namprd11.prod.outlook.com ([fe80::f160:29ab:b8f9:4189%6]) with mapi id 15.20.3021.026; Fri, 22 May 2020 08:37:05 +0000 From: "Ananyev, Konstantin" To: Honnappa Nagarahalli , "dev@dpdk.org" , "stephen@networkplumber.org" , "jerinj@marvell.com" , "hemant.agrawal@nxp.com" CC: "ruifeng.wang@arm.com" , "phil.yang@arm.com" , "nd@arm.com" Thread-Topic: [PATCH v2] doc: announce adoption of C11 atomic operations semantics Thread-Index: AQHWL/HJJne5ojU9SEyl1t6kkgDqFqizyDpA Date: Fri, 22 May 2020 08:37:05 +0000 Message-ID: References: <1588835193-27550-1-git-send-email-phil.yang@arm.com> <20200522043013.12535-1-honnappa.nagarahalli@arm.com> In-Reply-To: <20200522043013.12535-1-honnappa.nagarahalli@arm.com> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-reaction: no-action dlp-version: 11.2.0.6 authentication-results: arm.com; dkim=none (message not signed) header.d=none;arm.com; dmarc=none action=none header.from=intel.com; x-originating-ip: [192.198.151.190] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 42a89f61-a4db-4e5b-3638-08d7fe2b4f09 x-ms-traffictypediagnostic: BYAPR11MB2535: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:7219; x-forefront-prvs: 04111BAC64 x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: UJEypD5pSJBUHmRulGCC46ADua6hIJKuFxHZilzrNTr1LVUOH+SOUaeYTT+kCVrgAp9t6KFAOqGohJ2xv793L/PufutOZ9XkJHwyw1R2dvzckNU9B8zfixs0LVybjb9Jr3IhcXrAcjYDjMwLQ3/Cy8EAXNRTQBxGboBut7q5aPwR4LBfLCJuqwMXD0MKMtuyXf/VNi6V01wcg4hlQ2fCCEWO9OOE0eimQ7MsRV/E1GFUN0IIfzkGQLBnCFesPS/N4wphRB6+F2K0jwWIenWDHjz3txry5qut9XW670R/1HVUawRPn/sBALRzaZVy9h+WbxmprOvIMgXmfod1npsa8v76M/T4l8WOg6dvSTV7MERim8ctmiIHh/Y7tNR+jNjUfpgSr5JgTWdxhDjbYmziPQu88o7I34TMDEvbbHea/sX5aL5iQV0j696tf6VkXI6ry/dqokOWR/3nG0/hCz4hAQ== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BYAPR11MB3301.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(346002)(376002)(136003)(396003)(39860400002)(366004)(33656002)(110136005)(26005)(966005)(9686003)(7696005)(86362001)(76116006)(52536014)(6506007)(66446008)(186003)(71200400001)(2906002)(66556008)(66476007)(54906003)(66946007)(55016002)(64756008)(5660300002)(478600001)(316002)(8676002)(4326008)(8936002)(21314003); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata: A2HfqkJZQRI1rQPCEffewX5bBaY85H6TqdhAR2R1BNyEN7iJbrJ/3AWBbvDGpY2CFZQIesLlteUp7ouQXV4/431b0SsFeSyjRQqvtIvyB/WwrHE8Oi/2oweCYHGZ5y1GDyo3MOPZ6Q8oVOX8DvruL2JbrK7o4vtgbzW037k3KAPdHNXDsVAHQDc62JTzkKhr/i+WhiK2k+cZc507qntuTTLHt6Tsvp5i9DCO50T4WprAR6ugX9f6nyzMNtjl6ZlHgKZPzJYljUGwJIg5QmcmnJ6xdOg2k4+v9WDwOhNMQKzdrYTMn2KbeSs7V5SoZMNIOArgwbm7NG7t4C0U5KZVmKeT5PEu5N5mxuOKqz+VpV7HbEghQFA1XG3BPrM20LqH33CdU8QSPmLLcSEgA+YM0+uSl18rI2EZLdGtwW83FpwDc76yIGP6XzXi1ey01t81c8HHJwGcNI1Ij6jiCWXdlDBjZpwmhVS4U8M6zAGvr9/tlrRHp8Eu1qj0is3rFXRy x-ms-exchange-transport-forked: True Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: 42a89f61-a4db-4e5b-3638-08d7fe2b4f09 X-MS-Exchange-CrossTenant-originalarrivaltime: 22 May 2020 08:37:05.7738 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: tqFETwrshPc5YMqbbFCtVP4CuwI3k2skSXCdl3dYOZ0lRbDR45iv3Y4FOzFK+4PwE6xr5TPAEnkRhKpImwJOeiQlVePGhcCmkHIJttPpYAA= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR11MB2535 X-OriginatorOrg: intel.com Subject: Re: [dpdk-dev] [PATCH v2] 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" >=20 > As agreed in the DPDK tech board [1], after 20.05 release, patches must > use C11 atomic operations semantics with the help of wrappers. >=20 > [1] http://mails.dpdk.org/archives/dev/2020-April/165143.html >=20 > Signed-off-by: Honnappa Nagarahalli > Reviewed-by: Phil Yang > Reviewed-by: Ruifeng Wang > Acked-by: Hemant Agrawal > Acked-by: Jerin Jacob > --- > doc/guides/rel_notes/deprecation.rst | 13 +++++++++++++ > 1 file changed, 13 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/= deprecation.rst > index 20aa745b7..01f99a0d6 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -113,3 +113,16 @@ 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 sup= ported > + in DPDK. DPDK will adopt C11 atomic operations semantics and provide w= rappers > + 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. > + > +* 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. > -- Acked-by: Konstantin Ananyev > 2.17.1