Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/136324/?format=api
{ "id": 136324, "url": "http://patches.dpdk.org/api/patches/136324/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20240202123953.77166-6-bruce.richardson@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": "<20240202123953.77166-6-bruce.richardson@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20240202123953.77166-6-bruce.richardson@intel.com", "date": "2024-02-02T12:39:47", "name": "[v3,05/11] eventdev: improve function documentation for query fns", "commit_ref": null, "pull_url": null, "state": "changes-requested", "archived": true, "hash": "ecec5898520c4b5f88266a833745db640dcb2de7", "submitter": { "id": 20, "url": "http://patches.dpdk.org/api/people/20/?format=api", "name": "Bruce Richardson", "email": "bruce.richardson@intel.com" }, "delegate": { "id": 310, "url": "http://patches.dpdk.org/api/users/310/?format=api", "username": "jerin", "first_name": "Jerin", "last_name": "Jacob", "email": "jerinj@marvell.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20240202123953.77166-6-bruce.richardson@intel.com/mbox/", "series": [ { "id": 30988, "url": "http://patches.dpdk.org/api/series/30988/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30988", "date": "2024-02-02T12:39:42", "name": "improve eventdev API specification/documentation", "version": 3, "mbox": "http://patches.dpdk.org/series/30988/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/136324/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/136324/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 72AAB43A4F;\n\tFri, 2 Feb 2024 13:41:02 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 69DD442E84;\n\tFri, 2 Feb 2024 13:40:50 +0100 (CET)", "from mgamail.intel.com (mgamail.intel.com [192.198.163.18])\n by mails.dpdk.org (Postfix) with ESMTP id 0EB2D42E50\n for <dev@dpdk.org>; Fri, 2 Feb 2024 13:40:46 +0100 (CET)", "from fmviesa006.fm.intel.com ([10.60.135.146])\n by fmvoesa112.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 02 Feb 2024 04:40:44 -0800", "from silpixa00401385.ir.intel.com ([10.237.214.38])\n by fmviesa006.fm.intel.com with ESMTP; 02 Feb 2024 04:40:40 -0800" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1706877647; x=1738413647;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=i8OwGytzddBIU9b3SWNszKNUjectXoAlnrfUBjrMvmM=;\n b=X+mWhS1PuUdWzf9INfMwV//aqJ1WpHa5yOppfZFvXwBNBfLOVUacc/6G\n 5HtPwjoLGUavnIM5/bLoF/CTp4KX2h8dxobcI5sbigAH1kB1pbj6T5V96\n +0iMVjHcLRMSjoHHYzYptSyaUWT1QlVa/i4LhyInuUGIJB2EW0hbjBDaB\n uHREzd7LY5sqE49f+GYCac7uN2Dnj3mC1E1Q3M/zpFnYkF4Msm+sJebAf\n tyl1oBQb0hApFs4Zj5EUOCbDrbJ29Q2jYtJHJOe2dEvb5E3nBxp/PxL27\n xgKCBYYe+tu6ueZV0Vb8W9KLj52+GEn+bBD5JaOA/SSZKx26SKpyFKxQP A==;", "X-IronPort-AV": [ "E=McAfee;i=\"6600,9927,10971\"; a=\"54378\"", "E=Sophos;i=\"6.05,238,1701158400\";\n d=\"scan'208\";a=\"54378\"", "E=Sophos;i=\"6.05,238,1701158400\";\n d=\"scan'208\";a=\"347593\"" ], "X-ExtLoop1": "1", "From": "Bruce Richardson <bruce.richardson@intel.com>", "To": "dev@dpdk.org,\n\tjerinj@marvell.com,\n\tmattias.ronnblom@ericsson.com", "Cc": "abdullah.sevincer@intel.com, sachin.saxena@oss.nxp.com,\n hemant.agrawal@nxp.com, pbhagavatula@marvell.com, pravin.pathak@intel.com,\n Bruce Richardson <bruce.richardson@intel.com>", "Subject": "[PATCH v3 05/11] eventdev: improve function documentation for query\n fns", "Date": "Fri, 2 Feb 2024 12:39:47 +0000", "Message-Id": "<20240202123953.77166-6-bruce.richardson@intel.com>", "X-Mailer": "git-send-email 2.40.1", "In-Reply-To": "<20240202123953.77166-1-bruce.richardson@intel.com>", "References": "<20240119174346.108905-1-bruce.richardson@intel.com>\n <20240202123953.77166-1-bruce.richardson@intel.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "General improvements to the doxygen docs for eventdev functions for\nquerying basic information:\n* number of devices\n* id for a particular device\n* socket id of device\n* capability information for a device\n\nSigned-off-by: Bruce Richardson <bruce.richardson@intel.com>\n\n---\nV3: minor changes following review\n---\n lib/eventdev/rte_eventdev.h | 22 +++++++++++++---------\n 1 file changed, 13 insertions(+), 9 deletions(-)", "diff": "diff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h\nindex da3f72d89e..3cba13e2c4 100644\n--- a/lib/eventdev/rte_eventdev.h\n+++ b/lib/eventdev/rte_eventdev.h\n@@ -448,8 +448,7 @@ struct rte_event;\n */\n \n /**\n- * Get the total number of event devices that have been successfully\n- * initialised.\n+ * Get the total number of event devices.\n *\n * @return\n * The total number of usable event devices.\n@@ -464,8 +463,10 @@ rte_event_dev_count(void);\n * Event device name to select the event device identifier.\n *\n * @return\n- * Returns event device identifier on success.\n- * - <0: Failure to find named event device.\n+ * Event device identifier (dev_id >= 0) on success.\n+ * Negative error code on failure:\n+ * - -EINVAL - input name parameter is invalid.\n+ * - -ENODEV - no event device found with that name.\n */\n int\n rte_event_dev_get_dev_id(const char *name);\n@@ -478,7 +479,8 @@ rte_event_dev_get_dev_id(const char *name);\n * @return\n * The NUMA socket id to which the device is connected or\n * a default of zero if the socket could not be determined.\n- * -(-EINVAL) dev_id value is out of range.\n+ * -EINVAL on error, where the given dev_id value does not\n+ * correspond to any event device.\n */\n int\n rte_event_dev_socket_id(uint8_t dev_id);\n@@ -574,18 +576,20 @@ struct rte_event_dev_info {\n };\n \n /**\n- * Retrieve the contextual information of an event device.\n+ * Retrieve details of an event device's capabilities and configuration limits.\n *\n * @param dev_id\n * The identifier of the device.\n *\n * @param[out] dev_info\n * A pointer to a structure of type *rte_event_dev_info* to be filled with the\n- * contextual information of the device.\n+ * information about the device's capabilities.\n *\n * @return\n- * - 0: Success, driver updates the contextual information of the event device\n- * - <0: Error code returned by the driver info get function.\n+ * - 0: Success, information about the event device is present in dev_info.\n+ * - <0: Failure, error code returned by the function.\n+ * - -EINVAL - invalid input parameters, e.g. incorrect device id.\n+ * - -ENOTSUP - device does not support returning capabilities information.\n */\n int\n rte_event_dev_info_get(uint8_t dev_id, struct rte_event_dev_info *dev_info);\n", "prefixes": [ "v3", "05/11" ] }