FD.io VPP  v21.06
Vector Packet Processing
ipsec_itf.c
Go to the documentation of this file.
1 /*
2  * ipsec_itf.c: IPSec dedicated interface type
3  *
4  * Copyright (c) 2020 Cisco and/or its affiliates.
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at:
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */
17 
18 #include <vnet/ip/ip.h>
19 #include <vnet/ipsec/ipsec_itf.h>
20 #include <vnet/ipsec/ipsec_tun.h>
21 #include <vnet/ipsec/ipsec.h>
22 #include <vnet/adj/adj_midchain.h>
24 
25 /* bitmap of Allocated IPSEC_ITF instances */
27 
28 /* pool of interfaces */
30 
32 
35 {
36  return (pool_elt_at_index (ipsec_itf_pool, ii));
37 }
38 
39 static ipsec_itf_t *
41 {
42  if (vec_len (ipsec_itf_index_by_sw_if_index) <= sw_if_index)
43  return NULL;
45  if (ti == ~0)
46  return NULL;
47  return pool_elt_at_index (ipsec_itf_pool, ti);
48 }
49 
50 static u8 *
51 format_ipsec_itf_name (u8 * s, va_list * args)
52 {
53  u32 dev_instance = va_arg (*args, u32);
54  return format (s, "ipsec%d", dev_instance);
55 }
56 
57 void
59 {
61 }
62 
63 void
65 {
66  const vnet_hw_interface_t *hw;
67 
69 
71  {
72  const ipsec_sa_t *sa;
74 
75  sa = ipsec_sa_get (sai);
78  }
79  else
81 }
82 
83 static adj_walk_rc_t
85 {
86  ipsec_tun_protect_t *itp = arg;
87 
89 
90  return (ADJ_WALK_RC_CONTINUE);
91 }
92 
93 static void
95 {
98 
99  itp = ipsec_tun_protect_get (itpi);
100 
101  /*
102  * walk all the adjacencies on the interface and restack them
103  */
105  {
107  }
108 }
109 
110 static walk_rc_t
112 {
113  const ipsec_itf_t *itf = arg;
114 
115  ipsec_itf_restack (itpi, itf);
116 
117  return (WALK_CONTINUE);
118 }
119 
120 static clib_error_t *
122 {
124  ipsec_itf_t *itf;
125  u32 hw_flags;
126 
127  hi = vnet_get_hw_interface (vnm, hw_if_index);
128  hw_flags = (flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP ?
130  vnet_hw_interface_set_flags (vnm, hw_if_index, hw_flags);
131 
133 
134  if (itf)
137 
138  return (NULL);
139 }
140 
141 static int
143  ip46_address_t * src, ip46_address_t * dst, u8 * is_l2)
144 {
145  ip46_address_reset (src);
146  ip46_address_reset (dst);
147  *is_l2 = 0;
148 
149  return (0);
150 }
151 
152 static u8 *
154 {
155  /*
156  * passing the adj code a NULL rewrite means 'i don't have one cos
157  * t'other end is unresolved'. That's not the case here. For the ipsec
158  * tunnel there are just no bytes of encap to apply in the adj.
159  * So return a zero length rewrite. Encap will be added by a tunnel mode SA.
160  */
161  u8 *rewrite = NULL;
162 
163  vec_validate (rewrite, 0);
164  vec_reset_length (rewrite);
165 
166  return (rewrite);
167 }
168 
169 static u8 *
172  vnet_link_t link_type, const void *dst_address)
173 {
174  return (ipsec_itf_build_rewrite ());
175 }
176 
177 void
179 {
182 }
183 
184 /* *INDENT-OFF* */
185 VNET_DEVICE_CLASS (ipsec_itf_device_class) = {
186  .name = "IPSEC Tunnel",
187  .format_device_name = format_ipsec_itf_name,
188  .admin_up_down_function = ipsec_itf_admin_up_down,
189  .ip_tun_desc = ipsec_itf_tunnel_desc,
190 };
191 
192 VNET_HW_INTERFACE_CLASS(ipsec_hw_interface_class) = {
193  .name = "IPSec",
194  .build_rewrite = ipsec_itf_build_rewrite_i,
195  .update_adjacency = ipsec_itf_update_adj,
197 };
198 VNET_HW_INTERFACE_CLASS(ipsec_p2mp_hw_interface_class) = {
199  .name = "IPSec",
200  .build_rewrite = ipsec_itf_build_rewrite_i,
201  .update_adjacency = ipsec_itf_update_adj,
203 };
204 /* *INDENT-ON* */
205 
206 /*
207  * Maintain a bitmap of allocated ipsec_itf instance numbers.
208  */
209 #define IPSEC_ITF_MAX_INSTANCE (16 * 1024)
210 
211 static u32
213 {
214  /*
215  * Check for dynamically allocated instance number.
216  */
217  if (~0 == want)
218  {
219  u32 bit;
220 
222  if (bit >= IPSEC_ITF_MAX_INSTANCE)
223  {
224  return ~0;
225  }
227  return bit;
228  }
229 
230  /*
231  * In range?
232  */
233  if (want >= IPSEC_ITF_MAX_INSTANCE)
234  {
235  return ~0;
236  }
237 
238  /*
239  * Already in use?
240  */
242  {
243  return ~0;
244  }
245 
246  /*
247  * Grant allocation request.
248  */
250 
251  return want;
252 }
253 
254 static int
256 {
257  if (instance >= IPSEC_ITF_MAX_INSTANCE)
258  {
259  return -1;
260  }
261 
262  if (clib_bitmap_get (ipsec_itf_instances, instance) == 0)
263  {
264  return -1;
265  }
266 
268  return 0;
269 }
270 
271 int
272 ipsec_itf_create (u32 user_instance, tunnel_mode_t mode, u32 * sw_if_indexp)
273 {
274  vnet_main_t *vnm = vnet_get_main ();
275  u32 instance, hw_if_index;
278 
279  ASSERT (sw_if_indexp);
280 
281  *sw_if_indexp = (u32) ~ 0;
282 
283  /*
284  * Allocate a ipsec_itf instance. Either select on dynamically
285  * or try to use the desired user_instance number.
286  */
287  instance = ipsec_itf_instance_alloc (user_instance);
288  if (instance == ~0)
289  return VNET_API_ERROR_INVALID_REGISTRATION;
290 
291  pool_get (ipsec_itf_pool, ipsec_itf);
292 
293  /* tunnel index (or instance) */
294  u32 t_idx = ipsec_itf - ipsec_itf_pool;
295 
296  ipsec_itf->ii_mode = mode;
297  ipsec_itf->ii_user_instance = instance;
298 
299  hw_if_index = vnet_register_interface (vnm,
300  ipsec_itf_device_class.index,
301  ipsec_itf->ii_user_instance,
302  (mode == TUNNEL_MODE_P2P ?
303  ipsec_hw_interface_class.index :
304  ipsec_p2mp_hw_interface_class.index),
305  t_idx);
306 
307  hi = vnet_get_hw_interface (vnm, hw_if_index);
308  vnet_sw_interface_set_mtu (vnm, hi->sw_if_index, 9000);
309 
311  INDEX_INVALID);
313 
314  ipsec_itf->ii_sw_if_index = *sw_if_indexp = hi->sw_if_index;
315 
316  return 0;
317 }
318 
319 int
321 {
322  vnet_main_t *vnm = vnet_get_main ();
323 
324  if (pool_is_free_index (vnm->interface_main.sw_interfaces, sw_if_index))
325  return VNET_API_ERROR_INVALID_SW_IF_INDEX;
326 
327  vnet_hw_interface_t *hw = vnet_get_sup_hw_interface (vnm, sw_if_index);
328  if (hw == 0 || hw->dev_class_index != ipsec_itf_device_class.index)
329  return VNET_API_ERROR_INVALID_SW_IF_INDEX;
330 
332  ipsec_itf = ipsec_itf_find_by_sw_if_index (sw_if_index);
333  if (NULL == ipsec_itf)
334  return VNET_API_ERROR_INVALID_SW_IF_INDEX;
335 
337  return VNET_API_ERROR_INVALID_SW_IF_INDEX;
338 
340  pool_put (ipsec_itf_pool, ipsec_itf);
341 
342  return 0;
343 }
344 
345 static clib_error_t *
347  unformat_input_t * input, vlib_cli_command_t * cmd)
348 {
349  unformat_input_t _line_input, *line_input = &_line_input;
353  int rv;
354 
355  error = NULL;
356  instance = sw_if_index = ~0;
357  mac_address_set_zero (&mac);
358 
359  if (unformat_user (input, unformat_line_input, line_input))
360  {
361  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
362  {
363  if (unformat (line_input, "instance %d", &instance))
364  ;
365  else
366  {
367  error = clib_error_return (0, "unknown input: %U",
368  format_unformat_error, line_input);
369  break;
370  }
371  }
372 
373  unformat_free (line_input);
374 
375  if (error)
376  return error;
377  }
378 
379  rv = ipsec_itf_create (instance, TUNNEL_MODE_P2P, &sw_if_index);
380 
381  if (rv)
382  return clib_error_return (0, "iPSec interface create failed");
383 
385  sw_if_index);
386  return 0;
387 }
388 
389 /*?
390  * Create a IPSec interface.
391  *
392  * @cliexpar
393  * The following two command syntaxes are equivalent:
394  * @cliexcmd{ipsec itf create [instance <instance>]}
395  * Example of how to create a ipsec interface:
396  * @cliexcmd{ipsec itf create}
397 ?*/
398 /* *INDENT-OFF* */
399 VLIB_CLI_COMMAND (ipsec_itf_create_command, static) = {
400  .path = "ipsec itf create",
401  .short_help = "ipsec itf create [instance <instance>]",
402  .function = ipsec_itf_create_cli,
403 };
404 /* *INDENT-ON* */
405 
406 static clib_error_t *
408  unformat_input_t * input, vlib_cli_command_t * cmd)
409 {
410  vnet_main_t *vnm;
412  int rv;
413 
414  vnm = vnet_get_main ();
415  sw_if_index = ~0;
416 
418  {
419  if (unformat
420  (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
421  ;
422  else
423  break;
424  }
425 
426  if (~0 != sw_if_index)
427  {
428  rv = ipsec_itf_delete (sw_if_index);
429 
430  if (rv)
431  return clib_error_return (0, "ipsec interface delete failed");
432  }
433  else
434  return clib_error_return (0, "no such interface: %U",
435  format_unformat_error, input);
436 
437  return 0;
438 }
439 
440 /*?
441  * Delete a IPSEC_ITF interface.
442  *
443  * @cliexpar
444  * The following two command syntaxes are equivalent:
445  * @cliexcmd{ipsec itf delete <interface>}
446  * Example of how to create a ipsec_itf interface:
447  * @cliexcmd{ipsec itf delete ipsec0}
448 ?*/
449 /* *INDENT-OFF* */
450 VLIB_CLI_COMMAND (ipsec_itf_delete_command, static) = {
451  .path = "ipsec itf delete",
452  .short_help = "ipsec itf delete <interface>",
453  .function = ipsec_itf_delete_cli,
454 };
455 /* *INDENT-ON* */
456 
457 static clib_error_t *
459  unformat_input_t * input, vlib_cli_command_t * cmd)
460 {
461  index_t ii;
462 
463  /* *INDENT-OFF* */
464  pool_foreach_index (ii, ipsec_itf_pool)
465  {
466  vlib_cli_output (vm, "%U", format_ipsec_itf, ii);
467  }
468  /* *INDENT-ON* */
469 
470  return NULL;
471 }
472 
473 /**
474  * show IPSEC tunnel protection hash tables
475  */
476 /* *INDENT-OFF* */
477 VLIB_CLI_COMMAND (ipsec_interface_show_node, static) =
478 {
479  .path = "show ipsec interface",
480  .function = ipsec_interface_show,
481  .short_help = "show ipsec interface",
482 };
483 /* *INDENT-ON* */
484 
485 /*
486  * fd.io coding-style-patch-verification: ON
487  *
488  * Local Variables:
489  * eval: (c-set-style "gnu")
490  * End:
491  */
#define vec_validate(V, I)
Make sure vector is long enough for given index (no header, unspecified alignment) ...
Definition: vec.h:524
ipsec_itf_t * ipsec_itf_get(index_t ii)
Definition: ipsec_itf.c:34
static u8 * format_ipsec_itf_name(u8 *s, va_list *args)
Definition: ipsec_itf.c:51
#define pool_foreach_index(i, v)
Definition: pool.h:576
u32 t_fib_index
derived data
Definition: tunnel.h:99
vl_api_mac_address_t mac
Definition: l2.api:559
vl_api_wireguard_peer_flags_t flags
Definition: wireguard.api:105
static vnet_hw_interface_t * vnet_get_sup_hw_interface(vnet_main_t *vnm, u32 sw_if_index)
void vnet_sw_interface_set_mtu(vnet_main_t *vnm, u32 sw_if_index, u32 mtu)
Definition: interface.c:706
vnet_interface_main_t interface_main
Definition: vnet.h:81
static clib_error_t * ipsec_itf_admin_up_down(vnet_main_t *vnm, u32 hw_if_index, u32 flags)
Definition: ipsec_itf.c:121
void adj_midchain_delegate_stack(adj_index_t ai, u32 fib_index, const fib_prefix_t *pfx)
create/attach a midchain delegate and stack it on the prefix passed
static int ipsec_itf_instance_free(u32 instance)
Definition: ipsec_itf.c:255
a non-broadcast multiple access interface
Definition: interface.h:398
static vnet_hw_interface_t * vnet_get_hw_interface(vnet_main_t *vnm, u32 hw_if_index)
u32 index_t
A Data-Path Object is an object that represents actions that are applied to packets are they are swit...
Definition: dpo.h:43
void ipsec_tun_protect_walk_itf(u32 sw_if_index, ipsec_tun_protect_walk_cb_t fn, void *ctx)
Definition: ipsec_tun.c:759
vl_api_address_t src
Definition: gre.api:54
static uword * clib_bitmap_set(uword *ai, uword i, uword value)
Sets the ith bit of a bitmap to new_value Removes trailing zeros from the bitmap. ...
Definition: bitmap.h:167
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:989
u32 vnet_register_interface(vnet_main_t *vnm, u32 dev_class_index, u32 dev_instance, u32 hw_class_index, u32 hw_instance)
Definition: interface.c:812
unformat_function_t unformat_vnet_sw_interface
static adj_walk_rc_t ipsec_itf_adj_stack_cb(adj_index_t ai, void *arg)
Definition: ipsec_itf.c:84
clib_error_t * vnet_hw_interface_set_flags(vnet_main_t *vnm, u32 hw_if_index, vnet_hw_interface_flags_t flags)
Definition: interface.c:513
#define pool_get(P, E)
Allocate an object E from a pool P (unspecified alignment).
Definition: pool.h:255
static clib_error_t * ipsec_itf_delete_cli(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: ipsec_itf.c:407
format_function_t format_vnet_sw_if_index_name
unsigned char u8
Definition: types.h:56
static void ipsec_itf_restack(index_t itpi, const ipsec_itf_t *itf)
Definition: ipsec_itf.c:94
enum fib_protocol_t_ fib_protocol_t
Protocol Type.
#define vec_reset_length(v)
Reset vector length to zero NULL-pointer tolerant.
static_always_inline void mac_address_set_zero(mac_address_t *mac)
Definition: mac_address.h:146
unsigned int u32
Definition: types.h:88
enum walk_rc_t_ walk_rc_t
Walk return code.
VNET_DEVICE_CLASS(ipsec_itf_device_class)
static void ip46_address_reset(ip46_address_t *ip46)
Definition: ip46_address.h:74
void ipsec_itf_adj_unstack(adj_index_t ai)
Definition: ipsec_itf.c:58
ip_address_t t_dst
Definition: tunnel.h:88
enum adj_walk_rc_t_ adj_walk_rc_t
return codes from a adjacency walker callback function
description fragment has unexpected format
Definition: map.api:433
vnet_hw_interface_flags_t flags
Definition: interface.h:642
Aggregate type for a prefix.
Definition: fib_types.h:202
#define clib_error_return(e, args...)
Definition: error.h:99
static ipsec_itf_t * ipsec_itf_pool
Definition: ipsec_itf.c:29
vnet_main_t * vnet_get_main(void)
void ip_address_to_fib_prefix(const ip_address_t *addr, fib_prefix_t *prefix)
convert from a IP address to a FIB prefix
Definition: ip_types.c:270
int __clib_unused rv
Definition: application.c:491
unformat_function_t unformat_line_input
Definition: format.h:275
typedef ipsec_itf
Definition: ipsec.api:344
Definition: cJSON.c:88
#define pool_elt_at_index(p, i)
Returns pointer to element at given index.
Definition: pool.h:553
vl_api_interface_index_t sw_if_index
Definition: wireguard.api:34
u32 adj_get_sw_if_index(adj_index_t ai)
Return the sw interface index of the adjacency.
Definition: adj.c:543
vl_api_ip_proto_t proto
Definition: acl_types.api:51
struct _unformat_input_t unformat_input_t
static ipsec_itf_t * ipsec_itf_find_by_sw_if_index(u32 sw_if_index)
Definition: ipsec_itf.c:40
#define pool_put(P, E)
Free an object E in pool P.
Definition: pool.h:305
vlib_main_t * vm
X-connect all packets from the HOST to the PHY.
Definition: nat44_ei.c:3047
vl_api_tunnel_mode_t mode
Definition: gre.api:48
A dedicated IPSec interface type.
Definition: ipsec_itf.h:94
VNET_HW_INTERFACE_CLASS(ipsec_hw_interface_class)
#define UNFORMAT_END_OF_INPUT
Definition: format.h:137
u32 ti
void ipsec_itf_adj_stack(adj_index_t ai, u32 sai)
Definition: ipsec_itf.c:64
void adj_nbr_midchain_update_rewrite(adj_index_t adj_index, adj_midchain_fixup_t fixup, const void *fixup_data, adj_flags_t flags, u8 *rewrite)
adj_nbr_midchain_update_rewrite
Definition: adj_midchain.c:213
static u32 * ipsec_itf_index_by_sw_if_index
Definition: ipsec_itf.c:31
#define pool_is_free_index(P, I)
Use free bitmap to query whether given index is free.
Definition: pool.h:302
u32 adj_index_t
An index for adjacencies.
Definition: adj_types.h:30
static uword clib_bitmap_get(uword *ai, uword i)
Gets the ith bit value from a bitmap.
Definition: bitmap.h:197
void adj_nbr_walk(u32 sw_if_index, fib_protocol_t adj_nh_proto, adj_walk_cb_t cb, void *ctx)
Walk all adjacencies on a link for a given next-hop protocol.
Definition: adj_nbr.c:592
#define IPSEC_ITF_MAX_INSTANCE
Definition: ipsec_itf.c:209
void adj_midchain_delegate_unstack(adj_index_t ai)
unstack a midchain delegate (this stacks it on a drop)
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:163
#define ASSERT(truth)
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:716
static int ipsec_itf_tunnel_desc(u32 sw_if_index, ip46_address_t *src, ip46_address_t *dst, u8 *is_l2)
Definition: ipsec_itf.c:142
int ii_user_instance
Definition: ipsec_itf.h:97
u32 ii_sw_if_index
Definition: ipsec_itf.h:98
enum vnet_link_t_ vnet_link_t
Link Type: A description of the protocol of packets on the link.
void vnet_delete_hw_interface(vnet_main_t *vnm, u32 hw_if_index)
Definition: interface.c:1052
static ipsec_tun_protect_t * ipsec_tun_protect_get(u32 index)
Definition: ipsec_tun.h:172
int ipsec_itf_delete(u32 sw_if_index)
Definition: ipsec_itf.c:320
void ipsec_itf_update_adj(vnet_main_t *vnm, u32 sw_if_index, adj_index_t ai)
Definition: ipsec_itf.c:178
static uword * ipsec_itf_instances
Definition: ipsec_itf.c:26
vl_api_ip4_address_t hi
Definition: arp.api:37
tunnel_mode_t ii_mode
Definition: ipsec_itf.h:96
static ipsec_sa_t * ipsec_sa_get(u32 sa_index)
Definition: ipsec_sa.h:519
static walk_rc_t ipsec_tun_protect_walk_state_change(index_t itpi, void *arg)
Definition: ipsec_itf.c:111
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
u32 instance
Definition: gre.api:51
#define INDEX_INVALID
Invalid index - used when no index is known blazoned capitals INVALID speak volumes where ~0 does not...
Definition: dpo.h:49
u64 uword
Definition: types.h:112
static void unformat_free(unformat_input_t *i)
Definition: format.h:155
vnet_sw_interface_t * sw_interfaces
Definition: interface.h:1014
a point 2 point interface
Definition: interface.h:394
#define FOR_EACH_FIB_IP_PROTOCOL(_item)
Definition: fib_types.h:69
u8 * format_ipsec_itf(u8 *s, va_list *a)
Definition: ipsec_format.c:414
static clib_error_t * ipsec_itf_create_cli(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: ipsec_itf.c:346
int ipsec_itf_create(u32 user_instance, tunnel_mode_t mode, u32 *sw_if_indexp)
Definition: ipsec_itf.c:272
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
vl_api_ip4_address_t dst
Definition: pnat.api:41
static u8 * ipsec_itf_build_rewrite_i(vnet_main_t *vnm, u32 sw_if_index, vnet_link_t link_type, const void *dst_address)
Definition: ipsec_itf.c:170
static uword clib_bitmap_first_clear(uword *ai)
Return the lowest numbered clear bit in a bitmap.
Definition: bitmap.h:451
#define vec_validate_init_empty(V, I, INIT)
Make sure vector is long enough for given index and initialize empty space (no header, unspecified alignment)
Definition: vec.h:571
static u8 * ipsec_itf_build_rewrite(void)
Definition: ipsec_itf.c:153
enum tunnel_mode_t_ tunnel_mode_t
uword unformat(unformat_input_t *i, const char *fmt,...)
Definition: unformat.c:978
tunnel_t tunnel
Definition: ipsec_sa.h:206
static clib_error_t * ipsec_interface_show(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: ipsec_itf.c:458
static uword unformat_check_input(unformat_input_t *i)
Definition: format.h:163
static u32 ipsec_itf_instance_alloc(u32 want)
Definition: ipsec_itf.c:212
rewrite
Definition: pnat.api:158