get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 56048,
    "url": "http://patches.dpdk.org/api/patches/56048/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20190703172512.24909-2-stephen@networkplumber.org/",
    "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": "<20190703172512.24909-2-stephen@networkplumber.org>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20190703172512.24909-2-stephen@networkplumber.org",
    "date": "2019-07-03T17:25:11",
    "name": "[v2,1/2] ethdev: expose basic xstats for driver use",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "4c5f14828b672862dd9b9599348dc632722b877f",
    "submitter": {
        "id": 27,
        "url": "http://patches.dpdk.org/api/people/27/?format=api",
        "name": "Stephen Hemminger",
        "email": "stephen@networkplumber.org"
    },
    "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/20190703172512.24909-2-stephen@networkplumber.org/mbox/",
    "series": [
        {
            "id": 5320,
            "url": "http://patches.dpdk.org/api/series/5320/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=5320",
            "date": "2019-07-03T17:25:10",
            "name": "*failsafe: add xstats",
            "version": 2,
            "mbox": "http://patches.dpdk.org/series/5320/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/56048/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/56048/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@dpdk.org",
        "Delivered-To": "patchwork@dpdk.org",
        "Received": [
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 4B99E2C52;\n\tWed,  3 Jul 2019 19:25:24 +0200 (CEST)",
            "from mail-pg1-f195.google.com (mail-pg1-f195.google.com\n\t[209.85.215.195]) by dpdk.org (Postfix) with ESMTP id B29441D9E\n\tfor <dev@dpdk.org>; Wed,  3 Jul 2019 19:25:21 +0200 (CEST)",
            "by mail-pg1-f195.google.com with SMTP id o13so1563212pgp.12\n\tfor <dev@dpdk.org>; Wed, 03 Jul 2019 10:25:21 -0700 (PDT)",
            "from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127])\n\tby smtp.gmail.com with ESMTPSA id\n\tj11sm4468831pfa.2.2019.07.03.10.25.19\n\t(version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);\n\tWed, 03 Jul 2019 10:25:19 -0700 (PDT)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=networkplumber-org.20150623.gappssmtp.com; s=20150623;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:mime-version:content-transfer-encoding;\n\tbh=/sQRaTqwTeeCAB5ij+tT5EjPQpDSAMkJv/+7LBQYtIo=;\n\tb=GozuP8Cyw38HRwN2Jlz6ehfHbnhKa1D41sSKGYdYuald+jb3/Vzi1UM3hxfvtLom/Y\n\tryLSRku/xil5wp8dVWImaRIVbIpZKmB/vzHVWwbls1SICiFROT4vB8rQjnqhO7LzTpGN\n\toEK22CXTDoNB388WYHjOf0tOeWFo+NwCCnGyJGkeyETrJK8okx/CJ3WbGR7ilBwAsMsK\n\t/oQ3TuO1t2VyqYYRk0HX+kHvfik+i4B5ZuUC4yYsmhBQ1RYyDQtr/VTnMRBp08iLYTXC\n\tcDgeUdSKPylG/rm/u91j7PE9ZZ4Ddg2rKfCnwP1a0bGQZS5wR+mycmcVMXLsAY+yRD8Q\n\t1XnQ==",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references:mime-version:content-transfer-encoding;\n\tbh=/sQRaTqwTeeCAB5ij+tT5EjPQpDSAMkJv/+7LBQYtIo=;\n\tb=sCxM1yKI3OisLzLlk49Scemev4/bOsnOuzxLuq6OG1PUWNaOUWJU/yWNLR0Aa4oxKb\n\tTNpmpSypy+DpwM7XNcqBMhGAKezjOn2O2WRQZhmAQnEnqkf4XKXLrzmqpzg7SumFapk1\n\tvQNccgE47Lc/zlqQ8wxH+HRhjYphcHmC5KsOJl/ImMZHL/srzSF9AjZtnBSKFS53k4p/\n\tbYPbo9fKojm1W50ut0JSbs7ehh9QYm77kXR6wxtC+sDhXLh0RgSnpWVXd0uSc0KwVoqe\n\tS9Fm8poiozrPvvB//0nffSwoQQC8K1R0SWr5dAvEiMcRj+hoV8AlBYFKSiQUcUbZSSHn\n\t3Gew==",
        "X-Gm-Message-State": "APjAAAXP7UGsXsPzf0FKS+XU7+fka7gTwA1YmRRAOrqe1Kpbujqd0BKp\n\t7SMgb/WdX0ohuLLIqQdHOQBnkut7",
        "X-Google-Smtp-Source": "APXvYqxwl+yZLlc1lu4WBPbgsgwerhMjYbSfjZDju98udrKEbDBpyYjaBNVoCZKNei7cx72TC1aAQA==",
        "X-Received": "by 2002:a17:90a:ad86:: with SMTP id\n\ts6mr14156631pjq.42.1562174720872; \n\tWed, 03 Jul 2019 10:25:20 -0700 (PDT)",
        "From": "Stephen Hemminger <stephen@networkplumber.org>",
        "To": "gaetan.rivet@6wind.com,\n\tarybchenko@solarflare.com",
        "Cc": "dev@dpdk.org,\n\tStephen Hemminger <stephen@networkplumber.org>",
        "Date": "Wed,  3 Jul 2019 10:25:11 -0700",
        "Message-Id": "<20190703172512.24909-2-stephen@networkplumber.org>",
        "X-Mailer": "git-send-email 2.20.1",
        "In-Reply-To": "<20190703172512.24909-1-stephen@networkplumber.org>",
        "References": "<20190626222135.11368-1-stephen@networkplumber.org>\n\t<20190703172512.24909-1-stephen@networkplumber.org>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [PATCH v2 1/2] ethdev: expose basic xstats for driver use",
        "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\t<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\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "Avoid duplication by having generic basic xstats available\nfor use by drivers. A later patch uses this for failsafe\ndriver.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n lib/librte_ethdev/rte_ethdev.c           | 17 +++----\n lib/librte_ethdev/rte_ethdev_driver.h    | 65 ++++++++++++++++++++++++\n lib/librte_ethdev/rte_ethdev_version.map |  3 ++\n 3 files changed, 76 insertions(+), 9 deletions(-)",
    "diff": "diff --git a/lib/librte_ethdev/rte_ethdev.c b/lib/librte_ethdev/rte_ethdev.c\nindex 31f02ec2ba3b..82fcac57b1a7 100644\n--- a/lib/librte_ethdev/rte_ethdev.c\n+++ b/lib/librte_ethdev/rte_ethdev.c\n@@ -1996,8 +1996,8 @@ rte_eth_stats_reset(uint16_t port_id)\n \treturn 0;\n }\n \n-static inline int\n-get_xstats_basic_count(struct rte_eth_dev *dev)\n+int\n+rte_eth_basic_stats_count(struct rte_eth_dev *dev)\n {\n \tuint16_t nb_rxqs, nb_txqs;\n \tint count;\n@@ -2034,7 +2034,7 @@ get_xstats_count(uint16_t port_id)\n \t\tcount = 0;\n \n \n-\tcount += get_xstats_basic_count(dev);\n+\tcount += rte_eth_basic_stats_count(dev);\n \n \treturn count;\n }\n@@ -2084,7 +2084,7 @@ rte_eth_xstats_get_id_by_name(uint16_t port_id, const char *xstat_name,\n }\n \n /* retrieve basic stats names */\n-static int\n+int\n rte_eth_basic_stats_get_names(struct rte_eth_dev *dev,\n \tstruct rte_eth_xstat_name *xstats_names)\n {\n@@ -2140,7 +2140,7 @@ rte_eth_xstats_get_names_by_id(uint16_t port_id,\n \tRTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV);\n \tdev = &rte_eth_devices[port_id];\n \n-\tbasic_count = get_xstats_basic_count(dev);\n+\tbasic_count = rte_eth_basic_stats_count(dev);\n \tret = get_xstats_count(port_id);\n \tif (ret < 0)\n \t\treturn ret;\n@@ -2268,8 +2268,7 @@ rte_eth_xstats_get_names(uint16_t port_id,\n \treturn cnt_used_entries;\n }\n \n-\n-static int\n+int\n rte_eth_basic_stats_get(uint16_t port_id, struct rte_eth_xstat *xstats)\n {\n \tstruct rte_eth_dev *dev;\n@@ -2341,7 +2340,7 @@ rte_eth_xstats_get_by_id(uint16_t port_id, const uint64_t *ids,\n \texpected_entries = (uint16_t)ret;\n \tstruct rte_eth_xstat xstats[expected_entries];\n \tdev = &rte_eth_devices[port_id];\n-\tbasic_count = get_xstats_basic_count(dev);\n+\tbasic_count = rte_eth_basic_stats_count(dev);\n \n \t/* Return max number of stats if no ids given */\n \tif (!ids) {\n@@ -2355,7 +2354,7 @@ rte_eth_xstats_get_by_id(uint16_t port_id, const uint64_t *ids,\n \t\treturn -EINVAL;\n \n \tif (ids && dev->dev_ops->xstats_get_by_id != NULL && size) {\n-\t\tunsigned int basic_count = get_xstats_basic_count(dev);\n+\t\tunsigned int basic_count = rte_eth_basic_stats_count(dev);\n \t\tuint64_t ids_copy[size];\n \n \t\tfor (i = 0; i < size; i++) {\ndiff --git a/lib/librte_ethdev/rte_ethdev_driver.h b/lib/librte_ethdev/rte_ethdev_driver.h\nindex 936ff8c98651..489889a72203 100644\n--- a/lib/librte_ethdev/rte_ethdev_driver.h\n+++ b/lib/librte_ethdev/rte_ethdev_driver.h\n@@ -208,6 +208,71 @@ rte_eth_linkstatus_get(const struct rte_eth_dev *dev,\n #endif\n }\n \n+/**\n+ * @internal\n+ * Get basic stats part of xstats for an ethernet device.\n+ *\n+ * @param dev\n+ *  Pointer to struct rte_eth_dev.\n+ */\n+__rte_experimental\n+int\n+rte_eth_basic_stats_count(struct rte_eth_dev *dev);\n+\n+/**\n+ * @internal\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Retrieve the names for the basic part of extended statistics.\n+ *\n+ * @param dev\n+ *  Pointer to struct rte_eth_dev.\n+ * @param xstats_names\n+ *   An rte_eth_xstat_name array of at least *size* elements to\n+ *   be filled. If set to NULL, the function returns the required number\n+ *   of elements.\n+ * @return\n+ *   - A positive value lower or equal to size: success. The return value\n+ *     is the number of entries filled in the stats table.\n+ *   - A positive value higher than size: error, the given statistics table\n+ *     is too small. The return value corresponds to the size that should\n+ *     be given to succeed. The entries in the table are not valid and\n+ *     shall not be used by the caller.\n+ *   - A negative value on error (invalid port id).\n+ */\n+__rte_experimental\n+int\n+rte_eth_basic_stats_get_names(struct rte_eth_dev *dev,\n+\t\t\t      struct rte_eth_xstat_name *xstats_names);\n+\n+/**\n+ * @internal\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Retrieve the basic part of the extended statistics.\n+ *\n+ * @param dev\n+ *  Pointer to struct rte_eth_dev.\n+ * @param xstats\n+ *   A pointer to a table of structure of type *rte_eth_xstat*\n+ *   to be filled with device statistics ids and values.\n+ *   This parameter can be set to NULL if n is 0.\n+ * @param n\n+ *   The size of the xstats array (number of elements).\n+ * @return\n+ *   - A positive value lower or equal to n: success. The return value\n+ *     is the number of entries filled in the stats table.\n+ *   - A positive value higher than n: error, the given statistics table\n+ *     is too small. The return value corresponds to the size that should\n+ *     be given to succeed. The entries in the table are not valid and\n+ *     shall not be used by the caller.\n+ *   - A negative value on error (invalid port id).\n+ */\n+__rte_experimental\n+int\n+rte_eth_basic_stats_get(uint16_t port_id, struct rte_eth_xstat *xstats);\n+\n+\n /**\n  * @warning\n  * @b EXPERIMENTAL: this API may change without prior notice.\ndiff --git a/lib/librte_ethdev/rte_ethdev_version.map b/lib/librte_ethdev/rte_ethdev_version.map\nindex df9141825c3f..949a79800cbc 100644\n--- a/lib/librte_ethdev/rte_ethdev_version.map\n+++ b/lib/librte_ethdev/rte_ethdev_version.map\n@@ -239,6 +239,9 @@ DPDK_19.05 {\n EXPERIMENTAL {\n \tglobal:\n \n+\trte_eth_basic_stats_count;\n+\trte_eth_basic_stats_get;\n+\trte_eth_basic_stats_get_names;\n \trte_eth_devargs_parse;\n \trte_eth_dev_create;\n \trte_eth_dev_destroy;\n",
    "prefixes": [
        "v2",
        "1/2"
    ]
}