dst_blacklist.h
dcb59e67
 /*
  * $Id$
  *
  * Copyright (C) 2006 iptelorg GmbH
  *
  * This file is part of ser, a free SIP server.
  *
  * ser is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version
  *
  * ser is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
5744b6f8
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
dcb59e67
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
1ff47a5c
 
 /**
  * @file
  * @brief SIP-router core :: Destination blacklists
  * @ingroup core
  * Module: @ref core
  */
 
dcb59e67
 /* History:
  * --------
  *  2006-07-29  created by andrei
5744b6f8
  *  2007-07-30  dst blacklist measurements added (Gergo)
dcb59e67
  */
 
 #ifndef dst_black_list_h
 #define dst_black_list_h
 
 #include "ip_addr.h"
7a64325c
 #include "parser/msg_parser.h"
5bd736c7
 #include "timer_ticks.h"
a4d17f82
 #include "cfg_core.h"
5bd736c7
 
1ff47a5c
 #define DEFAULT_BLST_TIMEOUT		60  /**< 1 min. */
 #define DEFAULT_BLST_MAX_MEM		250 /**< 250 KB */
 
 /** @name flags: */
 /*@{ */
dcb59e67
 
1ff47a5c
 #define BLST_IS_IPV6		1		/**< set if the address is ipv6 */
 #define BLST_ERR_SEND		(1<<1)	/**< set if  send is denied/failed */
 #define BLST_ERR_CONNECT	(1<<2)	/**< set if connect failed (tcp/tls) */
 #define BLST_ICMP_RCVD		(1<<3)	/**< set if icmp error */
 #define BLST_ERR_TIMEOUT	(1<<4)	/**< set if sip timeout */
 #define BLST_503			(1<<5)	/**< set for 503 replies */
 #define BLST_ADM_PROHIBITED	(1<<6)	/**< administratively prohibited */
 #define BLST_PERMANENT		(1<<7)  /**< never deleted, never expires */
 /*@} */
dcb59e67
 
2b813af1
 /* uncomment the define above to enable blacklist callbacks support */
304eb781
 /*#define DST_BLACKLIST_HOOKS*/
 
1ff47a5c
 #define DST_BLACKLIST_CONTINUE 0 /**< add: do nothing/ignore, search: ignore */
 #define DST_BLACKLIST_ACCEPT 1   /**< add: force accept, search: force match */
 #define DST_BLACKLIST_DENY  -1   /**< add: deny, search: force no match */
2b813af1
 
 #define DST_BLACKLIST_ADD_CB 1
 #define DST_BLACKLIST_SEARCH_CB 2
304eb781
 
 #ifdef DST_BLACKLIST_HOOKS
 struct blacklist_hook{
7a64325c
 	/* WARNING: msg might be NULL, and it might point to shared memory
 	 * without locking, do not modify it! msg can be used typically for checking
 	 * the message flags with isflagset() */
5bd736c7
 	int (*on_blst_action)(struct dest_info* si, unsigned char* err_flags,
 							struct sip_msg* msg);
304eb781
 	/* called before ser shutdown */
 	void (*destroy)(void);
 };
 
2b813af1
 int register_blacklist_hook(struct blacklist_hook *h, int type);
304eb781
 #endif /* DST_BLACKLIST_HOOKS */
 
dcb59e67
 int init_dst_blacklist();
5744b6f8
 #ifdef USE_DST_BLACKLIST_STATS
 int init_dst_blacklist_stats(int iproc_num);
 #define DST_BLACKLIST_ALL_STATS "bkl_all_stats"
 #endif
dcb59e67
 void destroy_dst_blacklist();
 
5bd736c7
 
1ff47a5c
 /** @brief like dst_blacklist_add, but the timeout can be also set */
5bd736c7
 int dst_blacklist_add_to(unsigned char err_flags, struct dest_info* si,
 						struct sip_msg* msg, ticks_t timeout);
1ff47a5c
 /** @brief like above, but using a differnt way of passing the target */
6d91574d
 int dst_blacklist_su_to(unsigned char err_flags, unsigned char proto,
 							union sockaddr_union* dst,
 							struct sip_msg* msg, ticks_t timeout);
5bd736c7
 
1ff47a5c
 /** @brief adds a dst to the blacklist with default timeout.
6d91574d
  * @see dst_blacklist_add_to for more details.
  */
5bd736c7
 #define dst_blacklist_add(err_flags, si, msg) \
a4d17f82
 	dst_blacklist_add_to((err_flags), (si), (msg), \
 		S_TO_TICKS(cfg_get(core, core_cfg, blst_timeout)))
dcb59e67
 
1ff47a5c
 /** @brief adds a dst to the blacklist with default timeout.
6d91574d
  * @see dst_blacklist_su_to for more details.
  */
 #define dst_blacklist_su(err_flags, proto, dst, msg) \
 	dst_blacklist_su_to((err_flags), (proto), (dst), (msg), \
 		S_TO_TICKS(cfg_get(core, core_cfg, blst_timeout)))
 
7a64325c
 int dst_is_blacklisted(struct dest_info* si, struct sip_msg* msg);
1ff47a5c
 
 /** @brief  delete an entry from the blacklist */
5bd736c7
 int dst_blacklist_del(struct dest_info* si, struct sip_msg* msg);
dfcbd08b
 
1ff47a5c
 /** @brief deletes all the entries from the blacklist except the permanent ones
dfcbd08b
  * (which are marked with BLST_PERMANENT)
  */
 void dst_blst_flush(void);
 
33bfeb9d
 int use_dst_blacklist_fixup(void *handle, str *gname, str *name, void **val);
1ff47a5c
 
 /** @brief KByte to Byte conversion */
33bfeb9d
 int blst_max_mem_fixup(void *handle, str *gname, str *name, void **val);
a4d17f82
 
dcb59e67
 #endif