Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/35119/?format=api
{ "id": 35119, "url": "http://patches.dpdk.org/api/patches/35119/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20180212045314.171616-2-qi.z.zhang@intel.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": "<20180212045314.171616-2-qi.z.zhang@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20180212045314.171616-2-qi.z.zhang@intel.com", "date": "2018-02-12T04:53:11", "name": "[dpdk-dev,1/4] ether: support deferred queue setup", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "312adadca80a0230a1a890e912af83cbe93b4ebf", "submitter": { "id": 504, "url": "http://patches.dpdk.org/api/people/504/?format=api", "name": "Qi Zhang", "email": "qi.z.zhang@intel.com" }, "delegate": { "id": 319, "url": "http://patches.dpdk.org/api/users/319/?format=api", "username": "fyigit", "first_name": "Ferruh", "last_name": "Yigit", "email": "ferruh.yigit@amd.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20180212045314.171616-2-qi.z.zhang@intel.com/mbox/", "series": [], "comments": "http://patches.dpdk.org/api/patches/35119/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/35119/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 221E91B32A;\n\tMon, 12 Feb 2018 05:53:26 +0100 (CET)", "from mga14.intel.com (mga14.intel.com [192.55.52.115])\n\tby dpdk.org (Postfix) with ESMTP id 2AABF1B314\n\tfor <dev@dpdk.org>; Mon, 12 Feb 2018 05:53:22 +0100 (CET)", "from fmsmga001.fm.intel.com ([10.253.24.23])\n\tby fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t11 Feb 2018 20:53:22 -0800", "from dpdk51.sh.intel.com ([10.67.110.184])\n\tby fmsmga001.fm.intel.com with ESMTP; 11 Feb 2018 20:53:21 -0800" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "X-IronPort-AV": "E=Sophos;i=\"5.46,500,1511856000\"; d=\"scan'208\";a=\"30009471\"", "From": "Qi Zhang <qi.z.zhang@intel.com>", "To": "thomas@monjalon.net", "Cc": "dev@dpdk.org, jingjing.wu@intel.com, beilei.xing@intel.com,\n\tarybchenko@solarflare.com, konstantin.ananyev@intel.com,\n\tQi Zhang <qi.z.zhang@intel.com>", "Date": "Mon, 12 Feb 2018 12:53:11 +0800", "Message-Id": "<20180212045314.171616-2-qi.z.zhang@intel.com>", "X-Mailer": "git-send-email 2.13.6", "In-Reply-To": "<20180212045314.171616-1-qi.z.zhang@intel.com>", "References": "<20180212045314.171616-1-qi.z.zhang@intel.com>", "Subject": "[dpdk-dev] [PATCH 1/4] ether: support deferred queue setup", "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": "The patch let etherdev driver expose the capability flag through\nrte_eth_dev_info_get when it support deferred queue configuraiton,\nthen base on the flag rte_eth_[rx|tx]_queue_setup could decide\ncontinue to setup the queue or just return fail when device already\nstarted.\n\nSigned-off-by: Qi Zhang <qi.z.zhang@intel.com>\n---\n doc/guides/nics/features.rst | 8 ++++++++\n lib/librte_ether/rte_ethdev.c | 30 ++++++++++++++++++------------\n lib/librte_ether/rte_ethdev.h | 8 ++++++++\n 3 files changed, 34 insertions(+), 12 deletions(-)", "diff": "diff --git a/doc/guides/nics/features.rst b/doc/guides/nics/features.rst\nindex 1b4fb979f..36ad21a1f 100644\n--- a/doc/guides/nics/features.rst\n+++ b/doc/guides/nics/features.rst\n@@ -892,7 +892,15 @@ Documentation describes performance values.\n \n See ``dpdk.org/doc/perf/*``.\n \n+.. _nic_features_queue_deferred_setup_capabilities:\n \n+Queue deferred setup capabilities\n+---------------------------------\n+\n+Supports queue setup / release after device started.\n+\n+* **[provides] rte_eth_dev_info**: ``deferred_queue_config_capa:DEV_DEFERRED_RX_QUEUE_SETUP,DEV_DEFERRED_TX_QUEUE_SETUP,DEV_DEFERRED_RX_QUEUE_RELEASE,DEV_DEFERRED_TX_QUEUE_RELEASE``.\n+* **[related] API**: ``rte_eth_dev_info_get()``.\n \n .. _nic_features_other:\n \ndiff --git a/lib/librte_ether/rte_ethdev.c b/lib/librte_ether/rte_ethdev.c\nindex a6ce2a5ba..6c906c4df 100644\n--- a/lib/librte_ether/rte_ethdev.c\n+++ b/lib/librte_ether/rte_ethdev.c\n@@ -1425,12 +1425,6 @@ rte_eth_rx_queue_setup(uint16_t port_id, uint16_t rx_queue_id,\n \t\treturn -EINVAL;\n \t}\n \n-\tif (dev->data->dev_started) {\n-\t\tRTE_PMD_DEBUG_TRACE(\n-\t\t \"port %d must be stopped to allow configuration\\n\", port_id);\n-\t\treturn -EBUSY;\n-\t}\n-\n \tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);\n \tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_setup, -ENOTSUP);\n \n@@ -1474,10 +1468,19 @@ rte_eth_rx_queue_setup(uint16_t port_id, uint16_t rx_queue_id,\n \t\treturn -EINVAL;\n \t}\n \n+\tif (dev->data->dev_started &&\n+\t\t!(dev_info.deferred_queue_config_capa &\n+\t\t\tDEV_DEFERRED_RX_QUEUE_SETUP))\n+\t\treturn -EINVAL;\n+\n \trxq = dev->data->rx_queues;\n \tif (rxq[rx_queue_id]) {\n \t\tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->rx_queue_release,\n \t\t\t\t\t-ENOTSUP);\n+\t\tif (dev->data->dev_started &&\n+\t\t\t!(dev_info.deferred_queue_config_capa &\n+\t\t\t\tDEV_DEFERRED_RX_QUEUE_RELEASE))\n+\t\t\treturn -EINVAL;\n \t\t(*dev->dev_ops->rx_queue_release)(rxq[rx_queue_id]);\n \t\trxq[rx_queue_id] = NULL;\n \t}\n@@ -1573,12 +1576,6 @@ rte_eth_tx_queue_setup(uint16_t port_id, uint16_t tx_queue_id,\n \t\treturn -EINVAL;\n \t}\n \n-\tif (dev->data->dev_started) {\n-\t\tRTE_PMD_DEBUG_TRACE(\n-\t\t \"port %d must be stopped to allow configuration\\n\", port_id);\n-\t\treturn -EBUSY;\n-\t}\n-\n \tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP);\n \tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->tx_queue_setup, -ENOTSUP);\n \n@@ -1596,10 +1593,19 @@ rte_eth_tx_queue_setup(uint16_t port_id, uint16_t tx_queue_id,\n \t\treturn -EINVAL;\n \t}\n \n+\tif (dev->data->dev_started &&\n+\t\t!(dev_info.deferred_queue_config_capa &\n+\t\t\tDEV_DEFERRED_TX_QUEUE_SETUP))\n+\t\treturn -EINVAL;\n+\n \ttxq = dev->data->tx_queues;\n \tif (txq[tx_queue_id]) {\n \t\tRTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->tx_queue_release,\n \t\t\t\t\t-ENOTSUP);\n+\t\tif (dev->data->dev_started &&\n+\t\t\t!(dev_info.deferred_queue_config_capa &\n+\t\t\t\tDEV_DEFERRED_TX_QUEUE_RELEASE))\n+\t\t\treturn -EINVAL;\n \t\t(*dev->dev_ops->tx_queue_release)(txq[tx_queue_id]);\n \t\ttxq[tx_queue_id] = NULL;\n \t}\ndiff --git a/lib/librte_ether/rte_ethdev.h b/lib/librte_ether/rte_ethdev.h\nindex 036153306..6fc960c34 100644\n--- a/lib/librte_ether/rte_ethdev.h\n+++ b/lib/librte_ether/rte_ethdev.h\n@@ -981,6 +981,12 @@ struct rte_eth_conf {\n */\n #define DEV_TX_OFFLOAD_SECURITY 0x00020000\n \n+/** < Deferred queue setup / release capability */\n+#define DEV_DEFERRED_RX_QUEUE_SETUP 0x00000001\n+#define DEV_DEFERRED_TX_QUEUE_SETUP 0x00000002\n+#define DEV_DEFERRED_RX_QUEUE_RELEASE 0x00000004\n+#define DEV_DEFERRED_TX_QUEUE_RELEASE 0x00000008\n+\n /*\n * If new Tx offload capabilities are defined, they also must be\n * mentioned in rte_tx_offload_names in rte_ethdev.c file.\n@@ -1029,6 +1035,8 @@ struct rte_eth_dev_info {\n \t/** Configured number of rx/tx queues */\n \tuint16_t nb_rx_queues; /**< Number of RX queues. */\n \tuint16_t nb_tx_queues; /**< Number of TX queues. */\n+\tuint64_t deferred_queue_config_capa;\n+\t/**< a queue can be setup/release after dev_start */\n };\n \n /**\n", "prefixes": [ "dpdk-dev", "1/4" ] }