From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR01-VE1-obe.outbound.protection.outlook.com (mail-ve1eur01on0061.outbound.protection.outlook.com [104.47.1.61]) by dpdk.org (Postfix) with ESMTP id 615A71B856 for ; Thu, 8 Feb 2018 07:56:10 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=NpcvSmW5niIwAOUKUHOAw+o65mL2Vy6qt+fXfzk2kaM=; b=XTVDCS8dbtPm6uQZyVtuEnsTp2+B7ar/fNQ8yi0d359cbmYZTFwzhoHwywHpH9TV8jgJeNnyaHoojV8aiGzgdJOnbVRSK85yaQFq4NinsDXWqM37ohfy+eM6miqiS4zxrYZiToTrFt+3bVrGSKfWQ/nhMAkE6PVxCayR1XTDcg0= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=ophirmu@mellanox.com; Received: from mellanox.com (37.142.13.130) by VI1PR0502MB3885.eurprd05.prod.outlook.com (2603:10a6:803:c::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.485.10; Thu, 8 Feb 2018 06:56:07 +0000 From: Ophir Munk To: dev@dpdk.org, Adrien Mazarguil , Moti Haimovsky Cc: Thomas Monjalon , Olga Shern , Ophir Munk , Matan Azrad Date: Thu, 8 Feb 2018 06:55:54 +0000 Message-Id: <1518072954-19082-1-git-send-email-ophirmu@mellanox.com> X-Mailer: git-send-email 1.8.3.1 MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [37.142.13.130] X-ClientProxiedBy: AM0PR0102CA0052.eurprd01.prod.exchangelabs.com (2603:10a6:208::29) To VI1PR0502MB3885.eurprd05.prod.outlook.com (2603:10a6:803:c::10) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 361db5db-20d2-45e1-796b-08d56ec10831 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(4534165)(4627221)(201703031133081)(201702281549075)(5600026)(4604075)(2017052603307)(7153060)(7193020); SRVR:VI1PR0502MB3885; X-Microsoft-Exchange-Diagnostics: 1; VI1PR0502MB3885; 3:sh5fK4PzcAAfHltxrrh7YoMS8Fp+cRfbqD/5AhvQuBON5hRRj0wxh4+iObtuieXPw6VcV6/b8A73nfXRmWVVPxZo06oD5Bytpq1ZhxNOgydP5pyFv/SdBczCRRuF3MlM8DX4q+Uf899FHeztqCo3pjgHEIGP53OBofyxRl1g6aSBqTFIbd9T1W/iJVFD8QMy39jiwbWfBFmK7coitlvZx11ziY6+oGMs1Ys0UwgmNd1wiZMAh87wBS2xHaBU08dP; 25:KV43nqR+jOxzPCBw3C1fV90+NhVovftXK9NOQ6532kUTWOg5I5oguk1AAV5t1TGhs7C848OcNzjZg53LRzfyzkurRzAKfmuz1sk6534Avq6nGRqAqu7mw//rvek4nNBj19KLrckFRstsjRLysAyrlbkwhOrsCYxMO+/uYnC4qQgn4meBOGBT/FNvw9HpEtc69J5Fzyk/RKck3MZzS0qsELmbJcANYAnOhZaPQf6UHZGcJyQP44ucwMYCzLIF6SGllkE9X7wu85J9n32NKws7Q47131EDiM72XOGAJJSdqTU1NhMNUyL1951zbYDHCWcZ1TZwKWqylZ5zyMCfC5rVnA==; 31:YJdjHvtAyWcChEfWSUOYzj4bp3PJTCvhR8Pqjj2T7FhyKnPq3KIoOmyOihHw7LaWWn2LF0ik1IQkIDUEWUMsJfYFFVmIOcRG0WUxGkIR7ZP+RVEGcd/FMlshzLV3uRLs24X9ArTflIGxvR/Skm5h08SYKCP+CwR5y1/vqQmSt+KVVvQMAFSaCBppRgcuQrQgWCIkSgLp5ahMO9gsdy6rgxJK0Rhr7gVge9Z+HgiSrmw= X-MS-TrafficTypeDiagnostic: VI1PR0502MB3885: X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; VI1PR0502MB3885; 20:9EmhJCAOjBCeugYN2fSRlJW4h6fVbBwjEWr8XPcTf454dyL1/C4rZqVPzu3PomrNwS2qkhuoyFy2AkLciynkXUk3Wrq6+kSZ5ATDMydPuif+kUuI8whEPzZxxgNX3m+j0I8ht3ANkVRVRsE8GqqCv0X7DKIgFFcsNjP8PKNOB3xLv4r8Ki3VkaA0kwrcINQl0RzgtBIFbehWK6ktIw5d5yxctCER0gQWbixvqftoGIeuLyNxdpyQXUlXi85WjVU8pG0/V7JFkXM/pTigXMdLhw/fCBgrTdQGzP1H/azULIEloTjrKxdD5VLz0mkQZSNO3CcCzF1jNzZWG900b6NBT4a/ldq8Ofwb/zKMuOK01648bzqRcjugmwN+xpf/18K32qyrnWMDe6ikPPaVKs8HfG/9uWrNSNi2Px/netckh2gHK/Hp0yzsvnNwOBYQ3w10MiP1uL+rATqyC7pyI4006HDZaSSjccLztQBqNkpjPdSR8FSc6Vp6+07Mu9phnzyS; 4:TerlRSZGM0bY90bGNFzOuvYP3xE2iI6SEDq4XqpjsSr9YO4YCvi/Cd0ttnpk08CCHC6o+BB45hEnFL6L33HzdRHxeVMSqZkfC0tQ0FMlf9Q+6SmAi7HPZlqnX9IJlTgNePbdg6ulKrsnWl39NGaDL8ajZbaKlo/01g7zGbMD6uVO4BmQAa9xPL8s/P4Y6MKbokJkOGCWio75oJ8MTHLc3KwUbBTcHhYHFceMgMnD2EvFze7J3yUKH//4WENLH9ckw4ar2Fp2OJ3dx8rscG0Aaw== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040501)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93001095)(3231101)(2400082)(944501161)(6055026)(6041288)(20161123558120)(20161123562045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123564045)(6072148)(201708071742011); SRVR:VI1PR0502MB3885; BCL:0; PCL:0; RULEID:; SRVR:VI1PR0502MB3885; X-Forefront-PRVS: 0577AD41D6 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(396003)(376002)(346002)(39380400002)(39860400002)(366004)(199004)(189003)(26005)(16586007)(66066001)(2906002)(386003)(50466002)(54906003)(110136005)(107886003)(86362001)(51416003)(47776003)(36756003)(7696005)(52116002)(316002)(186003)(50226002)(48376002)(3846002)(6116002)(16526019)(105586002)(21086003)(7736002)(33026002)(106356001)(305945005)(478600001)(69596002)(81156014)(81166006)(8676002)(68736007)(5660300001)(97736004)(4326008)(6666003)(8936002)(6636002)(4720700003)(15650500001)(55016002)(53936002)(25786009); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR0502MB3885; H:mellanox.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en; Received-SPF: None (protection.outlook.com: mellanox.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; VI1PR0502MB3885; 23:sCbNkBYMUtz9DlPWbgwdo8uqKH5e+U733ZHxTI5?= =?us-ascii?Q?ZvubqVfZHAMOzDouV/7xgHhr3nQjh8oUf/0E9GqUiEKYn3NNcHyQitXxf3YC?= =?us-ascii?Q?BL9v7EjEWncDL5QpGZspmQwyTDglAKmW25T8G1s6xTAZ4mFAPc/JEigitHKP?= =?us-ascii?Q?yjssIigdDKLqZNZUWlwuFNTjBKkwpVTvfDTCGycIpb5yp1HZOrvjt3hImR8y?= =?us-ascii?Q?B+TXvJ9B8AUA6SPzXGPMFy1sHeU6J9m2V1gBdsPHLNQ2yi0ImKbbjDDkfKBz?= =?us-ascii?Q?LDOUmLqlxu+kGVujcu39YdG7yw0P+ub8C7LDucLH9J6G11E4HFpn23fqaMJg?= =?us-ascii?Q?8EPzCp/G+8+42oyKhxoHymrDogLcU7ujWR1YptrEIHQxVci865Al3XIE4w2K?= =?us-ascii?Q?9veFN5exhSsEDvbd5lCY+szdqZrP/dJJusYWdNf/K2PgiuAuKgyJkZjI8YNF?= =?us-ascii?Q?y7267J0/0lir/mEN/H1HG59kZ3lX5Ylm3EJAFwLJTO1HwQWtYaqwNGBiB1Ap?= =?us-ascii?Q?igCPzso06BMEjmTMP+xK66AhoV808dKbo+4FNVGRWZzfUdlldsJHtMIlr53N?= =?us-ascii?Q?k3NgMaS3H7U5lJXkh+NFv3JUd0FvBH4s4QecAtJvZ16T9nRU6W2hLbVzE08l?= =?us-ascii?Q?YmDd74ZLBGhrMvKrneSPyLGnT9LEeX6W6er1wHB/mrZ/uhCQOzlGLyFxWFzS?= =?us-ascii?Q?PkHiFDAKmYUuatUuto4lz0B+n4Dm+VTO2tBEYAdvrWt3VW4q1qh6j3Bnn6lb?= =?us-ascii?Q?YSggPtzkBWwaxUYFCnD3Sl6sFUS4bNCkxfIFAtw1z2W9OJM9nRQpYriZAdZ8?= =?us-ascii?Q?Lm0w0+1QnCRwd0bjapsH0lthkCyAV61wgT67LKLQ8c9VohZe80NXrnPncJu/?= =?us-ascii?Q?a3GahXiuF+zhRu3p4cmuAILBqMQv2YItN83qyCSPz8pIb8+AmNcRqJ1Edpw8?= =?us-ascii?Q?tA9DpTrKl7QhSmiOTuKy0+q+9TQ1skSFE5fRcvOyfZk8sCVSUeK7/d0b3CV3?= =?us-ascii?Q?toRuBCR8o+FlW2Hwv382wUbuIbGP+eIzPUZHz+VpZerdLfxQuDfmpcU29xNx?= =?us-ascii?Q?0el2Z2uK7eNKnUJtHbKiHOvoWGGIllsbhdUdQxxOMT9H5FLNPHEgShgGyuIw?= =?us-ascii?Q?B0ooTOuORvQjm99pDz4G4oqGaNv5PeIbLnBwYZjFpFYjg5cxHf1wxB9FMTuL?= =?us-ascii?Q?HPQIzjeJVy0sW7Y0N5XdmECkwaWaLJeCcY3pb8FQdsfZLjHoTxVx59KI5Rg?= =?us-ascii?Q?=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; VI1PR0502MB3885; 6:SCp+XimrwM1hhOCRlT+WtZqIK9ksheSqbonolAl+XGXV8e22n56Q0oKmdQLbDdqZp2pgDba3FcS1BmRaMHpCHcxTYBHZ7TJPve7/QivRW1AYFCjHwwVU5s+FudWCEnuQ5tHKtQdcDLgalkmPdDsEa3WWl4COFr7kmyzktRcqbZ5Gm2gfN1I7kVVM5/fkIw6LFFRXZbBJ/S2UG9Lb6VY0XSZvxzWRUz17M9cEbTGCXSZwd3tjPVDZW+uv9wPDySObQJEfisZ6zotw2Pgu1nxjPxR2XNQ0sy/G/KiSO+h1lhmgm5D1zs1gMrAJZNfqft4qJhrTpll9vwi54RLKBtfFj3eTWjyu7u/E3SpuDDYxQG8=; 5:RMA9SqME13gWZtaP0xjlJi3zyamC/VGZVjx3TIXCIHSZEnjQFOoIitlHthONJcixZtPkDeCmrTXEUNPuzikOY0M2P5TKAzUdG4OnQx5Bw9dnnzol1Wdv8ru3fmQL2sC7A6Z2zoQrZfrKiRvaJYb4DEkZzakFHt5gN5A5W9S12Kk=; 24:no/SAo7pq0B0pHpp1XoC7aPYXKrueDPx55BmsEfYQWQLX8nN3lR/4qnm+aalQDcs3SgceLVEmBYmuaaIUMhq8CXqWXRaMXjdJRSV0qCXmX0=; 7:DbUrwDmTOwBnqtk/pqllt9KtMuHcvVoMjUxkHp52twXbjL2lK78xRMDGt4wIgTkscOyPZ/uKvvUQJl9QeUZBb9b/xbkZBphzfaBg5seqBqyooxLA+RxegkzdpqMlXpu2NYRP4jm/CALK6t6ybv8NAKIhpstN7eysdEooY+tS6MA6BHjzHZweXAb+xZTE4TQq72g3GFydxIBBzxV5NF4QKeG6Y+y0pByad+5zk8JYwvAqsPCbB7ZGio+XTyKeIUxl SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Feb 2018 06:56:07.6434 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 361db5db-20d2-45e1-796b-08d56ec10831 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0502MB3885 Subject: [dpdk-dev] [PATCH v1] doc: update mlx4 flow limitations X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 08 Feb 2018 06:56:10 -0000 From: Moti Haimovsky This patch updates mlx4 documentation with flow configuration limitations imposed by NIC hardware and PMD implementation Signed-off-by: Ophir Munk --- doc/guides/nics/mlx4.rst | 77 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/doc/guides/nics/mlx4.rst b/doc/guides/nics/mlx4.rst index 98b9716..b81a875 100644 --- a/doc/guides/nics/mlx4.rst +++ b/doc/guides/nics/mlx4.rst @@ -515,3 +515,80 @@ devices managed by librte_pmd_mlx4. Port 3 Link Up - speed 40000 Mbps - full-duplex Done testpmd> + +Limitations +----------- + +Flow rules +~~~~~~~~~~ + +L2 (eth) +^^^^^^^^ + +- Can only use real destination MAC +- Source MAC is not taken into consideration + + For example using testpmd command - src mask must be 00:00:00:00:00:00 + otherwise the following command will fail + +.. code-block:: console + + testpmd> flow create 1 ingress pattern eth + src spec 00:16:3e:2b:e6:47 src mask FF:FF:FF:FF:FF:FF + / end actions drop / end + +- Supports only full MASK + + For example the following testpmd command will fail + +.. code-block:: console + + testpmd> flow create 1 ingress pattern eth + src spec 00:16:3e:2b:e6:47 + dst spec 4A:11:6C:FA:60:D0 dst mask FF:00:FF:FF:FF:00 + / end actions drop / end + + +- When configured to run in promiscuous or all-multicast modes does + not support additional rules +- Does not support the explicit exclusion of all multicast traffic +- Does not support partial VLAN TCI VID matching + +L3 (ipv4) +^^^^^^^^^ + +- Supports only 0 or full mask. Prerequisites: Need to have eth dst spec + +L4 (tcp/udp) +^^^^^^^^^^^^ + +- Supports only full mask + + For example the following testpmd command will fail + +.. code-block:: console + + testpmd> flow create 0 ingress pattern eth + src spec e4:1d:2d:2d:8d:22 + dst spec 00:15:5D:10:8D:00 dst mask FF:FF:FF:FF:FF:FF + / ipv4 src spec 144.144.92.0 src prefix 16 + / end actions drop / end + + Prerequisites: Need to have eth dst spec and IPv4 before it with all + its limitations + +Flow actions +~~~~~~~~~~~~ + +RSS +^^^ + +RSS is performed on packets to spread them among several queues based on hash +function calculation and according to provided parameters. + +- RSS hash is calculated on fixed packet fields including: L3 source and + destination addresses (ipv4 or ipv6) and L4 source and destination addresses + (upd or tcp ports) +- Uses default constant RSS key +- Only power of two number of queues is supported +- Every Rx queue can be specified only once in RSS action -- 2.7.4