FD.io VPP  v18.01.2-1-g9b554f3
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  /** Rewrite string. $$$$ embed vnet_rewrite header */
106 
107  /** encapsulated protocol */
109 
110  /* FIB DPO for IP forwarding of VXLAN-GPE encap packet */
112  /** tunnel local address */
113  ip46_address_t local;
114  /** tunnel remote address */
115  ip46_address_t remote;
116 
117  /* mcast packet output intfc index (used only if dst is mcast) */
119 
120  /** FIB indices - tunnel partner lookup here */
122  /** FIB indices - inner IP packet lookup here */
124 
125  /** VXLAN GPE VNI in HOST byte order, shifted left 8 bits */
127 
128  /** vnet intfc hw_if_index */
130  /** vnet intfc sw_if_index */
132 
133  /** flags */
135 
136  /** rewrite size for dynamic plugins like iOAM */
138 
139  /** Next node after VxLAN-GPE encap */
141 
142  /**
143  * Linkage into the FIB object graph
144  */
146 
147  /*
148  * The FIB entry for (depending on VXLAN-GPE tunnel is unicast or mcast)
149  * sending unicast VXLAN-GPE encap packets or receiving mcast VXLAN-GPE packets
150  */
153 
154  /**
155  * The tunnel is a child of the FIB entry for its desintion. This is
156  * so it receives updates when the forwarding information for that entry
157  * changes.
158  * The tunnels sibling index on the FIB entry's dependency list.
159  */
161 
163 
164 /** Flags for vxlan_gpe_tunnel_t */
165 #define VXLAN_GPE_TUNNEL_IS_IPV4 1
166 
167 /** next nodes for VXLAN GPE input */
168 #define foreach_vxlan_gpe_input_next \
169 _(DROP, "error-drop") \
170 _(IP4_INPUT, "ip4-input") \
171 _(IP6_INPUT, "ip6-input") \
172 _(L2_INPUT, "l2-input")
173 
174 /** struct for next nodes for VXLAN GPE input */
175 typedef enum
176 {
177 #define _(s,n) VXLAN_GPE_INPUT_NEXT_##s,
179 #undef _
182 
183 /** struct for VXLAN GPE errors */
184 typedef enum
185 {
186 #define vxlan_gpe_error(n,s) VXLAN_GPE_ERROR_##n,
188 #undef vxlan_gpe_error
191 
192 /** Struct for VXLAN GPE node state */
193 typedef struct
194 {
195  /** vector of encap tunnel instances */
197 
198  /** lookup IPv4 VXLAN GPE tunnel by key */
200  /** lookup IPv6 VXLAN GPE tunnel by key */
202 
203  /* local VTEP IPs ref count used by vxlan-bypass node to check if
204  received VXLAN packet DIP matches any local VTEP address */
205  uword *vtep4; /* local ip4 VTEPs keyed on their ip4 addr */
206  uword *vtep6; /* local ip6 VTEPs keyed on their ip6 addr */
207  /* mcast shared info */
208  uword *mcast_shared; /* keyed on mcast ip46 addr */
209  /** Free vlib hw_if_indices */
211 
212  /** Mapping from sw_if_index to tunnel index */
214 
215  /** State convenience vlib_main_t */
217  /** State convenience vnet_main_t */
219 
220  /** List of next nodes for the decap indexed on protocol */
221  uword decap_next_node_list[VXLAN_GPE_PROTOCOL_MAX];
223 
225 
229 
230 u8 *format_vxlan_gpe_encap_trace (u8 * s, va_list * args);
231 
232 /** Struct for VXLAN GPE add/del args */
233 typedef struct
234 {
237  ip46_address_t local, remote;
244 
245 
247  (vnet_vxlan_gpe_add_del_tunnel_args_t * a, u32 * sw_if_indexp);
248 
249 
250 int vxlan4_gpe_rewrite (vxlan_gpe_tunnel_t * t, u32 extension_size,
251  u8 protocol_override, uword encap_next_node);
252 int vxlan6_gpe_rewrite (vxlan_gpe_tunnel_t * t, u32 extension_size,
253  u8 protocol_override, uword encap_next_node);
254 
255 /**
256  * @brief Struct for defining VXLAN GPE next nodes
257  */
258 typedef enum
259 {
265 
266 
267 void vxlan_gpe_unregister_decap_protocol (u8 protocol_id,
268  uword next_node_index);
269 
270 void vxlan_gpe_register_decap_protocol (u8 protocol_id,
271  uword next_node_index);
272 
273 void vnet_int_vxlan_gpe_bypass_mode (u32 sw_if_index, u8 is_ip6,
274  u8 is_enable);
275 
276 #endif /* included_vnet_vxlan_gpe_h */
277 
278 /*
279  * fd.io coding-style-patch-verification: ON
280  *
281  * Local Variables:
282  * eval: (c-set-style "gnu")
283  * End:
284  */
uword * vxlan6_gpe_tunnel_by_key
lookup IPv6 VXLAN GPE tunnel by key
Definition: vxlan_gpe.h:201
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:160
u8 pad[3]
log2 (size of the packing page block)
Definition: bihash_doc.h:61
u32 flags
flags
Definition: vxlan_gpe.h:134
vlib_node_registration_t vxlan_gpe_encap_node
(constructor) VLIB_REGISTER_NODE (vxlan_gpe_encap_node)
Definition: encap.c:392
a
Definition: bitmap.h:516
u64 as_u64
Definition: bihash_doc.h:63
adj_index_t mcast_adj_index
Definition: vxlan_gpe.h:152
vxlan_gpe_encap_next_t
Struct for defining VXLAN GPE next nodes.
Definition: vxlan_gpe.h:258
uword * mcast_shared
Definition: vxlan_gpe.h:208
u32 * tunnel_index_by_sw_if_index
Mapping from sw_if_index to tunnel index.
Definition: vxlan_gpe.h:213
u8 * format_vxlan_gpe_encap_trace(u8 *s, va_list *args)
Trace of packets encapsulated in VXLAN GPE.
Definition: encap.c:69
struct _vlib_node_registration vlib_node_registration_t
vnet_main_t * vnet_main
State convenience vnet_main_t.
Definition: vxlan_gpe.h:218
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:113
unsigned long u64
Definition: types.h:89
fib_node_index_t fib_entry_index
Definition: vxlan_gpe.h:151
u8 * rewrite
Rewrite string.
Definition: vxlan_gpe.h:105
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:166
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:464
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:216
u8 protocol
encapsulated protocol
Definition: vxlan_gpe.h:108
An node in the FIB graph.
Definition: fib_node.h:286
ip46_address_t remote
tunnel remote address
Definition: vxlan_gpe.h:115
u32 vni
VXLAN GPE VNI in HOST byte order, shifted left 8 bits.
Definition: vxlan_gpe.h:126
void vnet_int_vxlan_gpe_bypass_mode(u32 sw_if_index, u8 is_ip6, u8 is_enable)
Definition: vxlan_gpe.c:1038
Struct for VXLAN GPE add/del args.
Definition: vxlan_gpe.h:233
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:325
fib_node_t node
Linkage into the FIB object graph.
Definition: vxlan_gpe.h:145
u32 fib_node_index_t
A typedef of a node index.
Definition: fib_types.h:29
vxlan_gpe_input_error_t
struct for VXLAN GPE errors
Definition: vxlan_gpe.h:184
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:168
void vxlan_gpe_register_decap_protocol(u8 protocol_id, uword next_node_index)
Definition: decap.c:685
unsigned int u32
Definition: types.h:88
u8 rewrite_size
rewrite size for dynamic plugins like iOAM
Definition: vxlan_gpe.h:137
Struct for VXLAN GPE node state.
Definition: vxlan_gpe.h:193
dpo_id_t next_dpo
Definition: vxlan_gpe.h:111
vxlan_gpe_tunnel_t * tunnels
vector of encap tunnel instances
Definition: vxlan_gpe.h:196
u64 uword
Definition: types.h:112
uword * vxlan4_gpe_tunnel_by_key
lookup IPv4 VXLAN GPE tunnel by key
Definition: vxlan_gpe.h:199
u32 decap_fib_index
FIB indices - inner IP packet lookup here.
Definition: vxlan_gpe.h:123
unsigned char u8
Definition: types.h:56
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:267
VXLAN GPE Header definition.
u32 hw_if_index
vnet intfc hw_if_index
Definition: vxlan_gpe.h:129
vxlan_gpe_input_next_t
struct for next nodes for VXLAN GPE input
Definition: vxlan_gpe.h:175
u32 encap_fib_index
FIB indices - tunnel partner lookup here.
Definition: vxlan_gpe.h:121
uword encap_next_node
Next node after VxLAN-GPE encap.
Definition: vxlan_gpe.h:140
u32 sw_if_index
vnet intfc sw_if_index
Definition: vxlan_gpe.h:131
u32 * free_vxlan_gpe_tunnel_hw_if_indices
Free vlib hw_if_indices.
Definition: vxlan_gpe.h:210