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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 /* ICMPv4 invert type for stateful ACL */
18 static const u8 icmp4_invmap[] = {
19 [ICMP4_echo_request] = ICMP4_echo_reply + 1,
20 [ICMP4_timestamp_request] = ICMP4_timestamp_reply + 1,
21 [ICMP4_information_request] = ICMP4_information_reply + 1,
22 [ICMP4_address_mask_request] = ICMP4_address_mask_reply + 1
25 /* Supported ICMPv4 messages for session creation */
26 static const u8 icmp4_valid_new[] = {
27 [ICMP4_echo_request] = 1,
28 [ICMP4_timestamp_request] = 1,
29 [ICMP4_information_request] = 1,
30 [ICMP4_address_mask_request] = 1
33 /* ICMPv6 invert type for stateful ACL */
34 static const u8 icmp6_invmap[] = {
35 [ICMP6_echo_request - 128] = ICMP6_echo_reply + 1,
36 [ICMP6_node_information_request - 128] = ICMP6_node_information_response + 1
39 /* Supported ICMPv6 messages for session creation */
40 static const u8 icmp6_valid_new[] = {
41 [ICMP6_echo_request - 128] = 1,
42 [ICMP6_node_information_request - 128] = 1
45 /* IP4 and IP6 protocol numbers of ICMP */
46 static u8 icmp_protos[] = { IP_PROTOCOL_ICMP, IP_PROTOCOL_ICMP6 };
51 acl_fa_ifc_has_sessions (acl_main_t * am, int sw_if_index0)
53 return am->fa_sessions_hash_is_initialized;
57 acl_fa_ifc_has_in_acl (acl_main_t * am, int sw_if_index0)
59 int it_has = clib_bitmap_get (am->fa_in_acl_on_sw_if_index, sw_if_index0);
64 acl_fa_ifc_has_out_acl (acl_main_t * am, int sw_if_index0)
66 int it_has = clib_bitmap_get (am->fa_out_acl_on_sw_if_index, sw_if_index0);
71 fa_session_get_timeout_type (acl_main_t * am, fa_session_t * sess)
73 /* seen both SYNs and ACKs but not FINs means we are in established state */
75 sess->tcp_flags_seen.as_u16 & ((TCP_FLAGS_RSTFINACKSYN << 8) +
76 TCP_FLAGS_RSTFINACKSYN);
77 switch (sess->info.l4.proto)
80 if (((TCP_FLAGS_ACKSYN << 8) + TCP_FLAGS_ACKSYN) == masked_flags)
82 return ACL_TIMEOUT_TCP_IDLE;
86 return ACL_TIMEOUT_TCP_TRANSIENT;
90 return ACL_TIMEOUT_UDP_IDLE;
93 return ACL_TIMEOUT_UDP_IDLE;
98 * Get the idle timeout of a session.
102 fa_session_get_timeout (acl_main_t * am, fa_session_t * sess)
104 u64 timeout = (am->vlib_main->clib_time.clocks_per_second);
105 if (sess->link_list_id == ACL_TIMEOUT_PURGATORY)
107 timeout /= (1000000 / SESSION_PURGATORY_TIMEOUT_USEC);
111 int timeout_type = fa_session_get_timeout_type (am, sess);
112 timeout *= am->session_timeout_sec[timeout_type];
119 always_inline fa_session_t *
120 get_session_ptr (acl_main_t * am, u16 thread_index, u32 session_index)
122 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
123 if (session_index >= vec_len (pw->fa_sessions_pool))
126 return pool_elt_at_index (pw->fa_sessions_pool, session_index);
130 is_valid_session_ptr (acl_main_t * am, u16 thread_index, fa_session_t * sess)
132 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
134 && ((sess - pw->fa_sessions_pool) <
135 pool_len (pw->fa_sessions_pool)));
139 acl_fa_conn_list_add_session (acl_main_t * am, fa_full_session_id_t sess_id,
143 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
145 sess->deleted ? ACL_TIMEOUT_PURGATORY : fa_session_get_timeout_type (am,
147 uword thread_index = os_get_thread_index ();
148 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
149 /* the retrieved session thread index must be necessarily the same as the one in the key */
150 ASSERT (sess->thread_index == sess_id.thread_index);
151 /* the retrieved session thread index must be the same as current thread */
152 ASSERT (sess->thread_index == thread_index);
153 sess->link_enqueue_time = now;
154 sess->link_list_id = list_id;
155 sess->link_next_idx = FA_SESSION_BOGUS_INDEX;
156 sess->link_prev_idx = pw->fa_conn_list_tail[list_id];
157 if (FA_SESSION_BOGUS_INDEX != pw->fa_conn_list_tail[list_id])
159 fa_session_t *prev_sess =
160 get_session_ptr (am, thread_index, pw->fa_conn_list_tail[list_id]);
161 prev_sess->link_next_idx = sess_id.session_index;
162 /* We should never try to link with a session on another thread */
163 ASSERT (prev_sess->thread_index == sess->thread_index);
165 pw->fa_conn_list_tail[list_id] = sess_id.session_index;
167 #ifdef FA_NODE_VERBOSE_DEBUG
169 ("FA-SESSION-DEBUG: add session id %d on thread %d sw_if_index %d",
170 sess_id.session_index, thread_index, sess->sw_if_index);
172 pw->serviced_sw_if_index_bitmap =
173 clib_bitmap_set (pw->serviced_sw_if_index_bitmap, sess->sw_if_index, 1);
175 if (FA_SESSION_BOGUS_INDEX == pw->fa_conn_list_head[list_id])
177 pw->fa_conn_list_head[list_id] = sess_id.session_index;
178 /* set the head expiry time because it is the first element */
179 pw->fa_conn_list_head_expiry_time[list_id] =
180 now + fa_session_get_timeout (am, sess);
185 acl_fa_conn_list_delete_session (acl_main_t * am,
186 fa_full_session_id_t sess_id, u64 now)
188 uword thread_index = os_get_thread_index ();
189 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
190 if (thread_index != sess_id.thread_index)
192 /* If another thread attempts to delete the session, fail it. */
193 #ifdef FA_NODE_VERBOSE_DEBUG
194 clib_warning ("thread id in key %d != curr thread index, not deleting");
199 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
200 u64 next_expiry_time = ~0ULL;
201 /* we should never try to delete the session with another thread index */
202 if (sess->thread_index != os_get_thread_index ())
205 ("Attempting to delete session belonging to thread %d by thread %d",
206 sess->thread_index, thread_index);
208 if (FA_SESSION_BOGUS_INDEX != sess->link_prev_idx)
210 fa_session_t *prev_sess =
211 get_session_ptr (am, thread_index, sess->link_prev_idx);
212 /* the previous session must be in the same list as this one */
213 ASSERT (prev_sess->link_list_id == sess->link_list_id);
214 prev_sess->link_next_idx = sess->link_next_idx;
216 if (FA_SESSION_BOGUS_INDEX != sess->link_next_idx)
218 fa_session_t *next_sess =
219 get_session_ptr (am, thread_index, sess->link_next_idx);
220 /* The next session must be in the same list as the one we are deleting */
221 ASSERT (next_sess->link_list_id == sess->link_list_id);
222 next_sess->link_prev_idx = sess->link_prev_idx;
223 next_expiry_time = now + fa_session_get_timeout (am, next_sess);
225 if (pw->fa_conn_list_head[sess->link_list_id] == sess_id.session_index)
227 pw->fa_conn_list_head[sess->link_list_id] = sess->link_next_idx;
228 pw->fa_conn_list_head_expiry_time[sess->link_list_id] =
231 if (pw->fa_conn_list_tail[sess->link_list_id] == sess_id.session_index)
233 pw->fa_conn_list_tail[sess->link_list_id] = sess->link_prev_idx;
239 acl_fa_restart_timer_for_session (acl_main_t * am, u64 now,
240 fa_full_session_id_t sess_id)
242 if (acl_fa_conn_list_delete_session (am, sess_id, now))
244 acl_fa_conn_list_add_session (am, sess_id, now);
250 * Our thread does not own this connection, so we can not requeue
251 * The session. So we post the signal to the owner.
253 aclp_post_session_change_request (am, sess_id.thread_index,
254 sess_id.session_index,
255 ACL_FA_REQ_SESS_RESCHEDULE);
261 is_ip6_5tuple (fa_5tuple_t * p5t)
263 return (p5t->l3_zero_pad[0] | p5t->
264 l3_zero_pad[1] | p5t->l3_zero_pad[2] | p5t->l3_zero_pad[3] | p5t->
265 l3_zero_pad[4] | p5t->l3_zero_pad[5]) != 0;
272 acl_fa_track_session (acl_main_t * am, int is_input, u32 sw_if_index, u64 now,
273 fa_session_t * sess, fa_5tuple_t * pkt_5tuple)
275 sess->last_active_time = now;
276 if (pkt_5tuple->pkt.tcp_flags_valid)
278 sess->tcp_flags_seen.as_u8[is_input] |= pkt_5tuple->pkt.tcp_flags;
284 reverse_l4_u64_fastpath (u64 l4, int is_ip6)
286 fa_session_l4_key_t l4i = {.as_u64 = l4 };
287 fa_session_l4_key_t l4o;
289 l4o.port[1] = l4i.port[0];
290 l4o.port[0] = l4i.port[1];
292 l4o.non_port_l4_data = l4i.non_port_l4_data;
293 l4o.is_input = 1 - l4i.is_input;
298 reverse_l4_u64_slowpath_valid (u64 l4, int is_ip6, u64 * out)
300 fa_session_l4_key_t l4i = {.as_u64 = l4 };
301 fa_session_l4_key_t l4o;
303 if (l4i.proto == icmp_protos[is_ip6])
305 static const u8 *icmp_invmap[] = { icmp4_invmap, icmp6_invmap };
306 static const u8 *icmp_valid_new[] =
307 { icmp4_valid_new, icmp6_valid_new };
308 static const u8 icmp_invmap_size[] = { sizeof (icmp4_invmap),
309 sizeof (icmp6_invmap)
311 static const u8 icmp_valid_new_size[] = { sizeof (icmp4_valid_new),
312 sizeof (icmp6_valid_new)
314 int type = is_ip6 ? l4i.port[0] - 128 : l4i.port[0];
316 l4o.non_port_l4_data = l4i.non_port_l4_data;
317 l4o.port[0] = l4i.port[0];
318 l4o.port[1] = l4i.port[1];
322 * ONLY ICMP messages defined in icmp4_valid_new/icmp6_valid_new table
323 * are allowed to create stateful ACL.
324 * The other messages will be forwarded without creating a reverse session.
327 int valid_reverse_sess = (type >= 0
328 && (type <= icmp_valid_new_size[is_ip6])
329 && (icmp_valid_new[is_ip6][type])
330 && (type <= icmp_invmap_size[is_ip6])
331 && icmp_invmap[is_ip6][type]);
332 if (valid_reverse_sess)
334 l4o.is_input = 1 - l4i.is_input;
335 l4o.port[0] = icmp_invmap[is_ip6][type] - 1;
339 return valid_reverse_sess;
342 *out = reverse_l4_u64_fastpath (l4, is_ip6);
348 reverse_session_add_del_ip6 (acl_main_t * am,
349 clib_bihash_kv_40_8_t * pkv, int is_add)
351 clib_bihash_kv_40_8_t kv2;
352 kv2.key[0] = pkv->key[2];
353 kv2.key[1] = pkv->key[3];
354 kv2.key[2] = pkv->key[0];
355 kv2.key[3] = pkv->key[1];
356 /* the last u64 needs special treatment (ports, etc.) so we do it last */
357 kv2.value = pkv->value;
358 if (PREDICT_FALSE (((fa_session_l4_key_t) pkv->key[4]).is_slowpath))
360 if (reverse_l4_u64_slowpath_valid (pkv->key[4], 1, &kv2.key[4]))
361 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash, &kv2, is_add);
365 kv2.key[4] = reverse_l4_u64_fastpath (pkv->key[4], 1);
366 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash, &kv2, is_add);
371 reverse_session_add_del_ip4 (acl_main_t * am,
372 clib_bihash_kv_16_8_t * pkv, int is_add)
374 clib_bihash_kv_16_8_t kv2;
376 ((pkv->key[0] & 0xffffffff) << 32) | ((pkv->key[0] >> 32) & 0xffffffff);
377 /* the last u64 needs special treatment (ports, etc.) so we do it last */
378 kv2.value = pkv->value;
379 if (PREDICT_FALSE (((fa_session_l4_key_t) pkv->key[1]).is_slowpath))
381 if (reverse_l4_u64_slowpath_valid (pkv->key[1], 0, &kv2.key[1]))
382 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash, &kv2, is_add);
386 kv2.key[1] = reverse_l4_u64_fastpath (pkv->key[1], 0);
387 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash, &kv2, is_add);
392 acl_fa_deactivate_session (acl_main_t * am, u32 sw_if_index,
393 fa_full_session_id_t sess_id)
396 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
397 ASSERT (sess->thread_index == os_get_thread_index ());
398 void *oldheap = clib_mem_set_heap (am->acl_mheap);
401 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash,
402 &sess->info.kv_40_8, 0);
403 reverse_session_add_del_ip6 (am, &sess->info.kv_40_8, 0);
407 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash,
408 &sess->info.kv_16_8, 0);
409 reverse_session_add_del_ip4 (am, &sess->info.kv_16_8, 0);
413 clib_smp_atomic_add (&am->fa_session_total_deactivations, 1);
414 clib_mem_set_heap (oldheap);
418 acl_fa_put_session (acl_main_t * am, u32 sw_if_index,
419 fa_full_session_id_t sess_id)
421 if (sess_id.thread_index != os_get_thread_index ())
424 ("Attempting to delete session belonging to thread %d by thread %d",
425 sess_id.thread_index, os_get_thread_index ());
427 void *oldheap = clib_mem_set_heap (am->acl_mheap);
428 acl_fa_per_worker_data_t *pw = &am->per_worker_data[sess_id.thread_index];
429 pool_put_index (pw->fa_sessions_pool, sess_id.session_index);
430 /* Deleting from timer structures not needed,
431 as the caller must have dealt with the timers. */
432 vec_validate (pw->fa_session_dels_by_sw_if_index, sw_if_index);
433 clib_mem_set_heap (oldheap);
434 pw->fa_session_dels_by_sw_if_index[sw_if_index]++;
435 clib_smp_atomic_add (&am->fa_session_total_dels, 1);
439 acl_fa_two_stage_delete_session (acl_main_t * am, u32 sw_if_index,
440 fa_full_session_id_t sess_id, u64 now)
443 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
446 acl_fa_put_session (am, sw_if_index, sess_id);
451 acl_fa_deactivate_session (am, sw_if_index, sess_id);
452 acl_fa_conn_list_add_session (am, sess_id, now);
458 acl_fa_can_add_session (acl_main_t * am, int is_input, u32 sw_if_index)
461 curr_sess_count = am->fa_session_total_adds - am->fa_session_total_dels;
462 return (curr_sess_count + vec_len (vlib_mains) <
463 am->fa_conn_table_max_entries);
468 acl_fa_try_recycle_session (acl_main_t * am, int is_input, u16 thread_index,
469 u32 sw_if_index, u64 now)
471 /* try to recycle a TCP transient session */
472 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
473 fa_full_session_id_t volatile sess_id;
476 /* clean up sessions from purgatory, if we can */
477 sess_id.session_index = pw->fa_conn_list_head[ACL_TIMEOUT_PURGATORY];
478 while ((FA_SESSION_BOGUS_INDEX != sess_id.session_index)
479 && n_recycled < am->fa_max_deleted_sessions_per_interval)
481 sess_id.thread_index = thread_index;
483 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
484 if (sess->link_enqueue_time + fa_session_get_timeout (am, sess) < now)
486 acl_fa_conn_list_delete_session (am, sess_id, now);
487 /* interface that needs the sessions may not be the interface of the session. */
488 acl_fa_put_session (am, sess->sw_if_index, sess_id);
492 break; /* too early to try to recycle from here, bail out */
493 sess_id.session_index = pw->fa_conn_list_head[ACL_TIMEOUT_PURGATORY];
495 sess_id.session_index = pw->fa_conn_list_head[ACL_TIMEOUT_TCP_TRANSIENT];
496 if (FA_SESSION_BOGUS_INDEX != sess_id.session_index)
498 sess_id.thread_index = thread_index;
499 acl_fa_conn_list_delete_session (am, sess_id, now);
500 acl_fa_deactivate_session (am, sw_if_index, sess_id);
501 /* this goes to purgatory list */
502 acl_fa_conn_list_add_session (am, sess_id, now);
507 always_inline fa_session_t *
508 acl_fa_add_session (acl_main_t * am, int is_input, int is_ip6,
509 u32 sw_if_index, u64 now, fa_5tuple_t * p5tuple,
510 u16 current_policy_epoch)
512 fa_full_session_id_t f_sess_id;
513 uword thread_index = os_get_thread_index ();
514 void *oldheap = clib_mem_set_heap (am->acl_mheap);
515 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
517 f_sess_id.thread_index = thread_index;
520 if (f_sess_id.as_u64 == ~0)
522 clib_error ("Adding session with invalid value");
525 pool_get_aligned (pw->fa_sessions_pool, sess, CLIB_CACHE_LINE_BYTES);
526 f_sess_id.session_index = sess - pw->fa_sessions_pool;
527 f_sess_id.intf_policy_epoch = current_policy_epoch;
531 sess->info.kv_40_8.key[0] = p5tuple->kv_40_8.key[0];
532 sess->info.kv_40_8.key[1] = p5tuple->kv_40_8.key[1];
533 sess->info.kv_40_8.key[2] = p5tuple->kv_40_8.key[2];
534 sess->info.kv_40_8.key[3] = p5tuple->kv_40_8.key[3];
535 sess->info.kv_40_8.key[4] = p5tuple->kv_40_8.key[4];
536 sess->info.kv_40_8.value = f_sess_id.as_u64;
540 sess->info.kv_16_8.key[0] = p5tuple->kv_16_8.key[0];
541 sess->info.kv_16_8.key[1] = p5tuple->kv_16_8.key[1];
542 sess->info.kv_16_8.value = f_sess_id.as_u64;
545 sess->last_active_time = now;
546 sess->sw_if_index = sw_if_index;
547 sess->tcp_flags_seen.as_u16 = 0;
548 sess->thread_index = thread_index;
549 sess->link_list_id = ACL_TIMEOUT_UNUSED;
550 sess->link_prev_idx = FA_SESSION_BOGUS_INDEX;
551 sess->link_next_idx = FA_SESSION_BOGUS_INDEX;
553 sess->is_ip6 = is_ip6;
555 acl_fa_conn_list_add_session (am, f_sess_id, now);
557 ASSERT (am->fa_sessions_hash_is_initialized == 1);
560 reverse_session_add_del_ip6 (am, &sess->info.kv_40_8, 1);
561 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash,
562 &sess->info.kv_40_8, 1);
566 reverse_session_add_del_ip4 (am, &sess->info.kv_16_8, 1);
567 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash,
568 &sess->info.kv_16_8, 1);
571 vec_validate (pw->fa_session_adds_by_sw_if_index, sw_if_index);
572 clib_mem_set_heap (oldheap);
573 pw->fa_session_adds_by_sw_if_index[sw_if_index]++;
574 clib_smp_atomic_add (&am->fa_session_total_adds, 1);
579 acl_fa_find_session (acl_main_t * am, int is_ip6, u32 sw_if_index0,
580 fa_5tuple_t * p5tuple, u64 * pvalue_sess)
585 clib_bihash_kv_40_8_t kv_result;
586 res = (clib_bihash_search_inline_2_40_8
587 (&am->fa_ip6_sessions_hash, &p5tuple->kv_40_8, &kv_result) == 0);
588 *pvalue_sess = kv_result.value;
592 clib_bihash_kv_16_8_t kv_result;
593 res = (clib_bihash_search_inline_2_16_8
594 (&am->fa_ip4_sessions_hash, &p5tuple->kv_16_8, &kv_result) == 0);
595 *pvalue_sess = kv_result.value;
601 * fd.io coding-style-patch-verification: ON
604 * eval: (c-set-style "gnu")