Definitions for Open Flow 1.2
authorSimon Horman <horms@verge.net.au>
Fri, 30 Mar 2012 02:30:01 +0000 (11:30 +0900)
committerBen Pfaff <blp@nicira.com>
Fri, 30 Mar 2012 16:14:51 +0000 (09:14 -0700)
This is a first pass at adding include/openflow/openflow-1.2.h to
include enum and struct definitions for Open Flow 1.2 that
are not already covered by Open Flow 1.1.

Signed-off-by: Simon Horman <horms@verge.net.au>
Signed-off-by: Ben Pfaff <blp@nicira.com>
include/openflow/automake.mk
include/openflow/openflow-1.2.h [new file with mode: 0644]
include/openflow/openflow-common.h
include/openflow/openflow.h

index ac7412b..4b7bc07 100644 (file)
@@ -2,6 +2,7 @@ noinst_HEADERS += \
        include/openflow/nicira-ext.h \
        include/openflow/openflow-1.0.h \
        include/openflow/openflow-1.1.h \
+       include/openflow/openflow-1.2.h \
        include/openflow/openflow-common.h \
        include/openflow/openflow.h
 
@@ -16,6 +17,7 @@ HSTAMP_FILES = \
        include/openflow/nicira.hstamp \
        include/openflow/openflow-1.0.hstamp \
        include/openflow/openflow-1.1.hstamp \
+       include/openflow/openflow-1.2.hstamp \
        include/openflow/openflow.hstamp
 CLEANFILES += $(HSTAMP_FILES)
 ALL_LOCAL += $(HSTAMP_FILES)
@@ -26,6 +28,7 @@ include/openflow/openflow-1.1.hstamp: include/openflow/openflow-common.h
 include/openflow/nicira-ext.hstamp: \
        include/openflow/openflow-1.0.h \
        include/openflow/openflow-1.1.h \
+       include/openflow/openflow-1.2.h \
        include/openflow/openflow-common.h \
        include/openflow/openflow.h
 endif
