Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/34940/?format=api
{ "id": 34940, "url": "http://patches.dpdk.org/api/patches/34940/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20180205062222.27522-1-shreyansh.jain@nxp.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20180205062222.27522-1-shreyansh.jain@nxp.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20180205062222.27522-1-shreyansh.jain@nxp.com", "date": "2018-02-05T06:22:22", "name": "[dpdk-dev,v3] doc: add preferred burst size support", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "9f87d68f7d1db200b87ae5273578811d8f968b5a", "submitter": { "id": 497, "url": "http://patches.dpdk.org/api/people/497/?format=api", "name": "Shreyansh Jain", "email": "shreyansh.jain@nxp.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20180205062222.27522-1-shreyansh.jain@nxp.com/mbox/", "series": [], "comments": "http://patches.dpdk.org/api/patches/34940/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/34940/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@dpdk.org", "Delivered-To": "patchwork@dpdk.org", "Received": [ "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 8D8361B30A;\n\tMon, 5 Feb 2018 07:07:45 +0100 (CET)", "from EUR03-AM5-obe.outbound.protection.outlook.com\n\t(mail-eopbgr30086.outbound.protection.outlook.com [40.107.3.86])\n\tby dpdk.org (Postfix) with ESMTP id 168031B304\n\tfor <dev@dpdk.org>; Mon, 5 Feb 2018 07:07:43 +0100 (CET)", "from Tophie.ap.freescale.net (192.88.169.1) by\n\tDB6PR0401MB2453.eurprd04.prod.outlook.com (2603:10a6:4:35::17) with\n\tMicrosoft SMTP Server (version=TLS1_2,\n\tcipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.464.11;\n\tMon, 5 Feb 2018 06:07:40 +0000" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1;\n\th=From:Date:Subject:Message-ID:Content-Type:MIME-Version;\n\tbh=OzJbk8717G/xr2yoDBUiKXEXg9NdFBx54yYJNmZWxc8=;\n\tb=qo4szNVp4fEDiW36X29eb9XzuwwB28zNrd9lPd6qr1c27aYd/OklbBCoWNTQqUKE3DKe0KOyzoUAx8i/PGGpVxyXwfuhoWekrY5C/G8f4qljQfTXRDpEphgrD+4io3wUv2z5fILSnlhEGZFXKxHv2nmzAdgx/fS6two+t/J5RTA=", "Authentication-Results": "spf=none (sender IP is )\n\tsmtp.mailfrom=shreyansh.jain@nxp.com; ", "From": "Shreyansh Jain <shreyansh.jain@nxp.com>", "To": "dev@dpdk.org", "Cc": "ferruh.yigit@intel.com, thomas@monjalon.net, bruce.richardson@intel.com, \n\tkonstantin.ananyev@intel.com, hemant.agrawal@nxp.com, matan@mellanox.com,\n\tShreyansh Jain <shreyansh.jain@nxp.com>", "Date": "Mon, 5 Feb 2018 11:52:22 +0530", "Message-Id": "<20180205062222.27522-1-shreyansh.jain@nxp.com>", "X-Mailer": "git-send-email 2.14.1", "In-Reply-To": "<20180201124823.22621-1-shreyansh.jain@nxp.com>", "References": "<20180201124823.22621-1-shreyansh.jain@nxp.com>", "MIME-Version": "1.0", "Content-Type": "text/plain", "X-Originating-IP": "[192.88.169.1]", "X-ClientProxiedBy": "PN1PR0101CA0008.INDPRD01.PROD.OUTLOOK.COM\n\t(2603:1096:c00:e::18) To DB6PR0401MB2453.eurprd04.prod.outlook.com\n\t(2603:10a6:4:35::17)", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-HT": "Tenant", "X-MS-Office365-Filtering-Correlation-Id": "b077d3eb-57d6-44e0-4332-08d56c5ec493", "X-Microsoft-Antispam": "UriScan:; BCL:0; PCL:0;\n\tRULEID:(7020095)(4652020)(48565401081)(4534165)(4627221)(201703031133081)(201702281549075)(5600026)(4604075)(2017052603307)(7153060)(7193020);\n\tSRVR:DB6PR0401MB2453; ", "X-Microsoft-Exchange-Diagnostics": [ "1; DB6PR0401MB2453;\n\t3:4koVWn2oOOSLYt8z47sFOBLn/xYWAYbZYUbnMZ4RMEkkapnyu0txseCHhcQ+Kv7O/WrvSotBZmknVmPp6ukw/sbaRjpaKZ6PvnwnVGc+G4cuPqizGlurRa/34aX0tF+tgsESOXxzPijbni5rEuF5Or4o5DmJkEp8TYX4frRf+16Px4LDVBZdmJxgFrVw7OWZsqtqOjLcjkFtLT+V76J97OvnbM34BFBoXVAYLMo55hoZYTLx1F+FKuLLHvO7VQCR;\n\t25:Vdh42VB2l2ZMfzYuk3mcTavZx5Y4C6Gs9yf8L/8deWkyHBNbOp9cNanXaCKKr4yuLv3G4jYPU/zDc06k4kcUxCQ8fLfNWxOJMqTJqSYHvbuou/8Wz2UkFGsZ2daktwffHjUoOtihYaF+14FfbReg3HwhzLNoOy6NQK0jNp51K+oXfDnw8bFUdjYI9Oah7Id1oCM3+jJYHyKncqaxdaWPBrJHU4VlsvTnDU+pHQYzO8rW9fn6BfGU6BUraLPQHVQrhW1C/Bus1x8Q+NOq8sjiM9YtYnzvdWV55us46QTqnQaxZhAquXkyWnknXupI2/pkPa9BqY/oKGeLOM4F67z3eQ==;\n\t31:p5xWpZqA2kT0jQsy6+8oD1eS/aw4RdcZXYFPYVS77v8/MyJgQSRH6oU9LVOkh0KpwIC6gZ9ZeWUuua4C55AoGyXFMcf7jsklDYTnez1kJ6lSNtmxbP4FoOQA9mnCfy4VohKmPw5/uq77FqkDpXN3cKcNLsD5FKuLE+rzH4NnsljiIVKkSVV90HMRW497kja8vMdTtGGTsMEWJHB0kFAkFg1dNT9rPXsgbqjrJ5y348E=", "1; DB6PR0401MB2453;\n\t20:E0SLL6HXcysWHSMALhnwWvq0pZMndS1tnx4OWzocKji2ux+G0HMXJs17lJ5Bsy86KI0cQk+QXE2b3sBHVmA2rzmV2LTOgXL9YexyBIpQ04IWdBbp9T0wN6EFbmjiruTecBfkGW5vyFTiEELpCVUB3APW2AQ1PKwMsRIBj2P97EXp/9tpJcsmDM7cyhCEcECJ2ZbJgFHVr2mcmrkdepXqHcvNi0lbUV8IEPnOxRM1cxYL5aQrnGzeaQH/ykwJiH/tFYnZ3u4uxLuldKyqxWakniHL6FnGzoMcQisJObu2PU3/xvlrvaFp1y8b4thlHXkmP//3+65xbULqsDQ4uXbFurLvovX6dgkI40W5GWJz4eED07955PqlTCVGgD4pmCNfCPjPfXhfUmiVIL/1BCV8I5YTF+ex0cSOIcK2L9qgwwL7bgIh4FolOs4SZmb6A+AwG31a8pvbT2zww5JO17V25eUGNa2Eqqc8OPaNtTiYyQdEUI9VaeH82bCGxBgMj1NA;\n\t4:rruOG8K7rQf8Fd3lTnNWVMyByR2y/+nwN73rcHp8r/MSu3Ett06dZk2WPHaTYZ+FNSYyYqVwZZp1FwGZf0HNZoOLVggk/x9IVKPhSeCInvIfPQmSUIAFeTySe4qg9bFQKLjwsniMMdfWLttuMINCFioReL14xW0E5EYojl01aX0ndHGFvBw1G/GwqMkj8TlzrMa2fIfnP8x5BUDn3Hb0zs+vHmG0nuXflyrNQlJB3Zj7K3DvqQ/XZ5Z/5PVRj0+MSdIKz7UhNs34d0OGzzOU8QIQe0SBZEVl7G7gyGvmRbJQ9iJWV1za4uLluOZRJ/o9JgnQftGq3qkqVoRV+NOguCynMOoRYwDJ7mij+V7o3fs=", "=?us-ascii?Q?1; DB6PR0401MB2453;\n\t23:bOBfSjOMcA5aPiUhvH1CszQONXjmA2I4sAMHL2M?=\n\tMQaFGkDSZA/QvK9z/X59wKjaJRSGrjnjRRV+jebMu4wzkCd2SunH7gwG4POM9n1kxizR4UQhNSo0FwgaHXmizDl8PFPk7qmUCZg9tUma2YkIryMtSy2dyRRYL2G/yUT95OLzmF4FWO+GxTgcSypz/wcVSvQbnEh6JfUUgsG3SzPf9ZLlnUvQ3ILg4QdgrJ4Y5HfkTi08npCF2Xmsp3kLHU+SybK/cTh4j5iaQ2006NgZr3PPiyiE7FJ2bUOlrZhvV9Ua5TTomWfjVIT8aD4JjPu69wF86iIIHe5SGW03t5lsc31Nx6KxzXRT8bKmmJw7LCNCDli2RDcYzAHm21PAWpQosPjIAVa2Oyt4Jm4M0BA+uBAiN2iAkZpKLdlE8I5mkSx3Hr2wYJV8B2fWCiVwLf4IrgLOV26EO++/Mr5CVqZfFf2nuveLUDCsDNw7M7d1Uno7zAdKsd1lFUZHN0F9rHaXbER2iRKMbLtpKxWw/4gQ2xl1lrTjj2RVOg82smarfghmGM9Z+LmcjY4NVI/vGkPzz6LTPoh1qupX0vbLV0SQFDvNwnZ2bmaIVTF7UoPKpCHfJTGkv8kNwdZ5I2lqQqbktLgBuvAGEuLO3yGLnlT9kJsv5iMfRZa+81b8JTQnCoXDiNsyfELaow5HhNlwYq7waLZjHzGyPpIgiAHa4uzW3FuqnDXREmbEMHl9XKes6ukWh6HOdDXTAaEgg5QCnj3ha8zlKRFCrxETbxWMsyKI7ZJj6vj02gyxRSVI5BDkF1hP64IPbFIRZJ6CsAVPVyU457c3qyPhg5pRdNO04BkSL889AJQIIYScWYikTft4MQlob0gE1lWEO55JORKoDLboVfwMsZyiF0SyHHgxavni89zNN2X0C1IbSyXlpTKCAU/+urxFS24SN859V3QYf4rb28uVsVQM5bOyh55sfkrWeFecmPSGw+AERDpHIhOQFFHrBDO11JDQPGbM8X6uu+4Ai9tdjeN6Gv1ScFZSYss9QQ+8VdVErq/umPlzeTMghB3zU3G8ZN5ue5YlxiuzyB/mLlqT1I6PlxS8j6PkA9tdLmpfefCURFO5ICDrGNeP26t86e53nZ6IgwyKxqYTPNQTYe68nnT7jrr2t0ifNCYw3LM6dtxhjfvs/x3ZaKOJdLE4=", "1; DB6PR0401MB2453;\n\t6:7R7h9XDCl+iGUj1M5gdDtaz9eAS/orduoD2G96mbAhk52aTuLhNcUASuu3HjTmvO3fsGW/vZAKEVQXVuzKkLiTX4rGRA29m/tsXOpi1ubaikJSUHE0xSq6DKtLD1CzFJQOTUuLoSB9j3RZYMcLIyFivfxr0FBemd5u1qOwOSHWSJbd799iDFE1aHE+ytV5OWyiTEQ0GWqApFLAdK3s+lHEPfEG4Zu4V1NHLy4cf/jmn6VbQ/EdfaSEShtgfW2miLWgA7shGV6ZUCtmjTqDo/e6QA4od4l4Uca0q2LDWQ6DUM9vT9kpXrWP0YEL78mAevGtKsa2Zetcm84Y9Dw5Ko72NeQUVIsO0ZOrrp0QOlU0o=;\n\t5:jBTDFPU3wJyorhGQKqlNIPyKXS2oAenjDXK0/cuJvs0LBQihFnO8bZCAzXzmdpyedlV6kPd4OMs1wMngUY1uZJmwt+kUoOoyqrUJkffqTEt1HT708asRytfzO+KguXTxjUawMBgHi5NQEsnAbz8jj/mCcmNY47bG3KhfCneApdI=;\n\t24:po6894gZth7RkdiVTADBCf2tl12pi2fnIUr29o0DABX9aS0xZKfW49Xe5+29gheBDdOg/YEBIUR2sdB9VerbcvBLrR3MlJFAdCxZ1RRf4nY=;\n\t7:dnyH3V4b6GIgo5jjQWnpUDMqJeaTGmUaIr7wZq6thF0HIi3GuJ++OWEBOkR88bkl4x4I0J0UsoIQFy8jyLNWKb8OrV6VnDNOR1ur6DRkOywOdiT15CdbgOjEpny7a8a8mTIuUs1x3wYbZt/N7E4AyA99uYvvgnGmvTq96sA/xpSgSVdRcJW/M/6IqIaRt+nQhtqsSqL9U/1CAsTqAXm1Gx8xLj4A10cOVeaaV/35hFYtN5wuta95SPYZoOFCKW6Y" ], "X-MS-TrafficTypeDiagnostic": "DB6PR0401MB2453:", "X-Microsoft-Antispam-PRVS": "<DB6PR0401MB24537E4F3759FF3000211AB690FE0@DB6PR0401MB2453.eurprd04.prod.outlook.com>", "X-Exchange-Antispam-Report-Test": "UriScan:(185117386973197)(228905959029699); ", "X-Exchange-Antispam-Report-CFA-Test": "BCL:0; PCL:0;\n\tRULEID:(6040501)(2401047)(8121501046)(5005006)(3231101)(2400082)(944501161)(3002001)(93006095)(93001095)(10201501046)(6055026)(6041288)(20161123558120)(20161123560045)(20161123562045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123564045)(6072148)(201708071742011);\n\tSRVR:DB6PR0401MB2453; BCL:0; PCL:0; RULEID:; SRVR:DB6PR0401MB2453; ", "X-Forefront-PRVS": "0574D4712B", "X-Forefront-Antispam-Report": "SFV:NSPM;\n\tSFS:(10009020)(346002)(39860400002)(366004)(396003)(376002)(39380400002)(189003)(199004)(59450400001)(51416003)(16586007)(2351001)(106356001)(2906002)(105586002)(4326008)(8936002)(50226002)(305945005)(26005)(81166006)(6666003)(8676002)(478600001)(6512007)(53936002)(25786009)(5660300001)(52116002)(6916009)(7736002)(48376002)(47776003)(68736007)(81156014)(6506007)(6486002)(2950100002)(386003)(36756003)(66066001)(50466002)(316002)(76176011)(16526019)(186003)(2361001)(86362001)(97736004)(3846002)(6116002)(1076002);\n\tDIR:OUT; SFP:1101; SCL:1; SRVR:DB6PR0401MB2453;\n\tH:Tophie.ap.freescale.net; \n\tFPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; ", "Received-SPF": "None (protection.outlook.com: nxp.com does not designate\n\tpermitted sender hosts)", "SpamDiagnosticOutput": "1:99", "SpamDiagnosticMetadata": "NSPM", "X-OriginatorOrg": "nxp.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "05 Feb 2018 06:07:40.2567\n\t(UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "b077d3eb-57d6-44e0-4332-08d56c5ec493", "X-MS-Exchange-CrossTenant-FromEntityHeader": "Hosted", "X-MS-Exchange-CrossTenant-Id": "686ea1d3-bc2b-4c6f-a92c-d99c5c301635", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "DB6PR0401MB2453", "Subject": "[dpdk-dev] [PATCH v3] 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>,\n\t<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>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "rte_eth_rx_burst(..,nb_pkts) function has semantic that if return value\nis smaller than requested, application can consider it end of packet\nstream. Some hardware can only support smaller burst sizes which need\nto be advertised. Similar is the case for Tx burst.\n\nThis patch adds deprecation notice for rte_eth_dev_info structure as\nnew members, for preferred Rx and Tx burst and ring size would be\nadded - impacting the size of the structure.\n\nSigned-off-by: Shreyansh Jain <shreyansh.jain@nxp.com>\nAcked-by: Hemant Agrawal <hemant.agrawal@nxp.com>\nAcked-by: Andrew Rybchenko <arybchenko@solarflare.com>\nAcked-by: Bruce Richardson <bruce.richardson@intel.com>\n---\nv3:\n Modification to deprecation notice to add ring size as member\n\nv2:\n Spell check\n\n doc/guides/rel_notes/deprecation.rst | 13 +++++++++++++\n 1 file changed, 13 insertions(+)", "diff": "diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst\nindex d59ad5988..91de3c62c 100644\n--- a/doc/guides/rel_notes/deprecation.rst\n+++ b/doc/guides/rel_notes/deprecation.rst\n@@ -59,3 +59,16 @@ Deprecation Notices\n be added between the producer and consumer structures. The size of the\n structure and the offset of the fields will remain the same on\n platforms with 64B cache line, but will change on other platforms.\n+\n+* ethdev: Currently, if the rte_eth_rx_burst() function returns a value less\n+ than *nb_pkts*, the application will assume that no more packets are present.\n+ Some of the hw queue based hardware can only support smaller burst for RX\n+ and TX and thus break the expectation of the rx_burst API. Similar is the\n+ case for TX burst as well as ring sizes. ``rte_eth_dev_info`` will be added\n+ with following new parameters so as to support semantics for drivers to\n+ define a preferred size for Rx/Tx burst and rings.\n+\n+ - Member ``struct preferred_size`` would be added to enclose all preferred\n+ size to be fetched from driver/implementation.\n+ - Members ``uint16_t rx_burst``, ``uint16_t tx_burst``, ``uint16_t rx_ring``,\n+ and ``uint16_t tx_ring`` would be added to ``struct preferred_size``.\n", "prefixes": [ "dpdk-dev", "v3" ] }