← Back to branch summary

~james-page/ubuntu/saucy/openvswitch/1.12-snapshot

« back to all changes in this revision

Viewing changes to vswitchd/ovs-vswitchd.8.in

  • Committer: James Page
  • Date: 2013-08-21 10:16:57 UTC
  • mfrom: (1.1.20)
  • Revision ID: james.page@canonical.com-20130821101657-3o0z0qeiv5zkwlzi
New upstream snapshot

Show diffs side-by-side

added added

removed removed

Lines of Context:
vswitchd/ovs-vswitchd.8.in
98
98
.so lib/ssl-bootstrap.man
99
99
.so lib/vlog.man
100
100
.so lib/common.man
101
 
.so lib/leak-checker.man
102
101
.
103
102
.SH "RUNTIME MANAGEMENT COMMANDS"
104
103
\fBovs\-appctl\fR(8) can send commands to a running
111
110
.IP "\fBqos/show\fR \fIinterface\fR"
112
111
Queries the kernel for Quality of Service configuration and statistics
113
112
associated with the given \fIinterface\fR.
 
113
.IP "\fBbfd/show\fR [\fIinterface\fR]"
 
114
Displays detailed information about Bidirectional Forwarding Detection
 
115
configured on \fIinterface\fR.  If \fIinterface\fR is not specified,
 
116
then displays detailed information about all interfaces with BFD
 
117
enabled.
 
118
.IP "\fBbfd/set-forwarding\fR [\fIinterface\fR] \fIstatus\fR"
 
119
Force the fault status of the BFD module on \fIinterface\fR (or all
 
120
interfaces if none is given) to be \fIstatus\fR.  \fIstatus\fR can be
 
121
"true", "false", or "normal" which reverts to the standard behavior.
114
122
.IP "\fBcfm/show\fR [\fIinterface\fR]"
115
123
Displays detailed information about Connectivity Fault Management
116
124
configured on \fIinterface\fR.  If \fIinterface\fR is not specified,
208
216
.so ofproto/ofproto-unixctl.man
209
217
.so lib/vlog-unixctl.man
210
218
.so lib/memory-unixctl.man
211
 
.so lib/stress-unixctl.man
 
219
.so lib/coverage-unixctl.man
 
220
.
 
221
.SH "OPENFLOW IMPLEMENTATION"
 
222
.
 
223
.PP
 
224
This section documents aspects of OpenFlow for which the OpenFlow
 
225
specification requires documentation.
 
226
.
 
227
.SS "Packet buffering."
 
228
The OpenFlow specification, version 1.2, says:
 
229
.
 
230
.IP
 
231
Switches that implement buffering are expected to expose, through
 
232
documentation, both the amount of available buffering, and the length
 
233
of time before buffers may be reused.
 
234
.
 
235
.PP
 
236
Open vSwitch maintains a separate set of 256 packet buffers for each
 
237
OpenFlow connection.  Any given packet buffer is preserved until it is
 
238
referenced by an \fBOFPT_FLOW_MOD\fR or \fBOFPT_PACKET_OUT\fR request
 
239
or for 5 seconds, whichever comes first.
212
240
.
213
241
.SH "LIMITS"
214
242
.
217
245
limits assume the use of the Linux kernel datapath.
218
246
.
219
247
.IP \(bu
220
 
Approximately 256 bridges given the allowance of 5,000 file
221
 
descriptors that \fBovs\-ctl\fR(8) configures.  (\fBovs\-vswitchd\fR
222
 
requires 17 file descriptors per datapath.)
223
 
.
224
 
.IP \(bu
225
 
65,280 ports per bridge.  Performance will degrade beyond 1,024 ports
226
 
per bridge due to fixed hash table sizing.
227
 
.
228
 
.IP \(bu
229
 
2,048 MAC learning entries per bridge.
 
248
\fBovs\-vswitchd\fR started through \fBovs\-ctl\fR(8) provides a limit of 7500
 
249
file descriptors.  The limits on the number of bridges and ports is decided by
 
250
the availability of file descriptors.  With the Linux kernel datapath, creation
 
251
of a single bridge consumes 3 file descriptors and adding a port consumes
 
252
1 file descriptor.  Performance will degrade beyond 1,024 ports per bridge due
 
253
to fixed hash table sizing.  Other platforms may have different limitations.
 
254
.
 
255
.IP \(bu
 
256
2,048 MAC learning entries per bridge, by default.  (This is
 
257
configurable via \fBother\-config:mac\-table\-size\fR in the
 
258
\fBBridge\fR table.  See \fBovs\-vswitchd.conf.db\fR(5) for details.)
230
259
.
231
260
.IP \(bu
232
261
Kernel flows are limited only by memory available to the kernel.