blob: c2a42a62433ba7d5487d098ebcd52065977d741b [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * IPVS An implementation of the IP virtual server support for the
3 * LINUX operating system. IPVS is now implemented as a module
4 * over the Netfilter framework. IPVS can be used to build a
5 * high-performance and highly available server based on a
6 * cluster of servers.
7 *
Linus Torvalds1da177e2005-04-16 15:20:36 -07008 * Authors: Wensong Zhang <wensong@linuxvirtualserver.org>
9 * Peter Kese <peter.kese@ijs.si>
10 * Julian Anastasov <ja@ssi.bg>
11 *
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation; either version
15 * 2 of the License, or (at your option) any later version.
16 *
17 * The IPVS code for kernel 2.2 was done by Wensong Zhang and Peter Kese,
18 * with changes/fixes from Julian Anastasov, Lars Marowsky-Bree, Horms
19 * and others. Many code here is taken from IP MASQ code of kernel 2.2.
20 *
21 * Changes:
22 *
23 */
24
Andrew Mortone9242832006-01-05 14:57:36 -080025#include <linux/interrupt.h>
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -020026#include <linux/in.h>
Arnaldo Carvalho de Melof1900552006-01-04 02:02:20 -020027#include <linux/net.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070028#include <linux/kernel.h>
Arnaldo Carvalho de Melo14c85022005-12-27 02:43:12 -020029#include <linux/module.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070030#include <linux/vmalloc.h>
31#include <linux/proc_fs.h> /* for proc_net_* */
32#include <linux/seq_file.h>
33#include <linux/jhash.h>
34#include <linux/random.h>
35
Eric W. Biederman457c4cb2007-09-12 12:01:34 +020036#include <net/net_namespace.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070037#include <net/ip_vs.h>
38
39
40/*
41 * Connection hash table: for input and output packets lookups of IPVS
42 */
43static struct list_head *ip_vs_conn_tab;
44
45/* SLAB cache for IPVS connections */
Christoph Lametere18b8902006-12-06 20:33:20 -080046static struct kmem_cache *ip_vs_conn_cachep __read_mostly;
Linus Torvalds1da177e2005-04-16 15:20:36 -070047
48/* counter for current IPVS connections */
49static atomic_t ip_vs_conn_count = ATOMIC_INIT(0);
50
51/* counter for no client port connections */
52static atomic_t ip_vs_conn_no_cport_cnt = ATOMIC_INIT(0);
53
54/* random value for IPVS connection hash */
55static unsigned int ip_vs_conn_rnd;
56
57/*
58 * Fine locking granularity for big connection hash table
59 */
60#define CT_LOCKARRAY_BITS 4
61#define CT_LOCKARRAY_SIZE (1<<CT_LOCKARRAY_BITS)
62#define CT_LOCKARRAY_MASK (CT_LOCKARRAY_SIZE-1)
63
64struct ip_vs_aligned_lock
65{
66 rwlock_t l;
67} __attribute__((__aligned__(SMP_CACHE_BYTES)));
68
69/* lock array for conn table */
70static struct ip_vs_aligned_lock
71__ip_vs_conntbl_lock_array[CT_LOCKARRAY_SIZE] __cacheline_aligned;
72
73static inline void ct_read_lock(unsigned key)
74{
75 read_lock(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
76}
77
78static inline void ct_read_unlock(unsigned key)
79{
80 read_unlock(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
81}
82
83static inline void ct_write_lock(unsigned key)
84{
85 write_lock(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
86}
87
88static inline void ct_write_unlock(unsigned key)
89{
90 write_unlock(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
91}
92
93static inline void ct_read_lock_bh(unsigned key)
94{
95 read_lock_bh(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
96}
97
98static inline void ct_read_unlock_bh(unsigned key)
99{
100 read_unlock_bh(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
101}
102
103static inline void ct_write_lock_bh(unsigned key)
104{
105 write_lock_bh(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
106}
107
108static inline void ct_write_unlock_bh(unsigned key)
109{
110 write_unlock_bh(&__ip_vs_conntbl_lock_array[key&CT_LOCKARRAY_MASK].l);
111}
112
113
114/*
115 * Returns hash value for IPVS connection entry
116 */
Julius Volz28364a52008-09-02 15:55:43 +0200117static unsigned int ip_vs_conn_hashkey(int af, unsigned proto,
118 const union nf_inet_addr *addr,
119 __be16 port)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700120{
Julius Volz28364a52008-09-02 15:55:43 +0200121#ifdef CONFIG_IP_VS_IPV6
122 if (af == AF_INET6)
123 return jhash_3words(jhash(addr, 16, ip_vs_conn_rnd),
124 (__force u32)port, proto, ip_vs_conn_rnd)
125 & IP_VS_CONN_TAB_MASK;
126#endif
127 return jhash_3words((__force u32)addr->ip, (__force u32)port, proto,
128 ip_vs_conn_rnd)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700129 & IP_VS_CONN_TAB_MASK;
130}
131
132
133/*
134 * Hashes ip_vs_conn in ip_vs_conn_tab by proto,addr,port.
135 * returns bool success.
136 */
137static inline int ip_vs_conn_hash(struct ip_vs_conn *cp)
138{
139 unsigned hash;
140 int ret;
141
142 /* Hash by protocol, client address and port */
Julius Volz28364a52008-09-02 15:55:43 +0200143 hash = ip_vs_conn_hashkey(cp->af, cp->protocol, &cp->caddr, cp->cport);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700144
145 ct_write_lock(hash);
146
147 if (!(cp->flags & IP_VS_CONN_F_HASHED)) {
148 list_add(&cp->c_list, &ip_vs_conn_tab[hash]);
149 cp->flags |= IP_VS_CONN_F_HASHED;
150 atomic_inc(&cp->refcnt);
151 ret = 1;
152 } else {
153 IP_VS_ERR("ip_vs_conn_hash(): request for already hashed, "
154 "called from %p\n", __builtin_return_address(0));
155 ret = 0;
156 }
157
158 ct_write_unlock(hash);
159
160 return ret;
161}
162
163
164/*
165 * UNhashes ip_vs_conn from ip_vs_conn_tab.
166 * returns bool success.
167 */
168static inline int ip_vs_conn_unhash(struct ip_vs_conn *cp)
169{
170 unsigned hash;
171 int ret;
172
173 /* unhash it and decrease its reference counter */
Julius Volz28364a52008-09-02 15:55:43 +0200174 hash = ip_vs_conn_hashkey(cp->af, cp->protocol, &cp->caddr, cp->cport);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700175
176 ct_write_lock(hash);
177
178 if (cp->flags & IP_VS_CONN_F_HASHED) {
179 list_del(&cp->c_list);
180 cp->flags &= ~IP_VS_CONN_F_HASHED;
181 atomic_dec(&cp->refcnt);
182 ret = 1;
183 } else
184 ret = 0;
185
186 ct_write_unlock(hash);
187
188 return ret;
189}
190
191
192/*
193 * Gets ip_vs_conn associated with supplied parameters in the ip_vs_conn_tab.
194 * Called for pkts coming from OUTside-to-INside.
195 * s_addr, s_port: pkt source address (foreign host)
196 * d_addr, d_port: pkt dest address (load balancer)
197 */
198static inline struct ip_vs_conn *__ip_vs_conn_in_get
Julius Volz28364a52008-09-02 15:55:43 +0200199(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
200 const union nf_inet_addr *d_addr, __be16 d_port)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700201{
202 unsigned hash;
203 struct ip_vs_conn *cp;
204
Julius Volz28364a52008-09-02 15:55:43 +0200205 hash = ip_vs_conn_hashkey(af, protocol, s_addr, s_port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206
207 ct_read_lock(hash);
208
209 list_for_each_entry(cp, &ip_vs_conn_tab[hash], c_list) {
Julius Volz28364a52008-09-02 15:55:43 +0200210 if (cp->af == af &&
211 ip_vs_addr_equal(af, s_addr, &cp->caddr) &&
212 ip_vs_addr_equal(af, d_addr, &cp->vaddr) &&
213 s_port == cp->cport && d_port == cp->vport &&
Julian Anastasov87375ab2005-09-14 21:08:51 -0700214 ((!s_port) ^ (!(cp->flags & IP_VS_CONN_F_NO_CPORT))) &&
Julius Volze7ade462008-09-02 15:55:33 +0200215 protocol == cp->protocol) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700216 /* HIT */
217 atomic_inc(&cp->refcnt);
218 ct_read_unlock(hash);
219 return cp;
220 }
221 }
222
223 ct_read_unlock(hash);
224
225 return NULL;
226}
227
228struct ip_vs_conn *ip_vs_conn_in_get
Julius Volz28364a52008-09-02 15:55:43 +0200229(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
230 const union nf_inet_addr *d_addr, __be16 d_port)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231{
232 struct ip_vs_conn *cp;
233
Julius Volz28364a52008-09-02 15:55:43 +0200234 cp = __ip_vs_conn_in_get(af, protocol, s_addr, s_port, d_addr, d_port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235 if (!cp && atomic_read(&ip_vs_conn_no_cport_cnt))
Julius Volz28364a52008-09-02 15:55:43 +0200236 cp = __ip_vs_conn_in_get(af, protocol, s_addr, 0, d_addr,
237 d_port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700238
Julius Volz28364a52008-09-02 15:55:43 +0200239 IP_VS_DBG_BUF(9, "lookup/in %s %s:%d->%s:%d %s\n",
240 ip_vs_proto_name(protocol),
241 IP_VS_DBG_ADDR(af, s_addr), ntohs(s_port),
242 IP_VS_DBG_ADDR(af, d_addr), ntohs(d_port),
243 cp ? "hit" : "not hit");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700244
245 return cp;
246}
247
Julian Anastasov87375ab2005-09-14 21:08:51 -0700248/* Get reference to connection template */
249struct ip_vs_conn *ip_vs_ct_in_get
Julius Volz28364a52008-09-02 15:55:43 +0200250(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
251 const union nf_inet_addr *d_addr, __be16 d_port)
Julian Anastasov87375ab2005-09-14 21:08:51 -0700252{
253 unsigned hash;
254 struct ip_vs_conn *cp;
255
Julius Volz28364a52008-09-02 15:55:43 +0200256 hash = ip_vs_conn_hashkey(af, protocol, s_addr, s_port);
Julian Anastasov87375ab2005-09-14 21:08:51 -0700257
258 ct_read_lock(hash);
259
260 list_for_each_entry(cp, &ip_vs_conn_tab[hash], c_list) {
Julius Volz28364a52008-09-02 15:55:43 +0200261 if (cp->af == af &&
262 ip_vs_addr_equal(af, s_addr, &cp->caddr) &&
263 ip_vs_addr_equal(af, d_addr, &cp->vaddr) &&
264 s_port == cp->cport && d_port == cp->vport &&
Julian Anastasov87375ab2005-09-14 21:08:51 -0700265 cp->flags & IP_VS_CONN_F_TEMPLATE &&
Julius Volze7ade462008-09-02 15:55:33 +0200266 protocol == cp->protocol) {
Julian Anastasov87375ab2005-09-14 21:08:51 -0700267 /* HIT */
268 atomic_inc(&cp->refcnt);
269 goto out;
270 }
271 }
272 cp = NULL;
273
274 out:
275 ct_read_unlock(hash);
276
Julius Volz28364a52008-09-02 15:55:43 +0200277 IP_VS_DBG_BUF(9, "template lookup/in %s %s:%d->%s:%d %s\n",
278 ip_vs_proto_name(protocol),
279 IP_VS_DBG_ADDR(af, s_addr), ntohs(s_port),
280 IP_VS_DBG_ADDR(af, d_addr), ntohs(d_port),
281 cp ? "hit" : "not hit");
Julian Anastasov87375ab2005-09-14 21:08:51 -0700282
283 return cp;
284}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700285
286/*
287 * Gets ip_vs_conn associated with supplied parameters in the ip_vs_conn_tab.
288 * Called for pkts coming from inside-to-OUTside.
289 * s_addr, s_port: pkt source address (inside host)
290 * d_addr, d_port: pkt dest address (foreign host)
291 */
292struct ip_vs_conn *ip_vs_conn_out_get
Julius Volz28364a52008-09-02 15:55:43 +0200293(int af, int protocol, const union nf_inet_addr *s_addr, __be16 s_port,
294 const union nf_inet_addr *d_addr, __be16 d_port)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700295{
296 unsigned hash;
297 struct ip_vs_conn *cp, *ret=NULL;
298
299 /*
300 * Check for "full" addressed entries
301 */
Julius Volz28364a52008-09-02 15:55:43 +0200302 hash = ip_vs_conn_hashkey(af, protocol, d_addr, d_port);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700303
304 ct_read_lock(hash);
305
306 list_for_each_entry(cp, &ip_vs_conn_tab[hash], c_list) {
Julius Volz28364a52008-09-02 15:55:43 +0200307 if (cp->af == af &&
308 ip_vs_addr_equal(af, d_addr, &cp->caddr) &&
309 ip_vs_addr_equal(af, s_addr, &cp->daddr) &&
310 d_port == cp->cport && s_port == cp->dport &&
Linus Torvalds1da177e2005-04-16 15:20:36 -0700311 protocol == cp->protocol) {
312 /* HIT */
313 atomic_inc(&cp->refcnt);
314 ret = cp;
315 break;
316 }
317 }
318
319 ct_read_unlock(hash);
320
Julius Volz28364a52008-09-02 15:55:43 +0200321 IP_VS_DBG_BUF(9, "lookup/out %s %s:%d->%s:%d %s\n",
322 ip_vs_proto_name(protocol),
323 IP_VS_DBG_ADDR(af, s_addr), ntohs(s_port),
324 IP_VS_DBG_ADDR(af, d_addr), ntohs(d_port),
325 ret ? "hit" : "not hit");
Linus Torvalds1da177e2005-04-16 15:20:36 -0700326
327 return ret;
328}
329
330
331/*
332 * Put back the conn and restart its timer with its timeout
333 */
334void ip_vs_conn_put(struct ip_vs_conn *cp)
335{
336 /* reset it expire in its timeout */
337 mod_timer(&cp->timer, jiffies+cp->timeout);
338
339 __ip_vs_conn_put(cp);
340}
341
342
343/*
344 * Fill a no_client_port connection with a client port number
345 */
Al Viro014d7302006-09-28 14:29:52 -0700346void ip_vs_conn_fill_cport(struct ip_vs_conn *cp, __be16 cport)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700347{
348 if (ip_vs_conn_unhash(cp)) {
349 spin_lock(&cp->lock);
350 if (cp->flags & IP_VS_CONN_F_NO_CPORT) {
351 atomic_dec(&ip_vs_conn_no_cport_cnt);
352 cp->flags &= ~IP_VS_CONN_F_NO_CPORT;
353 cp->cport = cport;
354 }
355 spin_unlock(&cp->lock);
356
357 /* hash on new dport */
358 ip_vs_conn_hash(cp);
359 }
360}
361
362
363/*
364 * Bind a connection entry with the corresponding packet_xmit.
365 * Called by ip_vs_conn_new.
366 */
367static inline void ip_vs_bind_xmit(struct ip_vs_conn *cp)
368{
369 switch (IP_VS_FWD_METHOD(cp)) {
370 case IP_VS_CONN_F_MASQ:
371 cp->packet_xmit = ip_vs_nat_xmit;
372 break;
373
374 case IP_VS_CONN_F_TUNNEL:
375 cp->packet_xmit = ip_vs_tunnel_xmit;
376 break;
377
378 case IP_VS_CONN_F_DROUTE:
379 cp->packet_xmit = ip_vs_dr_xmit;
380 break;
381
382 case IP_VS_CONN_F_LOCALNODE:
383 cp->packet_xmit = ip_vs_null_xmit;
384 break;
385
386 case IP_VS_CONN_F_BYPASS:
387 cp->packet_xmit = ip_vs_bypass_xmit;
388 break;
389 }
390}
391
Julius Volzb3cdd2a72008-09-02 15:55:45 +0200392#ifdef CONFIG_IP_VS_IPV6
393static inline void ip_vs_bind_xmit_v6(struct ip_vs_conn *cp)
394{
395 switch (IP_VS_FWD_METHOD(cp)) {
396 case IP_VS_CONN_F_MASQ:
397 cp->packet_xmit = ip_vs_nat_xmit_v6;
398 break;
399
400 case IP_VS_CONN_F_TUNNEL:
401 cp->packet_xmit = ip_vs_tunnel_xmit_v6;
402 break;
403
404 case IP_VS_CONN_F_DROUTE:
405 cp->packet_xmit = ip_vs_dr_xmit_v6;
406 break;
407
408 case IP_VS_CONN_F_LOCALNODE:
409 cp->packet_xmit = ip_vs_null_xmit;
410 break;
411
412 case IP_VS_CONN_F_BYPASS:
413 cp->packet_xmit = ip_vs_bypass_xmit_v6;
414 break;
415 }
416}
417#endif
418
Linus Torvalds1da177e2005-04-16 15:20:36 -0700419
420static inline int ip_vs_dest_totalconns(struct ip_vs_dest *dest)
421{
422 return atomic_read(&dest->activeconns)
423 + atomic_read(&dest->inactconns);
424}
425
426/*
427 * Bind a connection entry with a virtual service destination
428 * Called just after a new connection entry is created.
429 */
430static inline void
431ip_vs_bind_dest(struct ip_vs_conn *cp, struct ip_vs_dest *dest)
432{
433 /* if dest is NULL, then return directly */
434 if (!dest)
435 return;
436
437 /* Increase the refcnt counter of the dest */
438 atomic_inc(&dest->refcnt);
439
440 /* Bind with the destination and its corresponding transmitter */
Rumen G. Bogdanovskib2096392007-11-19 21:53:27 -0800441 if ((cp->flags & IP_VS_CONN_F_SYNC) &&
442 (!(cp->flags & IP_VS_CONN_F_TEMPLATE)))
443 /* if the connection is not template and is created
444 * by sync, preserve the activity flag.
445 */
446 cp->flags |= atomic_read(&dest->conn_flags) &
447 (~IP_VS_CONN_F_INACTIVE);
448 else
449 cp->flags |= atomic_read(&dest->conn_flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700450 cp->dest = dest;
451
Roberto Nibali4b5bdf52006-01-03 14:22:59 -0800452 IP_VS_DBG(7, "Bind-dest %s c:%u.%u.%u.%u:%d v:%u.%u.%u.%u:%d "
453 "d:%u.%u.%u.%u:%d fwd:%c s:%u conn->flags:%X conn->refcnt:%d "
454 "dest->refcnt:%d\n",
Linus Torvalds1da177e2005-04-16 15:20:36 -0700455 ip_vs_proto_name(cp->protocol),
Julius Volze7ade462008-09-02 15:55:33 +0200456 NIPQUAD(cp->caddr.ip), ntohs(cp->cport),
457 NIPQUAD(cp->vaddr.ip), ntohs(cp->vport),
458 NIPQUAD(cp->daddr.ip), ntohs(cp->dport),
Linus Torvalds1da177e2005-04-16 15:20:36 -0700459 ip_vs_fwd_tag(cp), cp->state,
460 cp->flags, atomic_read(&cp->refcnt),
461 atomic_read(&dest->refcnt));
462
463 /* Update the connection counters */
Julian Anastasov87375ab2005-09-14 21:08:51 -0700464 if (!(cp->flags & IP_VS_CONN_F_TEMPLATE)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700465 /* It is a normal connection, so increase the inactive
466 connection counter because it is in TCP SYNRECV
467 state (inactive) or other protocol inacive state */
Rumen G. Bogdanovskib2096392007-11-19 21:53:27 -0800468 if ((cp->flags & IP_VS_CONN_F_SYNC) &&
469 (!(cp->flags & IP_VS_CONN_F_INACTIVE)))
470 atomic_inc(&dest->activeconns);
471 else
472 atomic_inc(&dest->inactconns);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700473 } else {
474 /* It is a persistent connection/template, so increase
475 the peristent connection counter */
476 atomic_inc(&dest->persistconns);
477 }
478
479 if (dest->u_threshold != 0 &&
480 ip_vs_dest_totalconns(dest) >= dest->u_threshold)
481 dest->flags |= IP_VS_DEST_F_OVERLOAD;
482}
483
484
485/*
Rumen G. Bogdanovski1e356f92007-11-07 02:35:54 -0800486 * Check if there is a destination for the connection, if so
487 * bind the connection to the destination.
488 */
489struct ip_vs_dest *ip_vs_try_bind_dest(struct ip_vs_conn *cp)
490{
491 struct ip_vs_dest *dest;
492
493 if ((cp) && (!cp->dest)) {
Julius Volz7937df12008-09-02 15:55:48 +0200494 dest = ip_vs_find_dest(cp->af, &cp->daddr, cp->dport,
495 &cp->vaddr, cp->vport,
496 cp->protocol);
Rumen G. Bogdanovski1e356f92007-11-07 02:35:54 -0800497 ip_vs_bind_dest(cp, dest);
498 return dest;
499 } else
500 return NULL;
501}
Rumen G. Bogdanovski1e356f92007-11-07 02:35:54 -0800502
503
504/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700505 * Unbind a connection entry with its VS destination
506 * Called by the ip_vs_conn_expire function.
507 */
508static inline void ip_vs_unbind_dest(struct ip_vs_conn *cp)
509{
510 struct ip_vs_dest *dest = cp->dest;
511
512 if (!dest)
513 return;
514
Roberto Nibali4b5bdf52006-01-03 14:22:59 -0800515 IP_VS_DBG(7, "Unbind-dest %s c:%u.%u.%u.%u:%d v:%u.%u.%u.%u:%d "
516 "d:%u.%u.%u.%u:%d fwd:%c s:%u conn->flags:%X conn->refcnt:%d "
517 "dest->refcnt:%d\n",
Linus Torvalds1da177e2005-04-16 15:20:36 -0700518 ip_vs_proto_name(cp->protocol),
Julius Volze7ade462008-09-02 15:55:33 +0200519 NIPQUAD(cp->caddr.ip), ntohs(cp->cport),
520 NIPQUAD(cp->vaddr.ip), ntohs(cp->vport),
521 NIPQUAD(cp->daddr.ip), ntohs(cp->dport),
Linus Torvalds1da177e2005-04-16 15:20:36 -0700522 ip_vs_fwd_tag(cp), cp->state,
523 cp->flags, atomic_read(&cp->refcnt),
524 atomic_read(&dest->refcnt));
525
526 /* Update the connection counters */
Julian Anastasov87375ab2005-09-14 21:08:51 -0700527 if (!(cp->flags & IP_VS_CONN_F_TEMPLATE)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700528 /* It is a normal connection, so decrease the inactconns
529 or activeconns counter */
530 if (cp->flags & IP_VS_CONN_F_INACTIVE) {
531 atomic_dec(&dest->inactconns);
532 } else {
533 atomic_dec(&dest->activeconns);
534 }
535 } else {
536 /* It is a persistent connection/template, so decrease
537 the peristent connection counter */
538 atomic_dec(&dest->persistconns);
539 }
540
541 if (dest->l_threshold != 0) {
542 if (ip_vs_dest_totalconns(dest) < dest->l_threshold)
543 dest->flags &= ~IP_VS_DEST_F_OVERLOAD;
544 } else if (dest->u_threshold != 0) {
545 if (ip_vs_dest_totalconns(dest) * 4 < dest->u_threshold * 3)
546 dest->flags &= ~IP_VS_DEST_F_OVERLOAD;
547 } else {
548 if (dest->flags & IP_VS_DEST_F_OVERLOAD)
549 dest->flags &= ~IP_VS_DEST_F_OVERLOAD;
550 }
551
552 /*
553 * Simply decrease the refcnt of the dest, because the
554 * dest will be either in service's destination list
555 * or in the trash.
556 */
557 atomic_dec(&dest->refcnt);
558}
559
560
561/*
562 * Checking if the destination of a connection template is available.
563 * If available, return 1, otherwise invalidate this connection
564 * template and return 0.
565 */
566int ip_vs_check_template(struct ip_vs_conn *ct)
567{
568 struct ip_vs_dest *dest = ct->dest;
569
570 /*
571 * Checking the dest server status.
572 */
573 if ((dest == NULL) ||
YOSHIFUJI Hideakie905a9e2007-02-09 23:24:47 +0900574 !(dest->flags & IP_VS_DEST_F_AVAILABLE) ||
575 (sysctl_ip_vs_expire_quiescent_template &&
Linus Torvalds1da177e2005-04-16 15:20:36 -0700576 (atomic_read(&dest->weight) == 0))) {
577 IP_VS_DBG(9, "check_template: dest not available for "
578 "protocol %s s:%u.%u.%u.%u:%d v:%u.%u.%u.%u:%d "
579 "-> d:%u.%u.%u.%u:%d\n",
580 ip_vs_proto_name(ct->protocol),
Julius Volze7ade462008-09-02 15:55:33 +0200581 NIPQUAD(ct->caddr.ip), ntohs(ct->cport),
582 NIPQUAD(ct->vaddr.ip), ntohs(ct->vport),
583 NIPQUAD(ct->daddr.ip), ntohs(ct->dport));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700584
585 /*
586 * Invalidate the connection template
587 */
Al Viro014d7302006-09-28 14:29:52 -0700588 if (ct->vport != htons(0xffff)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700589 if (ip_vs_conn_unhash(ct)) {
Al Viro014d7302006-09-28 14:29:52 -0700590 ct->dport = htons(0xffff);
591 ct->vport = htons(0xffff);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700592 ct->cport = 0;
593 ip_vs_conn_hash(ct);
594 }
595 }
596
597 /*
598 * Simply decrease the refcnt of the template,
599 * don't restart its timer.
600 */
601 atomic_dec(&ct->refcnt);
602 return 0;
603 }
604 return 1;
605}
606
607static void ip_vs_conn_expire(unsigned long data)
608{
609 struct ip_vs_conn *cp = (struct ip_vs_conn *)data;
610
611 cp->timeout = 60*HZ;
612
613 /*
614 * hey, I'm using it
615 */
616 atomic_inc(&cp->refcnt);
617
618 /*
619 * do I control anybody?
620 */
621 if (atomic_read(&cp->n_control))
622 goto expire_later;
623
624 /*
625 * unhash it if it is hashed in the conn table
626 */
627 if (!ip_vs_conn_unhash(cp))
628 goto expire_later;
629
630 /*
631 * refcnt==1 implies I'm the only one referrer
632 */
633 if (likely(atomic_read(&cp->refcnt) == 1)) {
634 /* delete the timer if it is activated by other users */
635 if (timer_pending(&cp->timer))
636 del_timer(&cp->timer);
637
638 /* does anybody control me? */
639 if (cp->control)
640 ip_vs_control_del(cp);
641
642 if (unlikely(cp->app != NULL))
643 ip_vs_unbind_app(cp);
644 ip_vs_unbind_dest(cp);
645 if (cp->flags & IP_VS_CONN_F_NO_CPORT)
646 atomic_dec(&ip_vs_conn_no_cport_cnt);
647 atomic_dec(&ip_vs_conn_count);
648
649 kmem_cache_free(ip_vs_conn_cachep, cp);
650 return;
651 }
652
653 /* hash it back to the table */
654 ip_vs_conn_hash(cp);
655
656 expire_later:
Roberto Nibali4b5bdf52006-01-03 14:22:59 -0800657 IP_VS_DBG(7, "delayed: conn->refcnt-1=%d conn->n_control=%d\n",
Linus Torvalds1da177e2005-04-16 15:20:36 -0700658 atomic_read(&cp->refcnt)-1,
659 atomic_read(&cp->n_control));
660
661 ip_vs_conn_put(cp);
662}
663
664
665void ip_vs_conn_expire_now(struct ip_vs_conn *cp)
666{
667 if (del_timer(&cp->timer))
668 mod_timer(&cp->timer, jiffies);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700669}
670
671
672/*
673 * Create a new connection entry and hash it into the ip_vs_conn_tab
674 */
675struct ip_vs_conn *
Julius Volz28364a52008-09-02 15:55:43 +0200676ip_vs_conn_new(int af, int proto, const union nf_inet_addr *caddr, __be16 cport,
677 const union nf_inet_addr *vaddr, __be16 vport,
678 const union nf_inet_addr *daddr, __be16 dport, unsigned flags,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700679 struct ip_vs_dest *dest)
680{
681 struct ip_vs_conn *cp;
682 struct ip_vs_protocol *pp = ip_vs_proto_get(proto);
683
Robert P. J. Dayc3762222007-02-10 01:45:03 -0800684 cp = kmem_cache_zalloc(ip_vs_conn_cachep, GFP_ATOMIC);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700685 if (cp == NULL) {
686 IP_VS_ERR_RL("ip_vs_conn_new: no memory available.\n");
687 return NULL;
688 }
689
Linus Torvalds1da177e2005-04-16 15:20:36 -0700690 INIT_LIST_HEAD(&cp->c_list);
Pavel Emelyanovb24b8a22008-01-23 21:20:07 -0800691 setup_timer(&cp->timer, ip_vs_conn_expire, (unsigned long)cp);
Julius Volz28364a52008-09-02 15:55:43 +0200692 cp->af = af;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700693 cp->protocol = proto;
Julius Volz28364a52008-09-02 15:55:43 +0200694 ip_vs_addr_copy(af, &cp->caddr, caddr);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700695 cp->cport = cport;
Julius Volz28364a52008-09-02 15:55:43 +0200696 ip_vs_addr_copy(af, &cp->vaddr, vaddr);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700697 cp->vport = vport;
Julius Volz28364a52008-09-02 15:55:43 +0200698 ip_vs_addr_copy(af, &cp->daddr, daddr);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700699 cp->dport = dport;
700 cp->flags = flags;
701 spin_lock_init(&cp->lock);
702
703 /*
704 * Set the entry is referenced by the current thread before hashing
705 * it in the table, so that other thread run ip_vs_random_dropentry
706 * but cannot drop this entry.
707 */
708 atomic_set(&cp->refcnt, 1);
709
710 atomic_set(&cp->n_control, 0);
711 atomic_set(&cp->in_pkts, 0);
712
713 atomic_inc(&ip_vs_conn_count);
714 if (flags & IP_VS_CONN_F_NO_CPORT)
715 atomic_inc(&ip_vs_conn_no_cport_cnt);
716
717 /* Bind the connection with a destination server */
718 ip_vs_bind_dest(cp, dest);
719
720 /* Set its state and timeout */
721 cp->state = 0;
722 cp->timeout = 3*HZ;
723
724 /* Bind its packet transmitter */
Julius Volzb3cdd2a72008-09-02 15:55:45 +0200725#ifdef CONFIG_IP_VS_IPV6
726 if (af == AF_INET6)
727 ip_vs_bind_xmit_v6(cp);
728 else
729#endif
730 ip_vs_bind_xmit(cp);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700731
732 if (unlikely(pp && atomic_read(&pp->appcnt)))
733 ip_vs_bind_app(cp, pp);
734
735 /* Hash it in the ip_vs_conn_tab finally */
736 ip_vs_conn_hash(cp);
737
738 return cp;
739}
740
741
742/*
743 * /proc/net/ip_vs_conn entries
744 */
745#ifdef CONFIG_PROC_FS
746
747static void *ip_vs_conn_array(struct seq_file *seq, loff_t pos)
748{
749 int idx;
750 struct ip_vs_conn *cp;
YOSHIFUJI Hideakie905a9e2007-02-09 23:24:47 +0900751
Linus Torvalds1da177e2005-04-16 15:20:36 -0700752 for(idx = 0; idx < IP_VS_CONN_TAB_SIZE; idx++) {
753 ct_read_lock_bh(idx);
754 list_for_each_entry(cp, &ip_vs_conn_tab[idx], c_list) {
755 if (pos-- == 0) {
756 seq->private = &ip_vs_conn_tab[idx];
757 return cp;
758 }
759 }
760 ct_read_unlock_bh(idx);
761 }
762
763 return NULL;
764}
765
766static void *ip_vs_conn_seq_start(struct seq_file *seq, loff_t *pos)
767{
768 seq->private = NULL;
769 return *pos ? ip_vs_conn_array(seq, *pos - 1) :SEQ_START_TOKEN;
770}
771
772static void *ip_vs_conn_seq_next(struct seq_file *seq, void *v, loff_t *pos)
773{
774 struct ip_vs_conn *cp = v;
775 struct list_head *e, *l = seq->private;
776 int idx;
777
778 ++*pos;
YOSHIFUJI Hideakie905a9e2007-02-09 23:24:47 +0900779 if (v == SEQ_START_TOKEN)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700780 return ip_vs_conn_array(seq, 0);
781
782 /* more on same hash chain? */
783 if ((e = cp->c_list.next) != l)
784 return list_entry(e, struct ip_vs_conn, c_list);
785
786 idx = l - ip_vs_conn_tab;
787 ct_read_unlock_bh(idx);
788
789 while (++idx < IP_VS_CONN_TAB_SIZE) {
790 ct_read_lock_bh(idx);
791 list_for_each_entry(cp, &ip_vs_conn_tab[idx], c_list) {
792 seq->private = &ip_vs_conn_tab[idx];
793 return cp;
YOSHIFUJI Hideakie905a9e2007-02-09 23:24:47 +0900794 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700795 ct_read_unlock_bh(idx);
796 }
797 seq->private = NULL;
798 return NULL;
799}
800
801static void ip_vs_conn_seq_stop(struct seq_file *seq, void *v)
802{
803 struct list_head *l = seq->private;
804
805 if (l)
806 ct_read_unlock_bh(l - ip_vs_conn_tab);
807}
808
809static int ip_vs_conn_seq_show(struct seq_file *seq, void *v)
810{
811
812 if (v == SEQ_START_TOKEN)
813 seq_puts(seq,
814 "Pro FromIP FPrt ToIP TPrt DestIP DPrt State Expires\n");
815 else {
816 const struct ip_vs_conn *cp = v;
817
818 seq_printf(seq,
819 "%-3s %08X %04X %08X %04X %08X %04X %-11s %7lu\n",
820 ip_vs_proto_name(cp->protocol),
Julius Volze7ade462008-09-02 15:55:33 +0200821 ntohl(cp->caddr.ip), ntohs(cp->cport),
822 ntohl(cp->vaddr.ip), ntohs(cp->vport),
823 ntohl(cp->daddr.ip), ntohs(cp->dport),
Linus Torvalds1da177e2005-04-16 15:20:36 -0700824 ip_vs_state_name(cp->protocol, cp->state),
825 (cp->timer.expires-jiffies)/HZ);
826 }
827 return 0;
828}
829
Philippe De Muyter56b3d972007-07-10 23:07:31 -0700830static const struct seq_operations ip_vs_conn_seq_ops = {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700831 .start = ip_vs_conn_seq_start,
832 .next = ip_vs_conn_seq_next,
833 .stop = ip_vs_conn_seq_stop,
834 .show = ip_vs_conn_seq_show,
835};
836
837static int ip_vs_conn_open(struct inode *inode, struct file *file)
838{
839 return seq_open(file, &ip_vs_conn_seq_ops);
840}
841
Arjan van de Ven9a321442007-02-12 00:55:35 -0800842static const struct file_operations ip_vs_conn_fops = {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700843 .owner = THIS_MODULE,
844 .open = ip_vs_conn_open,
845 .read = seq_read,
846 .llseek = seq_lseek,
847 .release = seq_release,
848};
Rumen G. Bogdanovski7a4fbb12007-11-19 21:52:42 -0800849
850static const char *ip_vs_origin_name(unsigned flags)
851{
852 if (flags & IP_VS_CONN_F_SYNC)
853 return "SYNC";
854 else
855 return "LOCAL";
856}
857
858static int ip_vs_conn_sync_seq_show(struct seq_file *seq, void *v)
859{
860
861 if (v == SEQ_START_TOKEN)
862 seq_puts(seq,
863 "Pro FromIP FPrt ToIP TPrt DestIP DPrt State Origin Expires\n");
864 else {
865 const struct ip_vs_conn *cp = v;
866
867 seq_printf(seq,
868 "%-3s %08X %04X %08X %04X %08X %04X %-11s %-6s %7lu\n",
869 ip_vs_proto_name(cp->protocol),
Julius Volze7ade462008-09-02 15:55:33 +0200870 ntohl(cp->caddr.ip), ntohs(cp->cport),
871 ntohl(cp->vaddr.ip), ntohs(cp->vport),
872 ntohl(cp->daddr.ip), ntohs(cp->dport),
Rumen G. Bogdanovski7a4fbb12007-11-19 21:52:42 -0800873 ip_vs_state_name(cp->protocol, cp->state),
874 ip_vs_origin_name(cp->flags),
875 (cp->timer.expires-jiffies)/HZ);
876 }
877 return 0;
878}
879
880static const struct seq_operations ip_vs_conn_sync_seq_ops = {
881 .start = ip_vs_conn_seq_start,
882 .next = ip_vs_conn_seq_next,
883 .stop = ip_vs_conn_seq_stop,
884 .show = ip_vs_conn_sync_seq_show,
885};
886
887static int ip_vs_conn_sync_open(struct inode *inode, struct file *file)
888{
889 return seq_open(file, &ip_vs_conn_sync_seq_ops);
890}
891
892static const struct file_operations ip_vs_conn_sync_fops = {
893 .owner = THIS_MODULE,
894 .open = ip_vs_conn_sync_open,
895 .read = seq_read,
896 .llseek = seq_lseek,
897 .release = seq_release,
898};
899
Linus Torvalds1da177e2005-04-16 15:20:36 -0700900#endif
901
902
903/*
904 * Randomly drop connection entries before running out of memory
905 */
906static inline int todrop_entry(struct ip_vs_conn *cp)
907{
908 /*
909 * The drop rate array needs tuning for real environments.
910 * Called from timer bh only => no locking
911 */
Arjan van de Ven9b5b5cf2005-11-29 16:21:38 -0800912 static const char todrop_rate[9] = {0, 1, 2, 3, 4, 5, 6, 7, 8};
Linus Torvalds1da177e2005-04-16 15:20:36 -0700913 static char todrop_counter[9] = {0};
914 int i;
915
916 /* if the conn entry hasn't lasted for 60 seconds, don't drop it.
917 This will leave enough time for normal connection to get
918 through. */
919 if (time_before(cp->timeout + jiffies, cp->timer.expires + 60*HZ))
920 return 0;
921
922 /* Don't drop the entry if its number of incoming packets is not
923 located in [0, 8] */
924 i = atomic_read(&cp->in_pkts);
925 if (i > 8 || i < 0) return 0;
926
927 if (!todrop_rate[i]) return 0;
928 if (--todrop_counter[i] > 0) return 0;
929
930 todrop_counter[i] = todrop_rate[i];
931 return 1;
932}
933
Julian Anastasovaf9debd2005-07-11 20:59:57 -0700934/* Called from keventd and must protect itself from softirqs */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700935void ip_vs_random_dropentry(void)
936{
937 int idx;
938 struct ip_vs_conn *cp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700939
940 /*
941 * Randomly scan 1/32 of the whole table every second
942 */
943 for (idx = 0; idx < (IP_VS_CONN_TAB_SIZE>>5); idx++) {
944 unsigned hash = net_random() & IP_VS_CONN_TAB_MASK;
945
946 /*
947 * Lock is actually needed in this loop.
948 */
Julian Anastasovaf9debd2005-07-11 20:59:57 -0700949 ct_write_lock_bh(hash);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700950
951 list_for_each_entry(cp, &ip_vs_conn_tab[hash], c_list) {
Julian Anastasov87375ab2005-09-14 21:08:51 -0700952 if (cp->flags & IP_VS_CONN_F_TEMPLATE)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700953 /* connection template */
954 continue;
955
956 if (cp->protocol == IPPROTO_TCP) {
957 switch(cp->state) {
958 case IP_VS_TCP_S_SYN_RECV:
959 case IP_VS_TCP_S_SYNACK:
960 break;
961
962 case IP_VS_TCP_S_ESTABLISHED:
963 if (todrop_entry(cp))
964 break;
965 continue;
966
967 default:
968 continue;
969 }
970 } else {
971 if (!todrop_entry(cp))
972 continue;
973 }
974
Linus Torvalds1da177e2005-04-16 15:20:36 -0700975 IP_VS_DBG(4, "del connection\n");
976 ip_vs_conn_expire_now(cp);
Neil Hormanfb3d8942005-06-28 15:40:02 -0700977 if (cp->control) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700978 IP_VS_DBG(4, "del conn template\n");
Neil Hormanfb3d8942005-06-28 15:40:02 -0700979 ip_vs_conn_expire_now(cp->control);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700980 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700981 }
Julian Anastasovaf9debd2005-07-11 20:59:57 -0700982 ct_write_unlock_bh(hash);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700983 }
984}
985
986
987/*
988 * Flush all the connection entries in the ip_vs_conn_tab
989 */
990static void ip_vs_conn_flush(void)
991{
992 int idx;
993 struct ip_vs_conn *cp;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700994
995 flush_again:
996 for (idx=0; idx<IP_VS_CONN_TAB_SIZE; idx++) {
997 /*
998 * Lock is actually needed in this loop.
999 */
1000 ct_write_lock_bh(idx);
1001
1002 list_for_each_entry(cp, &ip_vs_conn_tab[idx], c_list) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001003
Linus Torvalds1da177e2005-04-16 15:20:36 -07001004 IP_VS_DBG(4, "del connection\n");
1005 ip_vs_conn_expire_now(cp);
Neil Hormanfb3d8942005-06-28 15:40:02 -07001006 if (cp->control) {
Linus Torvalds1da177e2005-04-16 15:20:36 -07001007 IP_VS_DBG(4, "del conn template\n");
Neil Hormanfb3d8942005-06-28 15:40:02 -07001008 ip_vs_conn_expire_now(cp->control);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001009 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001010 }
1011 ct_write_unlock_bh(idx);
1012 }
1013
1014 /* the counter may be not NULL, because maybe some conn entries
1015 are run by slow timer handler or unhashed but still referred */
1016 if (atomic_read(&ip_vs_conn_count) != 0) {
1017 schedule();
1018 goto flush_again;
1019 }
1020}
1021
1022
Sven Wegener048cf482008-08-10 18:24:35 +00001023int __init ip_vs_conn_init(void)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001024{
1025 int idx;
1026
1027 /*
1028 * Allocate the connection hash table and initialize its list heads
1029 */
1030 ip_vs_conn_tab = vmalloc(IP_VS_CONN_TAB_SIZE*sizeof(struct list_head));
1031 if (!ip_vs_conn_tab)
1032 return -ENOMEM;
1033
1034 /* Allocate ip_vs_conn slab cache */
1035 ip_vs_conn_cachep = kmem_cache_create("ip_vs_conn",
1036 sizeof(struct ip_vs_conn), 0,
Paul Mundt20c2df82007-07-20 10:11:58 +09001037 SLAB_HWCACHE_ALIGN, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001038 if (!ip_vs_conn_cachep) {
1039 vfree(ip_vs_conn_tab);
1040 return -ENOMEM;
1041 }
1042
1043 IP_VS_INFO("Connection hash table configured "
1044 "(size=%d, memory=%ldKbytes)\n",
1045 IP_VS_CONN_TAB_SIZE,
1046 (long)(IP_VS_CONN_TAB_SIZE*sizeof(struct list_head))/1024);
1047 IP_VS_DBG(0, "Each connection entry needs %Zd bytes at least\n",
1048 sizeof(struct ip_vs_conn));
1049
1050 for (idx = 0; idx < IP_VS_CONN_TAB_SIZE; idx++) {
1051 INIT_LIST_HEAD(&ip_vs_conn_tab[idx]);
1052 }
1053
1054 for (idx = 0; idx < CT_LOCKARRAY_SIZE; idx++) {
1055 rwlock_init(&__ip_vs_conntbl_lock_array[idx].l);
1056 }
1057
Eric W. Biederman457c4cb2007-09-12 12:01:34 +02001058 proc_net_fops_create(&init_net, "ip_vs_conn", 0, &ip_vs_conn_fops);
Rumen G. Bogdanovski7a4fbb12007-11-19 21:52:42 -08001059 proc_net_fops_create(&init_net, "ip_vs_conn_sync", 0, &ip_vs_conn_sync_fops);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001060
1061 /* calculate the random value for connection hash */
1062 get_random_bytes(&ip_vs_conn_rnd, sizeof(ip_vs_conn_rnd));
1063
1064 return 0;
1065}
1066
1067
1068void ip_vs_conn_cleanup(void)
1069{
1070 /* flush all the connection entries first */
1071 ip_vs_conn_flush();
1072
1073 /* Release the empty cache */
1074 kmem_cache_destroy(ip_vs_conn_cachep);
Eric W. Biederman457c4cb2007-09-12 12:01:34 +02001075 proc_net_remove(&init_net, "ip_vs_conn");
Rumen G. Bogdanovski7a4fbb12007-11-19 21:52:42 -08001076 proc_net_remove(&init_net, "ip_vs_conn_sync");
Linus Torvalds1da177e2005-04-16 15:20:36 -07001077 vfree(ip_vs_conn_tab);
1078}