From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <shreyansh.jain@nxp.com> Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-ve1eur01on0048.outbound.protection.outlook.com [104.47.1.48]) by dpdk.org (Postfix) with ESMTP id 1F5D14D3A for <dev@dpdk.org>; Thu, 1 Feb 2018 13:29:56 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=cMxNiFiWnHECVqkgZcJf0pURPpwjQ4dCU7iEgMPdqkw=; b=aPvVRUlfJWGidI4lOVIFUQnMnX6mylKEnjmad8RpgrNJjJs+P7K1mvuxolH3zdDM0gXIHOUExNQd2sAiDSlIm5A3jyX7KPtcw1JO+3ClYtswMG9qLRTIicg2uUED6towfVrwH1gmsejXcRGYFROR59jNQ09lowD64d5QsfzVZJo= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=shreyansh.jain@nxp.com; Received: from Tophie.ap.freescale.net (192.88.169.1) by AM5PR0401MB2452.eurprd04.prod.outlook.com (2603:10a6:203:35::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.444.14; Thu, 1 Feb 2018 12:29:51 +0000 From: Shreyansh Jain <shreyansh.jain@nxp.com> To: dev@dpdk.org Cc: ferruh.yigit@intel.com, thomas@monjalon.net, matan@mellanox.com, konstantin.ananyev@intel.com, hemant.agrawal@nxp.com, Shreyansh Jain <shreyansh.jain@nxp.com> Date: Thu, 1 Feb 2018 18:14:39 +0530 Message-Id: <20180201124439.21633-1-shreyansh.jain@nxp.com> X-Mailer: git-send-email 2.14.1 MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [192.88.169.1] X-ClientProxiedBy: BM1PR01CA0099.INDPRD01.PROD.OUTLOOK.COM (2603:1096:b00::15) To AM5PR0401MB2452.eurprd04.prod.outlook.com (2603:10a6:203:35::21) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 902c0efb-e8da-4ec5-08f7-08d5696f7e63 X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(4604075)(4534165)(4627221)(201703031133081)(201702281549075)(48565401081)(2017052603307)(7153060)(7193020); SRVR:AM5PR0401MB2452; X-Microsoft-Exchange-Diagnostics: 1; AM5PR0401MB2452; 3:HBsHqKbs5WHye+QL67OU65+v2B+AOxWkV7dX7SszKaAFWLl7w3Y4reABLf09ywXmCX80xOvUhyF7dGJu/mWzqcuua5nGkybX0AbeF74IaDcfQJmnpZZRnhTgld2Zy5kaP2JKPaQmD8fH3YMY/DhCVtM9uEHTR2CI0MpdXdYEBkRJrpflALBMl7LAQszG0ep72F1nv2Q8WGrriEQdEMJGFpUxrVSnDQbo7ZGNeKKhr8THD8OtHZGRve5WnHyCptgs; 25:sc6AlN3+kSDOf0a4j01L1Q8nHDwVostbxw0OrovQm78WXeafXWRdMVa8xMcn7RzykuPqB7qBchISIX21N/bAGXJ/Td43JIV3CGcG21kG74EvRIKVxfpYEbNAn4WADFM3Yfhuxhwr+eP8ewaPj25c+9554ZtiHKOGRJ9w5StE7ihoR6zthRwI9pWqlxc4Hcy2xkI4MzsJxfTz0+HI5UGEBYMs6QCSUQFakdOiKuz/LRAGD6OMsAwkkAcnZWsSccxc+mZBg25F1ohI8C9vBz6Sg1pLN0cgxyM/GxmXeYRIWbxZFczrAmwN+JXekkN4SR19PIELM1rFVHrvF3VaE2ItvA==; 31:JrT1r/FFALusbg1zQfdDXZdBmeomL1W8wD1aenbQMFU8skr+kigJBDvp9XnzwoGn/gHvGp1cu98/I42H3Fext2IumP7tjoIZZ01dKGFhm/zwu/DDz+SrkLvq27V8c4ZpC/jg6G026I0FaxvZk06lLwOtE5GM06DPH7eULGodo117GJ7p6doFmcnGYdVgGG8tDWAO0cpO2wpk/x0CtJOtswJcPcC/SdSxXAXKQpkgWJQ= X-MS-TrafficTypeDiagnostic: AM5PR0401MB2452: X-Microsoft-Exchange-Diagnostics: 1; AM5PR0401MB2452; 20:+hubxEASM3LpH+E1IxFPIvudWZFoFfglePQJL5XjOFKYhlcMbyj3gU3k7sUV3iL6ipXF5uoUUX5bvvWkbaSbCHHF3+nDxJH5qBr0aIuYV0zzxGEfFQAIvXVfc+NDCJY3CZ7bJ6OeKJDTUAIZIMbGPxv93fYASqoi28QiCuKoE17/T/TUTTUeVmqcZXuU3PyaR7uybiBnH+kmr13mJiIOoZO3iXOZ6lnZBof1h48eAI3lHnJwtrJqxn4mYlLKSgZnvAuz7zC3ymU7Y+nMWcJwNW2fKPNBjBZtSPM+4LeKGe7Y36tW/uNgyCMWRQVusIeuwrcnK1Cuub5cfSYJymHPp0IW5K6/WaHpBW64lw46Qss+B/6fVAywAFxV05VM8axiI9KlcZCEI6BYRxx40l/EvzAj1A1XU5b+RIZScxHVOknxOrrSsWjVfvETmjE+EQHX/V09hfH3lhg0AC0Tmfblirb8Jo8I0b8nkZmZN7cGNRGKnk4CIgjAwCJED5YsFhh2; 4:YkF4r91jl0R9Ly5OtqtugcZ9Jb0FsyvOFJ0rvJyLT3baHnoca2lEw8b6BT1bxu7G++pteaid317Ot+X7sfVOJpfK5sQhBRhAANGbappbaNv+oKRTVmcjJj8OURVKTwA7pjpUERre0iYZd9grTvakG/lXgOjfrzRakYrAZ10OIhYTF5mvqOVjc+hgwz6T81XhR7CPNH91uatvwPnk2J3dmhG3M7XYtM7ylgEUw7vUn/Q6CZzwUYftRDQUsLw2N1hRX/UNEHFyHc4xlv0N8kEGHS/myzc9GVSq4u5cACgWReKPirkjT2e5i8phAnZMfv3q X-Microsoft-Antispam-PRVS: <AM5PR0401MB2452B37422888E73F076BF2D90FA0@AM5PR0401MB2452.eurprd04.prod.outlook.com> X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040501)(2401047)(5005006)(8121501046)(10201501046)(93006095)(93001095)(3002001)(3231101)(2400082)(944501161)(6055026)(6041288)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123564045)(20161123562045)(20161123558120)(6072148)(201708071742011); SRVR:AM5PR0401MB2452; BCL:0; PCL:0; RULEID:; SRVR:AM5PR0401MB2452; X-Forefront-PRVS: 0570F1F193 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(376002)(366004)(346002)(396003)(39380400002)(39860400002)(189003)(199004)(51416003)(6916009)(25786009)(478600001)(1720100001)(316002)(3846002)(305945005)(16526019)(4326008)(6116002)(53376002)(47776003)(66066001)(6666003)(53936002)(52116002)(2906002)(81156014)(8936002)(81166006)(8676002)(50466002)(48376002)(5660300001)(6512007)(86362001)(6506007)(2361001)(16586007)(7736002)(2351001)(6486002)(26005)(186003)(106356001)(966005)(59450400001)(97736004)(6306002)(50226002)(36756003)(105586002)(68736007)(386003)(1076002); DIR:OUT; SFP:1101; SCL:1; SRVR:AM5PR0401MB2452; H:Tophie.ap.freescale.net; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; AM5PR0401MB2452; 23:5SQieEyOkiRtkRX1IuXfSCXBQMP7K2JFWDXSS/X?= =?us-ascii?Q?Huc0bfy/Nd8UMOrzwS3825a46FOqw8zM+BicK5AJwD7kz5xk1Wz7mT1U86x5?= =?us-ascii?Q?+tta0yBOQmVJ8J+Ufc/Xdh5OXRUIVNFP01Qiv8KsNrjG/1ZUJRwNCmGHYFne?= =?us-ascii?Q?i5a6AJICu8m4ShVud+Un0k/cl77xnvZrnRlW/HyenZxSnZ22ljVfaJ/ahCBb?= =?us-ascii?Q?mBbRlFhXPOd1H0t499IdkZwu70gd78+xsoUPgBfxpfjM4bXkKPGECi5cu6Fv?= =?us-ascii?Q?GZmLZTxQ0fZWfVlA/pE3z2BC0ec6tb25aOtTRbKZ3661FJkjM5a2MafBONQZ?= =?us-ascii?Q?uZrKt6Hyj9jS0XdkKoU83BGN4C/8JO8R/pKAtTe3rJOzgMgNpW7jKybviBHn?= =?us-ascii?Q?iSlKUZllrAFV5PzZNCSDHMg2qk4qjtMzRE/h6gFYC3OMhfwYrw0/GNzyEs54?= =?us-ascii?Q?9A8PBKT889vRBCr/odCb5l1ftwcCbmnSHS0jjd7U4KAj6tJSwXtFyZa/REZo?= =?us-ascii?Q?pxGYdxQLQM7gHwE+MRc86oCgCGeiJ5wW/YntXZihwCFWXdAoSeemtGNxQEOy?= =?us-ascii?Q?gwdLRT7x4Z6vlxFOugvX0tdM5sSeHilnKdV4asOloqXefBcpPBk8RIkDDRZZ?= =?us-ascii?Q?riZvcj6y/PApBWmB7yhXovD2qHpgNSquZuXNEXSjQBsXlk5ZI/qqkkn6tDvl?= =?us-ascii?Q?/mgJJOktA3SwYKVq8hnkZdMibxRbQ3FJvbZooprtitvCaTN4ZZ33LK86KLAT?= =?us-ascii?Q?37f79Ui6ACFriZt7n7uqmrgmlNbrx5GUBKVvTxZQLq+1pVkfYiW9Jgq5J/mD?= =?us-ascii?Q?9L7mGwW+9nbyi/JQkp/tLVpGrMP5q8AzprB/g3km9knJKp1XPA3oel0C7ISn?= =?us-ascii?Q?EOHR/xcC1/lL5tAsaxsMThRiEo6J0rOQK3Me6pytPdJ2mMw68becE9IPGrtt?= =?us-ascii?Q?86qELh33ZV1DyOT34lPAb5YL8FxWJIZVaOKPX/rN0vvcMR4O1MtHuoVwwIen?= =?us-ascii?Q?uJerrRykvBIt8Sm2ty7ASoDNoDJ5Fe5MRRUDAA7tvEhmYOwDKZJjDUJOD1EF?= =?us-ascii?Q?qvGCNlm4auqYYSsh2l0tbdM1bpl5pCsGNcgOk79qAoE694lpWvl/r9dg0wCO?= =?us-ascii?Q?7UozGHiRP32DjcnUyr3D747M/FuQVct2nGznblgLTTXNQv/4nU7ag23Oayb2?= =?us-ascii?Q?ytNn5BeoN6xF9fsR1rETsFvlBlheG5o4I3WDbxvWQUUoo953JsZPLtTkHIA?= =?us-ascii?Q?=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; AM5PR0401MB2452; 6:PTh6cC667yJwPSTrx5cjew7QBZLtFSdIDQYlz3t8l8FWdqZiZ+lter4Cy0t8atRCUC9F2laEkigngFpPVf2uv2Jd3dSMSz4P8utrLolu93R8PNHR2y7Qbzs3TzxczKB/IX+ku4V7fIUq4wIDNV2dprS3FQdrJm3wEhwz/MRaiU/Z7io7eULEOXtt3FRDDHIcCZNbDr6ffyFao1XGfMxIwrQJSZXqc1nGx+KNLDrE+VIX+VeZLkV1VF/1kGY7IEW5SKSSo4S58/vN4qb0Zyic9jT25WelUZVqvNY2237mWNQuaLBUpm1AMq3/nZVJw0gnrzBuwDBcAwMZmgdBlSLXykzeBPY9q2Jz/x2TjlZqPUU=; 5:iP928zp1LRoDSp+t8nm6srjg3uaZvL6a710p8S+7Et4xKrE9IjQVnM5R9SVEXTOoBkTwT/w0EiWJzjdq6jV/O01Nog/8v4BW+YVU4oVh//WUUKuEUl2DxOw+bL4HWKaobWW5rnQWqkR9svw8kpc30w3wbPtTP0Y241Ofsv4PN/c=; 24:Wq466WA2/ajQ2qjqCusqCfGSIP4cKoSchwMLT8fCVewQ8oknS9lEfOSCMoN7Ff9Q4q/VJ4Gyv/xwjk+q2R0zRi5t4+a+0z70bGj+OYbpeXk=; 7:3w9RYGHTDsqUKFjllX14/+d6+jQrHGzddKPofjRkL/9qGIeWUXvpTYA800H56HQJu1lNW981KzHU4pcmplt8W9XBNCIyaCak12POFkF7M+miuFI44kTKkTe8xo6oTO7/aKF5CuG/fd41py0V0Xo1a3nP1s3NkRSqYDLH04Rdbi3sG77i5yfHHtsX9CIa2gqTGUR7g7L19FIjL+/LECbhruoRwhEZPLJm2m2s1nggePhjRAiCQvDEwyNjL0RYe5/B SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Feb 2018 12:29:51.0186 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 902c0efb-e8da-4ec5-08f7-08d5696f7e63 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM5PR0401MB2452 Subject: [dpdk-dev] [PATCH] doc: add preferred burst size support X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions <dev.dpdk.org> List-Unsubscribe: <https://dpdk.org/ml/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://dpdk.org/ml/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <https://dpdk.org/ml/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> X-List-Received-Date: Thu, 01 Feb 2018 12:29:56 -0000 rte_eth_rx_burst(..,nb_pkts) function has semantic that if return value is smaller than requested, application can consider it end of packet stream. Some hardware can only support smaller burst sizes which need to be advertised. Similar is the case for Tx burst. This patch adds deprecation notice for rte_eth_dev_info structure as two new members, for preferred Rx and Tx burst size would be added - impacting the size of the structure. Signed-off-by: Shreyansh Jain <shreyansh.jain@nxp.com> --- * Refer: http://dpdk.org/dev/patchwork/patch/32112 for context 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 d59ad5988..575c5e770 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -59,3 +59,11 @@ Deprecation Notices be added between the producer and consumer structures. The size of the structure and the offset of the fields will remain the same on platforms with 64B cache line, but will change on other platforms. + +* ethdev: Currently, if the rte_eth_rx_burst() function returns a value less + than *nb_pkts*, the application will assume that no more packets are present. + Some of the hw queue based hardware can only support smaller burst for RX + and TX and thus break the expectation of the rx_burst API. Similar is the + case for TX burst. ``rte_eth_dev_info`` will be added with two new + paramaters, ``uint16_t pref_rx_burst`` and ``uint16_t pref_tx_burst``, + for preferred RX and TX burst sizes, respectively. -- 2.14.1