stellar-stellar/src/session/session_manager.cpp

#include <stdlib.h>
#include <assert.h>

#include "stellar.h"
#include "tcp_utils.h"
#include "udp_utils.h"
#include "id_generator.h"
#include "session_pool.h"
#include "session_table.h"
#include "session_timer.h"
#include "session_queue.h"
#include "session_manager.h"
#include "session_private.h"
#include "session_transition.h"
#include "evicted_session_filter.h"
#include "duplicated_packet_filter.h"

struct session_manager
{
     struct session_pool *sess_pool;
     struct session_table *tcp_sess_table;
     struct session_table *udp_sess_table;
     struct session_timer *sess_timer;
     struct session_queue *sess_evicte_queue;

     struct duplicated_packet_filter *dup_pkt_filter;
     struct evicted_session_filter *evicte_sess_filter;

     struct session_manager_options opts;
     struct session_manager_stat stat;
};

#define EVICTE_SESSION_BURST (RX_BURST_MAX)

struct tcp_reassembly_options tcp_reassembly_opts = {0};

/******************************************************************************
 * Options
 ******************************************************************************/

static int check_options(struct session_manager_options *opts)
{
     if (opts == NULL)
     {
          SESSION_LOG_ERROR("invalid options");
          return -1;
     }
     // max session number
     if (opts->max_tcp_session_num < EVICTE_SESSION_BURST * 2)
     {
          SESSION_LOG_ERROR("invalid max tcp session number, must be greater than %d", EVICTE_SESSION_BURST * 2);
          return -1;
     }
     if (opts->max_udp_session_num < EVICTE_SESSION_BURST * 2)
     {
          SESSION_LOG_ERROR("invalid max udp session number, must be greater than %d", EVICTE_SESSION_BURST * 2);
          return -1;
     }
     // session overload
     if (opts->tcp_overload_evict_old_sess != 0 && opts->tcp_overload_evict_old_sess != 1)
     {
          SESSION_LOG_ERROR("invalid tcp overload evict old session, support range: 0-1");
          return -1;
     }
     if (opts->udp_overload_evict_old_sess != 0 && opts->udp_overload_evict_old_sess != 1)
     {
          SESSION_LOG_ERROR("invalid udp overload evict old session, support range: 0-1");
          return -1;
     }
     // TCP timeout opts
     if (opts->tcp_timeout_init < 1 || opts->tcp_timeout_init > 60000)
     {
          SESSION_LOG_ERROR("invalid tcp timeout init, support range: 1-60,000");
          return -1;
     }
     if (opts->tcp_timeout_handshake < 1 || opts->tcp_timeout_handshake > 60000)
     {
          SESSION_LOG_ERROR("invalid tcp timeout handshake, support range: 1-60,000");
          return -1;
     }
     if (opts->tcp_timeout_data < 1 || opts->tcp_timeout_data > 15999999000)
     {
          SESSION_LOG_ERROR("invalid tcp timeout data, support range: 1-15,999,999,000");
          return -1;
     }
     if (opts->tcp_timeout_half_closed < 1 || opts->tcp_timeout_half_closed > 604800000)
     {
          SESSION_LOG_ERROR("invalid tcp timeout half closed, support range: 1-604,800,000");
          return -1;
     }
     if (opts->tcp_timeout_time_wait < 1 || opts->tcp_timeout_time_wait > 600000)
     {
          SESSION_LOG_ERROR("invalid tcp timeout time wait, support range: 1-600,000");
          return -1;
     }
     if (opts->tcp_timeout_discard < 1 || opts->tcp_timeout_discard > 15999999000)
     {
          SESSION_LOG_ERROR("invalid tcp timeout discard, support range: 1-15,999,999,000");
          return -1;
     }
     // UDP timeout opts
     if (opts->udp_timeout_data < 1 || opts->udp_timeout_data > 15999999000)
     {
          SESSION_LOG_ERROR("invalid udp timeout data, support range: 1-15,999,999,000");
          return -1;
     }
     // duplicate packet filter opts
     if (opts->duplicated_packet_filter_enable != 0 && opts->duplicated_packet_filter_enable != 1)
     {
          SESSION_LOG_ERROR("invalid duplicate packet filter enable, support range: 0-1");
          return -1;
     }
     if (opts->duplicated_packet_filter_enable)
     {
          if (opts->duplicated_packet_filter_capacity == 0)
          {
               SESSION_LOG_ERROR("invalid duplicate packet filter capacity");
               return -1;
          }
          if (opts->duplicated_packet_filter_timeout < 1 || opts->duplicated_packet_filter_timeout > 60000)
          {
               SESSION_LOG_ERROR("invalid duplicate packet filter timeout, support range: 1-60,000");
               return -1;
          }
          if (opts->duplicated_packet_filter_error_rate < 0 || opts->duplicated_packet_filter_error_rate > 1)
          {
               SESSION_LOG_ERROR("invalid duplicate packet filter error rate, support range: 0-1");
               return -1;
          }
     }
     // eviction filter opts
     if (opts->evicted_session_filter_enable != 0 && opts->evicted_session_filter_enable != 1)
     {
          SESSION_LOG_ERROR("invalid eviction filter enable, support range: 0-1");
          return -1;
     }
     if (opts->evicted_session_filter_enable)
     {
          if (opts->evicted_session_filter_capacity == 0)
          {
               SESSION_LOG_ERROR("invalid eviction filter capacity");
               return -1;
          }
          if (opts->evicted_session_filter_timeout < 1 || opts->evicted_session_filter_timeout > 60000)
          {
               SESSION_LOG_ERROR("invalid eviction filter timeout, support range: 1-60,000");
               return -1;
          }
          if (opts->evicted_session_filter_error_rate < 0 || opts->evicted_session_filter_error_rate > 1)
          {
               SESSION_LOG_ERROR("invalid eviction filter error rate, support range: 0-1");
               return -1;
          }
     }
     // TCP reassembly opts
     if (opts->tcp_reassembly_enable != 0 && opts->tcp_reassembly_enable != 1)
     {
          SESSION_LOG_ERROR("invalid tcp reassembly enable, support range: 0-1");
          return -1;
     }
     if (opts->tcp_reassembly_enable)
     {
          if (opts->tcp_reassembly_max_timeout < 1 || opts->tcp_reassembly_max_timeout > 60000)
          {
               SESSION_LOG_ERROR("invalid tcp reassembly max timeout, support range: 1-60,000");
               return -1;
          }
     }

     return 0;
}

