From patchwork Wed Mar 1 05:02:25 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yongseok Koh X-Patchwork-Id: 20970 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id A30B1BD28; Wed, 1 Mar 2017 06:03:22 +0100 (CET) Received: from EUR01-DB5-obe.outbound.protection.outlook.com (mail-db5eur01on0050.outbound.protection.outlook.com [104.47.2.50]) by dpdk.org (Postfix) with ESMTP id E2899374F for ; Wed, 1 Mar 2017 06:02:45 +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=Z9pLGK01GPiisCDTsjY1fvaEGkRqazU6sRgsfIFzonE=; b=cyvV0N6OWozX5MwnZhN8AdnxraR8fYt9MdvPRdO6tr+LuiK0CwRVUbmGoLiTj9n5d/pxUfQKOfJ+T6YAxJ5xn2RsXIAKPKVaEj+tSq1j76Vaw8RrWlLiXQUcCtvfkeWFQXmYG/ubtBVBWcO8wAOmSU1Xl6aQHwXX7Zs48QNod8Q= Authentication-Results: intel.com; dkim=none (message not signed) header.d=none; intel.com; dmarc=none action=none header.from=mellanox.com; Received: from mellanox.com (12.250.235.110) by DB6PR0501MB2455.eurprd05.prod.outlook.com (10.168.73.136) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.933.12; Wed, 1 Mar 2017 05:02:43 +0000 From: Yongseok Koh To: CC: , , , Yongseok Koh Date: Tue, 28 Feb 2017 21:02:25 -0800 Message-ID: <20170301050225.27164-3-yskoh@mellanox.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20170301050225.27164-1-yskoh@mellanox.com> References: <20170301050225.27164-1-yskoh@mellanox.com> MIME-Version: 1.0 X-Originating-IP: [12.250.235.110] X-ClientProxiedBy: CY4PR06CA0042.namprd06.prod.outlook.com (10.173.44.28) To DB6PR0501MB2455.eurprd05.prod.outlook.com (10.168.73.136) X-MS-Office365-Filtering-Correlation-Id: a6999634-86ae-49f4-7a7d-08d4606032d6 X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081); SRVR:DB6PR0501MB2455; X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2455; 3:52vu6b3oxKCjhbWY281fu+LI/eIjOFb6TX4dYkGfNi/v1RzblH9+xxY97omqKCdze9Z2y1nwk9q9cuUGFLonhf0Hbrhw9QQFV8lH9x3uamzSSw4IqcGliDzvznv3V/Tkwj67viV4EVlojEljO8Vo85rqWedImX5BfiYc2CJqDnhallOwEZUECopGZ5f4ozbh8L8FMBqH+B/M/0776pEM1GlDuqpe5BuneKbi0jxRvZGioxUH3ffRWT+RyrVbkpQW3X3TxD+v/MO9qimKpeTgqr7Iv2PqIcSpJbtzNH9HE1E=; 25:y36PCf6I8XC+2nlNpv3q6VN89vOsYSjoeIiS9tKah5Y/OwwzgmTUuYXQvuKKwEX7gR1jk31ARGYpIizT9Ci4Ej6pL2c44xZ+Nk0jx8wePx02TK8TA3be71lqvnBT7GTFsrFM2MbT4D5oJ8lRX6ZAKjiXHRSpc7ZHeoKm31Bb6rQ5JWmayl9vuNsXHC7NGIIMmFLcNtd1VxKldkul4CTyDj/vutNaDKZy3B47tmN2ZiBXfC/QfUm1aBgTXBZ4lsOSMVXeaWnNS2gn/+DlrlSj6qwuF2pREeydIBKhqnsb5FJbpV7wSVU4jRZ/VHe6reFcl12gews6o4BHroDQWDdrKfk05nASCC2M71v8qxP6VYvhq3Cc9HtRXoM2Q7UyZei3no5/qcopVEFfXSnNuTFz6sW2k0A9PbbEjrOORbjl1RtESevV3R3OeoapJ04DnEtdeR7z++MdXnzA+y5CBxmKUQ== X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2455; 31:WcdaESgPz5BTgV01b7IsBNVLfp9ifqvwGMwPbaaTzMD0K719cJVqdBAyAnlksppAxjZtnrCF4TVvfzfOb9xV33YGoP9m1U6QCA4GGU2FUGEbpKh15KJj6KaoiNmswb7ULrB/ItEHBeq1FIXIGweCyPw3rKJvBhXdPUp2y8lRnRoLOixTiFgXD8ilOo7+Da/3Wk3GrDKr4iFtjyFeE5TrZ7xLzCr+C+h4MIc6NRz+HOI=; 20:NahANNzw3tMV2RYAodRqH4dhrO3uw6xzjNZtdkqXG16a5Q6/k1yGXc2HNWGZqd0wAClWsJlD4RuL6Hk++rwFLTEz1QbbC/jCfbR/QqGTYvoqUYv4uuI2m55jzXQ+siLo8GY2I8gnU7Wt+d80yh+xWgTQfebrYw6mL6AegN8WA0JSZ3mb9ecGfgg6AboDbaNO/HLMil23b2D6akkImO9ewPsHxQ2LywIZzMyKEYRVtYBtbpGf3P2o2BR1nMwhKmyDWp4Ly9wrQfY/Kd6W81dEZ6oRC7hf0lMOaoe7vnRFdyl/kZCsFPg2ZmoaUDYh5jQwDLlvuMwGoucAXCou9TsY2N9rCZdqa+SvN3HlRFUypDgDSCP5WlMs9attF50+/PJgqeTkXouksEccr1LC7NcYf2twaPlN91k+AVAcXR+BqVi9hJ9pnlafK4UNbeeo9SWiPbkVjczIvj8m2Gro7R1WvGO7C7RYtPxmS26QSwfNjXgKbi5wowz6a9GgzTk63u2G X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(8121501046)(5005006)(3002001)(10201501046)(6055026)(6041248)(20161123555025)(20161123558025)(20161123562025)(20161123560025)(20161123564025)(6072148); SRVR:DB6PR0501MB2455; BCL:0; PCL:0; RULEID:; SRVR:DB6PR0501MB2455; X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2455; 4:Ug02xOMc/2AZGW47WCI1poVcd4wi0XpKUdi+xeszjBj0E3YJVAbsc8Fmt0I8Cy0xt78V0F+l4wUBjXwg9OtZUvjjEo0dDJAC69faxGe0Yehqg4MGsQC7/ZXpQL2FWolJUMnw/lrlRytds6kAZ5jldIZWZ9vEQv8NjZLFS0Jnxxv+OhlaSY9dtUv6eUqjXdqV5VVdbb7DK+RaZeF1HNf03OPPIwKULGdYnOxoOskpxm+q6Gb2NGSfWKK/gh9a7tNjwg82FicDF/5/2i/k2It+dgrfgL3hCTIvtUS4w6kLt2mYK3jhyL1E7UD52DqqxM3yywyyoq8RWtnSTZFxqtABUJ2WTi4l6Iy/t5ZtSGhJdJkuNVW8k2MBEPcUHEZ4gHC/+9swTYNxGrkd1OROW0ZhZLcpoiUXrGP1lvCwx3G/1IP/2XORAIdfcCSD6GQ2X0f4xrrarCXBMEPbM0hhcjnyNW+mb28FMDvYsbRZ+1tVPRDKXBE/vottsYWHn7qQAXT2AKglOs72sq3gO0R22lIU3zJ5ChXMPxgClKEqdrTefY0M8idnF6klXChVhIBIn/Ob2DYft/2o9Pwu8hZO9KvK6M7z05QJ9/Sna15TK5RGDWLdSg/uk7C6LqQWpiTLOBeR X-Forefront-PRVS: 0233768B38 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(7916002)(39450400003)(39860400002)(39840400002)(39850400002)(39410400002)(92566002)(50226002)(81166006)(66066001)(8676002)(47776003)(1076002)(42186005)(53936002)(5660300001)(2906002)(2351001)(5003940100001)(33646002)(107886003)(38730400002)(6916009)(2950100002)(110136004)(7736002)(189998001)(305945005)(3846002)(50986999)(6116002)(54906002)(36756003)(76176999)(86362001)(55016002)(50466002)(4326008)(33026002)(25786008)(6666003)(48376002); DIR:OUT; SFP:1101; SCL:1; SRVR:DB6PR0501MB2455; H:mellanox.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DB6PR0501MB2455; 23:q0qM/qc816Pm9LcnZNpB/AZQozrv06FXK0dwvq0?= IjmuhK8/pKoIJ98YVFT5QN+21g38hFSDGaXWVS/GoIhT4WzG5bbFUwTYW8SjzFYyz46w6aRcM+0ZruPCiuXC9qJlzDSUBKFV0V6m8JxbRe6p3jk7MwANE8nCke+UGbK6bXvjSwRJ1UbOUhVRrJ5EHXd6rI8awdjrL0WHX+Yde9ufsRyadRxLvmbex8+gQXcYGTmGNY9jL9L25Ug6x9bTVpthHLPlZKDh1cb/urY3sGpJl0sw6z1TzdieLd8XInffj5UcV323WITnEiPpOYinEquPz7zc40kVpAZS68Rzt4NL25wGkxqeul+bu05TF+cQj1R4ty9DrB6gfH+qg9vus/Vbv78UlvXZaEXF2ThzzaqBIGySfn92QLgYQK346sGOcS75TsGGFgQALgduwqDrzsYV1qzQ5DA+FxAKbwHAjxUjAq71+84ukcoPtMr0dEC4lFXwDiZv73rjjlrYhReH2ahAwErUQVHfeMHFAu2tuGoeAHmXF+hAUuIR+DZNRPYi0RENJiiTpdRvn4v/bIjU6AToHdLtHY+XFnAYg2MGpAG8iCJHDpU8lHnLga6vlf1wYDb+hxdz6ZWwAPdDlgwdUh2ZYwvxW2nNpgfAq6cAc8jkx8Ffux6/X+VeD3/NB0C23/ekQ2IMGDvWUXjW+Fe2XRqc5vAW5twRwO0XMhU0QEOclcGVYD1kSygXTxrSybjqapaAnC1yArEU7UNuMibbYWnueuHdPuitC/Q0g+hWmwP+Iwjl2VwDCoJ0s6d+jT2l4Z9Ewa9ph6+5JaHDA2w/EtF2iNS2KMfUYeF0r+ecKtvpZhNdw3lmUtvDVPxCkQ2F0eFgblwVh+eE0QIksZaYrOu4tlFKiAoalFZVFXnq9IW4HIlPi8rGQHnp9OSMue8s2La2Nfr50QcXIdZTQqUzaO8FLFdZn+QIMLgIfWfvfiVI63nLpyDUnmmIxm1a6bBEN8QJ4qtVtpRBRqcDgreZtLD0Iu508uXxFCz1PSw3mnxi2De4nwLDqxCTR4tDBYK69RKxB8FVfZZ3eb7FXS93WUFUHpXryl07/DNCYYG3t8WYdCVg42ISSzOiuHsNrzvKaQ5w= X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2455; 6:rg3Xb58T4aNCylHqeP0DSF202PDoY+Ep4WkoC4v6iihIRTjZs4VJMYis93xSP5Jp/GKbj62fTUNyIIM5e7MszyXfN+Rv8bPbNdtE57ZLG4wVGBsiP/QUndKWgF841WwzujqevqaDUNua+FoEKzRLw+s/sUZnPq9aV3vHincjrxTDOSZ3Dr0F0uQ/dfV4WiX8awd7sCJCe9Zft4ja6ytvdpgspsb2mY/Zdf//dU1QceJ7ADm1173wqrW9+KN39io53DBhcjldrfgrJzEb5INQnCILVEMFEiO2mfsxARmJs6W2WH4kJ7jT5nxeJaJX15FNNSVGpPahlAlnuA8i/DVY1YEMjGIjSVIAVdwwjUdZj7txjQk8pSbyoddHZEq5m+MKi4sBKefikoTj1QyiqJ91Av8+CWQy+1fld99p563KMmo=; 5:QVVdmEoHg73psjgpUTBxMsbxmDrzbXDdiTwc5fKicisZBJcVjV1Ci0i05r5G2SV0bgAxYpVW7ECi0L/NeIe04P7mPELGtrIKeW/8xeipD3kkvUWWWhmblu4i8zFnx6Bcn3PHwanyUpewy/VbqUCPfQ==; 24:UHPPxGrqfRLwFYsh1tAmkbJHfXKDsGOn+IYyqjnDEikqhHYHLc0uQT83c8bWExZa6WDlradf0dHmjZiWN5jFBgcjNorrWvxiAKHM4r2TnyE= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2455; 7:uYYwGb4DSmEpNYAa+/VsWrkxttjRADQA/RgTJvJy7qZ+9/6qZeupPVpq+JXANdHg4cNKkyzTDfRezd8WwqSJ6yY4DjUPxc9y3eiPVak+6A2Tc+HCbpNfwhfOEkpT/p1QnSY6pUNkqgpGjU26e3ZyxGaAbbgGW5QOI57vf/GywM8fHaPdQv0isjvRTGXh0CUHBZJFzho19csKAgabH8E8k7TOwR5eU5FZE72l0jMcggQ3apgaqzBi/ZdzSJmBlusDfgEohR2GFhukvF6SLJzkjOoI0Ydw1N6Pt03xU2WK4x/n4+hPtLS0NeAZTKSv6RutgCeSo1W7/Tm6G3fl66Rrsw== X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Mar 2017 05:02:43.7126 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0501MB2455 Subject: [dpdk-dev] [PATCH 2/2] doc: update PMD options for mlx5 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Enhanced multi-packet send mode is newly introduced for ConnectX-5 families of adaptors. Signed-off-by: Yongseok Koh --- doc/guides/nics/mlx5.rst | 32 ++++++++++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 09922a08f..fda8bc3fe 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -181,14 +181,38 @@ Run-time configuration - ``txq_mpw_en`` parameter [int] - A nonzero value enables multi-packet send. This feature allows the TX - burst function to pack up to five packets in two descriptors in order to - save PCI bandwidth and improve performance at the cost of a slightly - higher CPU usage. + A nonzero value enables multi-packet send (MPS) for ConnectX-4 Lx and + enhanced multi-packet send (Enhanced MPS) for ConnectX-5. MPS allows the + TX burst function to pack up multiple packets in a single descriptor + session in order to save PCI bandwidth and improve performance at the + cost of a slightly higher CPU usage. When ``txq_inline`` is set along + with ``txq_mpw_en``, TX burst function tries to copy entire packet data + on to TX descriptor instead of including pointer of packet only if there + is enough room remained in the descriptor. ``txq_inline`` sets + per-descriptor space for either pointers or inlined packets. In addition, + Enhanced MPS supports hybrid mode - mixing inlined packets and pointers + in the same descriptor. It is currently only supported on the ConnectX-4 Lx and ConnectX-5 families of adapters. Enabled by default. +- ``txq_mpw_hdr_dseg_en`` parameter [int] + + A nonzero value enables including two pointers in the unused space in the + first block of TX descriptor. This can be used to lessen CPU load for + memory copy. + + Effective only when Enhanced MPS is supported. Disabled by default. + +- ``txq_max_inline_len`` parameter [int] + + Maximum size of packet to be inlined. This limits the size of packet to + be inlined. If the size of a packet is larger than configured value, the + packet isn't inlined even though there's enough space remained in the + descriptor. Instead, the packet is included with pointer. + + Effective only when Enhanced MPS is supported. The default value is 256. + Prerequisites -------------