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   /* Maximum number of learned entries */
 114   u32 learn_limit;
 115
 116   /* Current number of learned entries */
 117   u32 learn_count;
 118
 119 } l2_bridge_domain_t;
 120
 121 /* Limit Bridge Domain ID to 24 bits to match 24-bit VNI range */
 122 #define L2_BD_ID_MAX ((1<<24)-1)
 123
 124 typedef struct
 125 {
 126   u32 bd_id;
 127   u8 flood;
 128   u8 uu_flood;
 129   u8 forward;
 130   u8 learn;
 131   u8 arp_term;
 132   u8 arp_ufwd;
 133   u8 mac_age;
 134   u8 *bd_tag;
 135   u8 is_add;
 136 } l2_bridge_domain_add_del_args_t;
 137
 138 /* Return 1 if bridge domain has been initialized */
 139 always_inline u32
 140 bd_is_valid (l2_bridge_domain_t * bd_config)
 141 {
 142   return (bd_config->feature_bitmap != 0);
 143 }
 144
 145 /* Init bridge domain if not done already */
 146 void bd_validate (l2_bridge_domain_t * bd_config);
 147
 148 void
 149 bd_add_member (l2_bridge_domain_t * bd_config, l2_flood_member_t * member);
 150
 151 u32 bd_remove_member (l2_bridge_domain_t * bd_config, u32 sw_if_index);
 152
 153 typedef enum bd_flags_t_
 154 {
 155   L2_NONE = 0,
 156   L2_LEARN = (1 << 0),
 157   L2_FWD = (1 << 1),
 158   L2_FLOOD = (1 << 2),
 159   L2_UU_FLOOD = (1 << 3),
 160   L2_ARP_TERM = (1 << 4),
 161   L2_ARP_UFWD = (1 << 5),
 162 } bd_flags_t;
 163
 164 u32 bd_set_flags (vlib_main_t * vm, u32 bd_index, bd_flags_t flags,
 165                   u32 enable);
 166 void bd_set_mac_age (vlib_main_t * vm, u32 bd_index, u8 age);
 167 void bd_set_learn_limit (vlib_main_t *vm, u32 bd_index, u32 learn_limit);
 168 int bd_add_del (l2_bridge_domain_add_del_args_t * args);
 169
 170 /**
 171  * \brief Get a bridge domain.
 172  *
 173  * Get a bridge domain with the given bridge domain ID.
 174  *
 175  * \param bdm bd_main pointer.
 176  * \param bd_id The bridge domain ID
 177  * \return The bridge domain index in \c l2input_main->l2_bridge_domain_t vector.
 178  */
 179 u32 bd_find_index (bd_main_t * bdm, u32 bd_id);
 180
 181 /**
 182  * \brief Create a bridge domain.
 183  *
 184  * Create a bridge domain with the given bridge domain ID
 185  *
 186  * \param bdm bd_main pointer.
 187  * \return The bridge domain index in \c l2input_main->l2_bridge_domain_t vector.
 188  */
 189 u32 bd_add_bd_index (bd_main_t * bdm, u32 bd_id);
 190
 191 /**
 192  * \brief Get or create a bridge domain.
 193  *
 194  * Get a bridge domain with the given bridge domain ID, if one exists, otherwise
 195  * create one with the given ID, or the first unused ID if the given ID is ~0..
 196  *
 197  * \param bdm bd_main pointer.
 198  * \param bd_id The bridge domain ID
 199  * \return The bridge domain index in \c l2input_main->l2_bridge_domain_t vector.
 200  */
 201 static inline u32
 202 bd_find_or_add_bd_index (bd_main_t * bdm, u32 bd_id)
 203 {
 204   u32 bd_index = bd_find_index (bdm, bd_id);
 205   if (bd_index == ~0)
 206     return bd_add_bd_index (bdm, bd_id);
 207   return bd_index;
 208 }
 209
 210 /**
 211  * \brief Walk all the input interfaces in the BD
 212  */
 213 typedef walk_rc_t (*bd_input_walk_fn_t) (u32 bd_index, u32 sw_if_index);
 214
 215 u32 bd_input_walk (u32 bd_index, bd_input_walk_fn_t fn, void *data);
 216
 217 l2_bridge_domain_t *bd_get (u32 bd_index);
 218 l2_bridge_domain_t *bd_get_by_table_id (u32 table_id);
 219
 220 u32 bd_add_del_ip_mac (u32 bd_index,
 221                        ip46_type_t type,
 222                        const ip46_address_t * ip_addr,
 223                        const mac_address_t * mac, u8 is_add);
 224
 225 void bd_flush_ip_mac (u32 bd_index);
 226
 227 #endif
 228
 229 /*
 230  * fd.io coding-style-patch-verification: ON
 231  *
 232  * Local Variables:
 233  * eval: (c-set-style "gnu")
 234  * End:
 235  */