From patchwork Fri Oct 2 11:16:55 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rahul Lakkireddy X-Patchwork-Id: 7366 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 3D8118E82; Fri, 2 Oct 2015 13:17:46 +0200 (CEST) Received: from stargate3.asicdesigners.com (stargate.chelsio.com [67.207.112.58]) by dpdk.org (Postfix) with ESMTP id BF9098E7D for ; Fri, 2 Oct 2015 13:17:44 +0200 (CEST) Received: from localhost (scalar.blr.asicdesigners.com [10.193.185.94]) by stargate3.asicdesigners.com (8.13.8/8.13.8) with ESMTP id t92BHgci005256; Fri, 2 Oct 2015 04:17:42 -0700 From: Rahul Lakkireddy To: dev@dpdk.org Date: Fri, 2 Oct 2015 16:46:55 +0530 Message-Id: X-Mailer: git-send-email 2.5.3 In-Reply-To: References: In-Reply-To: References: Cc: Kumar Sanghvi , Felix Marti , Nirranjan Kirubaharan Subject: [dpdk-dev] [PATCH 6/6] doc: Update cxgbe documentation and release notes X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" - Add a missed step to mount huge pages in Linux. - Re-structure Sample Application Notes. - Add Jumbo Frame support to list of supported features and instructions on how to enable it via testpmd. - Update release notes. Signed-off-by: Rahul Lakkireddy Signed-off-by: Kumar Sanghvi --- doc/guides/nics/cxgbe.rst | 81 +++++++++++++++++++++++++----------- doc/guides/rel_notes/release_2_2.rst | 5 +++ 2 files changed, 61 insertions(+), 25 deletions(-) diff --git a/doc/guides/nics/cxgbe.rst b/doc/guides/nics/cxgbe.rst index 148cd25..d718f19 100644 --- a/doc/guides/nics/cxgbe.rst +++ b/doc/guides/nics/cxgbe.rst @@ -50,6 +50,7 @@ CXGBE PMD has support for: - Promiscuous mode - All multicast mode - Port hardware statistics +- Jumbo frames Limitations ----------- @@ -211,8 +212,8 @@ Unified Wire package for Linux operating system are as follows: firmware-version: 1.13.32.0, TP 0.1.4.8 -Sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~ +Running testpmd +~~~~~~~~~~~~~~~ This section demonstrates how to launch **testpmd** with Chelsio T5 devices managed by librte_pmd_cxgbe in Linux operating system. @@ -260,6 +261,13 @@ devices managed by librte_pmd_cxgbe in Linux operating system. echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages/nr_hugepages +#. Mount huge pages: + + .. code-block:: console + + mkdir /mnt/huge + mount -t hugetlbfs nodev /mnt/huge + #. Load igb_uio or vfio-pci driver: .. code-block:: console @@ -329,19 +337,7 @@ devices managed by librte_pmd_cxgbe in Linux operating system. .. note:: Flow control pause TX/RX is disabled by default and can be enabled via - testpmd as follows: - - .. code-block:: console - - testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 0 - testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 1 - - To disable again, use: - - .. code-block:: console - - testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 0 - testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 1 + testpmd. Refer section :ref:`flow-control` for more details. FreeBSD ------- @@ -409,8 +405,8 @@ Unified Wire package for FreeBSD operating system are as follows: dev.t5nex.0.firmware_version: 1.13.32.0 -Sample Application Notes -~~~~~~~~~~~~~~~~~~~~~~~~ +Running testpmd +~~~~~~~~~~~~~~~ This section demonstrates how to launch **testpmd** with Chelsio T5 devices managed by librte_pmd_cxgbe in FreeBSD operating system. @@ -543,16 +539,51 @@ devices managed by librte_pmd_cxgbe in FreeBSD operating system. .. note:: Flow control pause TX/RX is disabled by default and can be enabled via - testpmd as follows: + testpmd. Refer section :ref:`flow-control` for more details. - .. code-block:: console +Sample Application Notes +------------------------ - testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 0 - testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 1 +.. _flow-control: - To disable again, use: +Enable/Disable Flow Control +~~~~~~~~~~~~~~~~~~~~~~~~~~~ - .. code-block:: console +Flow control pause TX/RX is disabled by default and can be enabled via +testpmd as follows: + +.. code-block:: console + + testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 0 + testpmd> set flow_ctrl rx on tx on 0 0 0 0 mac_ctrl_frame_fwd off autoneg on 1 + +To disable again, run: + +.. code-block:: console + + testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 0 + testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 1 + +Jumbo Mode +~~~~~~~~~~ + +There are two ways to enable sending and receiving of jumbo frames via testpmd. +One method involves using the **mtu** command, which changes the mtu of an +individual port without having to stop the selected port. Another method +involves stopping all the ports first and then running **max-pkt-len** command +to configure the mtu of all the ports with a single command. + +- To configure each port individually, run the mtu command as follows: + + .. code-block:: console + + testpmd> port config mtu 0 9000 + testpmd> port config mtu 1 9000 + +- To configure all the ports at once, stop all the ports first and run the + max-pkt-len command as follows: + + .. code-block:: console - testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 0 - testpmd> set flow_ctrl rx off tx off 0 0 0 0 mac_ctrl_frame_fwd off autoneg off 1 + testpmd> port stop all + testpmd> port config all max-pkt-len 9000 diff --git a/doc/guides/rel_notes/release_2_2.rst b/doc/guides/rel_notes/release_2_2.rst index 5687676..a3f4f77 100644 --- a/doc/guides/rel_notes/release_2_2.rst +++ b/doc/guides/rel_notes/release_2_2.rst @@ -4,6 +4,11 @@ DPDK Release 2.2 New Features ------------ +* **Enhanced support for the Chelsio CXGBE driver.** + + * Added support for Jumbo Frames. + * Optimize forwarding performance for Chelsio T5 40GbE cards. + Resolved Issues ---------------