From patchwork Wed Mar 15 23:55:45 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yongseok Koh X-Patchwork-Id: 21815 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 D3A7F69D4; Thu, 16 Mar 2017 00:56:50 +0100 (CET) Received: from EUR01-HE1-obe.outbound.protection.outlook.com (mail-he1eur01on0040.outbound.protection.outlook.com [104.47.0.40]) by dpdk.org (Postfix) with ESMTP id 9B88D2C28 for ; Thu, 16 Mar 2017 00:56:04 +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=SUJtd4iZzFVojobE3Ulg/LjYK1FcUcaW0gTFLQ4o1Dpv1xzQcsXbvpIowVUumEjPiS4m5i89YLXiDQxCy+4IrtJfZdKNArfWYq10SCCmtpKDiYPKYsLuwEQyPHENzb3yY+i50EpimZPvWRDvPyahsKs/Cnxz3qIYijfiq5+31yk= 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 DB6PR0501MB2456.eurprd05.prod.outlook.com (10.168.73.137) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.961.17; Wed, 15 Mar 2017 23:56:02 +0000 From: Yongseok Koh To: CC: , , , Yongseok Koh Date: Wed, 15 Mar 2017 16:55:45 -0700 Message-ID: <9a4aa753e1f3f36dc4d3662e9ed6ae5307c3ceac.1489621439.git.yskoh@mellanox.com> X-Mailer: git-send-email 2.11.0 In-Reply-To: References: <20170310231334.2457-1-yskoh@mellanox.com> MIME-Version: 1.0 X-Originating-IP: [12.250.235.110] X-ClientProxiedBy: MWHPR10CA0055.namprd10.prod.outlook.com (10.169.238.17) To DB6PR0501MB2456.eurprd05.prod.outlook.com (10.168.73.137) X-MS-Office365-Filtering-Correlation-Id: 2021b25a-ff4b-4ceb-8c58-08d46bfed6ea X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401081); SRVR:DB6PR0501MB2456; X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2456; 3:9ViWo/yI33cKqW9Pd5tQLfqK0W576zrSDYBD/dzKyAYFI/TYFr8JZG5SpLBlIXmzRDPCWzMiHJ8fq5dHHOQtYuFWNtAHSGvBQ/atVuJUa/YgMXQ58HLcx88oGpWMfzRcKABYVv8A0I6VMXBbeN5L9Nz6/hYP6R/sNtbVHk7b0o1+u+suktabXg9Ns+TDmJifZHG/fOxnMfZ0D8F23bXNnKNZKdXTC1Ml7rlGPJuLU/EgGkMShHZjjpwjr0FN0Pv+iKIR2hvCw8x4MjANjXlRTZjgUVtuHIS4SIeOUCSZkGo=; 25:bibUEPwTL1dFMxgB32/p6IFdNzIQxjUv4KlYsN0wFQwTyB/1XFTKN1kPLkYn0VTVhmftVmn/YWrhuF+CXBsHoBJBnlqms9x58Xsj5R+a4F6wq7hP96OvvIuCQos37+eWQI0qNHAV10y+P7PsTzxImKW23B9YjwPwxsONxVmoelPNzM7kvV0d6fgnX3iMCenyLQtGaGJenzkH8SuFk3XnX/PjMD7pVpIiLj50NuZREt4DKj8XphSEwVmXN3Ahn2oSEplifvXUOsEobh3xDGywbhaX2SZRjmAo0vri6lCJiKEQaPI4k7roaARqag9/xDVXbn+6MrIUvXzPP2X7BC9RGAsudGAk9QODZtNjcfy/ZRoyWDmfzilwcEK4RO/JgQJtWx3Wuwql4EAPYRsTyirOHJihNr6n6IGLiqW008GQW2jzu3zTI6KLMYiFFOuZCLZIMN5jOWtt+sgyFOU0WCXGeQ== X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2456; 31:y1msPodmeQmxeA5aDSyC191OYrQTnw34ry4hx1h4kNBEsnD2sYcdYuV2238n0rW5ndX7guJ9WIOMERxq2je9UFfkkpBaEjJToTWuk1Mg59QlzbgSZ7oSxjO9bd4Txo7fiprdQNBgvmqJEbGWzQbvVAPmpNKYnd7YM4BN3PGhocCJ0yeRc1ZVVsGwEeS3FXh3uyeLU8k3RbMgI9wedrLTfmtPOZ3oOdRA7D9JdW+YbTRe1+QZg5d6cJejXmzBHEjf; 20:Xvhp4UvYqi2GNDsRsyr7nvA7+qIyfaRxEGw7XCogl7/8Mc8EzKL/n9aMPTZ4DBQJdWIJDJI6Ch99hQRnRJ0gnhoJkFEdGjsit7zfSOI95K06uH7JzjirzryPRmS489v+fwJaQs1tklJg29TA9G74y8EtuByIlh2bW5x53O0YeDROeUYT2SFe1OqsIkiHXupe+x3i+h4+V2qdWqC8b2Nrin+gkM8YGOfGO6elkRWXhFRtJ7AkK55hTROHY3mtOjHwpr8Aa/VYIj3eUCt2oEIppv4k4ZBA/E1GdNUexYRWmZch8QA+aM9CFSeB2yEq/9Me9iWfimeS4am3k0mjsg4XuVPwYUnv6leIIY72SAhLQAycclc76Opcp475wCzfrnTfiDW7AvF4vYW9Z1Z3niO1P4Of3Pl5GafrdZV5HL3/R/HG143TIKCTEoGxMKyCEIu2R90xJnHVYPz0WJ/KIwB2fVvY+1iL1CvteU9V6e+bZnp3/PbkmolRC3lxtzkuqjuY 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)(20161123560025)(20161123564025)(20161123555025)(20161123562025)(20161123558025)(6072148); SRVR:DB6PR0501MB2456; BCL:0; PCL:0; RULEID:; SRVR:DB6PR0501MB2456; X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2456; 4:bZ906BYpH3Spj9U/WxdqJuZNoQn3CoXm6e7ZDNFNLmqsbPzqPxcxBiTpfdwDXRv3HtPdhaa9TAtZYiZDzWdnz3ARKefWaWzSBmCC0g1vbylUw5bwMiuMlSquDmVvJPU1X1MCR9QQHvFH2oBv8pljrbkDGk+03j9lI+U8kJMqkBt/sWmutznmO/M1lX/ySW/u41GCVcZDo3a1ERJvLlfvAmep6OTxRb1c+VIQpdkZSHtaA4BK+eBzx2YjHMJPUuHAbkm+8T1QADZ9cplYWOjGw/D7d2QoJ0dSslgtGvK6+oCQSu8G09poTQnK+X3o5OM5MVTZ3QEmev2d8ZAzp1NMKgJNGFlv/OflQ9q8vg4lYIt1o72g1RWdTfwZWbRkGJBR7OxiaAuX2uruF750xjDpY7o5H/Lb0BDNYJTIAawrgyypBpmlNYXHITOM5NBNB1UZ5EWj05zYm/CM8oT6YPK7e6g/8mkNZXHGUTcIqZdi9VV/cv/cqNzaECSe1ArXzR04YcQruDG6cjjwAFXiwxgDRKiB8EABhm3oo7gQJVJosqwwxtMPuyNwxZG/HlEogIA5IkTCQPUpFk51MZ0QKFaDAWjHMuKFO/4ZDJcIIhDAVfTZEl3Rujmptmx9PVhH4kkX X-Forefront-PRVS: 02475B2A01 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(4630300001)(6009001)(39850400002)(39840400002)(39410400002)(39450400003)(39860400002)(48376002)(2950100002)(55016002)(6916009)(6666003)(50466002)(54906002)(5660300001)(107886003)(189998001)(38730400002)(110136004)(86362001)(53936002)(36756003)(305945005)(7736002)(5003940100001)(66066001)(81166006)(8676002)(4326008)(2906002)(42186005)(6116002)(2351001)(3846002)(33646002)(25786008)(50226002)(47776003)(76176999)(50986999)(118296001)(33026002); DIR:OUT; SFP:1101; SCL:1; SRVR:DB6PR0501MB2456; H:mellanox.com; FPR:; SPF:None; MLV:sfv; LANG:en; X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; DB6PR0501MB2456; 23:+GbryXawQz45Sd8EuZLipJuBU54TMhKE1pSNxA8?= kbfbrWlPh+FdTbYP2aUz7Lka334uz6QoZ1NtinTMtUz/+z4fCYJkeYELp+rcbb7W0kEFfT8OHL62EIqdFfIvdBqgNWSOhXrDotFTxT6NL27K4rehpxuxAgO+U9dtBPwwRYr7anzv8MK2Qm9KW0xIsGTwk5YYaGI3LhxYH8qoTb+Chm3PBz1a13gEW8OlyP4Hg2lk7B20RYwt+qHj4AKYKdqRHcx5/uVav2sjsCycsVoDAUvvbr8gGBpODNSHkd7oEmhPM4Z9CaX9PkI11rIwBIbBTHlfMLpyxf3zR8Nem+4s+2oQX6zt6TQObP0OdXaqXp8t/1ng5ifPR50eVJ6GPSX8FdHY2bzPOeyBK74L7gWpNtZ3Lm1huZUYUBfFEjmeW2AFw0U3m5Yxat9EkSz+oZNb16isFQ/YZJa/G8sVe6jSUDmxoCodIPVe/yUyrbbGZ+F2ApyYlMcPvuGLoERh7kouEFsnD7iwJ8iw6MXExZZOKmM8IDZCAksrTcDHLqlSxlNkXVCuyWgYLZ3UR6+InC7x0T0yYCKAGKxltvx70bVY0nGTK/o2s6qtwHRGONk0b1A8pQkv0kMaEcUZ02d6S4u+5WHBNhhm1p87As1qKfD9ONoZP5WpkTSrNK8LGAo15ceV7RQK+utZh3w29Z4OCTwebs9z9w603EPTjyBlItSfY5iZZN7ldiI+FcasXl7FxoRN04OZxmWryZYwrPgjeA2vobHsAeDLClXY/nMBQNMi84lMbDlT0MqkyT91aUfLjucdOnBQS3fULGIxo+xaNULHkxRD4knlEZz/cgKtMkltIw7aM+44SQXYEsQeGr3fpwzj2Kk9+TvmjyWhH+PHd0n3wFDj2H4IV+mGnZbOYbLnCXQ+hmG9f9biH0Sd71bhVxUlPiS+aT9CDjByJyPPYxygGvBnB5XHyCnT+A+V4VAic5vTgl/PrVZPY02subkAvZq6cRGxNEKRlyXMjq8zEBIFKkTwvCOz59mVJxuBz1WhMLeKtt0s/J/dzl83UYxk39E48uJrfqlnZydlVbXje30MG X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2456; 6:c1U2MZZzOouxx9FdvnEnLjMqxscL2yUnYWhvwbTyUgui+RtWtZggccaXW07bpyaL/EI4zWKr1Zt3zDmOLNI0z7Fxxq7LLYbHdkKDmbr7GGz9RMhYAs4FzyUAMZTYGBVukFUD+IMSEj1MbRLz+3dkHL4fU85xvPEtVTtHx68XrbbzRkr22DbFZZnC3i2F86l6WyT2fSNXYvOe4pYfgiZPw4Vis+PKzMIl2lyIx2BpfhE0ox23uWA0HxnRGtQCK1hAiVSbTzBaiWnDwIXCOR28msYQK0QPCk7dTIB91UVqACEnexGyKD4ASV69RzQrmpwDVsCIrDPhr76+DAPLJQgM6yVKBXP401c5V75M9XAay4cuQd2ZhDLdIc08Kk85VpXX6Bo6twLwaTc2BnjbHJxp5mMh3hg+zh4M5o2MAkIyxZ4=; 5:cB22JOFI9HSIrhjgKJe0wrBFFWMn76zhX5LSvbH5F4X3inZluexCTIjSZ0Bh62veN5ikRVtp+Uh11A2fJIXLRmJNCMZJ/N1H7wM4z55UOWZBWBbVHaeXJ0NHxlQNHo5cLhStyDPZCte19B7cBNEZ/A==; 24:GMTBncSYSPnFmTgKYoHdAwuMKPvekxpa7QWZxkfIXtlIhj2PssUUa0atdh+ZeWtDI1lF+xN+84HApByoO8yt2RDGKwJGdglonKGs9GXBlGI= SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-Microsoft-Exchange-Diagnostics: 1; DB6PR0501MB2456; 7:FcNZm7eW4dEoA3/T17isSepwRIPnF51Gm4yQHfvHMFkOJjSCIVGue9w57dtw+GLUoxSGnYBlaTeBnY0b9bEabEssli+39mKFFxvqJl9l3mIW2QLq8Oo+cwF4Fcq3EGIxu8DPQx8Op1poSbcL5HCA7iUJE5g9oB6XCXJipW54AGGxt5KvG5XLACsP+QIrsEfLTu7TsgPkwUUueT+Q83TS+Zta1vu1uqpRwmXY2Uv7yv4WQii06w0ZKv/qYuhLXuOPEubbXfyWmM9XqNFRHN/eEFbfjWb9nmHzb03u7Px3Vw6Q+9SCYNjLErOCEUM/1QnFg668dVdW25mN4qvRERxsBw== X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Mar 2017 23:56:02.6083 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0501MB2456 Subject: [dpdk-dev] [PATCH v3 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 | 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.