/******************************************************************************
 * Stat
 ******************************************************************************/

static void session_stat_inc(struct session_stat *stat, enum session_state state)
{
     switch (state)
     {
     case SESSION_STATE_INIT:
          stat->nr_sess_init++;
          break;
     case SESSION_STATE_OPENING:
          stat->nr_sess_opening++;
          break;
     case SESSION_STATE_ACTIVE:
          stat->nr_sess_active++;
          break;
     case SESSION_STATE_CLOSING:
          stat->nr_sess_closing++;
          break;
     case SESSION_STATE_DISCARD:
          stat->nr_sess_discard++;
          break;
     case SESSION_STATE_CLOSED:
          stat->nr_sess_closed++;
          break;
     default:
          break;
     }
}

static void session_stat_dec(struct session_stat *stat, enum session_state state)
{
     switch (state)
     {
     case SESSION_STATE_INIT:
          stat->nr_sess_init--;
          break;
     case SESSION_STATE_OPENING:
          stat->nr_sess_opening--;
          break;
     case SESSION_STATE_ACTIVE:
          stat->nr_sess_active--;
          break;
     case SESSION_STATE_CLOSING:
          stat->nr_sess_closing--;
          break;
     case SESSION_STATE_DISCARD:
          stat->nr_sess_discard--;
          break;
     case SESSION_STATE_CLOSED:
          stat->nr_sess_closed--;
          break;
     default:
          break;
     }
}

static void session_stat_update(struct session_manager *mgr, struct session *sess, enum session_state curr_state, enum session_state next_state)
{
     switch (session_get_type(sess))
     {
     case SESSION_TYPE_TCP:
          session_stat_dec(&mgr->stat.tcp_sess, curr_state);
          session_stat_inc(&mgr->stat.tcp_sess, next_state);
          break;
     case SESSION_TYPE_UDP:
          session_stat_dec(&mgr->stat.udp_sess, curr_state);
          session_stat_inc(&mgr->stat.udp_sess, next_state);
          break;
     default:
          break;
     }
}

/******************************************************************************
 * Session Direction
 ******************************************************************************/

