/* Copyright (c) 2008 The Board of Trustees of The Leland Stanford * Junior University * * We are making the OpenFlow specification and associated documentation * (Software) available for public use and benefit with the expectation * that others will use, modify and enhance the Software and contribute * those enhancements back to the community. However, since we would * like to make the Software available for broadest use, with as few * restrictions as possible permission is hereby granted, free of * charge, to any person obtaining a copy of this Software to deal in * the Software under the copyrights without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. * * The name and trademarks of copyright holder(s) may NOT be used in * advertising or publicity pertaining to the Software or any * derivatives without specific, written prior permission. */ /* OpenFlow: protocol between controller and datapath. */ #ifndef OPENFLOW_OPENFLOW_H #define OPENFLOW_OPENFLOW_H 1 #ifdef __KERNEL__ #include #else #include #endif #ifdef SWIG #define OFP_ASSERT(EXPR) /* SWIG can't handle OFP_ASSERT. */ #elif !defined(__cplusplus) /* Build-time assertion for use in a declaration context. */ #define OFP_ASSERT(EXPR) \ extern int (*build_assert(void))[ sizeof(struct { \ unsigned int build_assert_failed : (EXPR) ? 1 : -1; })] #else /* __cplusplus */ #define OFP_ASSERT(_EXPR) typedef int build_assert_failed[(_EXPR) ? 1 : -1] #endif /* __cplusplus */ #ifndef SWIG #define OFP_PACKED __attribute__((packed)) #else #define OFP_PACKED /* SWIG doesn't understand __attribute. */ #endif /* Version number: * Non-experimental versions released: 0x01 = 1.0 ; 0x02 = 1.1 ; 0x03 = 1.2 * Experimental versions released: 0x81 -- 0x99 */ /* The most significant bit being set in the version field indicates an * experimental OpenFlow version. */ #define OFP_VERSION 0x03 #define OFP_MAX_TABLE_NAME_LEN 32 #define OFP_MAX_PORT_NAME_LEN 16 #define OFP_TCP_PORT 6633 #define OFP_SSL_PORT 6633 #define OFP_ETH_ALEN 6 /* Bytes in an Ethernet address. */ /* Port numbering. Ports are numbered starting from 1. */ enum ofp_port_no { /* Maximum number of physical switch ports. */ OFPP_MAX = 0xffffff00, /* Fake output "ports". */ OFPP_IN_PORT = 0xfffffff8, /* Send the packet out the input port. This virtual port must be explicitly used in order to send back out of the input port. */ OFPP_TABLE = 0xfffffff9, /* Submit the packet to the first flow table NB: This destination port can only be used in packet-out messages. */ OFPP_NORMAL = 0xfffffffa, /* Process with normal L2/L3 switching. */ OFPP_FLOOD = 0xfffffffb, /* All physical ports in VLAN, except input port and those blocked or link down. */ OFPP_ALL = 0xfffffffc, /* All physical ports except input port. */ OFPP_CONTROLLER = 0xfffffffd, /* Send to controller. */ OFPP_LOCAL = 0xfffffffe, /* Local openflow "port". */ OFPP_ANY = 0xffffffff /* Wildcard port used only for flow mod (delete) and flow stats requests. Selects all flows regardless of output port (including flows with no output port). */ }; enum ofp_type { /* Immutable messages. */ OFPT_HELLO, /* Symmetric message */ OFPT_ERROR, /* Symmetric message */ OFPT_ECHO_REQUEST, /* Symmetric message */ OFPT_ECHO_REPLY, /* Symmetric message */ OFPT_EXPERIMENTER, /* Symmetric message */ /* Switch configuration messages. */ OFPT_FEATURES_REQUEST, /* Controller/switch message */ OFPT_FEATURES_REPLY, /* Controller/switch message */ OFPT_GET_CONFIG_REQUEST, /* Controller/switch message */ OFPT_GET_CONFIG_REPLY, /* Controller/switch message */ OFPT_SET_CONFIG, /* Controller/switch message */ /* Asynchronous messages. */ OFPT_PACKET_IN, /* Async message */ OFPT_FLOW_REMOVED, /* Async message */ OFPT_PORT_STATUS, /* Async message */ /* Controller command messages. */ OFPT_PACKET_OUT, /* Controller/switch message */ OFPT_FLOW_MOD, /* Controller/switch message */ OFPT_GROUP_MOD, /* Controller/switch message */ OFPT_PORT_MOD, /* Controller/switch message */ OFPT_TABLE_MOD, /* Controller/switch message */ /* Statistics messages. */ OFPT_STATS_REQUEST, /* Controller/switch message */ OFPT_STATS_REPLY, /* Controller/switch message */ /* Barrier messages. */ OFPT_BARRIER_REQUEST, /* Controller/switch message */ OFPT_BARRIER_REPLY, /* Controller/switch message */ /* Queue Configuration messages. */ OFPT_QUEUE_GET_CONFIG_REQUEST, /* Controller/switch message */ OFPT_QUEUE_GET_CONFIG_REPLY, /* Controller/switch message */ }; /* Header on all OpenFlow packets. */ struct ofp_header { uint8_t version; /* OFP_VERSION. */ uint8_t type; /* One of the OFPT_ constants. */ uint16_t length; /* Length including this ofp_header. */ uint32_t xid; /* Transaction id associated with this packet. Replies use the same id as was in the request to facilitate pairing. */ }; OFP_ASSERT(sizeof(struct ofp_header) == 8); /* OFPT_HELLO. This message has an empty body, but implementations must * ignore any data included in the body, to allow for future extensions. */ struct ofp_hello { struct ofp_header header; }; #define OFP_DEFAULT_MISS_SEND_LEN 128 enum ofp_config_flags { /* Handling of IP fragments. */ OFPC_FRAG_NORMAL = 0, /* No special handling for fragments. */ OFPC_FRAG_DROP = 1 << 0, /* Drop fragments. */ OFPC_FRAG_REASM = 1 << 1, /* Reassemble (only if OFPC_IP_REASM set). */ OFPC_FRAG_MASK = 3, /* TTL processing - applicable for IP and MPLS packets */ OFPC_INVALID_TTL_TO_CONTROLLER = 1 << 2, /* Send packets with invalid TTL ie. 0 or 1 to controller */ }; /* Switch configuration. */ struct ofp_switch_config { struct ofp_header header; uint16_t flags; /* OFPC_* flags. */ uint16_t miss_send_len; /* Max bytes of new flow that datapath should send to the controller. */ }; OFP_ASSERT(sizeof(struct ofp_switch_config) == 12); /* Flags to indicate behavior of the flow table for unmatched packets. These flags are used in ofp_table_stats messages to describe the current configuration and in ofp_table_mod messages to configure table behavior. */ enum ofp_table_config { OFPTC_TABLE_MISS_CONTROLLER = 0, /* Send to controller. */ OFPTC_TABLE_MISS_CONTINUE = 1 << 0, /* Continue to the next table in the pipeline (OpenFlow 1.0 behavior). */ OFPTC_TABLE_MISS_DROP = 1 << 1, /* Drop the packet. */ OFPTC_TABLE_MISS_MASK = 3 }; /* Table numbering. Tables can use any number up to OFPT_MAX. */ enum ofp_table { /* Last usable table number. */ OFPTT_MAX = 0xfe, /* Fake tables. */ OFPTT_ALL = 0xff /* Wildcard table used for table config, flow stats and flow deletes. */ }; /* Configure/Modify behavior of a flow table */ struct ofp_table_mod { struct ofp_header header; uint8_t table_id; /* ID of the table, OFPTT_ALL indicates all tables */ uint8_t pad[3]; /* Pad to 32 bits */ uint32_t config; /* Bitmap of OFPTC_* flags */ }; OFP_ASSERT(sizeof(struct ofp_table_mod) == 16); /* Capabilities supported by the datapath. */ enum ofp_capabilities { OFPC_FLOW_STATS = 1 << 0, /* Flow statistics. */ OFPC_TABLE_STATS = 1 << 1, /* Table statistics. */ OFPC_PORT_STATS = 1 << 2, /* Port statistics. */ OFPC_GROUP_STATS = 1 << 3, /* Group statistics. */ OFPC_IP_REASM = 1 << 5, /* Can reassemble IP fragments. */ OFPC_QUEUE_STATS = 1 << 6, /* Queue statistics. */ OFPC_ARP_MATCH_IP = 1 << 7, /* Match IP addresses in ARP pkts. */ OFPC_PORT_BLOCKED = 1 << 8 /* Switch will block looping ports. */ }; /* Flags to indicate behavior of the physical port. These flags are * used in ofp_port to describe the current configuration. They are * used in the ofp_port_mod message to configure the port's behavior. */ enum ofp_port_config { OFPPC_PORT_DOWN = 1 << 0, /* Port is administratively down. */ OFPPC_NO_RECV = 1 << 2, /* Drop all packets received by port. */ OFPPC_NO_FWD = 1 << 5, /* Drop packets forwarded to port. */ OFPPC_NO_PACKET_IN = 1 << 6 /* Do not send packet-in msgs for port. */ }; /* Current state of the physical port. These are not configurable from * the controller. */ enum ofp_port_state { OFPPS_LINK_DOWN = 1 << 0, /* No physical link present. */ OFPPS_BLOCKED = 1 << 1, /* Port is blocked */ OFPPS_LIVE = 1 << 2, /* Live for Fast Failover Group. */ }; /* Features of ports available in a datapath. */ enum ofp_port_features { OFPPF_10MB_HD = 1 << 0, /* 10 Mb half-duplex rate support. */ OFPPF_10MB_FD = 1 << 1, /* 10 Mb full-duplex rate support. */ OFPPF_100MB_HD = 1 << 2, /* 100 Mb half-duplex rate support. */ OFPPF_100MB_FD = 1 << 3, /* 100 Mb full-duplex rate support. */ OFPPF_1GB_HD = 1 << 4, /* 1 Gb half-duplex rate support. */ OFPPF_1GB_FD = 1 << 5, /* 1 Gb full-duplex rate support. */ OFPPF_10GB_FD = 1 << 6, /* 10 Gb full-duplex rate support. */ OFPPF_40GB_FD = 1 << 7, /* 40 Gb full-duplex rate support. */ OFPPF_100GB_FD = 1 << 8, /* 100 Gb full-duplex rate support. */ OFPPF_1TB_FD = 1 << 9, /* 1 Tb full-duplex rate support. */ OFPPF_OTHER = 1 << 10, /* Other rate, not in the list. */ OFPPF_COPPER = 1 << 11, /* Copper medium. */ OFPPF_FIBER = 1 << 12, /* Fiber medium. */ OFPPF_AUTONEG = 1 << 13, /* Auto-negotiation. */ OFPPF_PAUSE = 1 << 14, /* Pause. */ OFPPF_PAUSE_ASYM = 1 << 15 /* Asymmetric pause. */ }; /* Description of a port */ struct ofp_port { uint32_t port_no; uint8_t pad[4]; uint8_t hw_addr[OFP_ETH_ALEN]; uint8_t pad2[2]; /* Align to 64 bits. */ char name[OFP_MAX_PORT_NAME_LEN]; /* Null-terminated */ uint32_t config; /* Bitmap of OFPPC_* flags. */ uint32_t state; /* Bitmap of OFPPS_* flags. */ /* Bitmaps of OFPPF_* that describe features. All bits zeroed if * unsupported or unavailable. */ uint32_t curr; /* Current features. */ uint32_t advertised; /* Features being advertised by the port. */ uint32_t supported; /* Features supported by the port. */ uint32_t peer; /* Features advertised by peer. */ uint32_t curr_speed; /* Current port bitrate in kbps. */ uint32_t max_speed; /* Max port bitrate in kbps */ }; OFP_ASSERT(sizeof(struct ofp_port) == 64); /* Switch features. */ struct ofp_switch_features { struct ofp_header header; uint64_t datapath_id; /* Datapath unique ID. The lower 48-bits are for a MAC address, while the upper 16-bits are implementer-defined. */ uint32_t n_buffers; /* Max packets buffered at once. */ uint8_t n_tables; /* Number of tables supported by datapath. */ uint8_t pad[3]; /* Align to 64-bits. */ /* Features. */ uint32_t capabilities; /* Bitmap of support "ofp_capabilities". */ uint32_t reserved; /* Port info.*/ struct ofp_port ports[0]; /* Port definitions. The number of ports is inferred from the length field in the header. */ }; OFP_ASSERT(sizeof(struct ofp_switch_features) == 32); /* What changed about the physical port */ enum ofp_port_reason { OFPPR_ADD, /* The port was added. */ OFPPR_DELETE, /* The port was removed. */ OFPPR_MODIFY /* Some attribute of the port has changed. */ }; /* A physical port has changed in the datapath */ struct ofp_port_status { struct ofp_header header; uint8_t reason; /* One of OFPPR_*. */ uint8_t pad[7]; /* Align to 64-bits. */ struct ofp_port desc; }; OFP_ASSERT(sizeof(struct ofp_port_status) == 80); /* Modify behavior of the physical port */ struct ofp_port_mod { struct ofp_header header; uint32_t port_no; uint8_t pad[4]; uint8_t hw_addr[OFP_ETH_ALEN]; /* The hardware address is not configurable. This is used to sanity-check the request, so it must be the same as returned in an ofp_port struct. */ uint8_t pad2[2]; /* Pad to 64 bits. */ uint32_t config; /* Bitmap of OFPPC_* flags. */ uint32_t mask; /* Bitmap of OFPPC_* flags to be changed. */ uint32_t advertise; /* Bitmap of OFPPF_*. Zero all bits to prevent any action taking place. */ uint8_t pad3[4]; /* Pad to 64 bits. */ }; OFP_ASSERT(sizeof(struct ofp_port_mod) == 40); /* ## -------------------------- ## */ /* ## OpenFlow Extensible Match. ## */ /* ## -------------------------- ## */ /* The match type indicates the match structure (set of fields that compose the * match) in use. The match type is placed in the type field at the beginning * of all match structures. The "OpenFlow Extensible Match" type corresponds * to OXM TLV format described below and must be supported by all OpenFlow * switches. Extensions that define other match types may be published on the * OpenFlow wiki. Support for extensions is optional. */ enum ofp_match_type { OFPMT_STANDARD, /* Deprecated. */ OFPMT_OXM, /* OpenFlow Extensible Match */ }; /* Fields to match against flows */ struct ofp_match { uint16_t type; /* One of OFPMT_* */ uint16_t length; /* Length of ofp_match (excluding padding) */ /* Followed by: * - Exactly (match_len - 4) (possibly 0) bytes containing OXM TLVs, then * - Exactly (match_len + 7)/8*8 - match_len (between 0 and 7) bytes of * all-zero bytes */ uint8_t oxm_fields[4]; /* OXMs start here - Make compiler happy */ }; OFP_ASSERT(sizeof(struct ofp_match) == 8); /* Components of a OXM TLV header. */ #define OXM_HEADER__(CLASS, FIELD, HASMASK, LENGTH) \ (((CLASS) << 16) | ((FIELD) << 9) | ((HASMASK) << 8) | (LENGTH)) #define OXM_HEADER(CLASS, FIELD, LENGTH) \ OXM_HEADER__(CLASS, FIELD, 0, LENGTH) #define OXM_HEADER_W(CLASS, FIELD, LENGTH) \ OXM_HEADER__(CLASS, FIELD, 1, (LENGTH) * 2) #define OXM_CLASS(HEADER) ((HEADER) >> 16) #define OXM_FIELD(HEADER) (((HEADER) >> 9) & 0x7f) #define OXM_TYPE(HEADER) (((HEADER) >> 9) & 0x7fffff) #define OXM_HASMASK(HEADER) (((HEADER) >> 8) & 1) #define OXM_LENGTH(HEADER) ((HEADER) & 0xff) #define OXM_MAKE_WILD_HEADER(HEADER) \ OXM_HEADER_W(OXM_CLASS(HEADER), OXM_FIELD(HEADER), OXM_LENGTH(HEADER)) /* OXM Class IDs. * The high order bit differentiate ONF from member classes. * Classes 0x0000 to 0x7FFF are member classes, allocated by ONF. * Classes 0x8000 to 0xFFFE are ONF classes, reserved for ONF standardisation. */ enum ofp_oxm_class { OFPXMC_NXM_0 = 0x0000, /* Backward compatibility with NXM */ OFPXMC_NXM_1 = 0x0001, /* Backward compatibility with NXM */ OFPXMC_OPENFLOW_BASIC = 0x8000, /* Basic class for OpenFlow */ OFPXMC_EXPERIMENTER = 0xFFFF, /* Experimenter class */ }; /* OXM Flow match field types for OpenFlow basic class. */ enum oxm_ofb_match_fields { OFPXMT_OFB_IN_PORT = 0, /* Switch input port. */ OFPXMT_OFB_IN_PHY_PORT = 1, /* Switch physical input port. */ OFPXMT_OFB_METADATA = 2, /* Metadata passed between tables. */ OFPXMT_OFB_ETH_DST = 3, /* Ethernet destination address. */ OFPXMT_OFB_ETH_SRC = 4, /* Ethernet source address. */ OFPXMT_OFB_ETH_TYPE = 5, /* Ethernet frame type. */ OFPXMT_OFB_VLAN_VID = 6, /* VLAN id. */ OFPXMT_OFB_VLAN_PCP = 7, /* VLAN priority. */ OFPXMT_OFB_IP_TOS = 8, /* IP ToS (DSCP field, 6 bits). */ OFPXMT_OFB_IP_ECN = 9, /* IP ECN bits (2 bits). */ OFPXMT_OFB_IP_PROTO = 10, /* IP protocol. */ OFPXMT_OFB_IPV4_SRC = 11, /* IPv4 source address. */ OFPXMT_OFB_IPV4_DST = 12, /* IPv4 destination address. */ OFPXMT_OFB_TCP_SRC = 13, /* TCP source port. */ OFPXMT_OFB_TCP_DST = 14, /* TCP destination port. */ OFPXMT_OFB_UDP_SRC = 15, /* UDP source port. */ OFPXMT_OFB_UDP_DST = 16, /* UDP destination port. */ OFPXMT_OFB_SCTP_SRC = 17, /* SCTP source port. */ OFPXMT_OFB_SCTP_DST = 18, /* SCTP destination port. */ OFPXMT_OFB_ICMPV4_TYPE = 19, /* ICMP type. */ OFPXMT_OFB_ICMPV4_CODE = 20, /* ICMP code. */ OFPXMT_OFB_ARP_OP = 21, /* ARP opcode. */ OFPXMT_OFB_ARP_SPA = 22, /* ARP source IPv4 address. */ OFPXMT_OFB_ARP_TPA = 23, /* ARP target IPv4 address. */ OFPXMT_OFB_ARP_SHA = 24, /* ARP source hardware address. */ OFPXMT_OFB_ARP_THA = 25, /* ARP target hardware address. */ OFPXMT_OFB_IPV6_SRC = 26, /* IPv6 source address. */ OFPXMT_OFB_IPV6_DST = 27, /* IPv6 destination address. */ OFPXMT_OFB_ICMPV6_TYPE = 29, /* ICMP type. */ OFPXMT_OFB_ICMPV6_CODE = 30, /* ICMP code. */ OFPXMT_OFB_IPV6_ND_TARGET = 31, /* Target address for ND. */ OFPXMT_OFB_IPV6_ND_SLL = 32, /* Source link-layer for ND. */ OFPXMT_OFB_IPV6_ND_TLL = 33, /* Target link-layer for ND. */ OFPXMT_OFB_MPLS_LABEL = 34, /* MPLS label. */ OFPXMT_OFB_MPLS_TC = 35, /* MPLS TC. */ }; #define OFPXMT_OFB_ALL ((UINT64_C(1) << 36) - 1) /* Physical or virtual port on which the packet was received. * * Prereqs: None. * * Format: 32-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_IN_PORT OXM_HEADER (0x8000, OFPXMT_OFB_IN_PORT, 4) /* Physical port on which the packet was received. * * Consider a packet received on a tunnel interface defined over a link * aggregation group (LAG) with two physical port members. If the tunnel * interface is the virtual port bound to OpenFlow. In this case, * OFPXMT_OF_IN_PORT is the tunnel's port number and OFPXMT_OF_IN_PHY_PORT is * the physical port number of the LAG on which the tunnel is configured. * * When a packet is received directly on a physical port and not processed by a * virtual port, OFPXMT_OF_IN_PORT and OFPXMT_OF_IN_PHY_PORT have the same * value. * * This field is usually not available in a regular match and only available * in ofp_packet_in messages when it's different from OXM_OF_IN_PORT. * * Prereqs: None. * * Format: 32-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_IN_PHY_PORT OXM_HEADER (0x8000, OFPXMT_OFB_IN_PHY_PORT, 4) /* Table metadata. * * Prereqs: None. * * Format: 64-bit integer in network byte order. * * Masking: Arbitrary masks. */ #define OXM_OF_METADATA OXM_HEADER (0x8000, OFPXMT_OFB_METADATA, 8) #define OXM_OF_METADATA_W OXM_HEADER_W(0x8000, OFPXMT_OFB_METADATA, 8) /* Source or destination address in Ethernet header. * * Prereqs: None. * * Format: 48-bit Ethernet MAC address. * * Masking: Arbitrary masks. */ #define OXM_OF_ETH_DST OXM_HEADER (0x8000, OFPXMT_OFB_ETH_DST, 6) #define OXM_OF_ETH_DST_W OXM_HEADER_W(0x8000, OFPXMT_OFB_ETH_DST, 6) #define OXM_OF_ETH_SRC OXM_HEADER (0x8000, OFPXMT_OFB_ETH_SRC, 6) #define OXM_OF_ETH_SRC_W OXM_HEADER_W(0x8000, OFPXMT_OFB_ETH_SRC, 6) /* Packet's Ethernet type. * * Prereqs: None. * * Format: 16-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_ETH_TYPE OXM_HEADER (0x8000, OFPXMT_OFB_ETH_TYPE, 2) /* The VLAN id is 12-bits, so we can use the entire 16 bits to indicate * special conditions. */ enum ofp_vlan_id { OFPVID_PRESENT = 0x1000, /* Bit that indicate that a VLAN id is set */ OFPVID_NONE = 0x0000, /* No VLAN id was set. */ }; /* Define for compatibility */ #define OFP_VLAN_NONE OFPVID_NONE /* 802.1Q VID. * * For a packet with an 802.1Q header, this is the VLAN-ID (VID) from the * outermost tag, with the CFI bit forced to 1. For a packet with no 802.1Q * header, this has value OFPVID_NONE. * * Prereqs: None. * * Format: 16-bit integer in network byte order with bit 13 indicating * presence of VLAN header and 3 most-significant bits forced to 0. * Only the lower 13 bits have meaning. * * Masking: Arbitrary masks. * * This field can be used in various ways: * * - If it is not constrained at all, the nx_match matches packets without * an 802.1Q header or with an 802.1Q header that has any VID value. * * - Testing for an exact match with 0x0 matches only packets without * an 802.1Q header. * * - Testing for an exact match with a VID value with CFI=1 matches packets * that have an 802.1Q header with a specified VID. * * - Testing for an exact match with a nonzero VID value with CFI=0 does * not make sense. The switch may reject this combination. * * - Testing with nxm_value=0, nxm_mask=0x0fff matches packets with no 802.1Q * header or with an 802.1Q header with a VID of 0. * * - Testing with nxm_value=0x1000, nxm_mask=0x1000 matches packets with * an 802.1Q header that has any VID value. */ #define OXM_OF_VLAN_VID OXM_HEADER (0x8000, OFPXMT_OFB_VLAN_VID, 2) #define OXM_OF_VLAN_VID_W OXM_HEADER_W(0x8000, OFPXMT_OFB_VLAN_VID, 2) /* 802.1Q PCP. * * For a packet with an 802.1Q header, this is the VLAN-PCP from the * outermost tag. For a packet with no 802.1Q header, this has value * 0. * * Prereqs: OXM_OF_VLAN_VID must be different from OFPVID_NONE. * * Format: 8-bit integer with 5 most-significant bits forced to 0. * Only the lower 3 bits have meaning. * * Masking: Not maskable. */ #define OXM_OF_VLAN_PCP OXM_HEADER (0x8000, OFPXMT_OFB_VLAN_PCP, 1) /* The "type of service" byte of the IP header, with the ECN bits forced to 0. * This is actually the DSCP value part of the IPv4 ToS field or the * IPv6 Traffic Class field. * * Prereqs: OXM_OF_ETH_TYPE must be either 0x0800 or 0x86dd. * * Format: 8-bit integer with 2 least-significant bits forced to 0. * Only the higher 6 bits have meaning. * * Masking: Not maskable. */ #define OXM_OF_IP_TOS OXM_HEADER (0x8000, OFPXMT_OFB_IP_TOS, 1) /* The ECN bits of the IP header. * Part of the IPv4 ToS field or the IPv6 Traffic Class field. * * Prereqs: OXM_OF_ETH_TYPE must be either 0x0800 or 0x86dd. * * Format: 8-bit integer with 6 most-significant bits forced to 0. * Only the lower 2 bits have meaning. * * Masking: Not maskable. */ #define OXM_OF_IP_ECN OXM_HEADER (0x8000, OFPXMT_OFB_IP_ECN, 1) /* The "protocol" byte in the IP header. * * Prereqs: OXM_OF_ETH_TYPE must be either 0x0800 or 0x86dd. * * Format: 8-bit integer. * * Masking: Not maskable. */ #define OXM_OF_IP_PROTO OXM_HEADER (0x8000, OFPXMT_OFB_IP_PROTO, 1) /* The source or destination address in the IP header. * * Prereqs: OXM_OF_ETH_TYPE must match 0x0800 exactly. * * Format: 32-bit integer in network byte order. * * Masking: Arbitrary masks. */ #define OXM_OF_IPV4_SRC OXM_HEADER (0x8000, OFPXMT_OFB_IPV4_SRC, 4) #define OXM_OF_IPV4_SRC_W OXM_HEADER_W(0x8000, OFPXMT_OFB_IPV4_SRC, 4) #define OXM_OF_IPV4_DST OXM_HEADER (0x8000, OFPXMT_OFB_IPV4_DST, 4) #define OXM_OF_IPV4_DST_W OXM_HEADER_W(0x8000, OFPXMT_OFB_IPV4_DST, 4) /* The source or destination port in the TCP header. * * Prereqs: * OXM_OF_ETH_TYPE must be either 0x0800 or 0x86dd. * OXM_OF_IP_PROTO must match 6 exactly. * * Format: 16-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_TCP_SRC OXM_HEADER (0x8000, OFPXMT_OFB_TCP_SRC, 2) #define OXM_OF_TCP_DST OXM_HEADER (0x8000, OFPXMT_OFB_TCP_DST, 2) /* The source or destination port in the UDP header. * * Prereqs: * OXM_OF_ETH_TYPE must match either 0x0800 or 0x86dd. * OXM_OF_IP_PROTO must match 17 exactly. * * Format: 16-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_UDP_SRC OXM_HEADER (0x8000, OFPXMT_OFB_UDP_SRC, 2) #define OXM_OF_UDP_DST OXM_HEADER (0x8000, OFPXMT_OFB_UDP_DST, 2) /* The source or destination port in the SCTP header. * * Prereqs: * OXM_OF_ETH_TYPE must match either 0x0800 or 0x86dd. * OXM_OF_IP_PROTO must match 132 exactly. * * Format: 16-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_SCTP_SRC OXM_HEADER (0x8000, OFPXMT_OFB_SCTP_SRC, 2) #define OXM_OF_SCTP_DST OXM_HEADER (0x8000, OFPXMT_OFB_SCTP_DST, 2) /* The type or code in the ICMP header. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x0800 exactly. * OXM_OF_IP_PROTO must match 1 exactly. * * Format: 8-bit integer. * * Masking: Not maskable. */ #define OXM_OF_ICMPV4_TYPE OXM_HEADER (0x8000, OFPXMT_OFB_ICMPV4_TYPE, 1) #define OXM_OF_ICMPV4_CODE OXM_HEADER (0x8000, OFPXMT_OFB_ICMPV4_CODE, 1) /* ARP opcode. * * For an Ethernet+IP ARP packet, the opcode in the ARP header. Always 0 * otherwise. * * Prereqs: OXM_OF_ETH_TYPE must match 0x0806 exactly. * * Format: 16-bit integer in network byte order. * * Masking: Not maskable. */ #define OXM_OF_ARP_OP OXM_HEADER (0x8000, OFPXMT_OFB_ARP_OP, 2) /* For an Ethernet+IP ARP packet, the source or target protocol address * in the ARP header. Always 0 otherwise. * * Prereqs: OXM_OF_ETH_TYPE must match 0x0806 exactly. * * Format: 32-bit integer in network byte order. * * Masking: Arbitrary masks. */ #define OXM_OF_ARP_SPA OXM_HEADER (0x8000, OFPXMT_OFB_ARP_SPA, 4) #define OXM_OF_ARP_SPA_W OXM_HEADER_W(0x8000, OFPXMT_OFB_ARP_SPA, 4) #define OXM_OF_ARP_TPA OXM_HEADER (0x8000, OFPXMT_OFB_ARP_TPA, 4) #define OXM_OF_ARP_TPA_W OXM_HEADER_W(0x8000, OFPXMT_OFB_ARP_TPA, 4) /* For an Ethernet+IP ARP packet, the source or target hardware address * in the ARP header. Always 0 otherwise. * * Prereqs: OXM_OF_ETH_TYPE must match 0x0806 exactly. * * Format: 48-bit Ethernet MAC address. * * Masking: Not maskable. */ #define OXM_OF_ARP_SHA OXM_HEADER (0x8000, OFPXMT_OFB_ARP_SHA, 6) #define OXM_OF_ARP_THA OXM_HEADER (0x8000, OFPXMT_OFB_ARP_THA, 6) /* The source or destination address in the IPv6 header. * * Prereqs: OXM_OF_ETH_TYPE must match 0x86dd exactly. * * Format: 128-bit IPv6 address. * * Masking: Arbitrary masks. */ #define OXM_OF_IPV6_SRC OXM_HEADER (0x8000, OFPXMT_OFB_IPV6_SRC, 16) #define OXM_OF_IPV6_SRC_W OXM_HEADER_W(0x8000, OFPXMT_OFB_IPV6_SRC, 16) #define OXM_OF_IPV6_DST OXM_HEADER (0x8000, OFPXMT_OFB_IPV6_DST, 16) #define OXM_OF_IPV6_DST_W OXM_HEADER_W(0x8000, OFPXMT_OFB_IPV6_DST, 16) /* The type or code in the ICMPv6 header. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x86dd exactly. * OXM_OF_IP_PROTO must match 58 exactly. * * Format: 8-bit integer. * * Masking: Not maskable. */ #define OXM_OF_ICMPV6_TYPE OXM_HEADER (0x8000, OFPXMT_OFB_ICMPV6_TYPE, 1) #define OXM_OF_ICMPV6_CODE OXM_HEADER (0x8000, OFPXMT_OFB_ICMPV6_CODE, 1) /* The target address in an IPv6 Neighbor Discovery message. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x86dd exactly. * OXM_OF_IP_PROTO must match 58 exactly. * OXM_OF_ICMPV6_TYPE must be either 135 or 136. * * Format: 128-bit IPv6 address. * * Masking: Not maskable. */ #define OXM_OF_IPV6_ND_TARGET OXM_HEADER (0x8000, OFPXMT_OFB_IPV6_ND_TARGET, 16) /* The source link-layer address option in an IPv6 Neighbor Discovery * message. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x86dd exactly. * OXM_OF_IP_PROTO must match 58 exactly. * OXM_OF_ICMPV6_TYPE must be exactly 135. * * Format: 48-bit Ethernet MAC address. * * Masking: Not maskable. */ #define OXM_OF_IPV6_ND_SLL OXM_HEADER (0x8000, OFPXMT_OFB_IPV6_ND_SLL, 6) /* The target link-layer address option in an IPv6 Neighbor Discovery * message. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x86dd exactly. * OXM_OF_IP_PROTO must match 58 exactly. * OXM_OF_ICMPV6_TYPE must be exactly 136. * * Format: 48-bit Ethernet MAC address. * * Masking: Not maskable. */ #define OXM_OF_IPV6_ND_TLL OXM_HEADER (0x8000, OFPXMT_OFB_IPV6_ND_TLL, 6) /* The LABEL in the first MPLS shim header. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x8847 or 0x8848 exactly. * * Format: 32-bit integer in network byte order with 12 most-significant * bits forced to 0. Only the lower 20 bits have meaning. * * Masking: Not maskable. */ #define OXM_OF_MPLS_LABEL OXM_HEADER (0x8000, OFPXMT_OFB_MPLS_LABEL, 4) /* The TC in the first MPLS shim header. * * Prereqs: * OXM_OF_ETH_TYPE must match 0x8847 or 0x8848 exactly. * * Format: 8-bit integer with 5 most-significant bits forced to 0. * Only the lower 3 bits have meaning. * * Masking: Not maskable. */ #define OXM_OF_MPLS_TC OXM_HEADER (0x8000, OFPXMT_OFB_MPLS_TC, 1) /* Header for OXM experimenter match fields. */ struct ofp_oxm_experimenter_header { uint32_t oxm_header; /* oxm_class = OFPXMC_EXPERIMENTER */ uint32_t experimenter; /* Experimenter ID which takes the same form as in struct ofp_experimenter_header. */ }; OFP_ASSERT(sizeof(struct ofp_oxm_experimenter_header) == 8); /* ## ----------------- ## */ /* ## OpenFlow Actions. ## */ /* ## ----------------- ## */ enum ofp_action_type { OFPAT_OUTPUT, /* Output to switch port. */ OFPAT_OBSOLETE_1, /* Obsolete. */ OFPAT_OBSOLETE_2, /* Obsolete. */ OFPAT_OBSOLETE_3, /* Obsolete. */ OFPAT_OBSOLETE_4, /* Obsolete. */ OFPAT_OBSOLETE_5, /* Obsolete. */ OFPAT_OBSOLETE_6, /* Obsolete. */ OFPAT_OBSOLETE_7, /* Obsolete. */ OFPAT_OBSOLETE_8, /* Obsolete. */ OFPAT_OBSOLETE_9, /* Obsolete. */ OFPAT_OBSOLETE_10, /* Obsolete. */ OFPAT_COPY_TTL_OUT, /* Copy TTL "outwards" -- from next-to-outermost to outermost */ OFPAT_COPY_TTL_IN, /* Copy TTL "inwards" -- from outermost to next-to-outermost */ OFPAT_OBSOLETE_11, /* Obsolete. */ OFPAT_OBSOLETE_12, /* Obsolete. */ OFPAT_SET_MPLS_TTL, /* MPLS TTL */ OFPAT_DEC_MPLS_TTL, /* Decrement MPLS TTL */ OFPAT_PUSH_VLAN, /* Push a new VLAN tag */ OFPAT_POP_VLAN, /* Pop the outer VLAN tag */ OFPAT_PUSH_MPLS, /* Push a new MPLS tag */ OFPAT_POP_MPLS, /* Pop the outer MPLS tag */ OFPAT_SET_QUEUE, /* Set queue id when outputting to a port */ OFPAT_GROUP, /* Apply group. */ OFPAT_SET_NW_TTL, /* IP TTL. */ OFPAT_DEC_NW_TTL, /* Decrement IP TTL. */ OFPAT_SET_FIELD, /* Set a match field using OXM TLV format. */ OFPAT_EXPERIMENTER = 0xffff }; /* Action structure for OFPAT_OUTPUT, which sends packets out 'port'. * When the 'port' is the OFPP_CONTROLLER, 'max_len' indicates the max * number of bytes to send. A 'max_len' of zero means no bytes of the * packet should be sent.*/ struct ofp_action_output { uint16_t type; /* OFPAT_OUTPUT. */ uint16_t len; /* Length is 16. */ uint32_t port; /* Output port. */ uint16_t max_len; /* Max length to send to controller. */ uint8_t pad[6]; /* Pad to 64 bits. */ }; OFP_ASSERT(sizeof(struct ofp_action_output) == 16); /* Action structure for OFPAT_SET_MPLS_TTL. */ struct ofp_action_mpls_ttl { uint16_t type; /* OFPAT_SET_MPLS_TTL. */ uint16_t len; /* Length is 8. */ uint8_t mpls_ttl; /* MPLS TTL */ uint8_t pad[3]; }; OFP_ASSERT(sizeof(struct ofp_action_mpls_ttl) == 8); /* Action structure for OFPAT_PUSH_VLAN/MPLS. */ struct ofp_action_push { uint16_t type; /* OFPAT_PUSH_VLAN/MPLS. */ uint16_t len; /* Length is 8. */ uint16_t ethertype; /* Ethertype */ uint8_t pad[2]; }; OFP_ASSERT(sizeof(struct ofp_action_push) == 8); /* Action structure for OFPAT_POP_MPLS. */ struct ofp_action_pop_mpls { uint16_t type; /* OFPAT_POP_MPLS. */ uint16_t len; /* Length is 8. */ uint16_t ethertype; /* Ethertype */ uint8_t pad[2]; }; OFP_ASSERT(sizeof(struct ofp_action_pop_mpls) == 8); /* Action structure for OFPAT_GROUP. */ struct ofp_action_group { uint16_t type; /* OFPAT_GROUP. */ uint16_t len; /* Length is 8. */ uint32_t group_id; /* Group identifier. */ }; OFP_ASSERT(sizeof(struct ofp_action_group) == 8); /* Action structure for OFPAT_SET_NW_TTL. */ struct ofp_action_nw_ttl { uint16_t type; /* OFPAT_SET_NW_TTL. */ uint16_t len; /* Length is 8. */ uint8_t nw_ttl; /* IP TTL */ uint8_t pad[3]; }; OFP_ASSERT(sizeof(struct ofp_action_nw_ttl) == 8); /* Action structure for OFPAT_SET_FIELD. */ struct ofp_action_set_field { uint16_t type; /* OFPAT_SET_FIELD. */ uint16_t len; /* Length is padded to 64 bits. */ /* Followed by: * - Exactly oxm_len bytes containing a single OXM TLV, then * - Exactly (oxm_len + 7)/8*8 - oxm_len (between 0 and 7) bytes of * all-zero bytes */ uint8_t field[4]; /* OXM TLV - Make compiler happy */ }; OFP_ASSERT(sizeof(struct ofp_action_nw_ttl) == 8); /* Action header for OFPAT_EXPERIMENTER. * The rest of the body is experimenter-defined. */ struct ofp_action_experimenter_header { uint16_t type; /* OFPAT_EXPERIMENTER. */ uint16_t len; /* Length is a multiple of 8. */ uint32_t experimenter; /* Experimenter ID which takes the same form as in struct ofp_experimenter_header. */ }; OFP_ASSERT(sizeof(struct ofp_action_experimenter_header) == 8); /* Action header that is common to all actions. The length includes the * header and any padding used to make the action 64-bit aligned. * NB: The length of an action *must* always be a multiple of eight. */ struct ofp_action_header { uint16_t type; /* One of OFPAT_*. */ uint16_t len; /* Length of action, including this header. This is the length of action, including any padding to make it 64-bit aligned. */ uint8_t pad[4]; }; OFP_ASSERT(sizeof(struct ofp_action_header) == 8); /* ## ---------------------- ## */ /* ## OpenFlow Instructions. ## */ /* ## ---------------------- ## */ enum ofp_instruction_type { OFPIT_GOTO_TABLE = 1, /* Setup the next table in the lookup pipeline */ OFPIT_WRITE_METADATA = 2, /* Setup the metadata field for use later in pipeline */ OFPIT_WRITE_ACTIONS = 3, /* Write the action(s) onto the datapath action set */ OFPIT_APPLY_ACTIONS = 4, /* Applies the action(s) immediately */ OFPIT_CLEAR_ACTIONS = 5, /* Clears all actions from the datapath action set */ OFPIT_EXPERIMENTER = 0xFFFF /* Experimenter instruction */ }; /* Generic ofp_instruction structure */ struct ofp_instruction { uint16_t type; /* Instruction type */ uint16_t len; /* Length of this struct in bytes. */ uint8_t pad[4]; /* Align to 64-bits */ }; OFP_ASSERT(sizeof(struct ofp_instruction) == 8); /* Instruction structure for OFPIT_GOTO_TABLE */ struct ofp_instruction_goto_table { uint16_t type; /* OFPIT_GOTO_TABLE */ uint16_t len; /* Length of this struct in bytes. */ uint8_t table_id; /* Set next table in the lookup pipeline */ uint8_t pad[3]; /* Pad to 64 bits. */ }; OFP_ASSERT(sizeof(struct ofp_instruction_goto_table) == 8); /* Instruction structure for OFPIT_WRITE_METADATA */ struct ofp_instruction_write_metadata { uint16_t type; /* OFPIT_WRITE_METADATA */ uint16_t len; /* Length of this struct in bytes. */ uint8_t pad[4]; /* Align to 64-bits */ uint64_t metadata; /* Metadata value to write */ uint64_t metadata_mask; /* Metadata write bitmask */ }; OFP_ASSERT(sizeof(struct ofp_instruction_write_metadata) == 24); /* Instruction structure for OFPIT_WRITE/APPLY/CLEAR_ACTIONS */ struct ofp_instruction_actions { uint16_t type; /* One of OFPIT_*_ACTIONS */ uint16_t len; /* Length of this struct in bytes. */ uint8_t pad[4]; /* Align to 64-bits */ struct ofp_action_header actions[0]; /* Actions associated with OFPIT_WRITE_ACTIONS and OFPIT_APPLY_ACTIONS */ }; OFP_ASSERT(sizeof(struct ofp_instruction_actions) == 8); /* Instruction structure for experimental instructions */ struct ofp_instruction_experimenter { uint16_t type; /* OFPIT_EXPERIMENTER */ uint16_t len; /* Length of this struct in bytes */ uint32_t experimenter; /* Experimenter ID which takes the same form as in struct ofp_experimenter_header. */ /* Experimenter-defined arbitrary additional data. */ }; OFP_ASSERT(sizeof(struct ofp_instruction_experimenter) == 8); /* ## --------------------------- ## */ /* ## OpenFlow Flow Modification. ## */ /* ## --------------------------- ## */ enum ofp_flow_mod_command { OFPFC_ADD, /* New flow. */ OFPFC_MODIFY, /* Modify all matching flows. */ OFPFC_MODIFY_STRICT, /* Modify entry strictly matching wildcards and priority. */ OFPFC_DELETE, /* Delete all matching flows. */ OFPFC_DELETE_STRICT /* Delete entry strictly matching wildcards and priority. */ }; /* Value used in "idle_timeout" and "hard_timeout" to indicate that the entry * is permanent. */ #define OFP_FLOW_PERMANENT 0 /* By default, choose a priority in the middle. */ #define OFP_DEFAULT_PRIORITY 0x8000 enum ofp_flow_mod_flags { OFPFF_SEND_FLOW_REM = 1 << 0, /* Send flow removed message when flow * expires or is deleted. */ OFPFF_CHECK_OVERLAP = 1 << 1, /* Check for overlapping entries first. */ OFPFF_RESET_COUNTS = 1 << 2 /* Reset flow packet and byte counts. */ }; /* Flow setup and teardown (controller -> datapath). */ struct ofp_flow_mod { struct ofp_header header; uint64_t cookie; /* Opaque controller-issued identifier. */ uint64_t cookie_mask; /* Mask used to restrict the cookie bits that must match when the command is OFPFC_MODIFY* or OFPFC_DELETE*. A value of 0 indicates no restriction. */ /* Flow actions. */ uint8_t table_id; /* ID of the table to put the flow in. For OFPFC_DELETE_* commands, OFPTT_ALL can also be used to delete matching flows from all tables. */ uint8_t command; /* One of OFPFC_*. */ uint16_t idle_timeout; /* Idle time before discarding (seconds). */ uint16_t hard_timeout; /* Max time before discarding (seconds). */ uint16_t priority; /* Priority level of flow entry. */ uint32_t buffer_id; /* Buffered packet to apply to (or -1). Not meaningful for OFPFC_DELETE*. */ uint32_t out_port; /* For OFPFC_DELETE* commands, require matching entries to include this as an output port. A value of OFPP_ANY indicates no restriction. */ uint32_t out_group; /* For OFPFC_DELETE* commands, require matching entries to include this as an output group. A value of OFPG_ANY indicates no restriction. */ uint16_t flags; /* One of OFPFF_*. */ uint8_t pad[2]; struct ofp_match match; /* Fields to match. Variable size. */ //struct ofp_instruction instructions[0]; /* Instruction set */ }; OFP_ASSERT(sizeof(struct ofp_flow_mod) == 56); /* Group numbering. Groups can use any number up to OFPG_MAX. */ enum ofp_group { /* Last usable group number. */ OFPG_MAX = 0xffffff00, /* Fake groups. */ OFPG_ALL = 0xfffffffc, /* Represents all groups for group delete commands. */ OFPG_ANY = 0xffffffff /* Wildcard group used only for flow stats requests. Selects all flows regardless of group (including flows with no group). */ }; /* Group commands */ enum ofp_group_mod_command { OFPGC_ADD, /* New group. */ OFPGC_MODIFY, /* Modify all matching groups. */ OFPGC_DELETE, /* Delete all matching groups. */ }; /* Bucket for use in groups. */ struct ofp_bucket { uint16_t len; /* Length the bucket in bytes, including this header and any padding to make it 64-bit aligned. */ uint16_t weight; /* Relative weight of bucket. Only defined for select groups. */ uint32_t watch_port; /* Port whose state affects whether this bucket is live. Only required for fast failover groups. */ uint32_t watch_group; /* Group whose state affects whether this bucket is live. Only required for fast failover groups. */ uint8_t pad[4]; struct ofp_action_header actions[0]; /* The action length is inferred from the length field in the header. */ }; OFP_ASSERT(sizeof(struct ofp_bucket) == 16); /* Group setup and teardown (controller -> datapath). */ struct ofp_group_mod { struct ofp_header header; uint16_t command; /* One of OFPGC_*. */ uint8_t type; /* One of OFPGT_*. */ uint8_t pad; /* Pad to 64 bits. */ uint32_t group_id; /* Group identifier. */ struct ofp_bucket buckets[0]; /* The length of the bucket array is inferred from the length field in the header. */ }; OFP_ASSERT(sizeof(struct ofp_group_mod) == 16); /* Group types. Values in the range [128, 255] are reserved for experimental * use. */ enum ofp_group_type { OFPGT_ALL, /* All (multicast/broadcast) group. */ OFPGT_SELECT, /* Select group. */ OFPGT_INDIRECT, /* Indirect group. */ OFPGT_FF /* Fast failover group. */ }; /* Send packet (controller -> datapath). */ struct ofp_packet_out { struct ofp_header header; uint32_t buffer_id; /* ID assigned by datapath (-1 if none). */ uint32_t in_port; /* Packet's input port or OFPP_CONTROLLER. */ uint16_t actions_len; /* Size of action array in bytes. */ uint8_t pad[6]; struct ofp_action_header actions[0]; /* Action list. */ /* uint8_t data[0]; */ /* Packet data. The length is inferred from the length field in the header. (Only meaningful if buffer_id == -1.) */ }; OFP_ASSERT(sizeof(struct ofp_packet_out) == 24); /* Why is this packet being sent to the controller? */ enum ofp_packet_in_reason { OFPR_NO_MATCH, /* No matching flow. */ OFPR_ACTION, /* Action explicitly output to controller. */ OFPR_INVALID_TTL /* Packet has invalid TTL */ }; /* Packet received on port (datapath -> controller). */ struct ofp_packet_in { struct ofp_header header; uint32_t buffer_id; /* ID assigned by datapath. */ uint16_t total_len; /* Full length of frame. */ uint8_t reason; /* Reason packet is being sent (one of OFPR_*) */ uint8_t table_id; /* ID of the table that was looked up */ struct ofp_match match; /* Packet metadata. Variable size. */ /* Followed by: * - Exactly 2 all-zero padding bytes, then * - An Ethernet frame whose length is inferred from header.length. * The padding bytes preceding the Ethernet frame ensure that the IP * header (if any) following the Ethernet header is 32-bit aligned. */ //uint8_t pad[2]; /* Align to 64 bit + 16 bit */ //uint8_t data[0]; /* Ethernet frame */ }; OFP_ASSERT(sizeof(struct ofp_packet_in) == 24); /* Why was this flow removed? */ enum ofp_flow_removed_reason { OFPRR_IDLE_TIMEOUT, /* Flow idle time exceeded idle_timeout. */ OFPRR_HARD_TIMEOUT, /* Time exceeded hard_timeout. */ OFPRR_DELETE, /* Evicted by a DELETE flow mod. */ OFPRR_GROUP_DELETE /* Group was removed. */ }; /* Flow removed (datapath -> controller). */ struct ofp_flow_removed { struct ofp_header header; uint64_t cookie; /* Opaque controller-issued identifier. */ uint16_t priority; /* Priority level of flow entry. */ uint8_t reason; /* One of OFPRR_*. */ uint8_t table_id; /* ID of the table */ uint32_t duration_sec; /* Time flow was alive in seconds. */ uint32_t duration_nsec; /* Time flow was alive in nanoseconds beyond duration_sec. */ uint16_t idle_timeout; /* Idle timeout from original flow mod. */ uint16_t hard_timeout; /* Hard timeout from original flow mod. */ uint64_t packet_count; uint64_t byte_count; struct ofp_match match; /* Description of fields. Variable size. */ }; OFP_ASSERT(sizeof(struct ofp_flow_removed) == 56); /* Values for 'type' in ofp_error_message. These values are immutable: they * will not change in future versions of the protocol (although new values may * be added). */ enum ofp_error_type { OFPET_HELLO_FAILED, /* Hello protocol failed. */ OFPET_BAD_REQUEST, /* Request was not understood. */ OFPET_BAD_ACTION, /* Error in action description. */ OFPET_BAD_INSTRUCTION, /* Error in instruction list. */ OFPET_BAD_MATCH, /* Error in match. */ OFPET_FLOW_MOD_FAILED, /* Problem modifying flow entry. */ OFPET_GROUP_MOD_FAILED, /* Problem modifying group entry. */ OFPET_PORT_MOD_FAILED, /* Port mod request failed. */ OFPET_TABLE_MOD_FAILED, /* Table mod request failed. */ OFPET_QUEUE_OP_FAILED, /* Queue operation failed. */ OFPET_SWITCH_CONFIG_FAILED, /* Switch config request failed. */ OFPET_EXPERIMENTER = 0xffff /* Experimenter error messages. */ }; /* ofp_error_msg 'code' values for OFPET_HELLO_FAILED. 'data' contains an * ASCII text string that may give failure details. */ enum ofp_hello_failed_code { OFPHFC_INCOMPATIBLE, /* No compatible version. */ OFPHFC_EPERM /* Permissions error. */ }; /* ofp_error_msg 'code' values for OFPET_BAD_REQUEST. 'data' contains at least * the first 64 bytes of the failed request. */ enum ofp_bad_request_code { OFPBRC_BAD_VERSION, /* ofp_header.version not supported. */ OFPBRC_BAD_TYPE, /* ofp_header.type not supported. */ OFPBRC_BAD_STAT, /* ofp_stats_request.type not supported. */ OFPBRC_BAD_EXPERIMENTER, /* Experimenter id not supported * (in ofp_experimenter_header * or ofp_stats_request or ofp_stats_reply). */ OFPBRC_BAD_EXP_TYPE, /* Experimenter type not supported. */ OFPBRC_EPERM, /* Permissions error. */ OFPBRC_BAD_LEN, /* Wrong request length for type. */ OFPBRC_BUFFER_EMPTY, /* Specified buffer has already been used. */ OFPBRC_BUFFER_UNKNOWN, /* Specified buffer does not exist. */ OFPBRC_BAD_TABLE_ID /* Specified table-id invalid or does not * exist. */ }; /* ofp_error_msg 'code' values for OFPET_BAD_ACTION. 'data' contains at least * the first 64 bytes of the failed request. */ enum ofp_bad_action_code { OFPBAC_BAD_TYPE, /* Unknown action type. */ OFPBAC_BAD_LEN, /* Length problem in actions. */ OFPBAC_BAD_EXPERIMENTER, /* Unknown experimenter id specified. */ OFPBAC_BAD_EXP_TYPE, /* Unknown action type for experimenter id. */ OFPBAC_BAD_OUT_PORT, /* Problem validating output port. */ OFPBAC_BAD_ARGUMENT, /* Bad action argument. */ OFPBAC_EPERM, /* Permissions error. */ OFPBAC_TOO_MANY, /* Can't handle this many actions. */ OFPBAC_BAD_QUEUE, /* Problem validating output queue. */ OFPBAC_BAD_OUT_GROUP, /* Invalid group id in forward action. */ OFPBAC_MATCH_INCONSISTENT, /* Action can't apply for this match, or Set-Field missing prerequisite. */ OFPBAC_UNSUPPORTED_ORDER, /* Action order is unsupported for the action list in an Apply-Actions instruction */ OFPBAC_BAD_TAG, /* Actions uses an unsupported tag/encap. */ OFPBAC_BAD_SET_TYPE, /* Unsupported type in OFPAT_SET_FIELD action. */ OFPBAC_BAD_SET_LEN, /* Length problem in OFPAT_SET_FIELD action. */ OFPBAC_BAD_SET_ARGUMENT, /* Bad argument in OFPAT_SET_FIELD action. */ }; /* ofp_error_msg 'code' values for OFPET_BAD_INSTRUCTION. 'data' contains at least * the first 64 bytes of the failed request. */ enum ofp_bad_instruction_code { OFPBIC_UNKNOWN_INST, /* Unknown instruction. */ OFPBIC_UNSUP_INST, /* Switch or table does not support the instruction. */ OFPBIC_BAD_TABLE_ID, /* Invalid Table-ID specified. */ OFPBIC_UNSUP_METADATA, /* Metadata value unsupported by datapath. */ OFPBIC_UNSUP_METADATA_MASK,/* Metadata mask value unsupported by datapath. */ OFPBIC_BAD_EXPERIMENTER, /* Unknown experimenter id specified. */ OFPBIC_BAD_EXP_TYPE, /* Unknown instruction for experimenter id. */ }; /* ofp_error_msg 'code' values for OFPET_BAD_MATCH. 'data' contains at least * the first 64 bytes of the failed request. */ enum ofp_bad_match_code { OFPBMC_BAD_TYPE, /* Unsupported match type specified by the match */ OFPBMC_BAD_LEN, /* Length problem in match. */ OFPBMC_BAD_TAG, /* Match uses an unsupported tag/encap. */ OFPBMC_BAD_DL_ADDR_MASK, /* Unsupported datalink addr mask - switch does not support arbitrary datalink address mask. */ OFPBMC_BAD_NW_ADDR_MASK, /* Unsupported network addr mask - switch does not support arbitrary network address mask. */ OFPBMC_BAD_WILDCARDS, /* Unsupported combination of fields masked or omitted in the match. */ OFPBMC_BAD_FIELD, /* Unsupported field type in the match. */ OFPBMC_BAD_VALUE, /* Unsupported value in a match field. */ OFPBMC_BAD_MASK, /* Unsupported mask specified in the match, field is not dl-address or nw-address. */ OFPBMC_BAD_PREREQ, /* A prerequisite was not met. */ OFPBMC_DUP_FIELD, /* A field type was duplicated. */ }; /* ofp_error_msg 'code' values for OFPET_FLOW_MOD_FAILED. 'data' contains * at least the first 64 bytes of the failed request. */ enum ofp_flow_mod_failed_code { OFPFMFC_UNKNOWN, /* Unspecified error. */ OFPFMFC_TABLE_FULL, /* Flow not added because table was full. */ OFPFMFC_BAD_TABLE_ID, /* Table does not exist */ OFPFMFC_OVERLAP, /* Attempted to add overlapping flow with CHECK_OVERLAP flag set. */ OFPFMFC_EPERM, /* Permissions error. */ OFPFMFC_BAD_TIMEOUT, /* Flow not added because of unsupported idle/hard timeout. */ OFPFMFC_BAD_COMMAND, /* Unsupported or unknown command. */ }; /* ofp_error_msg 'code' values for OFPET_GROUP_MOD_FAILED. 'data' contains * at least the first 64 bytes of the failed request. */ enum ofp_group_mod_failed_code { OFPGMFC_GROUP_EXISTS, /* Group not added because a group ADD * attempted to replace an * already-present group. */ OFPGMFC_INVALID_GROUP, /* Group not added because Group specified * is invalid. */ OFPGMFC_WEIGHT_UNSUPPORTED, /* Switch does not support unequal load * sharing with select groups. */ OFPGMFC_OUT_OF_GROUPS, /* The group table is full. */ OFPGMFC_OUT_OF_BUCKETS, /* The maximum number of action buckets * for a group has been exceeded. */ OFPGMFC_CHAINING_UNSUPPORTED, /* Switch does not support groups that * forward to groups. */ OFPGMFC_WATCH_UNSUPPORTED, /* This group cannot watch the watch_port or watch_group specified. */ OFPGMFC_LOOP, /* Group entry would cause a loop. */ OFPGMFC_UNKNOWN_GROUP, /* Group not modified because a group MODIFY attempted to modify a non-existent group. */ OFPGMFC_CHAINED_GROUP, /* Group not deleted because another group is forwarding to it. */ }; /* ofp_error_msg 'code' values for OFPET_PORT_MOD_FAILED. 'data' contains * at least the first 64 bytes of the failed request. */ enum ofp_port_mod_failed_code { OFPPMFC_BAD_PORT, /* Specified port number does not exist. */ OFPPMFC_BAD_HW_ADDR, /* Specified hardware address does not * match the port number. */ OFPPMFC_BAD_CONFIG, /* Specified config is invalid. */ OFPPMFC_BAD_ADVERTISE /* Specified advertise is invalid. */ }; /* ofp_error_msg 'code' values for OFPET_TABLE_MOD_FAILED. 'data' contains * at least the first 64 bytes of the failed request. */ enum ofp_table_mod_failed_code { OFPTMFC_BAD_TABLE, /* Specified table does not exist. */ OFPTMFC_BAD_CONFIG /* Specified config is invalid. */ }; /* ofp_error msg 'code' values for OFPET_QUEUE_OP_FAILED. 'data' contains * at least the first 64 bytes of the failed request */ enum ofp_queue_op_failed_code { OFPQOFC_BAD_PORT, /* Invalid port (or port does not exist). */ OFPQOFC_BAD_QUEUE, /* Queue does not exist. */ OFPQOFC_EPERM /* Permissions error. */ }; /* ofp_error_msg 'code' values for OFPET_SWITCH_CONFIG_FAILED. 'data' contains * at least the first 64 bytes of the failed request. */ enum ofp_switch_config_failed_code { OFPSCFC_BAD_FLAGS, /* Specified flags is invalid. */ OFPSCFC_BAD_LEN /* Specified len is invalid. */ }; /* OFPT_ERROR: Error message (datapath -> controller). */ struct ofp_error_msg { struct ofp_header header; uint16_t type; uint16_t code; uint8_t data[0]; /* Variable-length data. Interpreted based on the type and code. No padding. */ }; OFP_ASSERT(sizeof(struct ofp_error_msg) == 12); /* OFPET_EXPERIMENTER: Error message (datapath -> controller). */ struct ofp_error_experimenter_msg { struct ofp_header header; uint16_t type; /* OFPET_EXPERIMENTER. */ uint16_t exp_type; /* Experimenter defined. */ uint32_t experimenter; /* Experimenter ID which takes the same form as in struct ofp_experimenter_header. */ uint8_t data[0]; /* Variable-length data. Interpreted based on the type and code. No padding. */ }; OFP_ASSERT(sizeof(struct ofp_error_experimenter_msg) == 16); enum ofp_stats_types { /* Description of this OpenFlow switch. * The request body is empty. * The reply body is struct ofp_desc_stats. */ OFPST_DESC, /* Individual flow statistics. * The request body is struct ofp_flow_stats_request. * The reply body is an array of struct ofp_flow_stats. */ OFPST_FLOW, /* Aggregate flow statistics. * The request body is struct ofp_aggregate_stats_request. * The reply body is struct ofp_aggregate_stats_reply. */ OFPST_AGGREGATE, /* Flow table statistics. * The request body is empty. * The reply body is an array of struct ofp_table_stats. */ OFPST_TABLE, /* Port statistics. * The request body is struct ofp_port_stats_request. * The reply body is an array of struct ofp_port_stats. */ OFPST_PORT, /* Queue statistics for a port * The request body is struct ofp_queue_stats_request. * The reply body is an array of struct ofp_queue_stats */ OFPST_QUEUE, /* Group counter statistics. * The request body is struct ofp_group_stats_request. * The reply is is an array of struct ofp_group_stats. */ OFPST_GROUP, /* Group description statistics. * The request body is empty. * The reply body is is an array of struct ofp_group_desc_stats. */ OFPST_GROUP_DESC, /* Experimenter extension. * The request and reply bodies begin with * struct ofp_experimenter_stats_header. * The request and reply bodies are otherwise experimenter-defined. */ OFPST_EXPERIMENTER = 0xffff }; struct ofp_stats_request { struct ofp_header header; uint16_t type; /* One of the OFPST_* constants. */ uint16_t flags; /* OFPSF_REQ_* flags (none yet defined). */ uint8_t pad[4]; uint8_t body[0]; /* Body of the request. */ }; OFP_ASSERT(sizeof(struct ofp_stats_request) == 16); enum ofp_stats_reply_flags { OFPSF_REPLY_MORE = 1 << 0 /* More replies to follow. */ }; struct ofp_stats_reply { struct ofp_header header; uint16_t type; /* One of the OFPST_* constants. */ uint16_t flags; /* OFPSF_REPLY_* flags. */ uint8_t pad[4]; uint8_t body[0]; /* Body of the reply. */ }; OFP_ASSERT(sizeof(struct ofp_stats_reply) == 16); #define DESC_STR_LEN 256 #define SERIAL_NUM_LEN 32 /* Body of reply to OFPST_DESC request. Each entry is a NULL-terminated * ASCII string. */ struct ofp_desc_stats { char mfr_desc[DESC_STR_LEN]; /* Manufacturer description. */ char hw_desc[DESC_STR_LEN]; /* Hardware description. */ char sw_desc[DESC_STR_LEN]; /* Software description. */ char serial_num[SERIAL_NUM_LEN]; /* Serial number. */ char dp_desc[DESC_STR_LEN]; /* Human readable description of datapath. */ }; OFP_ASSERT(sizeof(struct ofp_desc_stats) == 1056); /* Body for ofp_stats_request of type OFPST_FLOW. */ struct ofp_flow_stats_request { uint8_t table_id; /* ID of table to read (from ofp_table_stats), OFPTT_ALL for all tables. */ uint8_t pad[3]; /* Align to 64 bits. */ uint32_t out_port; /* Require matching entries to include this as an output port. A value of OFPP_ANY indicates no restriction. */ uint32_t out_group; /* Require matching entries to include this as an output group. A value of OFPG_ANY indicates no restriction. */ uint8_t pad2[4]; /* Align to 64 bits. */ uint64_t cookie; /* Require matching entries to contain this cookie value */ uint64_t cookie_mask; /* Mask used to restrict the cookie bits that must match. A value of 0 indicates no restriction. */ struct ofp_match match; /* Fields to match. Variable size. */ }; OFP_ASSERT(sizeof(struct ofp_flow_stats_request) == 40); /* Body of reply to OFPST_FLOW request. */ struct ofp_flow_stats { uint16_t length; /* Length of this entry. */ uint8_t table_id; /* ID of table flow came from. */ uint8_t pad; uint32_t duration_sec; /* Time flow has been alive in seconds. */ uint32_t duration_nsec; /* Time flow has been alive in nanoseconds beyond duration_sec. */ uint16_t priority; /* Priority of the entry. Only meaningful when this is not an exact-match entry. */ uint16_t idle_timeout; /* Number of seconds idle before expiration. */ uint16_t hard_timeout; /* Number of seconds before expiration. */ uint8_t pad2[6]; /* Align to 64-bits. */ uint64_t cookie; /* Opaque controller-issued identifier. */ uint64_t packet_count; /* Number of packets in flow. */ uint64_t byte_count; /* Number of bytes in flow. */ struct ofp_match match; /* Description of fields. Variable size. */ //struct ofp_instruction instructions[0]; /* Instruction set. */ }; OFP_ASSERT(sizeof(struct ofp_flow_stats) == 56); /* Body for ofp_stats_request of type OFPST_AGGREGATE. */ struct ofp_aggregate_stats_request { uint8_t table_id; /* ID of table to read (from ofp_table_stats) OFPTT_ALL for all tables. */ uint8_t pad[3]; /* Align to 64 bits. */ uint32_t out_port; /* Require matching entries to include this as an output port. A value of OFPP_ANY indicates no restriction. */ uint32_t out_group; /* Require matching entries to include this as an output group. A value of OFPG_ANY indicates no restriction. */ uint8_t pad2[4]; /* Align to 64 bits. */ uint64_t cookie; /* Require matching entries to contain this cookie value */ uint64_t cookie_mask; /* Mask used to restrict the cookie bits that must match. A value of 0 indicates no restriction. */ struct ofp_match match; /* Fields to match. Variable size. */ }; OFP_ASSERT(sizeof(struct ofp_aggregate_stats_request) == 40); /* Body of reply to OFPST_AGGREGATE request. */ struct ofp_aggregate_stats_reply { uint64_t packet_count; /* Number of packets in flows. */ uint64_t byte_count; /* Number of bytes in flows. */ uint32_t flow_count; /* Number of flows. */ uint8_t pad[4]; /* Align to 64 bits. */ }; OFP_ASSERT(sizeof(struct ofp_aggregate_stats_reply) == 24); /* Body of reply to OFPST_TABLE request. */ struct ofp_table_stats { uint8_t table_id; /* Identifier of table. Lower numbered tables are consulted first. */ uint8_t pad[7]; /* Align to 64-bits. */ char name[OFP_MAX_TABLE_NAME_LEN]; uint64_t match; /* Bitmap of (1 << OFPXMT_*) that indicate the fields the table can match on. */ uint64_t wildcards; /* Bitmap of (1 << OFPXMT_*) wildcards that are supported by the table. */ uint32_t write_actions; /* Bitmap of OFPAT_* that are supported by the table with OFPIT_WRITE_ACTIONS. */ uint32_t apply_actions; /* Bitmap of OFPAT_* that are supported by the table with OFPIT_APPLY_ACTIONS. */ uint64_t write_setfields;/* Bitmap of (1 << OFPXMT_*) header fields that can be set with OFPIT_WRITE_ACTIONS. */ uint64_t apply_setfields;/* Bitmap of (1 << OFPXMT_*) header fields that can be set with OFPIT_APPLY_ACTIONS. */ uint64_t metadata_match; /* Bits of metadata table can match. */ uint64_t metadata_write; /* Bits of metadata table can write. */ uint32_t instructions; /* Bitmap of OFPIT_* values supported. */ uint32_t config; /* Bitmap of OFPTC_* values */ uint32_t max_entries; /* Max number of entries supported. */ uint32_t active_count; /* Number of active entries. */ uint64_t lookup_count; /* Number of packets looked up in table. */ uint64_t matched_count; /* Number of packets that hit table. */ }; OFP_ASSERT(sizeof(struct ofp_table_stats) == 128); /* Body for ofp_stats_request of type OFPST_PORT. */ struct ofp_port_stats_request { uint32_t port_no; /* OFPST_PORT message must request statistics * either for a single port (specified in * port_no) or for all ports (if port_no == * OFPP_ANY). */ uint8_t pad[4]; }; OFP_ASSERT(sizeof(struct ofp_port_stats_request) == 8); /* Body of reply to OFPST_PORT request. If a counter is unsupported, set * the field to all ones. */ struct ofp_port_stats { uint32_t port_no; uint8_t pad[4]; /* Align to 64-bits. */ uint64_t rx_packets; /* Number of received packets. */ uint64_t tx_packets; /* Number of transmitted packets. */ uint64_t rx_bytes; /* Number of received bytes. */ uint64_t tx_bytes; /* Number of transmitted bytes. */ uint64_t rx_dropped; /* Number of packets dropped by RX. */ uint64_t tx_dropped; /* Number of packets dropped by TX. */ uint64_t rx_errors; /* Number of receive errors. This is a super-set of more specific receive errors and should be greater than or equal to the sum of all rx_*_err values. */ uint64_t tx_errors; /* Number of transmit errors. This is a super-set of more specific transmit errors and should be greater than or equal to the sum of all tx_*_err values (none currently defined.) */ uint64_t rx_frame_err; /* Number of frame alignment errors. */ uint64_t rx_over_err; /* Number of packets with RX overrun. */ uint64_t rx_crc_err; /* Number of CRC errors. */ uint64_t collisions; /* Number of collisions. */ }; OFP_ASSERT(sizeof(struct ofp_port_stats) == 104); /* Body of OFPST_GROUP request. */ struct ofp_group_stats_request { uint32_t group_id; /* All groups if OFPG_ALL. */ uint8_t pad[4]; /* Align to 64 bits. */ }; OFP_ASSERT(sizeof(struct ofp_group_stats_request) == 8); /* Used in group stats replies. */ struct ofp_bucket_counter { uint64_t packet_count; /* Number of packets processed by bucket. */ uint64_t byte_count; /* Number of bytes processed by bucket. */ }; OFP_ASSERT(sizeof(struct ofp_bucket_counter) == 16); /* Body of reply to OFPST_GROUP request. */ struct ofp_group_stats { uint16_t length; /* Length of this entry. */ uint8_t pad[2]; /* Align to 64 bits. */ uint32_t group_id; /* Group identifier. */ uint32_t ref_count; /* Number of flows or groups that directly forward to this group. */ uint8_t pad2[4]; /* Align to 64 bits. */ uint64_t packet_count; /* Number of packets processed by group. */ uint64_t byte_count; /* Number of bytes processed by group. */ struct ofp_bucket_counter bucket_stats[0]; }; OFP_ASSERT(sizeof(struct ofp_group_stats) == 32); /* Body of reply to OFPST_GROUP_DESC request. */ struct ofp_group_desc_stats { uint16_t length; /* Length of this entry. */ uint8_t type; /* One of OFPGT_*. */ uint8_t pad; /* Pad to 64 bits. */ uint32_t group_id; /* Group identifier. */ struct ofp_bucket buckets[0]; }; OFP_ASSERT(sizeof(struct ofp_group_desc_stats) == 8); /* Body for ofp_stats_request/reply of type OFPST_EXPERIMENTER. */ struct ofp_experimenter_stats_header { uint32_t experimenter; /* Experimenter ID which takes the same form as in struct ofp_experimenter_header. */ uint32_t exp_type; /* Experimenter defined. */ /* Experimenter-defined arbitrary additional data. */ }; OFP_ASSERT(sizeof(struct ofp_experimenter_stats_header) == 8); /* Experimenter extension. */ struct ofp_experimenter_header { struct ofp_header header; /* Type OFPT_EXPERIMENTER. */ uint32_t experimenter; /* Experimenter ID: * - MSB 0: low-order bytes are IEEE OUI. * - MSB != 0: defined by ONF. */ uint32_t exp_type; /* Experimenter defined. */ /* Experimenter-defined arbitrary additional data. */ }; OFP_ASSERT(sizeof(struct ofp_experimenter_header) == 16); /* All ones is used to indicate all queues in a port (for stats retrieval). */ #define OFPQ_ALL 0xffffffff /* Min rate > 1000 means not configured. */ #define OFPQ_MIN_RATE_UNCFG 0xffff /* Max rate > 1000 means not configured. */ #define OFPQ_MAX_RATE_UNCFG 0xffff enum ofp_queue_properties { OFPQT_MIN_RATE, /* Minimum datarate guaranteed. */ OFPQT_MAX_RATE /* Maximum datarate. */ /* Other types should be added here. */ }; /* Common description for a queue. */ struct ofp_queue_prop_header { uint16_t property; /* One of OFPQT_. */ uint16_t len; /* Length of property, including this header. */ uint8_t pad[4]; /* 64-bit alignemnt. */ }; OFP_ASSERT(sizeof(struct ofp_queue_prop_header) == 8); /* Min-Rate queue property description. */ struct ofp_queue_prop_min_rate { struct ofp_queue_prop_header prop_header; /* prop: OFPQT_MIN, len: 16. */ uint16_t rate; /* In 1/10 of a percent; >1000 -> disabled. */ uint8_t pad[6]; /* 64-bit alignment */ }; OFP_ASSERT(sizeof(struct ofp_queue_prop_min_rate) == 16); /* Max-Rate queue property description. */ struct ofp_queue_prop_max_rate { struct ofp_queue_prop_header prop_header; /* prop: OFPQT_MAX, len: 16. */ uint16_t rate; /* In 1/10 of a percent; >1000 -> disabled. */ uint8_t pad[6]; /* 64-bit alignment */ }; OFP_ASSERT(sizeof(struct ofp_queue_prop_max_rate) == 16); /* Full description for a queue. */ struct ofp_packet_queue { uint32_t queue_id; /* id for the specific queue. */ uint32_t port; /* Port this queue is attached to. */ uint16_t len; /* Length in bytes of this queue desc. */ uint8_t pad[6]; /* 64-bit alignment. */ struct ofp_queue_prop_header properties[0]; /* List of properties. */ }; OFP_ASSERT(sizeof(struct ofp_packet_queue) == 16); /* Query for port queue configuration. */ struct ofp_queue_get_config_request { struct ofp_header header; uint32_t port; /* Port to be queried. Should refer to a valid physical port (i.e. < OFPP_MAX), or OFPP_ANY to request all configured queues.*/ uint8_t pad[4]; }; OFP_ASSERT(sizeof(struct ofp_queue_get_config_request) == 16); /* Queue configuration for a given port. */ struct ofp_queue_get_config_reply { struct ofp_header header; uint32_t port; uint8_t pad[4]; struct ofp_packet_queue queues[0]; /* List of configured queues. */ }; OFP_ASSERT(sizeof(struct ofp_queue_get_config_reply) == 16); /* OFPAT_SET_QUEUE action struct: send packets to given queue on port. */ struct ofp_action_set_queue { uint16_t type; /* OFPAT_SET_QUEUE. */ uint16_t len; /* Len is 8. */ uint32_t queue_id; /* Queue id for the packets. */ }; OFP_ASSERT(sizeof(struct ofp_action_set_queue) == 8); struct ofp_queue_stats_request { uint32_t port_no; /* All ports if OFPP_ANY. */ uint32_t queue_id; /* All queues if OFPQ_ALL. */ }; OFP_ASSERT(sizeof(struct ofp_queue_stats_request) == 8); struct ofp_queue_stats { uint32_t port_no; uint32_t queue_id; /* Queue i.d */ uint64_t tx_bytes; /* Number of transmitted bytes. */ uint64_t tx_packets; /* Number of transmitted packets. */ uint64_t tx_errors; /* Number of packets dropped due to overrun. */ }; OFP_ASSERT(sizeof(struct ofp_queue_stats) == 32); #endif /* openflow/openflow.h */