From patchwork Mon May 1 06:58:12 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shahaf Shuler X-Patchwork-Id: 24026 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 [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id E06B5374F; Mon, 1 May 2017 08:58:19 +0200 (CEST) Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-ve1eur01on0081.outbound.protection.outlook.com [104.47.1.81]) by dpdk.org (Postfix) with ESMTP id 5A5FE234 for ; Mon, 1 May 2017 08:58:18 +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=erRhzfOJBEQ5TUYPwUsaLSDKvgEvd5n6iceOkQLrr9M=; b=atSqmJDXZFdkxEsqYDsB5zdJTX0hf1wXN9rANaXV6Pj1MKGXUF3oTM1Gf4mlJ0hm8xvncbltQ4OKdLeELlthknaBboG6KOpO4Pzv5+W7Ozd5kknf5pxPBrIzqwFQMcJpIrQvq6DvqYnXZcesNZW7aaAVW/btDHbgYUQyQAkajHk= Authentication-Results: dpdk.org; dkim=none (message not signed) header.d=none; dpdk.org; dmarc=none action=none header.from=mellanox.com; Received: from mellanox.com (82.166.227.17) by AM4PR05MB1505.eurprd05.prod.outlook.com (2a01:111:e400:59e7::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1061.12; Mon, 1 May 2017 06:58:16 +0000 From: Shahaf Shuler To: Date: Mon, 1 May 2017 09:58:12 +0300 Message-ID: <20170501065812.5185-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: DB6PR0802CA0041.eurprd08.prod.outlook.com (2603:10a6:4:a3::27) To AM4PR05MB1505.eurprd05.prod.outlook.com (2a01:111:e400:59e7::19) X-MS-Office365-Filtering-Correlation-Id: 1fbca4d8-e4ce-4fa5-d35f-08d4905f717e X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081)(201703131423075)(201703031133081); SRVR:AM4PR05MB1505; X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB1505; 3:np07k8PD0pR+jY1fbMtpJECwIsrVGqY8Dkfp1xTpK506rlt6i35t1dutFeSHybiBLMwtcNH2Quu94xWj9Qm68M4mRtJNK04a2Y+N1VYRhPdpa7IHwc9CilfVCJuzj/gsvZJ8IzVKBtGGUvTtKiweMCiwHIyWd43p8oWMACDdNSIyl3apX0F4I7/Ly28e7C579aqWGZ2Suy5S0xdV/nsGwZ4IPddHzvgNpmN/LeyYsZpBVzXqYCdcmZxJPmV5c1rWvPP2q+m/Rhnak7zQblByO6g/yMq0htHduNwguzhlFVoInqtNI3p8k7JK0yqJLFw5i6yfY89lQ9XmDefYC5eHVPMK/wLfZw/nPYmXNoJHy74=; 25:W6lLQDpRMAgz0Fj+PdmRjDoI2uzHF1NcOQbuQYG1kOakDY+npJUEQRcgv3E0SUiEAw9Ruve69pOpBu03oIYZ3vf1kyOs6kO5IzVVY4Bj3GoC7aXfN8OgJMGJlXb/zIDA8vSeB43ikBj/XHvD+bWhbg1EusPw8HnZ9LxshiqF0YLdA6xE0eTgWZF+3xNTyatAZ0tIcpDcIbJf5pSlwluU3u2ucK0/HKsmPppZ8iJjgOE9qZ4jAATzikcDhwz6y3nHHnZg9P9YRQO9gGkx62Qz7THLRcrZq8uXqixYRBKqO5ZQF4qJE5uiNq1lRwZ82lMZtoYuCSgj3l3o3sCIFWMcCVOOIjsyqG/jjCWFwyAV+IamXPW72GRgXAZVCek8Q/95w6D6YMLgm61M5CNkMD9ubvW1b+lix68q53AhBc1MegRXPArA83UFUtI/A9izef6/1kxPyqvnl1YbQNk8w5E35g== X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB1505; 31:dYslkuTw14V+TUHEcYkcPpBVE2vhc4Ifem/PtHJV/BhKEFhThpzPz+QTYSqcfZ2+C0UVsYS/rs+tNOR8j4jO885LTJER+lTxbk/Gj44BBUajg89KbuxYJvY1lBsKdxipCqgF78cNssE1qlXldihTBS447r7cCy5R7mmNDwbZBtuz+Q/GJtj6Nzi2Zzm6ebk1bG02kgKU9FlXUeilo4c6rL+5Fsa12JK1BbdFoV9Y5JU=; 20:Y8PiUEQAX0tzgQN3Ef1chtA0yKsb1YQJsjq1oFkAzwKT2icCONLstSxm7NiC3BqZbNmAj/LwApK8wSNMWM79/gezwhVehEb085s+4UAUvptQ8sk5GY66bopN0yaRVhiuv6vpsYWyDMvqb7S0V3jUxJfsYQ7Kb3QLQeqolVhVtPyK9DwhC8owxqB31iF6C9V2ab0h8TfcZuorMq2fTKFkYQXDqZ2LrSmux+7I79u44v3Hp2n6lTSjBR21cotkQC6LanprufBv7SqVSj2tVsrmHW12jjdvIauWdQIdVMvjPahZqHsriSKn2ykJZ+QVVmXRITQrOPX+/IwGx+fRASml5wTV14xsQa4Q+VXPV6gCIwn0F69qsEGnqO2FeSYeMvvCRuJn4/Eq6XiaHHEFDcib4RCQ79xbg4UTnm59WZ3mR28dnVuL8uNkXiu+USbD5U6X0FLIo+knE1OOiQpoavOgkwBbj5gtVM2NzoCIflUxy4w+Bg+cJnJmcMdvAxgDhBI6 X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(278428928389397); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040450)(601004)(2401047)(8121501046)(5005006)(93006095)(93001095)(10201501046)(3002001)(6055026)(6041248)(201703131423075)(201702281528075)(201703061421075)(201703061406153)(20161123558100)(20161123560025)(20161123555025)(20161123562025)(20161123564025)(6072148); SRVR:AM4PR05MB1505; BCL:0; PCL:0; RULEID:; SRVR:AM4PR05MB1505; X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB1505; 4:4RXw2l8lrp1yM1aRDpPrOtkFZfSKJDv9ikvIZuyP/FjcdIdnDhSLp+6ZdUdjK64uEsWiLt1a173rCR7wmlHRmlqtBqXQhyIsfbmDyrH5B1/6KWwYLPnlP89pOqfw4AuCzbHH7iUhtbO5EvW5rI8ZEw6nh4EfFGX/8l8a35WUMWeRlvavtbmgLROGnZDvHqhyGQbp26ul348zkKapY3XMTRFba8klBEEYhygM5f98R4921P5RDtdH8+7fdeR55uvmUwD0I5ZTdzrKhybs07QW56zi19uc+9DVnZFrpt40lu2KIVDUSeRN4JmfreMCsariwcDHnytlj7aJoqNfzFy9evEPnBKo4lz9vLS9wGoZCLXchll1SlJzGwIDH+3dH8ahodp0mOGxfewCsAHWeI3cdqvykxkt3WN5xAuRPQuUE5SanBeRU/OGoUW5XvwsGLe/EdRp1NnnXpBzVas2WrIhKQ2t3XBZqgTgiDY3rV6IjvY/jO7SOpbjJKCPtJRYM0ir7Goawhb1SB6dxq855+JyFjQKJts83sM4+b3PQh4L2OJcTYzNyRSYIIbR6h3/dtb3hDdAz3J7Vh4af7ij125FakJuZlQx+9wBTVTVJSqcP4/w231gjRzcTIABXXtm4AypaCslP6sQ1yFo54aFSZj7RXCPx/A4bAcBzbcKNPnN4twsc9rTdjt9CaM0bQoa3Zm80y3g+j9BM/IoT4hbAsTD7N4kxxKSNJHcOVdG+HP3Lp154NKZnP1acA7Z135Yr/KbrY6OqZ+FdOU4jUotBfg0dXf4gvi/l9ULiUhZNo+ziTz/fMKJxRPkTJxUdKlL5/i6ySibDo85NJnj/+7qTo9o1GXL4Ycvo2jDSZ6kE+YI45Y= X-Forefront-PRVS: 02945962BD X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39400400002)(39850400002)(39840400002)(39450400003)(39860400002)(39410400002)(48376002)(50466002)(86362001)(3846002)(561944003)(36756003)(47776003)(478600001)(6116002)(1076002)(38730400002)(110136004)(6666003)(33026002)(5660300001)(6916009)(5003940100001)(25786009)(66066001)(50986999)(305945005)(2906002)(7736002)(55016002)(33646002)(50226002)(8676002)(81166006)(53936002)(2351001)(189998001)(42186005); DIR:OUT; SFP:1101; SCL:1; SRVR:AM4PR05MB1505; H:mellanox.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM4PR05MB1505; 23:A9LDyBAnA72G8GI4jid+r5iA0xh51v7eCmjFAjZRI?= x0HkbQWguANeR7TtZkQ3H3gxZUHjDxHBHkgMkrUsOlz/qb8gzjicWR35jHSyj2Vlr5I15IX0ucUJ/yxeyB6j0OLvcQnktmOIQ1jtG2RtineR1UDPgH4hnQMa+AvOc56pcX6Jzl3kMszGutlMmdxJUtCqXB9qy7fo+fJmf6i1m3PyOYqR0f7ACyvVPpTQY6lcHqx1rb+pQMGb3qCVPLHQzDKVRipxCmeF6v373SpGPAnKLRRIxnOvhWHwpO2IBqmyXQkwqflBg26jTPNNw0enoSIBay94hKLZ+uFB7sUxQzFCaW1vGq/KzMrt7mwElVBFDWvyse/amQIUMc8Pun36xhrVE5wizd/ioKFcO043ALnRXp6xld3y1w7TdUaOQ384ios7hVHdL5aOycX6NLwl38PYs8K6oKaQ5WEHrrZ6VCRMnUra0T4ucWHAw6K44VXY18oRFiLF31UlJOpDBurDdj9PexXHoTEbWZbC1Ngo4eFvVHfB55H14IjbAaF14baHhSet9ilZjXTIAuuHAFpUigYT/kgohku7xrpld98xAv2XpQmaXsUNZ5kcAvD+N0Gx6J37mr4MTfB4KZMRMvM1mAbhV93xzJjdbVpwq77is3xGmqZHZSPgiowjiooj6lXAReOS52qjZJCjUjvJcVQcl/ayNMwmoFpDMYTa7PePwOy5twYN5odV2vhIElp2S3WYfnpG8vmyz4DVeKYiFN8NIS3vr9GFbYnhO31gmv0Xo5/iRbfGQHJMUyns2YpD9xHqB9UAukU5NdOMrdrfq73TaPQCEnMWjWz/+jyDnM5+pTvkQ+S2AEhwcZi8HpJ1S3Fg1pESqlcJcBvT+I83wpXI1jJAGWrqfAARL8dyY5flXQEr3mOwgBg8OaTbd/RrSnCjRDKQbP/DGRqGh2rIija+c9QclKnAi71qG9d/IiajLdkaaE3XQnrhBl84qYVi3XkUf/D3z2eT1n0siL3WJEAFJ9aqfYLn5UXHP4NWwASqhjksQ== X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB1505; 6:/kh59NqVu5FhOVe3fqwlCqQa2RwC6IRuC0s/VxeRHeGIAcNeLUw8J2h2HNcDC9QWVXNBEsXjjuzNaE4ZBibnEJMtWxcnS5fGvxJOC9sBfl0N4RmpqfwUOJOVn6FVZJ8aaYc7VzgE8yE+C0ljFEgePyGIKoLnKU6NsN61+7QlIfmVGDDJYsehlKOnrRhNewLw4qfOPy8LYtY/pfPBir2uHV4vV/l4BCTlFnM80a7QLj00/VAioUcQGTlhYD5mSJWeUnMcFY+SHzufbdrOD4vziaHqestnSHaq62nNeK/f3apiBlzEtzOJ1F4bUW18WCVgECwUwNKLd6YbqEXynLTW60Q5OHxp2OIF6o45d8sDC42Z6qdu1pLJtU1VX1j59FrRrglDL8Hs8L+tJRXwHcpmcTM3XS9QvdLvQDsDGvt22Fxd1Sa1Vt/Q3c0zDjwbJKt/ZqDlW89ddNPRBTh557HF9Gjqb4v+IQoLyaidXLePW7xnbzuYCo7W4ZZUUzFqulp1SFCpqxb6lg+dk0iO4RPnBX4DJJTw9+jlX9DOO6BcmfA=; 5:OQIO1+d0jHM9DPp2GhGiRcIE4p5DdMONZwjOUUHbW7z5og50jTumorlMHnLrr7WW6lDC/Afb2VXKfV6fE9P6IFKQzg9VhTRBDd7Bkis99uKUnxFN8+rQmUnPo94mO1SNPqavgURmjtTfDZCfM1+SPw==; 24:wKvfGu4u0z47gXMJdILQVZxRfCOgvjWRI+Xtojw0QtJv4Ew8QmHm3Tz68lk+sUH79S7SAL2VqRTlZ8CZcMy5xpePnftkXp2mkPQZOQzfDO4= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; AM4PR05MB1505; 7:douf1xlqpXW+i169eBIX0uEmZbd1829GNPCtWh/+PWc9NFTl3KIvL/2WSHp4F6dDmMw/a7fLyGUySsCu9Hhnxq5NTqulyx1hxW1bBYL6PniThB2pa+/CXahmr9vUuUCrR0L4RV9aFQa2j+pZIrlchSuH4ixZIVLhNj0RyQ8owE/SKsuz23qiMLoP7v2+67ZaMQiaVUDcA8Fb0eljg4DyDdeYWu01GNiAIHGKZznOCQNiCz+sY3GxyKUkNz0RUXwdvJ/TY8OIuXCuVNlETgQz10BFjUoQv0M30TlEu3/93b7GbszXvuo4zwIhmuoBStVutV0UFBJl5iaycvZeu9fR3w== X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 May 2017 06:58:16.2136 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM4PR05MB1505 Subject: [dpdk-dev] [PATCH] doc: announce ABI change on ethdev 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" This is an ABI change notice for DPDK 17.08 in librte_ether about changes in rte_eth_txmode structure. Currently Tx offloads are enabled by default, and can be disabled using ETH_TXQ_FLAGS_NO* flags. This behaviour is not consistent with the Rx side where the Rx offloads are disabled by default and enabled according to bit field in rte_eth_rxmode structure. The proposal is to disable the Tx offloads by default, and provide a way for the application to enable them in rte_eth_txmode structure. Besides of making the Tx configuration API more consistent for applications, PMDs will be able to provide a better out of the box performance. Finally, as part of the work, the ETH_TXQ_FLAGS_NO* will be superseded as well. Signed-off-by: Shahaf Shuler Acked-by: Adrien Mazarguil Acked-by: Jerin Jacob Acked-by: Bruce Richardson --- looks like this patch has arrived to everyone besides dev@dpdk.org resending it again. sorry for the noise. --- doc/guides/rel_notes/deprecation.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index a3e7c720c..0920b4766 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -81,3 +81,11 @@ Deprecation Notices - ``rte_crpytodev_scheduler_mode_get``, replaced by ``rte_cryptodev_scheduler_mode_get`` - ``rte_crpytodev_scheduler_mode_set``, replaced by ``rte_cryptodev_scheduler_mode_set`` + +* ethdev: in 17.08 ABI changes are planned: + Tx offloads will no longer be enabled by default. + 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.