Initial GENEVE TUNNEL implementation and tests.
[vpp.git] / src / vnet / geneve / geneve.h
1 /*
2  * Copyright (c) 2017 SUSE LLC.
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 #ifndef included_vnet_geneve_h
16 #define included_vnet_geneve_h
17
18 #include <vppinfra/error.h>
19 #include <vppinfra/hash.h>
20 #include <vnet/vnet.h>
21 #include <vnet/ip/ip.h>
22 #include <vnet/l2/l2_input.h>
23 #include <vnet/l2/l2_output.h>
24 #include <vnet/l2/l2_bd.h>
25 #include <vnet/ethernet/ethernet.h>
26 #include <vnet/geneve/geneve_packet.h>
27 #include <vnet/ip/ip4_packet.h>
28 #include <vnet/ip/ip6_packet.h>
29 #include <vnet/udp/udp.h>
30 #include <vnet/dpo/dpo.h>
31 #include <vnet/adj/adj_types.h>
32
33 #define SUPPORT_OPTIONS_HEADER 0
34
35 typedef CLIB_PACKED (struct
36                      {
37                      ip4_header_t ip4;  /* 20 bytes */
38                      udp_header_t udp;  /* 8 bytes */
39                      geneve_header_t geneve;    /* Min 8 bytes, Max 260 bytes */
40                      }) ip4_geneve_header_t;
41
42 typedef CLIB_PACKED (struct
43                      {
44                      ip6_header_t ip6;  /* 40 bytes */
45                      udp_header_t udp;  /* 8 bytes */
46                      geneve_header_t geneve;    /* Min 8 bytes, Max 260 bytes */
47                      }) ip6_geneve_header_t;
48
49 typedef CLIB_PACKED (struct
50                      {
51                      /*
52                       * Key fields: ip source and geneve vni on incoming GENEVE packet
53                       * all fields in NET byte order
54                       */
55                      union
56                      {
57                      struct
58                      {
59                      u32 remote;
60                      u32 vni;   /* shifted left 8 bits */
61                      };
62                      u64 as_u64;
63                      };
64                      }) geneve4_tunnel_key_t;
65
66 typedef CLIB_PACKED (struct
67                      {
68                      /*
69                       * Key fields: ip source and geneve vni on incoming GENEVE packet
70                       * all fields in NET byte order
71                       */
72                      ip6_address_t remote;
73                      u32 vni;   /* shifted left 8 bits */
74                      }) geneve6_tunnel_key_t;
75
76 typedef struct
77 {
78   /* Rewrite string. $$$$ embed vnet_rewrite header */
79   u8 *rewrite;
80
81   /* FIB DPO for IP forwarding of GENEVE encap packet */
82   dpo_id_t next_dpo;
83
84   /* geneve VNI in HOST byte order */
85   u32 vni;
86
87   /* geneve OPTIONS LEN in HOST byte order */
88 #if SUPPORT_OPTIONS_HEADER==1
89   u8 options_len;
90 #endif
91
92   /* tunnel local and remote addresses */
93   ip46_address_t local;
94   ip46_address_t remote;
95
96   /* mcast packet output intfc index (used only if remote is mcast) */
97   u32 mcast_sw_if_index;
98
99   /* decap next index */
100   u32 decap_next_index;
101
102   /* The FIB index for local/remote addresses */
103   u32 encap_fib_index;
104
105   /* vnet intfc index */
106   u32 sw_if_index;
107   u32 hw_if_index;
108
109   /**
110    * Linkage into the FIB object graph
111    */
112   fib_node_t node;
113
114   /*
115    * The FIB entry for (depending on GENEVE tunnel is unicast or mcast)
116    * sending unicast GENEVE encap packets or receiving mcast GENEVE packets
117    */
118   fib_node_index_t fib_entry_index;
119   adj_index_t mcast_adj_index;
120
121   /**
122    * The tunnel is a child of the FIB entry for its desintion. This is
123    * so it receives updates when the forwarding information for that entry
124    * changes.
125    * The tunnels sibling index on the FIB entry's dependency list.
126    */
127   u32 sibling_index;
128 } geneve_tunnel_t;
129
130 #define foreach_geneve_input_next        \
131 _(DROP, "error-drop")                   \
132 _(L2_INPUT, "l2-input")
133
134 typedef enum
135 {
136 #define _(s,n) GENEVE_INPUT_NEXT_##s,
137   foreach_geneve_input_next
138 #undef _
139     GENEVE_INPUT_N_NEXT,
140 } geneve_input_next_t;
141
142 typedef enum
143 {
144 #define geneve_error(n,s) GENEVE_ERROR_##n,
145 #include <vnet/geneve/geneve_error.def>
146 #undef geneve_error
147   GENEVE_N_ERROR,
148 } geneve_input_error_t;
149
150 typedef struct
151 {
152   /* vector of encap tunnel instances */
153   geneve_tunnel_t *tunnels;
154
155   /* lookup tunnel by key */
156   uword *geneve4_tunnel_by_key; /* keyed on ipv4.remote + vni */
157   uword *geneve6_tunnel_by_key; /* keyed on ipv6.remote + vni */
158
159   /* local VTEP IPs ref count used by geneve-bypass node to check if
160      received GENEVE packet DIP matches any local VTEP address */
161   uword *vtep4;                 /* local ip4 VTEPs keyed on their ip4 addr */
162   uword *vtep6;                 /* local ip6 VTEPs keyed on their ip6 addr */
163
164   /* mcast shared info */
165   uword *mcast_shared;          /* keyed on mcast ip46 addr */
166
167   /* Free vlib hw_if_indices */
168   u32 *free_geneve_tunnel_hw_if_indices;
169
170   /* Mapping from sw_if_index to tunnel index */
171   u32 *tunnel_index_by_sw_if_index;
172
173   /* convenience */
174   vlib_main_t *vlib_main;
175   vnet_main_t *vnet_main;
176 } geneve_main_t;
177
178 geneve_main_t geneve_main;
179
180 extern vlib_node_registration_t geneve4_input_node;
181 extern vlib_node_registration_t geneve6_input_node;
182 extern vlib_node_registration_t geneve4_encap_node;
183 extern vlib_node_registration_t geneve6_encap_node;
184
185 u8 *format_geneve_encap_trace (u8 * s, va_list * args);
186
187 typedef struct
188 {
189   u8 is_add;
190
191   /* we normally use is_ip4, but since this adds to the
192    * structure, this seems less of abreaking change */
193   u8 is_ip6;
194   ip46_address_t local, remote;
195   u32 mcast_sw_if_index;
196   u32 encap_fib_index;
197   u32 decap_next_index;
198   u32 vni;
199 } vnet_geneve_add_del_tunnel_args_t;
200
201 int vnet_geneve_add_del_tunnel
202   (vnet_geneve_add_del_tunnel_args_t * a, u32 * sw_if_indexp);
203
204 void vnet_int_geneve_bypass_mode (u32 sw_if_index, u8 is_ip6, u8 is_enable);
205 #endif /* included_vnet_geneve_h */
206
207 /*
208  * fd.io coding-style-patch-verification: ON
209  *
210  * Local Variables:
211  * eval: (c-set-style "gnu")
212  * End:
213  */