From patchwork Wed Nov 9 16:31:14 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dariusz Sosnowski X-Patchwork-Id: 119620 X-Patchwork-Delegate: andrew.rybchenko@oktetlabs.ru 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 DEDD2A034C; Wed, 9 Nov 2022 17:32:27 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3027B400D4; Wed, 9 Nov 2022 17:32:19 +0100 (CET) Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2079.outbound.protection.outlook.com [40.107.93.79]) by mails.dpdk.org (Postfix) with ESMTP id 9512B42D0D for ; Wed, 9 Nov 2022 17:32:17 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=RYntxzu/zz8bbDtnftUT3a1QXa1FLOhFcWaMiQmPWRjaE8KjLAixrIPngkKQNYKaTALFk6/3/uZuzWuAz/9ibfqj3QGz3b8qKJ5jirKVdRMbeY+cFuosP5LeqQ/mroxE3ugCNpJE/YMEUcVyzu/XuYUz7MLxcfj+aCYByvNsyWykF0FYCX3inWbGwDaRBfKFCjocwx8Dvh47QvVdfQleV0wHhaBker2yh4g1+2pcMTomHtb8u083WQJS1fkqxDmUabV67oOH6AMNEM9c5cLQpuLYLUkRuYE4+wuEXqtwMY0sH2naMVpN59SKDzk6pYInpkd7KLoxHo7nNoVBZX03aQ== 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=ZPp/YUUBkS7MmSxOGIyY+K7RMkl4LjKg8DYwcVvPdU4=; b=JtsZxBPAgpclAyEwp9F7zMZHohFtSLejl3CLmLatSc6K6QNvmQnvdjmJkiltaSXCrX4kwmEAUMsLh/NaSedId1TW5bc9tAMyZ0A05B99YWSOMEHTKRVjmZ9piv+2fgnD49i+P4x/2dD3pOZGK8iZuXu8N6vFWbQwxoN1x4ahfm2lj/OhnuwmOPDsUgTaUizfRnQ/gG6yYgvqMB9dU2XlGBvYJfvo0fyRYGH+qKPP7NtE+p17uVymPdvi89ppABGh32ftNP2m71cz8ZLKzJ4I2q3Q9o/m7Y7/3fN+nQtdMrx9UbnY/84Uz1FLz/lOSVJVxo09/kAlKGqVwcJ1DFfeVQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ZPp/YUUBkS7MmSxOGIyY+K7RMkl4LjKg8DYwcVvPdU4=; b=Ty8E9IkVoHR79ACR3eM8PGKFVU84zxXzDM3NRBNzcmKN676VZEGXWbZCT4CVpnugr9X3Z9E0zgw59iEngFeQr7cbrX/IQn2bpsGWOntQDY8eJ8c415VYgUzmTPgRL/fAn7x2F6h5FYVQXW69ZyCbMJDrYX1hgf+FdU0REmwo5AUU1gR1DTqS8Ieymyb6XKZXDHQg/aAfsPe8r1YmFyulEf6VdU64ZHvSo2UKFiPD49J1jU5tzr+1+ce++nO5p1YVTvYKJp8BrPCvg/QNxENJwttJetJ9DilNGlPjQqCIDpHkcISDvgEX6esLXaaf2g5v5E5Q/jgCoD+d75g/77X2Tw== Received: from DS7PR03CA0072.namprd03.prod.outlook.com (2603:10b6:5:3bb::17) by PH7PR12MB6585.namprd12.prod.outlook.com (2603:10b6:510:213::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.27; Wed, 9 Nov 2022 16:32:15 +0000 Received: from DM6NAM11FT052.eop-nam11.prod.protection.outlook.com (2603:10b6:5:3bb:cafe::f0) by DS7PR03CA0072.outlook.office365.com (2603:10b6:5:3bb::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.27 via Frontend Transport; Wed, 9 Nov 2022 16:32:15 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by DM6NAM11FT052.mail.protection.outlook.com (10.13.172.111) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.12 via Frontend Transport; Wed, 9 Nov 2022 16:32:15 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.26; Wed, 9 Nov 2022 08:32:04 -0800 Received: from nvidia.com (10.126.230.35) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Wed, 9 Nov 2022 08:32:03 -0800 From: Dariusz Sosnowski To: Matan Azrad , Viacheslav Ovsiienko CC: Subject: [PATCH 2/3] doc: document E-Switch limitations with HWS in mlx5 PMD Date: Wed, 9 Nov 2022 16:31:14 +0000 Message-ID: <20221109163115.868939-3-dsosnowski@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20221109163115.868939-1-dsosnowski@nvidia.com> References: <20221109163115.868939-1-dsosnowski@nvidia.com> MIME-Version: 1.0 X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: rnnvmail201.nvidia.com (10.129.68.8) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT052:EE_|PH7PR12MB6585:EE_ X-MS-Office365-Filtering-Correlation-Id: b3fc7d4d-300f-4091-c8c3-08dac26ff667 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: /bZh3sNxYsB/cEKnYsSykkPAH8sn3r+kN6FHsbjy97UWvtvXOJiH81FWcJiE1kH79V7GFiGxaoVs2yJuU01mgDWwBKrO5J/XsGhB/oGQ9MPoTAO2Y6xp6r2cWHCgyMIyd9llQ0FtHYbccE3ZpCrr5Hcx3DOD0bWHkQP/tHx1l4meTs2t3oalXkXljPLXj0BaOjkkfMLi6dj3iYjvrL5xThPWHR1SlbwAuYyfTOJ7M2xY/DPHPoe2SLpZTFO5xDtNd2c+flkNg7twfcRILYZqP+ZoTjRhjg3e96tABOCpxNy+0gGWb3MwOMq/bH9+mx/Nn76irdv+OJ9OYdq5s8kfCYA+v/YDav+BdGkdcivEQZ8ZoqDIjkN+tL2XSAr8FRE5NY7KJRw4uqVj+TrGePCFGAXhcA0AgC/QxP3nt2rIgOEIC65ss7x7EBnRk3MofEkBRVQDpNQBVfmAKFlMkcNu3e0RwJWm2CiFm/pO2Q/ejqu6Vcpl3RbSY4omtZMsWJjiE9ZXlYlTfZfHVGJzM1DCi8EcU4ZLD/zmW0nap2aV5su81cWOcay4PBSMkuxzzvJOyTRnlHJuCJ0f71RXb2o62++5jhiGdWUg6CHr7MjsU+gfPyM7At0Odu8JNNBbZJe16YTif6PptgiA7lENj1dtq64Bji1fsB1zsRTY5MQrDabJWDzTcS9afJvI28WHufeAw9auOpHOiXXk3D2ChbHts/B1wkO41AN1YzaVODR+ULaPaYH2U6L1MX/G5SzXCZZakFP89+FGPdH17iVz03X7Xg== X-Forefront-Antispam-Report: CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE; SFS:(13230022)(4636009)(136003)(39860400002)(376002)(396003)(346002)(451199015)(40470700004)(46966006)(36840700001)(36756003)(2906002)(40480700001)(36860700001)(6636002)(4326008)(47076005)(86362001)(8676002)(110136005)(16526019)(70206006)(316002)(70586007)(83380400001)(40460700003)(426003)(1076003)(336012)(41300700001)(186003)(2616005)(7636003)(55016003)(7696005)(5660300002)(6286002)(6666004)(82310400005)(8936002)(356005)(26005)(82740400003)(478600001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Nov 2022 16:32:15.5939 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: b3fc7d4d-300f-4091-c8c3-08dac26ff667 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.161]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT052.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR12MB6585 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 patch adds the following limitations to the mlx5 PMD guide: - With HW Steering and E-Switch enabled, transfer proxy port must be started before any port representor. - With HW Steering and E-Switch enabled, all representors must be stopped before transfer proxy port is stopped. Signed-off-by: Dariusz Sosnowski --- doc/guides/nics/mlx5.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 4f0db21dde..7e39bb2ea5 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -161,6 +161,19 @@ Limitations - NIC ConnectX-5 and before are not supported. - Partial match with item template is not supported. - IPv6 5-tuple matching is not supported. + - With E-Switch enabled, ports which share the E-Switch domain + should be started and stopped in a specific order: + + - When starting ports, the transfer proxy port should be started first + and port representors should follow. + - When stopping ports, all of the port representors + should be stopped before stopping the transfer proxy port. + + If ports are started/stopped in an incorrect order, + ``rte_eth_dev_start()``/``rte_eth_dev_stop()`` will return an appropriate error code: + + - ``-EAGAIN`` for ``rte_eth_dev_start()``. + - ``-EBUSY`` for ``rte_eth_dev_stop(). - When using Verbs flow engine (``dv_flow_en`` = 0), flow pattern without any specific VLAN will match for VLAN packets as well: