FD.io VPP  v18.11-rc0-18-g2a3fb1a
Vector Packet Processing
vxlan_gpe.h
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 VXLAN GPE definitions
18  *
19 */
20 #ifndef included_vnet_vxlan_gpe_h
21 #define included_vnet_vxlan_gpe_h
22 
23 #include <vppinfra/error.h>
24 #include <vppinfra/hash.h>
25 #include <vnet/vnet.h>
26 #include <vnet/ip/ip.h>
27 #include <vnet/l2/l2_input.h>
28 #include <vnet/l2/l2_output.h>
29 #include <vnet/l2/l2_bd.h>
30 #include <vnet/ethernet/ethernet.h>
32 #include <vnet/ip/ip4_packet.h>
33 #include <vnet/ip/ip6_packet.h>
34 #include <vnet/udp/udp.h>
35 #include <vnet/dpo/dpo.h>
36 #include <vnet/adj/adj_types.h>
37 
38 /**
39  * @brief VXLAN GPE header struct
40  *
41  */
42 /* *INDENT-OFF* */
43 typedef CLIB_PACKED (struct {
44  /** 20 bytes */
45  ip4_header_t ip4;
46  /** 8 bytes */
47  udp_header_t udp;
48  /** 8 bytes */
49  vxlan_gpe_header_t vxlan;
50 }) ip4_vxlan_gpe_header_t;
51 /* *INDENT-ON* */
52 
53 /* *INDENT-OFF* */
54 typedef CLIB_PACKED (struct {
55  /** 40 bytes */
56  ip6_header_t ip6;
57  /** 8 bytes */
58  udp_header_t udp;
59  /** 8 bytes */
60  vxlan_gpe_header_t vxlan;
61 }) ip6_vxlan_gpe_header_t;
62 /* *INDENT-ON* */
63 
64 /**
65  * @brief Key struct for IPv4 VXLAN GPE tunnel.
66  * Key fields: local remote, vni
67  * all fields in NET byte order
68  * VNI shifted 8 bits
69  */
70 /* *INDENT-OFF* */
71 typedef CLIB_PACKED(struct {
72  union {
73  struct {
74  u32 local;
75  u32 remote;
76 
77  u32 vni;
78  u32 pad;
79  };
80  u64 as_u64[2];
81  };
82 }) vxlan4_gpe_tunnel_key_t;
83 /* *INDENT-ON* */
84 
85 /**
86  * @brief Key struct for IPv6 VXLAN GPE tunnel.
87  * Key fields: local remote, vni
88  * all fields in NET byte order
89  * VNI shifted 8 bits
90  */
91 /* *INDENT-OFF* */
92 typedef CLIB_PACKED(struct {
93  ip6_address_t local;
94  ip6_address_t remote;
95  u32 vni;
96 }) vxlan6_gpe_tunnel_key_t;
97 /* *INDENT-ON* */
98 
99 /**
100  * @brief Struct for VXLAN GPE tunnel
101  */
102 typedef struct
103 {
104  /* Required for pool_get_aligned */
105  CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
106 
107  /** Rewrite string. $$$$ embed vnet_rewrite header */
109 
110  /** encapsulated protocol */
112 
113  /* FIB DPO for IP forwarding of VXLAN-GPE encap packet */
115  /** tunnel local address */
116  ip46_address_t local;
117  /** tunnel remote address */
118  ip46_address_t remote;
119 
120  /* mcast packet output intfc index (used only if dst is mcast) */
122 
123  /** FIB indices - tunnel partner lookup here */
125  /** FIB indices - inner IP packet lookup here */
127 
128  /** VXLAN GPE VNI in HOST byte order, shifted left 8 bits */
130 
131  /** vnet intfc hw_if_index */
133  /** vnet intfc sw_if_index */
135 
136  /** flags */
138 
139  /** rewrite size for dynamic plugins like iOAM */
141 
142  /** Next node after VxLAN-GPE encap */
144 
145  /**
146  * Linkage into the FIB object graph
147  */
149 
150  /*
151  * The FIB entry for (depending on VXLAN-GPE tunnel is unicast or mcast)
152  * sending unicast VXLAN-GPE encap packets or receiving mcast VXLAN-GPE packets
153  */
156 
157  /**
158  * The tunnel is a child of the FIB entry for its desintion. This is
159  * so it receives updates when the forwarding information for that entry
160  * changes.
161  * The tunnels sibling index on the FIB entry's dependency list.
162  */
164 
166 
167 /** Flags for vxlan_gpe_tunnel_t */
168 #define VXLAN_GPE_TUNNEL_IS_IPV4 1
169 
170 /** next nodes for VXLAN GPE input */
171 #define foreach_vxlan_gpe_input_next \
172 _(DROP, "error-drop") \
173 _(IP4_INPUT, "ip4-input") \
174 _(IP6_INPUT, "ip6-input") \
175 _(L2_INPUT, "l2-input")
176 
177 /** struct for next nodes for VXLAN GPE input */
178 typedef enum
179 {
180 #define _(s,n) VXLAN_GPE_INPUT_NEXT_##s,
182 #undef _
185 
186 /** struct for VXLAN GPE errors */
187 typedef enum
188 {
189 #define vxlan_gpe_error(n,s) VXLAN_GPE_ERROR_##n,
191 #undef vxlan_gpe_error
194 
195 /** Struct for VXLAN GPE node state */
196 typedef struct
197 {
198  /** vector of encap tunnel instances */
200 
201  /** lookup IPv4 VXLAN GPE tunnel by key */
203  /** lookup IPv6 VXLAN GPE tunnel by key */
205 
206  /* local VTEP IPs ref count used by vxlan-bypass node to check if
207  received VXLAN packet DIP matches any local VTEP address */
208  uword *vtep4; /* local ip4 VTEPs keyed on their ip4 addr */
209  uword *vtep6; /* local ip6 VTEPs keyed on their ip6 addr */
210  /* mcast shared info */
211  uword *mcast_shared; /* keyed on mcast ip46 addr */
212  /** Free vlib hw_if_indices */
214 
215  /** Mapping from sw_if_index to tunnel index */
217 
218  /** State convenience vlib_main_t */
220  /** State convenience vnet_main_t */
222 
223  /** List of next nodes for the decap indexed on protocol */
224  uword decap_next_node_list[VXLAN_GPE_PROTOCOL_MAX];
226 
228 
232 
233 u8 *format_vxlan_gpe_encap_trace (u8 * s, va_list * args);
234 
235 /** Struct for VXLAN GPE add/del args */
236 typedef struct
237 {
240  ip46_address_t local, remote;
247 
248 
250  (vnet_vxlan_gpe_add_del_tunnel_args_t * a, u32 * sw_if_indexp);
251 
252 
253 int vxlan4_gpe_rewrite (vxlan_gpe_tunnel_t * t, u32 extension_size,
254  u8 protocol_override, uword encap_next_node);
255 int vxlan6_gpe_rewrite (vxlan_gpe_tunnel_t * t, u32 extension_size,
256  u8 protocol_override, uword encap_next_node);
257 
258 /**
259  * @brief Struct for defining VXLAN GPE next nodes
260  */
261 typedef enum
262 {
268 
269 
270 void vxlan_gpe_unregister_decap_protocol (u8 protocol_id,
271  uword next_node_index);
272 
273 void vxlan_gpe_register_decap_protocol (u8 protocol_id,
274  uword next_node_index);
275 
276 void vnet_int_vxlan_gpe_bypass_mode (u32 sw_if_index, u8 is_ip6,
277  u8 is_enable);
278 
279 #endif /* included_vnet_vxlan_gpe_h */
280 
281 /*
282  * fd.io coding-style-patch-verification: ON
283  *
284  * Local Variables:
285  * eval: (c-set-style "gnu")
286  * End:
287  */
uword * vxlan6_gpe_tunnel_by_key
lookup IPv6 VXLAN GPE tunnel by key
Definition: vxlan_gpe.h:204
vlib_node_registration_t vxlan6_gpe_input_node
(constructor) VLIB_REGISTER_NODE (vxlan6_gpe_input_node)
Definition: decap.c:755
u32 sibling_index
The tunnel is a child of the FIB entry for its desintion.
Definition: vxlan_gpe.h:163
u8 pad[3]
log2 (size of the packing page block)
Definition: bihash_doc.h:61
#define CLIB_CACHE_LINE_ALIGN_MARK(mark)
Definition: cache.h:63
u32 flags
flags
Definition: vxlan_gpe.h:137
vlib_node_registration_t vxlan_gpe_encap_node
(constructor) VLIB_REGISTER_NODE (vxlan_gpe_encap_node)
Definition: encap.c:392
a
Definition: bitmap.h:538
u64 as_u64
Definition: bihash_doc.h:63
adj_index_t mcast_adj_index
Definition: vxlan_gpe.h:155
vxlan_gpe_encap_next_t
Struct for defining VXLAN GPE next nodes.
Definition: vxlan_gpe.h:261
unsigned long u64
Definition: types.h:89
uword * mcast_shared
Definition: vxlan_gpe.h:211
u32 * tunnel_index_by_sw_if_index
Mapping from sw_if_index to tunnel index.
Definition: vxlan_gpe.h:216
u8 * format_vxlan_gpe_encap_trace(u8 *s, va_list *args)
Trace of packets encapsulated in VXLAN GPE.
Definition: encap.c:69
unsigned char u8
Definition: types.h:56
vnet_main_t * vnet_main
State convenience vnet_main_t.
Definition: vxlan_gpe.h:221
vxlan_gpe_main_t vxlan_gpe_main
Definition: vxlan_gpe.c:45
typedef CLIB_PACKED(struct{ip4_header_t ip4;udp_header_t udp;vxlan_gpe_header_t vxlan;}) ip4_vxlan_gpe_header_t
VXLAN GPE header struct.
ip46_address_t local
tunnel local address
Definition: vxlan_gpe.h:116
unsigned int u32
Definition: types.h:88
fib_node_index_t fib_entry_index
Definition: vxlan_gpe.h:154
u8 * rewrite
Rewrite string.
Definition: vxlan_gpe.h:108
VXLAN GPE packet header structure.
The identity of a DPO is a combination of its type and its instance number/index of objects of that t...
Definition: dpo.h:168
Struct for VXLAN GPE tunnel.
Definition: vxlan_gpe.h:102
int vnet_vxlan_gpe_add_del_tunnel(vnet_vxlan_gpe_add_del_tunnel_args_t *a, u32 *sw_if_indexp)
Add or Del a VXLAN GPE tunnel.
Definition: vxlan_gpe.c:469
vlib_node_registration_t vxlan4_gpe_input_node
(constructor) VLIB_REGISTER_NODE (vxlan4_gpe_input_node)
Definition: decap.c:730
vlib_main_t * vlib_main
State convenience vlib_main_t.
Definition: vxlan_gpe.h:219
u8 protocol
encapsulated protocol
Definition: vxlan_gpe.h:111
An node in the FIB graph.
Definition: fib_node.h:286
ip46_address_t remote
tunnel remote address
Definition: vxlan_gpe.h:118
u32 vni
VXLAN GPE VNI in HOST byte order, shifted left 8 bits.
Definition: vxlan_gpe.h:129
void vnet_int_vxlan_gpe_bypass_mode(u32 sw_if_index, u8 is_ip6, u8 is_enable)
Definition: vxlan_gpe.c:1043
Struct for VXLAN GPE add/del args.
Definition: vxlan_gpe.h:236
int vxlan6_gpe_rewrite(vxlan_gpe_tunnel_t *t, u32 extension_size, u8 protocol_override, uword encap_next_node)
Calculate IPv6 VXLAN GPE rewrite header.
Definition: vxlan_gpe.c:336
fib_node_t node
Linkage into the FIB object graph.
Definition: vxlan_gpe.h:148
u32 fib_node_index_t
A typedef of a node index.
Definition: fib_types.h:30
vxlan_gpe_input_error_t
struct for VXLAN GPE errors
Definition: vxlan_gpe.h:187
u32 adj_index_t
An index for adjacencies.
Definition: adj_types.h:30
void vxlan_gpe_unregister_decap_protocol(u8 protocol_id, uword next_node_index)
Definition: decap.c:693
#define foreach_vxlan_gpe_input_next
next nodes for VXLAN GPE input
Definition: vxlan_gpe.h:171
void vxlan_gpe_register_decap_protocol(u8 protocol_id, uword next_node_index)
Definition: decap.c:685
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
dpo_id_t next_dpo
Definition: vxlan_gpe.h:114
vxlan_gpe_tunnel_t * tunnels
vector of encap tunnel instances
Definition: vxlan_gpe.h:199
struct _vlib_node_registration vlib_node_registration_t
uword * vxlan4_gpe_tunnel_by_key
lookup IPv4 VXLAN GPE tunnel by key
Definition: vxlan_gpe.h:202
u32 decap_fib_index
FIB indices - inner IP packet lookup here.
Definition: vxlan_gpe.h:126
u64 uword
Definition: types.h:112
int vxlan4_gpe_rewrite(vxlan_gpe_tunnel_t *t, u32 extension_size, u8 protocol_override, uword encap_next_node)
Calculate IPv4 VXLAN GPE rewrite header.
Definition: vxlan_gpe.c:278
VXLAN GPE Header definition.
u32 hw_if_index
vnet intfc hw_if_index
Definition: vxlan_gpe.h:132
vxlan_gpe_input_next_t
struct for next nodes for VXLAN GPE input
Definition: vxlan_gpe.h:178
u32 encap_fib_index
FIB indices - tunnel partner lookup here.
Definition: vxlan_gpe.h:124
uword encap_next_node
Next node after VxLAN-GPE encap.
Definition: vxlan_gpe.h:143
u32 sw_if_index
vnet intfc sw_if_index
Definition: vxlan_gpe.h:134
u32 * free_vxlan_gpe_tunnel_hw_if_indices
Free vlib hw_if_indices.
Definition: vxlan_gpe.h:213