#pragma once #ifdef __cplusplus extern "C" { #endif #include #include #include "stellar/session.h" /****************************************************************************** * session set/get ******************************************************************************/ void session_init(struct session *sess); // session ID void session_set_id(struct session *sess, uint64_t id); uint64_t session_get_id(const struct session *sess); // session tuple void session_set_tuple6(struct session *sess, const struct tuple6 *tuple); const struct tuple6 *session_get_tuple6(const struct session *sess); // session tuple direction const char *session_get0_readable_addr(const struct session *sess); // session direction void session_set_direction(struct session *sess, enum session_direction dir); enum session_direction session_get_direction(const struct session *sess); // session flow direction void session_set_current_flow_direction(struct session *sess, enum flow_direction dir); enum flow_direction session_get_current_flow_direction(const struct session *sess); // session state void session_set_current_state(struct session *sess, enum session_state state); enum session_state session_get_current_state(const struct session *sess); // session type void session_set_type(struct session *sess, enum session_type type); enum session_type session_get_type(const struct session *sess); // session seen duplicate traffic void session_set_duplicate_traffic(struct session *sess); int session_has_duplicate_traffic(const struct session *sess); // session closing reason void session_set_closing_reason(struct session *sess, enum closing_reason reason); enum closing_reason session_get_closing_reason(const struct session *sess); // session stat void session_inc_stat(struct session *sess, enum flow_direction dir, enum session_stat stat, uint64_t val); uint64_t session_get_stat(const struct session *sess, enum flow_direction dir, enum session_stat stat); // session timestamp void session_set_timestamp(struct session *sess, enum session_timestamp type, uint64_t value); uint64_t session_get_timestamp(const struct session *sess, enum session_timestamp type); // session sids void session_clear_sids(struct session *sess, enum flow_direction dir); void session_set_sids(struct session *sess, enum flow_direction dir, const struct sids *sids); const struct sids *session_get_sids(const struct session *sess, enum flow_direction dir); // session route ctx void session_clear_route_ctx(struct session *sess, enum flow_direction dir); void session_set_route_ctx(struct session *sess, enum flow_direction dir, const struct route_ctx *ctx); const struct route_ctx *session_get_route_ctx(const struct session *sess, enum flow_direction dir); // session first packet void session_set_first_packet(struct session *sess, enum flow_direction dir, const struct packet *pkt); const struct packet *session_get_first_packet(const struct session *sess, enum flow_direction dir); // session current packet void session_set_current_packet(struct session *sess, const struct packet *pkt); const struct packet *session_get0_current_packet(const struct session *sess); // session symmetric int session_is_symmetric(const struct session *sess, unsigned char *flag); // session user data void session_set_user_data(struct session *sess, void *user_data); void *session_get_user_data(const struct session *sess); // session tcp segment struct tcp_segment *session_get_tcp_segment(struct session *sess); void session_free_tcp_segment(struct session *sess, struct tcp_segment *seg); /****************************************************************************** * session ex data ******************************************************************************/ typedef void session_ex_free_cb(struct session *sess, uint8_t idx, void *ex_ptr, void *arg); /* * the exdata prodoced by user, and comsumed by same user. * so, the exdata is not shared by different user. * otherwise, the exdata need dup by refer count, and free by refer count. * * if key exist, not allow update, return original index. */ uint8_t session_get_ex_new_index(const char *key, session_ex_free_cb *free_cb, void *args); /* * Support update ex_data. * * if key exist: run free_cb free old value, then set new value. * if not run free_cb, old value will be memory leak. * if not allow update, new value will be memory leak. * if key not exist: set new value. */ void session_set_ex_data(struct session *sess, uint8_t idx, void *val); void *session_get0_ex_data(const struct session *sess, uint8_t idx); /* * after set ex_data, the owner of ex_data is session, so user should not free it directly. * if user want to free ex_data, should use session_free_ex_data. */ void session_free_ex_data(struct session *sess, uint8_t idx); void session_free_all_ex_data(struct session *sess); /****************************************************************************** * to string ******************************************************************************/ const char *closing_reason_to_str(enum closing_reason reason); const char *session_state_to_str(enum session_state state); const char *session_type_to_str(enum session_type type); const char *flow_direction_to_str(enum flow_direction dir); // bref : 1, output session bref info // bref : 0, output session detail info int session_to_str(const struct session *sess, int bref, char *buff, int size); static inline void session_print(const struct session *sess) { char buff[4096]; session_to_str(sess, 0, buff, sizeof(buff)); printf("%s\n", buff); } #ifdef __cplusplus } #endif