src/vnet/l2/l2_bd.h

   1 /*
   2  * l2_bd.h : layer 2 bridge domain
   3  *
   4  * Copyright (c) 2013 Cisco and/or its affiliates.
   5  * Licensed under the Apache License, Version 2.0 (the "License");
   6  * you may not use this file except in compliance with the License.
   7  * You may obtain a copy of the License at:
   8  *
   9  *     http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  * Unless required by applicable law or agreed to in writing, software
  12  * distributed under the License is distributed on an "AS IS" BASIS,
  13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  * See the License for the specific language governing permissions and
  15  * limitations under the License.
  16  */
  17
  18 #ifndef included_l2bd_h
  19 #define included_l2bd_h
  20
  21 #include <vlib/vlib.h>
  22 #include <vnet/vnet.h>
  23 #include <vnet/ip/ip46_address.h>
  24 #include <vnet/ethernet/mac_address.h>
  25
  26 typedef enum l2_bd_port_type_t_
  27 {
  28   L2_BD_PORT_TYPE_NORMAL = 0,
  29   L2_BD_PORT_TYPE_BVI = 1,
  30   L2_BD_PORT_TYPE_UU_FWD = 2,
  31 } l2_bd_port_type_t;
  32
  33 typedef struct
  34 {
  35   /* hash bd_id -> bd_index */
  36   uword *bd_index_by_bd_id;
  37
  38   /* Busy bd_index bitmap */
  39   uword *bd_index_bitmap;
  40
  41   /* convenience */
  42   vlib_main_t *vlib_main;
  43   vnet_main_t *vnet_main;
  44 } bd_main_t;
  45
  46 extern bd_main_t bd_main;
  47
  48 /* Bridge domain member  */
  49
  50 #define L2_FLOOD_MEMBER_NORMAL 0
  51 #define L2_FLOOD_MEMBER_BVI    1
  52
  53 typedef struct
  54 {
  55   u32 sw_if_index;              /* the output L2 interface */
  56   u8 flags;                     /* 0=normal, 1=bvi */
  57   u8 shg;                       /* split horizon group number  */
  58   u16 spare;
  59 } l2_flood_member_t;
  60
  61 /* Per-bridge domain configuration */
  62
  63 typedef struct
  64 {
  65   /*
  66    * Contains bit enables for flooding, learning, and forwarding.
  67    * All other feature bits should always be set.
  68    */
  69   u32 feature_bitmap;
  70   /*
  71    * identity of the bridge-domain's BVI interface
  72    * set to ~0 if there is no BVI
  73    */
  74   u32 bvi_sw_if_index;
  75
  76   /*
  77    * identity of the bridge-domain's UU flood interface
  78    * set to ~0 if there is no such configuration
  79    */
  80   u32 uu_fwd_sw_if_index;
  81
  82   /* bridge domain id, not to be confused with bd_index */
  83   u32 bd_id;
  84
  85   /* Vector of member ports */
  86   l2_flood_member_t *members;
  87
  88   /* First flood_count member ports are flooded */
  89   u32 flood_count;
  90
  91   /* Tunnel Master (Multicast vxlan) are always flooded */
  92   u32 tun_master_count;
  93
  94   /* Tunnels (Unicast vxlan) are flooded if there are no masters */
  95   u32 tun_normal_count;
  96
  97   /* Interface on which packets are not flooded */
  98   u32 no_flood_count;
  99
 100   /* hash ip4/ip6 -> mac for arp/nd termination */
 101   uword *mac_by_ip4;
 102   uword *mac_by_ip6;
 103
 104   /* mac aging */
 105   u8 mac_age;
 106
 107   /* sequence number for bridge domain based flush of MACs */
 108   u8 seq_num;
 109
 110   /* Bridge domain tag (C string NULL terminated) */
 111   u8 *bd_tag;
 112
 113 } l2_bridge_domain_t;
 114
 115 /* Limit Bridge Domain ID to 24 bits to match 24-bit VNI range */
 116 #define L2_BD_ID_MAX ((1<<24)-1)
 117
 118 typedef struct
 119 {
 120   u32 bd_id;
 121   u8 flood;
 122   u8 uu_flood;
 123   u8 forward;
 124   u8 learn;
 125   u8 arp_term;
 126   u8 arp_ufwd;
 127   u8 mac_age;
 128   u8 *bd_tag;
 129   u8 is_add;
 130 } l2_bridge_domain_add_del_args_t;
 131
 132 /* Return 1 if bridge domain has been initialized */
 133 always_inline u32
 134 bd_is_valid (l2_bridge_domain_t * bd_config)
 135 {
 136   return (bd_config->feature_bitmap != 0);
 137 }
 138
 139 /* Init bridge domain if not done already */
 140 void bd_validate (l2_bridge_domain_t * bd_config);
 141
 142
 143 void
 144 bd_add_member (l2_bridge_domain_t * bd_config, l2_flood_member_t * member);
 145
 146 u32 bd_remove_member (l2_bridge_domain_t * bd_config, u32 sw_if_index);
 147
 148 typedef enum bd_flags_t_
 149 {
 150   L2_NONE = 0,
 151   L2_LEARN = (1 << 0),
 152   L2_FWD = (1 << 1),
 153   L2_FLOOD = (1 << 2),
 154   L2_UU_FLOOD = (1 << 3),
 155   L2_ARP_TERM = (1 << 4),
 156   L2_ARP_UFWD = (1 << 5),
 157 } bd_flags_t;
 158
 159 u32 bd_set_flags (vlib_main_t * vm, u32 bd_index, bd_flags_t flags,
 160                   u32 enable);
 161 void bd_set_mac_age (vlib_main_t * vm, u32 bd_index, u8 age);
 162 int bd_add_del (l2_bridge_domain_add_del_args_t * args);
 163
 164 /**
 165  * \brief Get a bridge domain.
 166  *
 167  * Get a bridge domain with the given bridge domain ID.
 168  *
 169  * \param bdm bd_main pointer.
 170  * \param bd_id The bridge domain ID
 171  * \return The bridge domain index in \c l2input_main->l2_bridge_domain_t vector.
 172  */
 173 u32 bd_find_index (bd_main_t * bdm, u32 bd_id);
 174
 175 /**
 176  * \brief Create a bridge domain.
 177  *
 178  * Create a bridge domain with the given bridge domain ID
 179  *
 180  * \param bdm bd_main pointer.
 181  * \return The bridge domain index in \c l2input_main->l2_bridge_domain_t vector.
 182  */
 183 u32 bd_add_bd_index (bd_main_t * bdm, u32 bd_id);
 184
 185 /**
 186  * \brief Get or create a bridge domain.
 187  *
 188  * Get a bridge domain with the given bridge domain ID, if one exists, otherwise
 189  * create one with the given ID, or the first unused ID if the given ID is ~0..
 190  *
 191  * \param bdm bd_main pointer.
 192  * \param bd_id The bridge domain ID
 193  * \return The bridge domain index in \c l2input_main->l2_bridge_domain_t vector.
 194  */
 195 static inline u32
 196 bd_find_or_add_bd_index (bd_main_t * bdm, u32 bd_id)
 197 {
 198   u32 bd_index = bd_find_index (bdm, bd_id);
 199   if (bd_index == ~0)
 200     return bd_add_bd_index (bdm, bd_id);
 201   return bd_index;
 202 }
 203
 204 u32 bd_add_del_ip_mac (u32 bd_index,
 205                        ip46_type_t type,
 206                        const ip46_address_t * ip_addr,
 207                        const mac_address_t * mac, u8 is_add);
 208
 209 void bd_flush_ip_mac (u32 bd_index);
 210
 211 #endif
 212
 213 /*
 214  * fd.io coding-style-patch-verification: ON
 215  *
 216  * Local Variables:
 217  * eval: (c-set-style "gnu")
 218  * End:
 219  */