pci-acpi: add flag to indicate query had been done
[linux-2.6/mini2440.git] / net / sctp / protocol.c
blobb435a193c5df916cd8d4ff7d0412167d17f5c99d
1 /* SCTP kernel implementation
2 * (C) Copyright IBM Corp. 2001, 2004
3 * Copyright (c) 1999-2000 Cisco, Inc.
4 * Copyright (c) 1999-2001 Motorola, Inc.
5 * Copyright (c) 2001 Intel Corp.
6 * Copyright (c) 2001 Nokia, Inc.
7 * Copyright (c) 2001 La Monte H.P. Yarroll
9 * This file is part of the SCTP kernel implementation
11 * Initialization/cleanup for SCTP protocol support.
13 * This SCTP implementation is free software;
14 * you can redistribute it and/or modify it under the terms of
15 * the GNU General Public License as published by
16 * the Free Software Foundation; either version 2, or (at your option)
17 * any later version.
19 * This SCTP implementation is distributed in the hope that it
20 * will be useful, but WITHOUT ANY WARRANTY; without even the implied
21 * ************************
22 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
23 * See the GNU General Public License for more details.
25 * You should have received a copy of the GNU General Public License
26 * along with GNU CC; see the file COPYING. If not, write to
27 * the Free Software Foundation, 59 Temple Place - Suite 330,
28 * Boston, MA 02111-1307, USA.
30 * Please send any bug reports or fixes you make to the
31 * email address(es):
32 * lksctp developers <lksctp-developers@lists.sourceforge.net>
34 * Or submit a bug report through the following website:
35 * http://www.sf.net/projects/lksctp
37 * Written or modified by:
38 * La Monte H.P. Yarroll <piggy@acm.org>
39 * Karl Knutson <karl@athena.chicago.il.us>
40 * Jon Grimm <jgrimm@us.ibm.com>
41 * Sridhar Samudrala <sri@us.ibm.com>
42 * Daisy Chang <daisyc@us.ibm.com>
43 * Ardelle Fan <ardelle.fan@intel.com>
45 * Any bugs reported given to us we will try to fix... any fixes shared will
46 * be incorporated into the next SCTP release.
49 #include <linux/module.h>
50 #include <linux/init.h>
51 #include <linux/netdevice.h>
52 #include <linux/inetdevice.h>
53 #include <linux/seq_file.h>
54 #include <linux/bootmem.h>
55 #include <net/net_namespace.h>
56 #include <net/protocol.h>
57 #include <net/ip.h>
58 #include <net/ipv6.h>
59 #include <net/route.h>
60 #include <net/sctp/sctp.h>
61 #include <net/addrconf.h>
62 #include <net/inet_common.h>
63 #include <net/inet_ecn.h>
65 /* Global data structures. */
66 struct sctp_globals sctp_globals __read_mostly;
67 struct proc_dir_entry *proc_net_sctp;
68 DEFINE_SNMP_STAT(struct sctp_mib, sctp_statistics) __read_mostly;
70 struct idr sctp_assocs_id;
71 DEFINE_SPINLOCK(sctp_assocs_id_lock);
73 /* This is the global socket data structure used for responding to
74 * the Out-of-the-blue (OOTB) packets. A control sock will be created
75 * for this socket at the initialization time.
77 static struct sock *sctp_ctl_sock;
79 static struct sctp_pf *sctp_pf_inet6_specific;
80 static struct sctp_pf *sctp_pf_inet_specific;
81 static struct sctp_af *sctp_af_v4_specific;
82 static struct sctp_af *sctp_af_v6_specific;
84 struct kmem_cache *sctp_chunk_cachep __read_mostly;
85 struct kmem_cache *sctp_bucket_cachep __read_mostly;
87 int sysctl_sctp_mem[3];
88 int sysctl_sctp_rmem[3];
89 int sysctl_sctp_wmem[3];
91 /* Return the address of the control sock. */
92 struct sock *sctp_get_ctl_sock(void)
94 return sctp_ctl_sock;
97 /* Set up the proc fs entry for the SCTP protocol. */
98 static __init int sctp_proc_init(void)
100 if (!proc_net_sctp) {
101 struct proc_dir_entry *ent;
102 ent = proc_mkdir("sctp", init_net.proc_net);
103 if (ent) {
104 ent->owner = THIS_MODULE;
105 proc_net_sctp = ent;
106 } else
107 goto out_nomem;
110 if (sctp_snmp_proc_init())
111 goto out_nomem;
112 if (sctp_eps_proc_init())
113 goto out_nomem;
114 if (sctp_assocs_proc_init())
115 goto out_nomem;
117 return 0;
119 out_nomem:
120 return -ENOMEM;
123 /* Clean up the proc fs entry for the SCTP protocol.
124 * Note: Do not make this __exit as it is used in the init error
125 * path.
127 static void sctp_proc_exit(void)
129 sctp_snmp_proc_exit();
130 sctp_eps_proc_exit();
131 sctp_assocs_proc_exit();
133 if (proc_net_sctp) {
134 proc_net_sctp = NULL;
135 remove_proc_entry("sctp", init_net.proc_net);
139 /* Private helper to extract ipv4 address and stash them in
140 * the protocol structure.
142 static void sctp_v4_copy_addrlist(struct list_head *addrlist,
143 struct net_device *dev)
145 struct in_device *in_dev;
146 struct in_ifaddr *ifa;
147 struct sctp_sockaddr_entry *addr;
149 rcu_read_lock();
150 if ((in_dev = __in_dev_get_rcu(dev)) == NULL) {
151 rcu_read_unlock();
152 return;
155 for (ifa = in_dev->ifa_list; ifa; ifa = ifa->ifa_next) {
156 /* Add the address to the local list. */
157 addr = t_new(struct sctp_sockaddr_entry, GFP_ATOMIC);
158 if (addr) {
159 addr->a.v4.sin_family = AF_INET;
160 addr->a.v4.sin_port = 0;
161 addr->a.v4.sin_addr.s_addr = ifa->ifa_local;
162 addr->valid = 1;
163 INIT_LIST_HEAD(&addr->list);
164 INIT_RCU_HEAD(&addr->rcu);
165 list_add_tail(&addr->list, addrlist);
169 rcu_read_unlock();
172 /* Extract our IP addresses from the system and stash them in the
173 * protocol structure.
175 static void sctp_get_local_addr_list(void)
177 struct net_device *dev;
178 struct list_head *pos;
179 struct sctp_af *af;
181 read_lock(&dev_base_lock);
182 for_each_netdev(&init_net, dev) {
183 __list_for_each(pos, &sctp_address_families) {
184 af = list_entry(pos, struct sctp_af, list);
185 af->copy_addrlist(&sctp_local_addr_list, dev);
188 read_unlock(&dev_base_lock);
191 /* Free the existing local addresses. */
192 static void sctp_free_local_addr_list(void)
194 struct sctp_sockaddr_entry *addr;
195 struct list_head *pos, *temp;
197 list_for_each_safe(pos, temp, &sctp_local_addr_list) {
198 addr = list_entry(pos, struct sctp_sockaddr_entry, list);
199 list_del(pos);
200 kfree(addr);
204 void sctp_local_addr_free(struct rcu_head *head)
206 struct sctp_sockaddr_entry *e = container_of(head,
207 struct sctp_sockaddr_entry, rcu);
208 kfree(e);
211 /* Copy the local addresses which are valid for 'scope' into 'bp'. */
212 int sctp_copy_local_addr_list(struct sctp_bind_addr *bp, sctp_scope_t scope,
213 gfp_t gfp, int copy_flags)
215 struct sctp_sockaddr_entry *addr;
216 int error = 0;
218 rcu_read_lock();
219 list_for_each_entry_rcu(addr, &sctp_local_addr_list, list) {
220 if (!addr->valid)
221 continue;
222 if (sctp_in_scope(&addr->a, scope)) {
223 /* Now that the address is in scope, check to see if
224 * the address type is really supported by the local
225 * sock as well as the remote peer.
227 if ((((AF_INET == addr->a.sa.sa_family) &&
228 (copy_flags & SCTP_ADDR4_PEERSUPP))) ||
229 (((AF_INET6 == addr->a.sa.sa_family) &&
230 (copy_flags & SCTP_ADDR6_ALLOWED) &&
231 (copy_flags & SCTP_ADDR6_PEERSUPP)))) {
232 error = sctp_add_bind_addr(bp, &addr->a,
233 SCTP_ADDR_SRC, GFP_ATOMIC);
234 if (error)
235 goto end_copy;
240 end_copy:
241 rcu_read_unlock();
242 return error;
245 /* Initialize a sctp_addr from in incoming skb. */
246 static void sctp_v4_from_skb(union sctp_addr *addr, struct sk_buff *skb,
247 int is_saddr)
249 void *from;
250 __be16 *port;
251 struct sctphdr *sh;
253 port = &addr->v4.sin_port;
254 addr->v4.sin_family = AF_INET;
256 sh = sctp_hdr(skb);
257 if (is_saddr) {
258 *port = sh->source;
259 from = &ip_hdr(skb)->saddr;
260 } else {
261 *port = sh->dest;
262 from = &ip_hdr(skb)->daddr;
264 memcpy(&addr->v4.sin_addr.s_addr, from, sizeof(struct in_addr));
267 /* Initialize an sctp_addr from a socket. */
268 static void sctp_v4_from_sk(union sctp_addr *addr, struct sock *sk)
270 addr->v4.sin_family = AF_INET;
271 addr->v4.sin_port = 0;
272 addr->v4.sin_addr.s_addr = inet_sk(sk)->rcv_saddr;
275 /* Initialize sk->sk_rcv_saddr from sctp_addr. */
276 static void sctp_v4_to_sk_saddr(union sctp_addr *addr, struct sock *sk)
278 inet_sk(sk)->rcv_saddr = addr->v4.sin_addr.s_addr;
281 /* Initialize sk->sk_daddr from sctp_addr. */
282 static void sctp_v4_to_sk_daddr(union sctp_addr *addr, struct sock *sk)
284 inet_sk(sk)->daddr = addr->v4.sin_addr.s_addr;
287 /* Initialize a sctp_addr from an address parameter. */
288 static void sctp_v4_from_addr_param(union sctp_addr *addr,
289 union sctp_addr_param *param,
290 __be16 port, int iif)
292 addr->v4.sin_family = AF_INET;
293 addr->v4.sin_port = port;
294 addr->v4.sin_addr.s_addr = param->v4.addr.s_addr;
297 /* Initialize an address parameter from a sctp_addr and return the length
298 * of the address parameter.
300 static int sctp_v4_to_addr_param(const union sctp_addr *addr,
301 union sctp_addr_param *param)
303 int length = sizeof(sctp_ipv4addr_param_t);
305 param->v4.param_hdr.type = SCTP_PARAM_IPV4_ADDRESS;
306 param->v4.param_hdr.length = htons(length);
307 param->v4.addr.s_addr = addr->v4.sin_addr.s_addr;
309 return length;
312 /* Initialize a sctp_addr from a dst_entry. */
313 static void sctp_v4_dst_saddr(union sctp_addr *saddr, struct dst_entry *dst,
314 __be16 port)
316 struct rtable *rt = (struct rtable *)dst;
317 saddr->v4.sin_family = AF_INET;
318 saddr->v4.sin_port = port;
319 saddr->v4.sin_addr.s_addr = rt->rt_src;
322 /* Compare two addresses exactly. */
323 static int sctp_v4_cmp_addr(const union sctp_addr *addr1,
324 const union sctp_addr *addr2)
326 if (addr1->sa.sa_family != addr2->sa.sa_family)
327 return 0;
328 if (addr1->v4.sin_port != addr2->v4.sin_port)
329 return 0;
330 if (addr1->v4.sin_addr.s_addr != addr2->v4.sin_addr.s_addr)
331 return 0;
333 return 1;
336 /* Initialize addr struct to INADDR_ANY. */
337 static void sctp_v4_inaddr_any(union sctp_addr *addr, __be16 port)
339 addr->v4.sin_family = AF_INET;
340 addr->v4.sin_addr.s_addr = htonl(INADDR_ANY);
341 addr->v4.sin_port = port;
344 /* Is this a wildcard address? */
345 static int sctp_v4_is_any(const union sctp_addr *addr)
347 return htonl(INADDR_ANY) == addr->v4.sin_addr.s_addr;
350 /* This function checks if the address is a valid address to be used for
351 * SCTP binding.
353 * Output:
354 * Return 0 - If the address is a non-unicast or an illegal address.
355 * Return 1 - If the address is a unicast.
357 static int sctp_v4_addr_valid(union sctp_addr *addr,
358 struct sctp_sock *sp,
359 const struct sk_buff *skb)
361 /* Is this a non-unicast address or a unusable SCTP address? */
362 if (IS_IPV4_UNUSABLE_ADDRESS(addr->v4.sin_addr.s_addr))
363 return 0;
365 /* Is this a broadcast address? */
366 if (skb && skb->rtable->rt_flags & RTCF_BROADCAST)
367 return 0;
369 return 1;
372 /* Should this be available for binding? */
373 static int sctp_v4_available(union sctp_addr *addr, struct sctp_sock *sp)
375 int ret = inet_addr_type(&init_net, addr->v4.sin_addr.s_addr);
378 if (addr->v4.sin_addr.s_addr != htonl(INADDR_ANY) &&
379 ret != RTN_LOCAL &&
380 !sp->inet.freebind &&
381 !sysctl_ip_nonlocal_bind)
382 return 0;
384 return 1;
387 /* Checking the loopback, private and other address scopes as defined in
388 * RFC 1918. The IPv4 scoping is based on the draft for SCTP IPv4
389 * scoping <draft-stewart-tsvwg-sctp-ipv4-00.txt>.
391 * Level 0 - unusable SCTP addresses
392 * Level 1 - loopback address
393 * Level 2 - link-local addresses
394 * Level 3 - private addresses.
395 * Level 4 - global addresses
396 * For INIT and INIT-ACK address list, let L be the level of
397 * of requested destination address, sender and receiver
398 * SHOULD include all of its addresses with level greater
399 * than or equal to L.
401 static sctp_scope_t sctp_v4_scope(union sctp_addr *addr)
403 sctp_scope_t retval;
405 /* Should IPv4 scoping be a sysctl configurable option
406 * so users can turn it off (default on) for certain
407 * unconventional networking environments?
410 /* Check for unusable SCTP addresses. */
411 if (IS_IPV4_UNUSABLE_ADDRESS(addr->v4.sin_addr.s_addr)) {
412 retval = SCTP_SCOPE_UNUSABLE;
413 } else if (ipv4_is_loopback(addr->v4.sin_addr.s_addr)) {
414 retval = SCTP_SCOPE_LOOPBACK;
415 } else if (ipv4_is_linklocal_169(addr->v4.sin_addr.s_addr)) {
416 retval = SCTP_SCOPE_LINK;
417 } else if (ipv4_is_private_10(addr->v4.sin_addr.s_addr) ||
418 ipv4_is_private_172(addr->v4.sin_addr.s_addr) ||
419 ipv4_is_private_192(addr->v4.sin_addr.s_addr)) {
420 retval = SCTP_SCOPE_PRIVATE;
421 } else {
422 retval = SCTP_SCOPE_GLOBAL;
425 return retval;
428 /* Returns a valid dst cache entry for the given source and destination ip
429 * addresses. If an association is passed, trys to get a dst entry with a
430 * source address that matches an address in the bind address list.
432 static struct dst_entry *sctp_v4_get_dst(struct sctp_association *asoc,
433 union sctp_addr *daddr,
434 union sctp_addr *saddr)
436 struct rtable *rt;
437 struct flowi fl;
438 struct sctp_bind_addr *bp;
439 struct sctp_sockaddr_entry *laddr;
440 struct dst_entry *dst = NULL;
441 union sctp_addr dst_saddr;
443 memset(&fl, 0x0, sizeof(struct flowi));
444 fl.fl4_dst = daddr->v4.sin_addr.s_addr;
445 fl.proto = IPPROTO_SCTP;
446 if (asoc) {
447 fl.fl4_tos = RT_CONN_FLAGS(asoc->base.sk);
448 fl.oif = asoc->base.sk->sk_bound_dev_if;
450 if (saddr)
451 fl.fl4_src = saddr->v4.sin_addr.s_addr;
453 SCTP_DEBUG_PRINTK("%s: DST:%u.%u.%u.%u, SRC:%u.%u.%u.%u - ",
454 __func__, NIPQUAD(fl.fl4_dst),
455 NIPQUAD(fl.fl4_src));
457 if (!ip_route_output_key(&init_net, &rt, &fl)) {
458 dst = &rt->u.dst;
461 /* If there is no association or if a source address is passed, no
462 * more validation is required.
464 if (!asoc || saddr)
465 goto out;
467 bp = &asoc->base.bind_addr;
469 if (dst) {
470 /* Walk through the bind address list and look for a bind
471 * address that matches the source address of the returned dst.
473 sctp_v4_dst_saddr(&dst_saddr, dst, htons(bp->port));
474 rcu_read_lock();
475 list_for_each_entry_rcu(laddr, &bp->address_list, list) {
476 if (!laddr->valid || (laddr->state != SCTP_ADDR_SRC))
477 continue;
478 if (sctp_v4_cmp_addr(&dst_saddr, &laddr->a))
479 goto out_unlock;
481 rcu_read_unlock();
483 /* None of the bound addresses match the source address of the
484 * dst. So release it.
486 dst_release(dst);
487 dst = NULL;
490 /* Walk through the bind address list and try to get a dst that
491 * matches a bind address as the source address.
493 rcu_read_lock();
494 list_for_each_entry_rcu(laddr, &bp->address_list, list) {
495 if (!laddr->valid)
496 continue;
497 if ((laddr->state == SCTP_ADDR_SRC) &&
498 (AF_INET == laddr->a.sa.sa_family)) {
499 fl.fl4_src = laddr->a.v4.sin_addr.s_addr;
500 if (!ip_route_output_key(&init_net, &rt, &fl)) {
501 dst = &rt->u.dst;
502 goto out_unlock;
507 out_unlock:
508 rcu_read_unlock();
509 out:
510 if (dst)
511 SCTP_DEBUG_PRINTK("rt_dst:%u.%u.%u.%u, rt_src:%u.%u.%u.%u\n",
512 NIPQUAD(rt->rt_dst), NIPQUAD(rt->rt_src));
513 else
514 SCTP_DEBUG_PRINTK("NO ROUTE\n");
516 return dst;
519 /* For v4, the source address is cached in the route entry(dst). So no need
520 * to cache it separately and hence this is an empty routine.
522 static void sctp_v4_get_saddr(struct sctp_sock *sk,
523 struct sctp_association *asoc,
524 struct dst_entry *dst,
525 union sctp_addr *daddr,
526 union sctp_addr *saddr)
528 struct rtable *rt = (struct rtable *)dst;
530 if (!asoc)
531 return;
533 if (rt) {
534 saddr->v4.sin_family = AF_INET;
535 saddr->v4.sin_port = htons(asoc->base.bind_addr.port);
536 saddr->v4.sin_addr.s_addr = rt->rt_src;
540 /* What interface did this skb arrive on? */
541 static int sctp_v4_skb_iif(const struct sk_buff *skb)
543 return skb->rtable->rt_iif;
546 /* Was this packet marked by Explicit Congestion Notification? */
547 static int sctp_v4_is_ce(const struct sk_buff *skb)
549 return INET_ECN_is_ce(ip_hdr(skb)->tos);
552 /* Create and initialize a new sk for the socket returned by accept(). */
553 static struct sock *sctp_v4_create_accept_sk(struct sock *sk,
554 struct sctp_association *asoc)
556 struct inet_sock *inet = inet_sk(sk);
557 struct inet_sock *newinet;
558 struct sock *newsk = sk_alloc(sock_net(sk), PF_INET, GFP_KERNEL,
559 sk->sk_prot);
561 if (!newsk)
562 goto out;
564 sock_init_data(NULL, newsk);
566 newsk->sk_type = SOCK_STREAM;
568 newsk->sk_no_check = sk->sk_no_check;
569 newsk->sk_reuse = sk->sk_reuse;
570 newsk->sk_shutdown = sk->sk_shutdown;
572 newsk->sk_destruct = inet_sock_destruct;
573 newsk->sk_family = PF_INET;
574 newsk->sk_protocol = IPPROTO_SCTP;
575 newsk->sk_backlog_rcv = sk->sk_prot->backlog_rcv;
576 sock_reset_flag(newsk, SOCK_ZAPPED);
578 newinet = inet_sk(newsk);
580 /* Initialize sk's sport, dport, rcv_saddr and daddr for
581 * getsockname() and getpeername()
583 newinet->sport = inet->sport;
584 newinet->saddr = inet->saddr;
585 newinet->rcv_saddr = inet->rcv_saddr;
586 newinet->dport = htons(asoc->peer.port);
587 newinet->daddr = asoc->peer.primary_addr.v4.sin_addr.s_addr;
588 newinet->pmtudisc = inet->pmtudisc;
589 newinet->id = asoc->next_tsn ^ jiffies;
591 newinet->uc_ttl = -1;
592 newinet->mc_loop = 1;
593 newinet->mc_ttl = 1;
594 newinet->mc_index = 0;
595 newinet->mc_list = NULL;
597 sk_refcnt_debug_inc(newsk);
599 if (newsk->sk_prot->init(newsk)) {
600 sk_common_release(newsk);
601 newsk = NULL;
604 out:
605 return newsk;
608 /* Map address, empty for v4 family */
609 static void sctp_v4_addr_v4map(struct sctp_sock *sp, union sctp_addr *addr)
611 /* Empty */
614 /* Dump the v4 addr to the seq file. */
615 static void sctp_v4_seq_dump_addr(struct seq_file *seq, union sctp_addr *addr)
617 seq_printf(seq, "%d.%d.%d.%d ", NIPQUAD(addr->v4.sin_addr));
620 static void sctp_v4_ecn_capable(struct sock *sk)
622 INET_ECN_xmit(sk);
625 /* Event handler for inet address addition/deletion events.
626 * The sctp_local_addr_list needs to be protocted by a spin lock since
627 * multiple notifiers (say IPv4 and IPv6) may be running at the same
628 * time and thus corrupt the list.
629 * The reader side is protected with RCU.
631 static int sctp_inetaddr_event(struct notifier_block *this, unsigned long ev,
632 void *ptr)
634 struct in_ifaddr *ifa = (struct in_ifaddr *)ptr;
635 struct sctp_sockaddr_entry *addr = NULL;
636 struct sctp_sockaddr_entry *temp;
637 int found = 0;
639 if (dev_net(ifa->ifa_dev->dev) != &init_net)
640 return NOTIFY_DONE;
642 switch (ev) {
643 case NETDEV_UP:
644 addr = kmalloc(sizeof(struct sctp_sockaddr_entry), GFP_ATOMIC);
645 if (addr) {
646 addr->a.v4.sin_family = AF_INET;
647 addr->a.v4.sin_port = 0;
648 addr->a.v4.sin_addr.s_addr = ifa->ifa_local;
649 addr->valid = 1;
650 spin_lock_bh(&sctp_local_addr_lock);
651 list_add_tail_rcu(&addr->list, &sctp_local_addr_list);
652 spin_unlock_bh(&sctp_local_addr_lock);
654 break;
655 case NETDEV_DOWN:
656 spin_lock_bh(&sctp_local_addr_lock);
657 list_for_each_entry_safe(addr, temp,
658 &sctp_local_addr_list, list) {
659 if (addr->a.sa.sa_family == AF_INET &&
660 addr->a.v4.sin_addr.s_addr ==
661 ifa->ifa_local) {
662 found = 1;
663 addr->valid = 0;
664 list_del_rcu(&addr->list);
665 break;
668 spin_unlock_bh(&sctp_local_addr_lock);
669 if (found)
670 call_rcu(&addr->rcu, sctp_local_addr_free);
671 break;
674 return NOTIFY_DONE;
678 * Initialize the control inode/socket with a control endpoint data
679 * structure. This endpoint is reserved exclusively for the OOTB processing.
681 static int sctp_ctl_sock_init(void)
683 int err;
684 sa_family_t family;
686 if (sctp_get_pf_specific(PF_INET6))
687 family = PF_INET6;
688 else
689 family = PF_INET;
691 err = inet_ctl_sock_create(&sctp_ctl_sock, family,
692 SOCK_SEQPACKET, IPPROTO_SCTP, &init_net);
693 if (err < 0) {
694 printk(KERN_ERR
695 "SCTP: Failed to create the SCTP control socket.\n");
696 return err;
698 return 0;
701 /* Register address family specific functions. */
702 int sctp_register_af(struct sctp_af *af)
704 switch (af->sa_family) {
705 case AF_INET:
706 if (sctp_af_v4_specific)
707 return 0;
708 sctp_af_v4_specific = af;
709 break;
710 case AF_INET6:
711 if (sctp_af_v6_specific)
712 return 0;
713 sctp_af_v6_specific = af;
714 break;
715 default:
716 return 0;
719 INIT_LIST_HEAD(&af->list);
720 list_add_tail(&af->list, &sctp_address_families);
721 return 1;
724 /* Get the table of functions for manipulating a particular address
725 * family.
727 struct sctp_af *sctp_get_af_specific(sa_family_t family)
729 switch (family) {
730 case AF_INET:
731 return sctp_af_v4_specific;
732 case AF_INET6:
733 return sctp_af_v6_specific;
734 default:
735 return NULL;
739 /* Common code to initialize a AF_INET msg_name. */
740 static void sctp_inet_msgname(char *msgname, int *addr_len)
742 struct sockaddr_in *sin;
744 sin = (struct sockaddr_in *)msgname;
745 *addr_len = sizeof(struct sockaddr_in);
746 sin->sin_family = AF_INET;
747 memset(sin->sin_zero, 0, sizeof(sin->sin_zero));
750 /* Copy the primary address of the peer primary address as the msg_name. */
751 static void sctp_inet_event_msgname(struct sctp_ulpevent *event, char *msgname,
752 int *addr_len)
754 struct sockaddr_in *sin, *sinfrom;
756 if (msgname) {
757 struct sctp_association *asoc;
759 asoc = event->asoc;
760 sctp_inet_msgname(msgname, addr_len);
761 sin = (struct sockaddr_in *)msgname;
762 sinfrom = &asoc->peer.primary_addr.v4;
763 sin->sin_port = htons(asoc->peer.port);
764 sin->sin_addr.s_addr = sinfrom->sin_addr.s_addr;
768 /* Initialize and copy out a msgname from an inbound skb. */
769 static void sctp_inet_skb_msgname(struct sk_buff *skb, char *msgname, int *len)
771 if (msgname) {
772 struct sctphdr *sh = sctp_hdr(skb);
773 struct sockaddr_in *sin = (struct sockaddr_in *)msgname;
775 sctp_inet_msgname(msgname, len);
776 sin->sin_port = sh->source;
777 sin->sin_addr.s_addr = ip_hdr(skb)->saddr;
781 /* Do we support this AF? */
782 static int sctp_inet_af_supported(sa_family_t family, struct sctp_sock *sp)
784 /* PF_INET only supports AF_INET addresses. */
785 return (AF_INET == family);
788 /* Address matching with wildcards allowed. */
789 static int sctp_inet_cmp_addr(const union sctp_addr *addr1,
790 const union sctp_addr *addr2,
791 struct sctp_sock *opt)
793 /* PF_INET only supports AF_INET addresses. */
794 if (addr1->sa.sa_family != addr2->sa.sa_family)
795 return 0;
796 if (htonl(INADDR_ANY) == addr1->v4.sin_addr.s_addr ||
797 htonl(INADDR_ANY) == addr2->v4.sin_addr.s_addr)
798 return 1;
799 if (addr1->v4.sin_addr.s_addr == addr2->v4.sin_addr.s_addr)
800 return 1;
802 return 0;
805 /* Verify that provided sockaddr looks bindable. Common verification has
806 * already been taken care of.
808 static int sctp_inet_bind_verify(struct sctp_sock *opt, union sctp_addr *addr)
810 return sctp_v4_available(addr, opt);
813 /* Verify that sockaddr looks sendable. Common verification has already
814 * been taken care of.
816 static int sctp_inet_send_verify(struct sctp_sock *opt, union sctp_addr *addr)
818 return 1;
821 /* Fill in Supported Address Type information for INIT and INIT-ACK
822 * chunks. Returns number of addresses supported.
824 static int sctp_inet_supported_addrs(const struct sctp_sock *opt,
825 __be16 *types)
827 types[0] = SCTP_PARAM_IPV4_ADDRESS;
828 return 1;
831 /* Wrapper routine that calls the ip transmit routine. */
832 static inline int sctp_v4_xmit(struct sk_buff *skb,
833 struct sctp_transport *transport, int ipfragok)
835 SCTP_DEBUG_PRINTK("%s: skb:%p, len:%d, "
836 "src:%u.%u.%u.%u, dst:%u.%u.%u.%u\n",
837 __func__, skb, skb->len,
838 NIPQUAD(skb->rtable->rt_src),
839 NIPQUAD(skb->rtable->rt_dst));
841 SCTP_INC_STATS(SCTP_MIB_OUTSCTPPACKS);
842 return ip_queue_xmit(skb, ipfragok);
845 static struct sctp_af sctp_af_inet;
847 static struct sctp_pf sctp_pf_inet = {
848 .event_msgname = sctp_inet_event_msgname,
849 .skb_msgname = sctp_inet_skb_msgname,
850 .af_supported = sctp_inet_af_supported,
851 .cmp_addr = sctp_inet_cmp_addr,
852 .bind_verify = sctp_inet_bind_verify,
853 .send_verify = sctp_inet_send_verify,
854 .supported_addrs = sctp_inet_supported_addrs,
855 .create_accept_sk = sctp_v4_create_accept_sk,
856 .addr_v4map = sctp_v4_addr_v4map,
857 .af = &sctp_af_inet
860 /* Notifier for inetaddr addition/deletion events. */
861 static struct notifier_block sctp_inetaddr_notifier = {
862 .notifier_call = sctp_inetaddr_event,
865 /* Socket operations. */
866 static const struct proto_ops inet_seqpacket_ops = {
867 .family = PF_INET,
868 .owner = THIS_MODULE,
869 .release = inet_release, /* Needs to be wrapped... */
870 .bind = inet_bind,
871 .connect = inet_dgram_connect,
872 .socketpair = sock_no_socketpair,
873 .accept = inet_accept,
874 .getname = inet_getname, /* Semantics are different. */
875 .poll = sctp_poll,
876 .ioctl = inet_ioctl,
877 .listen = sctp_inet_listen,
878 .shutdown = inet_shutdown, /* Looks harmless. */
879 .setsockopt = sock_common_setsockopt, /* IP_SOL IP_OPTION is a problem */
880 .getsockopt = sock_common_getsockopt,
881 .sendmsg = inet_sendmsg,
882 .recvmsg = sock_common_recvmsg,
883 .mmap = sock_no_mmap,
884 .sendpage = sock_no_sendpage,
885 #ifdef CONFIG_COMPAT
886 .compat_setsockopt = compat_sock_common_setsockopt,
887 .compat_getsockopt = compat_sock_common_getsockopt,
888 #endif
891 /* Registration with AF_INET family. */
892 static struct inet_protosw sctp_seqpacket_protosw = {
893 .type = SOCK_SEQPACKET,
894 .protocol = IPPROTO_SCTP,
895 .prot = &sctp_prot,
896 .ops = &inet_seqpacket_ops,
897 .capability = -1,
898 .no_check = 0,
899 .flags = SCTP_PROTOSW_FLAG
901 static struct inet_protosw sctp_stream_protosw = {
902 .type = SOCK_STREAM,
903 .protocol = IPPROTO_SCTP,
904 .prot = &sctp_prot,
905 .ops = &inet_seqpacket_ops,
906 .capability = -1,
907 .no_check = 0,
908 .flags = SCTP_PROTOSW_FLAG
911 /* Register with IP layer. */
912 static struct net_protocol sctp_protocol = {
913 .handler = sctp_rcv,
914 .err_handler = sctp_v4_err,
915 .no_policy = 1,
918 /* IPv4 address related functions. */
919 static struct sctp_af sctp_af_inet = {
920 .sa_family = AF_INET,
921 .sctp_xmit = sctp_v4_xmit,
922 .setsockopt = ip_setsockopt,
923 .getsockopt = ip_getsockopt,
924 .get_dst = sctp_v4_get_dst,
925 .get_saddr = sctp_v4_get_saddr,
926 .copy_addrlist = sctp_v4_copy_addrlist,
927 .from_skb = sctp_v4_from_skb,
928 .from_sk = sctp_v4_from_sk,
929 .to_sk_saddr = sctp_v4_to_sk_saddr,
930 .to_sk_daddr = sctp_v4_to_sk_daddr,
931 .from_addr_param = sctp_v4_from_addr_param,
932 .to_addr_param = sctp_v4_to_addr_param,
933 .dst_saddr = sctp_v4_dst_saddr,
934 .cmp_addr = sctp_v4_cmp_addr,
935 .addr_valid = sctp_v4_addr_valid,
936 .inaddr_any = sctp_v4_inaddr_any,
937 .is_any = sctp_v4_is_any,
938 .available = sctp_v4_available,
939 .scope = sctp_v4_scope,
940 .skb_iif = sctp_v4_skb_iif,
941 .is_ce = sctp_v4_is_ce,
942 .seq_dump_addr = sctp_v4_seq_dump_addr,
943 .ecn_capable = sctp_v4_ecn_capable,
944 .net_header_len = sizeof(struct iphdr),
945 .sockaddr_len = sizeof(struct sockaddr_in),
946 #ifdef CONFIG_COMPAT
947 .compat_setsockopt = compat_ip_setsockopt,
948 .compat_getsockopt = compat_ip_getsockopt,
949 #endif
952 struct sctp_pf *sctp_get_pf_specific(sa_family_t family) {
954 switch (family) {
955 case PF_INET:
956 return sctp_pf_inet_specific;
957 case PF_INET6:
958 return sctp_pf_inet6_specific;
959 default:
960 return NULL;
964 /* Register the PF specific function table. */
965 int sctp_register_pf(struct sctp_pf *pf, sa_family_t family)
967 switch (family) {
968 case PF_INET:
969 if (sctp_pf_inet_specific)
970 return 0;
971 sctp_pf_inet_specific = pf;
972 break;
973 case PF_INET6:
974 if (sctp_pf_inet6_specific)
975 return 0;
976 sctp_pf_inet6_specific = pf;
977 break;
978 default:
979 return 0;
981 return 1;
984 static inline int init_sctp_mibs(void)
986 return snmp_mib_init((void**)sctp_statistics, sizeof(struct sctp_mib));
989 static inline void cleanup_sctp_mibs(void)
991 snmp_mib_free((void**)sctp_statistics);
994 static void sctp_v4_pf_init(void)
996 /* Initialize the SCTP specific PF functions. */
997 sctp_register_pf(&sctp_pf_inet, PF_INET);
998 sctp_register_af(&sctp_af_inet);
1001 static void sctp_v4_pf_exit(void)
1003 list_del(&sctp_af_inet.list);
1006 static int sctp_v4_protosw_init(void)
1008 int rc;
1010 rc = proto_register(&sctp_prot, 1);
1011 if (rc)
1012 return rc;
1014 /* Register SCTP(UDP and TCP style) with socket layer. */
1015 inet_register_protosw(&sctp_seqpacket_protosw);
1016 inet_register_protosw(&sctp_stream_protosw);
1018 return 0;
1021 static void sctp_v4_protosw_exit(void)
1023 inet_unregister_protosw(&sctp_stream_protosw);
1024 inet_unregister_protosw(&sctp_seqpacket_protosw);
1025 proto_unregister(&sctp_prot);
1028 static int sctp_v4_add_protocol(void)
1030 /* Register notifier for inet address additions/deletions. */
1031 register_inetaddr_notifier(&sctp_inetaddr_notifier);
1033 /* Register SCTP with inet layer. */
1034 if (inet_add_protocol(&sctp_protocol, IPPROTO_SCTP) < 0)
1035 return -EAGAIN;
1037 return 0;
1040 static void sctp_v4_del_protocol(void)
1042 inet_del_protocol(&sctp_protocol, IPPROTO_SCTP);
1043 unregister_inetaddr_notifier(&sctp_inetaddr_notifier);
1046 /* Initialize the universe into something sensible. */
1047 SCTP_STATIC __init int sctp_init(void)
1049 int i;
1050 int status = -EINVAL;
1051 unsigned long goal;
1052 unsigned long limit;
1053 int max_share;
1054 int order;
1056 /* SCTP_DEBUG sanity check. */
1057 if (!sctp_sanity_check())
1058 goto out;
1060 /* Allocate bind_bucket and chunk caches. */
1061 status = -ENOBUFS;
1062 sctp_bucket_cachep = kmem_cache_create("sctp_bind_bucket",
1063 sizeof(struct sctp_bind_bucket),
1064 0, SLAB_HWCACHE_ALIGN,
1065 NULL);
1066 if (!sctp_bucket_cachep)
1067 goto out;
1069 sctp_chunk_cachep = kmem_cache_create("sctp_chunk",
1070 sizeof(struct sctp_chunk),
1071 0, SLAB_HWCACHE_ALIGN,
1072 NULL);
1073 if (!sctp_chunk_cachep)
1074 goto err_chunk_cachep;
1076 /* Allocate and initialise sctp mibs. */
1077 status = init_sctp_mibs();
1078 if (status)
1079 goto err_init_mibs;
1081 /* Initialize proc fs directory. */
1082 status = sctp_proc_init();
1083 if (status)
1084 goto err_init_proc;
1086 /* Initialize object count debugging. */
1087 sctp_dbg_objcnt_init();
1090 * 14. Suggested SCTP Protocol Parameter Values
1092 /* The following protocol parameters are RECOMMENDED: */
1093 /* RTO.Initial - 3 seconds */
1094 sctp_rto_initial = SCTP_RTO_INITIAL;
1095 /* RTO.Min - 1 second */
1096 sctp_rto_min = SCTP_RTO_MIN;
1097 /* RTO.Max - 60 seconds */
1098 sctp_rto_max = SCTP_RTO_MAX;
1099 /* RTO.Alpha - 1/8 */
1100 sctp_rto_alpha = SCTP_RTO_ALPHA;
1101 /* RTO.Beta - 1/4 */
1102 sctp_rto_beta = SCTP_RTO_BETA;
1104 /* Valid.Cookie.Life - 60 seconds */
1105 sctp_valid_cookie_life = SCTP_DEFAULT_COOKIE_LIFE;
1107 /* Whether Cookie Preservative is enabled(1) or not(0) */
1108 sctp_cookie_preserve_enable = 1;
1110 /* Max.Burst - 4 */
1111 sctp_max_burst = SCTP_DEFAULT_MAX_BURST;
1113 /* Association.Max.Retrans - 10 attempts
1114 * Path.Max.Retrans - 5 attempts (per destination address)
1115 * Max.Init.Retransmits - 8 attempts
1117 sctp_max_retrans_association = 10;
1118 sctp_max_retrans_path = 5;
1119 sctp_max_retrans_init = 8;
1121 /* Sendbuffer growth - do per-socket accounting */
1122 sctp_sndbuf_policy = 0;
1124 /* Rcvbuffer growth - do per-socket accounting */
1125 sctp_rcvbuf_policy = 0;
1127 /* HB.interval - 30 seconds */
1128 sctp_hb_interval = SCTP_DEFAULT_TIMEOUT_HEARTBEAT;
1130 /* delayed SACK timeout */
1131 sctp_sack_timeout = SCTP_DEFAULT_TIMEOUT_SACK;
1133 /* Implementation specific variables. */
1135 /* Initialize default stream count setup information. */
1136 sctp_max_instreams = SCTP_DEFAULT_INSTREAMS;
1137 sctp_max_outstreams = SCTP_DEFAULT_OUTSTREAMS;
1139 /* Initialize handle used for association ids. */
1140 idr_init(&sctp_assocs_id);
1142 /* Set the pressure threshold to be a fraction of global memory that
1143 * is up to 1/2 at 256 MB, decreasing toward zero with the amount of
1144 * memory, with a floor of 128 pages.
1145 * Note this initalizes the data in sctpv6_prot too
1146 * Unabashedly stolen from tcp_init
1148 limit = min(num_physpages, 1UL<<(28-PAGE_SHIFT)) >> (20-PAGE_SHIFT);
1149 limit = (limit * (num_physpages >> (20-PAGE_SHIFT))) >> (PAGE_SHIFT-11);
1150 limit = max(limit, 128UL);
1151 sysctl_sctp_mem[0] = limit / 4 * 3;
1152 sysctl_sctp_mem[1] = limit;
1153 sysctl_sctp_mem[2] = sysctl_sctp_mem[0] * 2;
1155 /* Set per-socket limits to no more than 1/128 the pressure threshold*/
1156 limit = (sysctl_sctp_mem[1]) << (PAGE_SHIFT - 7);
1157 max_share = min(4UL*1024*1024, limit);
1159 sysctl_sctp_rmem[0] = PAGE_SIZE; /* give each asoc 1 page min */
1160 sysctl_sctp_rmem[1] = (1500 *(sizeof(struct sk_buff) + 1));
1161 sysctl_sctp_rmem[2] = max(sysctl_sctp_rmem[1], max_share);
1163 sysctl_sctp_wmem[0] = SK_MEM_QUANTUM;
1164 sysctl_sctp_wmem[1] = 16*1024;
1165 sysctl_sctp_wmem[2] = max(64*1024, max_share);
1167 /* Size and allocate the association hash table.
1168 * The methodology is similar to that of the tcp hash tables.
1170 if (num_physpages >= (128 * 1024))
1171 goal = num_physpages >> (22 - PAGE_SHIFT);
1172 else
1173 goal = num_physpages >> (24 - PAGE_SHIFT);
1175 for (order = 0; (1UL << order) < goal; order++)
1178 do {
1179 sctp_assoc_hashsize = (1UL << order) * PAGE_SIZE /
1180 sizeof(struct sctp_hashbucket);
1181 if ((sctp_assoc_hashsize > (64 * 1024)) && order > 0)
1182 continue;
1183 sctp_assoc_hashtable = (struct sctp_hashbucket *)
1184 __get_free_pages(GFP_ATOMIC, order);
1185 } while (!sctp_assoc_hashtable && --order > 0);
1186 if (!sctp_assoc_hashtable) {
1187 printk(KERN_ERR "SCTP: Failed association hash alloc.\n");
1188 status = -ENOMEM;
1189 goto err_ahash_alloc;
1191 for (i = 0; i < sctp_assoc_hashsize; i++) {
1192 rwlock_init(&sctp_assoc_hashtable[i].lock);
1193 INIT_HLIST_HEAD(&sctp_assoc_hashtable[i].chain);
1196 /* Allocate and initialize the endpoint hash table. */
1197 sctp_ep_hashsize = 64;
1198 sctp_ep_hashtable = (struct sctp_hashbucket *)
1199 kmalloc(64 * sizeof(struct sctp_hashbucket), GFP_KERNEL);
1200 if (!sctp_ep_hashtable) {
1201 printk(KERN_ERR "SCTP: Failed endpoint_hash alloc.\n");
1202 status = -ENOMEM;
1203 goto err_ehash_alloc;
1205 for (i = 0; i < sctp_ep_hashsize; i++) {
1206 rwlock_init(&sctp_ep_hashtable[i].lock);
1207 INIT_HLIST_HEAD(&sctp_ep_hashtable[i].chain);
1210 /* Allocate and initialize the SCTP port hash table. */
1211 do {
1212 sctp_port_hashsize = (1UL << order) * PAGE_SIZE /
1213 sizeof(struct sctp_bind_hashbucket);
1214 if ((sctp_port_hashsize > (64 * 1024)) && order > 0)
1215 continue;
1216 sctp_port_hashtable = (struct sctp_bind_hashbucket *)
1217 __get_free_pages(GFP_ATOMIC, order);
1218 } while (!sctp_port_hashtable && --order > 0);
1219 if (!sctp_port_hashtable) {
1220 printk(KERN_ERR "SCTP: Failed bind hash alloc.");
1221 status = -ENOMEM;
1222 goto err_bhash_alloc;
1224 for (i = 0; i < sctp_port_hashsize; i++) {
1225 spin_lock_init(&sctp_port_hashtable[i].lock);
1226 INIT_HLIST_HEAD(&sctp_port_hashtable[i].chain);
1229 printk(KERN_INFO "SCTP: Hash tables configured "
1230 "(established %d bind %d)\n",
1231 sctp_assoc_hashsize, sctp_port_hashsize);
1233 /* Disable ADDIP by default. */
1234 sctp_addip_enable = 0;
1235 sctp_addip_noauth = 0;
1237 /* Enable PR-SCTP by default. */
1238 sctp_prsctp_enable = 1;
1240 /* Disable AUTH by default. */
1241 sctp_auth_enable = 0;
1243 sctp_sysctl_register();
1245 INIT_LIST_HEAD(&sctp_address_families);
1246 sctp_v4_pf_init();
1247 sctp_v6_pf_init();
1249 /* Initialize the local address list. */
1250 INIT_LIST_HEAD(&sctp_local_addr_list);
1251 spin_lock_init(&sctp_local_addr_lock);
1252 sctp_get_local_addr_list();
1254 status = sctp_v4_protosw_init();
1256 if (status)
1257 goto err_protosw_init;
1259 status = sctp_v6_protosw_init();
1260 if (status)
1261 goto err_v6_protosw_init;
1263 /* Initialize the control inode/socket for handling OOTB packets. */
1264 if ((status = sctp_ctl_sock_init())) {
1265 printk (KERN_ERR
1266 "SCTP: Failed to initialize the SCTP control sock.\n");
1267 goto err_ctl_sock_init;
1270 status = sctp_v4_add_protocol();
1271 if (status)
1272 goto err_add_protocol;
1274 /* Register SCTP with inet6 layer. */
1275 status = sctp_v6_add_protocol();
1276 if (status)
1277 goto err_v6_add_protocol;
1279 status = 0;
1280 out:
1281 return status;
1282 err_v6_add_protocol:
1283 sctp_v6_del_protocol();
1284 err_add_protocol:
1285 sctp_v4_del_protocol();
1286 inet_ctl_sock_destroy(sctp_ctl_sock);
1287 err_ctl_sock_init:
1288 sctp_v6_protosw_exit();
1289 err_v6_protosw_init:
1290 sctp_v4_protosw_exit();
1291 err_protosw_init:
1292 sctp_free_local_addr_list();
1293 sctp_v4_pf_exit();
1294 sctp_v6_pf_exit();
1295 sctp_sysctl_unregister();
1296 list_del(&sctp_af_inet.list);
1297 free_pages((unsigned long)sctp_port_hashtable,
1298 get_order(sctp_port_hashsize *
1299 sizeof(struct sctp_bind_hashbucket)));
1300 err_bhash_alloc:
1301 kfree(sctp_ep_hashtable);
1302 err_ehash_alloc:
1303 free_pages((unsigned long)sctp_assoc_hashtable,
1304 get_order(sctp_assoc_hashsize *
1305 sizeof(struct sctp_hashbucket)));
1306 err_ahash_alloc:
1307 sctp_dbg_objcnt_exit();
1308 sctp_proc_exit();
1309 err_init_proc:
1310 cleanup_sctp_mibs();
1311 err_init_mibs:
1312 kmem_cache_destroy(sctp_chunk_cachep);
1313 err_chunk_cachep:
1314 kmem_cache_destroy(sctp_bucket_cachep);
1315 goto out;
1318 /* Exit handler for the SCTP protocol. */
1319 SCTP_STATIC __exit void sctp_exit(void)
1321 /* BUG. This should probably do something useful like clean
1322 * up all the remaining associations and all that memory.
1325 /* Unregister with inet6/inet layers. */
1326 sctp_v6_del_protocol();
1327 sctp_v4_del_protocol();
1329 /* Free the control endpoint. */
1330 inet_ctl_sock_destroy(sctp_ctl_sock);
1332 /* Free protosw registrations */
1333 sctp_v6_protosw_exit();
1334 sctp_v4_protosw_exit();
1336 /* Free the local address list. */
1337 sctp_free_local_addr_list();
1339 /* Unregister with socket layer. */
1340 sctp_v6_pf_exit();
1341 sctp_v4_pf_exit();
1343 sctp_sysctl_unregister();
1344 list_del(&sctp_af_inet.list);
1346 free_pages((unsigned long)sctp_assoc_hashtable,
1347 get_order(sctp_assoc_hashsize *
1348 sizeof(struct sctp_hashbucket)));
1349 kfree(sctp_ep_hashtable);
1350 free_pages((unsigned long)sctp_port_hashtable,
1351 get_order(sctp_port_hashsize *
1352 sizeof(struct sctp_bind_hashbucket)));
1354 sctp_dbg_objcnt_exit();
1355 sctp_proc_exit();
1356 cleanup_sctp_mibs();
1358 kmem_cache_destroy(sctp_chunk_cachep);
1359 kmem_cache_destroy(sctp_bucket_cachep);
1362 module_init(sctp_init);
1363 module_exit(sctp_exit);
1366 * __stringify doesn't likes enums, so use IPPROTO_SCTP value (132) directly.
1368 MODULE_ALIAS("net-pf-" __stringify(PF_INET) "-proto-132");
1369 MODULE_ALIAS("net-pf-" __stringify(PF_INET6) "-proto-132");
1370 MODULE_AUTHOR("Linux Kernel SCTP developers <lksctp-developers@lists.sourceforge.net>");
1371 MODULE_DESCRIPTION("Support for the SCTP protocol (RFC2960)");
1372 MODULE_LICENSE("GPL");