static enum session_dir identify_direction_by_port(uint16_t src_port, uint16_t dst_port)
{
     // big port is client
     if (src_port > dst_port)
     {
          return SESSION_DIR_C2S;
     }
     else if (src_port < dst_port)
     {
          return SESSION_DIR_S2C;
     }
     else
     {
          // if port is equal, first packet is C2S
          return SESSION_DIR_C2S;
     }
}

static enum session_dir identify_direction_by_history(const struct session *sess, const struct tuple6 *key)
{
     if (tuple6_cmp(session_get0_key(sess), key) == 0)
     {
          return session_get_key_dir(sess);
     }
     else
     {
          return (session_get_key_dir(sess) == SESSION_DIR_C2S ? SESSION_DIR_S2C : SESSION_DIR_C2S);
     }
}

/******************************************************************************
 * Session Filter
 ******************************************************************************/

#define MAX_FILTER_NUM_PER_STAGE 4
enum filter_stage
{
     FILTER_STAGE_PRE_NEW_SESS,
     FILTER_STAGE_PRE_UPDATE_SESS,
     MAX_FILTER_STAGE,
};

// return 1: bypass
// return 0: not bypass
typedef int filter(struct session_manager *mgr, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now);

// on pre new session
static int session_manager_self_protection(struct session_manager *mgr, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     struct session_manager_options *opts = &mgr->opts;
     struct session_manager_stat *stat = &mgr->stat;
     switch (key->ip_proto)
     {
     case IPPROTO_TCP:
          if (stat->tcp_sess.nr_sess_used >= opts->max_tcp_session_num)
          {
               stat->evc_pkt.nr_pkts++;
               stat->evc_pkt.nr_bytes += packet_get_len(pkt);
               stat->tcp_sess.nr_new_sess_evicted++;
               return 1;
          }
          break;
     case IPPROTO_UDP:
          if (stat->udp_sess.nr_sess_used >= opts->max_udp_session_num)
          {
               stat->evc_pkt.nr_pkts++;
               stat->evc_pkt.nr_bytes += packet_get_len(pkt);
               stat->udp_sess.nr_new_sess_evicted++;
               return 1;
          }
          break;
     default:
          break;
     }

     return 0;
}

// on pre new session
static int session_manager_filter_evicted_session(struct session_manager *mgr, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     if (evicted_session_filter_lookup(mgr->evicte_sess_filter, key, now))
     {
          mgr->stat.evc_pkt.nr_pkts++;
          mgr->stat.evc_pkt.nr_bytes += packet_get_len(pkt);
          return 1;
     }

     return 0;
}

// on pre update session
static int session_manager_filter_duplicated_packet(struct session_manager *mgr, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     enum session_dir dir = identify_direction_by_history(sess, key);
     if ((dir == SESSION_DIR_C2S && session_get_c2s_packets(sess) < 3) ||
         (dir == SESSION_DIR_S2C && session_get_s2c_packets(sess) < 3) ||
         (session_get_dup_traffic_flag(sess) == DUP_TRAFFIC_YES))
     {
          if (duplicated_packet_filter_lookup(mgr->dup_pkt_filter, pkt, now))
          {
               mgr->stat.dup_pkt.nr_pkts++;
               mgr->stat.dup_pkt.nr_bytes += packet_get_len(pkt);
               session_set_dup_traffic_flag(sess, DUP_TRAFFIC_YES);
               return 1;
          }
          else
          {
               duplicated_packet_filter_add(mgr->dup_pkt_filter, pkt, now);
               return 0;
          }
     }

     return 0;
}

filter *smf[MAX_FILTER_STAGE][MAX_FILTER_NUM_PER_STAGE];

static void session_filter_init()
{
     for (int i = 0; i < MAX_FILTER_STAGE; i++)
     {
          for (int j = 0; j < MAX_FILTER_NUM_PER_STAGE; j++)
          {
               smf[i][j] = NULL;
          }
     }

     smf[FILTER_STAGE_PRE_NEW_SESS][0] = session_manager_self_protection;
     smf[FILTER_STAGE_PRE_NEW_SESS][1] = session_manager_filter_evicted_session;
     smf[FILTER_STAGE_PRE_NEW_SESS][2] = NULL;

     smf[FILTER_STAGE_PRE_UPDATE_SESS][0] = session_manager_filter_duplicated_packet;
     smf[FILTER_STAGE_PRE_UPDATE_SESS][1] = NULL;
}

