From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 67A25A00E6 for ; Mon, 5 Aug 2019 17:33:10 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 691D41BE04; Mon, 5 Aug 2019 17:32:53 +0200 (CEST) Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by dpdk.org (Postfix) with ESMTP id F3B621BE01 for ; Mon, 5 Aug 2019 17:32:51 +0200 (CEST) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id 9874B21C28; Mon, 5 Aug 2019 11:32:51 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Mon, 05 Aug 2019 11:32:51 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; s=mesmtp; bh=Z9DyzsNqSY lsTSSVTwYqm7t+DYfr6vCemWlym4SPSD8=; b=OqyMtFMzUJMXU2ol/Oq6++alNk D7kxYq1pqqn5rCFK4WUaXVOZWNZssgJknupZPWRQBOJYdi0szELDegN+e69gH5BV q4Wth0nBqEoz/PkVjiv/KtAq48Pug9Qt0a+4ZWbaVqGZWVPgqfuOTwv8n+quXn/S AcGUd0vwyW/lLc6OY= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=Z9DyzsNqSYlsTSSVTwYqm7t+DYfr6vCemWlym4SPSD8=; b=ZkZl1ZcH 6zBCmdMVcF9S6UpNTzfNXDQuArubZau3S//l5lHWLq9uCQkNGEhuKqkJQKO5I8vy aPHYvq88ChwBZRtDoKvXmYub2xN5EitbmHrmXVPLkOO5U3ai7mfp2y8xoN4+eEN1 IunpRX4Qzz49RsJf2Zn3YcTyRm2PMZ6OdsRMaV54IoUBFpslunZIXqi8e6nsrgzo Pn8BuRxwbQo5YIN0wQs++yCQ6n8SLpzFKOTUO7QLFQPNUCqD2oXLDiCNQWZR/rdU xF7eYk/rROP4dYz2LZydJ3ziLyRko7La31I+8DT/yTMavMF0KbLLP21Rahm1ioOU g+KZCnM/DCuMsA== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddruddtjedgkeelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecukf hppeejjedrudefgedrvddtfedrudekgeenucfrrghrrghmpehmrghilhhfrhhomhepthhh ohhmrghssehmohhnjhgrlhhonhdrnhgvthenucevlhhushhtvghrufhiiigvpedv X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 907FF80068; Mon, 5 Aug 2019 11:32:50 -0400 (EDT) From: Thomas Monjalon To: Shahaf Shuler , Yongseok Koh , Viacheslav Ovsiienko , John McNamara , Marko Kovacevic Cc: dev@dpdk.org Date: Mon, 5 Aug 2019 17:32:21 +0200 Message-Id: <20190805153222.29593-5-thomas@monjalon.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190805153222.29593-1-thomas@monjalon.net> References: <20190805153222.29593-1-thomas@monjalon.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH 4/5] doc: add mlx5 design details 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" Some details about libibverbs were missing: - automatic detection by meson - main ways to access the device Signed-off-by: Thomas Monjalon --- doc/guides/nics/mlx5.rst | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index dcefc65ec..b9cabfe96 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -20,12 +20,12 @@ There is also a `section dedicated to this poll mode driver .. note:: - Due to external dependencies, this driver is disabled by default. It must - be enabled manually by setting ``CONFIG_RTE_LIBRTE_MLX5_PMD=y`` and - recompiling DPDK. + Due to external dependencies, this driver is disabled in default configuration + of the "make" build. It can be enabled with ``CONFIG_RTE_LIBRTE_MLX5_PMD=y`` + or by using "meson" build system which will detect dependencies. -Implementation details ----------------------- +Design +------ Besides its dependency on libibverbs (that implies libmlx5 and associated kernel support), librte_pmd_mlx5 relies heavily on system calls for control @@ -44,6 +44,16 @@ This means legacy linux control tools (for example: ethtool, ifconfig and more) can operate on the same network interfaces that owned by the DPDK application. +The PMD can use libibverbs and libmlx5 to access the device firmware +or directly the hardware components. +There are different levels of objects and bypassing abilities +to get the best performances: + +- Verbs is a complete high-level generic API +- Direct Verbs is a device-specific API +- DevX allows to access firmware objects +- Direct Rules manages flow steering at low-level hardware layer + Enabling librte_pmd_mlx5 causes DPDK applications to be linked against libibverbs. -- 2.21.0