From patchwork Tue Apr 2 16:29:36 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 139021 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id D39F543DC3; Tue, 2 Apr 2024 18:31:33 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id CCAAC4064E; Tue, 2 Apr 2024 18:31:08 +0200 (CEST) Received: from mail-pf1-f178.google.com (mail-pf1-f178.google.com [209.85.210.178]) by mails.dpdk.org (Postfix) with ESMTP id 66910402F2 for ; Tue, 2 Apr 2024 18:31:05 +0200 (CEST) Received: by mail-pf1-f178.google.com with SMTP id d2e1a72fcca58-6eac64f2205so4466092b3a.2 for ; Tue, 02 Apr 2024 09:31:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1712075464; x=1712680264; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=l1YQR9vA1ExjgPXZx1u9QUYmj6l2lxm8f1tbQG9ecgQ=; b=1twO2n+Ob8hsdsqN4a8t48dBmFqWqdQRYg0qSX31cLi/983gESQjGvmqkpQjnpPs63 GREYwnVGNq3RjDseKKbk+2eSTkI91fVEqX7BdfdkM1qVyNdEZDl2AsJ8pBKqqTF7N/FQ EDQJ0d2sJ/CI1xyeWRVHIiCjl/puhJ7kkYw1ITIVuf+dXIrde5kIYSXqyDzP4g5vLhhE oyFBzRJKgT88OFvkLF6OaJ0poUiJUJmSkn6s+XQxG0Ov15cC1HeGk3/Y67aKUIuF6GYD tBWF1oU5S9X6C2vHgQT38qBjsnhNYgiJlqMAz8vrm1WqqNk2cwjeQgtCH/FKAXwI0X9Z zV3Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712075464; x=1712680264; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=l1YQR9vA1ExjgPXZx1u9QUYmj6l2lxm8f1tbQG9ecgQ=; b=xL30QiK82J7x5ZdpkMIcJN/9eL/ejx2/5xj7DiYaMsr2yL3qk7xOixlEJT92pYjLt8 jwjceSJIV0vrC8wFbP0LPi4eYt9biBQJJKoKBLt5BJicyarZD4koS12A8aYurihkpG1t a2yEsHMtOX/IYCtyqDHbr8dA6GxeGRQGjdSMSxhK3G8Mlp7vgm0Oek5aPGMYSux4Cdko csk8Sg17KolWatjmzqjW1dqhKE6ohM9PJ2d0+cnQMTrWTY4Px4Ia4RWbpiKArdkD6U63 VW8mKMib4CMn3q41gtZRHmnEf8HP4J+OEzdlfaB3WUJItQ4kLd6kInkusCjyTxem3Hwy 9rMA== X-Gm-Message-State: AOJu0Yzx6vdJdIHFTPr8wUoahX8URmdbyaLRXM58PwuW3fW73ItGjFZe Bbmx0jlIu5XCh7LFF28NZpnBrgF9Nf6DHTF9ZsSJ5iqigwPOMfFFRtdu/fsAHJnAshm17VSlyIA C X-Google-Smtp-Source: AGHT+IHKwLGfOtalUQSbLdCxZUFY8i3HngqXnRBlg2WaIfW+iSYBx2tk9+b9GmxWF2ZKoAytAculSQ== X-Received: by 2002:a05:6a00:1992:b0:6ea:c2a2:5648 with SMTP id d18-20020a056a00199200b006eac2a25648mr13435077pfl.3.1712075464542; Tue, 02 Apr 2024 09:31:04 -0700 (PDT) Received: from hermes.local (204-195-96-226.wavecable.com. [204.195.96.226]) by smtp.gmail.com with ESMTPSA id y7-20020aa793c7000000b006e6fd17069fsm9954857pff.37.2024.04.02.09.31.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 02 Apr 2024 09:31:04 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Julien Aube , Rahul Lakkireddy , Yuying Zhang , Dariusz Sosnowski , Viacheslav Ovsiienko , Ori Kam , Suanming Mou , Matan Azrad , Devendra Singh Rawat , Alok Prasad Subject: [PATCH 4/4] doc: replace use of ifconfig in nics Date: Tue, 2 Apr 2024 09:29:36 -0700 Message-ID: <20240402163050.133923-5-stephen@networkplumber.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240402163050.133923-1-stephen@networkplumber.org> References: <20240402163050.133923-1-stephen@networkplumber.org> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.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 --- 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):