From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from dpdk.org (dpdk.org [92.243.14.124])
by dpdk.space (Postfix) with ESMTP id 541C4A0471
for <public@inbox.dpdk.org>; Wed, 19 Jun 2019 20:59:09 +0200 (CEST)
Received: from [92.243.14.124] (localhost [127.0.0.1])
by dpdk.org (Postfix) with ESMTP id 2A8E91D144;
Wed, 19 Jun 2019 20:58:17 +0200 (CEST)
Received: from mail-pl1-f193.google.com (mail-pl1-f193.google.com
[209.85.214.193]) by dpdk.org (Postfix) with ESMTP id 991D01D0FE
for <dev@dpdk.org>; Wed, 19 Jun 2019 20:58:04 +0200 (CEST)
Received: by mail-pl1-f193.google.com with SMTP id i2so203908plt.1
for <dev@dpdk.org>; Wed, 19 Jun 2019 11:58:04 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=networkplumber-org.20150623.gappssmtp.com; s=20150623;
h=from:to:cc:subject:date:message-id:in-reply-to:references
:mime-version:content-transfer-encoding;
bh=izo55QUJe9iBPGBP8dhjRckymadapEsbrUhHMdFoGuU=;
b=hUawFW4MOG0NJIjMnF5/FbdaxzzkT9OYkziu//kiHUVDeCkbJpPCihgm6qyf9HlP4y
Jf/SK65C/l1TAVasZyTFy7HCyiAHVXx2U2RqtXvSqxBxdUW0S15+LvyfaBLkNpLt0WdH
Fe2+8tsJIDFq4bVBwGm/gtel8KFtwYa5cjDBEKxz0bYneyog1Lk6M68Nm6gg4VgpWDeB
VLeNug7mYQUsR/leX+L9Z/1xWpDsvd1TMHpoTDGmv2Wu30zDgx4uAdFUmmpM+1sJAVi8
qAKfGREMcxXSVGXmhVogPBh1tuqAOzmcKBp+tiXxbv55xICt5gbYVwlJZ2nSXYzdV2/5
CdvA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20161025;
h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
:references:mime-version:content-transfer-encoding;
bh=izo55QUJe9iBPGBP8dhjRckymadapEsbrUhHMdFoGuU=;
b=NHG3h8/y9XaeXmZLoJiYN4bZbX1rb1ViJMxmUTSY7iCyNPp5S/BZJ5HZCF80VWzI9i
GLiQzSb0+CyIZxf18hHtaHxqXscCnpamCmefc+Fk0JinzQ3VrfHU9SYLg2Cr3r3OHtmL
nqs9nyETEwHfYVOh6Cn5K45GY1a/yiB3up9gyI/4J8/AD98trmug9Obu4gewgD/+4NtY
hjnwBHaoJPXEYnF8CAi6wj0ZGNmZpx41MUJqFPVgueDC7zN4IYFb4mPS8ieqrurLPSri
zfKalCs9zEu3eGCZAWMPxD15BvnAOVTdIgrfU0wnn2287ozBunHeeMIhpEmkBZhTq5e/
RvIA==
X-Gm-Message-State: APjAAAVPGlDPfs9w50kdnI96cWOqdJzORI2lGMsd0x1MZDYOUABT5x3g
51bJ1yR9A461RrfKsWfXKckK878lFuM=
X-Google-Smtp-Source: APXvYqzJHmK32avgrtGUT3PomA1HEqFaojN7tVvpcArOCxMXLEOByIPAlLUTeH+72j5O1/QlsU4PfA==
X-Received: by 2002:a17:902:6947:: with SMTP id
k7mr47118666plt.253.1560970683395;
Wed, 19 Jun 2019 11:58:03 -0700 (PDT)
Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127])
by smtp.gmail.com with ESMTPSA id b8sm24774858pff.20.2019.06.19.11.58.01
(version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256);
Wed, 19 Jun 2019 11:58:02 -0700 (PDT)
From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <sthemmin@microsoft.com>,
Stephen 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>
<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>,
<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>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>
From: Stephen Hemminger <sthemmin@microsoft.com>
Make the KNI documentation reflect modern kernel networking.
Ifconfig has been superseded by iproute2 for 15 years.
Iproute2 is well maintained, supports current feature set.
Ethtool is no longer supported by KNI.
Tshark is a better replacement for tcpdump.
Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
.../sample_app_ug/kernel_nic_interface.rst | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
diff --git a/doc/guides/sample_app_ug/kernel_nic_interface.rst b/doc/guides/sample_app_ug/kernel_nic_interface.rst
index a7e549d5213a..422bd8c98465 100644
--- a/doc/guides/sample_app_ug/kernel_nic_interface.rst
+++ b/doc/guides/sample_app_ug/kernel_nic_interface.rst
@@ -21,14 +21,14 @@ The FIFO queues contain pointers to data packets in the DPDK. This:
* Provides a faster mechanism to interface with the kernel net stack and eliminates system calls
-* Facilitates the DPDK using standard Linux* userspace net tools (tcpdump, ftp, and so on)
+* Facilitates the DPDK using standard Linux* userspace net tools (tshark, rsync, and so on)
* Eliminate the copy_to_user and copy_from_user operations on packets.
The Kernel NIC Interface sample application is a simple example that demonstrates the use
of the DPDK to create a path for packets to go through the Linux* kernel.
This is done by creating one or more kernel net devices for each of the DPDK ports.
-The application allows the use of standard Linux tools (ethtool, ifconfig, tcpdump) with the DPDK ports and
+The application allows the use of standard Linux tools (iproute, tshark) with the DPDK ports and
also the exchange of packets between the DPDK application and the Linux* kernel.
The Kernel NIC Interface sample application requires that the
@@ -220,13 +220,13 @@ Enable KNI interface and assign an IP address:
.. code-block:: console
- # ifconfig vEth0_0 192.168.0.1
+ # ip addr add dev vEth0_0 192.168.0.1
Show KNI interface configuration and statistics:
.. code-block:: console
- # ifconfig vEth0_0
+ # ip -s -d addr show vEth0_0
The user can also check and reset the packet statistics inside the ``kni``
application by sending the app the USR1 and USR2 signals:
@@ -234,16 +234,16 @@ application by sending the app the USR1 and USR2 signals:
.. code-block:: console
# Print statistics
- # kill -SIGUSR1 `pidof kni`
+ # pkill -USR1 kni
# Zero statistics
- # kill -SIGUSR2 `pidof kni`
+ # pkill -USR2 kni
Dump network traffic:
.. code-block:: console
- # tcpdump -i vEth0_0
+ # tshark -n -i vEth0_0
The normal Linux commands can also be used to change the MAC address and
MTU size used by the physical NIC which corresponds to the KNI interface.
@@ -254,13 +254,13 @@ Change the MAC address:
.. code-block:: console
- # ifconfig vEth0_0 hw ether 0C:01:02:03:04:08
+ # ip link set dev vEth0_0 lladdr 0C:01:02:03:04:08
Change the MTU size:
.. code-block:: console
- # ifconfig vEth0_0 mtu 1450
+ # ip link set dev vEth0_0 mtu 1450
When the ``kni`` application is closed, all the KNI interfaces are deleted
from the Linux kernel.
--
2.20.1