diff --git a/include/openflow/openflow-1.2.h b/include/openflow/openflow-1.2.h
new file mode 100644 (file)
index 0000000..9254cf4
--- /dev/null
@@ -0,0 +1,319 @@
+/* Copyright (c) 2008, 2011, 2012 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.
+ */
+
+/*
+ * Copyright (c) 2008, 2009, 2010, 2011, 2012 Nicira Networks.
+ * Copyright (c) 2012 Horms Solutions Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/* OpenFlow: protocol between controller and datapath. */
+
+#ifndef OPENFLOW_12_H
+#define OPENFLOW_12_H 1
+
+#include "openflow/openflow-1.1.h"
+
+/* OpenFlow 1.2 specific message types, in addition to the common message
+ * types. */
+enum ofp12_type {
+    /* Controller role change request messages. */
+    OFPT12_ROLE_REQUEST = 24,   /* Controller/switch message */
+    OFPT12_ROLE_REPLY,          /* Controller/switch message */
+};
+
+/*
+ * OXM Class IDs.
+ * The high order bit differentiate reserved classes from member classes.
+ * Classes 0x0000 to 0x7FFF are member classes, allocated by ONF.
+ * Classes 0x8000 to 0xFFFE are reserved classes, reserved for standardisation.
+ */
+enum ofp12_oxm_class {
+    OFPXMC12_NXM_0          = 0x0000, /* Backward compatibility with NXM */
+    OFPXMC12_NXM_1          = 0x0001, /* Backward compatibility with NXM */
+    OFPXMC12_OPENFLOW_BASIC = 0x0000, /* Basic class for OpenFlow */
+    OFPXMC12_EXPERIMENTER   = 0x0000, /* Experimenter class */
+};
+
+/* OXM Flow match field types for OpenFlow basic class. */
+enum oxm12_ofb_match_fields {
+    OFPXMT12_OFB_IN_PORT,        /* Switch input port. */
+    OFPXMT12_OFB_IN_PHY_PORT,    /* Switch physical input port. */
+    OFPXMT12_OFB_METADATA,       /* Metadata passed between tables. */
+    OFPXMT12_OFB_ETH_DST,        /* Ethernet destination address. */
+    OFPXMT12_OFB_ETH_SRC,        /* Ethernet source address. */
+    OFPXMT12_OFB_ETH_TYPE,       /* Ethernet frame type. */
+    OFPXMT12_OFB_VLAN_VID,       /* VLAN id. */
+    OFPXMT12_OFB_VLAN_PCP,       /* VLAN priority. */
+    OFPXMT12_OFB_IP_DSCP,        /* IP DSCP (6 bits in ToS field). */
+    OFPXMT12_OFB_IP_ECN,         /* IP ECN (2 bits in ToS field). */
+    OFPXMT12_OFB_IP_PROTO,       /* IP protocol. */
+    OFPXMT12_OFB_IPV4_SRC,       /* IPv4 source address. */
+    OFPXMT12_OFB_IPV4_DST,       /* IPv4 destination address. */
+    OFPXMT12_OFB_TCP_SRC,        /* TCP source port. */
+    OFPXMT12_OFB_TCP_DST,        /* TCP destination port. */
+    OFPXMT12_OFB_UDP_SRC,        /* UDP source port. */
+    OFPXMT12_OFB_UDP_DST,        /* UDP destination port. */
+    OFPXMT12_OFB_SCTP_SRC,       /* SCTP source port. */
+    OFPXMT12_OFB_SCTP_DST,       /* SCTP destination port. */
+    OFPXMT12_OFB_ICMPV4_TYPE,    /* ICMP type. */
+    OFPXMT12_OFB_ICMPV4_CODE,    /* ICMP code. */
+    OFPXMT12_OFB_ARP_OP,         /* ARP opcode. */
+    OFPXMT12_OFB_ARP_SPA,        /* ARP source IPv4 address. */
+    OFPXMT12_OFB_ARP_TPA,        /* ARP target IPv4 address. */
+    OFPXMT12_OFB_ARP_SHA,        /* ARP source hardware address. */
+    OFPXMT12_OFB_ARP_THA,        /* ARP target hardware address. */
+    OFPXMT12_OFB_IPV6_SRC,       /* IPv6 source address. */
+    OFPXMT12_OFB_IPV6_DST,       /* IPv6 destination address. */
+    OFPXMT12_OFB_IPV6_FLABEL,    /* IPv6 Flow Label */
+    OFPXMT12_OFB_ICMPV6_TYPE,    /* ICMPv6 type. */
+    OFPXMT12_OFB_ICMPV6_CODE,    /* ICMPv6 code. */
+    OFPXMT12_OFB_IPV6_ND_TARGET, /* Target address for ND. */
+    OFPXMT12_OFB_IPV6_ND_SLL,    /* Source link-layer for ND. */
+    OFPXMT12_OFB_IPV6_ND_TLL,    /* Target link-layer for ND. */
+    OFPXMT12_OFB_MPLS_LABEL,     /* MPLS label. */
+    OFPXMT12_OFB_MPLS_TC,        /* MPLS TC. */
+};
+
+/* The VLAN id is 12-bits, so we can use the entire 16 bits to indicate
+ * special conditions.
+ */
+enum ofp12_vlan_id {
+    OFPVID12_PRESENT = 0x1000, /* Bit that indicate that a VLAN id is set */
+    OFPVID12_NONE    = 0x0000, /* No VLAN id was set. */
+};
+
+/* Header for OXM experimenter match fields. */
+struct ofp12_oxm_experimenter_header {
+    ovs_be32 oxm_header;   /* oxm_class = OFPXMC_EXPERIMENTER */
+    ovs_be32 experimenter; /* Experimenter ID which takes the same
+                              form as in struct ofp11_experimenter_header. */
+};
+OFP_ASSERT(sizeof(struct ofp12_oxm_experimenter_header) == 8);
+
+enum ofp12_action_type {
+    OFPAT12_OUTPUT       = 0,  /* Output to switch port. */
+    OFPAT12_COPY_TTL_OUT = 11, /* Copy TTL "outwards" -- from next-to-outermost
+                                  to outermost */
+    OFPAT12_COPY_TTL_IN,       /* Copy TTL "inwards" -- from outermost to
+                                  next-to-outermost */
+    OFPAT12_SET_MPLS_TTL,      /* MPLS TTL */
+    OFPAT12_DEC_MPLS_TTL,      /* Decrement MPLS TTL */
+    OFPAT12_PUSH_VLAN,         /* Push a new VLAN tag */
+    OFPAT12_POP_VLAN,          /* Pop the outer VLAN tag */
+    OFPAT12_PUSH_MPLS,         /* Push a new MPLS tag */
+    OFPAT12_POP_MPLS,          /* Pop the outer MPLS tag */
+    OFPAT12_SET_QUEUE,         /* Set queue id when outputting to a port */
+    OFPAT12_GROUP,             /* Apply group. */
+    OFPAT12_SET_NW_TTL,        /* IP TTL. */
+    OFPAT12_DEC_NW_TTL,        /* Decrement IP TTL. */
+    OFPAT12_SET_FIELD,         /* Set a header field using OXM TLV format. */
+    OFPAT12_EXPERIMENTER = 0xffff
+};
+
+enum ofp12_controller_max_len {
+       OFPCML12_MAX       = 0xffe5, /* maximum max_len value which can be used
+                                     * to request a specific byte length. */
+       OFPCML12_NO_BUFFER = 0xffff  /* indicates that no buffering should be
+                                     * applied and the whole packet is to be
+                                     * sent to the controller. */
+};
+
+/* Action structure for OFPAT12_SET_FIELD. */
+struct ofp12_action_set_field {
+    ovs_be16 type;                  /* OFPAT12_SET_FIELD. */
+    ovs_be16 len;                   /* Length is padded to 64 bits. */
+    /* Followed by:
+     * - Exactly oxm_len bytes containing a single OXM TLV, then
+     * - Exactly ((oxm_len + 4) + 7)/8*8 - (oxm_len + 4) (between 0 and 7)
+     *   bytes of all-zero bytes
+     */
+    uint8_t field[4];               /* OXM TLV - Make compiler happy */
+};
+OFP_ASSERT(sizeof(struct ofp12_action_set_field) == 8);
+
+/* OpenFlow 1.2 specific flags
+ * (struct ofp12_flow_mod, member flags). */
+enum ofp12_flow_mod_flags {
+    OFPFF12_RESET_COUNTS  = 1 << 2   /* Reset flow packet and byte counts. */
+};
+
+/* OpenFlow 1.2 specific capabilities
+ * (struct ofp_switch_features, member capabilities). */
+enum ofp12_capabilities {
+    OFPC12_PORT_BLOCKED   = 1 << 8   /* Switch will block looping ports. */
+};
+
+/* OpenFlow 1.2 specific types
+ * (struct ofp11_stats_request/reply, member type). */
+enum ofp12_stats_types {
+    /* Group features.
+     * The request body is empty.
+     * The reply body is struct ofp12_group_features_stats. */
+    OFPST12_GROUP_FEATURES = 8
+};
+
+/* OpenFlow 1.2 specific properties
+ * (struct ofp_queue_prop_header member property). */
+enum ofp12_queue_properties {
+    OFPQT12_MIN_RATE = 1,         /* Minimum datarate guaranteed. */
+    OFPQT12_MAX_RATE = 2,         /* Maximum datarate. */
+    OFPQT12_EXPERIMENTER = 0xffff /* Experimenter defined property. */
+};
+
+/* Body of reply to OFPST_TABLE request. */
+struct ofp12_table_stats {
+    struct ofp11_stats_msg osm;
+    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];
+    ovs_be64 match;          /* Bitmap of (1 << OFPXMT_*) that indicate the
+                                fields the table can match on. */
+    ovs_be64 wildcards;      /* Bitmap of (1 << OFPXMT_*) wildcards that are
+                                supported by the table. */
+    ovs_be32 write_actions;  /* Bitmap of OFPAT_* that are supported
+                                by the table with OFPIT_WRITE_ACTIONS. */
+    ovs_be32 apply_actions;  /* Bitmap of OFPAT_* that are supported
+                                by the table with OFPIT_APPLY_ACTIONS. */
+    ovs_be64 write_setfields;/* Bitmap of (1 << OFPXMT_*) header fields that
+                                can be set with OFPIT_WRITE_ACTIONS. */
+    ovs_be64 apply_setfields;/* Bitmap of (1 << OFPXMT_*) header fields that
+                                can be set with OFPIT_APPLY_ACTIONS. */
+    ovs_be64 metadata_match; /* Bits of metadata table can match. */
+    ovs_be64 metadata_write; /* Bits of metadata table can write. */
+    ovs_be32 instructions;   /* Bitmap of OFPIT_* values supported. */
+    ovs_be32 config;         /* Bitmap of OFPTC_* values */
+    ovs_be32 max_entries;    /* Max number of entries supported. */
+    ovs_be32 active_count;   /* Number of active entries. */
+    ovs_be64 lookup_count;   /* Number of packets looked up in table. */
+    ovs_be64 matched_count;  /* Number of packets that hit table. */
+};
+OFP_ASSERT(sizeof(struct ofp12_table_stats) == 144);
+
+/* Body of reply to OFPST12_GROUP_FEATURES request. Group features. */
+struct ofp12_group_features_stats {
+    struct ofp11_stats_msg osm;
+    ovs_be32  types;           /* Bitmap of OFPGT_* values supported. */
+    ovs_be32  capabilities;    /* Bitmap of OFPGFC12_* capability supported. */
+    ovs_be32  max_groups[4];   /* Maximum number of groups for each type. */
+    ovs_be32  actions[4];      /* Bitmaps of OFPAT_* that are supported. */
+};
+OFP_ASSERT(sizeof(struct ofp12_group_features_stats) == 56);
+
+/* Group configuration flags */
+enum ofp12_group_capabilities {
+    OFPGFC12_SELECT_WEIGHT   = 1 << 0, /* Support weight for select groups */
+    OFPGFC12_SELECT_LIVENESS = 1 << 1, /* Support liveness for select groups */
+    OFPGFC12_CHAINING        = 1 << 2, /* Support chaining groups */
+    OFPGFC12_CHAINING_CHECKS = 1 << 3, /* Check chaining for loops and delete */
+};
+
+/* Body for ofp12_stats_request/reply of type OFPST_EXPERIMENTER. */
+struct ofp12_experimenter_stats_header {
+    ovs_be32 experimenter;    /* Experimenter ID which takes the same form
+                                 as in struct ofp_experimenter_header. */
+    ovs_be32 exp_type;        /* Experimenter defined. */
+    /* Experimenter-defined arbitrary additional data. */
+};
+OFP_ASSERT(sizeof(struct ofp12_experimenter_stats_header) == 8);
+
+/* Role request and reply message. */
+struct ofp12_role_request {
+    struct ofp_header header; /* Type OFPT12_ROLE_REQUEST/OFPT12_ROLE_REPLY. */
+    ovs_be32 role;            /* One of OFPCR12_ROLE_*. */
+    uint8_t pad[4];           /* Align to 64 bits. */
+    ovs_be64 generation_id;   /* Master Election Generation Id */
+};
+OFP_ASSERT(sizeof(struct ofp12_role_request) == 24);
+
+/* Controller roles. */
+enum ofp12_controller_role {
+    OFPCR12_ROLE_NOCHANGE,    /* Don't change current role. */
+    OFPCR12_ROLE_EQUAL,       /* Default role, full access. */
+    OFPCR12_ROLE_MASTER,      /* Full access, at most one master. */
+    OFPCR12_ROLE_SLAVE,       /* Read-only access. */
+};
+
+/* Packet received on port (datapath -> controller). */
+struct ofp12_packet_in {
+    struct ofp_header header;
+    ovs_be32 buffer_id;     /* ID assigned by datapath. */
+    ovs_be16 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 */
+    /* Followed by:
+     *   - Match
+     *   - 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.
+     */
+    /* struct ofp12_match match; */
+    /* uint8_t pad[2];         Align to 64 bit + 16 bit */
+    /* uint8_t data[0];        Ethernet frame */
+};
+OFP_ASSERT(sizeof(struct ofp12_packet_in) == 16);
+
+/* Flow removed (datapath -> controller). */
+struct ofp12_flow_removed {
+    struct ofp_header header;
+    ovs_be64 cookie;          /* Opaque controller-issued identifier. */
+
+    ovs_be16 priority;        /* Priority level of flow entry. */
+    uint8_t reason;           /* One of OFPRR_*. */
+    uint8_t table_id;         /* ID of the table */
+
+    ovs_be32 duration_sec;    /* Time flow was alive in seconds. */
+    ovs_be32 duration_nsec;   /* Time flow was alive in nanoseconds beyond
+                                 duration_sec. */
+    ovs_be16 idle_timeout;    /* Idle timeout from original flow mod. */
+    ovs_be16 hard_timeout;    /* Hard timeout from original flow mod. */
+    ovs_be64 packet_count;
+    ovs_be64 byte_count;
+    /* struct ofp12_match match;  Description of fields. Variable size. */
+};
+OFP_ASSERT(sizeof(struct ofp12_flow_removed) == 48);
+
+#endif /* openflow/openflow-1.2.h */
index fd38b72..9ef8873 100644 (file)
@@ -73,6 +73,7 @@
  */
 #define OFP10_VERSION   0x01
 #define OFP11_VERSION   0x02
