X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=utilities%2Fovs-ofctl.8.in;h=2a20a2f4d9302cc209dc6d83a629c3d47e3fa7cd;hb=fe4a02e4fa6be030a0478f6b01b0d4b6ab9b808f;hp=2bf374034a68051f6ada4746f93d2341aa111924;hpb=fa8223b7fd02890647eb2bf3d3b5b27ee4d32a21;p=openvswitch diff --git a/utilities/ovs-ofctl.8.in b/utilities/ovs-ofctl.8.in index 2bf37403..2a20a2f4 100644 --- a/utilities/ovs-ofctl.8.in +++ b/utilities/ovs-ofctl.8.in @@ -81,6 +81,13 @@ system. Disables the interface. This is equivalent to ``ifconfig down'' on a Unix system. . +.IP \fBforward\fR +Allows forwarding of traffic on this interface. This is the default posture +for all ports. +. +.IP \fBnoforward\fR +Disallows forwarding of traffic on this interface. +. .IP \fBflood\fR When a \fIflood\fR action is specified, traffic will be sent out this interface. This is the default posture for monitored ports. @@ -139,7 +146,7 @@ Prints to the console aggregate statistics for flows in \fIswitch\fR's tables that match \fIflows\fR. If \fIflows\fR is omitted, the statistics are aggregated across all flows in the switch's flow tables. See \fBFlow Syntax\fR, below, for the syntax of \fIflows\fR. -The output format is descrbed in \fBTable Entry Output\fR. +The output format is described in \fBTable Entry Output\fR. . .IP "\fBqueue\-stats \fIswitch \fR[\fIport \fR[\fIqueue\fR]]" Prints to the console statistics for the specified \fIqueue\fR on @@ -236,7 +243,7 @@ If a switch has no controller configured, or if the configured controller is disconnected, no traffic is sent, so monitoring will not show any traffic. . -.IP "\fBmonitor \fIswitch\fR [\fImiss-len\fR]" +.IP "\fBmonitor \fIswitch\fR [\fImiss-len\fR] [\fIinvalid_ttl\fR]" Connects to \fIswitch\fR and prints to the console all OpenFlow messages received. Usually, \fIswitch\fR should specify the name of a bridge in the \fBovs\-vswitchd\fR database. @@ -249,6 +256,13 @@ does not send these and other asynchronous messages to an specified on this argument. (Thus, if \fImiss\-len\fR is not specified, very little traffic will ordinarily be printed.) .IP +.IP +If \fBinvalid_ttl\fR is passed, \fBovs\-ofctl\fR sends an OpenFlow ``set +configuration'' message at connection setup time that requests +\fIINVALID_TTL_TO_CONTROLLER\fR, so that \fBovs\-ofctl monitor\fR can +receive ``packets-in'' messages when TTL reaches zero on \fBdec_ttl\fR action. +.IP + This command may be useful for debugging switch or controller implementations. . @@ -408,6 +422,23 @@ When \fBdl_type\fR is wildcarded or set to a value other than 0x0800 or 0x86dd, the value of \fBnw_tos\fR is ignored (see \fBFlow Syntax\fR above). . +.IP \fBnw_ecn=\fIecn\fR +Matches \fIecn\fR bits in IP ToS or IPv6 traffic class fields, which is +specified as a decimal number between 0 and 3, inclusive. +.IP +When \fBdl_type\fR is wildcarded or set to a value other than 0x0800 or +0x86dd, the value of \fBnw_ecn\fR is ignored (see \fBFlow Syntax\fR +above). +. +.IP \fBnw_ttl=\fIttl\fR +Matches IP TTL or IPv6 hop limit value \fIttl\fR, which is +specified as a decimal number between 0 and 255, inclusive. +.IP +When \fBdl_type\fR is wildcarded or set to a value other than 0x0800 or +0x86dd, the value of \fBnw_ttl\fR is ignored (see \fBFlow Syntax\fR +above). +.IP +. .IP \fBtp_src=\fIport\fR .IQ \fBtp_dst=\fIport\fR When \fBdl_type\fR and \fBnw_proto\fR specify TCP or UDP, \fBtp_src\fR @@ -430,10 +461,10 @@ these settings are ignored (see \fBFlow Syntax\fR above). . .IP \fBtable=\fInumber\fR If specified, limits the flow manipulation and flow dump commands to -only apply to the table with the given \fInumber\fR. -\fInumber\fR is a number between 0 and 254, inclusive. +only apply to the table with the given \fInumber\fR between 0 and 254. . -Behavior varies if \fBtable\fR is not specified. For flow table +Behavior varies if \fBtable\fR is not specified (equivalent to +specifying 255 as \fInumber\fR). For flow table modification commands without \fB\-\-strict\fR, the switch will choose the table for these commands to operate on. For flow table modification commands with \fB\-\-strict\fR, the command will operate @@ -475,7 +506,7 @@ will report a fatal error. .IP \fBvlan_tci=\fItci\fR[\fB/\fImask\fR] Matches modified VLAN TCI \fItci\fR. If \fImask\fR is omitted, \fItci\fR is the exact VLAN TCI to match; if \fImask\fR is specified, -then a 1-bit in \fItci\fR indicates that the corresponding bit in +then a 1-bit in \fImask\fR indicates that the corresponding bit in \fItci\fR must match exactly, and a 0-bit wildcards that bit. Both \fItci\fR and \fImask\fR are 16-bit values that are decimal by default; use a \fB0x\fR prefix to specify them in hexadecimal. @@ -713,7 +744,7 @@ Sets the TCP or UDP source port to \fIport\fR. Sets the TCP or UDP destination port to \fIport\fR. . .IP \fBmod_nw_tos\fB:\fItos\fR -Sets the IP ToS/DSCP field to \fItos\fR. Valid values are between 0 and +Sets the IPv4 ToS/DSCP field to \fItos\fR. Valid values are between 0 and 255, inclusive. Note that the two lower reserved bits are never modified. . @@ -754,6 +785,16 @@ OpenFlow implementations do not support queuing at all. Restores the queue to the value it was before any \fBset_queue\fR actions were applied. . +.IP \fBdec_ttl\fR +Decrement TTL of IPv4 packet or hop limit of IPv6 packet. If the +TTL or hop limit is initially zero, no decrement occurs. Instead, +a ``packet-in'' message with reason code \fBOFPR_INVALID_TTL\fR is +sent to each connected controller that has enabled receiving them, +if any. Processing the current set of actions then stops. +However, if the current set of actions was reached through +``resubmit'' then remaining actions in outer levels resume +processing. +. .IP \fBnote:\fR[\fIhh\fR]... Does nothing at all. Any number of bytes represented as hex digits \fIhh\fR may be included. Pairs of hex digits may be separated by @@ -909,15 +950,22 @@ further actions, including those which may be in other tables, or different levels of the \fBresubmit\fR call stack, are ignored. . .PP -The \fBadd\-flow\fR, \fBadd\-flows\fR, and \fBmod\-flows\fR commands -support an additional optional field: +An opaque identifier called a cookie can be used as a handle to identify +a set of flows: . -.IP \fBcookie=\fIvalue\fR +.IP \fBcookie=\fIvalue\fR[\fB/\fImask\fR] . -A cookie is an opaque identifier that can be associated with the flow. -\fIvalue\fR can be any 64-bit number and need not be unique among -flows. If this field is omitted, these commands set a default cookie -value of 0. +A cookie can be associated with a flow using the \fBadd-flow\fR and +\fBadd-flows\fR commands. \fIvalue\fR can be any 64-bit number and need +not be unique among flows. If this field is omitted, a default cookie +value of 0 is used. +.IP +When using NXM, the cookie can be used as a handle for querying, +modifying, and deleting flows. In addition to \fIvalue\fR, an optional +\fImask\fR may be supplied for the \fBdel-flows\fR, \fBmod-flows\fR, +\fBdump-flows\fR, and \fBdump-aggregate\fR commands to limit matching +cookies. A 1-bit in \fImask\fR indicates that the corresponding bit in +\fIcookie\fR must match exactly, and a 0-bit wildcards that bit. . .PP The following additional field sets the priority for flows added by @@ -1018,16 +1066,49 @@ above table, overrides \fBovs\-ofctl\fR's default choice of flow format. If a command cannot work as requested using the requested flow format, \fBovs\-ofctl\fR will report a fatal error. . +. +.IP "\fB\-P \fIformat\fR" +.IQ "\fB\-\-packet\-in\-format=\fIformat\fR" +\fBovs\-ofctl\fR supports the following packet_in formats, in order of +increasing capability: +.RS +.IP "\fBopenflow10\fR" +This is the standard OpenFlow 1.0 packet in format. It should be supported by +all OpenFlow switches. +. +.IP "\fBnxm\fR (Nicira Extended Match)" +This packet_in format includes flow metadata encoded using the NXM format. +. +.RE +.IP +Usually, \fBovs\-ofctl\fR prefers the \fBnxm\fR packet_in format, but will +allow the switch to choose its default if \fBnxm\fR is unsupported. When +\fIformat\fR is one of the formats listed in the above table, \fBovs\-ofctl\fR +will insist on the selected format. If the switch does not support the +requested format, \fBovs\-ofctl\fR will report a fatal error. This option only +affects the \fBmonitor\fR and \fBsnoop\fR commands. +. .IP "\fB\-m\fR" .IQ "\fB\-\-more\fR" Increases the verbosity of OpenFlow messages printed and logged by \fBovs\-ofctl\fR commands. Specify this option more than once to increase verbosity further. +. +.ds DD \ +\fBovs\-ofctl\fR detaches only when executing the \fBmonitor\fR or \ +\fBsnoop\fR commands. +.so lib/daemon.man .SS "Public Key Infrastructure Options" .so lib/ssl.man .so lib/vlog.man .so lib/common.man . +.SH "RUNTIME MANAGEMENT COMMANDS" +\fBovs\-appctl\fR(8) can send commands to a running \fBovs\-ofctl\fR process. +The currently supported commands only apply when executing the \fBmonitor\fR or +\fBsnoop\fR commands and are described below. +.IP "\fBexit\fR" +Causes \fBovs\-ofctl\fR to gracefully terminate. .SH EXAMPLES . The following examples assume that \fBovs\-vswitchd\fR has a bridge