From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <dev-bounces@dpdk.org> Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 850F0427F9; Wed, 22 Mar 2023 01:00:14 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 375FB42B8E; Wed, 22 Mar 2023 01:00:03 +0100 (CET) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2047.outbound.protection.outlook.com [40.107.94.47]) by mails.dpdk.org (Postfix) with ESMTP id C84B340A84 for <dev@dpdk.org>; Wed, 22 Mar 2023 00:59:58 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=W0BjFibmie9KZvdAg9fDRfYyTQASFfl19jGDxuPFcMKmUj4XN973rWeNfvIvP7wep8gU5vbNJNb1yUqFOj/qgcNtaktZHntMX7Km58UucQ+a4wubfpgCn/VnNa4fHogj1KJQyrLHM/cqnCPsgfvzPJs9ItVcltVy/ReTqMSnDlWoCyeMqm8d8dXHaNplP30+vkV64k4/GgUl06Ky6vxFozWPBb45XfPx3vIgJiz2ao2zD8x1sq9bsGdmM9FI++gk3EMHu0XlGkCVOePD4r+Kw7nBT35oVt2xf1ROWW+v75PHa8FB6aPV+zjNBQwDtXOAGt1BfikYFmzYJqI0InWhfA== 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=rdYJujEr3urfiZAyPjrbjqgSpR9XBE4lfaP3ykBS+Wc=; b=F5hpwSMNiiHT5dk7hPjxF8c9+4k0kgfff3poVm/pIBbb1ImBnZm2a91TTv6DiYLjZ0xpRnddaFKvYjdy8xYQ4TCPXk3hlArVrKrwaJ6zGwfIYPGugY8aOrXQGpnffQSOVbb1PuvYMG6v1nEOPRu9JRaGlX6dJ1ZBoufY3ltDpRchODmSwSqCaVU1hlmVsIM5g68NTrBj6kUCygi17YF4FIWrYG25wRw8cgD/j3qgzW0TYgEV0Bi42s1QBnSsVLRPmNFLVh5Wxsr5XBuOoix3rbYLeWCq+1GMskxIqyBbqo7+/89cGmm4HB5SOMU45mtqPwVHHpdP8zJhG5z7NljtMQ== 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=rdYJujEr3urfiZAyPjrbjqgSpR9XBE4lfaP3ykBS+Wc=; b=GxPMFewFlJw57mI6cLyrrsa08jXbi3sLIY6OnKSwuDs+AC0ARhyZFRIJW8rGRo9l7gE0gNcqSYWPHLDmmmwIZppJTDYEhgNMRHmqYvAFCAV+YcHgTAgh4Csqbs7CoW52Q2CvosBH/uV0Oe4o3VC5dedfB+ThETb37yjS6BN2awM= Received: from MN2PR14CA0024.namprd14.prod.outlook.com (2603:10b6:208:23e::29) by DM4PR12MB5104.namprd12.prod.outlook.com (2603:10b6:5:393::24) 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:56 +0000 Received: from BL02EPF000100D2.namprd05.prod.outlook.com (2603:10b6:208:23e:cafe::f0) by MN2PR14CA0024.outlook.office365.com (2603:10b6:208:23e::29) 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:55 +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:55 +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:52 -0500 From: Ferruh Yigit <ferruh.yigit@amd.com> To: John McNamara <john.mcnamara@intel.com>, Yuying Zhang <yuying.zhang@intel.com>, Beilei Xing <beilei.xing@intel.com> CC: Thomas Monjalon <thomas@monjalon.net>, Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>, <dev@dpdk.org> Subject: [PATCH 02/33] doc: update cpfl guide Date: Tue, 21 Mar 2023 23:59:10 +0000 Message-ID: <20230321235941.2169068-3-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_|DM4PR12MB5104:EE_ X-MS-Office365-Filtering-Correlation-Id: d1028455-b0e5-4668-8a77-08db2a685edc X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: J+OGhxJLF5BzSsdaNaMZPG8XgxeSVNjhLXpiPqCx0a0saMROff59Tm1FEdPKYSuIPZRqagjTmvoqJU2IAusYela58za1WEIO+vbTc8yfAFnFWWrG5UIdgOAhdQxuqUlV2A5KEW25rvgooojSFTt0wnQ0/CJiLg9GBiShQLoptd8lxCiw3y0JmUqpDbYWcQJ3kBnij1OQAuP9dn9olBiFvyNiQh4111AN0WGFf7HoR3+EGVbBRtQVcbmaT0bdHHhN/pcpqoZzYT5+qujfBqpyEgG9SGXaLm7ZLiAYGwZ9oX2T9DoMfllB5JU4Acv0kMUYCa3Y/63z+ynu2wMfxWFT8djTg+PZS+5yHzYSMcsBpzhaIgSzijwDN9JNCwtOPZ12wdWA57Pntc8M9teXhynAraOzhHVuAGRtT6qrC+WoXd1jOzdWCDS4Jgry33LXK5kP3PdRmTdi8T5tqGFY7qxjrY6oUK2XXYTw/INDXI9mPBHNpWTVInpXt4dEU99Ss+L7UBAKotQgNMTjkWj4CtUZ+oQ5chKWmfxl9kzdcPnj+WaD5UKH4njvZvCnGPN2XXEq6YulzRInmnBoPnUXypZEgG183F+QLEDbxyN+ajM1YxYxIIV/MN/cKmvFae7a8s/f7ENh+KVUN+7bmjOh9h6lyx6HpUnRPn5OLO+6rNUF4GhssHspbeBPrTxSDaMerDDriv61CHHfJHcoTROI+cB6pt1l07HSfP8taPBcEIs9KMQ= 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)(39860400002)(376002)(136003)(396003)(346002)(451199018)(40470700004)(36840700001)(46966006)(2616005)(7696005)(16526019)(426003)(4326008)(478600001)(83380400001)(47076005)(6666004)(336012)(316002)(110136005)(70586007)(70206006)(8676002)(1076003)(186003)(26005)(54906003)(36860700001)(8936002)(44832011)(41300700001)(5660300002)(82740400003)(40460700003)(2906002)(81166007)(356005)(36756003)(86362001)(40480700001)(82310400005)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Mar 2023 23:59:55.9065 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: d1028455-b0e5-4668-8a77-08db2a685edc 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: DM4PR12MB5104 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions <dev.dpdk.org> List-Unsubscribe: <https://mails.dpdk.org/options/dev>, <mailto:dev-request@dpdk.org?subject=unsubscribe> List-Archive: <http://mails.dpdk.org/archives/dev/> List-Post: <mailto:dev@dpdk.org> List-Help: <mailto:dev-request@dpdk.org?subject=help> List-Subscribe: <https://mails.dpdk.org/listinfo/dev>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org - Rename "Pre-Installation Configuration" section to "Configuration" - Rename "Runtime Config Options" section to "Runtime Configuration" Signed-off-by: Ferruh Yigit <ferruh.yigit@amd.com> --- doc/guides/nics/cpfl.rst | 51 ++++++++++++++++++++-------------------- 1 file changed, 25 insertions(+), 26 deletions(-) diff --git a/doc/guides/nics/cpfl.rst b/doc/guides/nics/cpfl.rst index e2d71f8a4c20..91dbec306dbb 100644 --- a/doc/guides/nics/cpfl.rst +++ b/doc/guides/nics/cpfl.rst @@ -20,12 +20,33 @@ Follow the DPDK :doc:`../linux_gsg/index` to setup the basic DPDK environment. To get better performance on Intel platforms, please follow the :doc:`../linux_gsg/nic_perf_intel_platform`. +Features +-------- -Pre-Installation Configuration ------------------------------- +Vector PMD +~~~~~~~~~~ + +Vector path for Rx and Tx path are selected automatically. +The paths are chosen based on 2 conditions: + +- ``CPU`` + + On the x86 platform, the driver checks if the CPU supports AVX512. + If the CPU supports AVX512 and EAL argument ``--force-max-simd-bitwidth`` + is set to 512, AVX512 paths will be chosen. + +- ``Offload features`` + + The supported HW offload features are described in the document cpfl.ini, + A value "P" means the offload feature is not supported by vector path. + If any not supported features are used, cpfl vector PMD is disabled + and the scalar paths are chosen. + +Configuration +------------- -Runtime Config Options -~~~~~~~~~~~~~~~~~~~~~~ +Runtime Configuration +~~~~~~~~~~~~~~~~~~~~~ - ``vport`` (default ``0``) @@ -83,25 +104,3 @@ Driver compilation and testing ------------------------------ Refer to the document :doc:`build_and_test` for details. - -Features --------- - -Vector PMD -~~~~~~~~~~ - -Vector path for Rx and Tx path are selected automatically. -The paths are chosen based on 2 conditions: - -- ``CPU`` - - On the x86 platform, the driver checks if the CPU supports AVX512. - If the CPU supports AVX512 and EAL argument ``--force-max-simd-bitwidth`` - is set to 512, AVX512 paths will be chosen. - -- ``Offload features`` - - The supported HW offload features are described in the document cpfl.ini, - A value "P" means the offload feature is not supported by vector path. - If any not supported features are used, cpfl vector PMD is disabled - and the scalar paths are chosen. -- 2.34.1