get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 87151,
    "url": "https://patches.dpdk.org/api/patches/87151/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20210122224327.5621-2-dmitry.kozliuk@gmail.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": "<20210122224327.5621-2-dmitry.kozliuk@gmail.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20210122224327.5621-2-dmitry.kozliuk@gmail.com",
    "date": "2021-01-22T22:43:25",
    "name": "[v9,1/3] pmdinfogen: add Python implementation",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "bc80faf48c881cef95256f76e05049c421bce1fa",
    "submitter": {
        "id": 1581,
        "url": "https://patches.dpdk.org/api/people/1581/?format=api",
        "name": "Dmitry Kozlyuk",
        "email": "dmitry.kozliuk@gmail.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/20210122224327.5621-2-dmitry.kozliuk@gmail.com/mbox/",
    "series": [
        {
            "id": 14913,
            "url": "https://patches.dpdk.org/api/series/14913/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=14913",
            "date": "2021-01-22T22:43:24",
            "name": "pmdinfogen: rewrite in Python",
            "version": 9,
            "mbox": "https://patches.dpdk.org/series/14913/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/87151/comments/",
    "check": "success",
    "checks": "https://patches.dpdk.org/api/patches/87151/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 64266A0A0A;\n\tFri, 22 Jan 2021 23:43:44 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 293BF1411C2;\n\tFri, 22 Jan 2021 23:43:39 +0100 (CET)",
            "from mail-lj1-f182.google.com (mail-lj1-f182.google.com\n [209.85.208.182])\n by mails.dpdk.org (Postfix) with ESMTP id 636941411BF\n for <dev@dpdk.org>; Fri, 22 Jan 2021 23:43:38 +0100 (CET)",
            "by mail-lj1-f182.google.com with SMTP id b10so8338636ljp.6\n for <dev@dpdk.org>; Fri, 22 Jan 2021 14:43:38 -0800 (PST)",
            "from localhost.localdomain (broadband-37-110-65-23.ip.moscow.rt.ru.\n [37.110.65.23])\n by smtp.gmail.com with ESMTPSA id v11sm1119753ljg.128.2021.01.22.14.43.36\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Fri, 22 Jan 2021 14:43:36 -0800 (PST)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;\n h=from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding;\n bh=+wwEn0uvC6ZwE2YT5goyQUlpvw6CXN6BT2E3Ec/kmAM=;\n b=KDpT1+8q12JGU9shCkBpAJwP9P7jxQrLdfYhIPQ1vCJDC+8YmY/b3+XSFt69l5YHaN\n wD2ypPR6QSY96MWZmCxNEpmPrgIjXJDJ/a5hpEhTWwB6ZJ/fNmhrlmyrv6hh9cY9abgI\n VBTr/uPn0Nceg4mavxLR12kR981/Op8SVeub9mk7lNrB12f23BhH8w/pOjmH5Vz80QrD\n Ib9vF1amvyiiXh/FsClqyxUppZU0KNfL1bNdqsUXz0vmQAfBbDyXnyUlrUAJZCS+67r3\n u/P/ZjJ5a9azrj7MC+fF0JdZIE9OIFabd0D9xM704Kb73RwFUdx5AHLrCUhszWmn58mB\n L1fA==",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20161025;\n h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n :references:mime-version:content-transfer-encoding;\n bh=+wwEn0uvC6ZwE2YT5goyQUlpvw6CXN6BT2E3Ec/kmAM=;\n b=K9+5FwZ4/AV0oasxqp8rYv1EpZTMlZgdEQ82ZU/a3vpxFSFRue/vkW6Fc/KpUICIAg\n qFcResAPTx1Rtc4Y691KTemURzYsVJDq6gLS5MC5wsg9Otuyq8QzcJLt4vN5oO9AstZj\n WIvHLzPkUEwdPEnDZYztgU07Ju3Hgk64CILeGvTzlkg79OsH5GcC30aP0jJ6/+qxz6TD\n Qn0f/blYatRiagrsElqSx5tVcd6kf5hKjU78NYC2DNo6zDh/r8mzRLzVoxS9ZMqO9KFw\n GBw4NgK9smLIzMg4DSeyZXoAvzjNCATauo86eiyBUaONKH2ZdzCZ4kN7dUTbNFGUpS+M\n 6HqA==",
        "X-Gm-Message-State": "AOAM532vIdvl5hfa8I37XzEOyYuwQWVq9j/gVEkA+xgd2KnpiHm5boCK\n WimYthkjMH90EoH3dpJqf5b6vv6y5WlnKg==",
        "X-Google-Smtp-Source": "\n ABdhPJyKKjoDyH/ItO2qV4drsDpE9IWvnSCdKlshWAKACjqT4VLJMXb75A320JmmbVRWC6fkHegExA==",
        "X-Received": "by 2002:a2e:5408:: with SMTP id i8mr16589ljb.221.1611355417656;\n Fri, 22 Jan 2021 14:43:37 -0800 (PST)",
        "From": "Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>",
        "To": "dev@dpdk.org",
        "Cc": "Maxime Coquelin <maxime.coquelin@redhat.com>,\n Bruce Richardson <bruce.richardson@intel.com>,\n Thomas Monjalon <thomas@monjalon.net>,\n Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>,\n Neil Horman <nhorman@tuxdriver.com>",
        "Date": "Sat, 23 Jan 2021 01:43:25 +0300",
        "Message-Id": "<20210122224327.5621-2-dmitry.kozliuk@gmail.com>",
        "X-Mailer": "git-send-email 2.29.2",
        "In-Reply-To": "<20210122224327.5621-1-dmitry.kozliuk@gmail.com>",
        "References": "<20201020174404.28653-1-dmitry.kozliuk@gmail.com>\n <20210122224327.5621-1-dmitry.kozliuk@gmail.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [PATCH v9 1/3] pmdinfogen: add Python implementation",
        "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",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "Using a high-level, interpreted language simplifies maintenance and\nbuild process. Furthermore, ELF handling is delegated to pyelftools\npackage. Original logic is kept, the copyright recognizes that.\n\nSigned-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>\n---\n buildtools/pmdinfogen.py | 189 +++++++++++++++++++++++++++++++++++++++\n 1 file changed, 189 insertions(+)\n create mode 100755 buildtools/pmdinfogen.py",
    "diff": "diff --git a/buildtools/pmdinfogen.py b/buildtools/pmdinfogen.py\nnew file mode 100755\nindex 000000000..0cca47ff1\n--- /dev/null\n+++ b/buildtools/pmdinfogen.py\n@@ -0,0 +1,189 @@\n+#!/usr/bin/env python3\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright (c) 2016 Neil Horman <nhorman@tuxdriver.com>\n+# Copyright (c) 2020 Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>\n+\n+import argparse\n+import ctypes\n+import json\n+import sys\n+import tempfile\n+\n+from elftools.elf.elffile import ELFFile\n+from elftools.elf.sections import SymbolTableSection\n+\n+\n+class ELFSymbol:\n+    def __init__(self, image, symbol):\n+        self._image = image\n+        self._symbol = symbol\n+\n+    @property\n+    def size(self):\n+        return self._symbol[\"st_size\"]\n+\n+    @property\n+    def value(self):\n+        data = self._image.get_section_data(self._symbol[\"st_shndx\"])\n+        base = self._symbol[\"st_value\"]\n+        return data[base:base + self.size]\n+\n+    @property\n+    def string_value(self):\n+        value = self.value\n+        return value[:-1].decode() if value else \"\"\n+\n+\n+class ELFImage:\n+    def __init__(self, data):\n+        self._image = ELFFile(data)\n+        self._symtab = self._image.get_section_by_name(\".symtab\")\n+        if not isinstance(self._symtab, SymbolTableSection):\n+            raise Exception(\".symtab section is not a symbol table\")\n+\n+    @property\n+    def is_big_endian(self):\n+        return not self._image.little_endian\n+\n+    def get_section_data(self, name):\n+        return self._image.get_section(name).data()\n+\n+    def find_by_name(self, name):\n+        symbol = self._symtab.get_symbol_by_name(name)\n+        return ELFSymbol(self, symbol[0]) if symbol else None\n+\n+    def find_by_prefix(self, prefix):\n+        for i in range(self._symtab.num_symbols()):\n+            symbol = self._symtab.get_symbol(i)\n+            if symbol.name.startswith(prefix):\n+                yield ELFSymbol(self, symbol)\n+\n+\n+def define_rte_pci_id(is_big_endian):\n+    base_type = ctypes.LittleEndianStructure\n+    if is_big_endian:\n+        base_type = ctypes.BigEndianStructure\n+\n+    class rte_pci_id(base_type):\n+        _pack_ = True\n+        _fields_ = [\n+            (\"class_id\", ctypes.c_uint32),\n+            (\"vendor_id\", ctypes.c_uint16),\n+            (\"device_id\", ctypes.c_uint16),\n+            (\"subsystem_vendor_id\", ctypes.c_uint16),\n+            (\"subsystem_device_id\", ctypes.c_uint16),\n+        ]\n+\n+    return rte_pci_id\n+\n+\n+class Driver:\n+    OPTIONS = [\n+        (\"params\", \"_param_string_export\"),\n+        (\"kmod\", \"_kmod_dep_export\"),\n+    ]\n+\n+    def __init__(self, name, options):\n+        self.name = name\n+        for key, value in options.items():\n+            setattr(self, key, value)\n+        self.pci_ids = []\n+\n+    @classmethod\n+    def load(cls, image, symbol):\n+        name = symbol.string_value\n+\n+        options = {}\n+        for key, suffix in cls.OPTIONS:\n+            option_symbol = image.find_by_name(\"__%s%s\" % (name, suffix))\n+            if option_symbol:\n+                value = option_symbol.string_value\n+                options[key] = value\n+\n+        driver = cls(name, options)\n+\n+        pci_table_name_symbol = image.find_by_name(\"__%s_pci_tbl_export\" % name)\n+        if pci_table_name_symbol:\n+            driver.pci_ids = cls._load_pci_ids(image, pci_table_name_symbol)\n+\n+        return driver\n+\n+    @staticmethod\n+    def _load_pci_ids(image, table_name_symbol):\n+        table_name = table_name_symbol.string_value\n+        table_symbol = image.find_by_name(table_name)\n+        if not table_symbol:\n+            raise Exception(\"PCI table declared but not defined: %d\" % table_name)\n+\n+        rte_pci_id = define_rte_pci_id(image.is_big_endian)\n+\n+        pci_id_size = ctypes.sizeof(rte_pci_id)\n+        pci_ids_desc = rte_pci_id * (table_symbol.size // pci_id_size)\n+        pci_ids = pci_ids_desc.from_buffer_copy(table_symbol.value)\n+        result = []\n+        for pci_id in pci_ids:\n+            if not pci_id.device_id:\n+                break\n+            result.append([\n+                pci_id.vendor_id,\n+                pci_id.device_id,\n+                pci_id.subsystem_vendor_id,\n+                pci_id.subsystem_device_id,\n+                ])\n+        return result\n+\n+    def dump(self, file):\n+        dumped = json.dumps(self.__dict__)\n+        escaped = dumped.replace('\"', '\\\\\"')\n+        print(\n+            'const char %s_pmd_info[] __attribute__((used)) = \"PMD_INFO_STRING= %s\";'\n+            % (self.name, escaped),\n+            file=file,\n+        )\n+\n+\n+def load_drivers(image):\n+    drivers = []\n+    for symbol in image.find_by_prefix(\"this_pmd_name\"):\n+        drivers.append(Driver.load(image, symbol))\n+    return drivers\n+\n+\n+def dump_drivers(drivers, file):\n+    # Keep legacy order of definitions.\n+    for driver in reversed(drivers):\n+        driver.dump(file)\n+\n+\n+def parse_args():\n+    parser = argparse.ArgumentParser()\n+    parser.add_argument(\"input\", help=\"input object file path or '-' for stdin\")\n+    parser.add_argument(\"output\", help=\"output C file path or '-' for stdout\")\n+    return parser.parse_args()\n+\n+\n+def open_input(path):\n+    if path == \"-\":\n+        temp = tempfile.TemporaryFile()\n+        temp.write(sys.stdin.buffer.read())\n+        return temp\n+    return open(path, \"rb\")\n+\n+\n+def open_output(path):\n+    if path == \"-\":\n+        return sys.stdout\n+    return open(path, \"w\")\n+\n+\n+def main():\n+    args = parse_args()\n+    infile = open_input(args.input)\n+    image = ELFImage(infile)\n+    drivers = load_drivers(image)\n+    output = open_output(args.output)\n+    dump_drivers(drivers, output)\n+\n+\n+if __name__ == \"__main__\":\n+    main()\n",
    "prefixes": [
        "v9",
        "1/3"
    ]
}