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 06FAFA04DD; Wed, 21 Oct 2020 10:19:08 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id E4BAAAD05; Wed, 21 Oct 2020 10:17:54 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id 49B29ACD6 for ; Wed, 21 Oct 2020 10:17:50 +0200 (CEST) IronPort-SDR: AG1k4a8D8bPmcUvgB1E2/ulWhrkJV2YhEolKouRbxTvUD8VUMEoymvae5tXsKfKgTGCZV7hEX7 DVQQvyj37dGA== X-IronPort-AV: E=McAfee;i="6000,8403,9780"; a="166556313" X-IronPort-AV: E=Sophos;i="5.77,400,1596524400"; d="scan'208";a="166556313" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Oct 2020 01:17:47 -0700 IronPort-SDR: mZZrkzgFcbw6d0mzcr0tVtMC/LpYroU7+hGQpelHfJYTt7YU9v4+AUYgy2Kfp4X5SxVMH8EwQw YYq19HoNHC0g== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.77,400,1596524400"; d="scan'208";a="316301948" Received: from silpixa00400355.ir.intel.com (HELO silpixa00400355.ger.corp.intel.com) ([10.237.222.239]) by orsmga003.jf.intel.com with ESMTP; 21 Oct 2020 01:17:46 -0700 From: Ciara Power To: dev@dpdk.org Cc: Ciara Power , Matan Azrad , Xiao Wang , Viacheslav Ovsiienko Date: Wed, 21 Oct 2020 09:17:14 +0100 Message-Id: <20201021081725.68541-5-ciara.power@intel.com> X-Mailer: git-send-email 2.22.0 In-Reply-To: <20201021081725.68541-1-ciara.power@intel.com> References: <20200807123009.21266-1-ciara.power@intel.com> <20201021081725.68541-1-ciara.power@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v7 04/14] doc: remove references to make from vdpadevs guides 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" Make is no longer supported for compiling DPDK, references are now removed in the documentation. Signed-off-by: Ciara Power Acked-by: Matan Azrad --- v7: Modified compilation options to detail meson option ibverbs_link. --- doc/guides/vdpadevs/ifc.rst | 13 ------------- doc/guides/vdpadevs/mlx5.rst | 34 ++++++++++++---------------------- 2 files changed, 12 insertions(+), 35 deletions(-) diff --git a/doc/guides/vdpadevs/ifc.rst b/doc/guides/vdpadevs/ifc.rst index 12a2a342e6..f968489a75 100644 --- a/doc/guides/vdpadevs/ifc.rst +++ b/doc/guides/vdpadevs/ifc.rst @@ -11,19 +11,6 @@ directly by DMA. Besides, it supports dirty page logging and device state report/restore, this driver enables its vDPA functionality. -Pre-Installation Configuration ------------------------------- - -Config File Options -~~~~~~~~~~~~~~~~~~~ - -The following option can be modified in the ``config`` file. - -- ``CONFIG_RTE_LIBRTE_IFC_PMD`` (default ``y`` for linux) - - Toggle compilation of the ``librte_pmd_ifc`` driver. - - IFCVF vDPA Implementation ------------------------- diff --git a/doc/guides/vdpadevs/mlx5.rst b/doc/guides/vdpadevs/mlx5.rst index 2c7a550afc..9a11eefd2c 100644 --- a/doc/guides/vdpadevs/mlx5.rst +++ b/doc/guides/vdpadevs/mlx5.rst @@ -14,9 +14,7 @@ SR-IOV context. .. note:: - Due to external dependencies, this driver is disabled in default - configuration of the "make" build. It can be enabled with - ``CONFIG_RTE_LIBRTE_MLX5_VDPA_PMD=y`` or by using "meson" build system which + This driver is enabled automatically when using "meson" build system which will detect dependencies. @@ -62,16 +60,13 @@ Prerequisites - Mellanox OFED version: **5.0** see :doc:`../../nics/mlx5` guide for more Mellanox OFED details. -Compilation options -~~~~~~~~~~~~~~~~~~~ +Compilation option +~~~~~~~~~~~~~~~~~~ -These options can be modified in the ``.config`` file. +The meson option ``ibverbs_link`` is **shared** by default, +but can be configured to have the following values: -- ``CONFIG_RTE_LIBRTE_MLX5_VDPA_PMD`` (default **n**) - - Toggle compilation of librte_pmd_mlx5 itself. - -- ``CONFIG_RTE_IBVERBS_LINK_DLOPEN`` (default **n**) +- ``dlopen`` Build PMD with additional code to make it loadable without hard dependencies on **libibverbs** nor **libmlx5**, which may not be installed @@ -79,28 +74,23 @@ These options can be modified in the ``.config`` file. In this mode, their presence is still required for it to run properly, however their absence won't prevent a DPDK application from starting (with - ``CONFIG_RTE_BUILD_SHARED_LIB`` disabled) and they won't show up as - missing with ``ldd(1)``. + DPDK shared build disabled) and they won't show up as missing with ``ldd(1)``. It works by moving these dependencies to a purpose-built rdma-core "glue" - plug-in which must either be installed in a directory whose name is based - on ``CONFIG_RTE_EAL_PMD_PATH`` suffixed with ``-glue`` if set, or in a - standard location for the dynamic linker (e.g. ``/lib``) if left to the - default empty string (``""``). + plug-in which must be installed in a directory whose name is based + on ``RTE_EAL_PMD_PATH`` suffixed with ``-glue``. This option has no performance impact. -- ``CONFIG_RTE_IBVERBS_LINK_STATIC`` (default **n**) +- ``static`` Embed static flavor of the dependencies **libibverbs** and **libmlx5** in the PMD shared library or the executable static binary. .. note:: - For BlueField, target should be set to ``arm64-bluefield-linux-gcc``. This - will enable ``CONFIG_RTE_LIBRTE_MLX5_VDPA_PMD`` and set - ``RTE_CACHE_LINE_SIZE`` to 64. Default armv8a configuration of make build and - meson build set it to 128 then brings performance degradation. + Default armv8a configuration of meson build sets ``RTE_CACHE_LINE_SIZE`` + to 128 then brings performance degradation. Run-time configuration ~~~~~~~~~~~~~~~~~~~~~~ -- 2.22.0