FD.io VPP  v19.01.1-17-ge106252
Vector Packet Processing
encap.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 /**
16  * @file
17  * @brief Functions for encapsulating VXLAN GPE tunnels
18  *
19 */
20 #include <vppinfra/error.h>
21 #include <vppinfra/hash.h>
22 #include <vnet/vnet.h>
23 #include <vnet/ip/ip.h>
24 #include <vnet/ethernet/ethernet.h>
26 
27 /** Statistics (not really errors) */
28 #define foreach_vxlan_gpe_encap_error \
29 _(ENCAPSULATED, "good packets encapsulated")
30 
31 /**
32  * @brief VXLAN GPE encap error strings
33  */
35 #define _(sym,string) string,
37 #undef _
38 };
39 
40 /**
41  * @brief Struct for VXLAN GPE errors/counters
42  */
43 typedef enum
44 {
45 #define _(sym,str) VXLAN_GPE_ENCAP_ERROR_##sym,
47 #undef _
50 
51 /**
52  * @brief Struct for tracing VXLAN GPE encapsulated packets
53  */
54 typedef struct
55 {
58 
59 /**
60  * @brief Trace of packets encapsulated in VXLAN GPE
61  *
62  * @param *s
63  * @param *args
64  *
65  * @return *s
66  *
67  */
68 u8 *
69 format_vxlan_gpe_encap_trace (u8 * s, va_list * args)
70 {
71  CLIB_UNUSED (vlib_main_t * vm) = va_arg (*args, vlib_main_t *);
72  CLIB_UNUSED (vlib_node_t * node) = va_arg (*args, vlib_node_t *);
73  vxlan_gpe_encap_trace_t *t = va_arg (*args, vxlan_gpe_encap_trace_t *);
74 
75  s = format (s, "VXLAN-GPE-ENCAP: tunnel %d", t->tunnel_index);
76  return s;
77 }
78 
79 /**
80  * @brief Instantiates UDP + VXLAN-GPE header then set next node to IP4|6 lookup
81  *
82  * @param *ngm
83  * @param *b0
84  * @param *t0 contains rewrite header
85  * @param *next0 relative index of next dispatch function (next node)
86  * @param is_v4 Is this IPv4? (or IPv6)
87  *
88  */
89 always_inline void
91  vxlan_gpe_tunnel_t * t0, u32 * next0, u8 is_v4)
92 {
93  ASSERT (sizeof (ip4_vxlan_gpe_header_t) == 36);
94  ASSERT (sizeof (ip6_vxlan_gpe_header_t) == 56);
95 
96  ip_udp_encap_one (ngm->vlib_main, b0, t0->rewrite, t0->rewrite_size, is_v4);
97  next0[0] = t0->encap_next_node;
98 }
99 
100 /**
101  * @brief Instantiates UDP + VXLAN-GPE header then set next node to IP4|6 lookup for two packets
102  *
103  * @param *ngm
104  * @param *b0 Packet0
105  * @param *b1 Packet1
106  * @param *t0 contains rewrite header for Packet0
107  * @param *t1 contains rewrite header for Packet1
108  * @param *next0 relative index of next dispatch function (next node) for Packet0
109  * @param *next1 relative index of next dispatch function (next node) for Packet1
110  * @param is_v4 Is this IPv4? (or IPv6)
111  *
112  */
113 always_inline void
116  vxlan_gpe_tunnel_t * t1, u32 * next0,
117  u32 * next1, u8 is_v4)
118 {
119  ASSERT (sizeof (ip4_vxlan_gpe_header_t) == 36);
120  ASSERT (sizeof (ip6_vxlan_gpe_header_t) == 56);
121 
122  ip_udp_encap_one (ngm->vlib_main, b0, t0->rewrite, t0->rewrite_size, is_v4);
123  ip_udp_encap_one (ngm->vlib_main, b1, t1->rewrite, t1->rewrite_size, is_v4);
124  next0[0] = next1[0] = t0->encap_next_node;
125 }
126 
127 /**
128  * @brief Common processing for IPv4 and IPv6 VXLAN GPE encap dispatch functions
129  *
130  * It is worth noting that other than trivial UDP forwarding (transit), VXLAN GPE
131  * tunnels are "establish local". This means that we don't have a TX interface as yet
132  * as we need to look up where the outer-header dest is. By setting the TX index in the
133  * buffer metadata to the encap FIB, we can do a lookup to get the adjacency and real TX.
134  *
135  * vnet_buffer(b0)->sw_if_index[VLIB_TX] = t0->encap_fib_index;
136  *
137  * @node vxlan-gpe-input
138  * @param *vm
139  * @param *node
140  * @param *from_frame
141  *
142  * @return from_frame->n_vectors
143  *
144  */
145 static uword
147  vlib_node_runtime_t * node, vlib_frame_t * from_frame)
148 {
149  u32 n_left_from, next_index, *from, *to_next;
151  vnet_main_t *vnm = ngm->vnet_main;
153  u32 pkts_encapsulated = 0;
154  u32 thread_index = vm->thread_index;
155  u32 stats_sw_if_index, stats_n_packets, stats_n_bytes;
156 
157  from = vlib_frame_vector_args (from_frame);
158  n_left_from = from_frame->n_vectors;
159 
160  next_index = node->cached_next_index;
161  stats_sw_if_index = node->runtime_data[0];
162  stats_n_packets = stats_n_bytes = 0;
163 
164  while (n_left_from > 0)
165  {
166  u32 n_left_to_next;
167  u32 sw_if_index0 = ~0, sw_if_index1 = ~0, len0, len1;
168  vnet_hw_interface_t *hi0, *hi1;
169  vxlan_gpe_tunnel_t *t0 = NULL, *t1 = NULL;
170  u8 is_ip4_0 = 0, is_ip4_1 = 0;
171 
172  vlib_get_next_frame (vm, node, next_index, to_next, n_left_to_next);
173 
174  while (n_left_from >= 4 && n_left_to_next >= 2)
175  {
176  u32 bi0, bi1;
177  vlib_buffer_t *b0, *b1;
178  u32 next0, next1;
179 
180  next0 = next1 = VXLAN_GPE_ENCAP_NEXT_IP4_LOOKUP;
181 
182  /* Prefetch next iteration. */
183  {
184  vlib_buffer_t *p2, *p3;
185 
186  p2 = vlib_get_buffer (vm, from[2]);
187  p3 = vlib_get_buffer (vm, from[3]);
188 
189  vlib_prefetch_buffer_header (p2, LOAD);
190  vlib_prefetch_buffer_header (p3, LOAD);
191 
192  CLIB_PREFETCH (p2->data, 2 * CLIB_CACHE_LINE_BYTES, LOAD);
193  CLIB_PREFETCH (p3->data, 2 * CLIB_CACHE_LINE_BYTES, LOAD);
194  }
195 
196  bi0 = from[0];
197  bi1 = from[1];
198  to_next[0] = bi0;
199  to_next[1] = bi1;
200  from += 2;
201  to_next += 2;
202  n_left_to_next -= 2;
203  n_left_from -= 2;
204 
205  b0 = vlib_get_buffer (vm, bi0);
206  b1 = vlib_get_buffer (vm, bi1);
207 
208  /* get the flag "is_ip4" */
209  if (sw_if_index0 != vnet_buffer (b0)->sw_if_index[VLIB_TX])
210  {
211  sw_if_index0 = vnet_buffer (b0)->sw_if_index[VLIB_TX];
212  hi0 =
215  [VLIB_TX]);
216  t0 = pool_elt_at_index (ngm->tunnels, hi0->dev_instance);
217  is_ip4_0 = (t0->flags & VXLAN_GPE_TUNNEL_IS_IPV4);
218  }
219 
220  /* get the flag "is_ip4" */
221  if (sw_if_index1 != vnet_buffer (b1)->sw_if_index[VLIB_TX])
222  {
223  if (sw_if_index0 == vnet_buffer (b1)->sw_if_index[VLIB_TX])
224  {
225  sw_if_index1 = sw_if_index0;
226  hi1 = hi0;
227  t1 = t0;
228  is_ip4_1 = is_ip4_0;
229  }
230  else
231  {
232  sw_if_index1 = vnet_buffer (b1)->sw_if_index[VLIB_TX];
233  hi1 =
236  [VLIB_TX]);
237  t1 = pool_elt_at_index (ngm->tunnels, hi1->dev_instance);
238  is_ip4_1 = (t1->flags & VXLAN_GPE_TUNNEL_IS_IPV4);
239  }
240  }
241 
242  if (PREDICT_TRUE (is_ip4_0 == is_ip4_1))
243  {
244  vxlan_gpe_encap_two_inline (ngm, b0, b1, t0, t1, &next0, &next1,
245  is_ip4_0);
246  }
247  else
248  {
249  vxlan_gpe_encap_one_inline (ngm, b0, t0, &next0, is_ip4_0);
250  vxlan_gpe_encap_one_inline (ngm, b1, t1, &next1, is_ip4_1);
251  }
252 
253  /* Reset to look up tunnel partner in the configured FIB */
254  vnet_buffer (b0)->sw_if_index[VLIB_TX] = t0->encap_fib_index;
255  vnet_buffer (b1)->sw_if_index[VLIB_TX] = t1->encap_fib_index;
256  vnet_buffer (b0)->sw_if_index[VLIB_RX] = sw_if_index0;
257  vnet_buffer (b1)->sw_if_index[VLIB_RX] = sw_if_index1;
258  pkts_encapsulated += 2;
259 
260  len0 = vlib_buffer_length_in_chain (vm, b0);
261  len1 = vlib_buffer_length_in_chain (vm, b1);
262  stats_n_packets += 2;
263  stats_n_bytes += len0 + len1;
264 
265  /* Batch stats increment on the same vxlan tunnel so counter is not
266  incremented per packet. Note stats are still incremented for deleted
267  and admin-down tunnel where packets are dropped. It is not worthwhile
268  to check for this rare case and affect normal path performance. */
269  if (PREDICT_FALSE ((sw_if_index0 != stats_sw_if_index)
270  || (sw_if_index1 != stats_sw_if_index)))
271  {
272  stats_n_packets -= 2;
273  stats_n_bytes -= len0 + len1;
274  if (sw_if_index0 == sw_if_index1)
275  {
276  if (stats_n_packets)
279  VNET_INTERFACE_COUNTER_TX, thread_index,
280  stats_sw_if_index, stats_n_packets, stats_n_bytes);
281  stats_sw_if_index = sw_if_index0;
282  stats_n_packets = 2;
283  stats_n_bytes = len0 + len1;
284  }
285  else
286  {
288  +
290  thread_index, sw_if_index0,
291  1, len0);
293  +
295  thread_index, sw_if_index1,
296  1, len1);
297  }
298  }
299 
300  if (PREDICT_FALSE (b0->flags & VLIB_BUFFER_IS_TRACED))
301  {
303  vlib_add_trace (vm, node, b0, sizeof (*tr));
304  tr->tunnel_index = t0 - ngm->tunnels;
305  }
306 
307  if (PREDICT_FALSE (b1->flags & VLIB_BUFFER_IS_TRACED))
308  {
309  vxlan_gpe_encap_trace_t *tr = vlib_add_trace (vm, node, b1,
310  sizeof (*tr));
311  tr->tunnel_index = t1 - ngm->tunnels;
312  }
313 
314  vlib_validate_buffer_enqueue_x2 (vm, node, next_index, to_next,
315  n_left_to_next, bi0, bi1, next0,
316  next1);
317  }
318 
319  while (n_left_from > 0 && n_left_to_next > 0)
320  {
321  u32 bi0;
322  vlib_buffer_t *b0;
324 
325  bi0 = from[0];
326  to_next[0] = bi0;
327  from += 1;
328  to_next += 1;
329  n_left_from -= 1;
330  n_left_to_next -= 1;
331 
332  b0 = vlib_get_buffer (vm, bi0);
333 
334  /* get the flag "is_ip4" */
335  if (sw_if_index0 != vnet_buffer (b0)->sw_if_index[VLIB_TX])
336  {
337  sw_if_index0 = vnet_buffer (b0)->sw_if_index[VLIB_TX];
338  hi0 =
341  [VLIB_TX]);
342 
343  t0 = pool_elt_at_index (ngm->tunnels, hi0->dev_instance);
344 
345  is_ip4_0 = (t0->flags & VXLAN_GPE_TUNNEL_IS_IPV4);
346  }
347 
348  vxlan_gpe_encap_one_inline (ngm, b0, t0, &next0, is_ip4_0);
349 
350  /* Reset to look up tunnel partner in the configured FIB */
351  vnet_buffer (b0)->sw_if_index[VLIB_TX] = t0->encap_fib_index;
352  vnet_buffer (b0)->sw_if_index[VLIB_RX] = sw_if_index0;
353  pkts_encapsulated++;
354 
355  len0 = vlib_buffer_length_in_chain (vm, b0);
356  stats_n_packets += 1;
357  stats_n_bytes += len0;
358 
359  /* Batch stats increment on the same vxlan tunnel so counter is not
360  * incremented per packet. Note stats are still incremented for deleted
361  * and admin-down tunnel where packets are dropped. It is not worthwhile
362  * to check for this rare case and affect normal path performance. */
363  if (PREDICT_FALSE (sw_if_index0 != stats_sw_if_index))
364  {
365  stats_n_packets -= 1;
366  stats_n_bytes -= len0;
367  if (stats_n_packets)
370  thread_index,
371  stats_sw_if_index,
372  stats_n_packets,
373  stats_n_bytes);
374  stats_n_packets = 1;
375  stats_n_bytes = len0;
376  stats_sw_if_index = sw_if_index0;
377  }
378  if (PREDICT_FALSE (b0->flags & VLIB_BUFFER_IS_TRACED))
379  {
380  vxlan_gpe_encap_trace_t *tr = vlib_add_trace (vm, node, b0,
381  sizeof (*tr));
382  tr->tunnel_index = t0 - ngm->tunnels;
383  }
384  vlib_validate_buffer_enqueue_x1 (vm, node, next_index, to_next,
385  n_left_to_next, bi0, next0);
386  }
387 
388  vlib_put_next_frame (vm, node, next_index, n_left_to_next);
389  }
391  VXLAN_GPE_ENCAP_ERROR_ENCAPSULATED,
392  pkts_encapsulated);
393  /* Increment any remaining batch stats */
394  if (stats_n_packets)
395  {
398  thread_index, stats_sw_if_index,
399  stats_n_packets, stats_n_bytes);
400  node->runtime_data[0] = stats_sw_if_index;
401  }
402 
403  return from_frame->n_vectors;
404 }
405 
406 /* *INDENT-OFF* */
408  .function = vxlan_gpe_encap,
409  .name = "vxlan-gpe-encap",
410  .vector_size = sizeof (u32),
411  .format_trace = format_vxlan_gpe_encap_trace,
412  .type = VLIB_NODE_TYPE_INTERNAL,
413 
415  .error_strings = vxlan_gpe_encap_error_strings,
416 
417  .n_next_nodes = VXLAN_GPE_ENCAP_N_NEXT,
418 
419  .next_nodes = {
420  [VXLAN_GPE_ENCAP_NEXT_IP4_LOOKUP] = "ip4-lookup",
421  [VXLAN_GPE_ENCAP_NEXT_IP6_LOOKUP] = "ip6-lookup",
422  [VXLAN_GPE_ENCAP_NEXT_DROP] = "error-drop",
423  },
424 };
425 /* *INDENT-ON* */
426 
427 
428 /*
429  * fd.io coding-style-patch-verification: ON
430  *
431  * Local Variables:
432  * eval: (c-set-style "gnu")
433  * End:
434  */
#define CLIB_UNUSED(x)
Definition: clib.h:82
u32 flags
flags
Definition: vxlan_gpe.h:137
#define foreach_vxlan_gpe_encap_error
Statistics (not really errors)
Definition: encap.c:28
Struct for tracing VXLAN GPE encapsulated packets.
Definition: encap.c:54
static void vlib_increment_combined_counter(vlib_combined_counter_main_t *cm, u32 thread_index, u32 index, u64 n_packets, u64 n_bytes)
Increment a combined counter.
Definition: counter.h:220
u8 runtime_data[0]
Function dependent node-runtime data.
Definition: node.h:546
static vnet_hw_interface_t * vnet_get_sup_hw_interface(vnet_main_t *vnm, u32 sw_if_index)
vnet_interface_main_t interface_main
Definition: vnet.h:56
#define PREDICT_TRUE(x)
Definition: clib.h:112
#define NULL
Definition: clib.h:58
VXLAN GPE definitions.
u32 thread_index
Definition: main.h:179
u8 * format(u8 *s, const char *fmt,...)
Definition: format.c:419
static uword vlib_buffer_length_in_chain(vlib_main_t *vm, vlib_buffer_t *b)
Get length in bytes of the buffer chain.
Definition: buffer_funcs.h:267
unsigned char u8
Definition: types.h:56
vnet_main_t * vnet_main
State convenience vnet_main_t.
Definition: vxlan_gpe.h:221
static uword vxlan_gpe_encap(vlib_main_t *vm, vlib_node_runtime_t *node, vlib_frame_t *from_frame)
Common processing for IPv4 and IPv6 VXLAN GPE encap dispatch functions.
Definition: encap.c:146
static void vxlan_gpe_encap_one_inline(vxlan_gpe_main_t *ngm, vlib_buffer_t *b0, vxlan_gpe_tunnel_t *t0, u32 *next0, u8 is_v4)
Instantiates UDP + VXLAN-GPE header then set next node to IP4|6 lookup.
Definition: encap.c:90
u32 sw_if_index
Definition: vxlan_gbp.api:37
#define always_inline
Definition: clib.h:98
vlib_combined_counter_main_t * combined_sw_if_counters
Definition: interface.h:839
#define vlib_prefetch_buffer_header(b, type)
Prefetch buffer metadata.
Definition: buffer.h:188
u8 * format_vxlan_gpe_encap_trace(u8 *s, va_list *args)
Trace of packets encapsulated in VXLAN GPE.
Definition: encap.c:69
unsigned int u32
Definition: types.h:88
u8 * rewrite
Rewrite string.
Definition: vxlan_gpe.h:108
#define pool_elt_at_index(p, i)
Returns pointer to element at given index.
Definition: pool.h:511
Struct for VXLAN GPE tunnel.
Definition: vxlan_gpe.h:102
static void vxlan_gpe_encap_two_inline(vxlan_gpe_main_t *ngm, vlib_buffer_t *b0, vlib_buffer_t *b1, vxlan_gpe_tunnel_t *t0, vxlan_gpe_tunnel_t *t1, u32 *next0, u32 *next1, u8 is_v4)
Instantiates UDP + VXLAN-GPE header then set next node to IP4|6 lookup for two packets.
Definition: encap.c:114
vxlan_gpe_encap_error_t
Struct for VXLAN GPE errors/counters.
Definition: encap.c:43
vxlan_gpe_main_t vxlan_gpe_main
Definition: vxlan_gpe.c:45
vlib_main_t * vlib_main
State convenience vlib_main_t.
Definition: vxlan_gpe.h:219
#define PREDICT_FALSE(x)
Definition: clib.h:111
static void ip_udp_encap_one(vlib_main_t *vm, vlib_buffer_t *b0, u8 *ec0, word ec_len, u8 is_ip4)
Definition: udp.h:335
u32 node_index
Node index.
Definition: node.h:519
#define vlib_validate_buffer_enqueue_x2(vm, node, next_index, to_next, n_left_to_next, bi0, bi1, next0, next1)
Finish enqueueing two buffers forward in the graph.
Definition: buffer_node.h:70
#define vlib_validate_buffer_enqueue_x1(vm, node, next_index, to_next, n_left_to_next, bi0, next0)
Finish enqueueing one buffer forward in the graph.
Definition: buffer_node.h:218
#define vlib_get_next_frame(vm, node, next_index, vectors, n_vectors_left)
Get pointer to next frame vector data by (vlib_node_runtime_t, next_index).
Definition: node_funcs.h:368
static void vlib_node_increment_counter(vlib_main_t *vm, u32 node_index, u32 counter_index, u64 increment)
Definition: node_funcs.h:1180
#define VLIB_REGISTER_NODE(x,...)
Definition: node.h:169
u16 n_vectors
Definition: node.h:420
#define CLIB_PREFETCH(addr, size, type)
Definition: cache.h:79
vlib_main_t * vm
Definition: buffer.c:301
#define ARRAY_LEN(x)
Definition: clib.h:62
void vlib_put_next_frame(vlib_main_t *vm, vlib_node_runtime_t *r, u32 next_index, u32 n_vectors_left)
Release pointer to next frame vector data.
Definition: main.c:459
u16 cached_next_index
Next frame index that vector arguments were last enqueued to last time this node ran.
Definition: node.h:538
#define ASSERT(truth)
u8 rewrite_size
rewrite size for dynamic plugins like iOAM
Definition: vxlan_gpe.h:140
Struct for VXLAN GPE node state.
Definition: vxlan_gpe.h:196
vxlan_gpe_tunnel_t * tunnels
vector of encap tunnel instances
Definition: vxlan_gpe.h:199
static void * vlib_add_trace(vlib_main_t *vm, vlib_node_runtime_t *r, vlib_buffer_t *b, u32 n_data_bytes)
Definition: trace_funcs.h:57
Definition: defs.h:47
u64 uword
Definition: types.h:112
static void * vlib_frame_vector_args(vlib_frame_t *f)
Get pointer to frame vector data.
Definition: node_funcs.h:274
static char * vxlan_gpe_encap_error_strings[]
VXLAN GPE encap error strings.
Definition: encap.c:34
u32 encap_fib_index
FIB indices - tunnel partner lookup here.
Definition: vxlan_gpe.h:124
#define vnet_buffer(b)
Definition: buffer.h:368
uword encap_next_node
Next node after VxLAN-GPE encap.
Definition: vxlan_gpe.h:143
u8 data[0]
Packet data.
Definition: buffer.h:176
vlib_node_registration_t vxlan_gpe_encap_node
(constructor) VLIB_REGISTER_NODE (vxlan_gpe_encap_node)
Definition: encap.c:407
#define CLIB_CACHE_LINE_BYTES
Definition: cache.h:59
#define VXLAN_GPE_TUNNEL_IS_IPV4
Flags for vxlan_gpe_tunnel_t.
Definition: vxlan_gpe.h:168
u32 flags
buffer flags: VLIB_BUFFER_FREE_LIST_INDEX_MASK: bits used to store free list index, VLIB_BUFFER_IS_TRACED: trace this buffer.
Definition: buffer.h:117
static vlib_buffer_t * vlib_get_buffer(vlib_main_t *vm, u32 buffer_index)
Translate buffer index into buffer pointer.
Definition: buffer_funcs.h:62
Definition: defs.h:46