get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 122178,
    "url": "http://patches.dpdk.org/api/patches/122178/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20230117091049.20194-3-haijie1@huawei.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": "<20230117091049.20194-3-haijie1@huawei.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230117091049.20194-3-haijie1@huawei.com",
    "date": "2023-01-17T09:10:49",
    "name": "[2/2] ring: add ring info telemetry cmd",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "34e1e6719943111fb92bad85964100f2108f9fce",
    "submitter": {
        "id": 2935,
        "url": "http://patches.dpdk.org/api/people/2935/?format=api",
        "name": "Jie Hai",
        "email": "haijie1@huawei.com"
    },
    "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/20230117091049.20194-3-haijie1@huawei.com/mbox/",
    "series": [
        {
            "id": 26574,
            "url": "http://patches.dpdk.org/api/series/26574/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=26574",
            "date": "2023-01-17T09:10:47",
            "name": "add ring telemetry cmds",
            "version": 1,
            "mbox": "http://patches.dpdk.org/series/26574/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/122178/comments/",
    "check": "fail",
    "checks": "http://patches.dpdk.org/api/patches/122178/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 18028423FB;\n\tTue, 17 Jan 2023 10:13:26 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id C570242D24;\n\tTue, 17 Jan 2023 10:13:17 +0100 (CET)",
            "from szxga02-in.huawei.com (szxga02-in.huawei.com [45.249.212.188])\n by mails.dpdk.org (Postfix) with ESMTP id 0CDB6400D4\n for <dev@dpdk.org>; Tue, 17 Jan 2023 10:13:13 +0100 (CET)",
            "from kwepemi500020.china.huawei.com (unknown [172.30.72.53])\n by szxga02-in.huawei.com (SkyGuard) with ESMTP id 4Nx36J484WzRrGW;\n Tue, 17 Jan 2023 17:11:20 +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.2375.34; Tue, 17 Jan 2023 17:13:11 +0800"
        ],
        "From": "Jie Hai <haijie1@huawei.com>",
        "To": "<honnappa.nagarahalli@arm.com>, <konstantin.v.ananyev@yandex.ru>,\n <dev@dpdk.org>",
        "CC": "<liudongdong3@huawei.com>, <haijie1@huawei.com>",
        "Subject": "[PATCH 2/2] ring: add ring info telemetry cmd",
        "Date": "Tue, 17 Jan 2023 17:10:49 +0800",
        "Message-ID": "<20230117091049.20194-3-haijie1@huawei.com>",
        "X-Mailer": "git-send-email 2.33.0",
        "In-Reply-To": "<20230117091049.20194-1-haijie1@huawei.com>",
        "References": "<20230117091049.20194-1-haijie1@huawei.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[10.69.192.56]",
        "X-ClientProxiedBy": "dggems704-chm.china.huawei.com (10.3.19.181) 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 the info of ring 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\": 0,\n    \"producer_type\": \"MP\",\n    \"consumer_type\": \"MC\",\n    \"size\": 262144,\n    \"mask\": 262143,\n    \"capacity\": 262143,\n    \"used_count\": 147173,\n    \"consumer_tail\": 8283,\n    \"consumer_head\": 8283,\n    \"producer_tail\": 155456,\n    \"producer_head\": 155456,\n    \"mz_name\": \"RG_MP_mb_pool_0\",\n    \"mz_len\": 2097920,\n    \"mz_hugepage_sz\": 1073741824,\n    \"mz_socket_id\": 0,\n    \"mz_flags\": 0\n  }\n}\n\nSigned-off-by: Jie Hai <haijie1@huawei.com>\n---\n lib/ring/rte_ring.c | 88 +++++++++++++++++++++++++++++++++++++++++++++\n 1 file changed, 88 insertions(+)",
    "diff": "diff --git a/lib/ring/rte_ring.c b/lib/ring/rte_ring.c\nindex bb1dafd4d1ca..effdd1fcdba6 100644\n--- a/lib/ring/rte_ring.c\n+++ b/lib/ring/rte_ring.c\n@@ -45,6 +45,9 @@ EAL_REGISTER_TAILQ(rte_ring_tailq)\n /* by default set head/tail distance as 1/8 of ring capacity */\n #define HTD_MAX_DEF\t8\n \n+/* size of name of producer/consumer synchronization modes */\n+#define SYNC_MODE_NAME_SZ\t16\n+\n /* return the size of memory occupied by a ring */\n ssize_t\n rte_ring_get_memsize_elem(unsigned int esize, unsigned int count)\n@@ -454,8 +457,93 @@ ring_handle_list(const char *cmd __rte_unused,\n \treturn 0;\n }\n \n+static void\n+ring_get_sync_name_by_type(struct rte_ring *r, char *prod, char *cons)\n+{\n+\tswitch(r->prod.sync_type) {\n+\tcase RTE_RING_SYNC_MT:\n+\t\tstrcpy(prod, \"MP\");\n+\t\tbreak;\n+\tcase RTE_RING_SYNC_ST:\n+\t\tstrcpy(prod, \"SP\");\n+\t\tbreak;\n+\tcase RTE_RING_SYNC_MT_RTS:\n+\t\tstrcpy(prod, \"MP_RTS\");\n+\t\tbreak;\n+\tcase RTE_RING_SYNC_MT_HTS:\n+\t\tstrcpy(prod, \"MP_HTS\");\n+\t\tbreak;\n+\tdefault:\n+\t\tstrcpy(prod, \"Unknown\");\n+\t}\n+\n+\tswitch(r->cons.sync_type) {\n+\tcase RTE_RING_SYNC_MT:\n+\t\tstrcpy(cons, \"MC\");\n+\t\tbreak;\n+\tcase RTE_RING_SYNC_ST:\n+\t\tstrcpy(cons, \"SC\");\n+\t\tbreak;\n+\tcase RTE_RING_SYNC_MT_RTS:\n+\t\tstrcpy(cons, \"MC_RTS\");\n+\t\tbreak;\n+\tcase RTE_RING_SYNC_MT_HTS:\n+\t\tstrcpy(cons, \"MC_HTS\");\n+\t\tbreak;\n+\tdefault:\n+\t\tstrcpy(cons, \"Unknown\");\n+\t}\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 prod_type[SYNC_MODE_NAME_SZ];\n+\tchar cons_type[SYNC_MODE_NAME_SZ];\n+\tconst struct rte_memzone *mz;\n+\tchar name[RTE_RING_NAMESIZE];\n+\tstruct rte_ring *r;\n+\n+\tif (params == NULL || strlen(params) == 0 ||\n+\t\tstrlen(params) >= RTE_MEMZONE_NAMESIZE)\n+\t\treturn -EINVAL;\n+\n+\tstrlcpy(name, params, RTE_MEMZONE_NAMESIZE);\n+\tr = rte_ring_lookup(name);\n+\tif (r == NULL)\n+\t\treturn -EINVAL;\n+\n+\trte_tel_data_start_dict(d);\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_int(d, \"flags\", r->flags);\n+\tring_get_sync_name_by_type(r, prod_type, cons_type);\n+\trte_tel_data_add_dict_string(d, \"producer_type\", prod_type);\n+\trte_tel_data_add_dict_string(d, \"consumer_type\", cons_type);\n+\trte_tel_data_add_dict_u64(d, \"size\", r->size);\n+\trte_tel_data_add_dict_u64(d, \"mask\", r->mask);\n+\trte_tel_data_add_dict_u64(d, \"capacity\", r->capacity);\n+\trte_tel_data_add_dict_u64(d, \"used_count\", rte_ring_count(r));\n+\trte_tel_data_add_dict_u64(d, \"consumer_tail\", r->cons.tail);\n+\trte_tel_data_add_dict_u64(d, \"consumer_head\", r->cons.head);\n+\trte_tel_data_add_dict_u64(d, \"producer_tail\", r->prod.tail);\n+\trte_tel_data_add_dict_u64(d, \"producer_head\", r->prod.head);\n+\n+\tmz = r->memzone;\n+\trte_tel_data_add_dict_string(d, \"mz_name\", mz->name);\n+\trte_tel_data_add_dict_int(d, \"mz_len\", mz->len);\n+\trte_tel_data_add_dict_int(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_int(d, \"mz_flags\", mz->flags);\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 ring. 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": [
        "2/2"
    ]
}