From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 6810FA00E6 for ; Mon, 5 Aug 2019 17:33:03 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 83D171BDFE; Mon, 5 Aug 2019 17:32:51 +0200 (CEST) Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by dpdk.org (Postfix) with ESMTP id 195CA1B9FA for ; Mon, 5 Aug 2019 17:32:50 +0200 (CEST) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id B87F620D98; Mon, 5 Aug 2019 11:32:49 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Mon, 05 Aug 2019 11:32:49 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; s=mesmtp; bh=Ovm+oVwM1S DbDPcSqhqJ4E4xjyIR8gMcVVieCzbVSBc=; b=J0+P8EWzWrkqttXd2TytJI4f8N 70BL+QlC1otguTfY8Rb6SWSNxYi7/AUMy/qiAZ1z/Ju+QK6c+dYuMJPDw86OD8DZ r6qs3WRdRnLYeY4rPAjT2bEqFUHMI7SAu9cCG2k96gr8Ncges8N1dUyM1QJC2/Dl 02gCio9OS+OmMjUAw= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=Ovm+oVwM1SDbDPcSqhqJ4E4xjyIR8gMcVVieCzbVSBc=; b=nRX96q2s IjVi1mno4UxBDwGVpA32OvT/4F2GBEem9UBHMTTF8yMLhiK7LCGZ8HAwzfaFWiQr +sr1vijZ0xn08PNXWO6YduxGUWDl9xpXwZ4Nd8tw+CECtN3hlVauBL5HoZTuhX5P ShiqEG77AYblr5AIxILshhx6xTpZwYQmq2lcbYo+SWs4VINXZLC2CTyKcb2Xs4Co ykNOAhC13FFE/slmMM8XYZgrWyXmhjMV2P1dQihdFPTizm69sxCVnv1pEeCZrJYQ tMo3D1WzsI9kte7CZv028tZpQmDnGu7cFHr9bxsQgUFcGDcjD4NgADp0oMBPH4vX ekQMHPKToH1W4g== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddruddtjedgkeelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecukf hppeejjedrudefgedrvddtfedrudekgeenucfrrghrrghmpehmrghilhhfrhhomhepthhh ohhmrghssehmohhnjhgrlhhonhdrnhgvthenucevlhhushhtvghrufhiiigvpedv X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 7DF1D8005B; Mon, 5 Aug 2019 11:32:48 -0400 (EDT) From: Thomas Monjalon To: Matan Azrad , Shahaf Shuler , John McNamara , Marko Kovacevic , Yongseok Koh , Viacheslav Ovsiienko Cc: dev@dpdk.org Date: Mon, 5 Aug 2019 17:32:20 +0200 Message-Id: <20190805153222.29593-4-thomas@monjalon.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190805153222.29593-1-thomas@monjalon.net> References: <20190805153222.29593-1-thomas@monjalon.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH 3/5] doc: remove useless console syntax in mlx guides X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" It is not needed to use "console" syntax highlighting for literal blocks. The file is easier to read by removing the code-block lines and simply having double colons in previous line. Signed-off-by: Thomas Monjalon --- doc/guides/nics/mlx4.rst | 92 +++++++--------------------- doc/guides/nics/mlx5.rst | 128 ++++++++++----------------------------- 2 files changed, 55 insertions(+), 165 deletions(-) diff --git a/doc/guides/nics/mlx4.rst b/doc/guides/nics/mlx4.rst index 5c6bbdea1..d0e8a8b2f 100644 --- a/doc/guides/nics/mlx4.rst +++ b/doc/guides/nics/mlx4.rst @@ -272,33 +272,23 @@ Installing Mellanox OFED 2. Install the required libraries and kernel modules either by installing only the required set, or by installing the entire Mellanox OFED: - For bare metal use: - - .. code-block:: console + For bare metal use:: ./mlnxofedinstall --dpdk --upstream-libs - For SR-IOV hypervisors use: - - .. code-block:: console + For SR-IOV hypervisors use:: ./mlnxofedinstall --dpdk --upstream-libs --enable-sriov --hypervisor - For SR-IOV virtual machine use: - - .. code-block:: console + For SR-IOV virtual machine use:: ./mlnxofedinstall --dpdk --upstream-libs --guest -3. Verify the firmware is the correct one: - - .. code-block:: console +3. Verify the firmware is the correct one:: ibv_devinfo -4. Set all ports links to Ethernet, follow instructions on the screen: - - .. code-block:: console +4. Set all ports links to Ethernet, follow instructions on the screen:: connectx_port_config @@ -314,9 +304,7 @@ Supported NICs Quick Start Guide ----------------- -1. Set all ports links to Ethernet - - .. code-block:: console +1. Set all ports links to Ethernet:: PCI= echo eth > "/sys/bus/pci/devices/$PCI/mlx4_port0" @@ -331,9 +319,7 @@ Quick Start Guide .. _QSG_2: 2. In case of bare metal or hypervisor, configure optimized steering mode - by adding the following line to ``/etc/modprobe.d/mlx4_core.conf``: - - .. code-block:: console + by adding the following line to ``/etc/modprobe.d/mlx4_core.conf``:: options mlx4_core log_num_mgm_entry_size=-7 @@ -342,15 +328,11 @@ Quick Start Guide If VLAN filtering is used, set log_num_mgm_entry_size=-1. Performance degradation can occur on this case. -3. Restart the driver: - - .. code-block:: console +3. Restart the driver:: /etc/init.d/openibd restart - or: - - .. code-block:: console + or:: service openibd restart @@ -360,17 +342,13 @@ Quick Start Guide Performance tuning ------------------ -1. Verify the optimized steering mode is configured: - - .. code-block:: console +1. Verify the optimized steering mode is configured:: cat /sys/module/mlx4_core/parameters/log_num_mgm_entry_size 2. Use the CPU near local NUMA node to which the PCIe adapter is connected, for better performance. For VMs, verify that the right CPU - and NUMA node are pinned according to the above. Run: - - .. code-block:: console + and NUMA node are pinned according to the above. Run:: lstopo-no-graphics @@ -382,9 +360,7 @@ Performance tuning This in order to forward packets from one to the other without NUMA performance penalty. -4. Disable pause frames: - - .. code-block:: console +4. Disable pause frames:: ethtool -A rx off tx off @@ -398,15 +374,11 @@ Performance tuning to set the PCI max read request parameter to 1K. This can be done in the following way: - To query the read request size use: - - .. code-block:: console + To query the read request size use:: setpci -s 68.w - If the output is different than 3XXX, set it by: - - .. code-block:: console + If the output is different than 3XXX, set it by:: setpci -s 68.w=3XXX @@ -425,16 +397,12 @@ Usage example This section demonstrates how to launch **testpmd** with Mellanox ConnectX-3 devices managed by librte_pmd_mlx4. -#. Load the kernel modules: - - .. code-block:: console +#. Load the kernel modules:: modprobe -a ib_uverbs mlx4_en mlx4_core mlx4_ib Alternatively if MLNX_OFED is fully installed, the following script can - be run: - - .. code-block:: console + be run:: /etc/init.d/openibd restart @@ -444,24 +412,18 @@ devices managed by librte_pmd_mlx4. not have to be loaded. #. Make sure Ethernet interfaces are in working order and linked to kernel - verbs. Related sysfs entries should be present: - - .. code-block:: console + verbs. Related sysfs entries should be present:: ls -d /sys/class/net/*/device/infiniband_verbs/uverbs* | cut -d / -f 5 - Example output: - - .. code-block:: console + Example output:: eth2 eth3 eth4 eth5 -#. Optionally, retrieve their PCI bus addresses for whitelisting: - - .. code-block:: console +#. Optionally, retrieve their PCI bus addresses for whitelisting:: { for intf in eth2 eth3 eth4 eth5; @@ -471,9 +433,7 @@ devices managed by librte_pmd_mlx4. } | sed -n 's,.*/\(.*\),-w \1,p' - Example output: - - .. code-block:: console + Example output:: -w 0000:83:00.0 -w 0000:83:00.0 @@ -485,21 +445,15 @@ devices managed by librte_pmd_mlx4. There are only two distinct PCI bus addresses because the Mellanox ConnectX-3 adapters installed on this system are dual port. -#. Request huge pages: - - .. code-block:: console +#. Request huge pages:: echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages -#. Start testpmd with basic parameters: - - .. code-block:: console +#. Start testpmd with basic parameters:: testpmd -l 8-15 -n 4 -w 0000:83:00.0 -w 0000:84:00.0 -- --rxq=2 --txq=2 -i - Example output: - - .. code-block:: console + Example output:: [...] EAL: PCI device 0000:83:00.0 on NUMA socket 1 diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 59c9537c0..dcefc65ec 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -774,72 +774,52 @@ Quick Start Guide on OFED/EN 2. Install the required libraries and kernel modules either by installing - only the required set, or by installing the entire Mellanox OFED/EN: - - .. code-block:: console + only the required set, or by installing the entire Mellanox OFED/EN:: ./mlnxofedinstall --upstream-libs --dpdk -3. Verify the firmware is the correct one: - - .. code-block:: console +3. Verify the firmware is the correct one:: ibv_devinfo -4. Verify all ports links are set to Ethernet: - - .. code-block:: console +4. Verify all ports links are set to Ethernet:: mlxconfig -d query | grep LINK_TYPE LINK_TYPE_P1 ETH(2) LINK_TYPE_P2 ETH(2) - Link types may have to be configured to Ethernet: - - .. code-block:: console + Link types may have to be configured to Ethernet:: mlxconfig -d set LINK_TYPE_P1/2=1/2/3 * LINK_TYPE_P1=<1|2|3> , 1=Infiniband 2=Ethernet 3=VPI(auto-sense) - For hypervisors verify SR-IOV is enabled on the NIC: - - .. code-block:: console + For hypervisors, verify SR-IOV is enabled on the NIC:: mlxconfig -d query | grep SRIOV_EN SRIOV_EN True(1) - If needed, set enable the set the relevant fields: - - .. code-block:: console + If needed, configure SR-IOV:: mlxconfig -d set SRIOV_EN=1 NUM_OF_VFS=16 mlxfwreset -d reset -5. Restart the driver: - - .. code-block:: console +5. Restart the driver:: /etc/init.d/openibd restart - or: - - .. code-block:: console + or:: service openibd restart - If link type was changed, firmware must be reset as well: - - .. code-block:: console + If link type was changed, firmware must be reset as well:: mlxfwreset -d reset For hypervisors, after reset write the sysfs number of virtual functions needed for the PF. - To dynamically instantiate a given number of virtual functions (VFs): - - .. code-block:: console + To dynamically instantiate a given number of virtual functions (VFs):: echo [num_vfs] > /sys/class/infiniband/mlx5_0/device/sriov_numvfs @@ -860,54 +840,38 @@ flow should be offloaded to the E-Switch. After offloading the flow packet that the VF that are matching the flow will not be received any more by the DPDK application. -1. Enable SRIOV mode: - - .. code-block:: console +1. Enable SRIOV mode:: mlxconfig -d set SRIOV_EN=true -2. Configure the max number of VFs: - - .. code-block:: console +2. Configure the max number of VFs:: mlxconfig -d set NUM_OF_VFS= -3. Reset the FW: - - .. code-block:: console +3. Reset the FW:: mlxfwreset -d reset -3. Configure the actual number of VFs: - - .. code-block:: console +3. Configure the actual number of VFs:: echo /sys/class/net//device/sriov_numvfs -4. Unbind the device (can be rebind after the switchdev mode): - - .. code-block:: console +4. Unbind the device (can be rebind after the switchdev mode):: echo -n " /sys/bus/pci/drivers/mlx5_core/unbind -5. Enbale switchdev mode: - - .. code-block:: console +5. Enbale switchdev mode:: echo switchdev > /sys/class/net//compat/devlink/mode Performance tuning ------------------ -1. Configure aggressive CQE Zipping for maximum performance: - - .. code-block:: console +1. Configure aggressive CQE Zipping for maximum performance:: mlxconfig -d s CQE_COMPRESSION=1 - To set it back to the default CQE Zipping mode use: - - .. code-block:: console + To set it back to the default CQE Zipping mode use:: mlxconfig -d s CQE_COMPRESSION=0 @@ -921,9 +885,7 @@ Performance tuning 3. Use the CPU near local NUMA node to which the PCIe adapter is connected, for better performance. For VMs, verify that the right CPU - and NUMA node are pinned according to the above. Run: - - .. code-block:: console + and NUMA node are pinned according to the above. Run:: lstopo-no-graphics @@ -935,9 +897,7 @@ Performance tuning This in order to forward packets from one to the other without NUMA performance penalty. -5. Disable pause frames: - - .. code-block:: console +5. Disable pause frames:: ethtool -A rx off tx off @@ -951,15 +911,11 @@ Performance tuning to set the PCI max read request parameter to 1K. This can be done in the following way: - To query the read request size use: - - .. code-block:: console + To query the read request size use:: setpci -s 68.w - If the output is different than 3XXX, set it by: - - .. code-block:: console + If the output is different than 3XXX, set it by:: setpci -s 68.w=3XXX @@ -1034,9 +990,7 @@ port, librte_pmd_mlx5 supports per-protocol RSS configuration. Since ``testpmd`` defaults to IP RSS mode and there is currently no command-line parameter to enable additional protocols (UDP and TCP as well as IP), the following commands must be entered from its CLI to get the same -behavior as librte_pmd_mlx4: - -.. code-block:: console +behavior as librte_pmd_mlx4:: > port stop all > port config all rss all @@ -1048,16 +1002,12 @@ Usage example This section demonstrates how to launch **testpmd** with Mellanox ConnectX-4/ConnectX-5/ConnectX-6/BlueField devices managed by librte_pmd_mlx5. -#. Load the kernel modules: - - .. code-block:: console +#. Load the kernel modules:: modprobe -a ib_uverbs mlx5_core mlx5_ib Alternatively if MLNX_OFED/MLNX_EN is fully installed, the following script - can be run: - - .. code-block:: console + can be run:: /etc/init.d/openibd restart @@ -1067,24 +1017,18 @@ ConnectX-4/ConnectX-5/ConnectX-6/BlueField devices managed by librte_pmd_mlx5. not have to be loaded. #. Make sure Ethernet interfaces are in working order and linked to kernel - verbs. Related sysfs entries should be present: - - .. code-block:: console + verbs. Related sysfs entries should be present:: ls -d /sys/class/net/*/device/infiniband_verbs/uverbs* | cut -d / -f 5 - Example output: - - .. code-block:: console + Example output:: eth30 eth31 eth32 eth33 -#. Optionally, retrieve their PCI bus addresses for whitelisting: - - .. code-block:: console +#. Optionally, retrieve their PCI bus addresses for whitelisting:: { for intf in eth2 eth3 eth4 eth5; @@ -1094,30 +1038,22 @@ ConnectX-4/ConnectX-5/ConnectX-6/BlueField devices managed by librte_pmd_mlx5. } | sed -n 's,.*/\(.*\),-w \1,p' - Example output: - - .. code-block:: console + Example output:: -w 0000:05:00.1 -w 0000:06:00.0 -w 0000:06:00.1 -w 0000:05:00.0 -#. Request huge pages: - - .. code-block:: console +#. Request huge pages:: echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages -#. Start testpmd with basic parameters: - - .. code-block:: console +#. Start testpmd with basic parameters:: testpmd -l 8-15 -n 4 -w 05:00.0 -w 05:00.1 -w 06:00.0 -w 06:00.1 -- --rxq=2 --txq=2 -i - Example output: - - .. code-block:: console + Example output:: [...] EAL: PCI device 0000:05:00.0 on NUMA socket 0 -- 2.21.0