On 6/30/25 11:52 AM, David Marchand via dev wrote: > Manually compiling DPDK is more a developer/packager job. > "Normal" users should focus on using the Linux distribution package. > Simplify the documentation and recommend using the DPDK package. > > Signed-off-by: David Marchand <david.march...@redhat.com> > --- > Documentation/howto/dpdk.rst | 15 ++++++++------- > Documentation/intro/install/dpdk.rst | 9 ++++++--- > Documentation/topics/dpdk/vhost-user.rst | 4 +++- > 3 files changed, 17 insertions(+), 11 deletions(-) > > diff --git a/Documentation/howto/dpdk.rst b/Documentation/howto/dpdk.rst > index 493e2c99e5..ab6da3c35d 100644 > --- a/Documentation/howto/dpdk.rst > +++ b/Documentation/howto/dpdk.rst > @@ -32,8 +32,9 @@ This document describes how to use Open vSwitch with DPDK. > Using DPDK with OVS requires configuring OVS at build time to use > the DPDK library. The version of DPDK that OVS supports varies > from one OVS release to another, as described in the :doc:`releases > - FAQ </faq/releases>`. For build instructions refer to > - :doc:`/intro/install/dpdk`. > + FAQ </faq/releases>`. Most distributions now provide a package for > + DPDK and it is recommended you use it. Though for custom usecases, > + build instructions for DPDK are provided in :doc:`/intro/install/dpdk`.
I'd say that chances that a distribution ships a version of DPDK compatible with OVS that someone is trying to build is pretty slim. So, I would only advertise this option if the version of DPDK shipped by the distribution matches the version specified for this version of OVS in the FAQ. Building DPDK from source will still likely be the most common option. So, I'd suggest to adjust the wording throughout the patch. Best regards, Ilya Maximets. > > Ports and Bridges > ----------------- > @@ -216,12 +217,12 @@ You can do this directly with QEMU via the > ``qemu-system-x86_64`` application:: > For a explanation of this command, along with alternative approaches such as > booting the VM via libvirt, refer to :doc:`/topics/dpdk/vhost-user`. > > -Once the guest is configured and booted, configure DPDK packet forwarding > -within the guest. To accomplish this, build the ``dpdk-testpmd`` application > as > -described in :ref:`dpdk-testpmd`. Once compiled, run the application:: > +Once the guest is configured and booted, install DPDK (most distributions > +provide a package, otherwise you may build DPDK, see > +:doc:`/intro/install/dpdk`) and configure DPDK packet forwarding within the > +guest:: > > - $ cd /path/to/dpdk/build/ > - $ ./dpdk-testpmd -c 0x3 --in-memory -- --burst=64 -i > + $ dpdk-testpmd -c 0x3 --in-memory -- --burst=64 -i > $ set fwd mac retry > $ start > > diff --git a/Documentation/intro/install/dpdk.rst > b/Documentation/intro/install/dpdk.rst > index a1939f9041..4b2c7deaeb 100644 > --- a/Documentation/intro/install/dpdk.rst > +++ b/Documentation/intro/install/dpdk.rst > @@ -25,9 +25,8 @@ > Open vSwitch with DPDK > ====================== > > -This document describes how to build and install Open vSwitch using a DPDK > -datapath. Open vSwitch can use the DPDK library to operate entirely in > -userspace. > +This document describes how to build and install Open vSwitch using DPDK > +in the userspace datapath. > > .. important:: > > @@ -70,6 +69,10 @@ Installing > Install DPDK > ~~~~~~~~~~~~ > > +One important note is that most Linux distributions provide a DPDK package > and > +using it is recommended. > +If you still require to use a manually compiled DPDK, here are the steps. > + > #. Download the `DPDK sources`_, extract the file and set ``DPDK_DIR``:: > > $ cd /usr/src/ > diff --git a/Documentation/topics/dpdk/vhost-user.rst > b/Documentation/topics/dpdk/vhost-user.rst > index 0c0054b754..b992c79203 100644 > --- a/Documentation/topics/dpdk/vhost-user.rst > +++ b/Documentation/topics/dpdk/vhost-user.rst > @@ -396,7 +396,9 @@ DPDK in the Guest > ----------------- > > The ``dpdk-testpmd`` application can be run in guest VMs for high speed > packet > -forwarding between vhostuser ports. DPDK has to be compiled on the guest VM. > +forwarding between vhostuser ports. DPDK is provided as a package in most > Linux > +distributions (though you may want to build it manually, see > +:doc:`/intro/install/dpdk`). > Below are the steps for setting up the environment in the VM. > > .. note:: _______________________________________________ dev mailing list d...@openvswitch.org https://mail.openvswitch.org/mailman/listinfo/ovs-dev
