get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 126799,
    "url": "https://patches.dpdk.org/api/patches/126799/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20230509092459.20140-4-haijie1@huawei.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": "<20230509092459.20140-4-haijie1@huawei.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230509092459.20140-4-haijie1@huawei.com",
    "date": "2023-05-09T09:24:59",
    "name": "[v6,3/3] ring: add telemetry cmd for ring info",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "390a2ff54536584df48a611ea15d72fe12f74146",
    "submitter": {
        "id": 2935,
        "url": "https://patches.dpdk.org/api/people/2935/?format=api",
        "name": "Jie Hai",
        "email": "haijie1@huawei.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/20230509092459.20140-4-haijie1@huawei.com/mbox/",
    "series": [
        {
            "id": 27967,
            "url": "https://patches.dpdk.org/api/series/27967/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=27967",
            "date": "2023-05-09T09:24:56",
            "name": "add telemetry cmds for ring",
            "version": 6,
            "mbox": "https://patches.dpdk.org/series/27967/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/126799/comments/",
    "check": "fail",
    "checks": "https://patches.dpdk.org/api/patches/126799/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 4D3FE42AA2;\n\tTue,  9 May 2023 11:27:59 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 5F4F742D39;\n\tTue,  9 May 2023 11:27:48 +0200 (CEST)",
            "from szxga01-in.huawei.com (szxga01-in.huawei.com [45.249.212.187])\n by mails.dpdk.org (Postfix) with ESMTP id 4FEEF410D7\n for <dev@dpdk.org>; Tue,  9 May 2023 11:27:43 +0200 (CEST)",
            "from kwepemi500020.china.huawei.com (unknown [172.30.72.56])\n by szxga01-in.huawei.com (SkyGuard) with ESMTP id 4QFt4g5gN1zpV2f;\n Tue,  9 May 2023 17:23:31 +0800 (CST)",
            "from localhost.localdomain (10.69.192.56) by\n kwepemi500020.china.huawei.com (7.221.188.8) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id\n 15.1.2507.23; Tue, 9 May 2023 17:27:41 +0800"
        ],
        "From": "Jie Hai <haijie1@huawei.com>",
        "To": "Honnappa Nagarahalli <honnappa.nagarahalli@arm.com>, Konstantin Ananyev\n <konstantin.v.ananyev@yandex.ru>",
        "CC": "<dev@dpdk.org>, <liudongdong3@huawei.com>",
        "Subject": "[PATCH v6 3/3] ring: add telemetry cmd for ring info",
        "Date": "Tue, 9 May 2023 17:24:59 +0800",
        "Message-ID": "<20230509092459.20140-4-haijie1@huawei.com>",
        "X-Mailer": "git-send-email 2.33.0",
        "In-Reply-To": "<20230509092459.20140-1-haijie1@huawei.com>",
        "References": "<20230509012907.3817-1-haijie1@huawei.com>\n <20230509092459.20140-1-haijie1@huawei.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"UTF-8\"",
        "Content-Transfer-Encoding": "8bit",
        "X-Originating-IP": "[10.69.192.56]",
        "X-ClientProxiedBy": "dggems703-chm.china.huawei.com (10.3.19.180) To\n kwepemi500020.china.huawei.com (7.221.188.8)",
        "X-CFilter-Loop": "Reflected",
        "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": "This patch supports dump of ring information by its name.\nAn example using this command is shown below:\n\n--> /ring/info,MP_mb_pool_0\n{\n  \"/ring/info\": {\n    \"name\": \"MP_mb_pool_0\",\n    \"socket\": 0,\n    \"flags\": \"0x0\",\n    \"producer_type\": \"MP\",\n    \"consumer_type\": \"MC\",\n    \"size\": 262144,\n    \"mask\": \"0x3ffff\",\n    \"capacity\": 262143,\n    \"used_count\": 153197,\n    \"consumer_tail\": 2259,\n    \"consumer_head\": 2259,\n    \"producer_tail\": 155456,\n    \"producer_head\": 155456,\n    \"mz_name\": \"RG_MP_mb_pool_0\",\n    \"mz_len\": 2097536,\n    \"mz_hugepage_sz\": 1073741824,\n    \"mz_socket_id\": 0,\n    \"mz_flags\": \"0x0\"\n  }\n}\n\nSigned-off-by: Jie Hai <haijie1@huawei.com>\nReviewed-by: Honnappa Nagarahalli <honnappa.nagarahalli@arm.com>\nAcked-by: Konstantin Ananyev <konstantin.v.ananyev@yandex.ru>\nAcked-by: Huisong Li <lihuisong@huawei.com>\nAcked-by: Chengwen Feng <fengchengwen@huawei.com>\nAcked-by: Morten Brørup <mb@smartsharesystems.com>\n---\n lib/ring/rte_ring.c | 99 +++++++++++++++++++++++++++++++++++++++++++++\n 1 file changed, 99 insertions(+)",
    "diff": "diff --git a/lib/ring/rte_ring.c b/lib/ring/rte_ring.c\nindex 0e83d0099363..26c8f2a2e6a2 100644\n--- a/lib/ring/rte_ring.c\n+++ b/lib/ring/rte_ring.c\n@@ -455,8 +455,107 @@ ring_handle_list(const char *cmd __rte_unused,\n \treturn 0;\n }\n \n+static const char *\n+ring_prod_sync_type_to_name(struct rte_ring *r)\n+{\n+\tswitch (r->prod.sync_type) {\n+\tcase RTE_RING_SYNC_MT:\n+\t\treturn \"MP\";\n+\tcase RTE_RING_SYNC_ST:\n+\t\treturn \"SP\";\n+\tcase RTE_RING_SYNC_MT_RTS:\n+\t\treturn \"MP_RTS\";\n+\tcase RTE_RING_SYNC_MT_HTS:\n+\t\treturn \"MP_HTS\";\n+\tdefault:\n+\t\treturn \"Unknown\";\n+\t}\n+}\n+\n+static const char *\n+ring_cons_sync_type_to_name(struct rte_ring *r)\n+{\n+\tswitch (r->cons.sync_type) {\n+\tcase RTE_RING_SYNC_MT:\n+\t\treturn \"MC\";\n+\tcase RTE_RING_SYNC_ST:\n+\t\treturn \"SC\";\n+\tcase RTE_RING_SYNC_MT_RTS:\n+\t\treturn \"MC_RTS\";\n+\tcase RTE_RING_SYNC_MT_HTS:\n+\t\treturn \"MC_HTS\";\n+\tdefault:\n+\t\treturn \"Unknown\";\n+\t}\n+}\n+\n+struct ring_info_cb_arg {\n+\tchar *ring_name;\n+\tstruct rte_tel_data *d;\n+};\n+\n+static void\n+ring_info_cb(struct rte_ring *r, void *arg)\n+{\n+\tstruct ring_info_cb_arg *ring_arg = (struct ring_info_cb_arg *)arg;\n+\tstruct rte_tel_data *d = ring_arg->d;\n+\tconst struct rte_memzone *mz;\n+\n+\tif (strncmp(r->name, ring_arg->ring_name, RTE_RING_NAMESIZE))\n+\t\treturn;\n+\n+\trte_tel_data_add_dict_string(d, \"name\", r->name);\n+\trte_tel_data_add_dict_int(d, \"socket\", r->memzone->socket_id);\n+\trte_tel_data_add_dict_uint_hex(d, \"flags\", r->flags, 0);\n+\trte_tel_data_add_dict_string(d, \"producer_type\",\n+\t\tring_prod_sync_type_to_name(r));\n+\trte_tel_data_add_dict_string(d, \"consumer_type\",\n+\t\tring_cons_sync_type_to_name(r));\n+\trte_tel_data_add_dict_uint(d, \"size\", r->size);\n+\trte_tel_data_add_dict_uint_hex(d, \"mask\", r->mask, 0);\n+\trte_tel_data_add_dict_uint(d, \"capacity\", r->capacity);\n+\trte_tel_data_add_dict_uint(d, \"used_count\", rte_ring_count(r));\n+\trte_tel_data_add_dict_uint(d, \"consumer_tail\", r->cons.tail);\n+\trte_tel_data_add_dict_uint(d, \"consumer_head\", r->cons.head);\n+\trte_tel_data_add_dict_uint(d, \"producer_tail\", r->prod.tail);\n+\trte_tel_data_add_dict_uint(d, \"producer_head\", r->prod.head);\n+\n+\tmz = r->memzone;\n+\tif (mz == NULL)\n+\t\treturn;\n+\trte_tel_data_add_dict_string(d, \"mz_name\", mz->name);\n+\trte_tel_data_add_dict_uint(d, \"mz_len\", mz->len);\n+\trte_tel_data_add_dict_uint(d, \"mz_hugepage_sz\", mz->hugepage_sz);\n+\trte_tel_data_add_dict_int(d, \"mz_socket_id\", mz->socket_id);\n+\trte_tel_data_add_dict_uint_hex(d, \"mz_flags\", mz->flags, 0);\n+}\n+\n+static int\n+ring_handle_info(const char *cmd __rte_unused, const char *params,\n+\t\tstruct rte_tel_data *d)\n+{\n+\tchar name[RTE_RING_NAMESIZE] = {0};\n+\tstruct ring_info_cb_arg ring_arg;\n+\n+\tif (params == NULL || strlen(params) == 0 ||\n+\t\tstrlen(params) >= RTE_RING_NAMESIZE)\n+\t\treturn -EINVAL;\n+\n+\trte_strlcpy(name, params, RTE_RING_NAMESIZE);\n+\n+\tring_arg.ring_name = name;\n+\tring_arg.d = d;\n+\n+\trte_tel_data_start_dict(d);\n+\tring_walk(ring_info_cb, &ring_arg);\n+\n+\treturn 0;\n+}\n+\n RTE_INIT(ring_init_telemetry)\n {\n \trte_telemetry_register_cmd(\"/ring/list\", ring_handle_list,\n \t\t\"Returns list of available rings. Takes no parameters\");\n+\trte_telemetry_register_cmd(\"/ring/info\", ring_handle_info,\n+\t\t\"Returns ring info. Parameters: ring_name.\");\n }\n",
    "prefixes": [
        "v6",
        "3/3"
    ]
}