FD.io VPP  v18.07.1-19-g511ce25
Vector Packet Processing
l2_input.h
Go to the documentation of this file.
1 /*
2  * l2_input.h : layer 2 input packet processing
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_vnet_l2_input_h
19 #define included_vnet_l2_input_h
20 
21 #include <vlib/vlib.h>
22 #include <vnet/vnet.h>
23 #include <vnet/l2/l2_bd.h>
24 #include <vnet/ethernet/packet.h>
25 #include <vnet/ip/ip.h>
26 
27 /* Per-subinterface L2 feature configuration */
28 
29 typedef struct
30 {
31 
32  union
33  {
34  u16 bd_index; /* bridge domain id */
35  u32 output_sw_if_index; /* for xconnect */
36  };
37 
38  /* Interface mode. If both are 0, this interface is in L3 mode */
41 
42  /* this is the bvi interface for the bridge-domain */
44 
45  /* config for which input features are configured on this interface */
47 
48  /* some of these flags are also in the feature bitmap */
52 
53  /* split horizon group */
55 
57 
58 
59 typedef struct
60 {
61 
62  /* Next nodes for the feature bitmap */
63  u32 feat_next_node_index[32];
64 
65  /* config vector indexed by sw_if_index */
67 
68  /* bridge domain config vector indexed by bd_index */
70 
71  /* convenience variables */
75 
77 
79 
82 {
83  l2_bridge_domain_t *bd_config;
84 
85  bd_config = vec_elt_at_index (l2im->bd_configs, bd_index);
86  return bd_is_valid (bd_config) ? bd_config : NULL;
87 }
88 
91 {
93  l2_bridge_domain_t *bd_config;
94 
95  vec_validate (mp->bd_configs, bd_index);
96  bd_config = vec_elt_at_index (mp->bd_configs, bd_index);
97  return bd_config;
98 }
99 
100 /* L2 input indication packet is from BVI, using -2 */
101 #define L2INPUT_BVI ((u32) (~0-1))
102 
103 /* L2 input features */
104 
105 /* Mappings from feature ID to graph node name in reverse order */
106 #define foreach_l2input_feat \
107  _(DROP, "feature-bitmap-drop") \
108  _(XCONNECT, "l2-output") \
109  _(FLOOD, "l2-flood") \
110  _(ARP_TERM, "arp-term-l2bd") \
111  _(UU_FLOOD, "l2-flood") \
112  _(GBP_FWD, "gbp-fwd") \
113  _(FWD, "l2-fwd") \
114  _(RW, "l2-rw") \
115  _(LEARN, "l2-learn") \
116  _(L2_EMULATION, "l2-emulation") \
117  _(GBP_NULL_CLASSIFY, "gbp-null-classify") \
118  _(GBP_SRC_CLASSIFY, "gbp-src-classify") \
119  _(VTR, "l2-input-vtr") \
120  _(L2_IP_QOS_RECORD, "l2-ip-qos-record") \
121  _(VPATH, "vpath-input-l2") \
122  _(ACL, "l2-input-acl") \
123  _(POLICER_CLAS, "l2-policer-classify") \
124  _(INPUT_CLASSIFY, "l2-input-classify") \
125  _(SPAN, "span-l2-input")
126 
127 /* Feature bitmap positions */
128 typedef enum
129 {
130 #define _(sym,str) L2INPUT_FEAT_##sym##_BIT,
132 #undef _
135 
136 STATIC_ASSERT (L2INPUT_N_FEAT <= 32, "too many l2 input features");
137 
138 /* Feature bit masks */
139 typedef enum
140 {
141 #define _(sym,str) L2INPUT_FEAT_##sym = (1<<L2INPUT_FEAT_##sym##_BIT),
143 #undef _
145 #define _(sym,str) L2INPUT_FEAT_##sym |
147 #undef _
148  0
150 
151 STATIC_ASSERT ((u64) L2INPUT_VALID_MASK == (1ull << L2INPUT_N_FEAT) - 1, "");
152 
153 /** Return an array of strings containing graph node names of each feature */
154 char **l2input_get_feat_names (void);
155 
156 /* arg0 - u32 feature_bitmap */
157 u8 *format_l2_input_features (u8 * s, va_list * args);
158 
161 {
162  return ((bd_config->feature_bitmap & L2INPUT_FEAT_FLOOD) ==
163  L2INPUT_FEAT_FLOOD);
164 }
165 
168 {
169  return ((bd_config->feature_bitmap & L2INPUT_FEAT_UU_FLOOD) ==
170  L2INPUT_FEAT_UU_FLOOD);
171 }
172 
175 {
176  return ((bd_config->feature_bitmap & L2INPUT_FEAT_FWD) == L2INPUT_FEAT_FWD);
177 }
178 
181 {
182  return ((bd_config->feature_bitmap & L2INPUT_FEAT_LEARN) ==
183  L2INPUT_FEAT_LEARN);
184 }
185 
188 {
189  return ((bd_config->feature_bitmap & L2INPUT_FEAT_ARP_TERM) ==
190  L2INPUT_FEAT_ARP_TERM);
191 }
192 
193 /** Masks for eliminating features that do not apply to a packet */
194 
195 /** Get a pointer to the config for the given interface */
197 
198 /* Enable (or disable) the feature in the bitmap for the given interface */
199 u32 l2input_intf_bitmap_enable (u32 sw_if_index,
200  u32 feature_bitmap, u32 enable);
201 
202 /* Sets modifies flags from a bridge domain */
203 u32 l2input_set_bridge_features (u32 bd_index, u32 feat_mask, u32 feat_value);
204 
205 
206 #define MODE_L3 0
207 #define MODE_L2_BRIDGE 1
208 #define MODE_L2_XC 2
209 #define MODE_L2_CLASSIFY 3
210 
211 #define MODE_ERROR_ETH 1
212 #define MODE_ERROR_BVI_DEF 2
213 
216  u32 mode,
217  u32 sw_if_index,
218  u32 bd_index, u32 bvi, u32 shg, u32 xc_sw_if_index);
219 
220 static inline void
222 {
223  ethernet_header_t *eth;
224  u16 ethertype;
225  u8 vlan_count = 0;
226 
227  /* point at currrent l2 hdr */
228  eth = vlib_buffer_get_current (b);
229 
230  /*
231  * l2-output pays no attention to this
232  * but the tag push/pop code on an l2 subif needs it.
233  *
234  * Determine l2 header len, check for up to 2 vlans
235  */
236  vnet_buffer (b)->l2.l2_len = sizeof (ethernet_header_t);
237  ethertype = clib_net_to_host_u16 (eth->type);
238  if (ethernet_frame_is_tagged (ethertype))
239  {
241  vnet_buffer (b)->l2.l2_len += sizeof (*vlan);
242  vlan_count = 1;
243  vlan = (void *) (eth + 1);
244  ethertype = clib_net_to_host_u16 (vlan->type);
245  if (ethertype == ETHERNET_TYPE_VLAN)
246  {
247  vnet_buffer (b)->l2.l2_len += sizeof (*vlan);
248  vlan_count = 2;
249  }
250  }
251  ethernet_buffer_set_vlan_count (b, vlan_count);
252 }
253 
254 /*
255  * Compute flow hash of an ethernet packet, use 5-tuple hash if L3 packet
256  * is ip4 or ip6. Otherwise hash on smac/dmac/etype.
257  * The vlib buffer current pointer is expected to be at ethernet header
258  * and vnet l2.l2_len is exppected to be setup already.
259  */
260 static inline u32
262 {
264  u8 *l3h = (u8 *) eh + vnet_buffer (b)->l2.l2_len;
265  u16 ethertype = clib_net_to_host_u16 (*(u16 *) (l3h - 2));
266 
267  if (ethertype == ETHERNET_TYPE_IP4)
269  else if (ethertype == ETHERNET_TYPE_IP6)
271  else
272  {
273  u32 a, b, c;
274  u32 *ap = (u32 *) & eh->dst_address[2];
275  u32 *bp = (u32 *) & eh->src_address[2];
276  a = *ap;
277  b = *bp;
278  c = ethertype;
279  hash_v3_mix32 (a, b, c);
280  hash_v3_finalize32 (a, b, c);
281  return c;
282  }
283 }
284 
285 #endif
286 
287 
288 /*
289  * fd.io coding-style-patch-verification: ON
290  *
291  * Local Variables:
292  * eval: (c-set-style "gnu")
293  * End:
294  */
#define vec_validate(V, I)
Make sure vector is long enough for given index (no header, unspecified alignment) ...
Definition: vec.h:437
static_always_inline u8 bd_feature_forward(l2_bridge_domain_t *bd_config)
Definition: l2_input.h:174
l2_input_config_t * configs
Definition: l2_input.h:66
a
Definition: bitmap.h:538
STATIC_ASSERT(L2INPUT_N_FEAT<=32,"too many l2 input features")
unsigned long u64
Definition: types.h:89
#define NULL
Definition: clib.h:55
static u32 ip4_compute_flow_hash(const ip4_header_t *ip, flow_hash_config_t flow_hash_config)
Definition: ip4.h:287
u8 src_address[6]
Definition: packet.h:56
static_always_inline u8 bd_feature_uu_flood(l2_bridge_domain_t *bd_config)
Definition: l2_input.h:167
u8 * format_l2_input_features(u8 *s, va_list *args)
Definition: l2_input.c:66
#define hash_v3_mix32(a, b, c)
Definition: hash.h:554
unsigned char u8
Definition: types.h:56
#define static_always_inline
Definition: clib.h:93
u32 output_sw_if_index
Definition: l2_input.h:35
u8 dst_address[6]
Definition: packet.h:55
u32 l2input_set_bridge_features(u32 bd_index, u32 feat_mask, u32 feat_value)
Definition: l2_input.c:533
#define vec_elt_at_index(v, i)
Get vector value at index i checking that i is in bounds.
static_always_inline u8 bd_feature_arp_term(l2_bridge_domain_t *bd_config)
Definition: l2_input.h:187
l2_input_config_t * l2input_intf_config(u32 sw_if_index)
Masks for eliminating features that do not apply to a packet.
Definition: l2_input.c:510
u32 l2input_intf_bitmap_enable(u32 sw_if_index, u32 feature_bitmap, u32 enable)
Enable (or disable) the feature in the bitmap for the given interface.
Definition: l2_input.c:520
unsigned int u32
Definition: types.h:88
l2input_main_t l2input_main
Definition: l2_input.c:113
l2input_feat_t
Definition: l2_input.h:128
static_always_inline u8 bd_feature_flood(l2_bridge_domain_t *bd_config)
Definition: l2_input.h:160
char ** l2input_get_feat_names(void)
Return an array of strings containing graph node names of each feature.
Definition: l2_input.c:60
vnet_main_t * vnet_main
Definition: l2_input.h:73
unsigned short u16
Definition: types.h:57
static u32 vnet_l2_compute_flow_hash(vlib_buffer_t *b)
Definition: l2_input.h:261
static void * vlib_buffer_get_current(vlib_buffer_t *b)
Get pointer to current data to process.
Definition: buffer.h:202
static u32 ip6_compute_flow_hash(const ip6_header_t *ip, flow_hash_config_t flow_hash_config)
Definition: ip6.h:430
vnet_main_t vnet_main
Definition: misc.c:43
#define ethernet_buffer_set_vlan_count(b, v)
Sets the number of VLAN headers in the current Ethernet frame in the buffer.
Definition: ethernet.h:397
l2input_feat_masks_t
Definition: l2_input.h:139
static u32 bd_is_valid(l2_bridge_domain_t *bd_config)
Definition: l2_bd.h:117
svmdb_client_t * c
vlib_main_t * vm
Definition: buffer.c:294
vlib_node_registration_t l2input_node
(constructor) VLIB_REGISTER_NODE (l2input_node)
Definition: l2_input.c:458
static_always_inline u8 bd_feature_learn(l2_bridge_domain_t *bd_config)
Definition: l2_input.h:180
static_always_inline l2_bridge_domain_t * l2input_bd_config(u32 bd_index)
Definition: l2_input.h:90
#define foreach_l2input_feat
Definition: l2_input.h:106
static_always_inline l2_bridge_domain_t * l2input_bd_config_from_index(l2input_main_t *l2im, u32 bd_index)
Definition: l2_input.h:81
#define hash_v3_finalize32(a, b, c)
Definition: hash.h:564
static_always_inline int ethernet_frame_is_tagged(u16 type)
Definition: ethernet.h:85
#define IP_FLOW_HASH_DEFAULT
Default: 5-tuple without the "reverse" bit.
Definition: lookup.h:69
struct _vlib_node_registration vlib_node_registration_t
u32 feature_bitmap
Definition: l2_bd.h:56
static void vnet_update_l2_len(vlib_buffer_t *b)
Definition: l2_input.h:221
l2_bridge_domain_t * bd_configs
Definition: l2_input.h:69
#define vnet_buffer(b)
Definition: buffer.h:360
u32 set_int_l2_mode(vlib_main_t *vm, vnet_main_t *vnet_main, u32 mode, u32 sw_if_index, u32 bd_index, u32 bvi, u32 shg, u32 xc_sw_if_index)
Set the subinterface to run in l2 or l3 mode.
Definition: l2_input.c:551
vlib_main_t * vlib_main
Definition: l2_input.h:72