175ce780965168000aeeef87900fda0a21db137c
[sip-router] / dst_blacklist.h
1 /*
2  * $Id$
3  *
4  * resolver related functions
5  *
6  * Copyright (C) 2006 iptelorg GmbH
7  *
8  * This file is part of ser, a free SIP server.
9  *
10  * ser is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version
14  *
15  * For a license to use the ser software under conditions
16  * other than those described here, or to purchase support for this
17  * software, please contact iptel.org by e-mail at the following addresses:
18  *    info@iptel.org
19  *
20  * ser is distributed in the hope that it will be useful,
21  * but WITHOUT ANY WARRANTY; without even the implied warranty of
22  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
23  * GNU General Public License for more details.
24  *
25  * You should have received a copy of the GNU General Public License
26  * along with this program; if not, write to the Free Software
27  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
28  */
29 /* History:
30  * --------
31  *  2006-07-29  created by andrei
32  *  2007-07-30  dst blacklist measurements added (Gergo)
33  *  2009-12-22  blacklist ignore mask support and dst_blacklist_{add,su}
34  *               switched to macros (andrei)
35  */
36
37 #ifndef dst_black_list_h
38 #define dst_black_list_h
39
40 #include "ip_addr.h"
41 #include "parser/msg_parser.h"
42 #include "timer_ticks.h"
43 #include "cfg_core.h"
44
45 #define DEFAULT_BLST_TIMEOUT            60  /* 1 min. */
46 #define DEFAULT_BLST_MAX_MEM            250 /* 250 KB */
47
48 /* flags: */
49 #define BLST_IS_IPV6            1               /* set if the address is ipv6 */
50 #define BLST_ERR_SEND           (1<<1)  /* set if  send is denied/failed */
51 #define BLST_ERR_CONNECT        (1<<2)  /* set if connect failed (tcp/tls) */
52 #define BLST_ICMP_RCVD          (1<<3)  /* set if icmp error */
53 #define BLST_ERR_TIMEOUT        (1<<4)  /* set if sip timeout */
54 #define BLST_503                        (1<<5)  /* set for 503 replies */
55 #define BLST_ADM_PROHIBITED     (1<<6)  /* administratively prohibited */
56 #define BLST_PERMANENT          (1<<7)  /* never deleted, never expires */
57
58 /* uncomment the define above to enable blacklist callbacks support */
59 /*#define DST_BLACKLIST_HOOKS*/
60
61 #define DST_BLACKLIST_CONTINUE 0 /* add: do nothing/ignore, search: ignore */
62 #define DST_BLACKLIST_ACCEPT 1   /* add: force accept, search: force match */
63 #define DST_BLACKLIST_DENY  -1   /* add: deny, search: force no match */
64
65 #define DST_BLACKLIST_ADD_CB 1
66 #define DST_BLACKLIST_SEARCH_CB 2
67
68 #ifdef DST_BLACKLIST_HOOKS
69 struct blacklist_hook{
70         /* WARNING: msg might be NULL, and it might point to shared memory
71          * without locking, do not modify it! msg can be used typically for checking
72          * the message flags with isflagset() */
73         int (*on_blst_action)(struct dest_info* si, unsigned char* err_flags,
74                                                         struct sip_msg* msg);
75         /* called before ser shutdown */
76         void (*destroy)(void);
77 };
78
79 int register_blacklist_hook(struct blacklist_hook *h, int type);
80 #endif /* DST_BLACKLIST_HOOKS */
81
82 int init_dst_blacklist();
83 #ifdef USE_DST_BLACKLIST_STATS
84 int init_dst_blacklist_stats(int iproc_num);
85 #define DST_BLACKLIST_ALL_STATS "bkl_all_stats"
86 #endif
87 void destroy_dst_blacklist();
88
89
90 /** force add to the blacklist.
91  * like @function dst_blacklist_add_to, but no ignore mask or
92  * blacklist enabled checks are made.
93  * @see dst_blacklist_add_to for the parameters and return value.
94  */
95 int dst_blacklist_force_add_to(unsigned char err_flags, struct dest_info* si,
96                                                                 struct sip_msg* msg, ticks_t timeout);
97
98 /** force add to the blacklist, long version.
99  * like @function dst_blacklist_su_to, but no ignore mask or
100  * blacklist enabled checks are made.
101  * @see dst_blacklist_su_to for the parameters and return value.
102  */
103 int dst_blacklist_force_su_to(  unsigned char err_flags,
104                                                                 unsigned char proto,
105                                                                 union sockaddr_union* dst,
106                                                                 struct sip_msg* msg,
107                                                                 ticks_t timeout);
108
109
110 /** checks if blacklist should be used.
111   * @param  err_flags - blacklist reason
112   * @param si - filled dst_info structure pointer.
113   * @return 1 if blacklist is enabled (core_cfg) and the event/error
114   *           is not in the ignore list.
115   *         0 otherwise
116   */
117 #define should_blacklist(err_flags, si) \
118         (cfg_get(core, core_cfg, use_dst_blacklist) && \
119                 ((err_flags) & (si)->send_flags.blst_imask))
120
121
122 /** checks if blacklist should be used, long version.
123   * @param  err_flags - blacklist reason
124   * @param snd_flags - snd_flags pointer, can be 0.
125   * @param proto - protocol, can be 0 (PROTO_NONE).
126   * @param si  - sockaddr_union pointer, can be 0.
127   * @return 1 if blacklist is enabled (core_cfg) and the event/error
128   *           is not in the ignore list.
129   *         0 otherwise
130   */
131 #define should_blacklist_su(err_flags, snd_flags, proto, su) \
132         (cfg_get(core, core_cfg, use_dst_blacklist) && \
133                 ((err_flags) & \
134                                         ~((snd_flags)?((snd_flags_t*)(snd_flags))->blst_imask:0)))
135
136
137 /** adds a dst to the blacklist.
138  *
139  * @param  err_flags - blacklist reason
140  * @param si  - dest_info structure (dst).
141  * @param msg - sip msg struct. pointer if known, 0 otherwise.
142  * @param timeout - timeout in ticks.
143  * @return >=0 on success, -1 on error.
144  */
145 #define dst_blacklist_add_to(err_flags, si, msg, timeout) \
146         (should_blacklist(err_flags, si)? \
147                 dst_blacklist_force_add_to((err_flags), (si), (msg), (timeout))\
148                 : 0)
149
150
151 /** adds a dst to the blacklist, long version.
152  * Similar to dst_blacklist_add_to, but uses "unpacked" parameters.
153  * @param  err_flags - blacklist reason
154  * @param proto - protocol.
155  * @param dst  - sockaddr_union pointer.
156  * @param snd_flags - snd_flags pointer, can be 0.
157  * @param msg - sip msg struct. pointer if known, 0 otherwise.
158  * @param timeout - timeout in ticks.
159  * @return >=0 on success, -1 on error.
160  */
161 #define dst_blacklist_su_to(err_flags, proto, dst, snd_flags, msg, timeout) \
162         (should_blacklist_su(err_flags, snd_flags, proto, dst) ? \
163                 dst_blacklist_force_su_to((err_flags), (proto), (dst), (msg), \
164                                                                         (timeout))\
165                 : 0)
166
167
168 /** adds a dst to the blacklist with default timeout.
169  *
170  * @param  err_flags - blacklist reason
171  * @param si  - dest_info structure (dst).
172  * @param msg - sip msg struct. pointer if known, 0 otherwise.
173  * @return >=0 on success, -1 on error.
174  * @see dst_blacklist_add_to.
175  */
176 #define dst_blacklist_add(err_flags, si, msg) \
177         dst_blacklist_add_to(err_flags, si, msg, \
178                                                         S_TO_TICKS(cfg_get(core, core_cfg, blst_timeout)))
179
180
181 /** adds a dst to the blacklist with default timeout, long version.
182  * Similar to dst_blacklist_add_to, but uses "unpacked" parameters.
183  * @param  err_flags - blacklist reason
184  * @param proto - protocol.
185  * @param dst  - sockaddr_union pointer.
186  * @param snd_flags - snd_flags pointer, can be 0.
187  * @param msg - sip msg struct. pointer if known, 0 otherwise.
188  * @return >=0 on success, -1 on error.
189  * @see dst_blacklist_su_to.
190  */
191 #define dst_blacklist_su(err_flags, proto, dst, snd_flags, msg) \
192         dst_blacklist_su_to(err_flags, proto, dst, snd_flags, msg, \
193                                                         S_TO_TICKS(cfg_get(core, core_cfg, blst_timeout)))
194
195 int dst_is_blacklisted(struct dest_info* si, struct sip_msg* msg);
196 /* delete an entry from the blacklist */
197 int dst_blacklist_del(struct dest_info* si, struct sip_msg* msg);
198
199 /* deletes all the entries from the blacklist except the permanent ones
200  * (which are marked with BLST_PERMANENT)
201  */
202 void dst_blst_flush(void);
203
204 int use_dst_blacklist_fixup(void *handle, str *gname, str *name, void **val);
205 /* KByte to Byte conversion */
206 int blst_max_mem_fixup(void *handle, str *gname, str *name, void **val);
207
208 #endif