a6da81880dbfe831da9bb89884a906becadabfa7
[vpp.git] / src / vnet / lisp-cp / control.h
1 /*
2  * Copyright (c) 2016 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 #ifndef VNET_CONTROL_H_
17 #define VNET_CONTROL_H_
18
19 #include <vnet/vnet.h>
20 #include <vnet/lisp-cp/gid_dictionary.h>
21 #include <vnet/lisp-cp/lisp_types.h>
22 #include <vppinfra/timing_wheel.h>
23
24 #define NUMBER_OF_RETRIES                   1
25 #define PENDING_MREQ_EXPIRATION_TIME        3.0 /* seconds */
26 #define PENDING_MREQ_QUEUE_LEN              5
27
28 #define RLOC_PROBING_INTERVAL               60.0
29
30 /* when map-registration is enabled "quick registration" takes place first.
31    In this mode ETR sends map-register messages at an increased frequency
32    until specified message count is reached */
33 #define QUICK_MAP_REGISTER_MSG_COUNT        5
34 #define QUICK_MAP_REGISTER_INTERVAL         3.0
35
36 /* normal map-register period */
37 #define MAP_REGISTER_INTERVAL               60.0
38
39 /* how many tries until next map-server election */
40 #define MAX_EXPIRED_MAP_REGISTERS_DEFAULT   3
41
42 #define PENDING_MREG_EXPIRATION_TIME        3.0 /* seconds */
43
44 /* 24 hours */
45 #define MAP_REGISTER_DEFAULT_TTL            86400
46
47 typedef struct
48 {
49   gid_address_t src;
50   gid_address_t dst;
51   u32 retries_num;
52   f64 time_to_expire;
53   u8 is_smr_invoked;
54   u64 *nonces;
55   u8 to_be_removed;
56 } pending_map_request_t;
57
58 typedef struct
59 {
60   f64 time_to_expire;
61 } pending_map_register_t;
62
63 typedef struct
64 {
65   gid_address_t leid;
66   gid_address_t reid;
67   u8 is_src_dst;
68   locator_pair_t *locator_pairs;
69 } fwd_entry_t;
70
71 typedef struct
72 {
73   gid_address_t leid;
74   gid_address_t reid;
75 } lisp_adjacency_t;
76
77 typedef enum
78 {
79   IP4_MISS_PACKET,
80   IP6_MISS_PACKET
81 } miss_packet_type_t;
82
83 /* map-server/map-resolver structure */
84 typedef struct
85 {
86   u8 is_down;
87   f64 last_update;
88   ip_address_t address;
89   char *key;
90 } lisp_msmr_t;
91
92 typedef struct
93 {
94   /* headers */
95   u8 data[100];
96   u32 length;
97   miss_packet_type_t type;
98 } miss_packet_t;
99
100 typedef struct
101 {
102   u8 mac[6];
103   u32 ip4;
104 } lisp_api_l2_arp_entry_t;
105
106 typedef struct
107 {
108   u8 mac[6];
109   u8 ip6[16];
110 } lisp_api_ndp_entry_t;
111
112 typedef enum
113 {
114   MR_MODE_DST_ONLY = 0,
115   MR_MODE_SRC_DST,
116   _MR_MODE_MAX
117 } map_request_mode_t;
118
119 #define foreach_lisp_flag_bit       \
120   _(USE_PETR, "Use Proxy-ETR")                  \
121   _(STATS_ENABLED, "Statistics enabled")
122
123 typedef enum lisp_flag_bits
124 {
125 #define _(sym, str) LISP_FLAG_BIT_##sym,
126   foreach_lisp_flag_bit
127 #undef _
128 } lisp_flag_bits_e;
129
130 typedef enum lisp_flags
131 {
132 #define _(sym, str) LISP_FLAG_##sym = 1 << LISP_FLAG_BIT_##sym,
133   foreach_lisp_flag_bit
134 #undef _
135 } lisp_flags_e;
136
137 typedef struct
138 {
139   ip_address_t addr;
140   u32 bd;
141 } lisp_l2_arp_key_t;
142
143 typedef enum
144 {
145   LISP_TRANSPORT_PROTOCOL_UDP = 1,
146   LISP_TRANSPORT_PROTOCOL_API
147 } lisp_transport_protocol_t;
148
149 typedef struct
150 {
151   u64 nonce;
152   u8 is_rloc_probe;
153   mapping_t *mappings;
154   volatile u8 is_free;
155 } map_records_arg_t;
156
157 typedef struct
158 {
159   u32 flags;
160
161   /* LISP feature status */
162   u8 is_enabled;
163
164   /* eid table */
165   gid_dictionary_t mapping_index_by_gid;
166
167   /* pool of mappings */
168   mapping_t *mapping_pool;
169
170   /* hash map of secret keys by mapping index */
171   u8 *key_by_mapping_index;
172
173   /* pool of locators */
174   locator_t *locator_pool;
175
176   /* pool of locator-sets */
177   locator_set_t *locator_set_pool;
178
179   /* vector of locator-set vectors composed of and indexed by locator index */
180   u32 **locator_to_locator_sets;
181
182   /* hash map of locators by name */
183   uword *locator_set_index_by_name;
184
185   /* vector of eid index vectors supported and indexed by locator-set index */
186   u32 **locator_set_to_eids;
187
188   /* vectors of indexes for local locator-sets and mappings */
189   u32 *local_mappings_indexes;
190   u32 *local_locator_set_indexes;
191
192   /* hash map of forwarding entries by mapping index */
193   u32 *fwd_entry_by_mapping_index;
194
195   /* pool of vectors of rmts per lcl mapping in adjacencies */
196   u32 **lcl_to_rmt_adjacencies;
197
198   /* hash of pool positions of vectors of rmts by lcl mapping index */
199   u32 *lcl_to_rmt_adjs_by_lcl_idx;
200
201   /* forwarding entries pool */
202   fwd_entry_t *fwd_entry_pool;
203
204   /* hash map keyed by nonce of pending map-requests */
205   uword *pending_map_requests_by_nonce;
206
207   /* pool of pending map requests */
208   pending_map_request_t *pending_map_requests_pool;
209
210   /* pool of pending map registers */
211   pending_map_register_t *pending_map_registers_pool;
212
213   /* hash map of sent map register messages */
214   uword *map_register_messages_by_nonce;
215
216   /* vector of map-resolvers */
217   lisp_msmr_t *map_resolvers;
218
219   /* vector of map-servers */
220   lisp_msmr_t *map_servers;
221
222   /* map resolver address currently being used for sending requests.
223    * This has to be an actual address and not an index to map_resolvers vector
224    * since the vector may be modified during request resend/retry procedure
225    * and break things :-) */
226   ip_address_t active_map_resolver;
227   ip_address_t active_map_server;
228
229   u8 do_map_resolver_election;
230   u8 do_map_server_election;
231
232   /* map-request  locator set index */
233   u32 mreq_itr_rlocs;
234
235   /* vni to vrf hash tables */
236   uword *table_id_by_vni;
237   uword *vni_by_table_id;
238
239   /* vni to bd-index hash tables */
240   uword *bd_id_by_vni;
241   uword *vni_by_bd_id;
242
243   /* track l2 and l3 interfaces that have been created for vni */
244   uword *l2_dp_intf_by_vni;
245
246   /* Proxy ITR map index */
247   u32 pitr_map_index;
248
249   /** Proxy ETR map index */
250   u32 petr_map_index;
251
252   /* LISP PITR mode */
253   u8 lisp_pitr;
254
255   /* mapping index for NSH */
256   u32 nsh_map_index;
257
258   /* map request mode */
259   u8 map_request_mode;
260
261   /* enable/disable map registering */
262   u8 map_registering;
263
264   /* enable/disable rloc-probing */
265   u8 rloc_probing;
266
267   /* timing wheel for mappping timeouts */
268   timing_wheel_t wheel;
269
270   /** Per thread pool of records shared with thread0 */
271   map_records_arg_t **map_records_args_pool;
272
273   /* TTL used for all mappings when registering */
274   u32 map_register_ttl;
275
276   /* control variables for map server election */
277   u32 max_expired_map_registers;
278   u32 expired_map_registers;
279
280   /** either UDP based or binary API. Default is UDP */
281   lisp_transport_protocol_t transport_protocol;
282
283   /* commodity */
284   ip4_main_t *im4;
285   ip6_main_t *im6;
286   vlib_main_t *vlib_main;
287   vnet_main_t *vnet_main;
288 } lisp_cp_main_t;
289
290 /* lisp-gpe control plane */
291 extern lisp_cp_main_t lisp_control_main;
292
293 extern vlib_node_registration_t lisp_cp_input_node;
294 extern vlib_node_registration_t lisp_cp_lookup_ip4_node;
295 extern vlib_node_registration_t lisp_cp_lookup_ip6_node;
296
297 clib_error_t *lisp_cp_init ();
298
299 always_inline lisp_cp_main_t *
300 vnet_lisp_cp_get_main ()
301 {
302   return &lisp_control_main;
303 }
304
305 void
306 get_src_and_dst_eids_from_buffer (lisp_cp_main_t * lcm, vlib_buffer_t * b,
307                                   gid_address_t * src, gid_address_t * dst,
308                                   u16 type);
309
310 typedef struct
311 {
312   u8 is_add;
313   union
314   {
315     u8 *name;
316     u32 index;
317   };
318   locator_t *locators;
319   u8 local;
320 } vnet_lisp_add_del_locator_set_args_t;
321
322 int
323 vnet_lisp_add_del_locator_set (vnet_lisp_add_del_locator_set_args_t * a,
324                                u32 * ls_index);
325 int
326 vnet_lisp_add_del_locator (vnet_lisp_add_del_locator_set_args_t * a,
327                            locator_set_t * ls, u32 * ls_index);
328
329 typedef struct
330 {
331   u8 is_add;
332   gid_address_t eid;
333   u32 locator_set_index;
334
335   u32 ttl;
336   u8 action;
337   u8 authoritative;
338
339   u8 local;
340   u8 is_static;
341   u8 *key;
342   u8 key_id;
343 } vnet_lisp_add_del_mapping_args_t;
344
345 int
346 vnet_lisp_map_cache_add_del (vnet_lisp_add_del_mapping_args_t * a,
347                              u32 * map_index);
348 int
349 vnet_lisp_add_del_local_mapping (vnet_lisp_add_del_mapping_args_t * a,
350                                  u32 * map_index_result);
351
352 int
353 vnet_lisp_add_mapping (vnet_lisp_add_del_mapping_args_t * a,
354                        locator_t * rlocs, u32 * res_map_index,
355                        u8 * is_changed);
356
357 int vnet_lisp_del_mapping (gid_address_t * eid, u32 * res_map_index);
358
359 typedef struct
360 {
361   gid_address_t reid;
362   gid_address_t leid;
363   u8 is_add;
364 } vnet_lisp_add_del_adjacency_args_t;
365
366 int vnet_lisp_add_del_adjacency (vnet_lisp_add_del_adjacency_args_t * a);
367
368 typedef struct
369 {
370   u8 is_add;
371   ip_address_t address;
372 } vnet_lisp_add_del_map_resolver_args_t;
373
374 int
375 vnet_lisp_add_del_map_resolver (vnet_lisp_add_del_map_resolver_args_t * a);
376 int vnet_lisp_add_del_map_server (ip_address_t * addr, u8 is_add);
377
378 clib_error_t *vnet_lisp_enable_disable (u8 is_enabled);
379 u8 vnet_lisp_enable_disable_status (void);
380
381 int vnet_lisp_pitr_set_locator_set (u8 * locator_set_name, u8 is_add);
382 int vnet_lisp_use_petr (ip_address_t * ip, u8 is_add);
383
384 typedef struct
385 {
386   u8 is_add;
387   u8 *locator_set_name;
388 } vnet_lisp_add_del_mreq_itr_rloc_args_t;
389
390 int
391 vnet_lisp_add_del_mreq_itr_rlocs (vnet_lisp_add_del_mreq_itr_rloc_args_t * a);
392
393 int vnet_lisp_clear_all_remote_adjacencies (void);
394
395 int vnet_lisp_eid_table_map (u32 vni, u32 vrf, u8 is_l2, u8 is_add);
396 int vnet_lisp_add_del_map_table_key (gid_address_t * eid, char *key,
397                                      u8 is_add);
398 int vnet_lisp_set_map_request_mode (u8 mode);
399 u8 vnet_lisp_get_map_request_mode (void);
400 lisp_adjacency_t *vnet_lisp_adjacencies_get_by_vni (u32 vni);
401 int vnet_lisp_rloc_probe_enable_disable (u8 is_enable);
402 int vnet_lisp_map_register_enable_disable (u8 is_enable);
403 u8 vnet_lisp_map_register_state_get (void);
404 u8 vnet_lisp_rloc_probe_state_get (void);
405 int vnet_lisp_add_del_l2_arp_ndp_entry (gid_address_t * key, u8 * mac,
406                                         u8 is_add);
407 u32 *vnet_lisp_l2_arp_bds_get (void);
408 lisp_api_l2_arp_entry_t *vnet_lisp_l2_arp_entries_get_by_bd (u32 bd);
409 int vnet_lisp_nsh_set_locator_set (u8 * locator_set_name, u8 is_add);
410 int vnet_lisp_map_register_set_ttl (u32 ttl);
411 u32 vnet_lisp_map_register_get_ttl (void);
412 int vnet_lisp_map_register_fallback_threshold_set (u32 value);
413 u32 vnet_lisp_map_register_fallback_threshold_get (void);
414 u32 *vnet_lisp_ndp_bds_get (void);
415 lisp_api_ndp_entry_t *vnet_lisp_ndp_entries_get_by_bd (u32 bd);
416 u32 vnet_lisp_set_transport_protocol (u8 protocol);
417 lisp_transport_protocol_t vnet_lisp_get_transport_protocol (void);
418
419 map_records_arg_t *parse_map_reply (vlib_buffer_t * b);
420
421 always_inline mapping_t *
422 lisp_get_petr_mapping (lisp_cp_main_t * lcm)
423 {
424   return pool_elt_at_index (lcm->mapping_pool, lcm->petr_map_index);
425 }
426
427 #endif /* VNET_CONTROL_H_ */
428
429 /*
430  * fd.io coding-style-patch-verification: ON
431  *
432  * Local Variables:
433  * eval: (c-set-style "gnu")
434  * End:
435  */