// return 1: bypass packet
// return 0: not bypass packet
static int session_filter_run(struct session_manager *mgr, enum filter_stage stage, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     filter **list = smf[stage];
     for (int i = 0; i < MAX_FILTER_NUM_PER_STAGE; i++)
     {
          if (list[i])
          {
               if (list[i](mgr, sess, pkt, key, now))
               {
                    return 1;
               }
          }
          else
          {
               break;
          }
     }

     return 0;
}

/******************************************************************************
 * Session Manager
 ******************************************************************************/

static void timer_update(struct session_timer *timer, struct session *sess, uint64_t abs_timeout)
{
     session_timer_del(timer, sess);
     session_set_expirecb(sess, NULL, NULL, abs_timeout);
     session_timer_add(timer, sess);
}

static void session_update(struct session *sess, enum session_state next_state, const struct packet *pkt, const struct tuple6 *key, enum session_dir dir, uint64_t now)
{
     if (session_get_state(sess) == SESSION_STATE_INIT)
     {
          session_set_key(sess, key);
          session_set_key_dir(sess, dir);
          session_set_new_time(sess, now);
          switch (key->ip_proto)
          {
          case IPPROTO_TCP:
               session_set_type(sess, SESSION_TYPE_TCP);
               break;
          case IPPROTO_UDP:
               session_set_type(sess, SESSION_TYPE_UDP);
               break;
          default:
               assert(0);
               break;
          }
     }

     if (dir == SESSION_DIR_C2S)
     {
          session_inc_c2s_metrics(sess, 1, packet_get_len(pkt));
          session_set_c2s_1st_pkt(sess, pkt);
     }
     else
     {
          session_inc_s2c_metrics(sess, 1, packet_get_len(pkt));
          session_set_s2c_1st_pkt(sess, pkt);
     }
     session_set0_cur_pkt(sess, pkt);
     session_set_cur_dir(sess, dir);
     session_set_last_time(sess, now);
     session_set_state(sess, next_state);
}

static void session_manager_evicte_session(struct session_manager *mgr, struct session *sess, uint64_t now)
{
     if (sess == NULL)
     {
          return;
     }

     // when session add to evicted queue, session lifetime is over
     enum session_state curr_state = session_get_state(sess);
     enum session_state next_state = session_transition_run(curr_state, LRU_EVICT);
     session_transition_log(sess, curr_state, next_state, LRU_EVICT);
     session_set_state(sess, next_state);
     session_stat_update(mgr, sess, curr_state, next_state);

     session_timer_del(mgr->sess_timer, sess);
     session_set_closing_reason(sess, CLOSING_BY_EVICTED);
     session_queue_push(mgr->sess_evicte_queue, sess);

     switch (session_get_type(sess))
     {
     case SESSION_TYPE_TCP:
          SESSION_LOG_DEBUG("evicte tcp old session: %lu", session_get_id(sess));
          mgr->stat.tcp_sess.nr_old_sess_evicted++;
          session_table_del(mgr->tcp_sess_table, session_get0_key(sess));
          break;
     case SESSION_TYPE_UDP:
          SESSION_LOG_DEBUG("evicte udp old session: %lu", session_get_id(sess));
          mgr->stat.udp_sess.nr_old_sess_evicted++;
          session_table_del(mgr->udp_sess_table, session_get0_key(sess));
          evicted_session_filter_add(mgr->evicte_sess_filter, session_get0_key(sess), now);
          break;
     default:
          assert(0);
          break;
     }
}

