From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alejandro Lucero Subject: [PATCH] nfp: modifying guide about using uio modules Date: Tue, 26 Apr 2016 12:36:41 +0100 Message-ID: <1461670601-44285-1-git-send-email-alejandro.lucero@netronome.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable To: dev@dpdk.org Return-path: Received: from cbtest1.netronome.com (unknown [79.78.33.110]) by dpdk.org (Postfix) with ESMTP id 317282716 for ; Tue, 26 Apr 2016 13:36:49 +0200 (CEST) Received: from cbtest1.netronome.com (localhost [127.0.0.1]) by cbtest1.netronome.com (8.14.4/8.14.4/Debian-4.1ubuntu1) with ESMTP id u3QBafXV044324 for ; Tue, 26 Apr 2016 12:36:41 +0100 Received: (from alucero@localhost) by cbtest1.netronome.com (8.14.4/8.14.4/Submit) id u3QBaf3b044323 for dev@dpdk.org; Tue, 26 Apr 2016 12:36:41 +0100 List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" - Removing dependency on nfp_uio kernel module. The igb_uio kernel modules can be used instead. Fixes: 80bc1752f16e ("nfp: add guide") Signed-off-by: Alejandro Lucero --- doc/guides/nics/nfp.rst | 47 ++++++++++++++++---------------------------= ---- 1 file changed, 16 insertions(+), 31 deletions(-) diff --git a/doc/guides/nics/nfp.rst b/doc/guides/nics/nfp.rst index dfc3683..e4ebc71 100644 --- a/doc/guides/nics/nfp.rst +++ b/doc/guides/nics/nfp.rst @@ -61,9 +61,8 @@ instructions. =20 DPDK runs in userspace and PMDs uses the Linux kernel UIO interface to allow access to physical devices from userspace. The NFP PMD requires -a separate UIO driver, **nfp_uio**, to perform correct -initialization. This driver is part of Netronome=C2=B4s BSP and it is -equivalent to Intel's igb_uio driver. +the **igb_uio** UIO driver, available with DPDK, to perform correct +initialization. =20 Building the software --------------------- @@ -201,27 +200,18 @@ Using the NFP PMD is not different to using other P= MDs. Usual steps are: =20 The module should now be listed by the lsmod command. =20 -#. **To install the nfp_uio kernel module (manually):** This module supp= orts - NFP-6xxx devices through the UIO interface. - - This module is part of Netronome=C2=B4s BSP and it should be availabl= e when the - BSP is installed. +#. **To install the igb_uio kernel module (manually):** This module is p= art + of DPDK sources and configured by default (CONFIG_RTE_EAL_IGB_UIO=3Dy= ). =20 .. code-block:: console =20 - modprobe nfp_uio.ko + modprobe igb_uio.ko =20 The module should now be listed by the lsmod command. =20 - Depending on which NFP modules are loaded, nfp_uio may be automatical= ly - bound to the NFP PCI devices by the system. Otherwise the binding nee= ds - to be done explicitly. This is the case when nfp_netvf, the Linux ker= nel - driver for NFP VFs, was loaded when VFs were created. As described la= ter - in this document this configuration may also be performed using scrip= ts - provided by the Netronome=C2=B4s BSP. - - First the device needs to be unbound, for example from the nfp_netvf - driver: + Depending on which NFP modules are loaded, it could be necessary to + detach NFP devices from the nfp_netvf module. If this is the case the + device needs to be unbound, for example: =20 .. code-block:: console =20 @@ -232,30 +222,25 @@ Using the NFP PMD is not different to using other P= MDs. Usual steps are: The output of lspci should now show that 0000:03:08.0 is not bound to any driver. =20 - The next step is to add the NFP PCI ID to the NFP UIO driver: + The next step is to add the NFP PCI ID to the IGB UIO driver: =20 .. code-block:: console =20 - echo 19ee 6003 > /sys/bus/pci/drivers/nfp_uio/new_id + echo 19ee 6003 > /sys/bus/pci/drivers/igb_uio/new_id =20 - And then to bind the device to the nfp_uio driver: + And then to bind the device to the igb_uio driver: =20 .. code-block:: console =20 - echo 0000:03:08.0 > /sys/bus/pci/drivers/nfp_uio/bind + echo 0000:03:08.0 > /sys/bus/pci/drivers/igb_uio/bind =20 lspci -d19ee: -k =20 - lspci should show that device bound to nfp_uio driver. - -#. **Using tools from Netronome=C2=B4s BSP to install and bind modules:*= * DPDK provides - scripts which are useful for installing the UIO modules and for bindi= ng the - right device to those modules avoiding doing so manually. However, th= ese scripts - have not support for Netronome=C2=B4s UIO driver. Along with drivers,= the BSP installs - those DPDK scripts slightly modified with support for Netronome=C2=B4= s UIO driver. + lspci should show that device bound to igb_uio driver. =20 - Those specific scripts can be found in Netronome=C2=B4s BSP installat= ion directory. - Refer to BSP documentation for more information. +#. **Using scripts to install and bind modules:** DPDK provides scripts = which are + useful for installing the UIO modules and for binding the right devic= e to those + modules avoiding doing so manually: =20 * **setup.sh** * **dpdk_nic_bind.py** --=20 1.9.1