get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 85035,
    "url": "https://patches.dpdk.org/api/patches/85035/?format=api",
    "web_url": "https://patches.dpdk.org/project/dpdk/patch/20201212233447.23154-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": "<20201212233447.23154-2-dmitry.kozliuk@gmail.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20201212233447.23154-2-dmitry.kozliuk@gmail.com",
    "date": "2020-12-12T23:34:44",
    "name": "[1/4] pmdinfogen: support COFF",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "628cbe6cb0b7c177870023fd6ed1d8257a382c95",
    "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/20201212233447.23154-2-dmitry.kozliuk@gmail.com/mbox/",
    "series": [
        {
            "id": 14274,
            "url": "https://patches.dpdk.org/api/series/14274/?format=api",
            "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=14274",
            "date": "2020-12-12T23:34:43",
            "name": "pmdinfogen: support Windows",
            "version": 1,
            "mbox": "https://patches.dpdk.org/series/14274/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/85035/comments/",
    "check": "success",
    "checks": "https://patches.dpdk.org/api/patches/85035/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 78C36A0524;\n\tSun, 13 Dec 2020 00:35:20 +0100 (CET)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id F2BBAC962;\n\tSun, 13 Dec 2020 00:35:00 +0100 (CET)",
            "from mail-lf1-f44.google.com (mail-lf1-f44.google.com\n [209.85.167.44]) by dpdk.org (Postfix) with ESMTP id 6ABE94C7B\n for <dev@dpdk.org>; Sun, 13 Dec 2020 00:34:59 +0100 (CET)",
            "by mail-lf1-f44.google.com with SMTP id u18so20911721lfd.9\n for <dev@dpdk.org>; Sat, 12 Dec 2020 15:34:59 -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 b22sm1517930lfp.233.2020.12.12.15.34.56\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Sat, 12 Dec 2020 15:34:57 -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=r4nlXmJ5anekRUqJKbh2YrEXYyuLN+txtYxN7CWsNPc=;\n b=fOisq9bZCW/H/qgIwOw6Q0RHzy2/ffLMj2s/O9YQwXq/dsNDQMKwKzrrygyEd0K5wr\n wALVIXj0iw+S2fzQ2SyRysajk+gDuND70djH2Pe6G7Wcs4PfBoLKqRe0SS5BzEukacrS\n qvIzMfrpY/KlR5zY9re2OjpKoOwY1dbm87+T+FqO5MFHS4badiu+119icmLZBcQgy7ur\n 4K4FGxNI+el+AgpDUsV0iAGuiq5ViGe1eOJ7NtME3ZJdwVaVnO9MU0SPmDrs94ShcA5i\n ARdv56xkNUTtnBnh2DNcyUYAOA/Oqt6vu0EDmcxT6cVRn9WduT2pHyLBPlSC8id9iiT0\n 5Byg==",
        "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=r4nlXmJ5anekRUqJKbh2YrEXYyuLN+txtYxN7CWsNPc=;\n b=b7nto5YrrcnaWhMbelfNcll90lJjTcBU5AQ1W8mbnvhQheu2+ljOz+Ka8Kans05suD\n FYvv84wkKneMGb/4/VHS2Y2yhYANWXIHVLGOByTPDV11DCtRsIkBnGYpchWJ8X4PEiZT\n PJRxYlDBkZFrhYhqUhIYrsM9J00pJkkTFd4mXsFL7q0BhvSGX18jqyRPYe9vnv9CgQT2\n yZqM72Mb4rDYieFyysFpSY7vZWsqg1Pxok9UAvNjQcAMUvPn9n8BCB6uZChX4y+QPMYm\n HNEtjCT05S2oAipW+ojIysnFy7b10q3cnQ6jzBpD5UG/rPOBgEWSLyOC/DWk7LZXht2e\n sINg==",
        "X-Gm-Message-State": "AOAM532LC6yj83TFHtwhLVCCUW0Y9B+2eh8hy8fEqTiMLN9yK445Qf32\n Wqu1ZvwTuvjxlr66IxfZLbQt2TtKqlDfwQFc",
        "X-Google-Smtp-Source": "\n ABdhPJz/VD/LQOsTXv5Una/9GYahproKkW2N85ZhsH7eIEuOLhwMNd+b+iVFu+mtIO00SrOAPFYl6Q==",
        "X-Received": "by 2002:a19:4242:: with SMTP id p63mr6605068lfa.609.1607816097559;\n Sat, 12 Dec 2020 15:34:57 -0800 (PST)",
        "From": "Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>",
        "To": "dev@dpdk.org",
        "Cc": "Narcisa Ana Maria Vasile <navasile@linux.microsoft.com>,\n Pallavi Kadam <pallavi.kadam@intel.com>,\n Dmitry Malloy <dmitrym@microsoft.com>,\n Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>,\n Neil Horman <nhorman@tuxdriver.com>",
        "Date": "Sun, 13 Dec 2020 02:34:44 +0300",
        "Message-Id": "<20201212233447.23154-2-dmitry.kozliuk@gmail.com>",
        "X-Mailer": "git-send-email 2.29.2",
        "In-Reply-To": "<20201212233447.23154-1-dmitry.kozliuk@gmail.com>",
        "References": "<20201212233447.23154-1-dmitry.kozliuk@gmail.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [PATCH 1/4] pmdinfogen: support COFF",
        "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": "Common Object File Format (COFF) is used on Windows in place of ELF.\n\nAdd COFF parser to pmdinfogen. Also add an argument to specify input\nfile format, which is selected at configure time based on the target.\n\nSigned-off-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>\n---\n buildtools/coff.py       | 154 +++++++++++++++++++++++++++++++++++++++\n buildtools/meson.build   |   7 ++\n buildtools/pmdinfogen.py | 107 ++++++++++++++++++++-------\n 3 files changed, 240 insertions(+), 28 deletions(-)\n create mode 100644 buildtools/coff.py",
    "diff": "diff --git a/buildtools/coff.py b/buildtools/coff.py\nnew file mode 100644\nindex 000000000..86fb0602b\n--- /dev/null\n+++ b/buildtools/coff.py\n@@ -0,0 +1,154 @@\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright (c) 2020 Dmitry Kozlyuk <dmitry.kozliuk@gmail.com>\n+\n+import ctypes\n+\n+# x86_64 little-endian\n+COFF_MAGIC = 0x8664\n+\n+# Names up to this length are stored immediately in symbol table entries.\n+COFF_NAMELEN = 8\n+\n+# Special \"section numbers\" changing the meaning of symbol table entry.\n+COFF_SN_UNDEFINED = 0\n+COFF_SN_ABSOLUTE = -1\n+COFF_SN_DEBUG = -2\n+\n+\n+class CoffFileHeader(ctypes.LittleEndianStructure):\n+    _pack_ = True\n+    _fields_ = [\n+        (\"magic\", ctypes.c_uint16),\n+        (\"section_count\", ctypes.c_uint16),\n+        (\"timestamp\", ctypes.c_uint32),\n+        (\"symbol_table_offset\", ctypes.c_uint32),\n+        (\"symbol_count\", ctypes.c_uint32),\n+        (\"optional_header_size\", ctypes.c_uint16),\n+        (\"flags\", ctypes.c_uint16),\n+    ]\n+\n+\n+class CoffName(ctypes.Union):\n+    class Reference(ctypes.LittleEndianStructure):\n+        _pack_ = True\n+        _fields_ = [\n+            (\"zeroes\", ctypes.c_uint32),\n+            (\"offset\", ctypes.c_uint32),\n+        ]\n+\n+    Immediate = ctypes.c_char * 8\n+\n+    _pack_ = True\n+    _fields_ = [\n+        (\"immediate\", Immediate),\n+        (\"reference\", Reference),\n+    ]\n+\n+\n+class CoffSection(ctypes.LittleEndianStructure):\n+    _pack_ = True\n+    _fields_ = [\n+        (\"name\", CoffName),\n+        (\"physical_address\", ctypes.c_uint32),\n+        (\"physical_address\", ctypes.c_uint32),\n+        (\"size\", ctypes.c_uint32),\n+        (\"data_offset\", ctypes.c_uint32),\n+        (\"relocations_offset\", ctypes.c_uint32),\n+        (\"line_numbers_offset\", ctypes.c_uint32),\n+        (\"relocation_count\", ctypes.c_uint16),\n+        (\"line_number_count\", ctypes.c_uint16),\n+        (\"flags\", ctypes.c_uint32),\n+    ]\n+\n+\n+class CoffSymbol(ctypes.LittleEndianStructure):\n+    _pack_ = True\n+    _fields_ = [\n+        (\"name\", CoffName),\n+        (\"value\", ctypes.c_uint32),\n+        (\"section_number\", ctypes.c_int16),\n+        (\"type\", ctypes.c_uint16),\n+        (\"storage_class\", ctypes.c_uint8),\n+        (\"auxiliary_count\", ctypes.c_uint8),\n+    ]\n+\n+\n+class Symbol:\n+    def __init__(self, image, symbol: CoffSymbol):\n+        self._image = image\n+        self._coff = symbol\n+\n+    @property\n+    def name(self):\n+        if self._coff.name.reference.zeroes:\n+            return decode_asciiz(bytes(self._coff.name.immediate))\n+\n+        offset = self._coff.name.reference.offset\n+        offset -= ctypes.sizeof(ctypes.c_uint32)\n+        return self._image.get_string(offset)\n+\n+    def get_value(self, offset):\n+        section_number = self._coff.section_number\n+\n+        if section_number == COFF_SN_UNDEFINED:\n+            return None\n+\n+        if section_number == COFF_SN_DEBUG:\n+            return None\n+\n+        if section_number == COFF_SN_ABSOLUTE:\n+            return bytes(ctypes.c_uint32(self._coff.value))\n+\n+        section_data = self._image.get_section_data(section_number)\n+        section_offset = self._coff.value + offset\n+        return section_data[section_offset:]\n+\n+\n+class Image:\n+    def __init__(self, data):\n+        header = CoffFileHeader.from_buffer_copy(data)\n+        header_size = ctypes.sizeof(header) + header.optional_header_size\n+\n+        sections_desc = CoffSection * header.section_count\n+        sections = sections_desc.from_buffer_copy(data, header_size)\n+\n+        symbols_desc = CoffSymbol * header.symbol_count\n+        symbols = symbols_desc.from_buffer_copy(data, header.symbol_table_offset)\n+\n+        strings_offset = header.symbol_table_offset + ctypes.sizeof(symbols)\n+        strings = Image._parse_strings(data[strings_offset:])\n+\n+        self._data = data\n+        self._header = header\n+        self._sections = sections\n+        self._symbols = symbols\n+        self._strings = strings\n+\n+    @staticmethod\n+    def _parse_strings(data):\n+        full_size = ctypes.c_uint32.from_buffer_copy(data)\n+        header_size = ctypes.sizeof(full_size)\n+        return data[header_size : full_size.value]\n+\n+    @property\n+    def symbols(self):\n+        i = 0\n+        while i < self._header.symbol_count:\n+            symbol = self._symbols[i]\n+            yield Symbol(self, symbol)\n+            i += symbol.auxiliary_count + 1\n+\n+    def get_section_data(self, number):\n+        # section numbers are 1-based\n+        section = self._sections[number - 1]\n+        base = section.data_offset\n+        return self._data[base : base + section.size]\n+\n+    def get_string(self, offset):\n+        return decode_asciiz(self._strings[offset:])\n+\n+\n+def decode_asciiz(data):\n+    index = data.find(b'\\x00')\n+    end = index if index >= 0 else len(data)\n+    return data[:end].decode()\ndiff --git a/buildtools/meson.build b/buildtools/meson.build\nindex dd4c0f640..23cefd4be 100644\n--- a/buildtools/meson.build\n+++ b/buildtools/meson.build\n@@ -17,7 +17,14 @@ else\n endif\n map_to_win_cmd = py3 + files('map_to_win.py')\n sphinx_wrapper = py3 + files('call-sphinx-build.py')\n+\n+# select object file format\n pmdinfogen = py3 + files('pmdinfogen.py')\n+if host_machine.system() == 'windows'\n+\tpmdinfogen += 'coff'\n+else\n+\tpmdinfogen += 'elf'\n+endif\n \n # TODO: starting from Meson 0.51.0 use\n # \tpython3 = import('python').find_installation('python',\ndiff --git a/buildtools/pmdinfogen.py b/buildtools/pmdinfogen.py\nindex 0cca47ff1..65d78b872 100755\n--- a/buildtools/pmdinfogen.py\n+++ b/buildtools/pmdinfogen.py\n@@ -9,6 +9,8 @@\n import sys\n import tempfile\n \n+import coff\n+\n from elftools.elf.elffile import ELFFile\n from elftools.elf.sections import SymbolTableSection\n \n@@ -18,21 +20,18 @@ 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+        size = self._symbol[\"st_size\"]\n+        value = self.get_value(0, size)\n         return value[:-1].decode() if value else \"\"\n \n+    def get_value(self, offset, size):\n+        section = self._symbol[\"st_shndx\"]\n+        data = self._image.get_section(section).data()\n+        base = self._symbol[\"st_value\"] + offset\n+        return data[base : base + size]\n+\n \n class ELFImage:\n     def __init__(self, data):\n@@ -45,18 +44,50 @@ def __init__(self, data):\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+        return ELFSymbol(self._image, 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+                yield ELFSymbol(self._image, symbol)\n+\n+\n+class COFFSymbol:\n+    def __init__(self, image, symbol):\n+        self._image = image\n+        self._symbol = symbol\n+\n+    def get_value(self, offset, size):\n+        value = self._symbol.get_value(offset)\n+        return value[:size] if value else value\n+\n+    @property\n+    def string_value(self):\n+        value = self._symbol.get_value(0)\n+        return coff.decode_asciiz(value) if value else ''\n+\n+\n+class COFFImage:\n+    def __init__(self, data):\n+        self._image = coff.Image(data)\n+\n+    @property\n+    def is_big_endian(self):\n+        return False\n+\n+    def find_by_prefix(self, prefix):\n+        for symbol in self._image.symbols:\n+            if symbol.name.startswith(prefix):\n+                yield COFFSymbol(self._image, symbol)\n+\n+    def find_by_name(self, name):\n+        for symbol in self._image.symbols:\n+            if symbol.name == name:\n+                return COFFSymbol(self._image, symbol)\n+        return None\n \n \n def define_rte_pci_id(is_big_endian):\n@@ -117,19 +148,24 @@ def _load_pci_ids(image, table_name_symbol):\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+        while True:\n+            size = ctypes.sizeof(rte_pci_id)\n+            offset = size * len(result)\n+            data = table_symbol.get_value(offset, size)\n+            if not data:\n+                break\n+            pci_id = rte_pci_id.from_buffer_copy(data)\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+            result.append(\n+                [\n+                    pci_id.vendor_id,\n+                    pci_id.device_id,\n+                    pci_id.subsystem_vendor_id,\n+                    pci_id.subsystem_device_id,\n+                ]\n+            )\n         return result\n \n     def dump(self, file):\n@@ -157,6 +193,7 @@ def dump_drivers(drivers, file):\n \n def parse_args():\n     parser = argparse.ArgumentParser()\n+    parser.add_argument(\"format\", help=\"object file format, 'elf' or 'coff'\")\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@@ -170,6 +207,21 @@ def open_input(path):\n     return open(path, \"rb\")\n \n \n+def read_input(path):\n+    if path == \"-\":\n+        return sys.stdin.buffer.read()\n+    with open(path, \"rb\") as file:\n+        return file.read()\n+\n+\n+def load_image(fmt, path):\n+    if fmt == 'elf':\n+        return ELFImage(open_input(path))\n+    if fmt == 'coff':\n+        return COFFImage(read_input(path))\n+    raise Exception('unsupported object file format')\n+\n+\n def open_output(path):\n     if path == \"-\":\n         return sys.stdout\n@@ -178,8 +230,7 @@ def open_output(path):\n \n def main():\n     args = parse_args()\n-    infile = open_input(args.input)\n-    image = ELFImage(infile)\n+    image = load_image(args.format, args.input)\n     drivers = load_drivers(image)\n     output = open_output(args.output)\n     dump_drivers(drivers, output)\n",
    "prefixes": [
        "1/4"
    ]
}