static struct session *session_manager_new_tcp_session(struct session_manager *mgr, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     struct session_manager_options *opts = &mgr->opts;
     const struct layer *tcp_layer = packet_get_innermost_layer(pkt, LAYER_TYPE_TCP);
     const struct tcphdr *hdr = (const struct tcphdr *)tcp_layer->hdr_ptr;
     if (!tcp_hdr_get_syn_flag(hdr))
     {
          return NULL;
     }

     // tcp table full evict old session
     if (opts->tcp_overload_evict_old_sess && mgr->stat.tcp_sess.nr_sess_used >= opts->max_tcp_session_num - EVICTE_SESSION_BURST)
     {
          struct session *evic_sess = session_table_find_lru(mgr->tcp_sess_table);
          session_manager_evicte_session(mgr, evic_sess, now);
     }

     struct session *sess = session_pool_pop(mgr->sess_pool);
     if (sess == NULL)
     {
          assert(0);
          return NULL;
     }
     session_init(sess);
     session_set_id(sess, id_generator_alloc());
     sess->c2s_reassembly = tcp_reassembly_new(&tcp_reassembly_opts);
     sess->s2c_reassembly = tcp_reassembly_new(&tcp_reassembly_opts);
     if (sess->c2s_reassembly == NULL || sess->s2c_reassembly == NULL)
     {
          assert(0);
          session_pool_push(mgr->sess_pool, sess);
          return NULL;
     }
     mgr->stat.tcp_sess.nr_sess_used++;
     SESSION_LOG_DEBUG("session %lu, c2s reassembler %p, s2c reassembler %p", session_get_id(sess), sess->c2s_reassembly, sess->s2c_reassembly);

     enum session_dir dir = tcp_hdr_get_ack_flag(hdr) ? SESSION_DIR_S2C : SESSION_DIR_C2S;
     enum session_state next_state = session_transition_run(SESSION_STATE_INIT, TCP_SYN);
     session_update(sess, next_state, pkt, key, dir, now);
     session_transition_log(sess, SESSION_STATE_INIT, next_state, TCP_SYN);
     session_stat_inc(&mgr->stat.tcp_sess, next_state);

     tcp_reassembly_init(dir == SESSION_DIR_C2S ? sess->c2s_reassembly : sess->s2c_reassembly, tcp_hdr_get_seq(hdr));
     if (tcp_layer->pld_len)
     {
          tcp_reassembly_insert(dir == SESSION_DIR_C2S ? sess->c2s_reassembly : sess->s2c_reassembly,
                                tcp_hdr_get_seq(hdr), tcp_layer->pld_ptr, tcp_layer->pld_len, now);
     }

     uint64_t timeout = tcp_hdr_get_ack_flag(hdr) ? opts->tcp_timeout_handshake : opts->tcp_timeout_init;
     timer_update(mgr->sess_timer, sess, now + timeout);
     session_table_add(mgr->tcp_sess_table, key, sess);

     duplicated_packet_filter_add(mgr->dup_pkt_filter, pkt, now);

     return sess;
}

static struct session *session_manager_new_udp_session(struct session_manager *mgr, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     struct session_manager_options *opts = &mgr->opts;

     // udp table full evict old session
     if (opts->udp_overload_evict_old_sess && mgr->stat.udp_sess.nr_sess_used >= opts->max_udp_session_num - EVICTE_SESSION_BURST)
     {
          struct session *evic_sess = session_table_find_lru(mgr->udp_sess_table);
          session_manager_evicte_session(mgr, evic_sess, now);
     }

     struct session *sess = session_pool_pop(mgr->sess_pool);
     if (sess == NULL)
     {
          assert(sess);
          return NULL;
     }
     mgr->stat.udp_sess.nr_sess_used++;
     session_init(sess);
     session_set_id(sess, id_generator_alloc());

     enum session_dir dir = identify_direction_by_port(ntohs(key->src_port), ntohs(key->dst_port));
     enum session_state next_state = session_transition_run(SESSION_STATE_INIT, UDP_DATA);
     session_update(sess, next_state, pkt, key, dir, now);
     session_transition_log(sess, SESSION_STATE_INIT, next_state, UDP_DATA);
     session_stat_inc(&mgr->stat.udp_sess, next_state);

     timer_update(mgr->sess_timer, sess, now + opts->udp_timeout_data);
     session_table_add(mgr->udp_sess_table, key, sess);

     return sess;
}

