From patchwork Tue Nov 7 15:10:07 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jiawei Wang X-Patchwork-Id: 133940 X-Patchwork-Delegate: rasland@nvidia.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 254AF432C8; Tue, 7 Nov 2023 16:10:40 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 116B1402DD; Tue, 7 Nov 2023 16:10:40 +0100 (CET) Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2048.outbound.protection.outlook.com [40.107.93.48]) by mails.dpdk.org (Postfix) with ESMTP id 02059402A1 for ; Tue, 7 Nov 2023 16:10:39 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mIfZpDwK5RZRizL0VC975BriXHqW3I8D0xOH2nTvkqB1UfnGTb36Q09gSPe//9+YjUxxlht0zYqtdWC9OcpLsasV0PfH8xu0LoPyJhdZvd1I1cmV8xpSXPpZFuWxfgKVj0u1Cn7y3esxrE+Q2f01tU2ZgEk7lbaavhvijQ/2szhhtgQ3OqAtg8orksSJnslF81NOCs4av9n+4N9M5NtVZkfbE0ejb231AT8oE5PThx+z/s4C1rTjWdx0Kq/YVWICn5/VfEomyN8H4kiMd+VaCkvFlQMra1lNVv9W0btGSvkyoYfEJ4tZGVGAzzKwtb56t6YdjP2PE0ZoM932V7b5EQ== 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=nM723UNC47j37WaQjWA1CLpm85INexya9qxg5EYRkPs=; b=Vj1u6/pTxXpxQmUh7q27lS+rnxbIRT3eh+61LYexiOwP0vS3L9s9i4Q4WZ7xY9NkSFEuiPEUW+TnE4PMCeUgQpPbCVfn802QqSPumZvsq5ls7BR3L3a2YQDqTukWjNYnthhM2gyzvuEG2fID0WgxKiyjiHSAT6+0CTf4bXfpGsM4nHO0zKD4M+GWVsqHqwMr4PQrJ5H33B0W7iAQa1qJ1O+UIw26crb2Q4/HxDJnf3rrgCMQGCiplbDNIibE2vto5gp8rBj0ZHoXrDoVCKSVFdhSkNx++BIMuJmOzfGN6wtBXcwfLt5uQUuO1YE6axABaE91pNm0zRzTKaPHxIoYLg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) smtp.rcpttodomain=monjalon.net 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 (0) 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=nM723UNC47j37WaQjWA1CLpm85INexya9qxg5EYRkPs=; b=Q+d8CONYlKMVsqwKrdqTCactHElO4yxZECqbyDNVHej7I+oyj6W5G7UlrX6GGY60vtxmfFicIhCszBqSggIdQ+NPpSJ/hRwY7jzY8lY0Qs1FFR6Fjb8lua2+qNDzC11bDqoG5ohip2015zpMMBUOROktenuNODy9dknAU7YaDZFVbm+O2jThf/aq98neh4pZKvycOfDeHSf91CsekjBQR+C0KXDM+Ah2lMeSeHNzdvDoZlrh7xb+hVcF+8EPWdP1zICf0FFqZPa4HPeWG5lPHROKLukIdZf31hHbs7FmK9el+rIBuS+MCLYCuwO6GUiLzTTZUE0ouiiDVFIfZaq+CQ== Received: from CH0PR03CA0043.namprd03.prod.outlook.com (2603:10b6:610:b3::18) by DS7PR12MB6093.namprd12.prod.outlook.com (2603:10b6:8:9e::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6954.28; Tue, 7 Nov 2023 15:10:37 +0000 Received: from DS3PEPF000099D7.namprd04.prod.outlook.com (2603:10b6:610:b3:cafe::b) by CH0PR03CA0043.outlook.office365.com (2603:10b6:610:b3::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6954.30 via Frontend Transport; Tue, 7 Nov 2023 15:10:37 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) 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.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by DS3PEPF000099D7.mail.protection.outlook.com (10.167.17.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6977.16 via Frontend Transport; Tue, 7 Nov 2023 15:10:36 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.41; Tue, 7 Nov 2023 07:10:23 -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.41; Tue, 7 Nov 2023 07:10:20 -0800 From: Jiawei Wang To: , , , Matan Azrad , Ori Kam CC: , Subject: [PATCH] doc: clarify mirroring limitations in mlx5 guide Date: Tue, 7 Nov 2023 17:10:07 +0200 Message-ID: <20231107151007.31044-1-jiaweiw@nvidia.com> X-Mailer: git-send-email 2.18.1 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: DS3PEPF000099D7:EE_|DS7PR12MB6093:EE_ X-MS-Office365-Filtering-Correlation-Id: 688a4d3e-2927-44b8-54b9-08dbdfa3b270 X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 0j1GiFfpXuLlRw/bD1q1y7z58vkyKNQreK+GUjauNydlQ9mBcYfUNxKpYoMBGQfJ1GQI5DUykokHQMYRcc2SHvYp8WtmQaydEzm/N0IVyqX0ySXeTjFwSnwntuGfKz+E++PISpPG7K/NpxipOD+p3j3NmSOf9NQsRHeKKduUbedofG/dnG/J0aWtbPzJGZPvegw3BvM/Xy77TnnQrsclO5KL/ZYbwu2G2BQqek7BbnYqphL54RCY5CzGI3LgX9DgD7kSiK17pcKwIuITPESSBgfzkqfaxe/sbtb/TrwJvGlqbhR65MG6V/lJzm7HAOmQAQ6hc+LtHdB1v6duJQMet96dbllcKpkX5DgzsHtdzjjUqHKs60OMz/fl/T2pI6RmNCc0BcteXxV6WuHLQHYxfUTKKUIE+JtoHEvqAbgOlud3b9yGudCmbk1oWfSbk4kpUq2Gs3oAIWGu6sErAri24T5IWrgV2S+fe5a3lYpNGtLcg386vCC4Ihk26A9P+fG/Sn3nVMIJ3ETgok8tzQuDc61NFXcGzayGiOLIgceXu+Q4N3yqplcNooG85xtW8bCVX8NvXkqb/DhF43k+UTpYeywv6ba/TlpiQ2Y2CBKZyRvchcZcTx/8UQFMk2BetUQMV67mNRcU/EOz+hGYhZ7/IfK7lCpKwYRF77mILa02foMGgPwcqV03rc4JBhpeSoXLOkjMEqg1a2uLhDKHdVjyblksF3YLy4JvBC/PAz/ljThGb6ZtiobG+dZS+X6O7AhY X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230031)(4636009)(136003)(376002)(346002)(396003)(39860400002)(230922051799003)(186009)(1800799009)(82310400011)(451199024)(64100799003)(46966006)(36840700001)(40470700004)(55016003)(40480700001)(40460700003)(2616005)(6666004)(478600001)(7696005)(54906003)(2906002)(36860700001)(36756003)(356005)(316002)(82740400003)(86362001)(7636003)(47076005)(5660300002)(107886003)(41300700001)(83380400001)(1076003)(70586007)(336012)(16526019)(426003)(26005)(6286002)(70206006)(8676002)(4326008)(110136005)(8936002)(6636002); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Nov 2023 15:10:36.7864 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 688a4d3e-2927-44b8-54b9-08dbdfa3b270 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.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DS3PEPF000099D7.namprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR12MB6093 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 Update the description of flow mirroring to make clear what are the limitations of the mlx5 driver. Signed-off-by: Jiawei Wang Acked-by: Thomas Monjalon --- doc/guides/nics/mlx5.rst | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 45379960f0..b2ac7c5097 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -537,19 +537,23 @@ Limitations - Supports ``RTE_FLOW_ACTION_TYPE_SAMPLE`` action only within NIC Rx and E-Switch steering domain. - - For E-Switch Sampling flow with sample ratio > 1, additional actions are not - supported in the sample actions list. + - In E-Switch steering domain, for sampling with sample ratio > 1 in a transfer rule, + additional actions are not supported in the sample actions list. - For ConnectX-5, the ``RTE_FLOW_ACTION_TYPE_SAMPLE`` is typically used as first action in the E-Switch egress flow if with header modify or encapsulation actions. - - For NIC Rx flow, supports ``MARK``, ``COUNT``, ``QUEUE``, ``RSS`` in the + - For NIC Rx flow, supports only ``MARK``, ``COUNT``, ``QUEUE``, ``RSS`` in the sample actions list. - - For E-Switch mirroring flow, supports ``RAW_ENCAP``, ``PORT_ID``, - ``VXLAN_ENCAP``, ``NVGRE_ENCAP`` in the sample actions list. - - For E-Switch mirroring flow with sample ratio = 1, the ``ENCAP`` action - supports uplink port only. - - For E-Switch mirroring flow with sample ratio = 1, the ``PORT`` and ``JUMP`` actions - are not supported without presented ``ENCAP`` action in the sample actions list. + - In E-Switch steering domain, for mirroring with sample ratio = 1 in a transfer rule, + supports only ``RAW_ENCAP``, ``PORT_ID``, ``REPRESENTED_PORT``, ``VXLAN_ENCAP``, ``NVGRE_ENCAP`` + in the sample actions list. + - In E-Switch steering domain, for mirroring with sample ratio = 1 in a transfer rule, + the encapsulation actions (``RAW_ENCAP`` or ``VXLAN_ENCAP`` or ``NVGRE_ENCAP``) + support for uplink port only. + - In E-Switch steering domain, for mirroring with sample ratio = 1 in a transfer rule, + the port actions (``PORT_ID`` or ``REPRESENTED_PORT``) with uplink port and ``JUMP`` action + are not supported without the encapsulation actions (``RAW_ENCAP`` or ``VXLAN_ENCAP`` or ``NVGRE_ENCAP``) + in the sample actions list. - For ConnectX-5 trusted device, the application metadata with SET_TAG index 0 is not supported before ``RTE_FLOW_ACTION_TYPE_SAMPLE`` action.