Document per-port round-robin during controller rate limiting.
authorBen Pfaff <blp@nicira.com>
Wed, 23 Sep 2009 19:39:58 +0000 (12:39 -0700)
committerBen Pfaff <blp@nicira.com>
Mon, 28 Sep 2009 17:39:24 +0000 (10:39 -0700)
CC: Peter Balland <peter@nicira.com>
Bug #2072.

vswitchd/ovs-vswitchd.conf.5.in

index 431e20b9cfee3b26584850d2e2c5899225904fe3..e7a1739711da8d84db41b5dd2e517f5ed4f51841 100644 (file)
@@ -546,6 +546,19 @@ These settings configure how the switch applies a ``token
 bucket'' to limit the rate at which packets in unknown flows are
 forwarded to the OpenFlow controller for flow-setup processing.  This
 feature prevents a single bridge from overwhelming a controller.
+.PP
+In addition, when a high rate triggers rate-limiting,
+\fBovs\-vswitchd\fR queues controller packets for each port and
+transmits them to the controller at the configured rate.  The number
+of queued packets is limited by a ``burst size'' parameter.  The
+packet queue is shared fairly among the ports on a bridge.
+.PP
+\fBovs\-vswitchd\fR maintains two such packet rate-limiters per
+bridge.  One of these applies to packets sent up to the controller
+because they do not correspond to any flow.  The other applies to
+packets sent up to the controller by request through flow actions.
+When both rate-limiters are filled with packets, the actual rate that
+packets are sent to the controller is up to twice the specified rate.
 .IP "\fBbridge.\fIname\fB.controller.rate-limit=\fIrate\fR"
 .IQ "\fBmgmt.rate-limit=\fIrate\fR"
 Limits the maximum rate at which packets will be forwarded to the