Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/55094/?format=api
http://patches.dpdk.org/api/patches/55094/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20190619185746.26866-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": "<20190619185746.26866-8-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20190619185746.26866-8-stephen@networkplumber.org", "date": "2019-06-19T18:57:45", "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/20190619185746.26866-8-stephen@networkplumber.org/mbox/", "series": [ { "id": 5090, "url": "http://patches.dpdk.org/api/series/5090/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=5090", "date": "2019-06-19T18:57:38", "name": "kni: cleanups and fixes", "version": 3, "mbox": "http://patches.dpdk.org/series/5090/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/55094/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/55094/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 2A8E91D144;\n\tWed, 19 Jun 2019 20:58:17 +0200 (CEST)", "from mail-pl1-f193.google.com (mail-pl1-f193.google.com\n\t[209.85.214.193]) by dpdk.org (Postfix) with ESMTP id 991D01D0FE\n\tfor <dev@dpdk.org>; Wed, 19 Jun 2019 20:58:04 +0200 (CEST)", "by mail-pl1-f193.google.com with SMTP id i2so203908plt.1\n\tfor <dev@dpdk.org>; Wed, 19 Jun 2019 11:58:04 -0700 (PDT)", "from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127])\n\tby smtp.gmail.com with ESMTPSA id\n\tb8sm24774858pff.20.2019.06.19.11.58.01\n\t(version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);\n\tWed, 19 Jun 2019 11:58:02 -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=izo55QUJe9iBPGBP8dhjRckymadapEsbrUhHMdFoGuU=;\n\tb=hUawFW4MOG0NJIjMnF5/FbdaxzzkT9OYkziu//kiHUVDeCkbJpPCihgm6qyf9HlP4y\n\tJf/SK65C/l1TAVasZyTFy7HCyiAHVXx2U2RqtXvSqxBxdUW0S15+LvyfaBLkNpLt0WdH\n\tFe2+8tsJIDFq4bVBwGm/gtel8KFtwYa5cjDBEKxz0bYneyog1Lk6M68Nm6gg4VgpWDeB\n\tVLeNug7mYQUsR/leX+L9Z/1xWpDsvd1TMHpoTDGmv2Wu30zDgx4uAdFUmmpM+1sJAVi8\n\tqAKfGREMcxXSVGXmhVogPBh1tuqAOzmcKBp+tiXxbv55xICt5gbYVwlJZ2nSXYzdV2/5\n\tCdvA==", "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=izo55QUJe9iBPGBP8dhjRckymadapEsbrUhHMdFoGuU=;\n\tb=NHG3h8/y9XaeXmZLoJiYN4bZbX1rb1ViJMxmUTSY7iCyNPp5S/BZJ5HZCF80VWzI9i\n\tGLiQzSb0+CyIZxf18hHtaHxqXscCnpamCmefc+Fk0JinzQ3VrfHU9SYLg2Cr3r3OHtmL\n\tnqs9nyETEwHfYVOh6Cn5K45GY1a/yiB3up9gyI/4J8/AD98trmug9Obu4gewgD/+4NtY\n\thjnwBHaoJPXEYnF8CAi6wj0ZGNmZpx41MUJqFPVgueDC7zN4IYFb4mPS8ieqrurLPSri\n\tzfKalCs9zEu3eGCZAWMPxD15BvnAOVTdIgrfU0wnn2287ozBunHeeMIhpEmkBZhTq5e/\n\tRvIA==", "X-Gm-Message-State": "APjAAAVPGlDPfs9w50kdnI96cWOqdJzORI2lGMsd0x1MZDYOUABT5x3g\n\t51bJ1yR9A461RrfKsWfXKckK878lFuM=", "X-Google-Smtp-Source": "APXvYqzJHmK32avgrtGUT3PomA1HEqFaojN7tVvpcArOCxMXLEOByIPAlLUTeH+72j5O1/QlsU4PfA==", "X-Received": "by 2002:a17:902:6947:: with SMTP id\n\tk7mr47118666plt.253.1560970683395; \n\tWed, 19 Jun 2019 11:58:03 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <sthemmin@microsoft.com>,\n\tStephen Hemminger <stephen@networkplumber.org>", "Date": "Wed, 19 Jun 2019 11:57:45 -0700", "Message-Id": "<20190619185746.26866-8-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.20.1", "In-Reply-To": "<20190619185746.26866-1-stephen@networkplumber.org>", "References": "<20190610175155.21374-1-stephen@networkplumber.org>\n\t<20190619185746.26866-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": "From: Stephen Hemminger <sthemmin@microsoft.com>\n\nMake 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": 55094, "url": "