| # Copyright 2013, Big Switch Networks, Inc. |
| # |
| # LoxiGen is licensed under the Eclipse Public License, version 1.0 (EPL), with |
| # the following special exception: |
| # |
| # LOXI Exception |
| # |
| # As a special exception to the terms of the EPL, you may distribute libraries |
| # generated by LoxiGen (LoxiGen Libraries) under the terms of your choice, provided |
| # that copyright and licensing notices generated by LoxiGen are not altered or removed |
| # from the LoxiGen Libraries and the notice provided below is (i) included in |
| # the LoxiGen Libraries, if distributed in source code form and (ii) included in any |
| # documentation for the LoxiGen Libraries, if distributed in binary form. |
| # |
| # Notice: "Copyright 2013, Big Switch Networks, Inc. This library was generated by the LoxiGen Compiler." |
| # |
| # You may not use this file except in compliance with the EPL or LOXI Exception. You may obtain |
| # a copy of the EPL at: |
| # |
| # http://www.eclipse.org/legal/epl-v10.html |
| # |
| # 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 |
| # EPL for the specific language governing permissions and limitations |
| # under the EPL. |
| |
| ## |
| # @brief Global data structs for LOXI code generation |
| # |
| # @fixme This needs to be refactored and brought into the 21st century. |
| # |
| |
| import loxi_globals |
| |
| ################################################################ |
| # |
| # Configuration global parameters |
| # |
| ################################################################ |
| |
| ## |
| # The map from wire protocol to enum identifier generated from input |
| # This is built from the version-specific structs file info. |
| # @fixme This should go away when the process structs file is updated |
| wire_ver_map = {} |
| |
| ## |
| # The list of wire versions which are to be supported |
| target_version_list = [] |
| |
| ## |
| # The dictionary of config variables related to code |
| # |
| # @param use_obj_id Use object IDs in struct defns CURRENTLY NOT SUPPORTED |
| # |
| # @param return_base_types For 'get' accessors, return values when possible. |
| # Otherwise all values are returned thru a call by variable parameter |
| # |
| # @param use_static_inlines Generate low level accessors as static inline |
| # and put them in header files rather than .c files. |
| # |
| # @param copy_semantics One of "read", "write" or "grow". This defines the |
| # way that buffer references are managed. Currently on "read" is supported. |
| # |
| # @param encode_typedefs Use object and member IDs (rather than names) |
| # when generating the names used for accessor function typedefs |
| # |
| # @param get_returns One of "error", "value", or "void"; |
| # CURRENTLY ONLY "error" IS SUPPORTED. "error" means |
| # all get operations return an error code. "value" means return a base_type |
| # value when possible or void if not. "void" means always return void |
| # and use a call-by-variable parameter |
| # |
| |
| ## These members do not get normal accessors |
| |
| skip_members = ["version", "type", "length", "err_type", "stats_type", "len", |
| "type_len", "actions_len", "_command", "command", "key_length"] |
| |
| ## Some OpenFlow string length constants |
| # |
| # These are a few length constants needed for array processing |
| ofp_constants = dict( |
| OF_MAX_TABLE_NAME_LEN = 32, |
| OF_MAX_PORT_NAME_LEN = 16, |
| OF_ETH_ALEN = 6, |
| OF_DESC_STR_LEN = 256, |
| OF_SERIAL_NUM_LEN = 32, |
| OF_APP_CODE_LEN = 15, |
| OF_SIGID_LEN=6, |
| ) |
| |
| ## List of mixed data types |
| # |
| # This is a list of data types which require special treatment |
| # because the underlying datatype has changed between versions. |
| # The main example is port which went from 16 to 32 bits. We |
| # define per-version accessors for these types and those are |
| # used in place of the normal ones. |
| # |
| # The wire protocol number is used to identify versions. For now, |
| # the value is the name of the type to use for that version |
| # |
| # This is the map between the external type (like of_port_no_t) |
| # which is used by customers of this code and the internal |
| # datatypes (like uint16_t) that appear on the wire for a |
| # particular version. |
| # |
| of_mixed_types = dict( |
| of_port_no_t = { |
| 1: "uint16_t", |
| 2: "uint32_t", |
| 3: "uint32_t", |
| 4: "uint32_t", |
| 5: "uint32_t", |
| "short_name":"port_no" |
| }, |
| of_port_desc_t = { |
| 1: "of_port_desc_t", |
| 2: "of_port_desc_t", |
| 3: "of_port_desc_t", |
| 4: "of_port_desc_t", |
| 5: "of_port_desc_t", |
| "short_name":"port_desc" |
| }, |
| of_bsn_vport_t = { |
| 1: "of_bsn_vport_t", |
| 2: "of_bsn_vport_t", |
| 3: "of_bsn_vport_t", |
| 4: "of_bsn_vport_t", |
| 5: "of_bsn_vport_t", |
| "short_name":"bsn_vport" |
| }, |
| of_fm_cmd_t = { # Flow mod command went from u16 to u8 |
| 1: "uint16_t", |
| 2: "uint8_t", |
| 3: "uint8_t", |
| 4: "uint8_t", |
| 5: "uint8_t", |
| "short_name":"fm_cmd" |
| }, |
| of_wc_bmap_t = { # Wildcard bitmap |
| 1: "uint32_t", |
| 2: "uint32_t", |
| 3: "uint64_t", |
| 4: "uint64_t", |
| 5: "uint64_t", |
| "short_name":"wc_bmap" |
| }, |
| of_match_bmap_t = { # Match bitmap |
| 1: "uint32_t", |
| 2: "uint32_t", |
| 3: "uint64_t", |
| 4: "uint64_t", |
| 5: "uint64_t", |
| "short_name":"match_bmap" |
| }, |
| of_match_t = { # Match object |
| 1: "of_match_v1_t", |
| 2: "of_match_v2_t", |
| 3: "of_match_v3_t", |
| 4: "of_match_v3_t", # Currently uses same match as 1.2 (v3). |
| 5: "of_match_v3_t", # Currently uses same match as 1.2 (v3). |
| "short_name":"match" |
| }, |
| of_calient_port_desc_stats_entry_t = { |
| 1: "of_calient_port_desc_stats_entry_t", |
| 2: "of_calient_port_desc_stats_entry_t", |
| 3: "of_calient_port_desc_stats_entry_t", |
| 4: "of_calient_port_desc_stats_entry_t", |
| 5: "of_calient_port_desc_stats_entry_t", |
| "short_name":"calient_port_desc_stats_entry" |
| }, |
| of_odu_sig_id_t = { |
| 1: "of_odu_sig_id_t", |
| 2: "of_odu_sig_id_t", |
| 3: "of_odu_sig_id_t", |
| 4: "of_odu_sig_id_t", |
| 5: "of_odu_sig_id_t", |
| "short_name":"odu_sig_id" |
| }, |
| of_och_sig_id_t = { |
| 1: "of_sig_id_t", |
| 2: "of_sig_id_t", |
| 3: "of_sig_id_t", |
| 4: "of_sig_id_t", |
| 5: "of_sig_id_t", |
| "short_name":"sig_id" |
| }, |
| |
| ) |
| |
| ## Base data types |
| # |
| # The basic types; Value is a list: bytes, to_wire, from_wire |
| # The accessors deal with endian, alignment and any other host/network |
| # considerations. These are common across all versions |
| # |
| # For get accessors, assume we memcpy from wire buf and then apply ntoh |
| # For set accessors, assume we apply hton and then memcpy to wire buf |
| # |
| # to/from wire functions take a pointer to class and change in place |
| of_base_types = dict( |
| char = dict(bytes=1, use_as_rv=1, short_name="char"), |
| uint8_t = dict(bytes=1, use_as_rv=1, short_name="u8"), |
| uint16_t = dict(bytes=2, to_w="u16_hton", from_w="u16_ntoh", use_as_rv=1, |
| short_name="u16"), |
| uint32_t = dict(bytes=4, to_w="u32_hton", from_w="u32_ntoh", use_as_rv=1, |
| short_name="u32"), |
| uint64_t = dict(bytes=8, to_w="u64_hton", from_w="u64_ntoh", use_as_rv=1, |
| short_name="u64"), |
| # of_cookie_t = dict(bytes=8, to_w="u64_hton", from_w="u64_ntoh", use_as_rv=1#, |
| # short_name="cookie"), |
| # of_counter_t = dict(bytes=8, to_w="u64_hton", from_w="u64_ntoh", use_as_rv=1, |
| # short_name="counter"), |
| of_mac_addr_t = dict(bytes=6, short_name="mac"), |
| of_ipv4_t = dict(bytes=4, short_name="ipv4"), |
| of_ipv6_t = dict(bytes=16, short_name="ipv6"), |
| of_port_name_t = dict(bytes=ofp_constants["OF_MAX_PORT_NAME_LEN"], |
| short_name="port_name"), |
| of_table_name_t = dict(bytes=ofp_constants["OF_MAX_TABLE_NAME_LEN"], |
| short_name="tab_name"), |
| of_desc_str_t = dict(bytes=ofp_constants["OF_DESC_STR_LEN"], |
| short_name="desc_str"), |
| of_serial_num_t = dict(bytes=ofp_constants["OF_SERIAL_NUM_LEN"], |
| short_name="ser_num"), |
| of_str64_t = dict(bytes=64, short_name="str64"), |
| of_str32_t = dict(bytes=32, short_name="str32"), |
| of_str6_t = dict(bytes=6, short_name="str6"), |
| of_match_v1_t = dict(bytes=40, to_w="match_v1_hton", |
| from_w="match_v1_ntoh", |
| short_name="match_v1"), |
| of_match_v2_t = dict(bytes=88, to_w="match_v2_hton", |
| from_w="match_v2_ntoh", |
| short_name="match_v2"), |
| of_match_v3_t = dict(bytes=-1, to_w="match_v3_hton", |
| from_w="match_v3_ntoh", |
| short_name="match_v3"), |
| # of_match_v4_t = dict(bytes=-1, to_w="match_v4_hton", |
| # from_w="match_v4_ntoh", |
| # short_name="match_v4"), |
| of_octets_t = dict(bytes=-1, short_name="octets"), |
| of_bitmap_128_t = dict(bytes=16, short_name="bitmap_128"), |
| of_bitmap_512_t = dict(bytes=64, short_name="bitmap_512"), |
| of_checksum_128_t = dict(bytes=16, short_name="checksum_128"), |
| of_app_code_t = dict(bytes=ofp_constants["OF_APP_CODE_LEN"], |
| short_name="app_code"), |
| of_sig_id_t = dict(bytes=ofp_constants["OF_SIGID_LEN"], |
| short_name="sig_id"), |
| of_odu_sig_id_t = dict(bytes=1, short_name="odu_sig_id"), |
| ) |
| |
| of_scalar_types = ["char", "uint8_t", "uint16_t", "uint32_t", "uint64_t", |
| "of_port_no_t", "of_fm_cmd_t", "of_wc_bmap_t", |
| "of_match_bmap_t", "of_port_name_t", "of_table_name_t", |
| "of_desc_str_t", "of_serial_num_t", "of_mac_addr_t", |
| "of_ipv6_t", "of_ipv4_t", "of_bitmap_128_t", "of_checksum_128_t", |
| "of_str64_t", "of_str32_t", "of_str6_t", "of_bitmap_512_t"] |
| |
| ## |
| # LOXI identifiers |
| # |
| # Dict indexed by identifier name. Each entry contains the information |
| # as a DotDict with the following keys: |
| # values: A dict indexed by wire version giving each verion's value or None |
| # common: The common value to use for this identifier at the LOXI top level (TBD) |
| # all_same: If True, all the values across all versions are the same |
| # ofp_name: The original name for the identifier |
| # ofp_group: The ofp enumerated type if defined |
| |
| identifiers = {} |
| |
| ## |
| # Identifiers by original group |
| # Keys are the original group names. Value is a list of LOXI identifiers |
| |
| identifiers_by_group = {} |
| |
| ## Ordered list of class names |
| # This is per-wire-version and is a list of the classes in the order |
| # they appear in the file. That is important because of the assumption |
| # that data members are defined before they are included in a superclass. |
| ordered_classes = {} # Indexed by wire version |
| |
| ## Per class ordered list of member names |
| ordered_members = {} |
| |
| ## Ordered list of message classes |
| ordered_messages = [] |
| |
| ## Ordered list of non message classes |
| ordered_non_messages = [] |
| |
| ## The objects that need list support |
| ordered_list_objects = [] |
| |
| ## Stats request/reply are pseudo objects |
| ordered_pseudo_objects = [] |
| |
| ## Standard order is normally messages followed by non-messages |
| standard_class_order = [] |
| |
| ## All classes in order, including psuedo classes for which most code |
| # is not generated. |
| all_class_order = [] |
| |
| ## Map from class, wire_version to size of fixed part of class |
| base_length = {} |
| |
| ## Boolean indication of variable length, per class, wire_version, |
| is_fixed_length = set() |
| |
| ## The global object ID counter |
| object_id = 1 # Reserve 0 for root object |
| |
| ## The unified view of all classes. See internal readme. |
| unified = {} |
| |
| ## Indicates data members with non-fixed start offsets |
| # Indexed by (cls, version, member-name) and value is prev-member-name |
| special_offsets = {} |
| |
| # Map from wire version to OF_1_x |
| short_version_names = {} |
| |
| # The iteration object that gives the wire versions supported |
| of_version_range = [] |
| |
| # Map from wire version to OF_VERSION_1_x |
| of_version_wire2name = {} |
| |
| for version in loxi_globals.OFVersions.all_supported: |
| globals()[version.constant] = version.wire_version |
| |
| |
| ################################################################ |
| # |
| # Experimenters, vendors, extensions |
| # |
| # Although the term "experimenter" is used for identifying |
| # external extension definitions, we generally use the term |
| # extension when refering to the messages or objects themselves. |
| # |
| # Conventions: |
| # |
| # Extension messages should start with of_<experimenter>_ |
| # Extension actions should start with of_<experimenter>_action_ |
| # Extension instructions should start with of_<experimenter>_instructions_ |
| # |
| # Currently, the above conventions are not enforced; the mapping |
| # is done brute force in type_maps.py |
| # |
| ################################################################ |
| |
| # The map of known experimenters to their experimenter IDs |
| experimenter_name_to_id = dict( |
| bsn = 0x005c16c7, |
| nicira = 0x00002320, |
| openflow = 0x000026e1 |
| ) |