From patchwork Sun Nov 19 13:24:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Raslan Darawsheh X-Patchwork-Id: 134470 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 610F043373; Sun, 19 Nov 2023 14:25:08 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id D026E42D80; Sun, 19 Nov 2023 14:25:07 +0100 (CET) Received: from NAM12-DM6-obe.outbound.protection.outlook.com (mail-dm6nam12on2067.outbound.protection.outlook.com [40.107.243.67]) by mails.dpdk.org (Postfix) with ESMTP id 5BEDC40285 for ; Sun, 19 Nov 2023 14:25:05 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Flzz0j1hZNk/7wah6PLDLiD8yRvZlYUUi8KcJzKUPBlzyYhTneCOBS5xd4+HcEM5N/EvsIX9gt+rRHp5Pag44JqLtUoXv6Hd51yWoP6qPDmCGbO49LOG9ZOIIXfbvm+g8K9ShQZYKU50z81KtZqedD3boCtOftewVgO3QypjlqenAS9Zm3eXNw8YpwIltAeYha0M49Jveie1U2VkbpyElLG55xrmAE+Ep+npmUNHa1/H5aLT7Q2Bfdk5RTLfLQEdudHCS8PXq/19EbigVTCWniEKdCltPfMpk2q+9V4Z/HYQaWRcB4FhcTy7SPdAVCf19SJQ0d1bulLCLThILSQl4w== 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=yCyY32xFZVCymZPTDWcRN2vlWRGA8CMH6jOIfs+n/Yo=; b=ZFhkiwqjPbTmfi2XqChnB0rYb1aCzWrJwFWiCg0qrew0hpVkpcMa/vBR/snJAL0TVGKfXQPgvpRQ7k/1vlq/fbSTIiwXcWituEhGKsWoIFE55YND6tIgLDlUmxRDO/w1QzmGb5c01gL0fIo010o/EnFbIhHMFPYD0Tn1Uy1llAHsDeNTkdWyj7yV16jfjY4b1OFfEjaW3cSxPMG0EwlNulxyuFsa2VNa08n+p7n04OofNOUFcGGBwlj+39ihIzin0YiR14aYFU29qgOkd8Yitm6pxr6i2IZlXkw4mFMJ/QbZL82Ut0AlseYkOHxs1NettL7ovlutBIdwnuB5/HVEAw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) 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=yCyY32xFZVCymZPTDWcRN2vlWRGA8CMH6jOIfs+n/Yo=; b=LL5woCR+xF0On0baRqYSi/lMrnocbIncSSjrMB6OxzAPfEcs1ddpMKN08hvXPDYgUq1HCJiP5YSzQCzRGhUqVAJgtxy0WCKuEYDlfSznOJ2pKYjMi4hr7KON3IpjWwfFMvrJq95njcolJkAkEQ83CftGh4E9XqOaVIuJ0nUEQBBgv+YzDRTEnjUjGdFc/yJYccyZ6k+YYsdhVL2K8Q+T2D2qh0e3Nln/AwmXtWSdGLjKq//oIXVcl7oI1OgbsXPqXtIb2RIe6GC1gF/8KomabDzc9h4v7hqYD3FXwIy6jW8pS7E2uO0emLpqJLfppQNf/3x5X3nE82je6H9ZWXlkAg== Received: from CYZPR05CA0017.namprd05.prod.outlook.com (2603:10b6:930:89::14) by DM4PR12MB7765.namprd12.prod.outlook.com (2603:10b6:8:113::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7002.26; Sun, 19 Nov 2023 13:25:00 +0000 Received: from CY4PEPF0000EDD3.namprd03.prod.outlook.com (2603:10b6:930:89:cafe::4c) by CYZPR05CA0017.outlook.office365.com (2603:10b6:930:89::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.14 via Frontend Transport; Sun, 19 Nov 2023 13:25:00 +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 CY4PEPF0000EDD3.mail.protection.outlook.com (10.167.241.207) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.12 via Frontend Transport; Sun, 19 Nov 2023 13:25:00 +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.41; Sun, 19 Nov 2023 05:24:51 -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; Sun, 19 Nov 2023 05:24:50 -0800 From: Raslan Darawsheh To: CC: Subject: [PATCH] doc/mlx4: set limitation for RSS Date: Sun, 19 Nov 2023 15:24:30 +0200 Message-ID: <20231119132430.3666-1-rasland@nvidia.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: rnnvmail202.nvidia.com (10.129.68.7) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY4PEPF0000EDD3:EE_|DM4PR12MB7765:EE_ X-MS-Office365-Filtering-Correlation-Id: 666501fe-8df8-4e8a-6be6-08dbe902ee75 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: 031ikmLpt8IdDU9CAWoKYlpUb/hVCcfx5BQt9Hrnr4xJeX3A6C+T5mMLy++K5NGSBBtYF8o80lshnbbK23oV5eK25nj2YW6f3KAnEn/EhrndUr/8bcfZ3VSUKDPfjY3Sjsmc+LFdu3r3D/6EZ3TckUh2BXlkHZgthX0aMtG414C2WQGDvmGL22vfFStiJ55VGOm4+IzkwUW3fae7PuEeQdE6U0mBzTN2xG61CLcC32kfDEghJWECiLqzh4+gxWaiREamZM3BW1ODK2/iCc8r1sepy1vIXK/+yoW/5QsR3S11CSe6UFrzOE1J4E1a3O1lKrBC42erhxOc5lZ4u/c88Y11gUqlf7ytNjidvenrVNRNu3qj/YCKNdUWjrAO9bt+kO2hjfHIpvWF/S+hbcIJoI6Y7DwXdvnAN2u8jkLygmi+kr05pjHvYIdlJvojJywCrzdDyPSBuOQEDPo5wSNVz8jdmD/PbhR0Lm+6US4WIHoJufoEObbkOQW3YOXxNOSr1wdNN7bwWDWdum85Q0Jc1IcObZ7tC0nZloQEKwMQg+whob67dNq4eVYH/JiYgWW64eSl8MrJ+ptYIiIQ+SHM0tlRbDM0KryWtSq5xLaCSKB98/lRbHIbF0Ay4/Vp0hKJtjlpj0TdgLfH+l9NtYEj+BTdBP08jhFVncCOrZ7SH4JR+tPhS77BRPZ7o/UzfBb0LLU4K8vKudzAWrMiO4+hJWTw5J9GGOmMALGMFVwKe0Bot1BfkyQ8LsVbJS+Tu0MB 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:(13230031)(4636009)(376002)(39860400002)(346002)(396003)(136003)(230922051799003)(82310400011)(1800799012)(451199024)(64100799003)(186009)(46966006)(36840700001)(40470700004)(5660300002)(2906002)(316002)(4326008)(8676002)(8936002)(41300700001)(70206006)(6916009)(70586007)(55016003)(26005)(6666004)(478600001)(1076003)(7696005)(40480700001)(2616005)(16526019)(36756003)(336012)(426003)(86362001)(83380400001)(82740400003)(40460700003)(6286002)(47076005)(7636003)(356005)(36860700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 19 Nov 2023 13:25:00.1842 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 666501fe-8df8-4e8a-6be6-08dbe902ee75 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: CY4PEPF0000EDD3.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR12MB7765 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 adds a limitation explanation on RSS queue usage for MLX4 pmd. MLX4 pmd requires a power of two queues to do RSS but, the user can still open more queues which can be utilized through flow API. Signed-off-by: Raslan Darawsheh --- doc/guides/nics/mlx4.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/guides/nics/mlx4.rst b/doc/guides/nics/mlx4.rst index c6279f51d0..f59e52a671 100644 --- a/doc/guides/nics/mlx4.rst +++ b/doc/guides/nics/mlx4.rst @@ -145,6 +145,18 @@ Limitations - TSO (Transmit Segmentation Offload) is supported in OFED version 4.4 and above. +- RSS only works on power of two number of queues. +- The user can open none power of two queues, but the PMD will round down + to the highest power of two queues by default for RSS. + Other queues can be utilized through flow API. + example:: + ./dpdk-testpmd -a 08:00.0 -- -i --rxq 12 --txq 12 --rss-ip + + The first 8 queues will be used by default for RSS over IP. + The rest of the queues can be utilized through rte flow like the following:: + flow create 0 ingress pattern eth / ipv4 / tcp / end actions rss queues 8 9 10 11 end / end + + Prerequisites -------------