blob: a816c37417bbbe3adc70a364cf0e84f99be3a164 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * IP Virtual Server
3 * data structure and functionality definitions
4 */
5
Julius Volzbc4768e2008-07-31 20:45:24 -07006#ifndef _NET_IP_VS_H
7#define _NET_IP_VS_H
Linus Torvalds1da177e2005-04-16 15:20:36 -07008
Julius Volzbc4768e2008-07-31 20:45:24 -07009#include <linux/ip_vs.h> /* definitions shared with userland */
Linus Torvalds1da177e2005-04-16 15:20:36 -070010
Julius Volzbc4768e2008-07-31 20:45:24 -070011/* old ipvsadm versions still include this file directly */
Linus Torvalds1da177e2005-04-16 15:20:36 -070012#ifdef __KERNEL__
13
Julius Volzbc4768e2008-07-31 20:45:24 -070014#include <asm/types.h> /* for __uXX types */
15
16#include <linux/sysctl.h> /* for ctl_path */
Linus Torvalds1da177e2005-04-16 15:20:36 -070017#include <linux/list.h> /* for struct list_head */
18#include <linux/spinlock.h> /* for struct rwlock_t */
Linus Torvalds1da177e2005-04-16 15:20:36 -070019#include <asm/atomic.h> /* for struct atomic_t */
Linus Torvalds1da177e2005-04-16 15:20:36 -070020#include <linux/compiler.h>
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -020021#include <linux/timer.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070022
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -020023#include <net/checksum.h>
Julius Volze7ade462008-09-02 15:55:33 +020024#include <linux/netfilter.h> /* for union nf_inet_addr */
KOVACS Krisztian1668e012008-10-01 07:33:10 -070025#include <linux/ip.h>
Julius Volze7ade462008-09-02 15:55:33 +020026#include <linux/ipv6.h> /* for struct ipv6hdr */
27#include <net/ipv6.h> /* for ipv6_addr_copy */
Linus Torvalds1da177e2005-04-16 15:20:36 -070028
Catalin(ux) M. BOIE6f7edb42010-01-05 05:50:24 +010029
30/* Connections' size value needed by ip_vs_ctl.c */
31extern int ip_vs_conn_tab_size;
32
33
Julius Volz64aae3c2008-09-02 15:55:34 +020034struct ip_vs_iphdr {
35 int len;
36 __u8 protocol;
37 union nf_inet_addr saddr;
38 union nf_inet_addr daddr;
39};
40
41static inline void
42ip_vs_fill_iphdr(int af, const void *nh, struct ip_vs_iphdr *iphdr)
43{
44#ifdef CONFIG_IP_VS_IPV6
45 if (af == AF_INET6) {
46 const struct ipv6hdr *iph = nh;
47 iphdr->len = sizeof(struct ipv6hdr);
48 iphdr->protocol = iph->nexthdr;
49 ipv6_addr_copy(&iphdr->saddr.in6, &iph->saddr);
50 ipv6_addr_copy(&iphdr->daddr.in6, &iph->daddr);
51 } else
52#endif
53 {
54 const struct iphdr *iph = nh;
55 iphdr->len = iph->ihl * 4;
56 iphdr->protocol = iph->protocol;
57 iphdr->saddr.ip = iph->saddr;
58 iphdr->daddr.ip = iph->daddr;
59 }
60}
61
62static inline void ip_vs_addr_copy(int af, union nf_inet_addr *dst,
63 const union nf_inet_addr *src)
64{
65#ifdef CONFIG_IP_VS_IPV6
66 if (af == AF_INET6)
67 ipv6_addr_copy(&dst->in6, &src->in6);
68 else
69#endif
70 dst->ip = src->ip;
71}
72
73static inline int ip_vs_addr_equal(int af, const union nf_inet_addr *a,
74 const union nf_inet_addr *b)
75{
76#ifdef CONFIG_IP_VS_IPV6
77 if (af == AF_INET6)
78 return ipv6_addr_equal(&a->in6, &b->in6);
79#endif
80 return a->ip == b->ip;
81}
82
Linus Torvalds1da177e2005-04-16 15:20:36 -070083#ifdef CONFIG_IP_VS_DEBUG
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -020084#include <linux/net.h>
85
Linus Torvalds1da177e2005-04-16 15:20:36 -070086extern int ip_vs_get_debug_level(void);
Julius Volzc842a3a2008-09-02 15:55:35 +020087
88static inline const char *ip_vs_dbg_addr(int af, char *buf, size_t buf_len,
89 const union nf_inet_addr *addr,
90 int *idx)
91{
92 int len;
93#ifdef CONFIG_IP_VS_IPV6
94 if (af == AF_INET6)
Harvey Harrison5b095d9892008-10-29 12:52:50 -070095 len = snprintf(&buf[*idx], buf_len - *idx, "[%pI6]",
Harvey Harrison0c6ce782008-10-28 16:09:23 -070096 &addr->in6) + 1;
Julius Volzc842a3a2008-09-02 15:55:35 +020097 else
98#endif
Harvey Harrison3685f25d2008-10-31 00:56:49 -070099 len = snprintf(&buf[*idx], buf_len - *idx, "%pI4",
100 &addr->ip) + 1;
Julius Volzc842a3a2008-09-02 15:55:35 +0200101
102 *idx += len;
103 BUG_ON(*idx > buf_len + 1);
104 return &buf[*idx - len];
105}
106
Hannes Eder9aada7a2009-07-30 14:29:44 -0700107#define IP_VS_DBG_BUF(level, msg, ...) \
108 do { \
109 char ip_vs_dbg_buf[160]; \
110 int ip_vs_dbg_idx = 0; \
111 if (level <= ip_vs_get_debug_level()) \
112 printk(KERN_DEBUG pr_fmt(msg), ##__VA_ARGS__); \
113 } while (0)
114#define IP_VS_ERR_BUF(msg...) \
115 do { \
116 char ip_vs_dbg_buf[160]; \
117 int ip_vs_dbg_idx = 0; \
118 pr_err(msg); \
119 } while (0)
Julius Volzc842a3a2008-09-02 15:55:35 +0200120
121/* Only use from within IP_VS_DBG_BUF() or IP_VS_ERR_BUF macros */
Hannes Eder9aada7a2009-07-30 14:29:44 -0700122#define IP_VS_DBG_ADDR(af, addr) \
123 ip_vs_dbg_addr(af, ip_vs_dbg_buf, \
124 sizeof(ip_vs_dbg_buf), addr, \
125 &ip_vs_dbg_idx)
Julius Volzc842a3a2008-09-02 15:55:35 +0200126
Hannes Eder9aada7a2009-07-30 14:29:44 -0700127#define IP_VS_DBG(level, msg, ...) \
128 do { \
129 if (level <= ip_vs_get_debug_level()) \
130 printk(KERN_DEBUG pr_fmt(msg), ##__VA_ARGS__); \
131 } while (0)
132#define IP_VS_DBG_RL(msg, ...) \
133 do { \
134 if (net_ratelimit()) \
135 printk(KERN_DEBUG pr_fmt(msg), ##__VA_ARGS__); \
136 } while (0)
137#define IP_VS_DBG_PKT(level, pp, skb, ofs, msg) \
138 do { \
139 if (level <= ip_vs_get_debug_level()) \
140 pp->debug_packet(pp, skb, ofs, msg); \
141 } while (0)
142#define IP_VS_DBG_RL_PKT(level, pp, skb, ofs, msg) \
143 do { \
144 if (level <= ip_vs_get_debug_level() && \
145 net_ratelimit()) \
146 pp->debug_packet(pp, skb, ofs, msg); \
147 } while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700148#else /* NO DEBUGGING at ALL */
Julius Volzc842a3a2008-09-02 15:55:35 +0200149#define IP_VS_DBG_BUF(level, msg...) do {} while (0)
150#define IP_VS_ERR_BUF(msg...) do {} while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151#define IP_VS_DBG(level, msg...) do {} while (0)
152#define IP_VS_DBG_RL(msg...) do {} while (0)
153#define IP_VS_DBG_PKT(level, pp, skb, ofs, msg) do {} while (0)
154#define IP_VS_DBG_RL_PKT(level, pp, skb, ofs, msg) do {} while (0)
155#endif
156
157#define IP_VS_BUG() BUG()
Hannes Eder1e3e2382009-08-02 11:05:41 +0000158#define IP_VS_ERR_RL(msg, ...) \
Hannes Eder9aada7a2009-07-30 14:29:44 -0700159 do { \
160 if (net_ratelimit()) \
Hannes Eder1e3e2382009-08-02 11:05:41 +0000161 pr_err(msg, ##__VA_ARGS__); \
Hannes Eder9aada7a2009-07-30 14:29:44 -0700162 } while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700163
164#ifdef CONFIG_IP_VS_DEBUG
165#define EnterFunction(level) \
Hannes Eder9aada7a2009-07-30 14:29:44 -0700166 do { \
167 if (level <= ip_vs_get_debug_level()) \
168 printk(KERN_DEBUG \
169 pr_fmt("Enter: %s, %s line %i\n"), \
170 __func__, __FILE__, __LINE__); \
171 } while (0)
172#define LeaveFunction(level) \
173 do { \
174 if (level <= ip_vs_get_debug_level()) \
175 printk(KERN_DEBUG \
176 pr_fmt("Leave: %s, %s line %i\n"), \
177 __func__, __FILE__, __LINE__); \
178 } while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700179#else
180#define EnterFunction(level) do {} while (0)
181#define LeaveFunction(level) do {} while (0)
182#endif
183
184#define IP_VS_WAIT_WHILE(expr) while (expr) { cpu_relax(); }
185
186
187/*
188 * The port number of FTP service (in network order).
189 */
Harvey Harrisonf3a7c662009-02-14 22:58:35 -0800190#define FTPPORT cpu_to_be16(21)
191#define FTPDATA cpu_to_be16(20)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700192
193/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700194 * TCP State Values
195 */
196enum {
197 IP_VS_TCP_S_NONE = 0,
198 IP_VS_TCP_S_ESTABLISHED,
199 IP_VS_TCP_S_SYN_SENT,
200 IP_VS_TCP_S_SYN_RECV,
201 IP_VS_TCP_S_FIN_WAIT,
202 IP_VS_TCP_S_TIME_WAIT,
203 IP_VS_TCP_S_CLOSE,
204 IP_VS_TCP_S_CLOSE_WAIT,
205 IP_VS_TCP_S_LAST_ACK,
206 IP_VS_TCP_S_LISTEN,
207 IP_VS_TCP_S_SYNACK,
208 IP_VS_TCP_S_LAST
209};
210
211/*
212 * UDP State Values
213 */
214enum {
215 IP_VS_UDP_S_NORMAL,
216 IP_VS_UDP_S_LAST,
217};
218
219/*
220 * ICMP State Values
221 */
222enum {
223 IP_VS_ICMP_S_NORMAL,
224 IP_VS_ICMP_S_LAST,
225};
226
227/*
228 * Delta sequence info structure
229 * Each ip_vs_conn has 2 (output AND input seq. changes).
230 * Only used in the VS/NAT.
231 */
232struct ip_vs_seq {
233 __u32 init_seq; /* Add delta from this seq */
234 __u32 delta; /* Delta in sequence numbers */
235 __u32 previous_delta; /* Delta in sequence numbers
236 before last resized pkt */
237};
238
239
240/*
Sven Wegener3a14a3132008-08-10 18:24:41 +0000241 * IPVS statistics objects
Linus Torvalds1da177e2005-04-16 15:20:36 -0700242 */
Sven Wegener3a14a3132008-08-10 18:24:41 +0000243struct ip_vs_estimator {
244 struct list_head list;
245
246 u64 last_inbytes;
247 u64 last_outbytes;
248 u32 last_conns;
249 u32 last_inpkts;
250 u32 last_outpkts;
251
252 u32 cps;
253 u32 inpps;
254 u32 outpps;
255 u32 inbps;
256 u32 outbps;
257};
258
Eric Dumazetfd2c3ef2009-11-03 03:26:03 +0000259struct ip_vs_stats {
Sven Wegenere9c0ce22008-09-08 13:39:04 +0200260 struct ip_vs_stats_user ustats; /* statistics */
261 struct ip_vs_estimator est; /* estimator */
Sven Wegener3a14a3132008-08-10 18:24:41 +0000262
Linus Torvalds1da177e2005-04-16 15:20:36 -0700263 spinlock_t lock; /* spin lock */
264};
265
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -0200266struct dst_entry;
267struct iphdr;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700268struct ip_vs_conn;
269struct ip_vs_app;
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -0200270struct sk_buff;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700271
272struct ip_vs_protocol {
273 struct ip_vs_protocol *next;
274 char *name;
Julian Anastasov2ad17de2008-04-29 03:21:23 -0700275 u16 protocol;
276 u16 num_states;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700277 int dont_defrag;
278 atomic_t appcnt; /* counter of proto app incs */
279 int *timeout_table; /* protocol timeout table */
280
281 void (*init)(struct ip_vs_protocol *pp);
282
283 void (*exit)(struct ip_vs_protocol *pp);
284
Julius Volz51ef3482008-09-02 15:55:40 +0200285 int (*conn_schedule)(int af, struct sk_buff *skb,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700286 struct ip_vs_protocol *pp,
287 int *verdict, struct ip_vs_conn **cpp);
288
289 struct ip_vs_conn *
Julius Volz51ef3482008-09-02 15:55:40 +0200290 (*conn_in_get)(int af,
291 const struct sk_buff *skb,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700292 struct ip_vs_protocol *pp,
Julius Volz51ef3482008-09-02 15:55:40 +0200293 const struct ip_vs_iphdr *iph,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700294 unsigned int proto_off,
295 int inverse);
296
297 struct ip_vs_conn *
Julius Volz51ef3482008-09-02 15:55:40 +0200298 (*conn_out_get)(int af,
299 const struct sk_buff *skb,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700300 struct ip_vs_protocol *pp,
Julius Volz51ef3482008-09-02 15:55:40 +0200301 const struct ip_vs_iphdr *iph,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700302 unsigned int proto_off,
303 int inverse);
304
Herbert Xu3db05fe2007-10-15 00:53:15 -0700305 int (*snat_handler)(struct sk_buff *skb,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700306 struct ip_vs_protocol *pp, struct ip_vs_conn *cp);
307
Herbert Xu3db05fe2007-10-15 00:53:15 -0700308 int (*dnat_handler)(struct sk_buff *skb,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700309 struct ip_vs_protocol *pp, struct ip_vs_conn *cp);
310
Julius Volz51ef3482008-09-02 15:55:40 +0200311 int (*csum_check)(int af, struct sk_buff *skb,
312 struct ip_vs_protocol *pp);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700313
314 const char *(*state_name)(int state);
315
316 int (*state_transition)(struct ip_vs_conn *cp, int direction,
317 const struct sk_buff *skb,
318 struct ip_vs_protocol *pp);
319
320 int (*register_app)(struct ip_vs_app *inc);
321
322 void (*unregister_app)(struct ip_vs_app *inc);
323
324 int (*app_conn_bind)(struct ip_vs_conn *cp);
325
326 void (*debug_packet)(struct ip_vs_protocol *pp,
327 const struct sk_buff *skb,
328 int offset,
329 const char *msg);
330
331 void (*timeout_change)(struct ip_vs_protocol *pp, int flags);
332
333 int (*set_state_timeout)(struct ip_vs_protocol *pp, char *sname, int to);
334};
335
336extern struct ip_vs_protocol * ip_vs_proto_get(unsigned short proto);
337
338/*
339 * IP_VS structure allocated for each dynamically scheduled connection
340 */
341struct ip_vs_conn {
342 struct list_head c_list; /* hashed list heads */
343
344 /* Protocol, addresses and port numbers */
Julius Volze7ade462008-09-02 15:55:33 +0200345 u16 af; /* address family */
346 union nf_inet_addr caddr; /* client address */
347 union nf_inet_addr vaddr; /* virtual address */
348 union nf_inet_addr daddr; /* destination address */
Al Viro014d7302006-09-28 14:29:52 -0700349 __be16 cport;
350 __be16 vport;
351 __be16 dport;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700352 __u16 protocol; /* Which protocol (TCP/UDP) */
353
354 /* counter and timer */
355 atomic_t refcnt; /* reference count */
356 struct timer_list timer; /* Expiration timer */
357 volatile unsigned long timeout; /* timeout */
358
359 /* Flags and state transition */
360 spinlock_t lock; /* lock for state transition */
361 volatile __u16 flags; /* status flags */
362 volatile __u16 state; /* state info */
Rumen G. Bogdanovskiefac5272007-11-07 02:36:55 -0800363 volatile __u16 old_state; /* old state, to be used for
364 * state transition triggerd
365 * synchronization
366 */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700367
368 /* Control members */
369 struct ip_vs_conn *control; /* Master control connection */
370 atomic_t n_control; /* Number of controlled ones */
371 struct ip_vs_dest *dest; /* real server */
372 atomic_t in_pkts; /* incoming packet counter */
373
374 /* packet transmitter for different forwarding methods. If it
375 mangles the packet, it must return NF_DROP or better NF_STOLEN,
376 otherwise this must be changed to a sk_buff **.
377 */
378 int (*packet_xmit)(struct sk_buff *skb, struct ip_vs_conn *cp,
379 struct ip_vs_protocol *pp);
380
381 /* Note: we can group the following members into a structure,
382 in order to save more space, and the following members are
383 only used in VS/NAT anyway */
384 struct ip_vs_app *app; /* bound ip_vs_app object */
385 void *app_data; /* Application private data */
386 struct ip_vs_seq in_seq; /* incoming seq. struct */
387 struct ip_vs_seq out_seq; /* outgoing seq. struct */
388};
389
390
391/*
Julius Volzc860c6b2008-09-02 15:55:36 +0200392 * Extended internal versions of struct ip_vs_service_user and
393 * ip_vs_dest_user for IPv6 support.
394 *
395 * We need these to conveniently pass around service and destination
396 * options, but unfortunately, we also need to keep the old definitions to
397 * maintain userspace backwards compatibility for the setsockopt interface.
398 */
399struct ip_vs_service_user_kern {
400 /* virtual service addresses */
401 u16 af;
402 u16 protocol;
403 union nf_inet_addr addr; /* virtual ip address */
404 u16 port;
405 u32 fwmark; /* firwall mark of service */
406
407 /* virtual service options */
408 char *sched_name;
409 unsigned flags; /* virtual service flags */
410 unsigned timeout; /* persistent timeout in sec */
411 u32 netmask; /* persistent netmask */
412};
413
414
415struct ip_vs_dest_user_kern {
416 /* destination server address */
417 union nf_inet_addr addr;
418 u16 port;
419
420 /* real server options */
421 unsigned conn_flags; /* connection flags */
422 int weight; /* destination weight */
423
424 /* thresholds for active connections */
425 u32 u_threshold; /* upper threshold */
426 u32 l_threshold; /* lower threshold */
427};
428
429
430/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700431 * The information about the virtual service offered to the net
432 * and the forwarding entries
433 */
434struct ip_vs_service {
435 struct list_head s_list; /* for normal service table */
436 struct list_head f_list; /* for fwmark-based service table */
437 atomic_t refcnt; /* reference counter */
438 atomic_t usecnt; /* use counter */
439
Julius Volze7ade462008-09-02 15:55:33 +0200440 u16 af; /* address family */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700441 __u16 protocol; /* which protocol (TCP/UDP) */
Julius Volze7ade462008-09-02 15:55:33 +0200442 union nf_inet_addr addr; /* IP address for virtual service */
Al Viro014d7302006-09-28 14:29:52 -0700443 __be16 port; /* port number for the service */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700444 __u32 fwmark; /* firewall mark of the service */
445 unsigned flags; /* service status flags */
446 unsigned timeout; /* persistent timeout in ticks */
Al Viro014d7302006-09-28 14:29:52 -0700447 __be32 netmask; /* grouping granularity */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700448
449 struct list_head destinations; /* real server d-linked list */
450 __u32 num_dests; /* number of servers */
451 struct ip_vs_stats stats; /* statistics for the service */
452 struct ip_vs_app *inc; /* bind conns to this app inc */
453
454 /* for scheduling */
455 struct ip_vs_scheduler *scheduler; /* bound scheduler object */
456 rwlock_t sched_lock; /* lock sched_data */
457 void *sched_data; /* scheduler application data */
458};
459
460
461/*
462 * The real server destination forwarding entry
463 * with ip address, port number, and so on.
464 */
465struct ip_vs_dest {
466 struct list_head n_list; /* for the dests in the service */
467 struct list_head d_list; /* for table with all the dests */
468
Julius Volze7ade462008-09-02 15:55:33 +0200469 u16 af; /* address family */
470 union nf_inet_addr addr; /* IP address of the server */
Al Viro014d7302006-09-28 14:29:52 -0700471 __be16 port; /* port number of the server */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700472 volatile unsigned flags; /* dest status flags */
473 atomic_t conn_flags; /* flags to copy to conn */
474 atomic_t weight; /* server weight */
475
476 atomic_t refcnt; /* reference counter */
477 struct ip_vs_stats stats; /* statistics */
478
479 /* connection counters and thresholds */
480 atomic_t activeconns; /* active connections */
481 atomic_t inactconns; /* inactive connections */
482 atomic_t persistconns; /* persistent connections */
483 __u32 u_threshold; /* upper threshold */
484 __u32 l_threshold; /* lower threshold */
485
486 /* for destination cache */
487 spinlock_t dst_lock; /* lock of dst_cache */
488 struct dst_entry *dst_cache; /* destination cache entry */
489 u32 dst_rtos; /* RT_TOS(tos) for dst */
490
491 /* for virtual service */
492 struct ip_vs_service *svc; /* service it belongs to */
493 __u16 protocol; /* which protocol (TCP/UDP) */
Julius Volze7ade462008-09-02 15:55:33 +0200494 union nf_inet_addr vaddr; /* virtual IP address */
Al Viro014d7302006-09-28 14:29:52 -0700495 __be16 vport; /* virtual port number */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700496 __u32 vfwmark; /* firewall mark of service */
497};
498
499
500/*
501 * The scheduler object
502 */
503struct ip_vs_scheduler {
504 struct list_head n_list; /* d-linked list head */
505 char *name; /* scheduler name */
506 atomic_t refcnt; /* reference counter */
507 struct module *module; /* THIS_MODULE/NULL */
508
509 /* scheduler initializing service */
510 int (*init_service)(struct ip_vs_service *svc);
511 /* scheduling service finish */
512 int (*done_service)(struct ip_vs_service *svc);
513 /* scheduler updating service */
514 int (*update_service)(struct ip_vs_service *svc);
515
516 /* selecting a server from the given service */
517 struct ip_vs_dest* (*schedule)(struct ip_vs_service *svc,
518 const struct sk_buff *skb);
519};
520
521
522/*
523 * The application module object (a.k.a. app incarnation)
524 */
Eric Dumazetfd2c3ef2009-11-03 03:26:03 +0000525struct ip_vs_app {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700526 struct list_head a_list; /* member in app list */
527 int type; /* IP_VS_APP_TYPE_xxx */
528 char *name; /* application module name */
529 __u16 protocol;
530 struct module *module; /* THIS_MODULE/NULL */
531 struct list_head incs_list; /* list of incarnations */
532
533 /* members for application incarnations */
534 struct list_head p_list; /* member in proto app list */
535 struct ip_vs_app *app; /* its real application */
Al Viro014d7302006-09-28 14:29:52 -0700536 __be16 port; /* port number in net order */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700537 atomic_t usecnt; /* usage counter */
538
539 /* output hook: return false if can't linearize. diff set for TCP. */
540 int (*pkt_out)(struct ip_vs_app *, struct ip_vs_conn *,
Herbert Xu3db05fe2007-10-15 00:53:15 -0700541 struct sk_buff *, int *diff);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700542
543 /* input hook: return false if can't linearize. diff set for TCP. */
544 int (*pkt_in)(struct ip_vs_app *, struct ip_vs_conn *,
Herbert Xu3db05fe2007-10-15 00:53:15 -0700545 struct sk_buff *, int *diff);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700546
547 /* ip_vs_app initializer */
548 int (*init_conn)(struct ip_vs_app *, struct ip_vs_conn *);
549
550 /* ip_vs_app finish */
551 int (*done_conn)(struct ip_vs_app *, struct ip_vs_conn *);
552
553
554 /* not used now */
555 int (*bind_conn)(struct ip_vs_app *, struct ip_vs_conn *,
556 struct ip_vs_protocol *);
557
558 void (*unbind_conn)(struct ip_vs_app *, struct ip_vs_conn *);
559
560 int * timeout_table;
561 int * timeouts;
562 int timeouts_size;
563
564 int (*conn_schedule)(struct sk_buff *skb, struct ip_vs_app *app,
565 int *verdict, struct ip_vs_conn **cpp);
566
567 struct ip_vs_conn *
568 (*conn_in_get)(const struct sk_buff *skb, struct ip_vs_app *app,
569 const struct iphdr *iph, unsigned int proto_off,
570 int inverse);
571
572 struct ip_vs_conn *
573 (*conn_out_get)(const struct sk_buff *skb, struct ip_vs_app *app,
574 const struct iphdr *iph, unsigned int proto_off,
575 int inverse);
576
577 int (*state_transition)(struct ip_vs_conn *cp, int direction,
578 const struct sk_buff *skb,
579 struct ip_vs_app *app);
580
581 void (*timeout_change)(struct ip_vs_app *app, int flags);
582};
583
584
585/*
586 * IPVS core functions
587 * (from ip_vs_core.c)
588 */
589extern const char *ip_vs_proto_name(unsigned proto);
590extern void ip_vs_init_hash_table(struct list_head *table, int rows);
Sven Wegenerafdd6142008-08-10 09:18:01 +0000591#define IP_VS_INIT_HASH_TABLE(t) ip_vs_init_hash_table((t), ARRAY_SIZE((t)))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700592
Linus Torvalds1da177e2005-04-16 15:20:36 -0700593#define IP_VS_APP_TYPE_FTP 1
594
595/*
596 * ip_vs_conn handling functions
597 * (from ip_vs_conn.c)
598 */
599
Linus Torvalds1da177e2005-04-16 15:20:36 -0700600enum {
601 IP_VS_DIR_INPUT = 0,
602 IP_VS_DIR_OUTPUT,
603 IP_VS_DIR_INPUT_ONLY,
604 IP_VS_DIR_LAST,
605};
606
607extern struct ip_vs_conn *ip_vs_conn_in_get
Julius Volz28364a52008-09-02 15:55:43 +0200608(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
609 const union nf_inet_addr *d_addr, __be16 d_port);
610
Julian Anastasov87375ab2005-09-14 21:08:51 -0700611extern struct ip_vs_conn *ip_vs_ct_in_get
Julius Volz28364a52008-09-02 15:55:43 +0200612(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
613 const union nf_inet_addr *d_addr, __be16 d_port);
614
Linus Torvalds1da177e2005-04-16 15:20:36 -0700615extern struct ip_vs_conn *ip_vs_conn_out_get
Julius Volz28364a52008-09-02 15:55:43 +0200616(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
617 const union nf_inet_addr *d_addr, __be16 d_port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700618
619/* put back the conn without restarting its timer */
620static inline void __ip_vs_conn_put(struct ip_vs_conn *cp)
621{
622 atomic_dec(&cp->refcnt);
623}
624extern void ip_vs_conn_put(struct ip_vs_conn *cp);
Al Viro014d7302006-09-28 14:29:52 -0700625extern void ip_vs_conn_fill_cport(struct ip_vs_conn *cp, __be16 cport);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626
627extern struct ip_vs_conn *
Julius Volz28364a52008-09-02 15:55:43 +0200628ip_vs_conn_new(int af, int proto, const union nf_inet_addr *caddr, __be16 cport,
629 const union nf_inet_addr *vaddr, __be16 vport,
630 const union nf_inet_addr *daddr, __be16 dport, unsigned flags,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700631 struct ip_vs_dest *dest);
632extern void ip_vs_conn_expire_now(struct ip_vs_conn *cp);
633
634extern const char * ip_vs_state_name(__u16 proto, int state);
635
636extern void ip_vs_tcp_conn_listen(struct ip_vs_conn *cp);
637extern int ip_vs_check_template(struct ip_vs_conn *ct);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700638extern void ip_vs_random_dropentry(void);
639extern int ip_vs_conn_init(void);
640extern void ip_vs_conn_cleanup(void);
641
642static inline void ip_vs_control_del(struct ip_vs_conn *cp)
643{
644 struct ip_vs_conn *ctl_cp = cp->control;
645 if (!ctl_cp) {
Julius Volzcfc78c52008-09-02 15:55:53 +0200646 IP_VS_ERR_BUF("request control DEL for uncontrolled: "
647 "%s:%d to %s:%d\n",
648 IP_VS_DBG_ADDR(cp->af, &cp->caddr),
649 ntohs(cp->cport),
650 IP_VS_DBG_ADDR(cp->af, &cp->vaddr),
651 ntohs(cp->vport));
652
Linus Torvalds1da177e2005-04-16 15:20:36 -0700653 return;
654 }
655
Julius Volzcfc78c52008-09-02 15:55:53 +0200656 IP_VS_DBG_BUF(7, "DELeting control for: "
657 "cp.dst=%s:%d ctl_cp.dst=%s:%d\n",
658 IP_VS_DBG_ADDR(cp->af, &cp->caddr),
659 ntohs(cp->cport),
660 IP_VS_DBG_ADDR(cp->af, &ctl_cp->caddr),
661 ntohs(ctl_cp->cport));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700662
663 cp->control = NULL;
664 if (atomic_read(&ctl_cp->n_control) == 0) {
Julius Volzcfc78c52008-09-02 15:55:53 +0200665 IP_VS_ERR_BUF("BUG control DEL with n=0 : "
666 "%s:%d to %s:%d\n",
667 IP_VS_DBG_ADDR(cp->af, &cp->caddr),
668 ntohs(cp->cport),
669 IP_VS_DBG_ADDR(cp->af, &cp->vaddr),
670 ntohs(cp->vport));
671
Linus Torvalds1da177e2005-04-16 15:20:36 -0700672 return;
673 }
674 atomic_dec(&ctl_cp->n_control);
675}
676
677static inline void
678ip_vs_control_add(struct ip_vs_conn *cp, struct ip_vs_conn *ctl_cp)
679{
680 if (cp->control) {
Julius Volzcfc78c52008-09-02 15:55:53 +0200681 IP_VS_ERR_BUF("request control ADD for already controlled: "
682 "%s:%d to %s:%d\n",
683 IP_VS_DBG_ADDR(cp->af, &cp->caddr),
684 ntohs(cp->cport),
685 IP_VS_DBG_ADDR(cp->af, &cp->vaddr),
686 ntohs(cp->vport));
687
Linus Torvalds1da177e2005-04-16 15:20:36 -0700688 ip_vs_control_del(cp);
689 }
690
Julius Volzcfc78c52008-09-02 15:55:53 +0200691 IP_VS_DBG_BUF(7, "ADDing control for: "
692 "cp.dst=%s:%d ctl_cp.dst=%s:%d\n",
693 IP_VS_DBG_ADDR(cp->af, &cp->caddr),
694 ntohs(cp->cport),
695 IP_VS_DBG_ADDR(cp->af, &ctl_cp->caddr),
696 ntohs(ctl_cp->cport));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700697
698 cp->control = ctl_cp;
699 atomic_inc(&ctl_cp->n_control);
700}
701
702
703/*
704 * IPVS application functions
705 * (from ip_vs_app.c)
706 */
707#define IP_VS_APP_MAX_PORTS 8
708extern int register_ip_vs_app(struct ip_vs_app *app);
709extern void unregister_ip_vs_app(struct ip_vs_app *app);
710extern int ip_vs_bind_app(struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
711extern void ip_vs_unbind_app(struct ip_vs_conn *cp);
712extern int
713register_ip_vs_app_inc(struct ip_vs_app *app, __u16 proto, __u16 port);
714extern int ip_vs_app_inc_get(struct ip_vs_app *inc);
715extern void ip_vs_app_inc_put(struct ip_vs_app *inc);
716
Herbert Xu3db05fe2007-10-15 00:53:15 -0700717extern int ip_vs_app_pkt_out(struct ip_vs_conn *, struct sk_buff *skb);
718extern int ip_vs_app_pkt_in(struct ip_vs_conn *, struct sk_buff *skb);
Al Virodd0fc662005-10-07 07:46:04 +0100719extern int ip_vs_skb_replace(struct sk_buff *skb, gfp_t pri,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700720 char *o_buf, int o_len, char *n_buf, int n_len);
721extern int ip_vs_app_init(void);
722extern void ip_vs_app_cleanup(void);
723
724
725/*
726 * IPVS protocol functions (from ip_vs_proto.c)
727 */
728extern int ip_vs_protocol_init(void);
729extern void ip_vs_protocol_cleanup(void);
730extern void ip_vs_protocol_timeout_change(int flags);
731extern int *ip_vs_create_timeout_table(int *table, int size);
732extern int
Jan Engelhardt36cbd3d2009-08-05 10:42:58 -0700733ip_vs_set_state_timeout(int *table, int num, const char *const *names,
734 const char *name, int to);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700735extern void
736ip_vs_tcpudp_debug_packet(struct ip_vs_protocol *pp, const struct sk_buff *skb,
737 int offset, const char *msg);
738
739extern struct ip_vs_protocol ip_vs_protocol_tcp;
740extern struct ip_vs_protocol ip_vs_protocol_udp;
741extern struct ip_vs_protocol ip_vs_protocol_icmp;
742extern struct ip_vs_protocol ip_vs_protocol_esp;
743extern struct ip_vs_protocol ip_vs_protocol_ah;
744
745
746/*
747 * Registering/unregistering scheduler functions
748 * (from ip_vs_sched.c)
749 */
750extern int register_ip_vs_scheduler(struct ip_vs_scheduler *scheduler);
751extern int unregister_ip_vs_scheduler(struct ip_vs_scheduler *scheduler);
752extern int ip_vs_bind_scheduler(struct ip_vs_service *svc,
753 struct ip_vs_scheduler *scheduler);
754extern int ip_vs_unbind_scheduler(struct ip_vs_service *svc);
755extern struct ip_vs_scheduler *ip_vs_scheduler_get(const char *sched_name);
756extern void ip_vs_scheduler_put(struct ip_vs_scheduler *scheduler);
757extern struct ip_vs_conn *
758ip_vs_schedule(struct ip_vs_service *svc, const struct sk_buff *skb);
759extern int ip_vs_leave(struct ip_vs_service *svc, struct sk_buff *skb,
760 struct ip_vs_protocol *pp);
761
762
763/*
764 * IPVS control data and functions (from ip_vs_ctl.c)
765 */
766extern int sysctl_ip_vs_cache_bypass;
767extern int sysctl_ip_vs_expire_nodest_conn;
768extern int sysctl_ip_vs_expire_quiescent_template;
769extern int sysctl_ip_vs_sync_threshold[2];
770extern int sysctl_ip_vs_nat_icmp_send;
771extern struct ip_vs_stats ip_vs_stats;
Sven Wegener5587da52008-08-10 18:24:40 +0000772extern const struct ctl_path net_vs_ctl_path[];
Linus Torvalds1da177e2005-04-16 15:20:36 -0700773
774extern struct ip_vs_service *
Julius Volz3c2e0502008-09-02 15:55:38 +0200775ip_vs_service_get(int af, __u32 fwmark, __u16 protocol,
776 const union nf_inet_addr *vaddr, __be16 vport);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700777
778static inline void ip_vs_service_put(struct ip_vs_service *svc)
779{
780 atomic_dec(&svc->usecnt);
781}
782
783extern struct ip_vs_dest *
Julius Volz7937df12008-09-02 15:55:48 +0200784ip_vs_lookup_real_service(int af, __u16 protocol,
785 const union nf_inet_addr *daddr, __be16 dport);
786
Linus Torvalds1da177e2005-04-16 15:20:36 -0700787extern int ip_vs_use_count_inc(void);
788extern void ip_vs_use_count_dec(void);
789extern int ip_vs_control_init(void);
790extern void ip_vs_control_cleanup(void);
Rumen G. Bogdanovski1e356f92007-11-07 02:35:54 -0800791extern struct ip_vs_dest *
Julius Volz7937df12008-09-02 15:55:48 +0200792ip_vs_find_dest(int af, const union nf_inet_addr *daddr, __be16 dport,
793 const union nf_inet_addr *vaddr, __be16 vport, __u16 protocol);
Rumen G. Bogdanovski1e356f92007-11-07 02:35:54 -0800794extern struct ip_vs_dest *ip_vs_try_bind_dest(struct ip_vs_conn *cp);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700795
796
797/*
798 * IPVS sync daemon data and function prototypes
799 * (from ip_vs_sync.c)
800 */
801extern volatile int ip_vs_sync_state;
802extern volatile int ip_vs_master_syncid;
803extern volatile int ip_vs_backup_syncid;
804extern char ip_vs_master_mcast_ifn[IP_VS_IFNAME_MAXLEN];
805extern char ip_vs_backup_mcast_ifn[IP_VS_IFNAME_MAXLEN];
806extern int start_sync_thread(int state, char *mcast_ifn, __u8 syncid);
807extern int stop_sync_thread(int state);
808extern void ip_vs_sync_conn(struct ip_vs_conn *cp);
809
810
811/*
812 * IPVS rate estimator prototypes (from ip_vs_est.c)
813 */
Sven Wegenera919cf42008-08-14 00:47:16 +0200814extern int ip_vs_estimator_init(void);
815extern void ip_vs_estimator_cleanup(void);
Sven Wegener3a14a3132008-08-10 18:24:41 +0000816extern void ip_vs_new_estimator(struct ip_vs_stats *stats);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700817extern void ip_vs_kill_estimator(struct ip_vs_stats *stats);
818extern void ip_vs_zero_estimator(struct ip_vs_stats *stats);
819
820/*
821 * Various IPVS packet transmitters (from ip_vs_xmit.c)
822 */
823extern int ip_vs_null_xmit
824(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
825extern int ip_vs_bypass_xmit
826(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
827extern int ip_vs_nat_xmit
828(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
829extern int ip_vs_tunnel_xmit
830(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
831extern int ip_vs_dr_xmit
832(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
833extern int ip_vs_icmp_xmit
834(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp, int offset);
835extern void ip_vs_dst_reset(struct ip_vs_dest *dest);
836
Julius Volzb3cdd2a72008-09-02 15:55:45 +0200837#ifdef CONFIG_IP_VS_IPV6
838extern int ip_vs_bypass_xmit_v6
839(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
840extern int ip_vs_nat_xmit_v6
841(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
842extern int ip_vs_tunnel_xmit_v6
843(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
844extern int ip_vs_dr_xmit_v6
845(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp);
846extern int ip_vs_icmp_xmit_v6
847(struct sk_buff *skb, struct ip_vs_conn *cp, struct ip_vs_protocol *pp,
848 int offset);
849#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700850
851/*
852 * This is a simple mechanism to ignore packets when
853 * we are loaded. Just set ip_vs_drop_rate to 'n' and
854 * we start to drop 1/rate of the packets
855 */
856extern int ip_vs_drop_rate;
857extern int ip_vs_drop_counter;
858
859static __inline__ int ip_vs_todrop(void)
860{
861 if (!ip_vs_drop_rate) return 0;
862 if (--ip_vs_drop_counter > 0) return 0;
863 ip_vs_drop_counter = ip_vs_drop_rate;
864 return 1;
865}
866
867/*
868 * ip_vs_fwd_tag returns the forwarding tag of the connection
869 */
870#define IP_VS_FWD_METHOD(cp) (cp->flags & IP_VS_CONN_F_FWD_MASK)
871
Adrian Bunk732db652005-09-01 17:40:26 -0700872static inline char ip_vs_fwd_tag(struct ip_vs_conn *cp)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700873{
874 char fwd;
875
876 switch (IP_VS_FWD_METHOD(cp)) {
877 case IP_VS_CONN_F_MASQ:
878 fwd = 'M'; break;
879 case IP_VS_CONN_F_LOCALNODE:
880 fwd = 'L'; break;
881 case IP_VS_CONN_F_TUNNEL:
882 fwd = 'T'; break;
883 case IP_VS_CONN_F_DROUTE:
884 fwd = 'R'; break;
885 case IP_VS_CONN_F_BYPASS:
886 fwd = 'B'; break;
887 default:
888 fwd = '?'; break;
889 }
890 return fwd;
891}
892
Linus Torvalds1da177e2005-04-16 15:20:36 -0700893extern void ip_vs_nat_icmp(struct sk_buff *skb, struct ip_vs_protocol *pp,
Julius Volzb3cdd2a72008-09-02 15:55:45 +0200894 struct ip_vs_conn *cp, int dir);
895
896#ifdef CONFIG_IP_VS_IPV6
897extern void ip_vs_nat_icmp_v6(struct sk_buff *skb, struct ip_vs_protocol *pp,
898 struct ip_vs_conn *cp, int dir);
899#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700900
Al Virob1550f22006-11-14 21:37:50 -0800901extern __sum16 ip_vs_checksum_complete(struct sk_buff *skb, int offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700902
Al Virof9214b22006-11-16 02:41:18 -0800903static inline __wsum ip_vs_check_diff4(__be32 old, __be32 new, __wsum oldsum)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700904{
Al Virof9214b22006-11-16 02:41:18 -0800905 __be32 diff[2] = { ~old, new };
Linus Torvalds1da177e2005-04-16 15:20:36 -0700906
Joe Perches07f07572008-11-19 15:44:53 -0800907 return csum_partial(diff, sizeof(diff), oldsum);
Al Virof9214b22006-11-16 02:41:18 -0800908}
909
Julius Volz0bbdd422008-09-02 15:55:42 +0200910#ifdef CONFIG_IP_VS_IPV6
911static inline __wsum ip_vs_check_diff16(const __be32 *old, const __be32 *new,
912 __wsum oldsum)
913{
914 __be32 diff[8] = { ~old[3], ~old[2], ~old[1], ~old[0],
915 new[3], new[2], new[1], new[0] };
916
Joe Perches07f07572008-11-19 15:44:53 -0800917 return csum_partial(diff, sizeof(diff), oldsum);
Julius Volz0bbdd422008-09-02 15:55:42 +0200918}
919#endif
920
Al Virof9214b22006-11-16 02:41:18 -0800921static inline __wsum ip_vs_check_diff2(__be16 old, __be16 new, __wsum oldsum)
922{
923 __be16 diff[2] = { ~old, new };
924
Joe Perches07f07572008-11-19 15:44:53 -0800925 return csum_partial(diff, sizeof(diff), oldsum);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700926}
927
928#endif /* __KERNEL__ */
929
Julius Volzbc4768e2008-07-31 20:45:24 -0700930#endif /* _NET_IP_VS_H */