get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/133429/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 133429,
    "url": "http://patches.dpdk.org/api/patches/133429/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20231026142135.19967-5-shaibran@amazon.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": "<20231026142135.19967-5-shaibran@amazon.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20231026142135.19967-5-shaibran@amazon.com",
    "date": "2023-10-26T14:21:34",
    "name": "[v3,4/5] net/ena: add support for ena-express metrics",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": true,
    "hash": "735414a1fd18d3d5a831ee9f75ab1c1b25c647ca",
    "submitter": {
        "id": 2930,
        "url": "http://patches.dpdk.org/api/people/2930/?format=api",
        "name": "Brandes, Shai",
        "email": "shaibran@amazon.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/20231026142135.19967-5-shaibran@amazon.com/mbox/",
    "series": [
        {
            "id": 30006,
            "url": "http://patches.dpdk.org/api/series/30006/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30006",
            "date": "2023-10-26T14:21:30",
            "name": "net/ena: v2.8.0 driver release",
            "version": 3,
            "mbox": "http://patches.dpdk.org/series/30006/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/133429/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/133429/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 7F7B743209;\n\tThu, 26 Oct 2023 16:22:40 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id EE96D42E45;\n\tThu, 26 Oct 2023 16:22:26 +0200 (CEST)",
            "from smtp-fw-80008.amazon.com (smtp-fw-80008.amazon.com\n [99.78.197.219]) by mails.dpdk.org (Postfix) with ESMTP id C57BC42E4A\n for <dev@dpdk.org>; Thu, 26 Oct 2023 16:22:18 +0200 (CEST)",
            "from pdx4-co-svc-p1-lb2-vlan3.amazon.com (HELO\n email-inbound-relay-iad-1a-m6i4x-edda28d4.us-east-1.amazon.com)\n ([10.25.36.214]) by smtp-border-fw-80008.pdx80.corp.amazon.com with\n ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Oct 2023 14:22:17 +0000",
            "from smtpout.prod.us-east-1.prod.farcaster.email.amazon.dev\n (iad7-ws-svc-p70-lb3-vlan3.iad.amazon.com [10.32.235.38])\n by email-inbound-relay-iad-1a-m6i4x-edda28d4.us-east-1.amazon.com (Postfix)\n with ESMTPS id BE377806A0; Thu, 26 Oct 2023 14:22:16 +0000 (UTC)",
            "from EX19MTAEUB001.ant.amazon.com [10.0.17.79:18861]\n by smtpin.naws.eu-west-1.prod.farcaster.email.amazon.dev [10.0.21.0:2525]\n with\n esmtp (Farcaster)\n id 03117e25-cde1-435c-ad08-1ed65ea30340;\n Thu, 26 Oct 2023 14:22:15 +0000 (UTC)",
            "from EX19D017EUA004.ant.amazon.com (10.252.50.239) by\n EX19MTAEUB001.ant.amazon.com (10.252.51.26) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.2.1118.39; Thu, 26 Oct 2023 14:22:14 +0000",
            "from EX19MTAUWC001.ant.amazon.com (10.250.64.145) by\n EX19D017EUA004.ant.amazon.com (10.252.50.239) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.2.1118.39; Thu, 26 Oct 2023 14:22:14 +0000",
            "from HFA15-CG15235BS.amazon.com (10.85.143.173) by\n mail-relay.amazon.com (10.250.64.145) with Microsoft SMTP Server id\n 15.2.1118.39 via Frontend Transport; Thu, 26 Oct 2023 14:22:12 +0000"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=amazon.com; i=@amazon.com; q=dns/txt; s=amazon201209;\n t=1698330139; x=1729866139;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=tcsa0tk9kp7wkaNVqrMK5DWfWhr5VpvFjyfxg8grJzo=;\n b=v6r+S4OPkHYljB9XL9JRxowI7xtoxD11ROBj7nxggshZWXk0RI139yRu\n dvbHHDk1HzDxYuudpWEZ9yXO54eg0BV6uox4wvOeSYSARbrAcVCk3zlI+\n LVk6QmkxclZq9RwRalh47xxVzyMqQb09f93fo/MudK6qGpsfQ+BTtpPs7 A=;",
        "X-IronPort-AV": "E=Sophos;i=\"6.03,253,1694736000\"; d=\"scan'208\";a=\"38849678\"",
        "X-Farcaster-Flow-ID": "03117e25-cde1-435c-ad08-1ed65ea30340",
        "From": "<shaibran@amazon.com>",
        "To": "<ferruh.yigit@amd.com>",
        "CC": "<dev@dpdk.org>, <rbeider@amazon.com>, <atrwajee@amazon.com>,\n <amitbern@amazon.com>, <shaibran@amazon.com>",
        "Subject": "[PATCH v3 4/5] net/ena: add support for ena-express metrics",
        "Date": "Thu, 26 Oct 2023 17:21:34 +0300",
        "Message-ID": "<20231026142135.19967-5-shaibran@amazon.com>",
        "X-Mailer": "git-send-email 2.17.1",
        "In-Reply-To": "<20231026142135.19967-1-shaibran@amazon.com>",
        "References": "<20231026142135.19967-1-shaibran@amazon.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"UTF-8\"",
        "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": "From: Shai Brandes <shaibran@amazon.com>\n\nENA-express is powered by AWS scalable reliable datagram (SRD)\ntechnology. SRD is a high performance network transport protocol\nthat uses dynamic routing to increase throughput and minimize\ntail latency.\n\nThe driver expose the following ENA-express metrics via xstats:\n* ena_srd_mode – Describes which ENA-express features are enabled\n* ena_srd_eligible_tx_pkts – The number of network packets sent\n  within a given time period that meet SRD requirements for\n  eligibility\n* ena_srd_tx_pkts – The number of SRD packets transmitted within\n  a given time period.\n* ena_srd_rx_pkts – The number of SRD packets received within\n  a given time period.\n* ena_srd_resource_utilization – The percentage of the maximum\n  allowed memory utilization for concurrent SRD connections\n  that the instance has consumed.\n\nProbing the ENA Express metrics is performed via an admin command.\nThus, a multi-process proxy handler was added.\n\nSigned-off-by: Shai Brandes <shaibran@amazon.com>\nReviewed-by: Amit Bernstein <amitbern@amazon.com>\n---\n doc/guides/rel_notes/release_23_11.rst |   1 +\n drivers/net/ena/ena_ethdev.c           | 103 ++++++++++++++++++++++++-\n drivers/net/ena/ena_ethdev.h           |  18 +++++\n 3 files changed, 121 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/doc/guides/rel_notes/release_23_11.rst b/doc/guides/rel_notes/release_23_11.rst\nindex 2666371ccd..10482a643d 100644\n--- a/doc/guides/rel_notes/release_23_11.rst\n+++ b/doc/guides/rel_notes/release_23_11.rst\n@@ -127,6 +127,7 @@ New Features\n   * Upgraded ENA HAL to latest version.\n   * Added support for connection tracking allowance utilization metric.\n   * Added support for reporting rx overrun errors in xstats.\n+  * Added support for ENA-express metrics.\n \n * **Updated Intel cpfl driver.**\n \ndiff --git a/drivers/net/ena/ena_ethdev.c b/drivers/net/ena/ena_ethdev.c\nindex bd9d7c6249..009ee425fe 100644\n--- a/drivers/net/ena/ena_ethdev.c\n+++ b/drivers/net/ena/ena_ethdev.c\n@@ -66,6 +66,9 @@ struct ena_stats {\n #define ENA_STAT_GLOBAL_ENTRY(stat) \\\n \tENA_STAT_ENTRY(stat, dev)\n \n+#define ENA_STAT_ENA_SRD_ENTRY(stat) \\\n+\tENA_STAT_ENTRY(stat, srd)\n+\n /* Device arguments */\n #define ENA_DEVARG_LARGE_LLQ_HDR \"large_llq_hdr\"\n /* Timeout in seconds after which a single uncompleted Tx packet should be\n@@ -106,6 +109,14 @@ static struct ena_stats ena_stats_metrics_strings[] = {\n \tENA_STAT_METRICS_ENTRY(conntrack_allowance_available),\n };\n \n+static const struct ena_stats ena_stats_srd_strings[] = {\n+\tENA_STAT_ENA_SRD_ENTRY(ena_srd_mode),\n+\tENA_STAT_ENA_SRD_ENTRY(ena_srd_tx_pkts),\n+\tENA_STAT_ENA_SRD_ENTRY(ena_srd_eligible_tx_pkts),\n+\tENA_STAT_ENA_SRD_ENTRY(ena_srd_rx_pkts),\n+\tENA_STAT_ENA_SRD_ENTRY(ena_srd_resource_utilization),\n+};\n+\n static const struct ena_stats ena_stats_tx_strings[] = {\n \tENA_STAT_TX_ENTRY(cnt),\n \tENA_STAT_TX_ENTRY(bytes),\n@@ -132,6 +143,7 @@ static const struct ena_stats ena_stats_rx_strings[] = {\n #define ENA_STATS_ARRAY_GLOBAL\tARRAY_SIZE(ena_stats_global_strings)\n #define ENA_STATS_ARRAY_METRICS\tARRAY_SIZE(ena_stats_metrics_strings)\n #define ENA_STATS_ARRAY_METRICS_LEGACY\t(ENA_STATS_ARRAY_METRICS - 1)\n+#define ENA_STATS_ARRAY_ENA_SRD\tARRAY_SIZE(ena_stats_srd_strings)\n #define ENA_STATS_ARRAY_TX\tARRAY_SIZE(ena_stats_tx_strings)\n #define ENA_STATS_ARRAY_RX\tARRAY_SIZE(ena_stats_rx_strings)\n \n@@ -272,6 +284,8 @@ static int ena_parse_devargs(struct ena_adapter *adapter,\n static void ena_copy_customer_metrics(struct ena_adapter *adapter,\n \t\t\t\t\tuint64_t *buf,\n \t\t\t\t\tsize_t buf_size);\n+static void ena_copy_ena_srd_info(struct ena_adapter *adapter,\n+\t\t\t\t  struct ena_stats_srd *srd_info);\n static int ena_setup_rx_intr(struct rte_eth_dev *dev);\n static int ena_rx_queue_intr_enable(struct rte_eth_dev *dev,\n \t\t\t\t    uint16_t queue_id);\n@@ -324,6 +338,7 @@ enum ena_mp_req {\n \tENA_MP_IND_TBL_GET,\n \tENA_MP_IND_TBL_SET,\n \tENA_MP_CUSTOMER_METRICS_GET,\n+\tENA_MP_SRD_STATS_GET,\n };\n \n /** Proxy message body. Shared between requests and responses. */\n@@ -581,6 +596,22 @@ ENA_PROXY_DESC(ena_com_get_customer_metrics, ENA_MP_CUSTOMER_METRICS_GET,\n }),\n \tstruct ena_com_dev *ena_dev, char *buf, size_t buf_size);\n \n+ENA_PROXY_DESC(ena_com_get_ena_srd_info, ENA_MP_SRD_STATS_GET,\n+({\n+\tENA_TOUCH(adapter);\n+\tENA_TOUCH(req);\n+\tENA_TOUCH(ena_dev);\n+\tENA_TOUCH(info);\n+}),\n+({\n+\tENA_TOUCH(rsp);\n+\tENA_TOUCH(ena_dev);\n+\tif ((struct ena_stats_srd *)info != &adapter->srd_stats)\n+\t\trte_memcpy((struct ena_stats_srd *)info,\n+\t\t\t\t&adapter->srd_stats,\n+\t\t\t\tsizeof(struct ena_stats_srd));\n+}),\n+\tstruct ena_com_dev *ena_dev, struct ena_admin_ena_srd_info *info);\n \n static inline void ena_trigger_reset(struct ena_adapter *adapter,\n \t\t\t\t     enum ena_regs_reset_reason_types reason)\n@@ -787,6 +818,7 @@ static unsigned int ena_xstats_calc_num(struct rte_eth_dev_data *data)\n \n \treturn ENA_STATS_ARRAY_GLOBAL +\n \t\tadapter->metrics_num +\n+\t\tENA_STATS_ARRAY_ENA_SRD +\n \t\t(data->nb_tx_queues * ENA_STATS_ARRAY_TX) +\n \t\t(data->nb_rx_queues * ENA_STATS_ARRAY_RX);\n }\n@@ -3250,6 +3282,27 @@ static void ena_copy_customer_metrics(struct ena_adapter *adapter, uint64_t *buf\n \t}\n }\n \n+static void ena_copy_ena_srd_info(struct ena_adapter *adapter,\n+\t\tstruct ena_stats_srd *srd_info)\n+{\n+\tint rc;\n+\n+\tif (!ena_com_get_cap(&adapter->ena_dev, ENA_ADMIN_ENA_SRD_INFO))\n+\t\treturn;\n+\n+\trte_spinlock_lock(&adapter->admin_lock);\n+\trc = ENA_PROXY(adapter,\n+\t\t       ena_com_get_ena_srd_info,\n+\t\t       &adapter->ena_dev,\n+\t\t       (struct ena_admin_ena_srd_info *)srd_info);\n+\trte_spinlock_unlock(&adapter->admin_lock);\n+\tif (rc != ENA_COM_OK && rc != ENA_COM_UNSUPPORTED) {\n+\t\tPMD_DRV_LOG(WARNING,\n+\t\t\t\t\"Failed to get ENA express srd info, rc: %d\\n\", rc);\n+\t\treturn;\n+\t}\n+}\n+\n /**\n  * DPDK callback to retrieve names of extended device statistics\n  *\n@@ -3282,6 +3335,10 @@ static int ena_xstats_get_names(struct rte_eth_dev *dev,\n \t\trte_strscpy(xstats_names[count].name,\n \t\t\t    ena_stats_metrics_strings[stat].name,\n \t\t\t    RTE_ETH_XSTATS_NAME_SIZE);\n+\tfor (stat = 0; stat < ENA_STATS_ARRAY_ENA_SRD; stat++, count++)\n+\t\trte_strscpy(xstats_names[count].name,\n+\t\t\t    ena_stats_srd_strings[stat].name,\n+\t\t\t    RTE_ETH_XSTATS_NAME_SIZE);\n \n \tfor (stat = 0; stat < ENA_STATS_ARRAY_RX; stat++)\n \t\tfor (i = 0; i < dev->data->nb_rx_queues; i++, count++)\n@@ -3353,6 +3410,15 @@ static int ena_xstats_get_names_by_id(struct rte_eth_dev *dev,\n \t\t}\n \n \t\tid -= adapter->metrics_num;\n+\n+\t\tif (id < ENA_STATS_ARRAY_ENA_SRD) {\n+\t\t\trte_strscpy(xstats_names[i].name,\n+\t\t\t\t    ena_stats_srd_strings[id].name,\n+\t\t\t\t    RTE_ETH_XSTATS_NAME_SIZE);\n+\t\t\tcontinue;\n+\t\t}\n+\t\tid -= ENA_STATS_ARRAY_ENA_SRD;\n+\n \t\tif (id < ENA_STATS_ARRAY_RX) {\n \t\t\tqid = id / dev->data->nb_rx_queues;\n \t\t\tid %= dev->data->nb_rx_queues;\n@@ -3404,6 +3470,7 @@ static int ena_xstats_get(struct rte_eth_dev *dev,\n \tint stat_offset;\n \tvoid *stats_begin;\n \tuint64_t metrics_stats[ENA_MAX_CUSTOMER_METRICS];\n+\tstruct ena_stats_srd srd_info = {0};\n \n \tif (n < xstats_count)\n \t\treturn xstats_count;\n@@ -3430,6 +3497,15 @@ static int ena_xstats_get(struct rte_eth_dev *dev,\n \t\t    ((char *)stats_begin + stat_offset));\n \t}\n \n+\tena_copy_ena_srd_info(adapter, &srd_info);\n+\tstats_begin = &srd_info;\n+\tfor (stat = 0; stat < ENA_STATS_ARRAY_ENA_SRD; stat++, count++) {\n+\t\tstat_offset = ena_stats_srd_strings[stat].stat_offset;\n+\t\txstats[count].id = count;\n+\t\txstats[count].value = *((uint64_t *)\n+\t\t    ((char *)stats_begin + stat_offset));\n+\t}\n+\n \tfor (stat = 0; stat < ENA_STATS_ARRAY_RX; stat++) {\n \t\tfor (i = 0; i < dev->data->nb_rx_queues; i++, count++) {\n \t\t\tstat_offset = ena_stats_rx_strings[stat].stat_offset;\n@@ -3467,7 +3543,9 @@ static int ena_xstats_get_by_id(struct rte_eth_dev *dev,\n \tint qid;\n \tint valid = 0;\n \tbool were_metrics_copied = false;\n+\tbool was_srd_info_copied = false;\n \tuint64_t metrics_stats[ENA_MAX_CUSTOMER_METRICS];\n+\tstruct ena_stats_srd srd_info = {0};\n \n \tfor (i = 0; i < n; ++i) {\n \t\tid = ids[i];\n@@ -3497,8 +3575,27 @@ static int ena_xstats_get_by_id(struct rte_eth_dev *dev,\n \t\t\tcontinue;\n \t\t}\n \n-\t\t/* Check if id belongs to rx queue statistics */\n+\t\t/* Check if id belongs to SRD info statistics */\n \t\tid -= adapter->metrics_num;\n+\n+\t\tif (id < ENA_STATS_ARRAY_ENA_SRD) {\n+\t\t\t/*\n+\t\t\t * Avoid reading srd info multiple times in a single\n+\t\t\t * function call, as it requires communication with the\n+\t\t\t * admin queue.\n+\t\t\t */\n+\t\t\tif (!was_srd_info_copied) {\n+\t\t\t\twas_srd_info_copied = true;\n+\t\t\t\tena_copy_ena_srd_info(adapter, &srd_info);\n+\t\t\t}\n+\t\t\tvalues[i] = *((uint64_t *)&adapter->srd_stats + id);\n+\t\t\t++valid;\n+\t\t\tcontinue;\n+\t\t}\n+\n+\t\t/* Check if id belongs to rx queue statistics */\n+\t\tid -= ENA_STATS_ARRAY_ENA_SRD;\n+\n \t\trx_entries = ENA_STATS_ARRAY_RX * dev->data->nb_rx_queues;\n \t\tif (id < rx_entries) {\n \t\t\tqid = id % dev->data->nb_rx_queues;\n@@ -3993,6 +4090,10 @@ ena_mp_primary_handle(const struct rte_mp_msg *mp_msg, const void *peer)\n \t\t\t\t(char *)adapter->metrics_stats,\n \t\t\t\tsizeof(uint64_t) * adapter->metrics_num);\n \t\tbreak;\n+\tcase ENA_MP_SRD_STATS_GET:\n+\t\tres = ena_com_get_ena_srd_info(ena_dev,\n+\t\t\t\t(struct ena_admin_ena_srd_info *)&adapter->srd_stats);\n+\t\tbreak;\n \tdefault:\n \t\tPMD_DRV_LOG(ERR, \"Unknown request type %d\\n\", req->type);\n \t\tres = -EINVAL;\ndiff --git a/drivers/net/ena/ena_ethdev.h b/drivers/net/ena/ena_ethdev.h\nindex 3f29764ca6..4988fbffb5 100644\n--- a/drivers/net/ena/ena_ethdev.h\n+++ b/drivers/net/ena/ena_ethdev.h\n@@ -252,6 +252,23 @@ struct ena_stats_metrics {\n \tuint64_t conntrack_allowance_available;\n };\n \n+struct ena_stats_srd {\n+\t/* Describes which ENA Express features are enabled */\n+\tuint64_t ena_srd_mode;\n+\n+\t/* Number of packets transmitted over ENA SRD */\n+\tuint64_t ena_srd_tx_pkts;\n+\n+\t/* Number of packets transmitted or could have been transmitted over ENA SRD */\n+\tuint64_t ena_srd_eligible_tx_pkts;\n+\n+\t/* Number of packets received over ENA SRD */\n+\tuint64_t ena_srd_rx_pkts;\n+\n+\t/* Percentage of the ENA SRD resources that is in use */\n+\tuint64_t ena_srd_resource_utilization;\n+};\n+\n struct ena_offloads {\n \tuint32_t tx_offloads;\n \tuint32_t rx_offloads;\n@@ -329,6 +346,7 @@ struct ena_adapter {\n \t */\n \tuint64_t metrics_stats[ENA_MAX_CUSTOMER_METRICS] __rte_cache_aligned;\n \tuint16_t metrics_num;\n+\tstruct ena_stats_srd srd_stats __rte_cache_aligned;\n };\n \n int ena_mp_indirect_table_set(struct ena_adapter *adapter);\n",
    "prefixes": [
        "v3",
        "4/5"
    ]
}