DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs
@ 2015-03-23 16:19 Bruce Richardson
  2015-03-25 10:43 ` Iremonger, Bernard
  0 siblings, 1 reply; 4+ messages in thread
From: Bruce Richardson @ 2015-03-23 16:19 UTC (permalink / raw)
  To: dev

Since the uio_pci_generic module requires that the device to which it is
being bound supports legacy interrupts, there can be problems using it
with VF devices. Add a note to the GSG doc to document this fact, and
provide information on loading igb_uio as a replacement.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/linux_gsg/build_dpdk.rst | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst
index 255d6dc..5f0f3ae 100644
--- a/doc/guides/linux_gsg/build_dpdk.rst
+++ b/doc/guides/linux_gsg/build_dpdk.rst
@@ -166,7 +166,7 @@ Loading Modules to Enable Userspace IO for DPDK
 -----------------------------------------------
 
 To run any DPDK application, a suitable uio module can be loaded into the running kernel.
-In most cases, the standard uio_pci_generic module included in the linux kernel
+In many cases, the standard uio_pci_generic module included in the linux kernel
 can provide the uio capability. This module can be loaded using the command
 
 .. code-block:: console
@@ -174,7 +174,18 @@ can provide the uio capability. This module can be loaded using the command
     sudo modprobe uio_pci_generic
 
 As an alternative to the uio_pci_generic, the DPDK also includes the igb_uio
-module which can be found in the kmod subdirectory referred to above.
+module which can be found in the kmod subdirectory referred to above. It can
+be loaded as shown below:
+
+.. code-block:: console
+
+    sudo modprobe uio
+    sudo insmod kmod/igb_uio.ko
+
+.. note::
+
+    For some devices which lack support for legacy interrupts, e.g. virtual function
+    (VF) devices, the igb_uio module may be needed in place of uio_pci_generic.
 
 Since DPDK release 1.7 onward provides VFIO support, use of UIO is optional
 for platforms that support using VFIO.
-- 
2.1.0

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs
  2015-03-23 16:19 [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs Bruce Richardson
@ 2015-03-25 10:43 ` Iremonger, Bernard
  2015-03-25 15:02   ` Butler, Siobhan A
  0 siblings, 1 reply; 4+ messages in thread
From: Iremonger, Bernard @ 2015-03-25 10:43 UTC (permalink / raw)
  To: Richardson, Bruce, dev

> -----Original Message-----
> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Bruce Richardson
> Sent: Monday, March 23, 2015 4:20 PM
> To: dev@dpdk.org
> Subject: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs
> 
> Since the uio_pci_generic module requires that the device to which it is being bound supports legacy
> interrupts, there can be problems using it with VF devices. Add a note to the GSG doc to document
> this fact, and provide information on loading igb_uio as a replacement.
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>

Acked-by: Bernard Iremonger <bernard.iremonger@intel.com>

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs
  2015-03-25 10:43 ` Iremonger, Bernard
@ 2015-03-25 15:02   ` Butler, Siobhan A
  2015-03-31  0:34     ` Thomas Monjalon
  0 siblings, 1 reply; 4+ messages in thread
From: Butler, Siobhan A @ 2015-03-25 15:02 UTC (permalink / raw)
  To: Iremonger, Bernard, Richardson, Bruce, dev



> -----Original Message-----
> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Iremonger, Bernard
> Sent: Wednesday, March 25, 2015 10:43 AM
> To: Richardson, Bruce; dev@dpdk.org
> Subject: Re: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module
> for VF devs
> 
> > -----Original Message-----
> > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Bruce Richardson
> > Sent: Monday, March 23, 2015 4:20 PM
> > To: dev@dpdk.org
> > Subject: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module
> > for VF devs
> >
> > Since the uio_pci_generic module requires that the device to which it
> > is being bound supports legacy interrupts, there can be problems using
> > it with VF devices. Add a note to the GSG doc to document this fact, and
> provide information on loading igb_uio as a replacement.
> >
> > Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> 
> Acked-by: Bernard Iremonger <bernard.iremonger@intel.com>

Acked-by: Siobhan Butler <siobhan.a.butler@intel.com>

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs
  2015-03-25 15:02   ` Butler, Siobhan A
@ 2015-03-31  0:34     ` Thomas Monjalon
  0 siblings, 0 replies; 4+ messages in thread
From: Thomas Monjalon @ 2015-03-31  0:34 UTC (permalink / raw)
  To: Richardson, Bruce; +Cc: dev

2015-03-25 15:02, Butler, Siobhan A:
> 
> > -----Original Message-----
> > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Iremonger, Bernard
> > Sent: Wednesday, March 25, 2015 10:43 AM
> > To: Richardson, Bruce; dev@dpdk.org
> > Subject: Re: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module
> > for VF devs
> > 
> > > -----Original Message-----
> > > From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Bruce Richardson
> > > Sent: Monday, March 23, 2015 4:20 PM
> > > To: dev@dpdk.org
> > > Subject: [dpdk-dev] [PATCH] doc: add note on needing igb_uio module
> > > for VF devs
> > >
> > > Since the uio_pci_generic module requires that the device to which it
> > > is being bound supports legacy interrupts, there can be problems using
> > > it with VF devices. Add a note to the GSG doc to document this fact, and
> > provide information on loading igb_uio as a replacement.
> > >
> > > Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> > 
> > Acked-by: Bernard Iremonger <bernard.iremonger@intel.com>
> 
> Acked-by: Siobhan Butler <siobhan.a.butler@intel.com>

Applied, thanks

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2015-03-31  0:35 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-03-23 16:19 [dpdk-dev] [PATCH] doc: add note on needing igb_uio module for VF devs Bruce Richardson
2015-03-25 10:43 ` Iremonger, Bernard
2015-03-25 15:02   ` Butler, Siobhan A
2015-03-31  0:34     ` Thomas Monjalon

DPDK patches and discussions

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://inbox.dpdk.org/dev/0 dev/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 dev dev/ https://inbox.dpdk.org/dev \
		dev@dpdk.org
	public-inbox-index dev

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://inbox.dpdk.org/inbox.dpdk.dev


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git