From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR02-AM5-obe.outbound.protection.outlook.com (mail-eopbgr00074.outbound.protection.outlook.com [40.107.0.74]) by dpdk.org (Postfix) with ESMTP id C6C5B5911; Fri, 2 Nov 2018 12:23:22 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector1-arm-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=J9PYDfAfi3dkMZePsgaqZQsinp4rYdxiv+pslHo/X4A=; b=H8onEXFE4p0S0h1JW9Ya+IQ6HbugK56dFZRTWjwYLGBcBXSxWhORJi1Ryj1nicb/fsOCLqdj3HIQ2pyzadLJ+pdvXNjr6j1JJTcNWPg8T0KgqVz+ckV9JYozCNy/KoRPHhxao5J6Gajgm1dwF9GX1eMWlLjJ9E+7HZYFtIO1nQ0= Received: from VI1PR08MB3167.eurprd08.prod.outlook.com (52.133.15.142) by VI1PR08MB1166.eurprd08.prod.outlook.com (10.166.45.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1294.25; Fri, 2 Nov 2018 11:23:20 +0000 Received: from VI1PR08MB3167.eurprd08.prod.outlook.com ([fe80::d46a:1de3:53cd:3e49]) by VI1PR08MB3167.eurprd08.prod.outlook.com ([fe80::d46a:1de3:53cd:3e49%4]) with mapi id 15.20.1294.024; Fri, 2 Nov 2018 11:23:20 +0000 From: "Gavin Hu (Arm Technology China)" To: Thomas Monjalon , Honnappa Nagarahalli CC: Stephen Hemminger , "dev@dpdk.org" , "olivier.matz@6wind.com" , "chaozhu@linux.vnet.ibm.com" , "bruce.richardson@intel.com" , "konstantin.ananyev@intel.com" , "jerin.jacob@caviumnetworks.com" , "stable@dpdk.org" , nd Thread-Topic: [PATCH v4 2/2] ring: move the atomic load of head above the loop Thread-Index: AQHUccjZCIJwxa2i/k+ilpsv5CToGqU7LFmAgAB01bWAAEANEIAALnwwgAArzICAAB2GsA== Date: Fri, 2 Nov 2018 11:23:20 +0000 Message-ID: References: <1541066031-29125-1-git-send-email-gavin.hu@arm.com> <15443120.J8yKmjSJbt@xps> In-Reply-To: <15443120.J8yKmjSJbt@xps> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=Gavin.Hu@arm.com; x-originating-ip: [113.29.88.7] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; VI1PR08MB1166; 6:BshXgtDRPZH7v6wVf1Na7dQJKk6t7UTzbAyLWRq1Po0j/opJr3Z1MDeAbOGbS2m6ckl7t9f1Mm0GcorXF0ZGS4ilNrwvQsF26fnVb4C+PlvmtaAnD7cP3H5/3aFtgY8Fa/HGyof4rqYJQ3LPkD9t7aOwyD9EaX/KoGX5wDZc9GJKe3RyEid4eM1+DVjQx3FfwLlWPuDPKcFILH/X+MD6jelzhmKeisHamMC0ZSnPt4yt+GCnS2CEQ8pna9WabDDjp9X1HiIYtRdiIlMpAMTawiK1DmrnN190/h0Vv2KGC5or7mXLUKlCxLqPbwf532YdOVoy6MJJ6Z9RVwUT9/m4UsEyxogErrJcvdOGeSyHUsebeW34R+vjMG7EKjiuSBer2znMcjGw/XHt45CuVOThagYowLQEJtJ7C6d1VLgYGO0TXfHqpoISgbIOdk0gT8JmQN4+vjYm7oTDo+NjTHq+og==; 5:UxRe+S5jWo1y1s1HZeIQv335HZXcU9cRAcnitJPanFIs21wsnJSUoJWNBQLEAhMozvAtDdtCYOERNPoSSBTxbAvcrtdMqlphPAWgrf4FYrzqMYFXK1scclfdB9CqAs22Qa6NJ781pxjDdmztT537JB1qiG+Xn4eXcFnOpTfZW5M=; 7:+r+kzdDNn0IBakvqLq+g6clC+KWBAwcJ9Po0Xy5L7ksd21U811oosoyObH1IkEwAjC58LpHjcrpBAPxjamIMlpR9NodIi7YpfDKQE+uKWnj9thsdhM4jd94mljFkN8myWOY/YzkHrZcIJ2O6zwxkKA== x-ms-exchange-antispam-srfa-diagnostics: SOS;SOR; x-ms-office365-filtering-correlation-id: dd12e516-9d74-4c17-739d-08d640b59849 x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989299)(5600074)(711020)(4618075)(4534185)(7168020)(4627221)(201703031133081)(201702281549075)(8990200)(2017052603328)(7153060)(7193020); SRVR:VI1PR08MB1166; x-ms-traffictypediagnostic: VI1PR08MB1166: nodisclaimer: True x-microsoft-antispam-prvs: x-exchange-antispam-report-test: UriScan:(104084551191319)(228905959029699)(209352067349851)(180628864354917); x-ms-exchange-senderadcheck: 1 x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(3231382)(944501410)(52105095)(3002001)(10201501046)(93006095)(93001095)(6055026)(148016)(149066)(150057)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123560045)(20161123564045)(20161123558120)(201708071742011)(7699051)(76991095); SRVR:VI1PR08MB1166; BCL:0; PCL:0; RULEID:; SRVR:VI1PR08MB1166; x-forefront-prvs: 08444C7C87 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(396003)(346002)(39860400002)(366004)(136003)(376002)(13464003)(189003)(199004)(86362001)(478600001)(74316002)(7736002)(54906003)(53936002)(6306002)(6436002)(55016002)(305945005)(68736007)(11346002)(446003)(5660300001)(8676002)(55236004)(102836004)(53546011)(106356001)(26005)(316002)(105586002)(966005)(14454004)(110136005)(9686003)(6506007)(72206003)(6246003)(4326008)(33656002)(2906002)(99286004)(8936002)(6116002)(2900100001)(93886005)(81166006)(81156014)(3846002)(66066001)(71190400001)(71200400001)(476003)(186003)(486006)(76176011)(6636002)(97736004)(14444005)(256004)(229853002)(25786009)(7696005); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR08MB1166; H:VI1PR08MB3167.eurprd08.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; received-spf: None (protection.outlook.com: arm.com does not designate permitted sender hosts) x-microsoft-antispam-message-info: dCHUrvN7lnr9qSo9UY+UFh8Uz4K7ykj2KUYSdmEphukbaFj/BT3BEfAIak7Hmr/JDdhEgVr9Y4qZCbhFiE/Nfr/I23aKSiIQXv65mwHJyN46WWMp0L3sP9B2LC1YN95J0tVoZqyxlD3U7Zc5dMs6+/QzQtgeYG3ImJmmqHoa5yMKPy8WTu/FMzwH2d7+PP5ni852KLJHwux/C2rURLgLmq3gNZ2p+MoUtT2N+GvLk8ncNmL5qqWh/9u045bIcjAQZnFxRbbYeTGemh5tK8spIIdGVuwJYGBUTggJQxUAiT+kqx3l12Ex3jAHknON0ls9UzyxzLPBZnthN7oVRk8Nq86ZQKl8AkjcNbqaQKaRktI= spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-Network-Message-Id: dd12e516-9d74-4c17-739d-08d640b59849 X-MS-Exchange-CrossTenant-originalarrivaltime: 02 Nov 2018 11:23:20.5941 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB1166 Subject: Re: [dpdk-dev] [PATCH v4 2/2] ring: move the atomic load of head above the loop 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: , X-List-Received-Date: Fri, 02 Nov 2018 11:23:23 -0000 > -----Original Message----- > From: Thomas Monjalon > Sent: Friday, November 2, 2018 5:37 PM > To: Gavin Hu (Arm Technology China) ; Honnappa > Nagarahalli > Cc: Stephen Hemminger ; dev@dpdk.org; > olivier.matz@6wind.com; chaozhu@linux.vnet.ibm.com; > bruce.richardson@intel.com; konstantin.ananyev@intel.com; > jerin.jacob@caviumnetworks.com; stable@dpdk.org; nd > Subject: Re: [PATCH v4 2/2] ring: move the atomic load of head above the > loop >=20 > 02/11/2018 08:15, Gavin Hu (Arm Technology China): > > > > > -----Original Message----- > > > From: Honnappa Nagarahalli > > > Sent: Friday, November 2, 2018 12:31 PM > > > To: Gavin Hu (Arm Technology China) ; Stephen > > > Hemminger > > > Cc: dev@dpdk.org; thomas@monjalon.net; olivier.matz@6wind.com; > > > chaozhu@linux.vnet.ibm.com; bruce.richardson@intel.com; > > > konstantin.ananyev@intel.com; jerin.jacob@caviumnetworks.com; > > > stable@dpdk.org; nd > > > Subject: RE: [PATCH v4 2/2] ring: move the atomic load of head above > > > the loop > > > > > > > > > > > > > > > On Thu, 1 Nov 2018 17:53:51 +0800 > > > Gavin Hu wrote: > > > > > > > +* **Updated the ring library with C11 memory model.** > > > > + > > > > + Updated the ring library with C11 memory model including the > > > > + following > > > changes: > > > > + > > > > + * Synchronize the load and store of the tail > > > > + * Move the atomic load of head above the loop > > > > + > > > > > > Does this really need to be in the release notes? Is it a user > > > visible change or just an internal/optimization and fix. > > > > > > [Gavin] There is no api changes, but this is a significant change as > > > ring is fundamental and widely used, it decreases latency by 25% in > > > our tests, it may do even better for cases with more contending > > > producers/consumers or deeper depth of rings. > > > > > > [Honnappa] I agree with Stephen. Release notes should be written > > > from DPDK user perspective. In the rte_ring case, the user has the > > > option of choosing between c11 and non-c11 algorithms. Performance > > > would be one of the criteria to choose between these 2 algorithms. > > > IMO, it probably makes sense to indicate that the performance of c11 > > > based algorithm has been improved. However, I do not know what DPDK > > > has followed historically regarding performance optimizations. I > > > would prefer to follow whatever has been followed so far. > > > I do not think that we need to document the details of the internal > > > changes since it does not help the user make a decision. > > > > I read through the online guidelines for release notes, besides API and= new > features, resolved issues which are significant and not newly introduced = in > this release cycle, should also be included. > > In this case, the resolved issue existed for long time, across multiple > release cycles and ring is a core lib, so it should be a candidate for re= lease > notes. > > > > https://doc.dpdk.org/guides-18.08/contributing/patches.html > > section 5.5 says: > > Important changes will require an addition to the release notes in > doc/guides/rel_notes/. > > See the Release Notes section of the Documentation Guidelines for detai= ls. > > https://doc.dpdk.org/guides-18.08/contributing/documentation.html#doc- > > guidelines "Developers should include updates to the Release Notes > > with patch sets that relate to any of the following sections: > > New Features > > Resolved Issues (see below) > > Known Issues > > API Changes > > ABI Changes > > Shared Library Versions > > Resolved Issues should only include issues from previous releases that > have been resolved in the current release. Issues that are introduced and > then fixed within a release cycle do not have to be included here." > > > > Suggested order in release notes items: > > * Core libs (EAL, mempool, ring, mbuf, buses) > > * Device abstraction libs and PMDs >=20 > I agree with Honnappa. > You don't need to give details, but can explain that performance of > C11 version is improved. >=20 V5 was submitted to indicate the improvement by the change, without giving = more technical details, please have a review, thanks!