get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 42903,
    "url": "http://patches.dpdk.org/api/patches/42903/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/806fcb35c84d6e8c0f8479c7714a1d8505b5d440.1531345404.git.gaetan.rivet@6wind.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": "<806fcb35c84d6e8c0f8479c7714a1d8505b5d440.1531345404.git.gaetan.rivet@6wind.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/806fcb35c84d6e8c0f8479c7714a1d8505b5d440.1531345404.git.gaetan.rivet@6wind.com",
    "date": "2018-07-11T21:45:00",
    "name": "[v11,10/25] eal/dev: implement device iteration initialization",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": true,
    "hash": "d52950f9b8a6eccce8a7d0545849bdc297e57fd8",
    "submitter": {
        "id": 269,
        "url": "http://patches.dpdk.org/api/people/269/?format=api",
        "name": "Gaëtan Rivet",
        "email": "gaetan.rivet@6wind.com"
    },
    "delegate": null,
    "mbox": "http://patches.dpdk.org/project/dpdk/patch/806fcb35c84d6e8c0f8479c7714a1d8505b5d440.1531345404.git.gaetan.rivet@6wind.com/mbox/",
    "series": [
        {
            "id": 533,
            "url": "http://patches.dpdk.org/api/series/533/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=533",
            "date": "2018-07-11T21:44:50",
            "name": "Device querying",
            "version": 11,
            "mbox": "http://patches.dpdk.org/series/533/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/42903/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/42903/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 F13411B5BC;\n\tWed, 11 Jul 2018 23:46:00 +0200 (CEST)",
            "from mail-wr1-f67.google.com (mail-wr1-f67.google.com\n\t[209.85.221.67]) by dpdk.org (Postfix) with ESMTP id 135521B54B\n\tfor <dev@dpdk.org>; Wed, 11 Jul 2018 23:45:51 +0200 (CEST)",
            "by mail-wr1-f67.google.com with SMTP id c13-v6so19558163wrt.1\n\tfor <dev@dpdk.org>; Wed, 11 Jul 2018 14:45:51 -0700 (PDT)",
            "from bidouze.dev.6wind.com. (host.78.145.23.62.rev.coltfrance.com.\n\t[62.23.145.78]) by smtp.gmail.com with ESMTPSA id\n\th5-v6sm10550936wrr.19.2018.07.11.14.45.49\n\t(version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);\n\tWed, 11 Jul 2018 14:45:49 -0700 (PDT)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=6wind-com.20150623.gappssmtp.com; s=20150623;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references;\n\tbh=yXVPuQbXIM7PPzxvuLOIBdECBu+SGT4tTjEn838vlUA=;\n\tb=1M0bgxYD+Cbeg925PnWHEp5AAJDxNQAAF+yJEa/AgRWdE8Dx/b3IWVc2zO52dzZvj7\n\tbW26OUactP33kc9V5dK1kD1AhjqC3hCI7dK6d6j6O2xCF+PoCvpAqnzsX9QVtU8LxGNb\n\tITwgu9v/u54kcDeS+MXPSaF9X1/KIrX3B02QZRdmEPYMcWsHeuJ+GtgYLux/Vz/FJnw7\n\tFoQYJGgomwtB911ZYiXqQQtcASo2sKnAa1HUEqS78/2o11nERuklPkPJJPNs/yxA2e5B\n\t+MWMvTTVRFoQP1TRj5WioM/tJD3PnS3ZH7Dc4JsVfKVhbautFNBtBuUlH9UMsEpwHu2P\n\tkU3w==",
        "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;\n\tbh=yXVPuQbXIM7PPzxvuLOIBdECBu+SGT4tTjEn838vlUA=;\n\tb=PfiQsRmetGXAupR/PP9UvBPa57IKeTE4X/vlPJKObY6wCwJmjJElSK55JCc2Vc2O2u\n\tMrgwOd5leS2WyWUEA08m0Rfzqht/Ubp6yv7BewwjSy5pd90QVWZT8w9OsmRVtM8JH0rX\n\t1XJFWAkLw+fmIsSJdSTT9kgzc5s4NKfgj4lcqEiE00k19Ro4/FLhvM9upc91bafP+QFf\n\tiEd5ZJySa8s7Q7XCqXElMOinM3KLY2vvxn4yjISLm99oe9KDAIavkXWe1eQinTXAAYDf\n\tGVXykb0CCkN3piSxsLwdiZI8VZWNQCQQ6VUjT5oRUqUPHbANoB+P1BwOdj5x3KuEhneG\n\tImTQ==",
        "X-Gm-Message-State": "AOUpUlG+U8ealGxh0xzF6T+v+DQcmX/T58vaUddo8bpdU5b2YW1y0kOP\n\tlxxl6vFkXD/7acl6Dssl/vL30zy6",
        "X-Google-Smtp-Source": "AAOMgpf0uztanZjZXugGNHw9csFqLeeDyrAsOVRq+1W0DfQRl4g7s9Nn+s5HStu4jqH6IIzqJaxH1Q==",
        "X-Received": "by 2002:adf:fc86:: with SMTP id\n\tg6-v6mr213370wrr.216.1531345550260; \n\tWed, 11 Jul 2018 14:45:50 -0700 (PDT)",
        "From": "Gaetan Rivet <gaetan.rivet@6wind.com>",
        "To": "dev@dpdk.org",
        "Cc": "Gaetan Rivet <gaetan.rivet@6wind.com>",
        "Date": "Wed, 11 Jul 2018 23:45:00 +0200",
        "Message-Id": "<806fcb35c84d6e8c0f8479c7714a1d8505b5d440.1531345404.git.gaetan.rivet@6wind.com>",
        "X-Mailer": "git-send-email 2.18.0",
        "In-Reply-To": "<cover.1531345404.git.gaetan.rivet@6wind.com>",
        "References": "<cover.1531345404.git.gaetan.rivet@6wind.com>",
        "Subject": "[dpdk-dev] [PATCH v11 10/25] eal/dev: implement device iteration\n\tinitialization",
        "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": "Parse a device description.\nSplit this description in their relevant part for each layers.\nNo dynamic allocation is performed.\n\nSigned-off-by: Gaetan Rivet <gaetan.rivet@6wind.com>\n---\n lib/Makefile                            |  1 +\n lib/librte_eal/bsdapp/eal/Makefile      |  1 +\n lib/librte_eal/common/eal_common_dev.c  | 55 +++++++++++++++++++++++++\n lib/librte_eal/common/include/rte_dev.h | 24 +++++++++++\n lib/librte_eal/linuxapp/eal/Makefile    |  1 +\n lib/librte_eal/rte_eal_version.map      |  1 +\n 6 files changed, 83 insertions(+)",
    "diff": "diff --git a/lib/Makefile b/lib/Makefile\nindex 8a65525cd..afa604e20 100644\n--- a/lib/Makefile\n+++ b/lib/Makefile\n@@ -7,6 +7,7 @@ DIRS-y += librte_compat\n DIRS-$(CONFIG_RTE_LIBRTE_KVARGS) += librte_kvargs\n DEPDIRS-librte_kvargs := librte_compat\n DIRS-$(CONFIG_RTE_LIBRTE_EAL) += librte_eal\n+DEPDIRS-librte_eal := librte_kvargs\n DIRS-$(CONFIG_RTE_LIBRTE_PCI) += librte_pci\n DEPDIRS-librte_pci := librte_eal\n DIRS-$(CONFIG_RTE_LIBRTE_RING) += librte_ring\ndiff --git a/lib/librte_eal/bsdapp/eal/Makefile b/lib/librte_eal/bsdapp/eal/Makefile\nindex b0a1c880a..67b10ae0d 100644\n--- a/lib/librte_eal/bsdapp/eal/Makefile\n+++ b/lib/librte_eal/bsdapp/eal/Makefile\n@@ -18,6 +18,7 @@ CFLAGS += $(WERROR_FLAGS) -O3\n LDLIBS += -lexecinfo\n LDLIBS += -lpthread\n LDLIBS += -lgcc_s\n+LDLIBS += -lrte_kvargs\n \n EXPORT_MAP := ../../rte_eal_version.map\n \ndiff --git a/lib/librte_eal/common/eal_common_dev.c b/lib/librte_eal/common/eal_common_dev.c\nindex ce4b51469..63e329bd8 100644\n--- a/lib/librte_eal/common/eal_common_dev.c\n+++ b/lib/librte_eal/common/eal_common_dev.c\n@@ -10,9 +10,12 @@\n \n #include <rte_compat.h>\n #include <rte_bus.h>\n+#include <rte_class.h>\n #include <rte_dev.h>\n #include <rte_devargs.h>\n #include <rte_debug.h>\n+#include <rte_errno.h>\n+#include <rte_kvargs.h>\n #include <rte_log.h>\n #include <rte_spinlock.h>\n #include <rte_malloc.h>\n@@ -343,3 +346,55 @@ dev_callback_process(char *device_name, enum rte_dev_event_type event)\n \t}\n \trte_spinlock_unlock(&dev_event_lock);\n }\n+\n+__rte_experimental\n+int\n+rte_dev_iterator_init(struct rte_dev_iterator *it,\n+\t\t      const char *dev_str)\n+{\n+\tstruct rte_devargs devargs;\n+\tstruct rte_class *cls = NULL;\n+\tstruct rte_bus *bus = NULL;\n+\n+\t/* Having both bus_str and cls_str NULL is illegal,\n+\t * marking this iterator as invalid unless\n+\t * everything goes well.\n+\t */\n+\tit->bus_str = NULL;\n+\tit->cls_str = NULL;\n+\n+\tdevargs.data = dev_str;\n+\tif (rte_devargs_layers_parse(&devargs, dev_str))\n+\t\tgoto get_out;\n+\n+\tbus = devargs.bus;\n+\tcls = devargs.cls;\n+\t/* The string should have at least\n+\t * one layer specified.\n+\t */\n+\tif (bus == NULL && cls == NULL) {\n+\t\tRTE_LOG(ERR, EAL,\n+\t\t\t\"Either bus or class must be specified.\\n\");\n+\t\trte_errno = EINVAL;\n+\t\tgoto get_out;\n+\t}\n+\tif (bus != NULL && bus->dev_iterate == NULL) {\n+\t\tRTE_LOG(ERR, EAL, \"Bus %s not supported\\n\", bus->name);\n+\t\trte_errno = ENOTSUP;\n+\t\tgoto get_out;\n+\t}\n+\tif (cls != NULL && cls->dev_iterate == NULL) {\n+\t\tRTE_LOG(ERR, EAL, \"Class %s not supported\\n\", cls->name);\n+\t\trte_errno = ENOTSUP;\n+\t\tgoto get_out;\n+\t}\n+\tit->bus_str = devargs.bus_str;\n+\tit->cls_str = devargs.cls_str;\n+\tit->dev_str = dev_str;\n+\tit->bus = bus;\n+\tit->cls = cls;\n+\tit->device = NULL;\n+\tit->class_device = NULL;\n+get_out:\n+\treturn -rte_errno;\n+}\ndiff --git a/lib/librte_eal/common/include/rte_dev.h b/lib/librte_eal/common/include/rte_dev.h\nindex 49000abac..fdc812ff8 100644\n--- a/lib/librte_eal/common/include/rte_dev.h\n+++ b/lib/librte_eal/common/include/rte_dev.h\n@@ -331,6 +331,30 @@ typedef void *(*rte_dev_iterate_t)(const void *start,\n \t\t\t\t   const char *devstr,\n \t\t\t\t   const struct rte_dev_iterator *it);\n \n+/**\n+ * Initializes a device iterator.\n+ *\n+ * This iterator allows accessing a list of devices matching a criteria.\n+ * The device matching is made among all buses and classes currently registered,\n+ * filtered by the device description given as parameter.\n+ *\n+ * This function will not allocate any memory. It is safe to stop the\n+ * iteration at any moment and let the iterator go out of context.\n+ *\n+ * @param it\n+ *   Device iterator handle.\n+ *\n+ * @param str\n+ *   Device description string.\n+ *\n+ * @return\n+ *   0 on successful initialization.\n+ *   <0 on error.\n+ */\n+__rte_experimental\n+int\n+rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);\n+\n #ifdef __cplusplus\n }\n #endif\ndiff --git a/lib/librte_eal/linuxapp/eal/Makefile b/lib/librte_eal/linuxapp/eal/Makefile\nindex babc8617a..885c48110 100644\n--- a/lib/librte_eal/linuxapp/eal/Makefile\n+++ b/lib/librte_eal/linuxapp/eal/Makefile\n@@ -27,6 +27,7 @@ LDLIBS += -lrt\n ifeq ($(CONFIG_RTE_EAL_NUMA_AWARE_HUGEPAGES),y)\n LDLIBS += -lnuma\n endif\n+LDLIBS += -lrte_kvargs\n \n # specific to linuxapp exec-env\n SRCS-$(CONFIG_RTE_EXEC_ENV_LINUXAPP) := eal.c\ndiff --git a/lib/librte_eal/rte_eal_version.map b/lib/librte_eal/rte_eal_version.map\nindex 19d36b4c7..ac04120d6 100644\n--- a/lib/librte_eal/rte_eal_version.map\n+++ b/lib/librte_eal/rte_eal_version.map\n@@ -251,6 +251,7 @@ EXPERIMENTAL {\n \trte_dev_event_callback_unregister;\n \trte_dev_event_monitor_start;\n \trte_dev_event_monitor_stop;\n+\trte_dev_iterator_init;\n \trte_devargs_add;\n \trte_devargs_dump;\n \trte_devargs_insert;\n",
    "prefixes": [
        "v11",
        "10/25"
    ]
}