static int session_manager_update_tcp_session(struct session_manager *mgr, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     struct session_manager_options *opts = &mgr->opts;
     const struct layer *tcp_layer = packet_get_innermost_layer(pkt, LAYER_TYPE_TCP);
     const struct tcphdr *hdr = (const struct tcphdr *)tcp_layer->hdr_ptr;
     enum session_dir dir = identify_direction_by_history(sess, key);
     int inputs = tcp_hdr_get_syn_flag(hdr) ? TCP_SYN : NONE;
     inputs |= tcp_hdr_get_fin_flag(hdr) ? TCP_FIN : NONE;
     inputs |= tcp_hdr_get_rst_flag(hdr) ? TCP_RST : NONE;
     inputs |= tcp_layer->pld_len ? TCP_DATA : NONE;
     enum session_state curr_state = session_get_state(sess);
     enum session_state next_state = session_transition_run(curr_state, inputs);
     session_update(sess, next_state, pkt, key, dir, now);
     session_transition_log(sess, curr_state, next_state, inputs);
     session_stat_update(mgr, sess, curr_state, next_state);

     if (tcp_hdr_get_syn_flag(hdr))
     {
          tcp_reassembly_init(dir == SESSION_DIR_C2S ? sess->c2s_reassembly : sess->s2c_reassembly, tcp_hdr_get_seq(hdr));
     }
     tcp_reassembly_expire(sess->c2s_reassembly, now);
     tcp_reassembly_expire(sess->s2c_reassembly, now);
     if (tcp_layer->pld_len)
     {
          tcp_reassembly_insert(dir == SESSION_DIR_C2S ? sess->c2s_reassembly : sess->s2c_reassembly,
                                tcp_hdr_get_seq(hdr), tcp_layer->pld_ptr, tcp_layer->pld_len, now);
     }

     // select next timeout
     uint64_t timeout = 0;
     switch (next_state)
     {
     case SESSION_STATE_OPENING:
          if (tcp_hdr_get_syn_flag(hdr))
          {
               timeout = tcp_hdr_get_ack_flag(hdr) ? opts->tcp_timeout_handshake : opts->tcp_timeout_init;
          }
          else
          {
               timeout = opts->tcp_timeout_data;
          }
          break;
     case SESSION_STATE_ACTIVE:
          timeout = opts->tcp_timeout_data;
          break;
     case SESSION_STATE_CLOSING:
          timeout = opts->tcp_timeout_time_wait;
          break;
     default:
          assert(0);
          break;
     }
     timer_update(mgr->sess_timer, sess, now + timeout);

     // set closing reason
     if (next_state == SESSION_STATE_CLOSING && !session_get_closing_reason(sess))
     {
          if (tcp_hdr_get_fin_flag(hdr))
          {
               session_set_closing_reason(sess, (dir == SESSION_DIR_C2S ? CLOSING_BY_CLIENT_FIN : CLOSING_BY_SERVER_FIN));
          }
          if (tcp_hdr_get_rst_flag(hdr))
          {
               session_set_closing_reason(sess, (dir == SESSION_DIR_C2S ? CLOSING_BY_CLIENT_RST : CLOSING_BY_SERVER_RST));
          }
     }

     return 0;
}

static int session_manager_update_udp_session(struct session_manager *mgr, struct session *sess, const struct packet *pkt, const struct tuple6 *key, uint64_t now)
{
     struct session_manager_options *opts = &mgr->opts;
     enum session_dir dir = identify_direction_by_history(sess, key);
     enum session_state curr_state = session_get_state(sess);
     enum session_state next_state = session_transition_run(curr_state, UDP_DATA);
     session_update(sess, next_state, pkt, key, dir, now);
     session_transition_log(sess, curr_state, next_state, UDP_DATA);
     session_stat_update(mgr, sess, curr_state, next_state);
     timer_update(mgr->sess_timer, sess, now + opts->udp_timeout_data);

     return 0;
}

/******************************************************************************
 * Public API
 ******************************************************************************/

struct session_manager *session_manager_new(struct session_manager_options *opts, uint64_t now)
{
     if (check_options(opts) == -1)
     {
          return NULL;
     }
     struct session_manager *mgr = (struct session_manager *)calloc(1, sizeof(struct session_manager));
     if (mgr == NULL)
     {
          return NULL;
     }

     memcpy(&mgr->opts, opts, sizeof(struct session_manager_options));
     struct duplicated_packet_filter_options dup_pkt_opts = {
         .enable = opts->duplicated_packet_filter_enable,
         .capacity = opts->duplicated_packet_filter_capacity,
         .timeout_sec = opts->duplicated_packet_filter_timeout,
         .error_rate = opts->duplicated_packet_filter_error_rate,
     };
     struct evicted_session_filter_options evc_sess_opts = {
         .enable = opts->evicted_session_filter_enable,
         .capacity = opts->evicted_session_filter_capacity,
         .timeout_sec = opts->evicted_session_filter_timeout,
         .error_rate = opts->evicted_session_filter_error_rate,
     };
     tcp_reassembly_opts = {
         .enable = opts->tcp_reassembly_enable,
         .max_timeout = opts->tcp_reassembly_max_timeout,
         .max_segments = opts->tcp_reassembly_max_segments,
         .max_bytes = opts->tcp_reassembly_max_bytes,
     };

