On 6/30/25 11:52 AM, David Marchand via dev wrote:
> igb_uio has been moved out of the DPDK git repository and is not
> maintained actively anymore.
> vfio-pci provides all needed features for DPDK.
> 
> Default to giving examples with vfio-pci.
> 
> Signed-off-by: David Marchand <david.march...@redhat.com>
> ---
>  Documentation/howto/userspace-tunneling.rst | 3 +--
>  Documentation/topics/dpdk/vhost-user.rst    | 8 +++-----
>  2 files changed, 4 insertions(+), 7 deletions(-)
> 
> diff --git a/Documentation/howto/userspace-tunneling.rst 
> b/Documentation/howto/userspace-tunneling.rst
> index 31d82fd5e5..0d84497e09 100644
> --- a/Documentation/howto/userspace-tunneling.rst
> +++ b/Documentation/howto/userspace-tunneling.rst
> @@ -149,8 +149,7 @@ Perform the following configuration on `host1`:
>         $ ip link set eth1 up
>         $ iptables -F
>  
> -   If instead the interface is a DPDK interface and bound to the ``igb_uio`` 
> or
> -   ``vfio`` driver, run::
> +   If instead the interface is a DPDK interface, run::
>  
>         $ ovs-vsctl --timeout 10 add-port br-phy dpdk0 \
>           -- set Interface dpdk0 type=dpdk options:dpdk-devargs=0000:06:00.0
> diff --git a/Documentation/topics/dpdk/vhost-user.rst 
> b/Documentation/topics/dpdk/vhost-user.rst
> index 76a5ec6638..3c31f52000 100644
> --- a/Documentation/topics/dpdk/vhost-user.rst
> +++ b/Documentation/topics/dpdk/vhost-user.rst
> @@ -408,15 +408,13 @@ To begin, instantiate a guest as described in 
> :ref:`dpdk-vhost-user` or
>  :ref:`dpdk-vhost-user-client`. Once started, connect to the VM, download the
>  DPDK sources to VM and build DPDK as described in :ref:`dpdk-install`.
>  
> -Setup huge pages and DPDK devices using UIO::
> +Setup huge pages and DPDK devices using VFIO::
>  
>      $ sysctl vm.nr_hugepages=1024
>      $ mkdir -p /dev/hugepages
>      $ mount -t hugetlbfs hugetlbfs /dev/hugepages  # only if not already 
> mounted
> -    $ modprobe uio
> -    $ insmod $DPDK_BUILD/kmod/igb_uio.ko
> -    $ driverctl set-override 0000:00:03.0 igb_uio
> -    $ driverctl set-override 0000:00:04.0 igb_uio
> +    $ driverctl set-override 0000:00:03.0 vfio-pci
> +    $ driverctl set-override 0000:00:04.0 vfio-pci

This doc is for VM.  Chances are, this VM doesn't have IOMMU as the example
XML doesn't.  So, may also be worth mentioning the no-IOMMU configuration.

Alternative is to use uio_pci_generic instead of igb_uio.

IIRC, older RHEL kernels do not even have ability to turn on insecure noiommu
mode for vfio module.  So, may be worth to at least mention the uio_pci_generic
anyway.

Best regards, Ilya Maximets.
_______________________________________________
dev mailing list
d...@openvswitch.org
https://mail.openvswitch.org/mailman/listinfo/ovs-dev

Reply via email to