From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR03-VE1-obe.outbound.protection.outlook.com (mail-eopbgr50062.outbound.protection.outlook.com [40.107.5.62]) by dpdk.org (Postfix) with ESMTP id 255E71DA4 for ; Fri, 25 May 2018 03:20:30 +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=vD+G1NYzCmQdGeZRBsT1kSRPEbtl7u5tRWIjQO5wmIg=; b=x5Q/iC8f5nWnVBdmnS1do3hQ1pXMlV5GqEx+xm4SdoEbONAKf5QcnqYkpFGUq6wKi0M8v4SI6m/kgpxCEUq0aASgK9cM08VRzV+wOJdXdUXWkpFsyR6EG1pJR1pxVp8d7lyfJEo4jIT8KYWHM0E0z0di1lzsxNtTBlqKdcNu2/A= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=yskoh@mellanox.com; Received: from mellanox.com (209.116.155.178) by HE1PR0501MB2043.eurprd05.prod.outlook.com (2603:10a6:3:35::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.776.11; Fri, 25 May 2018 01:20:25 +0000 From: Yongseok Koh To: olivier.matz@6wind.com, thomas@monjalon.net Cc: dev@dpdk.org, arybchenko@solarflare.com, konstantin.ananyev@intel.com, stephen@networkplumber.org, Yongseok Koh Date: Thu, 24 May 2018 18:20:06 -0700 Message-Id: <20180525012006.29856-1-yskoh@mellanox.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20180525005338.28773-1-yskoh@mellanox.com> References: <20180525005338.28773-1-yskoh@mellanox.com> MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [209.116.155.178] X-ClientProxiedBy: CO2PR04CA0143.namprd04.prod.outlook.com (2603:10b6:104::21) To HE1PR0501MB2043.eurprd05.prod.outlook.com (2603:10a6:3:35::21) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(48565401081)(4534165)(4627221)(201703031133081)(201702281549075)(2017052603328)(7153060)(7193020); SRVR:HE1PR0501MB2043; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2043; 3:ZCvENcFUGDUdgrtSa1Gz++/hBoDmcefU0eRYPPUK3DSMArCJb1Dy6uaI+wnxFONtR6vwOSCbRR1x+wDKD5MgVeQxJkr1FFrO5+ZppBmQOcFpTInpbyf9CQPJRQzA5C9amXwmyyq2FtHURi8vxSzOXJtLuU5KjzdlKLUAm+8pL/vIwLj4hwVT682ut0voolfkKpbMwwwjVZmYSHOyYmTkHmPn9KQGXfjMH86y71RVhBMW+s0aVTA1ipm9WaR7ykBZ; 25:xLIX04VnSnTdT0U6kNM3E+HFbu4CoiY2mAAZ3J2a3wq9C2dSLVIoEDZvdFE1wzBhuWjVjz369DZsuk2VNbOkmh41/wZsEtax8QAu4IGGsrRNx2qXgBD5oBVs0ogn9EkF6dcqYy2mLHFvQL820OH/RBakHRg50qAKCrjzmrLoD3OFUzdwq0dwqChs3wQqHcknwoyk+G/6MR8uI8zup2/xz25fQqv9s7aFhf8USmA48o5Iyp4tbDO4SfFyS1anmXL79oxVkQ0h0GBdoKnUpT0gkm4hPajYsa4CmT7gZZQ+sb4m7k5qh7W+WtnLDz5BXRBNmFwP2CRdhVXFoFpOZvZ/XQ==; 31:2EYbPxiTnO17y6/WaOE1Wz1d8ARn63Y3EYFpNQCnj2WYOdWK95jfi7O+kmi1fhqBvyjjM1Zo1BQJH/+64dAZtYQTu2RhAXJu8q0/jMHeTmk55JGeXKb3IQ/2UMLl2HYtpIEmL7JM1rzlZiok68jBHrMSCTUuIXzUMX6e5RkVFAIK8ol5Xbu3XijcK5FnNiNuktR3kJGdblI6SflZPvKPnmtmfDP/UM/giGeKXfYbmpI= X-MS-TrafficTypeDiagnostic: HE1PR0501MB2043: X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2043; 20:iE3creRgrlmyTF6WfwvyOsq3gk3XsUSM8WFuPrNIoddsQ5MZkYh9VijjAbxv28atM4LATq4BaZkSm/gi1liRFbHDihucsOtN1bKExZ8BHrV2y64hXJ+Li4Jxj2t+UNwMYzXFQkIbljmlrRV6pCdta1Bl+W24Bx8d0eWEOROK3G/q82vT6gZPQzR+S/+njEwj6SGP1WNJZuKHzoehh6ZxF7YJLmlkEoH5fGAH3PI2H7fnM4j32zsAiYxIKXtCppCIOBLY5KTVIKBKKYtMl24Es/4DaBnSrQgPMmJbjfIIii3ZVsRW49OxVfUl+kd4GrorbDTwvrtnt/2BznjOP8d02VBq85v/f1QAa0Gbt5O7/pKfmMnpvBh/I/f0AebMSjs+aE9d5SJe9gdoPOXEVjCBq0zQI5f7uURMOp8Ftwa0KcqnZPUm7ax37Mn1FnOe1JfxN6/3cZZCSwbtGNzAiCKr6bT8+QxkTsEXI8AgWGPy57AuU4QRw3CTA55pbOnktD4s; 4:TpKH6O1NFt7+rc43IxcRR9OuBOiMmUfH60LfugTQXbYO6VXfEJY2S7NRZjqvLu4k6cIZcR1oIB7zLku38WRnnBfJKdQjahy3amrWtTwFLJHjAgsOUWpBXiM0WDtFkadgKfddgKUKINu426W4phtDFXNA1AM0O4aIbOm3IHE48kgr+pOvPLTDC1gfJmCqJXmDotHHpzGFr0Ry3Xy3OeXt4LjdF7+V3I6IimBOBCoESeA8KATDuO1ASTtARyMvZDl2ZhIARQLA0cYYsEV/+E5Upw== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(8121501046)(5005006)(93006095)(93001095)(3002001)(10201501046)(3231254)(944501410)(52105095)(6055026)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123562045)(20161123560045)(20161123564045)(6072148)(201708071742011)(7699016); SRVR:HE1PR0501MB2043; BCL:0; PCL:0; RULEID:; SRVR:HE1PR0501MB2043; X-Forefront-PRVS: 06833C6A67 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(366004)(396003)(39380400002)(346002)(376002)(39860400002)(189003)(199004)(476003)(16526019)(53376002)(7736002)(1076002)(47776003)(4326008)(50466002)(59450400001)(5660300001)(55016002)(66066001)(86362001)(106356001)(186003)(305945005)(105586002)(6306002)(107886003)(7696005)(81166006)(2906002)(53936002)(52116002)(81156014)(15188555005)(48376002)(50226002)(446003)(8936002)(486006)(3846002)(6666003)(386003)(6116002)(76176011)(2616005)(26005)(11346002)(956004)(51416003)(97736004)(5890100001)(21086003)(478600001)(966005)(25786009)(69596002)(8676002)(68736007)(16586007)(36756003)(316002); DIR:OUT; SFP:1101; SCL:1; SRVR:HE1PR0501MB2043; H:mellanox.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-Exchange-Diagnostics: =?us-ascii?Q?1; HE1PR0501MB2043; 23:4KAAb2JRGRZNaH1HlmPs4b9yQAC/GQanAejsvl1?= =?us-ascii?Q?zm3b3jYdZClvbFXv2/XyjjnKi0W9rNtB4oVTAGKw0XAGbwcyF469VttInHGC?= =?us-ascii?Q?4dakWetFLfi5TwpGAaOMgKOgZ6vr3taOP+6gSWH4kA8maXKRBiaQRgPOZBQ+?= =?us-ascii?Q?ajJW6ROS8y/wWmAK1IOWbcGvaUCIXr0RqJlCKI2r8kBxekgfcnTCLkQv9bXB?= =?us-ascii?Q?s41KmKuZyVKizR9n0ZsrV95emLXm4MJm7/5wl4Oj+itP9zTweMhRzugIKg4C?= =?us-ascii?Q?5G1XVukkFCQgSwht9Qm0NtqUASe9xfEWfTRDKGcl5pV9bCnHk+ZwKR4dD45D?= =?us-ascii?Q?lYN6+vuSYjcJmSY5YilECUI7j9x8GzFK7/9yOhNc9wONb6nVXRAmolfy8Ohp?= =?us-ascii?Q?oIVq2cPwg2FrTRmkrEyX7JovdlN0bzwR7o+m1wgyXOqxZMRxR6/BLSFzcG57?= =?us-ascii?Q?uaZgPWS9QA4NlJbu5m1kdAF08WvWEXC6tsiQTYrJXrXR6qV6Ux0Yf6TS3jXB?= =?us-ascii?Q?QNO5iAmCarEP03VEiOiWsgku4XhqMX6iojr9FZ4y1HsFy7MvGklI96TByEPu?= =?us-ascii?Q?SPUuYkuz6Q/ZAU+NrmvnSnHpGIuHyI/0C0prQadewK4YaZKAK8dXuKmE45tb?= =?us-ascii?Q?aE57PmKCJ7fgryXsrO6Hh2hiJcbwQG7Mtjd22QuIqm3UKEKDWESx7rvv1e9y?= =?us-ascii?Q?gZjgUDSBQwsgMUBRp8a7jlkoGLiY85ToYQw+Up9MPZwg7pdV1fkOXV4CghQ3?= =?us-ascii?Q?VkhuZxZ61AbEPvYBVwdBWXJl9GeMwDh/DhG1TDZ1kBcuTHDLOdt7FzFti0Zv?= =?us-ascii?Q?JUAG7Ea8PYXlY5fyekvikw1n2frVwGKl6BLT/8cZnFTbAEFitRo/IDngif6w?= =?us-ascii?Q?cnYQPtSAtPpRF3O3pL+ID5FLsdig40x+1R2VOs2OhcKF1HnEa+6+Op44b0Hp?= =?us-ascii?Q?H3+O0IF6GwT40bRg1rdByP5rzRU3LlfC3GM7yawUHHCsPhUI1He/nPZUb6Ok?= =?us-ascii?Q?5BX1LWYXJRhU5G8inXFJIuiRNTR7fPjB5txP4nDpmMVVROeLMSpOx7xmav9n?= =?us-ascii?Q?pzOL8Se1vt358aYNoJ6/yqqC3EbRqDbO9Qu81SWKKDZk4KFLvBfrNebvceUj?= =?us-ascii?Q?gWjolQUstIkh5dXf+Q2Ac5WQlSbjRsb0HZ3cn6Ptyx4pYmiY01iIuUUF7p/1?= =?us-ascii?Q?QDO8lee0TA9OwYrh2TDTecc8Xm2lWopTjG41+oW/ybd/zIHuoeW3Ssdk9xnp?= =?us-ascii?Q?EG5a108Baka8Y+HoMfVcTdODkwca2+NlPyvMqnTfrmF8zQ7KkVAUvEf7b8Ho?= =?us-ascii?Q?LZsdNq67yrHAXlnpf5hk99itR7ByjGR2Ixv94YSSSHJL1UNwg8z15W1INPxI?= =?us-ascii?Q?zeJQoIQ=3D=3D?= X-Microsoft-Antispam-Message-Info: dDxHX0tZl6xBGfzHy+e00b3XVOYL/XU7QqqycXuRPdlP5RezGcQ2QcuJYqJAtJ2WvuPqKzfCKjCFiTZThdvXvA0yYZHETzrKQjW16jdMbe8LAuUAJ0S3mWulTcIKVu6sWdNIth3NgRtWgarkhmbti9T0G15IW+DXm0Le38CkrhWCRlHMw8nh/6rysrVKeC0a X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2043; 6:0jqIMlb4W9boJX1YVs6CDWdzPSKrcD32uCGdCvuJgfLY5KYXWmjLvtnliEAyizXmm59jq68rOOZBdMU/+vZbx2kqOTvAbogFOYi5HA8xz2a1joorUgptDx5mMNk12Drb10HGp77RYO8F4zI3D5+Qh++BkZry1n3SnVs3NF6jdr5Zm/VLuv6ZyojkhWSGbZ91I0Jsg8ZNCFjLUYiID1/oqu/34sgNQWmnxNynbZ0pX6o/pKdxSTJX+zSI3fwoAo/2Tz/SkUsj/bNVltclj2wWx2v+eP68YfPMCuRkuDZhc4uW6VFMQ4l84HUdBeEuY1gqLfAuR9UNw2WS8lJJA1FbXogMH33bInQy+XFkTskTB25CDQM8L9kL1o4n9vAcG63jseHo+PDmzf2gdw6irQo+CBmMpYjYX5ae0peMkkPMpTzJj9dDqd9c/tNYKJTvge3W02yUtvJqQG4T21koQoH+mw==; 5:MhH8dyr2f911sHAFy2gSS9tykat3/9HF9zzgjiPVnAetVIBaVMWiN7paGXi0BJuvKT/7Ve/xKTS4FuozEA+1ZPxuQgfsZAnO+Tsq4CUmeWci3LoqmAiH22LVwCk5ghHsTfDwBynsJdgeWL8Ylq+fn/sAGpDZ41tcEqg9yjRakhs=; 24:lpaNtRKR5vQJn+Lrvm9SEOSgjAk0HFGQDKQE4gligc5dvY4IkDybq1q5qRp6pOMz4aKsGnXdculmFyNvfJ5mZAycti73jHPCpyp6QjoPV5E= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2043; 7:TjfPns7PFcrYSfzh3Zk5HChGb/Im6cZ9Rw+DR6EkmqKHrS+S9rguXnHokfxKo1C9pJJcgwf4s009Lf4mSjdzJgELjy67jJK8vQjoXSvL4TO1IUGYkMWxLdqYJxyKl+rnX99IvEMAIuK091/kbhfGf5ctCBJJ6faW+7jAO+7vyF03u8hjjzJASwPQYxhLpwCuRuA68xxWQtlzuWwG9vl+E5aXRtTBS1/KaPk3WE6mTEj5M7y5GydSE/Dj14ASLzfG X-MS-Office365-Filtering-Correlation-Id: 0e53ebbd-8a20-4561-1f53-08d5c1ddb2b6 X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 25 May 2018 01:20:25.5036 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0e53ebbd-8a20-4561-1f53-08d5c1ddb2b6 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0501MB2043 Subject: [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: Fri, 25 May 2018 01:20:30 -0000 Link: http://dpdk.org/ml/archives/dev/2018-April/099476.html Signed-off-by: Yongseok Koh --- v2: * modify removal deadline and add more comments in the deprecation note * mark deprecation on the comment of the macro in rte_mbuf.h doc/guides/rel_notes/deprecation.rst | 7 +++++++ lib/librte_mbuf/rte_mbuf.h | 3 ++- 2 files changed, 9 insertions(+), 1 deletion(-) 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 format will contain: queue ID, traffic class, color. Field size will not change. +* 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 offloads. 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 index 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) /** - * Returns TRUE if given mbuf is indirect, or FALSE otherwise. + * Deprecated. + * Use RTE_MBUF_CLONED(). */ #define RTE_MBUF_INDIRECT(mb) RTE_MBUF_CLONED(mb) -- 2.11.0