     mgr->sess_pool = session_pool_new(opts->max_tcp_session_num + opts->max_udp_session_num);
     mgr->tcp_sess_table = session_table_new();
     mgr->udp_sess_table = session_table_new();
     mgr->sess_timer = session_timer_new();
     mgr->sess_evicte_queue = session_queue_new();
     mgr->dup_pkt_filter = duplicated_packet_filter_new(&dup_pkt_opts, now);
     mgr->evicte_sess_filter = evicted_session_filter_new(&evc_sess_opts, now);
     if (mgr->sess_pool == NULL || mgr->tcp_sess_table == NULL || mgr->udp_sess_table == NULL || mgr->sess_timer == NULL || mgr->sess_evicte_queue == NULL || mgr->dup_pkt_filter == NULL || mgr->evicte_sess_filter == NULL)
     {
          goto error;
     }

     session_transition_init();
     session_filter_init();
     return mgr;

error:
     session_manager_free(mgr);
     return NULL;
}

void session_manager_free(struct session_manager *mgr)
{
     struct session *sess;
     if (mgr)
     {
          // free all evicted session
          while (mgr->sess_evicte_queue && (sess = session_manager_get_evicted_session(mgr)))
          {
               session_manager_free_session(mgr, sess);
          }
          // free all udp session
          while (mgr->udp_sess_table && (sess = session_table_find_lru(mgr->udp_sess_table)))
          {
               session_manager_free_session(mgr, sess);
          }
          // free all tcp session
          while (mgr->tcp_sess_table && (sess = session_table_find_lru(mgr->tcp_sess_table)))
          {
               session_manager_free_session(mgr, sess);
          }
          evicted_session_filter_free(mgr->evicte_sess_filter);
          duplicated_packet_filter_free(mgr->dup_pkt_filter);
          session_queue_free(mgr->sess_evicte_queue);
          session_timer_free(mgr->sess_timer);
          session_table_free(mgr->udp_sess_table);
          session_table_free(mgr->tcp_sess_table);
          session_pool_free(mgr->sess_pool);
          free(mgr);
          mgr = NULL;
     }
}

struct session *session_manager_new_session(struct session_manager *mgr, const struct packet *pkt, uint64_t now)
{
     struct tuple6 key;
     if (packet_get_innermost_tuple6(pkt, &key))
     {
          return NULL;
     }
     if (session_filter_run(mgr, FILTER_STAGE_PRE_NEW_SESS, NULL, pkt, &key, now))
     {
          return NULL;
     }
     switch (key.ip_proto)
     {
     case IPPROTO_TCP:
          return session_manager_new_tcp_session(mgr, pkt, &key, now);
     case IPPROTO_UDP:
          return session_manager_new_udp_session(mgr, pkt, &key, now);
     default:
          return NULL;
     }
}

void session_manager_free_session(struct session_manager *mgr, struct session *sess)
{
     if (sess)
     {
          SESSION_LOG_DEBUG("session %lu closed (%s)", session_get_id(sess), session_closing_reason_to_str(session_get_closing_reason(sess)));

          session_timer_del(mgr->sess_timer, sess);
          switch (session_get_type(sess))
          {
          case SESSION_TYPE_TCP:
               tcp_reassembly_free(sess->c2s_reassembly);
               tcp_reassembly_free(sess->s2c_reassembly);
               session_table_del(mgr->tcp_sess_table, session_get0_key(sess));
               session_stat_dec(&mgr->stat.tcp_sess, session_get_state(sess));
               mgr->stat.tcp_sess.nr_sess_used--;
               break;
          case SESSION_TYPE_UDP:
               session_table_del(mgr->udp_sess_table, session_get0_key(sess));
               session_stat_dec(&mgr->stat.udp_sess, session_get_state(sess));
               mgr->stat.udp_sess.nr_sess_used--;
               break;
          default:
               assert(0);
               break;
          }

          session_set0_cur_pkt(sess, NULL);
          session_set_cur_dir(sess, SESSION_DIR_NONE);
          packet_free(sess->c2s_1st_pkt);
          packet_free(sess->s2c_1st_pkt);
          session_free_all_ex_data(sess);
          session_pool_push(mgr->sess_pool, sess);
          sess = NULL;
     }
}

struct session *session_manager_lookup_session(struct session_manager *mgr, const struct packet *pkt)
{
     struct tuple6 key;
     if (packet_get_innermost_tuple6(pkt, &key))
     {
          return NULL;
     }
     switch (key.ip_proto)
     {
     case IPPROTO_UDP:
          return session_table_find_tuple(mgr->udp_sess_table, &key);
     case IPPROTO_TCP:
          return session_table_find_tuple(mgr->tcp_sess_table, &key);
     default:
          return NULL;
     }
}

