Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/44990/?format=api
{ "id": 44990, "url": "https://patches.dpdk.org/api/patches/44990/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20180920045959.106252-1-qi.z.zhang@intel.com/", "project": { "id": 1, "url": "https://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": "<20180920045959.106252-1-qi.z.zhang@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20180920045959.106252-1-qi.z.zhang@intel.com", "date": "2018-09-20T04:59:59", "name": "[v2] doc: update API deprecation for device reset", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "e07b2ed0c756f1bdeb1c31f6d9ab002cbd0b7ed7", "submitter": { "id": 504, "url": "https://patches.dpdk.org/api/people/504/?format=api", "name": "Qi Zhang", "email": "qi.z.zhang@intel.com" }, "delegate": { "id": 1, "url": "https://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/20180920045959.106252-1-qi.z.zhang@intel.com/mbox/", "series": [ { "id": 1406, "url": "https://patches.dpdk.org/api/series/1406/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=1406", "date": "2018-09-20T04:59:59", "name": "[v2] doc: update API deprecation for device reset", "version": 2, "mbox": "https://patches.dpdk.org/series/1406/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/44990/comments/", "check": "success", "checks": "https://patches.dpdk.org/api/patches/44990/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 353D35A44;\n\tThu, 20 Sep 2018 06:59:04 +0200 (CEST)", "from mga09.intel.com (mga09.intel.com [134.134.136.24])\n\tby dpdk.org (Postfix) with ESMTP id 8545356A3\n\tfor <dev@dpdk.org>; Thu, 20 Sep 2018 06:59:02 +0200 (CEST)", "from fmsmga005.fm.intel.com ([10.253.24.32])\n\tby orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t19 Sep 2018 21:59:01 -0700", "from dpdk51.sh.intel.com ([10.67.110.190])\n\tby fmsmga005.fm.intel.com with ESMTP; 19 Sep 2018 21:58:59 -0700" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "X-IronPort-AV": "E=Sophos;i=\"5.53,397,1531810800\"; d=\"scan'208\";a=\"264159364\"", "From": "Qi Zhang <qi.z.zhang@intel.com>", "To": "thomas@monjalon.net,\n\tdeclan.doherty@intel.com,\n\tferruh.yigit@intel.com", "Cc": "ktraynor@redhat.com, dev@dpdk.org, benjamin.h.shelton@intel.com,\n\tnarender.vangati@intel.com, Qi Zhang <qi.z.zhang@intel.com>", "Date": "Thu, 20 Sep 2018 12:59:59 +0800", "Message-Id": "<20180920045959.106252-1-qi.z.zhang@intel.com>", "X-Mailer": "git-send-email 2.13.6", "Subject": "[dpdk-dev] [PATCH v2] doc: update API deprecation for device reset", "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://mails.dpdk.org/options/dev>,\n\t<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\t<mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Device reset may have the dependency, for example, a VF reset expects\nPF ready, or a NIC function as a part of a SOC need to wait for other\nparts of the system be ready, these are time-consuming tasks and will\nblock current thread.\n\nSo we rename rte_eth_dev_reset to rte_eth_dev_reset_async as an async\nAPI, that makes things easy for an application that what to reset the\ndevice from the interrupt thread since typically a\nRTE_ETH_EVENT_INTR_RESET handler is invoked in interrupt thread.\n\nRFC patch:\nhttp://patchwork.dpdk.org/patch/44989/\n\nSigned-off-by: Qi Zhang <qi.z.zhang@intel.com>\n---\n\nv2:\n- rename rte_eth_dev_reset to rte_eth_dev_reset_async\n\n\n doc/guides/rel_notes/deprecation.rst | 6 ++++++\n 1 file changed, 6 insertions(+)", "diff": "diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst\nindex bade1e4c4..c8dd6522e 100644\n--- a/doc/guides/rel_notes/deprecation.rst\n+++ b/doc/guides/rel_notes/deprecation.rst\n@@ -95,3 +95,9 @@ Deprecation Notices\n - ``rte_pdump_set_socket_dir`` will be removed;\n - The parameter, ``path``, of ``rte_pdump_init`` will be removed;\n - The enum ``rte_pdump_socktype`` will be removed.\n+\n+* ethdev: In v19.02 ``rte_eth_dev_reset`` is renamed to\n+ ``rte_eth_dev_reset_async``. As the name, it is an async API.\n+ Application should not assume device reset is finished after\n+ ``rte_eth_dev_reset_async`` return, it should always wait for a\n+ RTE_ETH_EVENT_RESET_COMPLETE event and check the reset result.\n", "prefixes": [ "v2" ] }