Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/133431/?format=api
{ "id": 133431, "url": "http://patches.dpdk.org/api/patches/133431/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20231026142749.1174372-2-thomas@monjalon.net/", "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": "<20231026142749.1174372-2-thomas@monjalon.net>", "list_archive_url": "https://inbox.dpdk.org/dev/20231026142749.1174372-2-thomas@monjalon.net", "date": "2023-10-26T14:19:36", "name": "[v5,1/2] eal: add thread yield functions", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "74a7a9af497418a1229ea350e4bbb30a211fe0d5", "submitter": { "id": 685, "url": "http://patches.dpdk.org/api/people/685/?format=api", "name": "Thomas Monjalon", "email": "thomas@monjalon.net" }, "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/20231026142749.1174372-2-thomas@monjalon.net/mbox/", "series": [ { "id": 30007, "url": "http://patches.dpdk.org/api/series/30007/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30007", "date": "2023-10-26T14:19:35", "name": "allow creating thread with real-time priority", "version": 5, "mbox": "http://patches.dpdk.org/series/30007/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/133431/comments/", "check": "success", "checks": "http://patches.dpdk.org/api/patches/133431/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 F0CE243209;\n\tThu, 26 Oct 2023 16:28:00 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id C96F8402B5;\n\tThu, 26 Oct 2023 16:27:57 +0200 (CEST)", "from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com\n [66.111.4.29]) by mails.dpdk.org (Postfix) with ESMTP id CE60C42DE9\n for <dev@dpdk.org>; Thu, 26 Oct 2023 16:27:56 +0200 (CEST)", "from compute5.internal (compute5.nyi.internal [10.202.2.45])\n by mailout.nyi.internal (Postfix) with ESMTP id 763875C011A;\n Thu, 26 Oct 2023 10:27:56 -0400 (EDT)", "from mailfrontend2 ([10.202.2.163])\n by compute5.internal (MEProxy); Thu, 26 Oct 2023 10:27:56 -0400", "by mail.messagingengine.com (Postfix) with ESMTPA; Thu,\n 26 Oct 2023 10:27:54 -0400 (EDT)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=\n cc:cc:content-transfer-encoding:content-type:date:date:from:from\n :in-reply-to:in-reply-to:message-id:mime-version:references\n :reply-to:sender:subject:subject:to:to; s=fm3; t=1698330476; x=\n 1698416876; bh=3eup8/dMvX2jlj9mkuIghKYFnKATsplc8kPYcpStj/E=; b=m\n 4PERNgWBSJousPXx5bHn1LzGL+IostKu4ru7jHWkow+i7IAsOCVqROCEU089S4PW\n 2Ebd1c7CVuK9Dojk1DTxHLeB/RwikNEsjpiWVTfa2w+s1qlicddgEXYzlPTETggo\n eF3eQyuVLjcUrOkydvV+E9Rf4DsiKwInh3f695ORUfgHktBrr21MXoxhEfIjfBKW\n l0/f+jJG3/mzMsxppdwefDMIQz37hj7kwoBRM/y29Qihiy2LGUx2HZN/MaTPoj07\n L1Ae6WficEt87RRhtD/1Q2KSzX7SxzrMMdgoeuOkt8177QFvkdOaRy5ITQigL48B\n avDfS4Ypl2BtKLIdRAJjg==", "v=1; a=rsa-sha256; c=relaxed/relaxed; d=\n messagingengine.com; h=cc:cc:content-transfer-encoding\n :content-type:date:date:feedback-id:feedback-id:from:from\n :in-reply-to:in-reply-to:message-id:mime-version:references\n :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy\n :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1698330476; x=\n 1698416876; bh=3eup8/dMvX2jlj9mkuIghKYFnKATsplc8kPYcpStj/E=; b=m\n Gr3LpVzmI39Etq8zMRfX2ORMH2i4AnV9PLNdu+63GuPp74r5MkM7lp+OcSOx7JTC\n efBW521j0vhVqKJIvwAeZnFp69/CyTl8GNKH17tvHQvuBUQlBRBUj0cNV1vdW9jQ\n Edxruxyw79MXIg3IPvxnPYqhSQmltJEyg7FoKvxbivfTBez0GBPAD8RdMXeGW8TY\n 3THSato8ErZtt4yGjrTA3SwE7bL9WQipVqWjkL8RkV0Z8BygO/mVmcEFqznrPIxz\n DknxwXKKSpsnXxZY3Di3HBR8vh1ZztUeiqSxSuU053FPXmQP4l31IvTV8YTRHGfD\n 8ptkUxzIHPMOPn31iRevA==" ], "X-ME-Sender": "<xms:a3c6ZZkVVATxFroaK0rLEP_-lcFkiCgg2Cv17as6U-ma34gllCrEvg>\n <xme:a3c6ZU3ENkKRSp5es839p9hOKwUY2BQvzBcHgcWB4O20621HuVGJ5jps-ZRVXLPrt\n sFyI3SEiK4HHPFSEA>", "X-ME-Received": "\n <xmr:a3c6ZfoaCxoWJ9LOXCQTLUu4nXKXv_QjBYpOHoPphecIMUfT27LPrlJO2UVjKuMfNhfb7TQgPUPG3WMzmswraYxWhLRF1Qg>", "X-ME-Proxy-Cause": "\n gggruggvucftvghtrhhoucdtuddrgedvkedrledvgdejjecutefuodetggdotefrodftvf\n curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu\n uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc\n fjughrpefhvfevufffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgr\n shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg\n ftrfgrthhtvghrnhepvdejhfdugeehvddtieejieegteeuudfgjeeukeeiledthfetveek\n hefhieelhfdtnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrh\n homhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgvth", "X-ME-Proxy": "<xmx:a3c6ZZmEUgBlPbdFc2TO17OlS4ctVFuyxOt9jfiX6pEOYpuDPtB1YA>\n <xmx:a3c6ZX2vk233QQJw12hMp2JDIIUC5rYT9yha6CN0dLr8ll_bgdrQOQ>\n <xmx:a3c6ZYuirgW2lOB2REc889n7rAt8uNmZksp9HvQ9O3yo0Cr-28EOoQ>\n <xmx:bHc6ZSS5vXDuvmsC7oXQizHaORHTOS6j2ITGcAywr3sVhE07elspNg>", "Feedback-ID": "i47234305:Fastmail", "From": "Thomas Monjalon <thomas@monjalon.net>", "To": "dev@dpdk.org", "Cc": "David Marchand <david.marchand@redhat.com>,\n Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>,\n Narcisa Ana Maria Vasile <navasile@linux.microsoft.com>,\n Dmitry Malloy <dmitrym@microsoft.com>,\n Pallavi Kadam <pallavi.kadam@intel.com>", "Subject": "[PATCH v5 1/2] eal: add thread yield functions", "Date": "Thu, 26 Oct 2023 16:19:36 +0200", "Message-ID": "<20231026142749.1174372-2-thomas@monjalon.net>", "X-Mailer": "git-send-email 2.42.0", "In-Reply-To": "<20231026142749.1174372-1-thomas@monjalon.net>", "References": "<20231024125416.798897-1-thomas@monjalon.net>\n <20231026142749.1174372-1-thomas@monjalon.net>", "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": "When running real-time threads, we may need to force scheduling\nkernel threads or other real-time threads.\nNew functions are added to address these cases.\n\nThe yield functions should not have any interest for normal threads.\nNote: other purposes may be addressed with rte_pause() or rte_delay_*().\n\nSigned-off-by: Thomas Monjalon <thomas@monjalon.net>\n---\n lib/eal/include/rte_thread.h | 25 +++++++++++++++++++++++++\n lib/eal/unix/rte_thread.c | 16 ++++++++++++++++\n lib/eal/version.map | 4 ++++\n lib/eal/windows/rte_thread.c | 15 +++++++++++++++\n 4 files changed, 60 insertions(+)", "diff": "diff --git a/lib/eal/include/rte_thread.h b/lib/eal/include/rte_thread.h\nindex 8da9d4d3fb..f2581fe152 100644\n--- a/lib/eal/include/rte_thread.h\n+++ b/lib/eal/include/rte_thread.h\n@@ -183,6 +183,31 @@ int rte_thread_join(rte_thread_t thread_id, uint32_t *value_ptr);\n */\n int rte_thread_detach(rte_thread_t thread_id);\n \n+/**\n+ * Allow another thread to run on the same CPU core.\n+ *\n+ * This is a scheduler request, with minimum latency.\n+ * Lower priority threads may not be scheduled.\n+ *\n+ * Especially useful in real-time thread priority\n+ * to schedule other real-time threads.\n+ * @see RTE_THREAD_PRIORITY_REALTIME_CRITICAL\n+ */\n+__rte_experimental\n+void rte_thread_yield(void);\n+\n+/**\n+ * Unblock a CPU core running busy in a real-time thread.\n+ *\n+ * This is a sleep call, giving priority to all other threads.\n+ *\n+ * Especially useful in real-time thread priority\n+ * to avoid a busy loop blocking vital threads on a core.\n+ * @see RTE_THREAD_PRIORITY_REALTIME_CRITICAL\n+ */\n+__rte_experimental\n+void rte_thread_yield_realtime(void);\n+\n /**\n * Get the id of the calling thread.\n *\ndiff --git a/lib/eal/unix/rte_thread.c b/lib/eal/unix/rte_thread.c\nindex 36a21ab2f9..278d8d342d 100644\n--- a/lib/eal/unix/rte_thread.c\n+++ b/lib/eal/unix/rte_thread.c\n@@ -5,9 +5,11 @@\n \n #include <errno.h>\n #include <pthread.h>\n+#include <sched.h>\n #include <stdbool.h>\n #include <stdlib.h>\n #include <string.h>\n+#include <time.h>\n \n #include <rte_errno.h>\n #include <rte_log.h>\n@@ -227,6 +229,20 @@ rte_thread_detach(rte_thread_t thread_id)\n \treturn pthread_detach((pthread_t)thread_id.opaque_id);\n }\n \n+void\n+rte_thread_yield(void)\n+{\n+\tsched_yield();\n+}\n+\n+void\n+rte_thread_yield_realtime(void)\n+{\n+\t/* A simple yield may not be enough to schedule kernel threads. */\n+\tstruct timespec wait = {.tv_nsec = 1000000}; /* 1 ms */\n+\tnanosleep(&wait, NULL);\n+}\n+\n int\n rte_thread_equal(rte_thread_t t1, rte_thread_t t2)\n {\ndiff --git a/lib/eal/version.map b/lib/eal/version.map\nindex e00a844805..b81ac3e3af 100644\n--- a/lib/eal/version.map\n+++ b/lib/eal/version.map\n@@ -413,6 +413,10 @@ EXPERIMENTAL {\n \t# added in 23.07\n \trte_memzone_max_get;\n \trte_memzone_max_set;\n+\n+\t# added in 23.11\n+\trte_thread_yield;\n+\trte_thread_yield_realtime;\n };\n \n INTERNAL {\ndiff --git a/lib/eal/windows/rte_thread.c b/lib/eal/windows/rte_thread.c\nindex acf648456c..ea17b5de3d 100644\n--- a/lib/eal/windows/rte_thread.c\n+++ b/lib/eal/windows/rte_thread.c\n@@ -304,6 +304,21 @@ rte_thread_detach(rte_thread_t thread_id)\n \treturn 0;\n }\n \n+void\n+rte_thread_yield(void)\n+{\n+\tSwitchToThread();\n+}\n+\n+void\n+rte_thread_yield_realtime(void)\n+{\n+\t/* Real-time threads are not causing problems on Windows.\n+\t * A simple sleep should be more than enough.\n+\t */\n+\tSleep(0);\n+}\n+\n int\n rte_thread_equal(rte_thread_t t1, rte_thread_t t2)\n {\n", "prefixes": [ "v5", "1/2" ] }