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 0566DA0540; Mon, 13 Jul 2020 17:54:49 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 38AE81D8E7; Mon, 13 Jul 2020 17:54:48 +0200 (CEST) Received: from EUR03-VE1-obe.outbound.protection.outlook.com (mail-eopbgr50084.outbound.protection.outlook.com [40.107.5.84]) by dpdk.org (Postfix) with ESMTP id 907BF1D8D8 for ; Mon, 13 Jul 2020 17:54:46 +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=6GtVPimxWwuZ0S/xUFXQ2j4KJX+Y0qbqE3e28kvoslE=; b=suBNBHUVIJ7iCuKqoOX3XG9G/yjQ/UGM6agY5oowUyLdKl7qxwojDszcbBDkPKa1f/Maf2bdvbm5uUGCSAYmD7pzafQK4dJa7wPwx4g0oVdxCOEU2x5VV5ieP9oGLeu/m3DI01m28A7FbHoxeruFq3Cix4DeDcRafS7czJfi9Qk= Received: from AM6PR04CA0038.eurprd04.prod.outlook.com (2603:10a6:20b:f0::15) by DB7PR08MB3849.eurprd08.prod.outlook.com (2603:10a6:10:79::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.22; Mon, 13 Jul 2020 15:54:45 +0000 Received: from AM5EUR03FT049.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:f0:cafe::de) by AM6PR04CA0038.outlook.office365.com (2603:10a6:20b:f0::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.20 via Frontend Transport; Mon, 13 Jul 2020 15:54:45 +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 AM5EUR03FT049.mail.protection.outlook.com (10.152.17.130) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.21 via Frontend Transport; Mon, 13 Jul 2020 15:54:45 +0000 Received: ("Tessian outbound 7de93d801f24:v62"); Mon, 13 Jul 2020 15:54:44 +0000 X-CR-MTA-TID: 64aa7808 Received: from 921608be272c.3 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 9FAF62B4-EA5B-481E-A776-E3268DEFBF5D.1; Mon, 13 Jul 2020 15:54:39 +0000 Received: from EUR04-HE1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 921608be272c.3 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Mon, 13 Jul 2020 15:54:39 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ND2TeFXHXrHXLEL6gfa8tKhlp3mdgf+fmb7hOyOvLZI3MLl6O5SvO760VB62Ma0AV0ouVwtZmuaVIE60mHzbkrIxlkhZP5vseVqaY6KhF5FCuHxOHXmy2KzcJC6VmPD9yEShLkp7VjTTEty9Ve+ZB/T4QPO6S4/mjhWBxRNeq/9LBGUdIJCwMS3QozUuiJDXvWN7v4s6yXOzm/8N+GFRB4iqFIrQk68Tw9yHWxQDJ0rZ741gmUGlVKyRcBBc5h1YjKGGxEWLiGcF24m6BItaFNNVOG1FohjcYYrXkZ5ue7vdT3DrUQLCl8AqR6BQi3p8Y9Xdof1iGwpRQGFXgeQmWw== 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=6GtVPimxWwuZ0S/xUFXQ2j4KJX+Y0qbqE3e28kvoslE=; b=TIjM0HivaYK8hf5QBlC6lm9u4ExQphmNrYZlDi1KchIcq1ylGFqEG1EBmM99QqFAS4azXWPmetpyeWOUxW6wZnOcrYKNZuPzdA66cL12w10ull/1m3hGbU9XV96faRNrE5HMfJUokrwqb9K+2iUZeVFpp1aNfQAUvtVehpV0vVzYZ+fHD3Nwj12bfSBzPOK945wlqN0iquThUlxzHDi4TC5RbQhoeEDK8oUYZaHLHgm3XpCZwd3obzy7ZaJfaF+7tx+hWGmLYNtjYH4DCGe8CLqGtT/wh/1/8LptpZW/WDgUAv7RFxO6pAhekyzF2IXHHzfZxgSvmF+6BKSQM/ZByg== 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=6GtVPimxWwuZ0S/xUFXQ2j4KJX+Y0qbqE3e28kvoslE=; b=suBNBHUVIJ7iCuKqoOX3XG9G/yjQ/UGM6agY5oowUyLdKl7qxwojDszcbBDkPKa1f/Maf2bdvbm5uUGCSAYmD7pzafQK4dJa7wPwx4g0oVdxCOEU2x5VV5ieP9oGLeu/m3DI01m28A7FbHoxeruFq3Cix4DeDcRafS7czJfi9Qk= Received: from VE1PR08MB4640.eurprd08.prod.outlook.com (2603:10a6:802:b2::11) by VI1PR08MB3229.eurprd08.prod.outlook.com (2603:10a6:803:47::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.20; Mon, 13 Jul 2020 15:54:37 +0000 Received: from VE1PR08MB4640.eurprd08.prod.outlook.com ([fe80::c2e:9ccb:a690:6863]) by VE1PR08MB4640.eurprd08.prod.outlook.com ([fe80::c2e:9ccb:a690:6863%6]) with mapi id 15.20.3174.025; Mon, 13 Jul 2020 15:54:37 +0000 From: Phil Yang To: Ruifeng Wang , "olivier.matz@6wind.com" , "dev@dpdk.org" CC: "stephen@networkplumber.org" , "david.marchand@redhat.com" , "drc@linux.vnet.ibm.com" , Honnappa Nagarahalli , nd , nd , "konstantin.ananyev@intel.com" , "jerinj@marvell.com" , nd Thread-Topic: [PATCH v4 2/2] doc: announce deprecation of refcnt atomic member Thread-Index: AQHWVmWl8IPUVT92r0uCwlwmOLncRakFpJMA Date: Mon, 13 Jul 2020 15:54:37 +0000 Message-ID: References: <1594289442-18594-1-git-send-email-phil.yang@arm.com> <1594310331-23345-1-git-send-email-phil.yang@arm.com> <1594310331-23345-2-git-send-email-phil.yang@arm.com> In-Reply-To: Accept-Language: zh-CN, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ts-tracking-id: 7826b2c8-f685-45b3-a76b-ba8c62d49076.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: [203.126.0.113] x-ms-publictraffictype: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 13b18015-528c-4371-9eb7-08d827451038 x-ms-traffictypediagnostic: VI1PR08MB3229:|DB7PR08MB3849: 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:7219;OLM:7219; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: 28SBo5RQuEtcgFJI4+vySp+gqZuN79VmyVrYsp6Bbwfnkx7pqQ/6QUkTxhQ83hIhG6yoUAaJ4oMfqHvRR4Dc+WY4n+0zBi511OM8h4xBRYF+eBLKW/20g0/siiMI+uhJd/St1kszvyrGZKiufTKQJY8BSBqxeOa0ZAdYotBwrMQTGl8nYPhaDOeAfrgHzAkCEHivK9Haeq/rle/7NNxiQSSYr3UnsowwqcKCX9/w2tIPkEtnCXV04Lyyb/DNcWA7f5tKClzd+R5cV8L7axxLM7rMdB+x776iwThECvGdxypdoR8LIriOjILw/Cos3+j6tXuj90rCEN38htl0v/TgyXcuce9Dbkd/DZe3kvAV3Ek1F3vXQoyNqPyU8sDSYePKYvdsZ7Qwbbkc3lgThmUg2Q== X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:VE1PR08MB4640.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(376002)(396003)(39860400002)(136003)(346002)(366004)(83380400001)(26005)(6506007)(8676002)(55016002)(966005)(9686003)(54906003)(110136005)(4326008)(86362001)(316002)(76116006)(66946007)(478600001)(7696005)(66476007)(66556008)(64756008)(66446008)(52536014)(5660300002)(8936002)(186003)(2906002)(71200400001)(33656002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: cAU3prtKKpOW8XdJWqXZGwdvxDhgPzZ6uRHr6zhnaQHwHYBkJq6qFy//M8k0JV9K/1R1kzj6clq5WeJ/vk5OykJ/LIDLP5KaXgV5pN37+kcI/qPRWndvDPOfuPtnOkZn+c7xsmFVkh/BUGuSsLWCU5A7tHu4URY7zNpcrbAa+5uBLEaGSK2DZpnpztKzcJQElGqmuXKAnPCZoHA0bdstZ1/V2j2FiulptRaBcpZNv7u9VkSf3Ro8+Z0cfxWwOH4wgN/hIJ35CKjeojYqehmW3bIgaEYFH87qascbn6fSixWOIdT0a7P0j3eQ6gpPcEYrh5PT3drw0YUuw9Zo4U2Ol4vXsNG7TKY0pE7XlNYRRcVTNChcXoCVC67ZyL6WEL/w63P2OOMU/YCDaHKh8kWzV/eFOIEylctPimuY9xafuuU2TTOhqVgsBv2HVCN85Nec1Br+gSCUds8ggPPYmSmFM8b0wWDhHvt3xm7jrUOtAdY= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR08MB3229 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: AM5EUR03FT049.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)(346002)(39860400002)(396003)(376002)(136003)(46966005)(70206006)(70586007)(316002)(110136005)(26005)(2906002)(55016002)(52536014)(6506007)(9686003)(186003)(36906005)(33656002)(336012)(82740400003)(8936002)(5660300002)(47076004)(356005)(4326008)(81166007)(86362001)(8676002)(54906003)(478600001)(83380400001)(7696005)(966005)(82310400002); DIR:OUT; SFP:1101; X-MS-Office365-Filtering-Correlation-Id-Prvs: 73ec2de5-cd31-4682-11e7-08d827450b91 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: QX9zmxd3JzWE1KJUrVs/luTFhKDrHSlaHXFGRT+qO0mggXSRnTzwicdlc1UN11tiZmbF6IHp7ZkTk9izF93Bfptty5+HTc7B3MheSPdkmO0DemNiVplUrq8yws7LIFq84WIaoC2iUoolFTPaUGCqEdGFU0ve3yc/sAksD+/4mQX3QpCVyxOTB4uJQ7PZIoaKtjSlFUvBKhUDgT0++NqB1lk/p56j2rYWL0jSyVdlolvInUFgzUVz1SekN9mKeqdak557krUWlsZlZRziXfoPkioJfytTVIn1qxADL1pD6Z/kDIsULlh7sFRKkBnzgNuzCNFcyFmhkeYaAlk4L6BzHDl04cu6zAaVjKtSxivXBOvgWJ4AUQB9oAbmbfdB+rBxFsfIx4Z88BuRVRIPkgon+7mF2+2hUUw+1szzUOKfn7HscFsQvcCNFWKD+ddgr0cdEgXodqKi7nt1nI2GJS3gYUY0xgSHmgAx3YQN8+9XwAY= X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Jul 2020 15:54:45.0758 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 13b18015-528c-4371-9eb7-08d827451038 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: AM5EUR03FT049.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR08MB3849 Subject: Re: [dpdk-dev] [PATCH v4 2/2] doc: announce deprecation of refcnt atomic member 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" Ruifeng Wang writes: > > Subject: [PATCH v4 2/2] doc: announce deprecation of refcnt atomic > member > > > > refcnt_atomic member in structures rte_mbuf and > > rte_mbuf_ext_shared_info will be deprecated in 20.11 release. > The plan should be deprecate it in 20.08 release and remove it in 20.11 > release. Yes. Just like Oliver suggested, we will deprecate it in 20.08 release and = remove it in 20.11. http://patchwork.dpdk.org/patch/73632/ Let's see if we have any other comments. +Jerin and Konstantin. Thanks, Phil >=20 > > > > Signed-off-by: Phil Yang > > --- > > doc/guides/rel_notes/deprecation.rst | 6 ++++++ > > 1 file changed, 6 insertions(+) > > > > diff --git a/doc/guides/rel_notes/deprecation.rst > > b/doc/guides/rel_notes/deprecation.rst > > index 74f8c34..7225570 100644 > > --- a/doc/guides/rel_notes/deprecation.rst > > +++ b/doc/guides/rel_notes/deprecation.rst > > @@ -123,6 +123,12 @@ Deprecation Notices > > in "rte_sched.h". These changes are aligned to improvements suggeste= d > in > > the > > RFC https://mails.dpdk.org/archives/dev/2018-November/120035.html. > > > > +* mbuf: ``refcnt_atomic`` member in structures ``rte_mbuf`` and > > + ``rte_mbuf_ext_shared_info`` is of type ``rte_atomic16_t``. Due to > > +adoption > > + of C11 atomic built-ins it will be of type ``uint16_t``. > > +``refcnt_atomic`` > > + will be removed in 20.11. It will be replaced with ``refcnt`` of typ= e > > + ``uint16_t``. > > + > > * metrics: The function ``rte_metrics_init`` will have a non-void retu= rn > > in order to notify errors instead of calling ``rte_exit``. > > > > -- > > 2.7.4