From patchwork Fri Apr 12 12:27:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kamil Vojanec X-Patchwork-Id: 139250 X-Patchwork-Delegate: ferruh.yigit@amd.com 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 C087C43E52; Fri, 12 Apr 2024 14:27:57 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 62AB340E28; Fri, 12 Apr 2024 14:27:54 +0200 (CEST) Received: from office2.cesnet.cz (office2.cesnet.cz [78.128.248.237]) by mails.dpdk.org (Postfix) with ESMTP id A897740E13 for ; Fri, 12 Apr 2024 14:27:53 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cesnet.cz; s=office2-2020; t=1712924873; bh=/VozFjvcU8tYMKNfgC1VFGiNGfO/CGbqBSdLsxo7OL8=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=co/KDQC/BDNVRAOJ37uex4GVh1/A1/Sy8XFav9ZI4xM4Kogi6Thn6ODIoJ3wBbK34 0plbWTwWih1WDxCEekunwfZjbuQChdiuPmj0mDNPAwd4qikVAMpI1iY/Yfi+bJOI2u AmWIdCBVpy4Tv7l16gCv43+4mAQ2TzXsnXw58g7+wiF3lnt8Qdby3fZhLsPaWj2I2o 8jerfvaOJDTxfi2dpC1ZsMCClP1k0mMQVNCYBEcMKyEZpMxIPP9s1mXcxdx939gKt0 PjsCqDtACvix/F7Hp500pW0ER58XOvMSHwxy8uRkMfOyyy1XHDfabwjVUdOesYrgpE YOPY4KNYeajtw== Received: from dpdk-test6.liberouter.org (rt-tmc-kou.liberouter.org [195.113.172.126]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by office2.cesnet.cz (Postfix) with ESMTPSA id B7B5D1180081; Fri, 12 Apr 2024 14:27:51 +0200 (CEST) From: Kamil Vojanec To: dev@dpdk.org Cc: Kamil Vojanec , Chas Williams , "Min Hu (Connor)" Subject: [PATCH v2 2/2] doc/prog_guide: document direct link bonding mode Date: Fri, 12 Apr 2024 14:27:40 +0200 Message-Id: <20240412122740.104121-2-vojanec@cesnet.cz> X-Mailer: git-send-email 2.39.3 In-Reply-To: <20240412122740.104121-1-vojanec@cesnet.cz> References: <20240412122740.104121-1-vojanec@cesnet.cz> 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 This commit introduces documentation for the newly introduced link bonding mode. Signed-off-by: Kamil Vojanec --- doc/guides/prog_guide/img/bond-mode-7.svg | 908 ++++++++++++++++++ .../link_bonding_poll_mode_drv_lib.rst | 13 + 2 files changed, 921 insertions(+) create mode 100644 doc/guides/prog_guide/img/bond-mode-7.svg diff --git a/doc/guides/prog_guide/img/bond-mode-7.svg b/doc/guides/prog_guide/img/bond-mode-7.svg new file mode 100644 index 0000000000..aae0a5132e --- /dev/null +++ b/doc/guides/prog_guide/img/bond-mode-7.svg @@ -0,0 +1,908 @@ + + + +image/svg+xmlPage-4Rectangle.7User ApplicationUser Application +Sheet.2Rectangle.38DPDKDPDK +Rectangle.16bonding ethdevbonding ethdev +Rectangle.11ethdev portethdev port +Rectangle.14ethdev portethdev port +Rectangle.15ethdev portethdev port +Simple Double Arrow.14Simple ArrowSimple Arrow.37Simple Arrow.37Simple Arrow.37Simple Arrow.38Simple Arrow.39Square.11411 +Square.11522 +Square.11633 +Square.11744 +Square.11855 +Square.12011 +Square.12011 +Square.12123 +Square.12123 +Square.12235 +Square.12235 +Square.12342 +Square.12342 +Square.12454 +Square.12454 + diff --git a/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst b/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst index 60717a3587..146add35a5 100644 --- a/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst +++ b/doc/guides/prog_guide/link_bonding_poll_mode_drv_lib.rst @@ -129,6 +129,19 @@ Currently the Link Bonding PMD library supports following modes of operation: changes the transmitting member, according to the computed load. Statistics are collected in 100ms intervals and scheduled every 10ms. +* **Transmit Load Balancing (Mode 7):** + +.. figure:: img/bond-mode-7.* + + Direct TX (Mode 7) + + + This mode is a specialized version of round robin bonding mode. It transmits + packets to the same member ports on which they were received (based on the + ``port`` attribute of ``struct rte_mbuf``). In case the port attribute does + not belong to any managed bonding members, this mode reverts back to round + robin TX mode. Note that this mode does not implement a specific RX mode, + instead using a round robin approach. Implementation Details ----------------------