+#define OFP12_VERSION   0x03
 
 #define OFP_MAX_TABLE_NAME_LEN 32
 #define OFP_MAX_PORT_NAME_LEN  16
@@ -189,7 +190,7 @@ struct ofp_switch_features {
     uint8_t pad[3];         /* Align to 64-bits. */
 
     /* Features. */
-    ovs_be32 capabilities;  /* OFPC_*, OFPC10_*, OFPC11_*. */
+    ovs_be32 capabilities;  /* OFPC_*, OFPC10_*, OFPC11_*, OFPC12_*. */
     ovs_be32 actions;       /* Bitmap of supported "ofp_action_type"s. */
 
     /* Followed by an array of struct ofp10_phy_port or struct ofp11_port
@@ -251,6 +252,7 @@ OFP_ASSERT(sizeof(struct ofp_port_status) == 16);
 enum ofp_match_type {
     OFPMT_STANDARD = 0,         /* The match fields defined in the ofp11_match
                                    structure apply */
+    OFPMT_OXM = 1,              /* OpenFlow Extensible Match */
 };
 
 #endif /* openflow/openflow-common.h */
index 769a0ad..7ae750a 100644 (file)
@@ -19,5 +19,6 @@
 
 #include "openflow/openflow-1.0.h"
 #include "openflow/openflow-1.1.h"
+#include "openflow/openflow-1.2.h"
 
 #endif /* openflow/openflow.h */