2 * esp_encrypt.c : IPSec ESP encrypt node using DPDK Cryptodev
4 * Copyright (c) 2017 Intel 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:
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
18 #include <vnet/vnet.h>
19 #include <vnet/api_errno.h>
20 #include <vnet/ip/ip.h>
22 #include <vnet/ipsec/ipsec.h>
23 #include <vnet/ipsec/esp.h>
24 #include <vnet/udp/udp.h>
25 #include <dpdk/buffer.h>
26 #include <dpdk/ipsec/ipsec.h>
27 #include <dpdk/device/dpdk.h>
28 #include <dpdk/device/dpdk_priv.h>
30 #define foreach_esp_encrypt_next \
31 _(DROP, "error-drop") \
32 _(IP4_LOOKUP, "ip4-lookup") \
33 _(IP6_LOOKUP, "ip6-lookup") \
34 _(INTERFACE_OUTPUT, "interface-output")
36 #define _(v, s) ESP_ENCRYPT_NEXT_##v,
39 foreach_esp_encrypt_next
44 #define foreach_esp_encrypt_error \
45 _(RX_PKTS, "ESP pkts received") \
46 _(SEQ_CYCLED, "Sequence number cycled") \
47 _(ENQ_FAIL, "Enqueue failed to crypto device") \
48 _(DISCARD, "Not enough crypto operations, discarding frame") \
49 _(SESSION, "Failed to get crypto session") \
50 _(NOSUP, "Cipher/Auth not supported")
55 #define _(sym,str) ESP_ENCRYPT_ERROR_##sym,
56 foreach_esp_encrypt_error
59 } esp_encrypt_error_t;
61 static char *esp_encrypt_error_strings[] = {
62 #define _(sym,string) string,
63 foreach_esp_encrypt_error
67 extern vlib_node_registration_t dpdk_esp4_encrypt_node;
68 extern vlib_node_registration_t dpdk_esp6_encrypt_node;
72 ipsec_crypto_alg_t crypto_alg;
73 ipsec_integ_alg_t integ_alg;
75 } esp_encrypt_trace_t;
77 /* packet trace format function */
79 format_esp_encrypt_trace (u8 * s, va_list * args)
81 CLIB_UNUSED (vlib_main_t * vm) = va_arg (*args, vlib_main_t *);
82 CLIB_UNUSED (vlib_node_t * node) = va_arg (*args, vlib_node_t *);
83 esp_encrypt_trace_t *t = va_arg (*args, esp_encrypt_trace_t *);
84 ip4_header_t *ih4 = (ip4_header_t *) t->packet_data;
85 u32 indent = format_get_indent (s), offset;
87 s = format (s, "cipher %U auth %U\n",
88 format_ipsec_crypto_alg, t->crypto_alg,
89 format_ipsec_integ_alg, t->integ_alg);
91 if ((ih4->ip_version_and_header_length & 0xF0) == 0x60)
93 s = format (s, "%U%U", format_white_space, indent,
94 format_ip6_header, ih4);
95 offset = sizeof (ip6_header_t);
99 s = format (s, "%U%U", format_white_space, indent,
100 format_ip4_header, ih4);
101 offset = ip4_header_bytes (ih4);
104 s = format (s, "\n%U%U", format_white_space, indent,
105 format_esp_header, t->packet_data + offset);
111 dpdk_esp_encrypt_inline (vlib_main_t * vm,
112 vlib_node_runtime_t * node,
113 vlib_frame_t * from_frame, int is_ip6)
115 u32 n_left_from, *from, *to_next, next_index, thread_index;
116 ipsec_main_t *im = &ipsec_main;
117 u32 thread_idx = vlib_get_thread_index ();
118 dpdk_crypto_main_t *dcm = &dpdk_crypto_main;
119 crypto_resource_t *res = 0;
121 crypto_alg_t *cipher_alg = 0, *auth_alg = 0;
122 struct rte_cryptodev_sym_session *session = 0;
123 u32 ret, last_sa_index = ~0;
124 u8 numa = rte_socket_id ();
126 crypto_worker_main_t *cwm =
127 vec_elt_at_index (dcm->workers_main, thread_idx);
128 struct rte_crypto_op **ops = cwm->ops;
130 from = vlib_frame_vector_args (from_frame);
131 n_left_from = from_frame->n_vectors;
132 thread_index = vm->thread_index;
134 ret = crypto_alloc_ops (numa, ops, n_left_from);
138 vlib_node_increment_counter (vm, dpdk_esp6_encrypt_node.index,
139 ESP_ENCRYPT_ERROR_DISCARD, 1);
141 vlib_node_increment_counter (vm, dpdk_esp4_encrypt_node.index,
142 ESP_ENCRYPT_ERROR_DISCARD, 1);
143 /* Discard whole frame */
147 next_index = ESP_ENCRYPT_NEXT_DROP;
149 while (n_left_from > 0)
153 vlib_get_next_frame (vm, node, next_index, to_next, n_left_to_next);
155 while (n_left_from > 0 && n_left_to_next > 0)
159 vlib_buffer_t *b0 = 0;
161 ip4_and_esp_header_t *ih0, *oh0 = 0;
162 ip6_and_esp_header_t *ih6_0, *oh6_0 = 0;
163 ip4_and_udp_and_esp_header_t *ouh0 = 0;
171 u16 udp_encap_adv = 0;
172 struct rte_mbuf *mb0 = 0;
173 struct rte_crypto_op *op;
180 b0 = vlib_get_buffer (vm, bi0);
181 ih0 = vlib_buffer_get_current (b0);
182 mb0 = rte_mbuf_from_vlib_buffer (b0);
185 CLIB_PREFETCH (ih0, sizeof (ih6_0[0]), LOAD);
187 CLIB_PREFETCH (vlib_buffer_get_tail (b0), 20, STORE);
189 CLIB_PREFETCH (mb0, CLIB_CACHE_LINE_BYTES, STORE);
193 ASSERT (op->status == RTE_CRYPTO_OP_STATUS_NOT_PROCESSED);
195 dpdk_op_priv_t *priv = crypto_op_get_priv (op);
196 /* store bi in op private */
200 sizeof (op[0]) + sizeof (op[0].sym[0]) + sizeof (priv[0]);
201 CLIB_PREFETCH (op, op_len, STORE);
203 sa_index0 = vnet_buffer (b0)->ipsec.sad_index;
205 if (sa_index0 != last_sa_index)
207 sa0 = pool_elt_at_index (im->sad, sa_index0);
210 vec_elt_at_index (dcm->cipher_algs, sa0->crypto_alg);
211 auth_alg = vec_elt_at_index (dcm->auth_algs, sa0->integ_alg);
213 is_aead = (cipher_alg->type == RTE_CRYPTO_SYM_XFORM_AEAD);
216 auth_alg = cipher_alg;
218 res_idx = get_resource (cwm, sa0);
220 if (PREDICT_FALSE (res_idx == (u16) ~ 0))
222 clib_warning ("unsupported SA by thread index %u",
225 vlib_node_increment_counter (vm,
226 dpdk_esp6_encrypt_node.index,
227 ESP_ENCRYPT_ERROR_NOSUP, 1);
229 vlib_node_increment_counter (vm,
230 dpdk_esp4_encrypt_node.index,
231 ESP_ENCRYPT_ERROR_NOSUP, 1);
237 res = vec_elt_at_index (dcm->resource, res_idx);
239 error = crypto_get_session (&session, sa_index0, res, cwm, 1);
240 if (PREDICT_FALSE (error || !session))
242 clib_warning ("failed to get crypto session");
244 vlib_node_increment_counter (vm,
245 dpdk_esp6_encrypt_node.index,
246 ESP_ENCRYPT_ERROR_SESSION,
249 vlib_node_increment_counter (vm,
250 dpdk_esp4_encrypt_node.index,
251 ESP_ENCRYPT_ERROR_SESSION,
259 last_sa_index = sa_index0;
262 if (PREDICT_FALSE (esp_seq_advance (sa0)))
264 clib_warning ("sequence number counter has cycled SPI %u",
267 vlib_node_increment_counter (vm,
268 dpdk_esp6_encrypt_node.index,
269 ESP_ENCRYPT_ERROR_SEQ_CYCLED, 1);
271 vlib_node_increment_counter (vm,
272 dpdk_esp4_encrypt_node.index,
273 ESP_ENCRYPT_ERROR_SEQ_CYCLED, 1);
281 orig_sz = b0->current_length;
283 /* TODO multi-seg support - total_length_not_including_first_buffer */
284 vlib_increment_combined_counter
285 (&ipsec_sa_counters, thread_index, sa_index0,
286 1, b0->current_length);
288 res->ops[res->n_ops] = op;
289 res->bi[res->n_ops] = bi0;
292 dpdk_gcm_cnt_blk *icb = &priv->cb;
294 crypto_set_icb (icb, sa0->salt, sa0->seq, sa0->seq_hi);
296 iv_size = cipher_alg->iv_len;
297 trunc_size = auth_alg->trunc_size;
299 /* if UDP encapsulation is used adjust the address of the IP header */
300 if (sa0->udp_encap && !is_ip6)
301 udp_encap_adv = sizeof (udp_header_t);
306 if (!is_ip6 && !sa0->is_tunnel_ip6) /* ip4inip4 */
308 /* in tunnel mode send it back to FIB */
309 priv->next = DPDK_CRYPTO_INPUT_NEXT_IP4_LOOKUP;
310 u8 adv = sizeof (ip4_header_t) + udp_encap_adv +
311 sizeof (esp_header_t) + iv_size;
312 vlib_buffer_advance (b0, -adv);
313 oh0 = vlib_buffer_get_current (b0);
314 ouh0 = vlib_buffer_get_current (b0);
315 next_hdr_type = IP_PROTOCOL_IP_IN_IP;
317 * oh0->ip4.ip_version_and_header_length = 0x45;
318 * oh0->ip4.tos = ih0->ip4.tos;
319 * oh0->ip4.fragment_id = 0;
320 * oh0->ip4.flags_and_fragment_offset = 0;
322 oh0->ip4.checksum_data_64[0] =
323 clib_host_to_net_u64 (0x45ULL << 56);
325 * oh0->ip4.ttl = 254;
326 * oh0->ip4.protocol = IP_PROTOCOL_IPSEC_ESP;
328 oh0->ip4.checksum_data_32[2] =
329 clib_host_to_net_u32 (0xfe320000);
331 oh0->ip4.src_address.as_u32 =
332 sa0->tunnel_src_addr.ip4.as_u32;
333 oh0->ip4.dst_address.as_u32 =
334 sa0->tunnel_dst_addr.ip4.as_u32;
338 oh0->ip4.protocol = IP_PROTOCOL_UDP;
343 esp0->spi = clib_host_to_net_u32 (sa0->spi);
344 esp0->seq = clib_host_to_net_u32 (sa0->seq);
346 else if (is_ip6 && sa0->is_tunnel_ip6) /* ip6inip6 */
348 /* in tunnel mode send it back to FIB */
349 priv->next = DPDK_CRYPTO_INPUT_NEXT_IP6_LOOKUP;
352 sizeof (ip6_header_t) + sizeof (esp_header_t) + iv_size;
353 vlib_buffer_advance (b0, -adv);
354 ih6_0 = (ip6_and_esp_header_t *) ih0;
355 oh6_0 = vlib_buffer_get_current (b0);
357 next_hdr_type = IP_PROTOCOL_IPV6;
359 oh6_0->ip6.ip_version_traffic_class_and_flow_label =
360 ih6_0->ip6.ip_version_traffic_class_and_flow_label;
362 oh6_0->ip6.protocol = IP_PROTOCOL_IPSEC_ESP;
363 oh6_0->ip6.hop_limit = 254;
364 oh6_0->ip6.src_address.as_u64[0] =
365 sa0->tunnel_src_addr.ip6.as_u64[0];
366 oh6_0->ip6.src_address.as_u64[1] =
367 sa0->tunnel_src_addr.ip6.as_u64[1];
368 oh6_0->ip6.dst_address.as_u64[0] =
369 sa0->tunnel_dst_addr.ip6.as_u64[0];
370 oh6_0->ip6.dst_address.as_u64[1] =
371 sa0->tunnel_dst_addr.ip6.as_u64[1];
373 oh6_0->esp.spi = clib_host_to_net_u32 (sa0->spi);
374 oh6_0->esp.seq = clib_host_to_net_u32 (sa0->seq);
376 else /* unsupported ip4inip6, ip6inip4 */
379 vlib_node_increment_counter (vm,
380 dpdk_esp6_encrypt_node.index,
381 ESP_ENCRYPT_ERROR_NOSUP, 1);
383 vlib_node_increment_counter (vm,
384 dpdk_esp4_encrypt_node.index,
385 ESP_ENCRYPT_ERROR_NOSUP, 1);
391 vnet_buffer (b0)->sw_if_index[VLIB_TX] = (u32) ~ 0;
393 else /* transport mode */
395 priv->next = DPDK_CRYPTO_INPUT_NEXT_INTERFACE_OUTPUT;
396 rewrite_len = vnet_buffer (b0)->ip.save_rewrite_length;
397 u16 adv = sizeof (esp_header_t) + iv_size + udp_encap_adv;
398 vlib_buffer_advance (b0, -adv - rewrite_len);
399 u8 *src = ((u8 *) ih0) - rewrite_len;
400 u8 *dst = vlib_buffer_get_current (b0);
401 oh0 = vlib_buffer_get_current (b0) + rewrite_len;
405 orig_sz -= sizeof (ip6_header_t);
406 ih6_0 = (ip6_and_esp_header_t *) ih0;
407 next_hdr_type = ih6_0->ip6.protocol;
408 memmove (dst, src, rewrite_len + sizeof (ip6_header_t));
409 oh6_0 = (ip6_and_esp_header_t *) oh0;
410 oh6_0->ip6.protocol = IP_PROTOCOL_IPSEC_ESP;
415 u16 ip_size = ip4_header_bytes (&ih0->ip4);
417 next_hdr_type = ih0->ip4.protocol;
418 memmove (dst, src, rewrite_len + ip_size);
419 oh0->ip4.protocol = IP_PROTOCOL_IPSEC_ESP;
420 esp0 = (esp_header_t *) (((u8 *) oh0) + ip_size);
423 oh0->ip4.protocol = IP_PROTOCOL_UDP;
424 esp0 = (esp_header_t *)
425 (((u8 *) oh0) + ip_size + udp_encap_adv);
429 oh0->ip4.protocol = IP_PROTOCOL_IPSEC_ESP;
430 esp0 = (esp_header_t *) (((u8 *) oh0) + ip_size);
433 esp0->spi = clib_host_to_net_u32 (sa0->spi);
434 esp0->seq = clib_host_to_net_u32 (sa0->seq);
437 if (sa0->udp_encap && ouh0)
439 ouh0->udp.src_port = clib_host_to_net_u16 (UDP_DST_PORT_ipsec);
440 ouh0->udp.dst_port = clib_host_to_net_u16 (UDP_DST_PORT_ipsec);
441 ouh0->udp.checksum = 0;
443 ASSERT (is_pow2 (cipher_alg->boundary));
444 u16 mask = cipher_alg->boundary - 1;
445 u16 pad_payload_len = ((orig_sz + 2) + mask) & ~mask;
446 u8 pad_bytes = pad_payload_len - 2 - orig_sz;
449 vlib_buffer_put_uninit (b0, pad_bytes + 2 + trunc_size);
451 /* The extra pad bytes would be overwritten by the digest */
453 clib_memcpy_fast (padding, pad_data, 16);
455 f0 = (esp_footer_t *) (padding + pad_bytes);
456 f0->pad_length = pad_bytes;
457 f0->next_header = next_hdr_type;
461 u16 len = b0->current_length - sizeof (ip6_header_t);
462 oh6_0->ip6.payload_length =
463 clib_host_to_net_u16 (len - rewrite_len);
468 clib_host_to_net_u16 (b0->current_length - rewrite_len);
469 oh0->ip4.checksum = ip4_header_checksum (&oh0->ip4);
470 if (sa0->udp_encap && ouh0)
473 clib_host_to_net_u16 (clib_net_to_host_u16
475 ip4_header_bytes (&ouh0->ip4));
479 b0->flags |= VLIB_BUFFER_TOTAL_LENGTH_VALID;
481 /* mbuf packet starts at ESP header */
482 mb0->data_len = vlib_buffer_get_tail (b0) - ((u8 *) esp0);
483 mb0->pkt_len = vlib_buffer_get_tail (b0) - ((u8 *) esp0);
484 mb0->data_off = ((void *) esp0) - mb0->buf_addr;
486 u32 cipher_off, cipher_len, auth_len = 0;
489 u8 *digest = vlib_buffer_get_tail (b0) - trunc_size;
491 mb0->buf_physaddr + digest - ((u8 *) mb0->buf_addr);
493 if (!is_aead && cipher_alg->alg == RTE_CRYPTO_CIPHER_AES_CBC)
495 cipher_off = sizeof (esp_header_t);
496 cipher_len = iv_size + pad_payload_len;
500 u32 *esp_iv = (u32 *) (esp0 + 1);
501 esp_iv[0] = sa0->seq;
502 esp_iv[1] = sa0->seq_hi;
504 cipher_off = sizeof (esp_header_t) + iv_size;
505 cipher_len = pad_payload_len;
510 aad = (u32 *) priv->aad;
511 aad[0] = clib_host_to_net_u32 (sa0->spi);
512 aad[1] = clib_host_to_net_u32 (sa0->seq);
514 /* aad[3] should always be 0 */
515 if (PREDICT_FALSE (sa0->use_esn))
516 aad[2] = clib_host_to_net_u32 (sa0->seq_hi);
523 vlib_buffer_get_tail (b0) - ((u8 *) esp0) - trunc_size;
526 u32 *_digest = (u32 *) digest;
527 _digest[0] = clib_host_to_net_u32 (sa0->seq_hi);
532 crypto_op_setup (is_aead, mb0, op, session, cipher_off, cipher_len,
533 0, auth_len, (u8 *) aad, digest, digest_paddr);
536 if (PREDICT_FALSE (b0->flags & VLIB_BUFFER_IS_TRACED))
538 esp_encrypt_trace_t *tr =
539 vlib_add_trace (vm, node, b0, sizeof (*tr));
540 tr->crypto_alg = sa0->crypto_alg;
541 tr->integ_alg = sa0->integ_alg;
542 u8 *p = vlib_buffer_get_current (b0);
544 p += vnet_buffer (b0)->ip.save_rewrite_length;
545 clib_memcpy_fast (tr->packet_data, p, sizeof (tr->packet_data));
548 vlib_put_next_frame (vm, node, next_index, n_left_to_next);
552 vlib_node_increment_counter (vm, dpdk_esp6_encrypt_node.index,
553 ESP_ENCRYPT_ERROR_RX_PKTS,
554 from_frame->n_vectors);
556 crypto_enqueue_ops (vm, cwm, dpdk_esp6_encrypt_node.index,
557 ESP_ENCRYPT_ERROR_ENQ_FAIL, numa);
561 vlib_node_increment_counter (vm, dpdk_esp4_encrypt_node.index,
562 ESP_ENCRYPT_ERROR_RX_PKTS,
563 from_frame->n_vectors);
565 crypto_enqueue_ops (vm, cwm, dpdk_esp4_encrypt_node.index,
566 ESP_ENCRYPT_ERROR_ENQ_FAIL, numa);
569 crypto_free_ops (numa, ops, cwm->ops + from_frame->n_vectors - ops);
571 return from_frame->n_vectors;
574 VLIB_NODE_FN (dpdk_esp4_encrypt_node) (vlib_main_t * vm,
575 vlib_node_runtime_t * node,
576 vlib_frame_t * from_frame)
578 return dpdk_esp_encrypt_inline (vm, node, from_frame, 0 /*is_ip6 */ );
582 VLIB_REGISTER_NODE (dpdk_esp4_encrypt_node) = {
583 .name = "dpdk-esp4-encrypt",
584 .flags = VLIB_NODE_FLAG_IS_OUTPUT,
585 .vector_size = sizeof (u32),
586 .format_trace = format_esp_encrypt_trace,
587 .n_errors = ARRAY_LEN (esp_encrypt_error_strings),
588 .error_strings = esp_encrypt_error_strings,
592 [ESP_ENCRYPT_NEXT_DROP] = "error-drop",
597 VLIB_NODE_FN (dpdk_esp6_encrypt_node) (vlib_main_t * vm,
598 vlib_node_runtime_t * node,
599 vlib_frame_t * from_frame)
601 return dpdk_esp_encrypt_inline (vm, node, from_frame, 1 /*is_ip6 */ );
605 VLIB_REGISTER_NODE (dpdk_esp6_encrypt_node) = {
606 .name = "dpdk-esp6-encrypt",
607 .flags = VLIB_NODE_FLAG_IS_OUTPUT,
608 .vector_size = sizeof (u32),
609 .format_trace = format_esp_encrypt_trace,
610 .n_errors = ARRAY_LEN (esp_encrypt_error_strings),
611 .error_strings = esp_encrypt_error_strings,
615 [ESP_ENCRYPT_NEXT_DROP] = "error-drop",
621 * fd.io coding-style-patch-verification: ON
624 * eval: (c-set-style "gnu")