get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 69019,
    "url": "http://patches.dpdk.org/api/patches/69019/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20200421123949.38270-9-ciara.power@intel.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": "<20200421123949.38270-9-ciara.power@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20200421123949.38270-9-ciara.power@intel.com",
    "date": "2020-04-21T12:39:40",
    "name": "[v3,08/17] ethdev: add callback support for telemetry",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "15735bc9c4f6bb7a641618087cd9401f112ab5cf",
    "submitter": {
        "id": 978,
        "url": "http://patches.dpdk.org/api/people/978/?format=api",
        "name": "Power, Ciara",
        "email": "ciara.power@intel.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/20200421123949.38270-9-ciara.power@intel.com/mbox/",
    "series": [
        {
            "id": 9543,
            "url": "http://patches.dpdk.org/api/series/9543/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=9543",
            "date": "2020-04-21T12:39:32",
            "name": "update and simplify telemetry library.",
            "version": 3,
            "mbox": "http://patches.dpdk.org/series/9543/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/69019/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/69019/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 dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id B7545A0597;\n\tTue, 21 Apr 2020 15:01:22 +0200 (CEST)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id AC1FA1D5D4;\n\tTue, 21 Apr 2020 14:59:46 +0200 (CEST)",
            "from mga11.intel.com (mga11.intel.com [192.55.52.93])\n by dpdk.org (Postfix) with ESMTP id DC8661D5B0\n for <dev@dpdk.org>; Tue, 21 Apr 2020 14:59:43 +0200 (CEST)",
            "from fmsmga004.fm.intel.com ([10.253.24.48])\n by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 21 Apr 2020 05:59:43 -0700",
            "from silpixa00399953.ir.intel.com (HELO\n silpixa00399953.ger.corp.intel.com) ([10.237.222.53])\n by fmsmga004.fm.intel.com with ESMTP; 21 Apr 2020 05:59:41 -0700"
        ],
        "IronPort-SDR": [
            "\n aBADhjAvA+6HfJEP8oVx5FlV+o/wFjs6wcG7K5VGIlmlnz9WLyKiJq9MqPy7pbmHu3FlojkX5P\n 6AlcY133jsNw==",
            "\n K+UVkIS+hEVVywRRkKUmQqCfk5CUoEO8iKWg/6qcjmQnXc8ZCCSlp07xITR1b2jdpuyMBEVQsR\n /meXL+qP9TXA=="
        ],
        "X-Amp-Result": "SKIPPED(no attachment in message)",
        "X-Amp-File-Uploaded": "False",
        "X-ExtLoop1": "1",
        "X-IronPort-AV": "E=Sophos;i=\"5.72,410,1580803200\"; d=\"scan'208\";a=\"279629136\"",
        "From": "Ciara Power <ciara.power@intel.com>",
        "To": "dev@dpdk.org,\n\tkevin.laatz@intel.com",
        "Cc": "reshma.pattan@intel.com, jerinjacobk@gmail.com, david.marchand@redhat.com,\n keith.wiles@intel.com, mb@smartsharesystems.com, thomas@monjalon.net,\n Bruce Richardson <bruce.richardson@intel.com>,\n Ciara Power <ciara.power@intel.com>",
        "Date": "Tue, 21 Apr 2020 13:39:40 +0100",
        "Message-Id": "<20200421123949.38270-9-ciara.power@intel.com>",
        "X-Mailer": "git-send-email 2.17.1",
        "In-Reply-To": "<20200421123949.38270-1-ciara.power@intel.com>",
        "References": "<20200319171907.60891-1-ciara.power@intel.com>\n <20200421123949.38270-1-ciara.power@intel.com>",
        "Subject": "[dpdk-dev] [PATCH v3 08/17] ethdev: add callback support for\n\ttelemetry",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.15",
        "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",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "From: Bruce Richardson <bruce.richardson@intel.com>\n\nThe ethdev library now registers commands with telemetry, and\nimplements the callback functions. These commands allow the list of\nethdev ports and the stats and link status for a port to be queried.\n\nSigned-off-by: Bruce Richardson <bruce.richardson@intel.com>\nSigned-off-by: Ciara Power <ciara.power@intel.com>\n\n---\nv2:\n  - Renamed stats to xstats for device specific stats.\n  - Added link status command for ethdev ports.\n---\n lib/librte_ethdev/Makefile     |   4 ++\n lib/librte_ethdev/meson.build  |   4 ++\n lib/librte_ethdev/rte_ethdev.c | 105 +++++++++++++++++++++++++++++++++\n 3 files changed, 113 insertions(+)",
    "diff": "diff --git a/lib/librte_ethdev/Makefile b/lib/librte_ethdev/Makefile\nindex 943fb8c877..ab83d45acf 100644\n--- a/lib/librte_ethdev/Makefile\n+++ b/lib/librte_ethdev/Makefile\n@@ -23,6 +23,10 @@ SRCS-y += rte_tm.c\n SRCS-y += rte_mtr.c\n SRCS-y += ethdev_profile.c\n \n+ifeq ($(CONFIG_RTE_LIBRTE_TELEMETRY),y)\n+LDLIBS += -lrte_telemetry\n+endif\n+\n #\n # Export include files\n #\ndiff --git a/lib/librte_ethdev/meson.build b/lib/librte_ethdev/meson.build\nindex ab341d9c04..0e9d3497a0 100644\n--- a/lib/librte_ethdev/meson.build\n+++ b/lib/librte_ethdev/meson.build\n@@ -25,3 +25,7 @@ headers = files('rte_ethdev.h',\n \t'rte_tm_driver.h')\n \n deps += ['net', 'kvargs', 'meter']\n+\n+if dpdk_conf.has('RTE_LIBRTE_TELEMETRY')\n+\tdeps += ['telemetry']\n+endif\ndiff --git a/lib/librte_ethdev/rte_ethdev.c b/lib/librte_ethdev/rte_ethdev.c\nindex 0854ef8832..fd63104e5d 100644\n--- a/lib/librte_ethdev/rte_ethdev.c\n+++ b/lib/librte_ethdev/rte_ethdev.c\n@@ -38,6 +38,9 @@\n #include <rte_kvargs.h>\n #include <rte_class.h>\n #include <rte_ether.h>\n+#ifdef RTE_LIBRTE_TELEMETRY\n+#include <rte_telemetry.h>\n+#endif\n \n #include \"rte_ethdev.h\"\n #include \"rte_ethdev_driver.h\"\n@@ -5189,9 +5192,111 @@ rte_eth_devargs_parse(const char *dargs, struct rte_eth_devargs *eth_da)\n \treturn result;\n }\n \n+#ifdef RTE_LIBRTE_TELEMETRY\n+static int\n+handle_port_list(const char *cmd __rte_unused,\n+\t\tconst char *params __rte_unused,\n+\t\tchar *buffer, int buf_len)\n+{\n+\tint port_id, used = 0;\n+\n+\tused = rte_tel_json_empty_array(buffer, buf_len, used);\n+\tRTE_ETH_FOREACH_DEV(port_id)\n+\t\tused = rte_tel_json_add_array_int(buffer, buf_len, used,\n+\t\t\t\tport_id);\n+\treturn used;\n+}\n+\n+static int\n+handle_port_xstats(const char *cmd __rte_unused,\n+\t\tconst char *params,\n+\t\tchar *buffer, int buf_len)\n+{\n+\tstruct rte_eth_xstat *eth_xstats;\n+\tstruct rte_eth_xstat_name *xstat_names;\n+\tint port_id, num_xstats;\n+\tint i, ret;\n+\tint used = 0;\n+\n+\tif (params == NULL || strlen(params) == 0 || !isdigit(*params))\n+\t\treturn -1;\n+\n+\tport_id = atoi(params);\n+\tif (!rte_eth_dev_is_valid_port(port_id))\n+\t\treturn -1;\n+\n+\tnum_xstats = rte_eth_xstats_get(port_id, NULL, 0);\n+\tif (num_xstats < 0)\n+\t\treturn -1;\n+\n+\t/* use one malloc for both names and stats */\n+\teth_xstats = malloc((sizeof(struct rte_eth_xstat) +\n+\t\t\tsizeof(struct rte_eth_xstat_name)) * num_xstats);\n+\tif (eth_xstats == NULL)\n+\t\treturn -1;\n+\txstat_names = (void *)&eth_xstats[num_xstats];\n+\n+\tret = rte_eth_xstats_get_names(port_id, xstat_names, num_xstats);\n+\tif (ret < 0 || ret > num_xstats) {\n+\t\tfree(eth_xstats);\n+\t\treturn -1;\n+\t}\n+\n+\tret = rte_eth_xstats_get(port_id, eth_xstats, num_xstats);\n+\tif (ret < 0 || ret > num_xstats) {\n+\t\tfree(eth_xstats);\n+\t\treturn -1;\n+\t}\n+\n+\tused = rte_tel_json_empty_obj(buffer, buf_len, used);\n+\tfor (i = 0; i < num_xstats; i++)\n+\t\tused = rte_tel_json_add_obj_u64(buffer, buf_len, used,\n+\t\t\t\txstat_names[i].name, eth_xstats[i].value);\n+\n+\treturn used;\n+}\n+\n+static int\n+handle_port_link_status(const char *cmd __rte_unused,\n+\t\tconst char *params,\n+\t\tchar *buffer, int buf_len)\n+{\n+\tint ret, port_id;\n+\tstruct rte_eth_link link;\n+\n+\tif (params == NULL || strlen(params) == 0 || !isdigit(*params))\n+\t\treturn -1;\n+\n+\tport_id = atoi(params);\n+\tif (!rte_eth_dev_is_valid_port(port_id))\n+\t\treturn -1;\n+\n+\tret = rte_eth_link_get(port_id, &link);\n+\tif (ret < 0)\n+\t\treturn -1;\n+\n+\tif (link.link_status)\n+\t\tret = snprintf(buffer, buf_len,\n+\t\t\t\t\"{\\\"status\\\":\\\"UP\\\",\\\"speed\\\":%u,\\\"duplex\\\":\"\n+\t\t\t\t\"\\\"%s\\\"}\", link.link_speed,\n+\t\t\t\t(link.link_duplex == ETH_LINK_FULL_DUPLEX) ?\n+\t\t\t\t(\"full-duplex\") : (\"half-duplex\"));\n+\telse\n+\t\tret = snprintf(buffer, buf_len, \"{\\\"status\\\":\\\"DOWN\\\"}\");\n+\n+\treturn ret >= buf_len ? -1 : ret;\n+}\n+#endif\n+\n RTE_INIT(ethdev_init_log)\n {\n \trte_eth_dev_logtype = rte_log_register(\"lib.ethdev\");\n \tif (rte_eth_dev_logtype >= 0)\n \t\trte_log_set_level(rte_eth_dev_logtype, RTE_LOG_INFO);\n+#ifdef RTE_LIBRTE_TELEMETRY\n+\trte_telemetry_register_cmd(\"/ethdev/list\", handle_port_list);\n+\trte_telemetry_register_cmd(\"/ethdev/xstats\", handle_port_xstats);\n+\trte_telemetry_register_cmd(\"/ethdev/link_status\",\n+\t\t\thandle_port_link_status);\n+#endif\n }\n",
    "prefixes": [
        "v3",
        "08/17"
    ]
}