From patchwork Fri Mar 10 23:13:34 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yongseok Koh X-Patchwork-Id: 21699 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 17958C254; Sat, 11 Mar 2017 00:14:33 +0100 (CET) Received: from EUR02-HE1-obe.outbound.protection.outlook.com (mail-eopbgr10046.outbound.protection.outlook.com [40.107.1.46]) by dpdk.org (Postfix) with ESMTP id 0D27C5A8D for ; Sat, 11 Mar 2017 00:13:58 +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=3wzWewUsxTVtV58PNolflgqwKQeO0hpYeq2otyWcpGs=; b=IAESqSzReVL73TNDFa2Ky/WdfOVZlnhutYjSXI3TC6aMPh1nuUHCpCu3+XDgZ0CfCm82pcElLGun9mkERe5+BbYiRlBKMoLBow1owtvjPt1r/anNWCTmUdfgYqsKrLimKlBa4mEX+SHBc+u8UC/Q/srDi0CF87rduU+pwXsvXGU= 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 HE1PR0501MB2460.eurprd05.prod.outlook.com (10.168.126.16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.947.12; Fri, 10 Mar 2017 23:13:55 +0000 From: Yongseok Koh To: CC: , , , Yongseok Koh Date: Fri, 10 Mar 2017 15:13:34 -0800 Message-ID: <20170310231334.2457-3-yskoh@mellanox.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20170310231334.2457-1-yskoh@mellanox.com> References: <20170310231334.2457-1-yskoh@mellanox.com> MIME-Version: 1.0 X-Originating-IP: [12.250.235.110] X-ClientProxiedBy: MWHPR1201CA0011.namprd12.prod.outlook.com (10.174.253.21) To HE1PR0501MB2460.eurprd05.prod.outlook.com (10.168.126.16) X-MS-Office365-Filtering-Correlation-Id: 48acd71c-8b0d-455e-2a4d-08d4680b20dc X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081); SRVR:HE1PR0501MB2460; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2460; 3:DT8iP5EpwRA7Zuz2uhfTMcaQ3XkHvwvv8VDfus3xJ3bxjyXhDd2f8nX9rNnfgjHqkX7JqQs61DuQ2mVuVKNfzVgZMYCeDYEueZGtp6oUqItVQYHXR+82ASfSFw0B9feOKKWedgvkv5jII2Vkm08dgs4HsOv/uSzUauPUNRtbLETSv847zdPWPzVM3YumYn/gVbAD+cfwQg/pEnFWAfhxMhBSQRzxOosvAUYsoUE0PkFDAPQOrqCWefoiC7dwFahyaDsoi7x0ogPhvirsXTaluaKLhtUPOoDnJLW0/Yi8NuM=; 25:L7SHkGv63SNIGxmsk5kxaxB3vMQSS+H2rk5pZi2ETH0aepB3uezcKfAnzKYEy9698BTj50Gh5Hh1DIE9So/o31otvID29cJv0QNrDTrrG3GWYutGsRi3nOSdjfBv2pcO4ehUee+GL7YZkN+cxdGhUKAmhVr0I8RdZmBvPnmUR5U94WBFKnzu/8/lUuTbQRBuGMGtrCQib1+kKG52EEGA/3L53/w1sKB+Sy+3BT3S4AdDcv9yKOaGUowRajRH3hXLHjjZiSNt+eOuYd+sFt5DVFvg++6CqNWcHgP+Xib9wN9PIoIhDoF+xchNm4Wj37fQTk8hMj7tDq96FtjPPRZdA8qO7rcYjJM+m22Cf5ixPV9GSjKTJcRfBqveculMwxnBu+auWksa5NVvdZvb45nFoC+aXU/Jy9fU+IS1rg3DPpBLrZ2yq+xQJ3XYKoFkcEHhc1x7XD029BAZsJX+s0eHUA== X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2460; 31:Ap2VKV9LuyA9+G+25rnKbdSoVvqn7XG4MG68CQyVp1y6uPCxi4HHyoZeSrpUdKO58Zsd+HRN226Q86v0b3vF9wmGH35cQgBhTNXM2VP+p69ptYrxKfAN7W7cXwbM0wUF1tGKUzcRsHS9df2kVKqG6TB2d7c0TlLl5M/1Df1dgBMv8eHUTFm4RFf47itKVBOslS/HXBHRLzSlO85BKPqjEuBCPyBx86uOfS2H+ghCDcWZLyRQmTagwrGLIfvpFWI4; 20:OHmdZW6/1jfbqMPvaJkOyH1UQbJLyRTQ6dQtM4TamPo9eE2tmZitqVx8YvC9iUNhG3OumXkyt2N5zMaKq/NXyJ7VUdS8DN/uhy/GF/ekgEihWjfTlpSeUpqBlJ+beStGNjLqpD2Dz3C7fmh8wxQukFFwuJ8eW52tediFpTGOd6xlU5E0h5JkuuB1v55+3kizzD92Xdj9+K+ClP2yxxGeMjVR0yyGoTMEqu4ceYfOf7xg6wZm2DDIctrxhiPp8NDffN+inVdAU7YlvszKpMzljzJBEvUpIiRqJ1A1Ap+SiBlzPmgdn9OJiAtmebsBz3V/Pp9Lp0yuRB35DkRDvFF9l7tS+R0WSKryjpSFm77t7z4MExCZRMPQuLyVkfvKfbRZXP14uiIf/z9zp3StDHGpFT+yv3hzLhkPKEYqK+wy7ZwHYzg0DpUac3TqGFPnSg5h1ob2zqOc1gV5OMIT8XKEPdzqrfThYwXVpuruepSLSD7KpIB8X9NUU/anOcL5Ae7q 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)(10201501046)(3002001)(6055026)(6041248)(20161123555025)(20161123560025)(20161123564025)(20161123558025)(20161123562025)(6072148); SRVR:HE1PR0501MB2460; BCL:0; PCL:0; RULEID:; SRVR:HE1PR0501MB2460; X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2460; 4:ksGJZNc6JJa50BGRTamOk9YvTtdxj8JR2TRMSyjjxX21W+V4AhWdluOs4DumlCtJZ88Kh8HnN9cbFM/evM7nBW6pSiKIPdAvusr6TZkLkYwPEI+7djCBPaGs2IiapS3G8umHfpWPfBbFMSr0ExE2CV1vaMP/1YyK3t+59KY4vh+ypkXd2xR8c2e2JzG7qzCguO+aoqnQn0HBf1jSgGEQo6/mhrP7JvjtuP97R/hd31sgzHKbY3tr5yK4ETTCG5OV10GxdIxbohY6MDZu4oCZ98FFVRzU9WOgV4DsJnBpZxsP9JCgYr5jdJCmobc98xTpfKj5v8mdaNQqLNMBod26TEdxbHa8Z2x+5TnecBRDwuJ7zho2c60iDS5vuZlxviDB5Eb8aK4aUBg5PHeaGT2osShwZeBbVW59abeehB8U/pfLgt8x591UMYZCLMO41aabwePv/2G0UoFYHDG8IlpPK227BHH0YPrV5bSyi6twKpVq22qQTw1AQS1xDX0sDJux8GGuedD5sV5jF2s96GhxtArk0cSsqMZtP/mZn83pRHb716mG9ocoL3I9gMLZI2AqchxvQzlby/WVe55t7lo9gSwo8g71dcwULoz8Ug/q68N5E0RbDOYkTU5UCO6N0xJb X-Forefront-PRVS: 02426D11FE X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39450400003)(39840400002)(39860400002)(39850400002)(39410400002)(42186005)(76176999)(7736002)(305945005)(110136004)(66066001)(38730400002)(53936002)(50466002)(50226002)(48376002)(50986999)(81166006)(47776003)(8676002)(33646002)(2906002)(1076002)(5003940100001)(189998001)(25786008)(54906002)(33026002)(2351001)(36756003)(86362001)(6116002)(3846002)(55016002)(5660300001)(6666003)(6916009)(2950100002)(4326008); DIR:OUT; SFP:1101; SCL:1; SRVR:HE1PR0501MB2460; H:mellanox.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; HE1PR0501MB2460; 23:+C4RO7Kb4YCoS+v0WuxeSMLc45ZkbacSSTg886l?= gBI/60EP6XJqpIuB4m/SV1okoRyaihzpATy869eKB2O0mzEyHewnKgUuD+w0l/HE502ScMZa+PtTwbVkTmVIfMwkqoHr23kTJSj5W76nGYAIKvVx/POO2+fkNWdKNx0t/EnTrP3LLkbLGGnyaAiHqpd0alcNzG0kxs9hI3FpvpnW79p5iAX6P5cAnyB/aaTEUBSmMuVheeiLeDnn/iTFCNRY3RYdnKNd/MuO1uoOBm8kzfeJ9t8iLjLLeJTGoSJq2VyPIOUBjUvkFcmIBLen7HCSSKAHc/dS4pHnonjG+UIIj3ORI1FyTR9xNGAndh81BtSazqvIHV5Rd5MjKdwv6egcfRZVDHHhKzyAlL6Bb7ojWTUTrZ0XUohA8GeRB/CsQyJ7MWa2lVvmev+2Gx8o7RMgtpTaJpTC3EyW14RpIJXpBDtaMOJvuCy4r/afFf0JtwZSi+JTKNMkrxURcumvxEjnnnhr/w49L7S1m/YnHpzTkApx94odmWkRFum49gv3y1l8wXHeg9lR8dU+YYij0Cz96YIk4w35pOYYCOV0PPUJYHaZWx6DcHYWyD3rcgZftPuRsK+ypL82v0nxEwnUn93uA0VN91hmA2Wm8GjEU7FNFnw2KMe71H7rOulv+haJI23LHqhYCfu/u3qZOfoeiZG/guRgkf2oLS715cWYnLmNMCDWLiESteBqP2Xo3z+hRduqv7fzJKOrqRhc2GigwsBxU4ypCzclzlWZkH23rV0Iz/VRjrqVPfuEWowN8seNsBqfGcF94dZ4u/7jrWeGMFWF8PhW7DaF/0BXt23VAxBowSZ+Hsy/feowPLugaIGpZwMRhXLq5CsBcgBnUHzBjrFRuFxUu8AvZJG2DknbcPHd7iblJvR6Uh6qfYG3CUGr7Ty7yUqPJOB2DoxSGudHDt0Vgzi/geRAIy6CtiBDxh5W5g4UkjF4h1wkam0cZgl1py2ZTuBpPGKUej1x0j2qGNs0JFOrDwljwKaK7B8/nTV2Q5PTw2TNeRGQ6/+0Mzk1l0cA= X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2460; 6:wfdy2mdgdV20FakinA8oK1iuRGDzAI7le0voBYAbqQ04bkfg3wzao7siO0lIOdOAMjoYvLQE+AMnKvNyQvP3N9MtB268E9FkrCSLZfurLQUkzqsXXqUh0+ROGNVh9w3oXkACvvICZq1WwakTuNDTJTy0Qu1WdVT+gB/TtlVRHKAdz5BfxJm5hCzDlV3htWNxG8gHMDfqwShMPUKWIeeI/jum8R3V7FN1JBUribXDHKLPFye1DyymBd9+UIAHYWtUZbzDnmTbGv/yfwgB5pSykeBdFmqQoPjWiFz6SfI+p9bnQkayEAqy9PNSbKvYbmYLJeWVNZORR5xeh1DrjJCY9ctI/syvmn2TCRxUrED/VQ39XWBTotw2jhUsW7LOVB9TqxUAQYgKeUDAyYE4wjxljHX69/veHUZt/0ug6bnbLDo=; 5:AiLUCuMZZaN1FmHXIQwPAVNScxKvFzxGUIb9cb+chad+vVr0JEnetTa8rSP62fbGoA/rSSrxavnyB9YhnARkBAcU4DgmveP9dcdDZ0/saM1V6gbZ+C5uwrDA5PPmONmCq2RJO+e2sA/1D69cGL6Uz0DVH1DYBV9IhGYFDMLTG0o=; 24:1i2WtV0+TVSZHGI3Ioa6nKK4zQP7lZSuaS9tgdkV0FajTIeW5MzLNgmnfPeDDgppuclPGsWtNhP45B4TeSC8i91AUw2IV6vd6OcQXjucEpo= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; HE1PR0501MB2460; 7:3V6gYoCYmqbO4llvF0aFTaYk6ekEjOeNwTfKkw6TBdLsWibIf+XMyOpUcqPmtia/zANzolSAjFvKTpS0R9CSpqUr5Ax9czuryJ0pG8xKeAunfyMDlqqi45HhSfRpwbPYUEuy4RNUglZt/9NMMm+3qdjuKP6ScyWibx+masg0Yqj8OFDRtK7fjtZrx+RxhqD8/JJoJ3Bz/0Xt9q/9gYYkJKMAs8zZaNbiGugQ19xoCmD0OKQbTZZNhZmF7X4iJD7nPfvVoSij1ePXmmUTvZW3QnX6teYNq7JQPFH31n1xOgCdw+nvds1NSgh/QfzL4x20dvzAGOlNWcZ083MC0ugOTA== X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Mar 2017 23:13:55.6939 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR0501MB2460 Subject: [dpdk-dev] [PATCH v2 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 Acked-by: Shahaf Shuler --- doc/guides/nics/mlx5.rst | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 41f3a472e..0783aebdd 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -183,10 +183,17 @@ 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. This option cannot be used in conjunction with ``tso`` below. When ``tso`` is set, ``txq_mpw_en`` is disabled. @@ -194,6 +201,22 @@ Run-time configuration 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 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. + - ``tso`` parameter [int] A nonzero value enables hardware TSO.