From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR01-DB5-obe.outbound.protection.outlook.com (mail-db5eur01on0045.outbound.protection.outlook.com [104.47.2.45]) by dpdk.org (Postfix) with ESMTP id 12D882C56 for ; Sun, 27 May 2018 06:36:51 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=IHioO9dyyMtKGWD5l/Q4b/slvxsqiafViqiGT2JeL+s=; b=JrFy7fFdN2HX+ZFA7LEd2ytaGhN3iygpjtktptcs5BuiZ0OcCRBjC8k8MKp6715u0ynwm8b512eC+z2mEt7UniAtEujHz535y0p3rsqsKfiLiqWF7UZnkxdscFlNzf40OmAdiZ/MIneB4qpWTB/6+eUrsxX5REyMDupcaaLAV9A= Received: from DB7PR05MB4426.eurprd05.prod.outlook.com (52.134.109.15) by DB7PR05MB5017.eurprd05.prod.outlook.com (20.176.236.161) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.797.11; Sun, 27 May 2018 04:36:41 +0000 Received: from DB7PR05MB4426.eurprd05.prod.outlook.com ([fe80::e57e:5e77:595f:d4f7]) by DB7PR05MB4426.eurprd05.prod.outlook.com ([fe80::e57e:5e77:595f:d4f7%13]) with mapi id 15.20.0797.011; Sun, 27 May 2018 04:36:41 +0000 From: Shahaf Shuler To: Yongseok Koh , "olivier.matz@6wind.com" , Thomas Monjalon CC: "dev@dpdk.org" , "arybchenko@solarflare.com" , "konstantin.ananyev@intel.com" , "stephen@networkplumber.org" , Yongseok Koh Thread-Topic: [dpdk-dev] [PATCH v2] doc: announce removal of indirect mbuf check macro Thread-Index: AQHT88aWGHoTP+w8tEqk5mhFh65yQqRDAPFw Date: Sun, 27 May 2018 04:36:41 +0000 Message-ID: References: <20180525005338.28773-1-yskoh@mellanox.com> <20180525012006.29856-1-yskoh@mellanox.com> In-Reply-To: <20180525012006.29856-1-yskoh@mellanox.com> 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=shahafs@mellanox.com; x-originating-ip: [31.154.10.105] x-ms-publictraffictype: Email x-microsoft-exchange-diagnostics: 1; DB7PR05MB5017; 7:95+PIt0z7hv1n8FQZgEJbBQPxpgzkXnEFmzT74BBP75SfrttXuP1hkQ76Sojw7IIPM2ATz4nIG2DV3IzJrJWIfChMGIkJ1/I1tA4QKEfjGLQasZnnxPy4bDR79AhmPrbF3kOdfT9Mpq0DqULUrkQkVK51zXCZKkLq0H2Z7ygzEstBHoz6MLU5vSggWNzWhSuMupjAf5icao6i0kz/RzLLs3MXDMqRBOQLpIhRPmikTMiBbuqKVP+wRPxI+2wVmI0 x-ms-exchange-antispam-srfa-diagnostics: SOS; x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(48565401081)(2017052603328)(7153060)(7193020); SRVR:DB7PR05MB5017; x-ms-traffictypediagnostic: DB7PR05MB5017: x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr x-microsoft-antispam-prvs: x-exchange-antispam-report-test: UriScan:(189930954265078)(45079756050767); x-ms-exchange-senderadcheck: 1 x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(93006095)(93001095)(3231254)(944501410)(52105095)(3002001)(10201501046)(6055026)(149027)(150027)(6041310)(20161123560045)(20161123562045)(20161123564045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(6072148)(201708071742011)(7699016); SRVR:DB7PR05MB5017; BCL:0; PCL:0; RULEID:; SRVR:DB7PR05MB5017; x-forefront-prvs: 0685122203 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(39860400002)(346002)(376002)(39380400002)(366004)(396003)(189003)(199004)(446003)(76176011)(486006)(14454004)(476003)(6506007)(105586002)(102836004)(45080400002)(5660300001)(11346002)(26005)(6116002)(7696005)(3846002)(97736004)(59450400001)(86362001)(316002)(99286004)(3660700001)(2906002)(8936002)(3280700002)(2900100001)(110136005)(229853002)(54906003)(66066001)(68736007)(33656002)(966005)(6436002)(53936002)(5890100001)(2501003)(478600001)(6246003)(4326008)(107886003)(74316002)(25786009)(106356001)(305945005)(55016002)(9686003)(81166006)(6306002)(81156014)(7736002)(5250100002); DIR:OUT; SFP:1101; SCL:1; SRVR:DB7PR05MB5017; H:DB7PR05MB4426.eurprd05.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; received-spf: None (protection.outlook.com: mellanox.com does not designate permitted sender hosts) x-microsoft-antispam-message-info: zsTfiIAAdjK+O/TBlhvFpeTa9VDJItrrF+K5HLT+jYxFkaudCYoDUvM0/zr3Pyh6VXo2SYopTvldvdnW//VcQQx6hoLdAjuaIxmOM6E/QXl17NXzjcVyZjtxfsGw+c8qNtk+b7W0laUaEVbSB9GOCukDqYRxYBqBfqdMAvBejWoKK/vVMfEvefO2QjYrBTBy spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Office365-Filtering-Correlation-Id: 3ccc1519-2a0b-43c0-3460-08d5c38b71c8 X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3ccc1519-2a0b-43c0-3460-08d5c38b71c8 X-MS-Exchange-CrossTenant-originalarrivaltime: 27 May 2018 04:36:41.8359 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR05MB5017 Subject: Re: [dpdk-dev] [PATCH v2] doc: announce removal of indirect mbuf check macro 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: Sun, 27 May 2018 04:36:53 -0000 Friday, May 25, 2018 4:20 AM, Yongseok Koh: > Subject: [dpdk-dev] [PATCH v2] doc: announce removal of indirect mbuf > check macro >=20 > Link: > https://emea01.safelinks.protection.outlook.com/?url=3Dhttp%3A%2F%2Fdpd > k.org%2Fml%2Farchives%2Fdev%2F2018- > April%2F099476.html&data=3D02%7C01%7Cshahafs%40mellanox.com%7Ccaccc > ead653640735e3308d5c1ddb6b0%7Ca652971c7d2e4d9ba6a4d149256f461b%7 > C0%7C0%7C636628080378790994&sdata=3D7JOFTPtuU4OYWowtwEKp3BaK5aS > 8idulFiGhLEHRIkU%3D&reserved=3D0 >=20 > Signed-off-by: Yongseok Koh > --- >=20 > v2: > * modify removal deadline and add more comments in the deprecation note > * mark deprecation on the comment of the macro in rte_mbuf.h >=20 > doc/guides/rel_notes/deprecation.rst | 7 +++++++ > lib/librte_mbuf/rte_mbuf.h | 3 ++- > 2 files changed, 9 insertions(+), 1 deletion(-) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 1e2443c76..e1630c2cf 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -42,6 +42,13 @@ Deprecation Notices > is defined in librte_sched in a non-generic way. The new generic forma= t > will contain: queue ID, traffic class, color. Field size will not chan= ge. >=20 > +* mbuf: the macro ``RTE_MBUF_INDIRECT()`` will be removed in v18.08 or > +later and > + replaced with ``RTE_MBUF_CLONED()`` which is already added in v18.05. > +As > + ``EXT_ATTACHED_MBUF`` is newly introduced in v18.05, > +``RTE_MBUF_INDIRECT()`` > + can no longer be mutually exclusive with ``RTE_MBUF_DIRECT()`` if the > +new > + experimental API ``rte_pktmbuf_attach_extbuf()`` is used. Removal of > +the macro > + is to fix this semantic inconsistency. > + > * ethdev: a new Tx and Rx offload API was introduced on 17.11. > In the new API, offloads are divided into per-port and per-queue offlo= ads. > Offloads are disabled by default and enabled per application request. > diff --git a/lib/librte_mbuf/rte_mbuf.h b/lib/librte_mbuf/rte_mbuf.h inde= x > e136d12b7..8e6b4d292 100644 > --- a/lib/librte_mbuf/rte_mbuf.h > +++ b/lib/librte_mbuf/rte_mbuf.h > @@ -738,7 +738,8 @@ rte_mbuf_to_baddr(struct rte_mbuf *md) > #define RTE_MBUF_CLONED(mb) ((mb)->ol_flags & > IND_ATTACHED_MBUF) >=20 > /** > - * Returns TRUE if given mbuf is indirect, or FALSE otherwise. > + * Deprecated. > + * Use RTE_MBUF_CLONED(). > */ > #define RTE_MBUF_INDIRECT(mb) RTE_MBUF_CLONED(mb) Acked-by: Shahaf Shuler >=20 > -- > 2.11.0