From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>,
Julien Aube <julien_dpdk@jaube.fr>,
Rahul Lakkireddy <rahul.lakkireddy@chelsio.com>,
Yuying Zhang <Yuying.Zhang@intel.com>,
Dariusz Sosnowski <dsosnowski@nvidia.com>,
Viacheslav Ovsiienko <viacheslavo@nvidia.com>,
Ori Kam <orika@nvidia.com>, Suanming Mou <suanmingm@nvidia.com>,
Matan Azrad <matan@nvidia.com>,
Devendra Singh Rawat <dsinghrawat@marvell.com>,
Alok Prasad <palok@marvell.com>
Subject: [PATCH 4/4] doc: replace use of ifconfig in nics
Date: Tue, 2 Apr 2024 09:29:36 -0700 [thread overview]
Message-ID: <20240402163050.133923-5-stephen@networkplumber.org> (raw)
In-Reply-To: <20240402163050.133923-1-stephen@networkplumber.org>
The ifconfig command is BSD legacy and no longer maintained.
Replace it with modern (20 year old) ip command.
Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
doc/guides/nics/bnx2x.rst | 4 ++--
doc/guides/nics/cxgbe.rst | 13 ++++++-------
doc/guides/nics/e1000em.rst | 2 +-
doc/guides/nics/i40e.rst | 2 +-
doc/guides/nics/mlx5.rst | 2 +-
doc/guides/nics/qede.rst | 4 ++--
6 files changed, 13 insertions(+), 14 deletions(-)
diff --git a/doc/guides/nics/bnx2x.rst b/doc/guides/nics/bnx2x.rst
index c24d32b9ab..ed56756a3f 100644
--- a/doc/guides/nics/bnx2x.rst
+++ b/doc/guides/nics/bnx2x.rst
@@ -163,8 +163,8 @@ This section provides instructions to configure SR-IOV with Linux OS.
.. code-block:: console
- ifconfig ens5f0 up
- ifconfig ens5f1 up
+ ip link set dev ens5f0 up
+ ip link set dev ens5f1 up
#. Create VF device(s):
diff --git a/doc/guides/nics/cxgbe.rst b/doc/guides/nics/cxgbe.rst
index 1f0b848ede..7cdaddeeb8 100644
--- a/doc/guides/nics/cxgbe.rst
+++ b/doc/guides/nics/cxgbe.rst
@@ -344,11 +344,11 @@ Unified Wire package for Linux operating system are as follows:
modprobe cxgb4
-#. Use ifconfig to get the interface name assigned to Chelsio card:
+#. Use ip to get the interface name assigned to Chelsio card:
.. code-block:: console
- ifconfig -a | grep "00:07:43"
+ ip -br link show | grep "00:07:43"
Example output:
@@ -502,11 +502,11 @@ virtual functions.
Both the interfaces of a Chelsio 2-port adapter are bound to the
same PCI bus address.
-#. Use ifconfig to get the interface name assigned to Chelsio card:
+#. Use ip to get the interface name assigned to Chelsio card:
.. code-block:: console
- ifconfig -a | grep "00:07:43"
+ ip -br link show | grep "00:07:43"
Example output:
@@ -519,8 +519,8 @@ virtual functions.
.. code-block:: console
- ifconfig p1p1 up
- ifconfig p1p2 up
+ ip link set dev p1p1 up
+ ip link set dev p1p2 up
#. Instantiate SR-IOV Virtual Functions. PF0..3 can be used for
SR-IOV VFs. Multiple VFs can be instantiated on each of PF0..3.
@@ -886,4 +886,3 @@ port.
For this reason, one cannot allow/block a single port without
allowing/blocking the other ports on the same device.
-
diff --git a/doc/guides/nics/e1000em.rst b/doc/guides/nics/e1000em.rst
index 5e752a29e5..b4ba132144 100644
--- a/doc/guides/nics/e1000em.rst
+++ b/doc/guides/nics/e1000em.rst
@@ -125,7 +125,7 @@ The setup procedure is as follows:
tapvm01: tap
tapvm02: tap
-#. Configure your TAP networking interfaces using ip/ifconfig tools.
+#. Configure your TAP networking interfaces using iproute2 tools.
#. Log in to the guest OS and check that the expected emulated devices exist:
diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index ca6caa0cff..f80e173c44 100644
--- a/doc/guides/nics/i40e.rst
+++ b/doc/guides/nics/i40e.rst
@@ -326,7 +326,7 @@ SR-IOV: Prerequisites and sample Application Notes
.. code-block:: console
- ifconfig ens802f0 up
+ ip link set dev ens802f0 up
#. Create VF device(s):
diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index 9b2fe07fd3..1863c1ab7f 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -86,7 +86,7 @@ operations such as querying/updating the MTU and flow control parameters.
This capability allows the PMD to coexist with kernel network interfaces
which remain functional, although they stop receiving unicast packets as
long as they share the same MAC address.
-This means legacy linux control tools (for example: ethtool, ifconfig and
+This means legacy linux control tools (for example: ethtool, iproute and
more) can operate on the same network interfaces that owned by the DPDK
application.
diff --git a/doc/guides/nics/qede.rst b/doc/guides/nics/qede.rst
index 38d5cbb1f3..9f65470179 100644
--- a/doc/guides/nics/qede.rst
+++ b/doc/guides/nics/qede.rst
@@ -226,8 +226,8 @@ This section provides instructions to configure SR-IOV with Linux OS.
.. code-block:: console
- ifconfig ens5f0 up
- ifconfig ens5f1 up
+ ip link set dev ens5f0 up
+ ip link set dev ens5f1 up
#. Create VF device(s):
--
2.43.0
next prev parent reply other threads:[~2024-04-02 16:31 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-04-02 16:29 [PATCH 0/4] Replace references to ifconfig in doc Stephen Hemminger
2024-04-02 16:29 ` [PATCH 1/4] doc: remove references to ifconfig Stephen Hemminger
2024-04-02 16:29 ` [PATCH 2/4] doc: replace ifconfig and brctl usage in howto Stephen Hemminger
2024-04-02 16:29 ` [PATCH 3/4] doc: replace ifconfig in testpmd doc Stephen Hemminger
2024-04-02 16:29 ` Stephen Hemminger [this message]
2024-04-02 16:39 ` [PATCH 0/4] Replace references to ifconfig in doc Bruce Richardson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240402163050.133923-5-stephen@networkplumber.org \
--to=stephen@networkplumber.org \
--cc=Yuying.Zhang@intel.com \
--cc=dev@dpdk.org \
--cc=dsinghrawat@marvell.com \
--cc=dsosnowski@nvidia.com \
--cc=julien_dpdk@jaube.fr \
--cc=matan@nvidia.com \
--cc=orika@nvidia.com \
--cc=palok@marvell.com \
--cc=rahul.lakkireddy@chelsio.com \
--cc=suanmingm@nvidia.com \
--cc=viacheslavo@nvidia.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).