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_reply] = ICMP4_echo_request + 1,
20 [ICMP4_timestamp_reply] = ICMP4_timestamp_request + 1,
21 [ICMP4_information_reply] = ICMP4_information_request + 1,
22 [ICMP4_address_mask_reply] = ICMP4_address_mask_request + 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_reply - 128] = ICMP6_echo_request + 1,
36 [ICMP6_node_information_response - 128] = ICMP6_node_information_request + 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 delete
251 * The session. To avoid the complicated signaling, we simply
252 * pick the list waiting time to be the shortest of the timeouts.
253 * This way we do not have to do anything special, and let
254 * the regular requeue check take care of everything.
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 (u64 l4, int is_ip6)
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 if (type >= 0 && (type <= icmp_valid_new_size[is_ip6])
328 && (icmp_valid_new[is_ip6][type])
329 && (type <= icmp_invmap_size[is_ip6]) && icmp_invmap[is_ip6][type])
332 * we set the inverse direction and correct the port,
333 * if it is okay to add the reverse session.
334 * If not, then the same session will be added twice
335 * to bihash, which is the same as adding just one session.
337 l4o.is_input = 1 - l4i.is_input;
338 l4o.port[0] = icmp_invmap[is_ip6][type] - 1;
344 return reverse_l4_u64_fastpath (l4, is_ip6);
348 reverse_l4_u64 (u64 l4, int is_ip6)
350 fa_session_l4_key_t l4i = {.as_u64 = l4 };
352 if (PREDICT_FALSE (l4i.is_slowpath))
354 return reverse_l4_u64_slowpath (l4, is_ip6);
358 return reverse_l4_u64_fastpath (l4, is_ip6);
363 reverse_session_add_del_ip6 (acl_main_t * am,
364 clib_bihash_kv_40_8_t * pkv, int is_add)
366 clib_bihash_kv_40_8_t kv2;
367 kv2.key[0] = pkv->key[2];
368 kv2.key[1] = pkv->key[3];
369 kv2.key[2] = pkv->key[0];
370 kv2.key[3] = pkv->key[1];
371 /* the last u64 needs special treatment (ports, etc.) */
372 kv2.key[4] = reverse_l4_u64 (pkv->key[4], 1);
373 kv2.value = pkv->value;
374 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash, &kv2, is_add);
378 reverse_session_add_del_ip4 (acl_main_t * am,
379 clib_bihash_kv_16_8_t * pkv, int is_add)
381 clib_bihash_kv_16_8_t kv2;
383 ((pkv->key[0] & 0xffffffff) << 32) | ((pkv->key[0] >> 32) & 0xffffffff);
384 /* the last u64 needs special treatment (ports, etc.) */
385 kv2.key[1] = reverse_l4_u64 (pkv->key[1], 0);
386 kv2.value = pkv->value;
387 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash, &kv2, is_add);
391 acl_fa_deactivate_session (acl_main_t * am, u32 sw_if_index,
392 fa_full_session_id_t sess_id)
395 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
396 ASSERT (sess->thread_index == os_get_thread_index ());
397 void *oldheap = clib_mem_set_heap (am->acl_mheap);
400 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash,
401 &sess->info.kv_40_8, 0);
402 reverse_session_add_del_ip6 (am, &sess->info.kv_40_8, 0);
406 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash,
407 &sess->info.kv_16_8, 0);
408 reverse_session_add_del_ip4 (am, &sess->info.kv_16_8, 0);
412 clib_smp_atomic_add (&am->fa_session_total_deactivations, 1);
413 clib_mem_set_heap (oldheap);
417 acl_fa_put_session (acl_main_t * am, u32 sw_if_index,
418 fa_full_session_id_t sess_id)
420 if (sess_id.thread_index != os_get_thread_index ())
423 ("Attempting to delete session belonging to thread %d by thread %d",
424 sess_id.thread_index, os_get_thread_index ());
426 void *oldheap = clib_mem_set_heap (am->acl_mheap);
427 acl_fa_per_worker_data_t *pw = &am->per_worker_data[sess_id.thread_index];
428 pool_put_index (pw->fa_sessions_pool, sess_id.session_index);
429 /* Deleting from timer structures not needed,
430 as the caller must have dealt with the timers. */
431 vec_validate (pw->fa_session_dels_by_sw_if_index, sw_if_index);
432 clib_mem_set_heap (oldheap);
433 pw->fa_session_dels_by_sw_if_index[sw_if_index]++;
434 clib_smp_atomic_add (&am->fa_session_total_dels, 1);
438 acl_fa_two_stage_delete_session (acl_main_t * am, u32 sw_if_index,
439 fa_full_session_id_t sess_id, u64 now)
442 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
445 acl_fa_put_session (am, sw_if_index, sess_id);
450 acl_fa_deactivate_session (am, sw_if_index, sess_id);
451 acl_fa_conn_list_add_session (am, sess_id, now);
457 acl_fa_can_add_session (acl_main_t * am, int is_input, u32 sw_if_index)
460 curr_sess_count = am->fa_session_total_adds - am->fa_session_total_dels;
461 return (curr_sess_count + vec_len (vlib_mains) <
462 am->fa_conn_table_max_entries);
467 acl_fa_try_recycle_session (acl_main_t * am, int is_input, u16 thread_index,
468 u32 sw_if_index, u64 now)
470 /* try to recycle a TCP transient session */
471 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
472 fa_full_session_id_t volatile sess_id;
475 /* clean up sessions from purgatory, if we can */
476 sess_id.session_index = pw->fa_conn_list_head[ACL_TIMEOUT_PURGATORY];
477 while ((FA_SESSION_BOGUS_INDEX != sess_id.session_index)
478 && n_recycled < am->fa_max_deleted_sessions_per_interval)
480 sess_id.thread_index = thread_index;
482 get_session_ptr (am, sess_id.thread_index, sess_id.session_index);
483 if (sess->link_enqueue_time + fa_session_get_timeout (am, sess) < now)
485 acl_fa_conn_list_delete_session (am, sess_id, now);
486 /* interface that needs the sessions may not be the interface of the session. */
487 acl_fa_put_session (am, sess->sw_if_index, sess_id);
491 break; /* too early to try to recycle from here, bail out */
492 sess_id.session_index = pw->fa_conn_list_head[ACL_TIMEOUT_PURGATORY];
494 sess_id.session_index = pw->fa_conn_list_head[ACL_TIMEOUT_TCP_TRANSIENT];
495 if (FA_SESSION_BOGUS_INDEX != sess_id.session_index)
497 sess_id.thread_index = thread_index;
498 acl_fa_conn_list_delete_session (am, sess_id, now);
499 acl_fa_deactivate_session (am, sw_if_index, sess_id);
500 /* this goes to purgatory list */
501 acl_fa_conn_list_add_session (am, sess_id, now);
506 always_inline fa_session_t *
507 acl_fa_add_session (acl_main_t * am, int is_input, int is_ip6,
508 u32 sw_if_index, u64 now, fa_5tuple_t * p5tuple,
509 u16 current_policy_epoch)
511 fa_full_session_id_t f_sess_id;
512 uword thread_index = os_get_thread_index ();
513 void *oldheap = clib_mem_set_heap (am->acl_mheap);
514 acl_fa_per_worker_data_t *pw = &am->per_worker_data[thread_index];
516 f_sess_id.thread_index = thread_index;
519 if (f_sess_id.as_u64 == ~0)
521 clib_error ("Adding session with invalid value");
524 pool_get_aligned (pw->fa_sessions_pool, sess, CLIB_CACHE_LINE_BYTES);
525 f_sess_id.session_index = sess - pw->fa_sessions_pool;
526 f_sess_id.intf_policy_epoch = current_policy_epoch;
530 sess->info.kv_40_8.key[0] = p5tuple->kv_40_8.key[0];
531 sess->info.kv_40_8.key[1] = p5tuple->kv_40_8.key[1];
532 sess->info.kv_40_8.key[2] = p5tuple->kv_40_8.key[2];
533 sess->info.kv_40_8.key[3] = p5tuple->kv_40_8.key[3];
534 sess->info.kv_40_8.key[4] = p5tuple->kv_40_8.key[4];
535 sess->info.kv_40_8.value = f_sess_id.as_u64;
539 sess->info.kv_16_8.key[0] = p5tuple->kv_16_8.key[0];
540 sess->info.kv_16_8.key[1] = p5tuple->kv_16_8.key[1];
541 sess->info.kv_16_8.value = f_sess_id.as_u64;
544 sess->last_active_time = now;
545 sess->sw_if_index = sw_if_index;
546 sess->tcp_flags_seen.as_u16 = 0;
547 sess->thread_index = thread_index;
548 sess->link_list_id = ACL_TIMEOUT_UNUSED;
549 sess->link_prev_idx = FA_SESSION_BOGUS_INDEX;
550 sess->link_next_idx = FA_SESSION_BOGUS_INDEX;
552 sess->is_ip6 = is_ip6;
554 acl_fa_conn_list_add_session (am, f_sess_id, now);
556 ASSERT (am->fa_sessions_hash_is_initialized == 1);
559 reverse_session_add_del_ip6 (am, &sess->info.kv_40_8, 1);
560 clib_bihash_add_del_40_8 (&am->fa_ip6_sessions_hash,
561 &sess->info.kv_40_8, 1);
565 reverse_session_add_del_ip4 (am, &sess->info.kv_16_8, 1);
566 clib_bihash_add_del_16_8 (&am->fa_ip4_sessions_hash,
567 &sess->info.kv_16_8, 1);
570 vec_validate (pw->fa_session_adds_by_sw_if_index, sw_if_index);
571 clib_mem_set_heap (oldheap);
572 pw->fa_session_adds_by_sw_if_index[sw_if_index]++;
573 clib_smp_atomic_add (&am->fa_session_total_adds, 1);
578 acl_fa_find_session (acl_main_t * am, int is_ip6, u32 sw_if_index0,
579 fa_5tuple_t * p5tuple, u64 * pvalue_sess)
584 clib_bihash_kv_40_8_t kv_result;
585 res = (clib_bihash_search_inline_2_40_8
586 (&am->fa_ip6_sessions_hash, &p5tuple->kv_40_8, &kv_result) == 0);
587 *pvalue_sess = kv_result.value;
591 clib_bihash_kv_16_8_t kv_result;
592 res = (clib_bihash_search_inline_2_16_8
593 (&am->fa_ip4_sessions_hash, &p5tuple->kv_16_8, &kv_result) == 0);
594 *pvalue_sess = kv_result.value;
600 * fd.io coding-style-patch-verification: ON
603 * eval: (c-set-style "gnu")