Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/54925/?format=api
http://patches.dpdk.org/api/patches/54925/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20190618161636.23748-8-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": "<20190618161636.23748-8-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20190618161636.23748-8-stephen@networkplumber.org", "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": "http://patches.dpdk.org/api/people/27/?format=api", "name": "Stephen Hemminger", "email": "stephen@networkplumber.org" }, "delegate": null, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20190618161636.23748-8-stephen@networkplumber.org/mbox/", "series": [ { "id": 5063, "url": "http://patches.dpdk.org/api/series/5063/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=5063", "date": "2019-06-18T16:16:28", "name": "kni: fixes and cleanups", "version": 3, "mbox": "http://patches.dpdk.org/series/5063/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/54925/comments/", "check": "fail", "checks": "http://patches.dpdk.org/api/patches/54925/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 424FB1C258;\n\tTue, 18 Jun 2019 18:17:05 +0200 (CEST)", "from mail-pg1-f194.google.com (mail-pg1-f194.google.com\n\t[209.85.215.194]) by dpdk.org (Postfix) with ESMTP id 3303C1C22B\n\tfor <dev@dpdk.org>; Tue, 18 Jun 2019 18:16:54 +0200 (CEST)", "by mail-pg1-f194.google.com with SMTP id p10so7975420pgn.1\n\tfor <dev@dpdk.org>; Tue, 18 Jun 2019 09:16:54 -0700 (PDT)", "from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127])\n\tby smtp.gmail.com with ESMTPSA id\n\t3sm15485385pfp.114.2019.06.18.09.16.51\n\t(version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);\n\tTue, 18 Jun 2019 09:16:52 -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=zwcpHj9mObwR/3WCwV5l4XnojjP3r4EDgCtfcfF1G0s=;\n\tb=NC7L0a+f0XzHznxJiLnmH5GWG8s1udyChV1amhxHMgMkf9r8IFAF4LeskKMGLp1kfK\n\tBC3Cj4BKPkZHISo/o73bqiOjE52flJFiN/9p0v1nLOfBDRf+nbKAfdSCGK5dHstAbMrY\n\tdHqZigKARkUS3iUCQ1xfXPevJUXqTLHiVHKL2rIOT4YngM9ws6098CsOjekstbPVtv25\n\tOABdJmmfbt+vZiph8z2eOAB3Ol/7wUtoYvp8t0llC3vHHZIl90l9VzePGmEXVfrOmkpl\n\tmZlwVHl8sny22Ul+pgAURBjtxKY8kNwArF3aAIABstS7ZfOMdAgTWBEclo6rQdQwH7Fv\n\tchIQ==", "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=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==", "X-Gm-Message-State": "APjAAAUPOZH9gs2bepl0Z8KhIigrq445k+gxuSrd7vCzPVbSuhwNH5nN\n\tjtZuYQepvdMekxkZPba7ijp/yJKAZ2Q=", "X-Google-Smtp-Source": "APXvYqyVbbgz7BThf+UjBecV0zFsBigrFDVUW35oMKYBL98SSiz9pqidXsWcxy2ntjYnXmKj875TqA==", "X-Received": "by 2002:a63:ce08:: with SMTP id y8mr3338414pgf.38.1560874613103; \n\tTue, 18 Jun 2019 09:16:53 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>", "Date": "Tue, 18 Jun 2019 09:16:35 -0700", "Message-Id": "<20190618161636.23748-8-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.20.1", "In-Reply-To": "<20190618161636.23748-1-stephen@networkplumber.org>", "References": "<20190610175155.21374-1-stephen@networkplumber.org>\n\t<20190618161636.23748-1-stephen@networkplumber.org>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH v3 7/8] doc: update KNI documentation", "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": "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 <stephen@networkplumber.org>\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 192.168.0.1\n+ # ip addr add dev vEth0_0 192.168.0.1\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": [ "v3", "7/8" ] }{ "id": 54925, "url": "