get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 138733,
    "url": "http://patchwork.dpdk.org/api/patches/138733/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20240322070923.244417-4-huangdengdui@huawei.com/",
    "project": {
        "id": 1,
        "url": "http://patchwork.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": "<20240322070923.244417-4-huangdengdui@huawei.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20240322070923.244417-4-huangdengdui@huawei.com",
    "date": "2024-03-22T07:09:20",
    "name": "[v2,3/6] ethdev: add function to parse link mode info",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "18708a6223484540c78ba454b687236876df731a",
    "submitter": {
        "id": 3066,
        "url": "http://patchwork.dpdk.org/api/people/3066/?format=api",
        "name": "huangdengdui",
        "email": "huangdengdui@huawei.com"
    },
    "delegate": {
        "id": 319,
        "url": "http://patchwork.dpdk.org/api/users/319/?format=api",
        "username": "fyigit",
        "first_name": "Ferruh",
        "last_name": "Yigit",
        "email": "ferruh.yigit@amd.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20240322070923.244417-4-huangdengdui@huawei.com/mbox/",
    "series": [
        {
            "id": 31593,
            "url": "http://patchwork.dpdk.org/api/series/31593/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=31593",
            "date": "2024-03-22T07:09:17",
            "name": "support setting lanes",
            "version": 2,
            "mbox": "http://patchwork.dpdk.org/series/31593/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/patches/138733/comments/",
    "check": "success",
    "checks": "http://patchwork.dpdk.org/api/patches/138733/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 A35BF43D1E;\n\tFri, 22 Mar 2024 08:09:33 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id E631242E67;\n\tFri, 22 Mar 2024 08:09:29 +0100 (CET)",
            "from szxga05-in.huawei.com (szxga05-in.huawei.com [45.249.212.191])\n by mails.dpdk.org (Postfix) with ESMTP id 489174003C\n for <dev@dpdk.org>; Fri, 22 Mar 2024 08:09:26 +0100 (CET)",
            "from mail.maildlp.com (unknown [172.19.88.163])\n by szxga05-in.huawei.com (SkyGuard) with ESMTP id 4V1D2g4x2hz1GChm;\n Fri, 22 Mar 2024 15:08:59 +0800 (CST)",
            "from dggpeml500011.china.huawei.com (unknown [7.185.36.84])\n by mail.maildlp.com (Postfix) with ESMTPS id EE73718005F;\n Fri, 22 Mar 2024 15:09:24 +0800 (CST)",
            "from localhost.huawei.com (10.50.165.33) by\n dggpeml500011.china.huawei.com (7.185.36.84) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.1.2507.35; Fri, 22 Mar 2024 15:09:24 +0800"
        ],
        "From": "Dengdui Huang <huangdengdui@huawei.com>",
        "To": "<dev@dpdk.org>",
        "CC": "<ferruh.yigit@amd.com>, <aman.deep.singh@intel.com>,\n <yuying.zhang@intel.com>, <thomas@monjalon.net>,\n <andrew.rybchenko@oktetlabs.ru>, <damodharam.ammepalli@broadcom.com>,\n <stephen@networkplumber.org>, <jerinjacobk@gmail.com>,\n <ajit.khaparde@broadcom.com>, <liuyonglong@huawei.com>,\n <fengchengwen@huawei.com>, <haijie1@huawei.com>, <lihuisong@huawei.com>",
        "Subject": "[PATCH v2 3/6] ethdev: add function to parse link mode info",
        "Date": "Fri, 22 Mar 2024 15:09:20 +0800",
        "Message-ID": "<20240322070923.244417-4-huangdengdui@huawei.com>",
        "X-Mailer": "git-send-email 2.33.0",
        "In-Reply-To": "<20240322070923.244417-1-huangdengdui@huawei.com>",
        "References": "<20240312075238.3319480-4-huangdengdui@huawei.com>\n <20240322070923.244417-1-huangdengdui@huawei.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[10.50.165.33]",
        "X-ClientProxiedBy": "dggems706-chm.china.huawei.com (10.3.19.183) To\n dggpeml500011.china.huawei.com (7.185.36.84)",
        "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": "Added function rte_eth_link_mode_parse() to parse\nthe speed number, lanes and duplex parameters\nfrom the Link speed apabilities bitmap flags.\n\nSigned-off-by: Dengdui Huang <huangdengdui@huawei.com>\n---\n doc/guides/rel_notes/release_24_03.rst |   3 +\n lib/ethdev/rte_ethdev.c                | 199 +++++++++++++++++++++++++\n lib/ethdev/rte_ethdev.h                |  29 ++++\n lib/ethdev/version.map                 |   1 +\n 4 files changed, 232 insertions(+)",
    "diff": "diff --git a/doc/guides/rel_notes/release_24_03.rst b/doc/guides/rel_notes/release_24_03.rst\nindex 4621689c68..b41b0028b2 100644\n--- a/doc/guides/rel_notes/release_24_03.rst\n+++ b/doc/guides/rel_notes/release_24_03.rst\n@@ -78,6 +78,9 @@ New Features\n \n * **Support setting lanes for ethdev.**\n   * Support setting lanes by extended ``RTE_ETH_LINK_SPEED_*``.\n+  * Added function to parse the speed number, lanes and duplex parameters from\n+  * the Link speed apabilities bitmap flags:\n+  ``rte_eth_link_mode_parse()``\n \n * **Added hash calculation of an encapsulated packet as done by the HW.**\n \ndiff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c\nindex 6571116fbf..bac7c652be 100644\n--- a/lib/ethdev/rte_ethdev.c\n+++ b/lib/ethdev/rte_ethdev.c\n@@ -1105,6 +1105,205 @@ rte_eth_dev_rx_offload_name(uint64_t offload)\n \treturn name;\n }\n \n+int\n+rte_eth_link_mode_parse(uint32_t link_speed,\n+\t\t\tstruct rte_eth_link_mode_info *mode_onfo)\n+{\n+\tconst struct {\n+\t\tuint32_t speed_capa;\n+\t\tstruct rte_eth_link_mode_info mode_onfo;\n+\t} speed_mode_onfo_map[] = {\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_10M_HD,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_10M,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_HALF_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_10M,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_10M,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_100M_HD,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_100M,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_HALF_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_100M,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_100M,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_1G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_1G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_2_5G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_2_5G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_5G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_5G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_10G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_10G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_20G_2LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_20G,\n+\t\t\t\t\tRTE_ETH_LANES_2,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_25G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_25G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_40G_4LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_40G,\n+\t\t\t\t\tRTE_ETH_LANES_4,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_50G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_50G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_56G_4LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_56G,\n+\t\t\t\t\tRTE_ETH_LANES_4,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_100G,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_100G,\n+\t\t\t\t\tRTE_ETH_LANES_1,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_200G_4LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_200G,\n+\t\t\t\t\tRTE_ETH_LANES_4,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_400G_4LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_400G,\n+\t\t\t\t\tRTE_ETH_LANES_4,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_10G_4LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_10G,\n+\t\t\t\t\tRTE_ETH_LANES_4,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_50G_2LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_50G,\n+\t\t\t\t\tRTE_ETH_LANES_2,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_100G_2LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_100G,\n+\t\t\t\t\tRTE_ETH_LANES_2,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_100G_4LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_100G,\n+\t\t\t\t\tRTE_ETH_LANES_4,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_200G_2LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_200G,\n+\t\t\t\t\tRTE_ETH_LANES_2,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t},\n+\t\t{\n+\t\t\tRTE_ETH_LINK_SPEED_400G_8LANES,\n+\t\t\t\t{\n+\t\t\t\t\tRTE_ETH_SPEED_NUM_400G,\n+\t\t\t\t\tRTE_ETH_LANES_8,\n+\t\t\t\t\tRTE_ETH_LINK_FULL_DUPLEX\n+\t\t\t\t}\n+\t\t}\n+\t};\n+\tuint32_t i;\n+\n+\tfor (i = 0; i < RTE_DIM(speed_mode_onfo_map); i++) {\n+\t\tif (link_speed == speed_mode_onfo_map[i].speed_capa) {\n+\t\t\tmode_onfo->speed_num = speed_mode_onfo_map[i].mode_onfo.speed_num;\n+\t\t\tmode_onfo->lanes = speed_mode_onfo_map[i].mode_onfo.lanes;\n+\t\t\tmode_onfo->duplex = speed_mode_onfo_map[i].mode_onfo.duplex;\n+\t\t\treturn 0;\n+\t\t}\n+\t}\n+\n+\treturn -EINVAL;\n+}\n+\n const char *\n rte_eth_dev_tx_offload_name(uint64_t offload)\n {\ndiff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h\nindex 123b771046..b7aacf6da8 100644\n--- a/lib/ethdev/rte_ethdev.h\n+++ b/lib/ethdev/rte_ethdev.h\n@@ -355,6 +355,15 @@ struct rte_eth_stats {\n #define RTE_ETH_LANES_8          8 /**< 8 lanes */\n /**@}*/\n \n+/**\n+ * A structure used to store information of link mode.\n+ */\n+struct rte_eth_link_mode_info {\n+\tuint32_t speed_num;        /**< RTE_ETH_SPEED_NUM_ */\n+\tuint8_t  lanes;        /**< RTE_ETH_LANES_ */\n+\tuint8_t  duplex;       /**< RTE_ETH_LINK_[HALF/FULL]_DUPLEX */\n+};\n+\n /**\n  * A structure used to retrieve link-level information of an Ethernet port.\n  */\n@@ -2345,6 +2354,26 @@ uint16_t rte_eth_dev_count_total(void);\n  */\n uint32_t rte_eth_speed_bitflag(uint32_t speed, uint8_t lanes, int duplex);\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change, or be removed, without prior notice\n+ *\n+ * Parse the speed number, lanes and duplex parameters from the Link speed\n+ * capabilities bitmap flags.\n+ *\n+ * @param link_speed\n+ *   speed capabilities bitmap flag (RTE_ETH_LINK_SPEED_)\n+ * @param mode_onfo\n+ *   A pointer to a structure of type *rte_eth_link_mode_info* to be filled\n+ *   with the information of link mode.\n+ * @return\n+ *   - (0) if successful.\n+ *   - (-EINVAL) if bad parameter.\n+ */\n+__rte_experimental\n+int rte_eth_link_mode_parse(uint32_t link_speed,\n+\t\t\t    struct rte_eth_link_mode_info *mode_info);\n+\n /**\n  * Get RTE_ETH_RX_OFFLOAD_* flag name.\n  *\ndiff --git a/lib/ethdev/version.map b/lib/ethdev/version.map\nindex 9fa2439976..5726498dd1 100644\n--- a/lib/ethdev/version.map\n+++ b/lib/ethdev/version.map\n@@ -326,6 +326,7 @@ EXPERIMENTAL {\n \t# added in 24.03\n \t__rte_eth_trace_tx_queue_count;\n \trte_eth_find_rss_algo;\n+\trte_eth_link_mode_parse;\n \trte_flow_async_update_resized;\n \trte_flow_calc_encap_hash;\n \trte_flow_template_table_resizable;\n",
    "prefixes": [
        "v2",
        "3/6"
    ]
}