Show a patch.

Update a patch.

Update a patch.

GET /api/patches/54925/?format=api
Content-Type: application/json
Vary: Accept

    "id": 54925,
    "url": "",
    "web_url": "",
    "project": {
        "id": 1,
        "url": "",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "",
        "list_email": "",
        "web_url": "",
        "scm_url": "git://",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "{}",
        "commit_url_format": ""
    "msgid": "<>",
    "list_archive_url": "",
    "date": "2019-06-18T16:16:35",
    "name": "[v3,7/8] doc: update KNI documentation",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "cae1d27064a7c5d4435610fb93ff35bcd2577e37",
    "submitter": {
        "id": 27,
        "url": "",
        "name": "Stephen Hemminger",
        "email": ""
    "delegate": null,
    "mbox": "",
    "series": [
            "id": 5063,
            "url": "",
            "web_url": "",
            "date": "2019-06-18T16:16:28",
            "name": "kni: fixes and cleanups",
            "version": 3,
            "mbox": ""
    "comments": "",
    "check": "fail",
    "checks": "",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<>",
        "MIME-Version": "1.0",
        "Sender": "\"dev\" <>",
        "From": "Stephen Hemminger <>",
        "To": "",
        "Delivered-To": "",
        "List-Archive": "<>",
        "X-Google-Smtp-Source": "APXvYqyVbbgz7BThf+UjBecV0zFsBigrFDVUW35oMKYBL98SSiz9pqidXsWcxy2ntjYnXmKj875TqA==",
        "References": "<>\n\t<>",
        "In-Reply-To": "<>",
        "List-Subscribe": "<>,\n\t<>",
        "List-Id": "DPDK patches and discussions <>",
        "X-Mailer": "git-send-email 2.20.1",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\; s=20150623;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:mime-version:content-transfer-encoding;\n\tbh=zwcpHj9mObwR/3WCwV5l4XnojjP3r4EDgCtfcfF1G0s=;\n\tb=NC7L0a+f0XzHznxJiLnmH5GWG8s1udyChV1amhxHMgMkf9r8IFAF4LeskKMGLp1kfK\n\tBC3Cj4BKPkZHISo/o73bqiOjE52flJFiN/9p0v1nLOfBDRf+nbKAfdSCGK5dHstAbMrY\n\tdHqZigKARkUS3iUCQ1xfXPevJUXqTLHiVHKL2rIOT4YngM9ws6098CsOjekstbPVtv25\n\tOABdJmmfbt+vZiph8z2eOAB3Ol/7wUtoYvp8t0llC3vHHZIl90l9VzePGmEXVfrOmkpl\n\tmZlwVHl8sny22Ul+pgAURBjtxKY8kNwArF3aAIABstS7ZfOMdAgTWBEclo6rQdQwH7Fv\n\tchIQ==",
        "List-Unsubscribe": "<>,\n\t<>",
        "Received": [
            "from [] (localhost [])\n\tby (Postfix) with ESMTP id 424FB1C258;\n\tTue, 18 Jun 2019 18:17:05 +0200 (CEST)",
            "from (\n\t[]) by (Postfix) with ESMTP id 3303C1C22B\n\tfor <>; Tue, 18 Jun 2019 18:16:54 +0200 (CEST)",
            "by with SMTP id p10so7975420pgn.1\n\tfor <>; Tue, 18 Jun 2019 09:16:54 -0700 (PDT)",
            "from hermes.lan ( [])\n\tby with ESMTPSA id\n\t3sm15485385pfp.114.2019.\n\t(version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);\n\tTue, 18 Jun 2019 09:16:52 -0700 (PDT)"
        "X-Original-To": "",
        "X-Received": "by 2002:a63:ce08:: with SMTP id y8mr3338414pgf.38.1560874613103; \n\tTue, 18 Jun 2019 09:16:53 -0700 (PDT)",
        "List-Post": "<>",
        "X-Gm-Message-State": "APjAAAUPOZH9gs2bepl0Z8KhIigrq445k+gxuSrd7vCzPVbSuhwNH5nN\n\tjtZuYQepvdMekxkZPba7ijp/yJKAZ2Q=",
        "Content-Transfer-Encoding": "8bit",
        "X-BeenThere": "",
        "List-Help": "<>",
        "Errors-To": "",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\; 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=zwcpHj9mObwR/3WCwV5l4XnojjP3r4EDgCtfcfF1G0s=;\n\tb=CRCrbd6ixZgZPnt75trl492zZIYxHQtokXcBKeJPP1xCwyT8owtV77NOFSgR6adyPu\n\tDVYl8ba7Km7K/HXtEP+T/XibyTcfdjTs+F1RIdb9MrG8Ni5/VNZz7eNehMmgdrtrZaWs\n\tryW6s3uEKTwkxdhor8Wb2Qcte3bwLhWT75jPuAPFDCoEt8XU/40iiv+dwlPLNIWrnhz2\n\tw6Om7Q0unneoty/T4v/D0WX5lmWARbUPBUVZf+F/tfGHyart06UCHdM4fM+48ABy8wdB\n\tUzfgQAaU8Tb9VmLvBL4jM9F4B5EDxpJ8m5Y2tdU5UK7kPUcVEg+c5Kgn/7L2eSykXU9u\n\tGORg==",
        "Subject": "[dpdk-dev] [PATCH v3 7/8] doc: update KNI documentation",
        "Date": "Tue, 18 Jun 2019 09:16:35 -0700",
        "Message-Id": "<>",
        "Precedence": "list",
        "X-Mailman-Version": "2.1.15",
        "Cc": "Stephen Hemminger <>"
    "content": "Make the KNI documentation reflect modern kernel networking.\nIfconfig has been superseded by iproute2 for 15 years.\nIproute2 is well maintained, supports current feature set.\n\nEthtool is no longer supported by KNI.\nTshark is a better replacement for tcpdump.\n\nSigned-off-by: Stephen Hemminger <>\n---\n .../sample_app_ug/kernel_nic_interface.rst     | 18 +++++++++---------\n 1 file changed, 9 insertions(+), 9 deletions(-)",
    "diff": "diff --git a/doc/guides/sample_app_ug/kernel_nic_interface.rst b/doc/guides/sample_app_ug/kernel_nic_interface.rst\nindex a7e549d5213a..422bd8c98465 100644\n--- a/doc/guides/sample_app_ug/kernel_nic_interface.rst\n+++ b/doc/guides/sample_app_ug/kernel_nic_interface.rst\n@@ -21,14 +21,14 @@ The FIFO queues contain pointers to data packets in the DPDK. This:\n \n *   Provides a faster mechanism to interface with the kernel net stack and eliminates system calls\n \n-*   Facilitates the DPDK using standard Linux* userspace net tools (tcpdump, ftp, and so on)\n+*   Facilitates the DPDK using standard Linux* userspace net tools (tshark, rsync, and so on)\n \n *   Eliminate the copy_to_user and copy_from_user operations on packets.\n \n The Kernel NIC Interface sample application is a simple example that demonstrates the use\n of the DPDK to create a path for packets to go through the Linux* kernel.\n This is done by creating one or more kernel net devices for each of the DPDK ports.\n-The application allows the use of standard Linux tools (ethtool, ifconfig, tcpdump) with the DPDK ports and\n+The application allows the use of standard Linux tools (iproute, tshark) with the DPDK ports and\n also the exchange of packets between the DPDK application and the Linux* kernel.\n \n The Kernel NIC Interface sample application requires that the\n@@ -220,13 +220,13 @@ Enable KNI interface and assign an IP address:\n \n .. code-block:: console\n \n-    # ifconfig vEth0_0\n+    # ip addr add dev vEth0_0\n \n Show KNI interface configuration and statistics:\n \n .. code-block:: console\n \n-    # ifconfig vEth0_0\n+    # ip -s -d addr show vEth0_0\n \n The user can also check and reset the packet statistics inside the ``kni``\n application by sending the app the USR1 and USR2 signals:\n@@ -234,16 +234,16 @@ application by sending the app the USR1 and USR2 signals:\n .. code-block:: console\n \n     # Print statistics\n-    # kill -SIGUSR1 `pidof kni`\n+    # pkill -USR1 kni\n \n     # Zero statistics\n-    # kill -SIGUSR2 `pidof kni`\n+    # pkill -USR2 kni\n \n Dump network traffic:\n \n .. code-block:: console\n \n-    # tcpdump -i vEth0_0\n+    # tshark -n -i vEth0_0\n \n The normal Linux commands can also be used to change the MAC address and\n MTU size used by the physical NIC which corresponds to the KNI interface.\n@@ -254,13 +254,13 @@ Change the MAC address:\n \n .. code-block:: console\n \n-    # ifconfig vEth0_0 hw ether 0C:01:02:03:04:08\n+    # ip link set dev vEth0_0 lladdr 0C:01:02:03:04:08\n \n Change the MTU size:\n \n .. code-block:: console\n \n-    # ifconfig vEth0_0 mtu 1450\n+    # ip link set dev vEth0_0 mtu 1450\n \n When the ``kni`` application is closed, all the KNI interfaces are deleted\n from the Linux kernel.\n",
    "prefixes": [