summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorCiara Loftus <ciara.loftus@intel.com>2017-01-05 10:42:09 +0000
committerDaniele Di Proietto <diproiettod@vmware.com>2017-01-05 20:10:13 -0800
commit55e075e65ef9ecbd70e5e0fada2704c3d73724d8 (patch)
treecee33f674f733cf432ab80856d443d3809871c52 /Documentation
parentb8374d0d04260793db35b617eb15bba958d50003 (diff)
downloadopenvswitch-55e075e65ef9ecbd70e5e0fada2704c3d73724d8.tar.gz
netdev-dpdk: Arbitrary 'dpdk' port naming
'dpdk' ports no longer have naming restrictions. Now, instead of specifying the dpdk port ID as part of the name, the PCI address of the device must be specified via the 'dpdk-devargs' option. eg. ovs-vsctl add-port br0 my-port ovs-vsctl set Interface my-port type=dpdk options:dpdk-devargs=0000:06:00.3 The user must no longer hotplug attach DPDK ports by issuing the specific ovs-appctl netdev-dpdk/attach command. The hotplug is now automatically invoked when a valid PCI address is set in the dpdk-devargs. The format for ovs-appctl netdev-dpdk/detach command has changed in that the user now must specify the relevant PCI address as input instead of the port name. Signed-off-by: Ciara Loftus <ciara.loftus@intel.com> Signed-off-by: Kevin Traynor <ktraynor@redhat.com> Co-authored-by: Kevin Traynor <ktraynor@redhat.com> Acked-by: Stephen Finucane <stephen@that.guru> # docs only Signed-off-by: Daniele Di Proietto <diproiettod@vmware.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/howto/dpdk.rst7
-rw-r--r--Documentation/intro/install/dpdk.rst9
2 files changed, 10 insertions, 6 deletions
diff --git a/Documentation/howto/dpdk.rst b/Documentation/howto/dpdk.rst
index 13da54801..1ff672c6a 100644
--- a/Documentation/howto/dpdk.rst
+++ b/Documentation/howto/dpdk.rst
@@ -312,14 +312,13 @@ In order to attach a port, it has to be bound to DPDK using the
Then it can be attached to OVS::
- $ ovs-appctl netdev-dpdk/attach 0000:01:00.0
-
-At this point, the user can create a dpdk port using the ``add-port`` command.
+ $ ovs-vsctl add-port br0 dpdkx -- set Interface dpdkx type=dpdk \
+ options:dpdk-devargs=0000:01:00.0
It is also possible to detach a port from ovs, the user has to remove the
port using the del-port command, then it can be detached using::
- $ ovs-appctl netdev-dpdk/detach dpdk0
+ $ ovs-appctl netdev-dpdk/detach dpdkx
This feature is not supported with VFIO and does not work with some NICs.
For more information please refer to the `DPDK Port Hotplug Framework
diff --git a/Documentation/intro/install/dpdk.rst b/Documentation/intro/install/dpdk.rst
index 10ceabba4..fff0a1a52 100644
--- a/Documentation/intro/install/dpdk.rst
+++ b/Documentation/intro/install/dpdk.rst
@@ -252,8 +252,13 @@ ports. For example, to create a userspace bridge named ``br0`` and add two
``dpdk`` ports to it, run::
$ ovs-vsctl add-br br0 -- set bridge br0 datapath_type=netdev
- $ ovs-vsctl add-port br0 dpdk0 -- set Interface dpdk0 type=dpdk
- $ ovs-vsctl add-port br0 dpdk1 -- set Interface dpdk1 type=dpdk
+ $ ovs-vsctl add-port br0 myportnameone -- set Interface myportnameone \
+ type=dpdk options:dpdk-devargs=0000:06:00.0
+ $ ovs-vsctl add-port br0 myportnametwo -- set Interface myportnametwo \
+ type=dpdk options:dpdk-devargs=0000:06:00.1
+
+DPDK devices will not be available for use until a valid dpdk-devargs is
+specified.
Refer to ovs-vsctl(8) and :doc:`/howto/dpdk` for more details.