From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by smtp.lore.kernel.org (Postfix) with ESMTP id 0FEF9CD4855 for ; Tue, 12 May 2026 08:06:36 +0000 (UTC) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 8944C40657; Tue, 12 May 2026 10:06:30 +0200 (CEST) Received: from cstnet.cn (smtp21.cstnet.cn [159.226.251.21]) by mails.dpdk.org (Postfix) with ESMTP id D5E3440653 for ; Tue, 12 May 2026 10:06:27 +0200 (CEST) Received: from localhost.localdomain (unknown [118.112.177.181]) by APP-01 (Coremail) with SMTP id qwCowAAHrWh93wJqIJr9Dw--.16996S4; Tue, 12 May 2026 16:06:23 +0800 (CST) From: liujie5@linkdatatechnology.com To: stephen@networkplumber.org Cc: dev@dpdk.org, Jie Liu Subject: [PATCH v12 02/10] doc: add sxe2 guide and release notes Date: Tue, 12 May 2026 16:06:03 +0800 Message-ID: <20260512080616.454171-3-liujie5@linkdatatechnology.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260512080616.454171-1-liujie5@linkdatatechnology.com> References: <20260506113557.1151250-11-liujie5@linkdatatechnology.com> <20260512080616.454171-1-liujie5@linkdatatechnology.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CM-TRANSID: qwCowAAHrWh93wJqIJr9Dw--.16996S4 X-Coremail-Antispam: 1UD129KBjvJXoWxZF18AF1ktrWkKF18AF1fZwb_yoWrAFyfpa n3uFWakrnxJw1xXrnIya18Ar45Ca1vya45Crn2q34rXFn8Cr18Zr4UKryxt3srJr93Za43 XF4Yqry7CF1UW3DanT9S1TB71UUUUU7qnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUUBI14x267AKxVW8JVW5JwAFc2x0x2IEx4CE42xK8VAvwI8IcIk0 rVWrJVCq3wAFIxvE14AKwVWUJVWUGwA2048vs2IY020E87I2jVAFwI0_Jryl82xGYIkIc2 x26xkF7I0E14v26r1I6r4UM28lY4IEw2IIxxk0rwA2F7IY1VAKz4vEj48ve4kI8wA2z4x0 Y4vE2Ix0cI8IcVAFwI0_Jr0_JF4l84ACjcxK6xIIjxv20xvEc7CjxVAFwI0_Jr0_Gr1l84 ACjcxK6I8E87Iv67AKxVWUJVW8JwA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_Gr0_Gr1UM2AI xVAIcxkEcVAq07x20xvEncxIr21l5I8CrVACY4xI64kE6c02F40Ex7xfMcIj6xIIjxv20x vE14v26r1j6r18McIj6I8E87Iv67AKxVWUJVW8JwAm72CE4IkC6x0Yz7v_Jr0_Gr1lF7xv r2IYc2Ij64vIr41lF7I21c0EjII2zVCS5cI20VAGYxC7M4kE6xkIj40Ew7xC0wCF04k20x vY0x0EwIxGrwCFx2IqxVCFs4IE7xkEbVWUJVW8JwC20s026c02F40E14v26r1j6r18MI8I 3I0E7480Y4vE14v26r106r1rMI8E67AF67kF1VAFwI0_Jrv_JF1lIxkGc2Ij64vIr41lIx AIcVC0I7IYx2IY67AKxVWUJVWUCwCI42IY6xIIjxv20xvEc7CjxVAFwI0_Jr0_Gr1lIxAI cVCF04k26cxKx2IYs7xG6r1j6r1xMIIF0xvEx4A2jsIE14v26r1j6r4UMIIF0xvEx4A2js IEc7CjxVAFwI0_Jr0_GrUvcSsGvfC2KfnxnUUI43ZEXa7VUjiID7UUUUU== X-Originating-IP: [118.112.177.181] X-CM-SenderInfo: xolxyxrhv6zxpqngt3pdwhux5qro0w31of0z/ 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 From: Jie Liu Add a new guide for SXE2 PMD in the nics directory. The guide contains driver capabilities, prerequisites, and compilation/usage instructions. Update the release notes to announce the addition of the sxe2 network driver. Signed-off-by: Jie Liu --- doc/guides/nics/features/sxe2.ini | 30 +++++++++++++++++++++++ doc/guides/nics/index.rst | 1 + doc/guides/nics/sxe2.rst | 34 ++++++++++++++++++++++++++ doc/guides/rel_notes/release_26_07.rst | 4 +++ 4 files changed, 69 insertions(+) create mode 100644 doc/guides/nics/features/sxe2.ini create mode 100644 doc/guides/nics/sxe2.rst diff --git a/doc/guides/nics/features/sxe2.ini b/doc/guides/nics/features/sxe2.ini new file mode 100644 index 0000000000..2718a702d4 --- /dev/null +++ b/doc/guides/nics/features/sxe2.ini @@ -0,0 +1,30 @@ +; +; Supported features of the 'sxe2' network poll mode driver. +; +; Refer to default.ini for the full list of available PMD features. +; +; A feature with "P" indicates only be supported when non-vector path +; is selected. +; +[Features] +Fast mbuf free = P +Free Tx mbuf on demand = Y +Burst mode info = Y +Queue start/stop = Y +MTU update = Y +Buffer split on Rx = P +Scattered Rx = Y +CRC offload = Y +VLAN offload = Y +QinQ offload = P +L3 checksum offload = Y +L4 checksum offload = Y +Timestamp offload = P +Inner L3 checksum = P +Inner L4 checksum = P +Rx descriptor status = Y +Tx descriptor status = Y +FreeBSD = Y +Linux = Y +x86-32 = Y +x86-64 = Y diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst index cb818284fe..e20be478f8 100644 --- a/doc/guides/nics/index.rst +++ b/doc/guides/nics/index.rst @@ -68,6 +68,7 @@ Network Interface Controller Drivers rnp sfc_efx softnic + sxe2 tap thunderx txgbe diff --git a/doc/guides/nics/sxe2.rst b/doc/guides/nics/sxe2.rst new file mode 100644 index 0000000000..7fcf9c085b --- /dev/null +++ b/doc/guides/nics/sxe2.rst @@ -0,0 +1,34 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright (C), 2025, Wuxi Stars Micro System Technologies Co., Ltd. + +SXE2 Poll Mode Driver +====================== + +The sxe2 PMD (**librte_net_sxe2**) provides poll mode driver support for +10/25/50/100 Gbps Network Adapters. +The embedded switch, Physical Functions (PF), +and SR-IOV Virtual Functions (VF) are supported. + +Implementation details +---------------------- + +The sxe2 PMD is designed to operate alongside the sxe2 kernel network driver. +For management and control operations, the PMD communicates with the kernel +driver via ioctl interfaces. These commands are processed by the kernel +driver and subsequently dispatched to the hardware firmware for execution. + +For security and robustness, the driver's data path is optimized to operate +using virtual addresses (IOVA as VA mode). However, to ensure full +compatibility in system environments where an IOMMU is absent or disabled, +the driver also provides an explicit path to support physical addressing +(IOVA as PA mode). + +The hardware is capable of handling the corresponding IOVA addresses (either +VA or PA) directly, as provided by the DPDK memory subsystem. This ensures +that DPDK applications can only access memory segments explicitly allocated +to the current process, preventing unauthorized access to random physical +memory. + +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. diff --git a/doc/guides/rel_notes/release_26_07.rst b/doc/guides/rel_notes/release_26_07.rst index f012d47a4b..fa0f0f5cca 100644 --- a/doc/guides/rel_notes/release_26_07.rst +++ b/doc/guides/rel_notes/release_26_07.rst @@ -64,6 +64,10 @@ New Features * ``--auto-probing`` enables the initial bus probing, which is the current default behavior. +* **Added Linkdata sxe2 ethernet driver.** + + Added network driver for the Linkdata Network Adapters. + Removed Items ------------- -- 2.47.3