Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/54561/?format=api
http://patches.dpdk.org/api/patches/54561/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20190608002003.19942-10-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": "<20190608002003.19942-10-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20190608002003.19942-10-stephen@networkplumber.org", "date": "2019-06-08T00:20:03", "name": "[9/9] 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/20190608002003.19942-10-stephen@networkplumber.org/mbox/", "series": [ { "id": 4956, "url": "http://patches.dpdk.org/api/series/4956/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=4956", "date": "2019-06-08T00:19:54", "name": "kni: cleanups and improvements", "version": 1, "mbox": "http://patches.dpdk.org/series/4956/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/54561/comments/", "check": "fail", "checks": "http://patches.dpdk.org/api/patches/54561/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 6807A1BCDF;\n\tSat, 8 Jun 2019 02:20:32 +0200 (CEST)", "from mail-pl1-f194.google.com (mail-pl1-f194.google.com\n\t[209.85.214.194]) by dpdk.org (Postfix) with ESMTP id 8CADB1BCA0\n\tfor <dev@dpdk.org>; Sat, 8 Jun 2019 02:20:21 +0200 (CEST)", "by mail-pl1-f194.google.com with SMTP id e5so1396825pls.13\n\tfor <dev@dpdk.org>; Fri, 07 Jun 2019 17:20:21 -0700 (PDT)", "from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127])\n\tby smtp.gmail.com with ESMTPSA id\n\tn184sm4012463pfn.21.2019.06.07.17.20.19\n\t(version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);\n\tFri, 07 Jun 2019 17:20:19 -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=y68dwzlp/uKX/ODO60y/TWPyhj9crd49HaKpu5GVO5B197xLS0n0l+ROid+V6J5tgG\n\tX+P+i6C4emv+911Nts4fFP2mwMnGaWqU9FmuVd1KlQz/rNZeEm+rhc+N6xbIRZ3Y+KRl\n\tw6Tz784L2fbffRS2Ib9pyH2r5J1boMIbpL7aESoghjs6qjixu/p2SXkhfX25xSGeXRb3\n\tMSxEN4DfZxlJvacvT5ipTuVKhCQON6+T+yuntS8SffU+4J11GWT2MthBEYcmGbzdn0VP\n\to7xKqLhFa1Gi9exKle97yqLXIbWzth/kjW1Pwr6TESbrR7GCzmOCng9G/7tCSekkabfY\n\t4bsQ==", "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=fttdamlECm+JexC/x76yTrq2bm7qU7GdOLVMVDu3AtGX4v6YZmSOgtzycluAKYAy3R\n\tEiUbOw1LPAqa7r159rt4m4e6Wd7D5ACBkM44Xh4cUaECxsi8YZRt2d2vL/1D/wEgKe8W\n\tqwqJJsXQDTrr4VuKUfn/X+T6LNAoJQYlXkd/OAY76p3pWIPkYmXYoRPfHr/fmtnFQjyu\n\tM2VZRCA8GFtOj7yKKumyvECG4k4Gj/OJ51sbFcsTvUHgsVbnV5EJAfYefsj5GyKce6Wr\n\tlek4++TY4l0aG/Jjj3eUCZtWYk3Ig8SpwWS/iGwrjl5tIE83YbaJ9sWIaZAjA4A1ZJgw\n\tpgLg==", "X-Gm-Message-State": "APjAAAWep2TCBEZU1dGjtF3ZVW3nm114hvJPsLsFXKGe/QbCChH+0+DD\n\t6nUyAYHYHtXZf7n2q1u30CDIFc2vuVs=", "X-Google-Smtp-Source": "APXvYqwl78dZq6+FChK+VUbHarjou18rwDUzEfI7PGqUZg9FVWOOL+6zJf6oh54N+VwWxABAENk6Ew==", "X-Received": "by 2002:a17:902:67:: with SMTP id\n\t94mr59568467pla.64.1559953220782; \n\tFri, 07 Jun 2019 17:20:20 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "ferruh.yigit@intel.com", "Cc": "dev@dpdk.org,\n\tStephen Hemminger <stephen@networkplumber.org>", "Date": "Fri, 7 Jun 2019 17:20:03 -0700", "Message-Id": "<20190608002003.19942-10-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.20.1", "In-Reply-To": "<20190608002003.19942-1-stephen@networkplumber.org>", "References": "<20190608002003.19942-1-stephen@networkplumber.org>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] [PATCH 9/9] 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": [ "9/9" ] }{ "id": 54561, "url": "