X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=utilities%2Fovs-ofctl.8.in;h=c48645af4eb1f32e8322f6575cc1b831ab6570d5;hb=85b20fd6ee585f462e012fbcc7f966a81edab2ed;hp=9ea09737bc276722537a3562aa17f8bd4b5a5e68;hpb=7a97619ae4484604c15b846ce7268094e048729a;p=sliver-openvswitch.git diff --git a/utilities/ovs-ofctl.8.in b/utilities/ovs-ofctl.8.in index 9ea09737b..c48645af4 100644 --- a/utilities/ovs-ofctl.8.in +++ b/utilities/ovs-ofctl.8.in @@ -4,7 +4,7 @@ . ns . IP "\\$1" .. -.TH ovs\-ofctl 8 "January 2011" "Open vSwitch" "Open vSwitch Manual" +.TH ovs\-ofctl 8 "@VERSION@" "Open vSwitch" "Open vSwitch Manual" .ds PN ovs\-ofctl . .SH NAME @@ -20,6 +20,7 @@ The program is a command line tool for monitoring and administering OpenFlow switches. It can also show the current state of an OpenFlow switch, including features, configuration, and table entries. +It should work with any OpenFlow switch, not just Open vSwitch. . .SS "OpenFlow Switch Management Commands" .PP @@ -392,8 +393,8 @@ flows not in normal form. The following field assignments describe how a flow matches a packet. If any of these assignments is omitted from the flow syntax, the field is treated as a wildcard; thus, if all of them are omitted, the -resulting flow matches all packets. The string \fB*\fR or \fBANY\fR -may be specified to explicitly mark any of these fields as a wildcard. +resulting flow matches all packets. The string \fB*\fR may be specified +to explicitly mark any of these fields as a wildcard. (\fB*\fR should be quoted to protect it from shell expansion.) . .IP \fBin_port=\fIport\fR @@ -468,8 +469,12 @@ When \fBdl_type=0x0806\fR or \fBarp\fR is specified, matches the \fBar_spa\fR or \fBar_tpa\fR field, respectively, in ARP packets for IPv4 and Ethernet. .IP -When \fBdl_type\fR is wildcarded or set to a value other than 0x0800 -or 0x0806, the values of \fBnw_src\fR and \fBnw_dst\fR are ignored +When \fBdl_type=0x8035\fR or \fBrarp\fR is specified, matches the +\fBar_spa\fR or \fBar_tpa\fR field, respectively, in RARP packets for +IPv4 and Ethernet. +.IP +When \fBdl_type\fR is wildcarded or set to a value other than 0x0800, +0x0806, or 0x8035, the values of \fBnw_src\fR and \fBnw_dst\fR are ignored (see \fBFlow Syntax\fR above). . .IP \fBnw_proto=\fIproto\fR @@ -488,9 +493,13 @@ When \fBarp\fR or \fBdl_type=0x0806\fR is specified, matches the lower 8 bits of the ARP opcode. ARP opcodes greater than 255 are treated as 0. .IP +When \fBrarp\fR or \fBdl_type=0x8035\fR is specified, matches the lower +8 bits of the ARP opcode. ARP opcodes greater than 255 are treated as +0. +.IP When \fBdl_type\fR is wildcarded or set to a value other than 0x0800, -0x0806, or 0x86dd, the value of \fBnw_proto\fR is ignored (see \fBFlow -Syntax\fR above). +0x0806, 0x8035 or 0x86dd, the value of \fBnw_proto\fR is ignored (see +\fBFlow Syntax\fR above). . .IP \fBnw_tos=\fItos\fR Matches IP ToS/DSCP or IPv6 traffic class field \fItos\fR, which is @@ -645,6 +654,9 @@ Same as \fBdl_type=0x0800,nw_proto=17\fR. .IP \fBarp\fR Same as \fBdl_type=0x0806\fR. . +.IP \fBrarp\fR +Same as \fBdl_type=0x8035\fR. +. .PP The following field assignments require support for the NXM (Nicira Extended Match) extension to OpenFlow. When one of these is specified, @@ -712,9 +724,9 @@ command, above, for more details. . .IP \fBarp_sha=\fIxx\fB:\fIxx\fB:\fIxx\fB:\fIxx\fB:\fIxx\fB:\fIxx\fR .IQ \fBarp_tha=\fIxx\fB:\fIxx\fB:\fIxx\fB:\fIxx\fB:\fIxx\fB:\fIxx\fR -When \fBdl_type\fR specifies ARP, \fBarp_sha\fR and \fBarp_tha\fR match -the source and target hardware address, respectively. An address is -specified as 6 pairs of hexadecimal digits delimited by colons. +When \fBdl_type\fR specifies either ARP or RARP, \fBarp_sha\fR and +\fBarp_tha\fR match the source and target hardware address, respectively. An +address is specified as 6 pairs of hexadecimal digits delimited by colons. . .IP \fBipv6_src=\fIipv6\fR[\fB/\fInetmask\fR] .IQ \fBipv6_dst=\fIipv6\fR[\fB/\fInetmask\fR] @@ -1332,6 +1344,8 @@ passing through the flow. \fB\-\-strict\fR Uses strict matching when running flow modification commands. . +.so lib/ofp-version.man +. .IP "\fB\-F \fIformat\fR[\fB,\fIformat\fR...]" .IQ "\fB\-\-flow\-format=\fIformat\fR[\fB,\fIformat\fR...]" \fBovs\-ofctl\fR supports the following individual flow formats, any @@ -1356,6 +1370,11 @@ registers. Open vSwitch 1.1 and later supports this flow format. This combines Nicira Extended match with the ability to place a flow in a specific table. Open vSwitch 1.2 and later supports this flow format. +. +.IP "\fBOXM-OpenFlow12\fR" +.IQ "\fBOXM-OpenFlow13\fR" +These are the standard OXM (OpenFlow Extensible Match) flow format in +OpenFlow 1.2 and 1.3, respectively. .RE . .IP @@ -1368,6 +1387,8 @@ Any supported flow format. \fBOpenFlow10\-table_id\fR or \fBOpenFlow10+table_id\fR. .IP "\fBNXM\fR" \fBNXM\-table_id\fR or \fBNXM+table_id\fR. +.IP "\fBOXM\fR" +\fBOXM-OpenFlow12\fR or \fBOXM-OpenFlow13\fR. .RE . .IP