[ovs-dev,per-port,ingress,scheduling,1/2] ingress scheduling: documentation

Message ID 1535464703-12708-2-git-send-email-billy.o.mahony@intel.com
State New
Delegated to: Ian Stokes
Headers show
Series
  • [ovs-dev,per-port,ingress,scheduling,1/2] ingress scheduling: documentation
Related show

Commit Message

Billy O'Mahony Aug. 28, 2018, 1:58 p.m.
Signed-off-by: Billy O'Mahony <billy.o.mahony@intel.com>
---
 Documentation/howto/dpdk.rst | 15 +++++++++++++++
 vswitchd/vswitch.xml         | 15 +++++++++++++++
 2 files changed, 30 insertions(+)

Comments

Ben Pfaff Aug. 30, 2018, 9:08 p.m. | #1
On Tue, Aug 28, 2018 at 02:58:22PM +0100, Billy O'Mahony wrote:
> Signed-off-by: Billy O'Mahony <billy.o.mahony@intel.com>

Please put documentation for a feature in the same patch that adds the
feature.

Thanks,

Ben.

Patch

diff --git a/Documentation/howto/dpdk.rst b/Documentation/howto/dpdk.rst
index ab3d576..83284e7 100644
--- a/Documentation/howto/dpdk.rst
+++ b/Documentation/howto/dpdk.rst
@@ -360,6 +360,21 @@  devices to bridge ``br0``. Once complete, follow the below steps:
 
        $ cat /proc/interrupts | grep virtio
 
+Ingress Scheduling
+------------------
+
+The ingress scheduling feature is described in general in
+``ovs-vswitchd.conf.db (5)``.
+
+Ingress scheduling currently supports setting a priority for incoming packets
+for an entire interface. Priority levels 0 (lowest) to 3 (highest) are
+supported.  The default priority is 0.
+
+To prioritize packets on a particular port:
+
+    $ ovs-vsctl set Interface dpdk0 \
+        ingress_sched=port_prio=3
+
 .. _dpdk-flow-hardware-offload:
 
 Flow Hardware Offload (Experimental)
diff --git a/vswitchd/vswitch.xml b/vswitchd/vswitch.xml
index 71bbe95..e88a69a 100644
--- a/vswitchd/vswitch.xml
+++ b/vswitchd/vswitch.xml
@@ -3196,6 +3196,21 @@  ovs-vsctl add-port br0 p0 -- set Interface p0 type=patch options:peer=p1 \
       </column>
     </group>
 
+    <group title="Ingress Scheduling">
+      <p>
+       Configuration to allow rxd traffic to be prioritized on a per Interface
+       basis.
+      </p>
+      <column name="other_config" key="port_prio">
+        <p>
+          The ingress priority of the port: 0 (lowest) to 3 (highest). Higher
+          priority ports are read more frequently than lower priority ports.
+          This provides enhanced protection to packets ingressing high priority
+          ports against being dropped due to Rx queue overflow.
+        </p>
+      </column>
+    </group>
+
     <group title="Bidirectional Forwarding Detection (BFD)">
       <p>
         BFD, defined in RFC 5880 and RFC 5881, allows point-to-point