Patch Detail

HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 126258,
    "url": "https://patches.dpdk.org/api/patches/126258/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20230419095427.563185-1-sivaprasad.tummala@amd.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": "<20230419095427.563185-1-sivaprasad.tummala@amd.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230419095427.563185-1-sivaprasad.tummala@amd.com",
    "date": "2023-04-19T09:54:23",
    "name": "[RFC,1/5] eventdev: add power monitoring API on event port",
    "commit_ref": null,
    "pull_url": null,
    "state": "changes-requested",
    "archived": true,
    "hash": "3e4c7d75938beb78f2981a621b86f469565a3dad",
    "submitter": {
        "id": 2510,
        "url": "https://patches.dpdk.org/api/people/2510/?format=api",
        "name": "Sivaprasad Tummala",
        "email": "Sivaprasad.Tummala@amd.com"
    },
    "delegate": {
        "id": 310,
        "url": "https://patches.dpdk.org/api/users/310/?format=api",
        "username": "jerin",
        "first_name": "Jerin",
        "last_name": "Jacob",
        "email": "jerinj@marvell.com"
    },
    "mbox": "https://patches.dpdk.org/project/dpdk/patch/20230419095427.563185-1-sivaprasad.tummala@amd.com/mbox/",
    "series": [
        {
            "id": 27776,
            "url": "https://patches.dpdk.org/api/series/27776/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=27776",
            "date": "2023-04-19T09:54:23",
            "name": "[RFC,1/5] eventdev: add power monitoring API on event port",
            "version": 1,
            "mbox": "https://patches.dpdk.org/series/27776/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/126258/comments/",
    "check": "success",
    "checks": "https://patches.dpdk.org/api/patches/126258/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 3C14242987;\n\tWed, 19 Apr 2023 11:54:44 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id BDCB940A79;\n\tWed, 19 Apr 2023 11:54:43 +0200 (CEST)",
            "from NAM12-BN8-obe.outbound.protection.outlook.com\n (mail-bn8nam12on2041.outbound.protection.outlook.com [40.107.237.41])\n by mails.dpdk.org (Postfix) with ESMTP id AC0BE4021F\n for <dev@dpdk.org>; Wed, 19 Apr 2023 11:54:42 +0200 (CEST)",
            "from DS7PR03CA0143.namprd03.prod.outlook.com (2603:10b6:5:3b4::28)\n by LV2PR12MB5989.namprd12.prod.outlook.com (2603:10b6:408:171::20) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6298.30; Wed, 19 Apr\n 2023 09:54:41 +0000",
            "from DM6NAM11FT004.eop-nam11.prod.protection.outlook.com\n (2603:10b6:5:3b4:cafe::5a) by DS7PR03CA0143.outlook.office365.com\n (2603:10b6:5:3b4::28) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6319.22 via Frontend\n Transport; Wed, 19 Apr 2023 09:54:40 +0000",
            "from SATLEXMB04.amd.com (165.204.84.17) by\n DM6NAM11FT004.mail.protection.outlook.com (10.13.172.217) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id\n 15.20.6319.22 via Frontend Transport; Wed, 19 Apr 2023 09:54:40 +0000",
            "from telco-siena.amd.com (10.180.168.240) by SATLEXMB04.amd.com\n (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Wed, 19 Apr\n 2023 04:54:39 -0500"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=Fh3VIIBEAVYYygBKR7HBpXvUOFG0WDAyfI3Rr8i/1Qnj9IdKHTwQhfHW2++GxxOkDgCqclQaub/upe4mlPXCao3ojAVbZlJmvR/3QgTaGmWmHycpoMNLNGArI91PXI8ilF9wWL5B8uV8IAKgYPb4yf2GEIlJIhW3KKjVvEDZsL9+dqJteaiAtW4/KH9jKECjYU1SFBgTBNsLX5qJAUPVvkuav2JGwcSxNlmVOlaThO9tgwKd/RY1gfNMWJnV9D+r9gF0E+oYEig8fA4WhEHrApBqKWUjSzXCCNMuuMj+5hW7z8YUGFwPimkO4lmGwKLbyfDCcYeD7Vntn6GxRwsXWg==",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=6CmSDcrY6NIaCs2aKbxVGTxT8ciFBxyTJJuRRzNY2OI=;\n b=SHJeb+xVWrdCQsJ8ozhfsSUgKN6cBoB8Ehhl49YWer2X3Q85KT0f8AlXFuMpkWT0r87D+VZcWWZ3M60iMmfNh0kf72gMx/gFKbeSaYJfzfxKZXE0jTQkmEqzqk1AiBOX35QSJocn8u3GAl9oW/Hh7InNJbRYsrdsbsJstOAlufdBFbJG253mHWj3PYf+bztKIly3n+TL8j4+p8zhV5NhX5ypf3e+vZcP4MtT3uQDihulvB0ijfutk+TGHsnxGAjuuTwVTrpNQUd/TQO8WsX/LJD2hQy/5JruRjCNm0YjEmzcispkP0A1fst0IFZuRfu/gaUUd8x0hMQAn105a2R0tQ==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 165.204.84.17) smtp.rcpttodomain=intel.com smtp.mailfrom=amd.com; dmarc=pass\n (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com;\n dkim=none (message not signed); arc=none",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=6CmSDcrY6NIaCs2aKbxVGTxT8ciFBxyTJJuRRzNY2OI=;\n b=SWFXipedW5/gf3vSpXoh9GlFF9HNftGh7ine41Hbw03/jE6BMC2EQHmHlhkmqMyIFegP6+BzHPBakIOX/zkMMaeFxhutAzi7tz7sd31e0vg50X+kBUNgw2hCB5RPeVgClOC2ZzNSczM7b3mOgDymQuz9FNrnm5JZlMuMbwVWiOU=",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 165.204.84.17)\n smtp.mailfrom=amd.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=amd.com;",
        "Received-SPF": "Pass (protection.outlook.com: domain of amd.com designates\n 165.204.84.17 as permitted sender) receiver=protection.outlook.com;\n client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C",
        "From": "Sivaprasad Tummala <sivaprasad.tummala@amd.com>",
        "To": "<david.hunt@intel.com>, <jerinj@marvell.com>, <harry.van.haaren@intel.com>",
        "CC": "<dev@dpdk.org>",
        "Subject": "[RFC PATCH 1/5] eventdev: add power monitoring API on event port",
        "Date": "Wed, 19 Apr 2023 02:54:23 -0700",
        "Message-ID": "<20230419095427.563185-1-sivaprasad.tummala@amd.com>",
        "X-Mailer": "git-send-email 2.34.1",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[10.180.168.240]",
        "X-ClientProxiedBy": "SATLEXMB04.amd.com (10.181.40.145) To SATLEXMB04.amd.com\n (10.181.40.145)",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-TrafficTypeDiagnostic": "DM6NAM11FT004:EE_|LV2PR12MB5989:EE_",
        "X-MS-Office365-Filtering-Correlation-Id": "34882e7d-882d-4600-5735-08db40bc180e",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n pzhCY7h9SBKwzn3CTuV9K4hw6cXV1l6tZ1P0Wbp/s/7KaSwHQq2K7swQ6z2Vgp1x1MhfrECnXlK5Nq9VOnkZdIGqPAuU5MYNsIZXs/pCt0iow7fr0my1mlpT7VSlSgrYbWU6R6pQ1dc3IUwmrbjfDS+KakZuvZsk7+kwmCvPbIaICGW5b9SHR6Mz9GKh8QhnYIExhv6EgwwjfSFWOXFiQUbgpfhH0FZuKXQD04ZttZHDRbD7UbTJQE58CqikdZYt7G9z5IRxippGS4LqZEkrTWL6WcEUiu1ZxRt9/lJxz0SMSU2QjiU5CXdl21GU1Sm+lWDcZrNjC0b1XsOARHRcbGDb76LF3yvGHB0SHkm5y/dTefkyiaTSYCUnRmBq3weLMTyW82zi1KW0q636TEbKF8owOAYRVKh12M0Rr4HqdY0ftp05FnZnc32+U6VRlaGO3qeeaCfieJWAFSNoneb48t9bbgzItxL3vRf7o8DWDCezBQHZAGmY+BnIH+D6xcdn/wwyYLe3Zbu13CCMOKo3kKImAlm3dI1DsjQhXD+6DZHsu+JyKzSRnd8PsOmOfYn4rp/GoD3yI/lj1fAogYFd1dd0Z/8tIFwBw9eRIXSQLDzm8aVggZHC3AoShG65kNmoqbqUBupZhsPaCUqDUNuSJZLYMjkeKYHNVa1gn97H+qOcv5GLw6cp0UeuCEWUU1dwd91lsRTMoW2yUXes4PEqHTLV0uoOu1eCFCztG6CEgHc=",
        "X-Forefront-Antispam-Report": "CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:SATLEXMB04.amd.com; PTR:InfoDomainNonexistent; CAT:NONE;\n SFS:(13230028)(4636009)(346002)(136003)(376002)(396003)(39860400002)(451199021)(36840700001)(46966006)(40470700004)(5660300002)(7696005)(40460700003)(478600001)(2906002)(4326008)(70206006)(70586007)(36756003)(44832011)(86362001)(8936002)(81166007)(41300700001)(6666004)(82740400003)(316002)(356005)(82310400005)(8676002)(40480700001)(110136005)(1076003)(26005)(336012)(426003)(36860700001)(16526019)(2616005)(47076005)(186003)(83380400001)(36900700001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "amd.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "19 Apr 2023 09:54:40.3898 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 34882e7d-882d-4600-5735-08db40bc180e",
        "X-MS-Exchange-CrossTenant-Id": "3dd8961f-e488-4e60-8e11-a82d994e183d",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17];\n Helo=[SATLEXMB04.amd.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n DM6NAM11FT004.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "LV2PR12MB5989",
        "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": "A new API to allow power monitoring condition on event port to\noptimize power when no events are arriving on an event port for\nthe worker core to process in an eventdev based pipelined application.\n\nSigned-off-by: Sivaprasad Tummala <sivaprasad.tummala@amd.com>\n---\n lib/eventdev/eventdev_pmd.h | 23 +++++++++++++++++++++++\n lib/eventdev/rte_eventdev.c | 24 ++++++++++++++++++++++++\n lib/eventdev/rte_eventdev.h | 25 +++++++++++++++++++++++++\n 3 files changed, 72 insertions(+)",
    "diff": "diff --git a/lib/eventdev/eventdev_pmd.h b/lib/eventdev/eventdev_pmd.h\nindex aebab26852..7b12f80f57 100644\n--- a/lib/eventdev/eventdev_pmd.h\n+++ b/lib/eventdev/eventdev_pmd.h\n@@ -481,6 +481,26 @@ typedef int (*eventdev_port_unlink_t)(struct rte_eventdev *dev, void *port,\n typedef int (*eventdev_port_unlinks_in_progress_t)(struct rte_eventdev *dev,\n \t\tvoid *port);\n \n+/**\n+ * @internal\n+ * Get address of memory location whose contents will change whenever there is\n+ * new data to be received on an Event port.\n+ *\n+ * @param port\n+ *   Eventdev port pointer.\n+ * @param pmc\n+ *   The pointer to power-optimized monitoring condition structure.\n+ * @return\n+ *   Negative errno value on error, 0 on success.\n+ *\n+ * @retval 0\n+ *   Success\n+ * @retval -EINVAL\n+ *   Invalid parameters\n+ */\n+typedef int (*event_get_monitor_addr_t)(void *port,\n+\t\tstruct rte_power_monitor_cond *pmc);\n+\n /**\n  * Converts nanoseconds to *timeout_ticks* value for rte_event_dequeue()\n  *\n@@ -1376,6 +1396,9 @@ struct eventdev_ops {\n \teventdev_dump_t dump;\n \t/* Dump internal information */\n \n+\t/** Get power monitoring condition for event port */\n+\tevent_get_monitor_addr_t get_monitor_addr;\n+\n \teventdev_xstats_get_t xstats_get;\n \t/**< Get extended device statistics. */\n \teventdev_xstats_get_names_t xstats_get_names;\ndiff --git a/lib/eventdev/rte_eventdev.c b/lib/eventdev/rte_eventdev.c\nindex 6ab4524332..ff77194783 100644\n--- a/lib/eventdev/rte_eventdev.c\n+++ b/lib/eventdev/rte_eventdev.c\n@@ -860,6 +860,30 @@ rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id,\n \treturn 0;\n }\n \n+int\n+rte_event_port_get_monitor_addr(uint8_t dev_id, uint8_t port_id,\n+\t\tstruct rte_power_monitor_cond *pmc)\n+{\n+\tstruct rte_eventdev *dev;\n+\n+\tRTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);\n+\tdev = &rte_eventdevs[dev_id];\n+\tif (!is_valid_port(dev, port_id)) {\n+\t\tRTE_EDEV_LOG_ERR(\"Invalid port_id=%\" PRIu8, port_id);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tif (pmc == NULL) {\n+\t\tRTE_EDEV_LOG_ERR(\"devid %u port %u power monitor condition is NULL\\n\",\n+\t\t\t\tdev_id, port_id);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tif (*dev->dev_ops->get_monitor_addr == NULL)\n+\t\treturn -ENOTSUP;\n+\treturn (*dev->dev_ops->get_monitor_addr)(dev->data->ports[port_id], pmc);\n+}\n+\n int\n rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id,\n \t\t\tuint32_t *attr_value)\ndiff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h\nindex a90e23ac8b..841b1fb9b5 100644\n--- a/lib/eventdev/rte_eventdev.h\n+++ b/lib/eventdev/rte_eventdev.h\n@@ -215,6 +215,7 @@ extern \"C\" {\n #include <rte_errno.h>\n #include <rte_mbuf_pool_ops.h>\n #include <rte_mempool.h>\n+#include <rte_power_intrinsics.h>\n \n #include \"rte_eventdev_trace_fp.h\"\n \n@@ -984,6 +985,30 @@ int\n rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id,\n \t\t\tuint32_t *attr_value);\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Retrieve the monitor condition for a given event port.\n+ *\n+ * @param dev_id\n+ *   Eventdev id\n+ * @param port_id\n+ *   Eventdev port id\n+ * @param pmc\n+ *   The pointer to power-optimized monitoring condition structure.\n+ *\n+ * @return\n+ *   - 0: Success.\n+ *   -ENOTSUP: Operation not supported.\n+ *   -EINVAL: Invalid parameters.\n+ *   -ENODEV: Invalid device ID.\n+ */\n+__rte_experimental\n+int\n+rte_event_port_get_monitor_addr(uint8_t dev_id, uint8_t port_id,\n+\t\tstruct rte_power_monitor_cond *pmc);\n+\n /**\n  * Start an event device.\n  *\n",
    "prefixes": [
        "RFC",
        "1/5"
    ]
}