int session_manager_update_session(struct session_manager *mgr, struct session *sess, const struct packet *pkt, uint64_t now)
{
     struct tuple6 key;
     if (packet_get_innermost_tuple6(pkt, &key))
     {
          return -1;
     }
     if (session_filter_run(mgr, FILTER_STAGE_PRE_UPDATE_SESS, sess, pkt, &key, now))
     {
          return -1;
     }
     switch (session_get_type(sess))
     {
     case SESSION_TYPE_TCP:
          return session_manager_update_tcp_session(mgr, sess, pkt, &key, now);
     case SESSION_TYPE_UDP:
          return session_manager_update_udp_session(mgr, sess, pkt, &key, now);
     default:
          return -1;
     }
}

struct session *session_manager_get_expired_session(struct session_manager *mgr, uint64_t now)
{
     struct session_manager_options *opts = &mgr->opts;
     struct session *sess = session_timer_expire(mgr->sess_timer, now);
     if (sess)
     {
          enum session_state curr_state = session_get_state(sess);
          enum session_state next_state = session_transition_run(curr_state, TIMEOUT);
          session_transition_log(sess, curr_state, next_state, TIMEOUT);
          session_set_state(sess, next_state);
          session_stat_update(mgr, sess, curr_state, next_state);

          if (next_state == SESSION_STATE_CLOSED)
          {
               // need free session
               if (!session_get_closing_reason(sess))
               {
                    session_set_closing_reason(sess, CLOSING_BY_TIMEOUT);
               }
               return sess;
          }
          else
          {
               // in closing state, only update timeout
               uint64_t timeout = session_get_type(sess) == SESSION_TYPE_TCP ? opts->tcp_timeout_time_wait : opts->udp_timeout_data;
               timer_update(mgr->sess_timer, sess, now + timeout);
               return NULL;
          }
     }

     return NULL;
}

struct session *session_manager_get_evicted_session(struct session_manager *mgr)
{
     return session_queue_pop(mgr->sess_evicte_queue);
}

uint64_t session_manager_get_expire_interval(struct session_manager *mgr)
{
     return session_timer_next_expire_interval(mgr->sess_timer);
}

void session_manager_print_stat(struct session_manager *mgr)
{
     if (mgr)
     {
          SESSION_LOG_DEBUG("session_manager_stat->tcp_sess_num: used: %u, init: %u, opening: %u, active: %u, closing: %u, closed: %u, evic_new: %u, evic_old: %u",
                            mgr->stat.tcp_sess.nr_sess_used, mgr->stat.tcp_sess.nr_sess_init, mgr->stat.tcp_sess.nr_sess_opening,
                            mgr->stat.tcp_sess.nr_sess_active, mgr->stat.tcp_sess.nr_sess_closing, mgr->stat.tcp_sess.nr_sess_closed,
                            mgr->stat.tcp_sess.nr_new_sess_evicted, mgr->stat.tcp_sess.nr_old_sess_evicted);
          SESSION_LOG_DEBUG("session_manager_stat->udp_sess_num: used: %u, init: %u, opening: %u, active: %u, closing: %u, closed: %u, evic_new: %u, evic_old: %u",
                            mgr->stat.udp_sess.nr_sess_used, mgr->stat.udp_sess.nr_sess_init, mgr->stat.udp_sess.nr_sess_opening,
                            mgr->stat.udp_sess.nr_sess_active, mgr->stat.udp_sess.nr_sess_closing, mgr->stat.udp_sess.nr_sess_closed,
                            mgr->stat.udp_sess.nr_new_sess_evicted, mgr->stat.udp_sess.nr_old_sess_evicted);
          SESSION_LOG_DEBUG("session_manager_stat: dup_pkts: %u, dup_bytes: %u, evic_pkts: %u, evic_bytes: %u",
                            mgr->stat.dup_pkt.nr_pkts, mgr->stat.dup_pkt.nr_bytes,
                            mgr->stat.evc_pkt.nr_pkts, mgr->stat.evc_pkt.nr_bytes);
     }
}

struct session_manager_stat *session_manager_get_stat(struct session_manager *mgr)
{
     return &mgr->stat;
}