From patchwork Tue Oct 17 14:24:14 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shahaf Shuler X-Patchwork-Id: 30483 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 048791B6F1; Tue, 17 Oct 2017 16:24:55 +0200 (CEST) Received: from EUR02-VE1-obe.outbound.protection.outlook.com (mail-eopbgr20052.outbound.protection.outlook.com [40.107.2.52]) by dpdk.org (Postfix) with ESMTP id EDC6C1B3D5 for ; Tue, 17 Oct 2017 16:24:53 +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; bh=j7LMykE4jG9Y+J92jeZqmT+E/NFw3v1kdY8pUesvyPg=; b=bqxLoNaTrP+7zypEswj8K2g1pYGLWXY379KGGKk4WBiqj+NvjSoab0LguGnmsseVPnGnsLEpELk8q7log/w5ilHxvTfOQD9LfDn3SbPuqTWJoOG43QFw3acOtGawdBv/1jbbWXhd1bCbulEz7VruzaGAyeVkH2NI0zRzZqaSFes= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=shahafs@mellanox.com; Received: from mellanox.com (82.166.227.17) by AM4PR05MB3138.eurprd05.prod.outlook.com (2603:10a6:205:3::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.77.7; Tue, 17 Oct 2017 14:24:51 +0000 From: Shahaf Shuler To: nhorman@tuxdriver.com, thomas@monjalon.net Cc: dev@dpdk.org Date: Tue, 17 Oct 2017 17:24:14 +0300 Message-Id: <20171017142414.127705-1-shahafs@mellanox.com> X-Mailer: git-send-email 2.12.0 MIME-Version: 1.0 X-Originating-IP: [82.166.227.17] X-ClientProxiedBy: VI1PR08CA0130.eurprd08.prod.outlook.com (2603:10a6:800:d4::32) To AM4PR05MB3138.eurprd05.prod.outlook.com (2603:10a6:205:3::15) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: dc5607a0-c205-4b0f-62a2-08d5156ad4c9 X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(2017030254152)(48565401081)(2017052603199)(201703131423075)(201703031133081)(201702281549075); SRVR:AM4PR05MB3138; X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB3138; 3:JXzf9CfYjlY2TWtz44awcu+LWA6e43IXRFa4JGvYgReyiDsAfvZWj1+bkW9N2m31nbTbt1vH/ZVlriQuClZCfYy6mOAP3skl7Dy/0w+0qi83FLiQC48N5D0fzQlbPfZ8hCDj33vrWwmkeJG7ZshFubjiW1PDK7BseOdOpxFvlNTRt8Vk3fPM1BOWk+U3ru8P9G8BWINSrDuhQ120V9T7wyNSEUKJrTvX/8/j5ELd55BkW9vaEE5ksEP7ruKWe4XF; 25:MinEo19XkR/xSMCI7v7CHL1FsfRz4AR0pydMc7WgjrSnLqE77OdJcQ/U6BCxAuBnyyAxSWTO22Q9odA+oXzW0ys8+2y0sDZ/nOziIBjnqr/QVc7fcel7VBv/dVvP7HMm+koIWtNBz4A+WFTS1rzbYcUyS26wCIek+L/dbbf6xW0Faisq8gYj4+oQv8wVsDCZjjSWKjIW8gdBnctxW7ysLcHQREj1b3GLWh4IATwcdvEoT4gvKXZOC2MIo9e4s7pdfGO+ao5GJ2vERXV7zFj4eSZJ3BbNZrRiQjpnMYCdC8QTpaUTS5hJrz01fZTHe6G2P4YzSnc5T64aNsDPdYf1IQ==; 31:RY5YvN/uwtvzl3abJqAPMh24Srum2QZ3FFaVV4/Wf5dOZz/FZbetpLq6LKn+4HKHYLTQsI2p0swKU40kDXnZ5QVHW0zXt2xppkXwU9b0BC9TdbkJNO2Eqfx/UteWp7+e1t2rmi9pZ0g7AVcgS/qNeRlW2lq2Asd1IkOU9fSz5FWeNuXD0NcZz8BQfJKw7ymLOIaEXWonSCvqymyo7D+t2wkP+Ze38jMrD2+Gjqoz0F8= X-MS-TrafficTypeDiagnostic: AM4PR05MB3138: X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB3138; 20:tHzHRcvm1XS3xIsIk6X/MC5CL7w2XQGA82voF1vQJHmsdkAgEJzxrDkysRCkWqPYMeM0hjSnHBq9uuBam1sIdPgGrrIWTJSaWDcEJLFIdrkeeXUT29EcsDSxFnjvpYRuBMzxk7UnYmAxi4fGtKG3Y6ZQ+geIGkJnWqVnV7Kcy5Iu/BoG8jEdraAhOhIa5cmN/cBsSTueZ7ys0/y2hdSAJo6v9bagYyCkeFBLEQGXUoh4KKjcApkXFKChTYdC5t96LX4opbaP4nEJ0jd3h3MbzCD0rz6j0QtAaADqGcatV7TbG9Q7MSLWVqZJEO2kqIta4GiVFVaysM/X+TlDg/XyKAGSvn5VuvQtUnflaCuVw27AZHd6/EBqetcTLgZohR/Mheny89ik7ojgzbu+oJFQc11O+FZ239BqwXwQFJ699StdmaWkQ3QrddXhB5gMn4UegvbA97Er8CN4LETJUDGTSK3yDatBrIESeKUXR46cNX0fJ3wdLZLPXotaXOzJxLpt; 4:fo9h2EhAvwbHkm8quBy87jND+lBUXIGFziE3gn4KyXZYwCu3RQ2+7+11WK7CGcNjlv40dHflYTcb5DaGhmsWbkDEHDV6FjKf0nLkNESbcqWXUrkFJd4tcbUbOSV1UoCG9KMYuE11VJGQl49X5dbRMpSze2CZzlbF6j/xaMi5FyybBByJQdXyijgO05ET/vWtLYdwmqBaOiY70/SRY2fn3Pa2W7AytDxF/tXjbe3vjLG50hjMqAu4L/CajNTj8iUf X-Exchange-Antispam-Report-Test: UriScan:; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6040450)(2401047)(5005006)(8121501046)(10201501046)(3002001)(100000703101)(100105400095)(93006095)(93001095)(6055026)(6041248)(20161123555025)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(20161123562025)(20161123564025)(20161123560025)(6072148)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:AM4PR05MB3138; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:AM4PR05MB3138; X-Forefront-PRVS: 04631F8F77 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(6009001)(346002)(376002)(39860400002)(189002)(199003)(16526018)(4326008)(8676002)(6116002)(7736002)(1076002)(3846002)(105586002)(106356001)(8936002)(25786009)(36756003)(16586007)(55016002)(316002)(189998001)(86362001)(53936002)(48376002)(50226002)(69596002)(81156014)(5660300001)(50466002)(6666003)(81166006)(68736007)(2906002)(97736004)(101416001)(15650500001)(305945005)(21086003)(478600001)(5003940100001)(50986999)(33026002)(66066001)(33646002)(47776003); DIR:OUT; SFP:1101; SCL:1; SRVR:AM4PR05MB3138; H:mellanox.com; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: mellanox.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM4PR05MB3138; 23:BKWm01yKK6ULqfFEHrxe7WZHveDywlyYg0Y0eGQh9?= cgb0KBLdSF3UO0tgXUNiZdz5RdGsL+JyhIOe5c1quTnk2uUoetWxkrx0zMwpXaSzcf+c6lK292cRmSScrymX2HfzSRNHU5f0zcdRoYC2CRyMNLQsBnlYK7V2JWDJFp7L4nY1JLIYIf6uT2zDBnCOZDyJNFRG8NDGUQINJ9ugdxyXpZTYaPXteb4otuVYs5BWTrj9oZxHvFBpJr65FvszbqNg3HMO/fwYPXVcEXu4oeILcaqzcJ90ajQuwwQ62t40RHV8IG71SdyW+p8Y07NGFkt413nmXXU/9/wqa66b/pn3ihs1+xgiGMMhCVhFCzxmiK09ijNiLmHbGe4Ot1TSANjfqWPmGaiz4Q7O7kOsVyIGqDDKUxI6taFdvWTiuv/pehxOd3AP1PpSB3cC4f9TdkWnWrqwpDFE/O8vB8Syl+2nC9Cp06hHpKS0g1B6Ylm6udPJCie6m8kDKXV14cBZsRH9txO+I+G2+pWq1dO9IrwUuvdqUW/AS7Q4qDzrVZOMczMT1qA1jQiIuE+Ssf+bEAj8qInlIUdObWNlTgqC1bgBWwkdgp2Y0PcrxDleIUBJqbh7Xo95DLmNeq4mBX9qf9XX7hy4VbkKEGE6gOaa6Tsg1xk/5J29iuMAccTCtmfZFG/7XP3/2lwHTF94DMjOc3nDhMUxfOv7tS6H2XWwo6LPNdBHgIAERURl52xLx+u95pD+r3euDQU9jcBivxnWc611WHnc5No9GKXvZr8Jxjv4A3aGpSh4vCyI5jtGRYuNE0Za1whesZb7EMy0c4+su4sh8jvC4IDHIypDn1VbqavwHXKPmyHSHqU4anDTHqRMuzRGbBeWKr+Xp1ZT88TddskMFj/VtebMvjkBfGLqIBztYFb1vgZ5y5U4BCvAdzwSqgSj5b8gyGxbH2DsekNdYwmtMglWpR5OTf78L0HE8GXi32M7NanbZirJV85GEIOHKBQynqHvqcfJP4CMM3XO7jlDKDhfiF9AhXvJCLcNZ9gIuOvpFKxsFoLiQMscKH9RF5Lkbnj1me2zLH+LO2rEztXRncbFhCkBuj8xyN8WgQLkg== X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB3138; 6:hL6LetXycHxVT37Yl63gqK6GZbNXeGS6HP90tiWHK7l/EXJFpbFFmXP8+mefsg715Lo5DiomyvgSy1rVF38vFgGuPzkHE5Pf+1blknB0MkvF3QKKA4myOt7kjeyfsgpMJAGMr/QMOa7spEbcGrDwU3uNaKQDOlowGgYJFqIc2erwdyVL7c1i70fPAtjKB2eQQsZFbBKUKuz+czRSUwbff4newhTFkWOzZ/a622soqe8DRFONxW9b+I5h4Mbugigjas31INe3IKvlkti2keZOAYAfUh+QKTLQgmcr9mg1CVtygeDodUd7aGqrPHU3yoZy7d7oA5I3eyEUPcgOf85jZg==; 5:zIZSh9BYosoaiRYkXjEamqEsCMuYn9/jpycvNuS+YuucEHuSCNc4atH8uhLfyDhEn1VUJGE2/Cg8ONOZwCtueEpm3OD1KkIdLOxPnboEUmBaHoyjG9zU1JnrShyhZVAfK/ZQIwUUjCSeKvloz6aiww==; 24:/JdRyjonK60U6UIOj58me+BzNQ7Yb7GOVqLvas+LYN+kfr2aZfl4h8H9lIyUcKSutYSNYzY8iPkjaauuNXJBMjIbw5sWcZmNliIwowB1OKg=; 7:ylN+omg2VTXgDlFLVAMEmd/m3F+doC/bn/EIbFMNdCmWux0PEwMsm+qJWvBzsZ4zp8STkOdGTCRM/+tdzYC2APS6iX4zL/ofmwn6maJhDGdxvSvJkcjZqSdJq1h8Je6MTrfFa/8IDGomezFZiXN4+kBstDopgVN66kSaR9caM0sYYyWPBm/W7ia24nEDiMGsQH9edCOKkWse8uEt8LMgKbp3cdZ7D2z4Bz4+FyGAkns= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Oct 2017 14:24:51.7696 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM4PR05MB3138 Subject: [dpdk-dev] [PATCH] doc: update deprecation of ethdev offload API 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" Update deprecation notice for the new ethdev offloads API. Deprecation of the old offloads API is set to 18.05. Signed-off-by: Shahaf Shuler Acked-by: Andrew Rybchenko Acked-by: Konstantin Ananyev Acked-by: Thomas Monjalon --- doc/guides/rel_notes/deprecation.rst | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 52058f580..deb546a67 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -41,12 +41,14 @@ Deprecation Notices PKT_RX_QINQ_STRIPPED, that are better described. The old flags and their behavior will be kept until 17.08 and will be removed in 17.11. -* ethdev: Tx offloads will no longer be enabled by default in 17.11. - Instead, the ``rte_eth_txmode`` structure will be extended with - bit field to enable each Tx offload. - Besides of making the Rx/Tx configuration API more consistent for the - application, PMDs will be able to provide a better out of the box performance. - As part of the work, ``ETH_TXQ_FLAGS_NO*`` will be superseded as well. +* 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. + The old offloads API is target to be deprecated on 18.05. This includes: + + - removal of ``ETH_TXQ_FLAGS_NO*`` flags. + - removal of ``txq_flags`` field from ``rte_eth_txconf`` struct. + - removal of the offloads bit-field from ``rte_eth_rxmode`` struct. * ethdev: the legacy filter API, including ``rte_eth_dev_filter_supported()``, ``rte_eth_dev_filter_ctrl()`` as well