1 /* Cluster IP hashmark target
2 * (C) 2003-2004 by Harald Welte <laforge@netfilter.org>
3 * based on ideas of Fabio Olive Leite <olive@unixforge.org>
5 * Development of this code funded by SuSE Linux AG, http://www.suse.com/
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
12 #include <linux/module.h>
13 #include <linux/config.h>
14 #include <linux/proc_fs.h>
15 #include <linux/jhash.h>
16 #include <linux/bitops.h>
17 #include <linux/skbuff.h>
19 #include <linux/tcp.h>
20 #include <linux/udp.h>
21 #include <linux/icmp.h>
22 #include <linux/if_arp.h>
23 #include <linux/proc_fs.h>
24 #include <linux/seq_file.h>
26 #include <net/checksum.h>
28 #include <linux/netfilter_arp.h>
30 #include <linux/netfilter_ipv4/ip_tables.h>
31 #include <linux/netfilter_ipv4/ipt_CLUSTERIP.h>
32 #include <net/netfilter/nf_conntrack_compat.h>
34 #define CLUSTERIP_VERSION "0.8"
36 #define DEBUG_CLUSTERIP
38 #ifdef DEBUG_CLUSTERIP
44 #define ASSERT_READ_LOCK(x)
46 MODULE_LICENSE("GPL");
47 MODULE_AUTHOR("Harald Welte <laforge@netfilter.org>");
48 MODULE_DESCRIPTION("iptables target for CLUSTERIP");
50 struct clusterip_config {
51 struct list_head list; /* list of all configs */
52 atomic_t refcount; /* reference count */
53 atomic_t entries; /* number of entries/rules
56 u_int32_t clusterip; /* the IP address */
57 u_int8_t clustermac[ETH_ALEN]; /* the MAC address */
58 struct net_device *dev; /* device */
59 u_int16_t num_total_nodes; /* total number of nodes */
60 unsigned long local_nodes; /* node number array */
63 struct proc_dir_entry *pde; /* proc dir entry */
65 enum clusterip_hashmode hash_mode; /* which hashing mode */
66 u_int32_t hash_initval; /* hash initialization */
69 static LIST_HEAD(clusterip_configs);
71 /* clusterip_lock protects the clusterip_configs list */
72 static DEFINE_RWLOCK(clusterip_lock);
75 static struct file_operations clusterip_proc_fops;
76 static struct proc_dir_entry *clusterip_procdir;
80 clusterip_config_get(struct clusterip_config *c)
82 atomic_inc(&c->refcount);
86 clusterip_config_put(struct clusterip_config *c)
88 if (atomic_dec_and_test(&c->refcount))
92 /* increase the count of entries(rules) using/referencing this config */
94 clusterip_config_entry_get(struct clusterip_config *c)
96 atomic_inc(&c->entries);
99 /* decrease the count of entries using/referencing this config. If last
100 * entry(rule) is removed, remove the config from lists, but don't free it
101 * yet, since proc-files could still be holding references */
103 clusterip_config_entry_put(struct clusterip_config *c)
105 if (atomic_dec_and_test(&c->entries)) {
106 write_lock_bh(&clusterip_lock);
108 write_unlock_bh(&clusterip_lock);
110 dev_mc_delete(c->dev, c->clustermac, ETH_ALEN, 0);
113 /* In case anyone still accesses the file, the open/close
114 * functions are also incrementing the refcount on their own,
115 * so it's safe to remove the entry even if it's in use. */
116 #ifdef CONFIG_PROC_FS
117 remove_proc_entry(c->pde->name, c->pde->parent);
122 static struct clusterip_config *
123 __clusterip_config_find(u_int32_t clusterip)
125 struct list_head *pos;
127 ASSERT_READ_LOCK(&clusterip_lock);
128 list_for_each(pos, &clusterip_configs) {
129 struct clusterip_config *c = list_entry(pos,
130 struct clusterip_config, list);
131 if (c->clusterip == clusterip) {
139 static inline struct clusterip_config *
140 clusterip_config_find_get(u_int32_t clusterip, int entry)
142 struct clusterip_config *c;
144 read_lock_bh(&clusterip_lock);
145 c = __clusterip_config_find(clusterip);
147 read_unlock_bh(&clusterip_lock);
150 atomic_inc(&c->refcount);
152 atomic_inc(&c->entries);
153 read_unlock_bh(&clusterip_lock);
159 clusterip_config_init_nodelist(struct clusterip_config *c,
160 const struct ipt_clusterip_tgt_info *i)
164 for (n = 0; n < i->num_local_nodes; n++) {
165 set_bit(i->local_nodes[n] - 1, &c->local_nodes);
169 static struct clusterip_config *
170 clusterip_config_init(struct ipt_clusterip_tgt_info *i, u_int32_t ip,
171 struct net_device *dev)
173 struct clusterip_config *c;
176 c = kmalloc(sizeof(*c), GFP_ATOMIC);
180 memset(c, 0, sizeof(*c));
183 memcpy(&c->clustermac, &i->clustermac, ETH_ALEN);
184 c->num_total_nodes = i->num_total_nodes;
185 clusterip_config_init_nodelist(c, i);
186 c->hash_mode = i->hash_mode;
187 c->hash_initval = i->hash_initval;
188 atomic_set(&c->refcount, 1);
189 atomic_set(&c->entries, 1);
191 #ifdef CONFIG_PROC_FS
192 /* create proc dir entry */
193 sprintf(buffer, "%u.%u.%u.%u", NIPQUAD(ip));
194 c->pde = create_proc_entry(buffer, S_IWUSR|S_IRUSR, clusterip_procdir);
199 c->pde->proc_fops = &clusterip_proc_fops;
203 write_lock_bh(&clusterip_lock);
204 list_add(&c->list, &clusterip_configs);
205 write_unlock_bh(&clusterip_lock);
211 clusterip_add_node(struct clusterip_config *c, u_int16_t nodenum)
215 nodenum > c->num_total_nodes)
218 /* check if we already have this number in our bitfield */
219 if (test_and_set_bit(nodenum - 1, &c->local_nodes))
226 clusterip_del_node(struct clusterip_config *c, u_int16_t nodenum)
229 nodenum > c->num_total_nodes)
232 if (test_and_clear_bit(nodenum - 1, &c->local_nodes))
238 static inline u_int32_t
239 clusterip_hashfn(struct sk_buff *skb, struct clusterip_config *config)
241 struct iphdr *iph = skb->nh.iph;
242 unsigned long hashval;
243 u_int16_t sport, dport;
248 switch (iph->protocol) {
250 th = (void *)iph+iph->ihl*4;
251 sport = ntohs(th->source);
252 dport = ntohs(th->dest);
255 uh = (void *)iph+iph->ihl*4;
256 sport = ntohs(uh->source);
257 dport = ntohs(uh->dest);
260 ih = (void *)iph+iph->ihl*4;
261 sport = ntohs(ih->un.echo.id);
262 dport = (ih->type<<8)|ih->code;
265 if (net_ratelimit()) {
266 printk(KERN_NOTICE "CLUSTERIP: unknown protocol `%u'\n",
272 switch (config->hash_mode) {
273 case CLUSTERIP_HASHMODE_SIP:
274 hashval = jhash_1word(ntohl(iph->saddr),
275 config->hash_initval);
277 case CLUSTERIP_HASHMODE_SIP_SPT:
278 hashval = jhash_2words(ntohl(iph->saddr), sport,
279 config->hash_initval);
281 case CLUSTERIP_HASHMODE_SIP_SPT_DPT:
282 hashval = jhash_3words(ntohl(iph->saddr), sport, dport,
283 config->hash_initval);
286 /* to make gcc happy */
288 /* This cannot happen, unless the check function wasn't called
289 * at rule load time */
290 printk("CLUSTERIP: unknown mode `%u'\n", config->hash_mode);
295 /* node numbers are 1..n, not 0..n */
296 return ((hashval % config->num_total_nodes)+1);
300 clusterip_responsible(struct clusterip_config *config, u_int32_t hash)
302 return test_bit(hash - 1, &config->local_nodes);
305 /***********************************************************************
307 ***********************************************************************/
310 target(struct sk_buff **pskb,
311 const struct net_device *in,
312 const struct net_device *out,
313 unsigned int hooknum,
314 const void *targinfo,
317 const struct ipt_clusterip_tgt_info *cipinfo = targinfo;
318 enum ip_conntrack_info ctinfo;
319 u_int32_t *mark, hash;
321 /* don't need to clusterip_config_get() here, since refcount
322 * is only decremented by destroy() - and ip_tables guarantees
323 * that the ->target() function isn't called after ->destroy() */
325 mark = nf_ct_get_mark((*pskb), &ctinfo);
327 printk(KERN_ERR "CLUSTERIP: no conntrack!\n");
328 /* FIXME: need to drop invalid ones, since replies
329 * to outgoing connections of other nodes will be
330 * marked as INVALID */
334 /* special case: ICMP error handling. conntrack distinguishes between
335 * error messages (RELATED) and information requests (see below) */
336 if ((*pskb)->nh.iph->protocol == IPPROTO_ICMP
337 && (ctinfo == IP_CT_RELATED
338 || ctinfo == IP_CT_RELATED+IP_CT_IS_REPLY))
341 /* ip_conntrack_icmp guarantees us that we only have ICMP_ECHO,
342 * TIMESTAMP, INFO_REQUEST or ADDRESS type icmp packets from here
343 * on, which all have an ID field [relevant for hashing]. */
345 hash = clusterip_hashfn(*pskb, cipinfo->config);
352 case IP_CT_RELATED+IP_CT_IS_REPLY:
353 /* FIXME: we don't handle expectations at the
354 * moment. they can arrive on a different node than
355 * the master connection (e.g. FTP passive mode) */
356 case IP_CT_ESTABLISHED:
357 case IP_CT_ESTABLISHED+IP_CT_IS_REPLY:
363 #ifdef DEBUG_CLUSTERP
364 DUMP_TUPLE(&ct->tuplehash[IP_CT_DIR_ORIGINAL].tuple);
366 DEBUGP("hash=%u ct_hash=%u ", hash, *mark);
367 if (!clusterip_responsible(cipinfo->config, hash)) {
368 DEBUGP("not responsible\n");
371 DEBUGP("responsible\n");
373 /* despite being received via linklayer multicast, this is
374 * actually a unicast IP packet. TCP doesn't like PACKET_MULTICAST */
375 (*pskb)->pkt_type = PACKET_HOST;
381 checkentry(const char *tablename,
384 unsigned int targinfosize,
385 unsigned int hook_mask)
387 struct ipt_clusterip_tgt_info *cipinfo = targinfo;
388 const struct ipt_entry *e = e_void;
390 struct clusterip_config *config;
392 if (targinfosize != IPT_ALIGN(sizeof(struct ipt_clusterip_tgt_info))) {
393 printk(KERN_WARNING "CLUSTERIP: targinfosize %u != %Zu\n",
395 IPT_ALIGN(sizeof(struct ipt_clusterip_tgt_info)));
399 if (cipinfo->hash_mode != CLUSTERIP_HASHMODE_SIP &&
400 cipinfo->hash_mode != CLUSTERIP_HASHMODE_SIP_SPT &&
401 cipinfo->hash_mode != CLUSTERIP_HASHMODE_SIP_SPT_DPT) {
402 printk(KERN_WARNING "CLUSTERIP: unknown mode `%u'\n",
407 if (e->ip.dmsk.s_addr != 0xffffffff
408 || e->ip.dst.s_addr == 0) {
409 printk(KERN_ERR "CLUSTERIP: Please specify destination IP\n");
413 /* FIXME: further sanity checks */
415 config = clusterip_config_find_get(e->ip.dst.s_addr, 1);
417 if (cipinfo->config != NULL) {
418 /* Case A: This is an entry that gets reloaded, since
419 * it still has a cipinfo->config pointer. Simply
420 * increase the entry refcount and return */
421 if (cipinfo->config != config) {
422 printk(KERN_ERR "CLUSTERIP: Reloaded entry "
423 "has invalid config pointer!\n");
426 clusterip_config_entry_get(cipinfo->config);
428 /* Case B: This is a new rule referring to an existing
429 * clusterip config. */
430 cipinfo->config = config;
431 clusterip_config_entry_get(cipinfo->config);
434 /* Case C: This is a completely new clusterip config */
435 if (!(cipinfo->flags & CLUSTERIP_FLAG_NEW)) {
436 printk(KERN_WARNING "CLUSTERIP: no config found for %u.%u.%u.%u, need 'new'\n", NIPQUAD(e->ip.dst.s_addr));
439 struct net_device *dev;
441 if (e->ip.iniface[0] == '\0') {
442 printk(KERN_WARNING "CLUSTERIP: Please specify an interface name\n");
446 dev = dev_get_by_name(e->ip.iniface);
448 printk(KERN_WARNING "CLUSTERIP: no such interface %s\n", e->ip.iniface);
452 config = clusterip_config_init(cipinfo,
453 e->ip.dst.s_addr, dev);
455 printk(KERN_WARNING "CLUSTERIP: cannot allocate config\n");
459 dev_mc_add(config->dev,config->clustermac, ETH_ALEN, 0);
461 cipinfo->config = config;
467 /* drop reference count of cluster config when rule is deleted */
468 static void destroy(void *matchinfo, unsigned int matchinfosize)
470 struct ipt_clusterip_tgt_info *cipinfo = matchinfo;
472 /* if no more entries are referencing the config, remove it
473 * from the list and destroy the proc entry */
474 clusterip_config_entry_put(cipinfo->config);
476 clusterip_config_put(cipinfo->config);
479 static struct ipt_target clusterip_tgt = {
482 .checkentry = &checkentry,
488 /***********************************************************************
490 ***********************************************************************/
492 /* hardcoded for 48bit ethernet and 32bit ipv4 addresses */
494 u_int8_t src_hw[ETH_ALEN];
496 u_int8_t dst_hw[ETH_ALEN];
498 } __attribute__ ((packed));
500 #ifdef CLUSTERIP_DEBUG
501 static void arp_print(struct arp_payload *payload)
503 #define HBUFFERLEN 30
504 char hbuffer[HBUFFERLEN];
506 const char hexbuf[]= "0123456789abcdef";
508 for (k=0, j=0; k < HBUFFERLEN-3 && j < ETH_ALEN; j++) {
509 hbuffer[k++]=hexbuf[(payload->src_hw[j]>>4)&15];
510 hbuffer[k++]=hexbuf[payload->src_hw[j]&15];
515 printk("src %u.%u.%u.%u@%s, dst %u.%u.%u.%u\n",
516 NIPQUAD(payload->src_ip), hbuffer,
517 NIPQUAD(payload->dst_ip));
522 arp_mangle(unsigned int hook,
523 struct sk_buff **pskb,
524 const struct net_device *in,
525 const struct net_device *out,
526 int (*okfn)(struct sk_buff *))
528 struct arphdr *arp = (*pskb)->nh.arph;
529 struct arp_payload *payload;
530 struct clusterip_config *c;
532 /* we don't care about non-ethernet and non-ipv4 ARP */
533 if (arp->ar_hrd != htons(ARPHRD_ETHER)
534 || arp->ar_pro != htons(ETH_P_IP)
535 || arp->ar_pln != 4 || arp->ar_hln != ETH_ALEN)
538 /* we only want to mangle arp requests and replies */
539 if (arp->ar_op != htons(ARPOP_REPLY)
540 && arp->ar_op != htons(ARPOP_REQUEST))
543 payload = (void *)(arp+1);
545 /* if there is no clusterip configuration for the arp reply's
546 * source ip, we don't want to mangle it */
547 c = clusterip_config_find_get(payload->src_ip, 0);
551 /* normally the linux kernel always replies to arp queries of
552 * addresses on different interfacs. However, in the CLUSTERIP case
553 * this wouldn't work, since we didn't subscribe the mcast group on
554 * other interfaces */
556 DEBUGP("CLUSTERIP: not mangling arp reply on different "
557 "interface: cip'%s'-skb'%s'\n", c->dev->name, out->name);
558 clusterip_config_put(c);
562 /* mangle reply hardware address */
563 memcpy(payload->src_hw, c->clustermac, arp->ar_hln);
565 #ifdef CLUSTERIP_DEBUG
566 DEBUGP(KERN_DEBUG "CLUSTERIP mangled arp reply: ");
570 clusterip_config_put(c);
575 static struct nf_hook_ops cip_arp_ops = {
578 .hooknum = NF_ARP_OUT,
582 /***********************************************************************
584 ***********************************************************************/
586 #ifdef CONFIG_PROC_FS
588 struct clusterip_seq_position {
589 unsigned int pos; /* position */
590 unsigned int weight; /* number of bits set == size */
591 unsigned int bit; /* current bit */
592 unsigned long val; /* current value */
595 static void *clusterip_seq_start(struct seq_file *s, loff_t *pos)
597 struct proc_dir_entry *pde = s->private;
598 struct clusterip_config *c = pde->data;
600 u_int32_t local_nodes;
601 struct clusterip_seq_position *idx;
603 /* FIXME: possible race */
604 local_nodes = c->local_nodes;
605 weight = hweight32(local_nodes);
609 idx = kmalloc(sizeof(struct clusterip_seq_position), GFP_KERNEL);
611 return ERR_PTR(-ENOMEM);
614 idx->weight = weight;
615 idx->bit = ffs(local_nodes);
616 idx->val = local_nodes;
617 clear_bit(idx->bit - 1, &idx->val);
622 static void *clusterip_seq_next(struct seq_file *s, void *v, loff_t *pos)
624 struct clusterip_seq_position *idx = (struct clusterip_seq_position *)v;
627 if (*pos >= idx->weight) {
631 idx->bit = ffs(idx->val);
632 clear_bit(idx->bit - 1, &idx->val);
636 static void clusterip_seq_stop(struct seq_file *s, void *v)
641 static int clusterip_seq_show(struct seq_file *s, void *v)
643 struct clusterip_seq_position *idx = (struct clusterip_seq_position *)v;
648 seq_printf(s, "%u", idx->bit);
650 if (idx->pos == idx->weight - 1)
656 static struct seq_operations clusterip_seq_ops = {
657 .start = clusterip_seq_start,
658 .next = clusterip_seq_next,
659 .stop = clusterip_seq_stop,
660 .show = clusterip_seq_show,
663 static int clusterip_proc_open(struct inode *inode, struct file *file)
665 int ret = seq_open(file, &clusterip_seq_ops);
668 struct seq_file *sf = file->private_data;
669 struct proc_dir_entry *pde = PDE(inode);
670 struct clusterip_config *c = pde->data;
674 clusterip_config_get(c);
680 static int clusterip_proc_release(struct inode *inode, struct file *file)
682 struct proc_dir_entry *pde = PDE(inode);
683 struct clusterip_config *c = pde->data;
686 ret = seq_release(inode, file);
689 clusterip_config_put(c);
694 static ssize_t clusterip_proc_write(struct file *file, const char __user *input,
695 size_t size, loff_t *ofs)
697 #define PROC_WRITELEN 10
698 char buffer[PROC_WRITELEN+1];
699 struct proc_dir_entry *pde = PDE(file->f_dentry->d_inode);
700 struct clusterip_config *c = pde->data;
701 unsigned long nodenum;
703 if (copy_from_user(buffer, input, PROC_WRITELEN))
706 if (*buffer == '+') {
707 nodenum = simple_strtoul(buffer+1, NULL, 10);
708 if (clusterip_add_node(c, nodenum))
710 } else if (*buffer == '-') {
711 nodenum = simple_strtoul(buffer+1, NULL,10);
712 if (clusterip_del_node(c, nodenum))
720 static struct file_operations clusterip_proc_fops = {
721 .owner = THIS_MODULE,
722 .open = clusterip_proc_open,
724 .write = clusterip_proc_write,
726 .release = clusterip_proc_release,
729 #endif /* CONFIG_PROC_FS */
731 static int init_or_cleanup(int fini)
738 if (ipt_register_target(&clusterip_tgt)) {
743 if (nf_register_hook(&cip_arp_ops) < 0) {
748 #ifdef CONFIG_PROC_FS
749 clusterip_procdir = proc_mkdir("ipt_CLUSTERIP", proc_net);
750 if (!clusterip_procdir) {
751 printk(KERN_ERR "CLUSTERIP: Unable to proc dir entry\n");
755 #endif /* CONFIG_PROC_FS */
757 printk(KERN_NOTICE "ClusterIP Version %s loaded successfully\n",
763 printk(KERN_NOTICE "ClusterIP Version %s unloading\n",
765 #ifdef CONFIG_PROC_FS
766 remove_proc_entry(clusterip_procdir->name, clusterip_procdir->parent);
769 nf_unregister_hook(&cip_arp_ops);
771 ipt_unregister_target(&clusterip_tgt);
776 static int __init init(void)
778 return init_or_cleanup(0);
781 static void __exit fini(void)