From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 76765427F9; Wed, 22 Mar 2023 01:01:09 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 34E0D42D3D; Wed, 22 Mar 2023 01:00:10 +0100 (CET) Received: from NAM11-CO1-obe.outbound.protection.outlook.com (mail-co1nam11on2059.outbound.protection.outlook.com [40.107.220.59]) by mails.dpdk.org (Postfix) with ESMTP id 5BD36410DD for ; Wed, 22 Mar 2023 01:00:02 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=LzN5vQd3gfXikn+J8DIMoQrNW0TOrsMe40HHhpg9NJ8/7g7ruxk5x9Whh2zWkSE2yAP2XmZ4zyEgt0PnvBwr46IuULEkZ8McpL9jtqR6xl3LTL1GPqMMi+eIytXpqspZFrWwF15b+4KVU0uzwdvaw8TvHI57oCT781PdqW2bCjR20Uqj0pc1OslSGkWw08iVlBqa2ml380dfiF5VfXbmEWtlnzs4dI8z4FViP5jKx2MXksZcHwOR8txDfwy434ggfmzyB/GJCwYAA8dlCHvPz+oaZIlvng5qBDTNrGly4ie4OptiL/8/lO09E+tdm878SDyx2QoZcgp47AUlKY3iGQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=sgdSivTUkXFAQIC4B3yKlQhNL7qBUJGgBhMzgLevnqI=; b=S0GHqRS3skkhKfZCoACzatY+uJAAhtYRkihVEJpWpQ6O/eUeH/nfkPxCqOzMFw1hYCKAWASTxzDR14cMlO2i2Sbt+RzLwIMBkSuyUN2GdllgY8VAhSrgJ3EJloBFrP0SsI9caJZZ32vnuYzumv21/MkCDTPqDZypyUz0ystHsexJcbtHQfUxxU/Mz/XmxdGaJnH+E0Pm2sUBy5eSvFZt5ixEw2ePoTGvlZyDpr5ENU0hzpl639y/sRhgCm/5EmCU+Ccgqt3ohJgzrM52SS4/QtKOrCnWLiAckL5bud1S1lzwDLi3QFEOGsvAqSLawD6AKa2Ltep8j8csEJi0/JAgUg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=intel.com smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=sgdSivTUkXFAQIC4B3yKlQhNL7qBUJGgBhMzgLevnqI=; b=mBDbgDtHm+AbxpdbrXDvCkt2hG0BBaDnwG5BDApvYGgQX78KGScw+AgB8FytxFz6mCk1GrkhPXnL949F/Yxh7XGxvjF3BMJqcloehlh2YMrGaMjBv5WLaX8qb2mdmT3FLLpafZ1DMtoElRttgL91kzSMUwntBrAXbsYub/8f/B4= Received: from MN2PR14CA0029.namprd14.prod.outlook.com (2603:10b6:208:23e::34) by DM6PR12MB4186.namprd12.prod.outlook.com (2603:10b6:5:21b::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37; Tue, 21 Mar 2023 23:59:59 +0000 Received: from BL02EPF000100D2.namprd05.prod.outlook.com (2603:10b6:208:23e:cafe::f4) by MN2PR14CA0029.outlook.office365.com (2603:10b6:208:23e::34) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6178.37 via Frontend Transport; Tue, 21 Mar 2023 23:59:58 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by BL02EPF000100D2.mail.protection.outlook.com (10.167.241.206) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6178.30 via Frontend Transport; Tue, 21 Mar 2023 23:59:58 +0000 Received: from telcodpdk.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.34; Tue, 21 Mar 2023 18:59:57 -0500 From: Ferruh Yigit To: John McNamara , John Daley , Hyong Youb Kim CC: Thomas Monjalon , Andrew Rybchenko , Subject: [PATCH 08/33] doc: update enic guide Date: Tue, 21 Mar 2023 23:59:16 +0000 Message-ID: <20230321235941.2169068-9-ferruh.yigit@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20230321235941.2169068-1-ferruh.yigit@amd.com> References: <20230321235941.2169068-1-ferruh.yigit@amd.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB03.amd.com (10.181.40.144) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BL02EPF000100D2:EE_|DM6PR12MB4186:EE_ X-MS-Office365-Filtering-Correlation-Id: 6b870982-a47d-400f-c4a2-08db2a68609c X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 1KtzIdjkprm3WelECA+VCnVGQ5pO4Dbb6//3uVbVDyNj2DLsDELifl44HcZc+7+cVHLfaFk0w1zQA0aPoPxfHd3Nf1yhiblqpdZq0KOE/9BtFL5sA9Jb6q7O7HbLI9gaa53ldWU64DwWXF1JliZqAE6Ia695lqnn0OTTCokpAwyds65j/AfpWsOZEgvSIEbHyCgtxWaHH4wVeDPTGPO6fhN2cIIAeQcxAXFKgqIL9upsPn7ZCPLAe6zaMkxEDKgSppWaBoQIAUEKAM9vAKFt5kqI4M2EHUbn/LgB89vDxkiy5f8FUS0cjPAi4pOzy5oWr+uYjB+yGuImdah0S7qttYeLuoXUiflT53JAcI0lRp7S7rydhpCwD9JdZNvBmj/ZITSI8VG3Mo1ItgxbwzDhkuTw+uFThXSCy3Z/OhrFSHcZHIPBbnlc4THu7slD2nhqGznZiS6+SmFd1V7U2FYNmDmkw0iCvsXWr3OtHus/z/ImhVIthc8BGaAbgBjyeFralDQwt5pyTCxewA1RsGt4rkqfcPLj3FuDUA9N1u7t+cPpAo6nNtabQsCTSXr/LTmMMJrCRTCyNApRvKvvRSQ43q1RN764jkMXxaryBOvRd18lsl4/kQl7kwjgXXrzZCRNY0dECobWLRSDuCttp1V8EFT25Tle/rYDmgB+wI1ednRYzHhlKGToub0FTPjf+kZDxzfOFtM8jEmqkBfHOLfeiiYqMcPT9j3SarH30Zr/X042NGQnB1R0T92iSIHamqozyaX1nGE6bVs5fA/aGZDS2A== X-Forefront-Antispam-Report: CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:SATLEXMB04.amd.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230025)(4636009)(396003)(346002)(39860400002)(136003)(376002)(451199018)(40470700004)(46966006)(36840700001)(54906003)(2616005)(47076005)(83380400001)(82310400005)(478600001)(426003)(966005)(8936002)(26005)(186003)(1076003)(6666004)(110136005)(16526019)(316002)(7696005)(356005)(81166007)(40460700003)(36860700001)(86362001)(44832011)(336012)(5660300002)(2906002)(70586007)(4326008)(70206006)(8676002)(82740400003)(36756003)(41300700001)(15650500001)(40480700001)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Mar 2023 23:59:58.8440 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 6b870982-a47d-400f-c4a2-08db2a68609c X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: BL02EPF000100D2.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR12MB4186 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 - Move "Supported Cisco VIC adapters" section up - Move "Supported features" section up - Remove "Contact Information" as this is duplication of Maintainers file Signed-off-by: Ferruh Yigit --- doc/guides/nics/enic.rst | 79 ++++++++++++++++++---------------------- 1 file changed, 35 insertions(+), 44 deletions(-) diff --git a/doc/guides/nics/enic.rst b/doc/guides/nics/enic.rst index 5e2054fc8a9d..5bf5cc9ab98f 100644 --- a/doc/guides/nics/enic.rst +++ b/doc/guides/nics/enic.rst @@ -10,6 +10,41 @@ NICs. These adapters are also referred to as vNICs below. If you are running or would like to run DPDK software applications on Cisco UCS servers using Cisco VIC adapters the following documentation is relevant. +Supported Cisco VIC adapters +---------------------------- + +ENIC PMD supports all recent generations of Cisco VIC adapters including: + +- VIC 1200 series +- VIC 1300 series +- VIC 1400 series + +Supported features +------------------ + +- Unicast, multicast and broadcast transmission and reception +- Receive queue polling +- Port Hardware Statistics +- Hardware VLAN acceleration +- IP checksum offload +- Receive side VLAN stripping +- Multiple receive and transmit queues +- Promiscuous mode +- Setting RX VLAN (supported via UCSM/CIMC only) +- VLAN filtering (supported via UCSM/CIMC only) +- Execution of application by unprivileged system users +- IPV4, IPV6 and TCP RSS hashing +- UDP RSS hashing (1400 series and later adapters) +- Scattered Rx +- MTU update +- SR-IOV on UCS managed servers connected to Fabric Interconnects +- Flow API +- Overlay offload + + - Rx/Tx checksum offloads for VXLAN, NVGRE, GENEVE + - TSO for VXLAN and GENEVE packets + - Inner RSS + How to obtain ENIC PMD integrated DPDK -------------------------------------- @@ -510,47 +545,12 @@ Refer to the document :ref:`compiling and testing a PMD for a NIC For configuring and using UIO and VFIO frameworks, please refer to the documentation that comes with DPDK suite. -Supported Cisco VIC adapters ----------------------------- - -ENIC PMD supports all recent generations of Cisco VIC adapters including: - -- VIC 1200 series -- VIC 1300 series -- VIC 1400 series - Supported Operating Systems --------------------------- Any Linux distribution fulfilling the conditions described in Dependencies section of DPDK documentation. -Supported features ------------------- - -- Unicast, multicast and broadcast transmission and reception -- Receive queue polling -- Port Hardware Statistics -- Hardware VLAN acceleration -- IP checksum offload -- Receive side VLAN stripping -- Multiple receive and transmit queues -- Promiscuous mode -- Setting RX VLAN (supported via UCSM/CIMC only) -- VLAN filtering (supported via UCSM/CIMC only) -- Execution of application by unprivileged system users -- IPV4, IPV6 and TCP RSS hashing -- UDP RSS hashing (1400 series and later adapters) -- Scattered Rx -- MTU update -- SR-IOV on UCS managed servers connected to Fabric Interconnects -- Flow API -- Overlay offload - - - Rx/Tx checksum offloads for VXLAN, NVGRE, GENEVE - - TSO for VXLAN and GENEVE packets - - Inner RSS - Known bugs and unsupported features in this release --------------------------------------------------- @@ -604,12 +604,3 @@ Additional Reference - https://www.cisco.com/c/en/us/products/servers-unified-computing/index.html - https://www.cisco.com/c/en/us/products/interfaces-modules/unified-computing-system-adapters/index.html - -Contact Information -------------------- - -Any questions or bugs should be reported to DPDK community and to the ENIC PMD -maintainers: - -- John Daley -- Hyong Youb Kim -- 2.34.1