[SCTP]: __nocast annotations
[linux-2.6/lfs.git] / include / net / sctp / sctp.h
blob4a26adfaed715ba531cb36e120241688cab385f3
1 /* SCTP kernel reference 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-2003 Intel Corp.
7 * This file is part of the SCTP kernel reference Implementation
9 * The base lksctp header.
11 * The SCTP reference implementation is free software;
12 * you can redistribute it and/or modify it under the terms of
13 * the GNU General Public License as published by
14 * the Free Software Foundation; either version 2, or (at your option)
15 * any later version.
17 * The SCTP reference implementation is distributed in the hope that it
18 * will be useful, but WITHOUT ANY WARRANTY; without even the implied
19 * ************************
20 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
21 * See the GNU General Public License for more details.
23 * You should have received a copy of the GNU General Public License
24 * along with GNU CC; see the file COPYING. If not, write to
25 * the Free Software Foundation, 59 Temple Place - Suite 330,
26 * Boston, MA 02111-1307, USA.
28 * Please send any bug reports or fixes you make to the
29 * email address(es):
30 * lksctp developers <lksctp-developers@lists.sourceforge.net>
32 * Or submit a bug report through the following website:
33 * http://www.sf.net/projects/lksctp
35 * Written or modified by:
36 * La Monte H.P. Yarroll <piggy@acm.org>
37 * Xingang Guo <xingang.guo@intel.com>
38 * Jon Grimm <jgrimm@us.ibm.com>
39 * Daisy Chang <daisyc@us.ibm.com>
40 * Sridhar Samudrala <sri@us.ibm.com>
41 * Ardelle Fan <ardelle.fan@intel.com>
42 * Ryan Layer <rmlayer@us.ibm.com>
43 * Kevin Gao <kevin.gao@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 #ifndef __net_sctp_h__
50 #define __net_sctp_h__
52 /* Header Strategy.
53 * Start getting some control over the header file depencies:
54 * includes
55 * constants
56 * structs
57 * prototypes
58 * macros, externs, and inlines
60 * Move test_frame specific items out of the kernel headers
61 * and into the test frame headers. This is not perfect in any sense
62 * and will continue to evolve.
66 #include <linux/config.h>
68 #ifdef TEST_FRAME
69 #undef CONFIG_PROC_FS
70 #undef CONFIG_SCTP_DBG_OBJCNT
71 #undef CONFIG_SYSCTL
72 #endif /* TEST_FRAME */
74 #include <linux/types.h>
75 #include <linux/slab.h>
76 #include <linux/in.h>
77 #include <linux/tty.h>
78 #include <linux/proc_fs.h>
79 #include <linux/spinlock.h>
80 #include <linux/jiffies.h>
81 #include <linux/idr.h>
83 #if defined(CONFIG_IPV6) || defined(CONFIG_IPV6_MODULE)
84 #include <net/ipv6.h>
85 #include <net/ip6_route.h>
86 #endif
88 #include <asm/uaccess.h>
89 #include <asm/page.h>
90 #include <net/sock.h>
91 #include <net/snmp.h>
92 #include <net/sctp/structs.h>
93 #include <net/sctp/constants.h>
96 /* Set SCTP_DEBUG flag via config if not already set. */
97 #ifndef SCTP_DEBUG
98 #ifdef CONFIG_SCTP_DBG_MSG
99 #define SCTP_DEBUG 1
100 #else
101 #define SCTP_DEBUG 0
102 #endif /* CONFIG_SCTP_DBG */
103 #endif /* SCTP_DEBUG */
105 #ifdef CONFIG_IP_SCTP_MODULE
106 #define SCTP_PROTOSW_FLAG 0
107 #else /* static! */
108 #define SCTP_PROTOSW_FLAG INET_PROTOSW_PERMANENT
109 #endif
112 /* Certain internal static functions need to be exported when
113 * compiled into the test frame.
115 #ifndef SCTP_STATIC
116 #define SCTP_STATIC static
117 #endif
120 * Function declarations.
124 * sctp/protocol.c
126 extern struct sock *sctp_get_ctl_sock(void);
127 extern int sctp_copy_local_addr_list(struct sctp_bind_addr *,
128 sctp_scope_t, unsigned int __nocast gfp,
129 int flags);
130 extern struct sctp_pf *sctp_get_pf_specific(sa_family_t family);
131 extern int sctp_register_pf(struct sctp_pf *, sa_family_t);
134 * sctp/socket.c
136 int sctp_backlog_rcv(struct sock *sk, struct sk_buff *skb);
137 int sctp_inet_listen(struct socket *sock, int backlog);
138 void sctp_write_space(struct sock *sk);
139 unsigned int sctp_poll(struct file *file, struct socket *sock,
140 poll_table *wait);
143 * sctp/primitive.c
145 int sctp_primitive_ASSOCIATE(struct sctp_association *, void *arg);
146 int sctp_primitive_SHUTDOWN(struct sctp_association *, void *arg);
147 int sctp_primitive_ABORT(struct sctp_association *, void *arg);
148 int sctp_primitive_SEND(struct sctp_association *, void *arg);
149 int sctp_primitive_REQUESTHEARTBEAT(struct sctp_association *, void *arg);
150 int sctp_primitive_ASCONF(struct sctp_association *, void *arg);
153 * sctp/crc32c.c
155 __u32 sctp_start_cksum(__u8 *ptr, __u16 count);
156 __u32 sctp_update_cksum(__u8 *ptr, __u16 count, __u32 cksum);
157 __u32 sctp_end_cksum(__u32 cksum);
158 __u32 sctp_update_copy_cksum(__u8 *, __u8 *, __u16 count, __u32 cksum);
161 * sctp/input.c
163 int sctp_rcv(struct sk_buff *skb);
164 void sctp_v4_err(struct sk_buff *skb, u32 info);
165 void sctp_hash_established(struct sctp_association *);
166 void sctp_unhash_established(struct sctp_association *);
167 void sctp_hash_endpoint(struct sctp_endpoint *);
168 void sctp_unhash_endpoint(struct sctp_endpoint *);
169 struct sock *sctp_err_lookup(int family, struct sk_buff *,
170 struct sctphdr *, struct sctp_endpoint **,
171 struct sctp_association **,
172 struct sctp_transport **);
173 void sctp_err_finish(struct sock *, struct sctp_endpoint *,
174 struct sctp_association *);
175 void sctp_icmp_frag_needed(struct sock *, struct sctp_association *,
176 struct sctp_transport *t, __u32 pmtu);
177 void sctp_icmp_proto_unreachable(struct sock *sk,
178 struct sctp_endpoint *ep,
179 struct sctp_association *asoc,
180 struct sctp_transport *t);
183 * Section: Macros, externs, and inlines
187 #ifdef TEST_FRAME
188 #include <test_frame.h>
189 #else
191 /* spin lock wrappers. */
192 #define sctp_spin_lock_irqsave(lock, flags) spin_lock_irqsave(lock, flags)
193 #define sctp_spin_unlock_irqrestore(lock, flags) \
194 spin_unlock_irqrestore(lock, flags)
195 #define sctp_local_bh_disable() local_bh_disable()
196 #define sctp_local_bh_enable() local_bh_enable()
197 #define sctp_spin_lock(lock) spin_lock(lock)
198 #define sctp_spin_unlock(lock) spin_unlock(lock)
199 #define sctp_write_lock(lock) write_lock(lock)
200 #define sctp_write_unlock(lock) write_unlock(lock)
201 #define sctp_read_lock(lock) read_lock(lock)
202 #define sctp_read_unlock(lock) read_unlock(lock)
204 /* sock lock wrappers. */
205 #define sctp_lock_sock(sk) lock_sock(sk)
206 #define sctp_release_sock(sk) release_sock(sk)
207 #define sctp_bh_lock_sock(sk) bh_lock_sock(sk)
208 #define sctp_bh_unlock_sock(sk) bh_unlock_sock(sk)
209 #define SCTP_SOCK_SLEEP_PRE(sk) SOCK_SLEEP_PRE(sk)
210 #define SCTP_SOCK_SLEEP_POST(sk) SOCK_SLEEP_POST(sk)
212 /* SCTP SNMP MIB stats handlers */
213 DECLARE_SNMP_STAT(struct sctp_mib, sctp_statistics);
214 #define SCTP_INC_STATS(field) SNMP_INC_STATS(sctp_statistics, field)
215 #define SCTP_INC_STATS_BH(field) SNMP_INC_STATS_BH(sctp_statistics, field)
216 #define SCTP_INC_STATS_USER(field) SNMP_INC_STATS_USER(sctp_statistics, field)
217 #define SCTP_DEC_STATS(field) SNMP_DEC_STATS(sctp_statistics, field)
219 #endif /* !TEST_FRAME */
222 /* Print debugging messages. */
223 #if SCTP_DEBUG
224 extern int sctp_debug_flag;
225 #define SCTP_DEBUG_PRINTK(whatever...) \
226 ((void) (sctp_debug_flag && printk(KERN_DEBUG whatever)))
227 #define SCTP_DEBUG_PRINTK_IPADDR(lead, trail, leadparm, saddr, otherparms...) \
228 if (sctp_debug_flag) { \
229 if (saddr->sa.sa_family == AF_INET6) { \
230 printk(KERN_DEBUG \
231 lead "%04x:%04x:%04x:%04x:%04x:%04x:%04x:%04x" trail, \
232 leadparm, \
233 NIP6(saddr->v6.sin6_addr), \
234 otherparms); \
235 } else { \
236 printk(KERN_DEBUG \
237 lead "%u.%u.%u.%u" trail, \
238 leadparm, \
239 NIPQUAD(saddr->v4.sin_addr.s_addr), \
240 otherparms); \
243 #define SCTP_ENABLE_DEBUG { sctp_debug_flag = 1; }
244 #define SCTP_DISABLE_DEBUG { sctp_debug_flag = 0; }
246 #define SCTP_ASSERT(expr, str, func) \
247 if (!(expr)) { \
248 SCTP_DEBUG_PRINTK("Assertion Failed: %s(%s) at %s:%s:%d\n", \
249 str, (#expr), __FILE__, __FUNCTION__, __LINE__); \
250 func; \
253 #else /* SCTP_DEBUG */
255 #define SCTP_DEBUG_PRINTK(whatever...)
256 #define SCTP_DEBUG_PRINTK_IPADDR(whatever...)
257 #define SCTP_ENABLE_DEBUG
258 #define SCTP_DISABLE_DEBUG
259 #define SCTP_ASSERT(expr, str, func)
261 #endif /* SCTP_DEBUG */
265 * Macros for keeping a global reference of object allocations.
267 #ifdef CONFIG_SCTP_DBG_OBJCNT
269 extern atomic_t sctp_dbg_objcnt_sock;
270 extern atomic_t sctp_dbg_objcnt_ep;
271 extern atomic_t sctp_dbg_objcnt_assoc;
272 extern atomic_t sctp_dbg_objcnt_transport;
273 extern atomic_t sctp_dbg_objcnt_chunk;
274 extern atomic_t sctp_dbg_objcnt_bind_addr;
275 extern atomic_t sctp_dbg_objcnt_bind_bucket;
276 extern atomic_t sctp_dbg_objcnt_addr;
277 extern atomic_t sctp_dbg_objcnt_ssnmap;
278 extern atomic_t sctp_dbg_objcnt_datamsg;
280 /* Macros to atomically increment/decrement objcnt counters. */
281 #define SCTP_DBG_OBJCNT_INC(name) \
282 atomic_inc(&sctp_dbg_objcnt_## name)
283 #define SCTP_DBG_OBJCNT_DEC(name) \
284 atomic_dec(&sctp_dbg_objcnt_## name)
285 #define SCTP_DBG_OBJCNT(name) \
286 atomic_t sctp_dbg_objcnt_## name = ATOMIC_INIT(0)
288 /* Macro to help create new entries in in the global array of
289 * objcnt counters.
291 #define SCTP_DBG_OBJCNT_ENTRY(name) \
292 {.label= #name, .counter= &sctp_dbg_objcnt_## name}
294 void sctp_dbg_objcnt_init(void);
295 void sctp_dbg_objcnt_exit(void);
297 #else
299 #define SCTP_DBG_OBJCNT_INC(name)
300 #define SCTP_DBG_OBJCNT_DEC(name)
302 static inline void sctp_dbg_objcnt_init(void) { return; }
303 static inline void sctp_dbg_objcnt_exit(void) { return; }
305 #endif /* CONFIG_SCTP_DBG_OBJCOUNT */
307 #if defined CONFIG_SYSCTL
308 void sctp_sysctl_register(void);
309 void sctp_sysctl_unregister(void);
310 #else
311 static inline void sctp_sysctl_register(void) { return; }
312 static inline void sctp_sysctl_unregister(void) { return; }
313 static inline int sctp_sysctl_jiffies_ms(ctl_table *table, int __user *name, int nlen,
314 void __user *oldval, size_t __user *oldlenp,
315 void __user *newval, size_t newlen, void **context) {
316 return -ENOSYS;
318 #endif
320 /* Size of Supported Address Parameter for 'x' address types. */
321 #define SCTP_SAT_LEN(x) (sizeof(struct sctp_paramhdr) + (x) * sizeof(__u16))
323 #if defined(CONFIG_IPV6) || defined(CONFIG_IPV6_MODULE)
325 int sctp_v6_init(void);
326 void sctp_v6_exit(void);
328 #else /* #ifdef defined(CONFIG_IPV6) */
330 static inline int sctp_v6_init(void) { return 0; }
331 static inline void sctp_v6_exit(void) { return; }
333 #endif /* #if defined(CONFIG_IPV6) */
335 /* Some wrappers, in case crypto not available. */
336 #if defined (CONFIG_CRYPTO_HMAC)
337 #define sctp_crypto_alloc_tfm crypto_alloc_tfm
338 #define sctp_crypto_free_tfm crypto_free_tfm
339 #define sctp_crypto_hmac crypto_hmac
340 #else
341 #define sctp_crypto_alloc_tfm(x...) NULL
342 #define sctp_crypto_free_tfm(x...)
343 #define sctp_crypto_hmac(x...)
344 #endif
347 /* Map an association to an assoc_id. */
348 static inline sctp_assoc_t sctp_assoc2id(const struct sctp_association *asoc)
350 return (asoc?asoc->assoc_id:0);
353 /* Look up the association by its id. */
354 struct sctp_association *sctp_id2assoc(struct sock *sk, sctp_assoc_t id);
357 /* A macro to walk a list of skbs. */
358 #define sctp_skb_for_each(pos, head, tmp) \
359 for (pos = (head)->next;\
360 tmp = (pos)->next, pos != ((struct sk_buff *)(head));\
361 pos = tmp)
364 /* A helper to append an entire skb list (list) to another (head). */
365 static inline void sctp_skb_list_tail(struct sk_buff_head *list,
366 struct sk_buff_head *head)
368 unsigned long flags;
370 sctp_spin_lock_irqsave(&head->lock, flags);
371 sctp_spin_lock(&list->lock);
373 list_splice((struct list_head *)list, (struct list_head *)head->prev);
375 head->qlen += list->qlen;
376 list->qlen = 0;
378 sctp_spin_unlock(&list->lock);
379 sctp_spin_unlock_irqrestore(&head->lock, flags);
383 * sctp_list_dequeue - remove from the head of the queue
384 * @list: list to dequeue from
386 * Remove the head of the list. The head item is
387 * returned or %NULL if the list is empty.
390 static inline struct list_head *sctp_list_dequeue(struct list_head *list)
392 struct list_head *result = NULL;
394 if (list->next != list) {
395 result = list->next;
396 list->next = result->next;
397 list->next->prev = list;
398 INIT_LIST_HEAD(result);
400 return result;
403 /* Tests if the list has one and only one entry. */
404 static inline int sctp_list_single_entry(struct list_head *head)
406 return ((head->next != head) && (head->next == head->prev));
409 /* Calculate the size (in bytes) occupied by the data of an iovec. */
410 static inline size_t get_user_iov_size(struct iovec *iov, int iovlen)
412 size_t retval = 0;
414 for (; iovlen > 0; --iovlen) {
415 retval += iov->iov_len;
416 iov++;
419 return retval;
422 /* Generate a random jitter in the range of -50% ~ +50% of input RTO. */
423 static inline __s32 sctp_jitter(__u32 rto)
425 static __u32 sctp_rand;
426 __s32 ret;
428 /* Avoid divide by zero. */
429 if (!rto)
430 rto = 1;
432 sctp_rand += jiffies;
433 sctp_rand ^= (sctp_rand << 12);
434 sctp_rand ^= (sctp_rand >> 20);
436 /* Choose random number from 0 to rto, then move to -50% ~ +50%
437 * of rto.
439 ret = sctp_rand % rto - (rto >> 1);
440 return ret;
443 /* Break down data chunks at this point. */
444 static inline int sctp_frag_point(const struct sctp_sock *sp, int pmtu)
446 int frag = pmtu;
448 frag -= sp->pf->af->net_header_len;
449 frag -= sizeof(struct sctphdr) + sizeof(struct sctp_data_chunk);
451 if (sp->user_frag)
452 frag = min_t(int, frag, sp->user_frag);
454 frag = min_t(int, frag, SCTP_MAX_CHUNK_LEN);
456 return frag;
459 /* Walk through a list of TLV parameters. Don't trust the
460 * individual parameter lengths and instead depend on
461 * the chunk length to indicate when to stop. Make sure
462 * there is room for a param header too.
464 #define sctp_walk_params(pos, chunk, member)\
465 _sctp_walk_params((pos), (chunk), WORD_ROUND(ntohs((chunk)->chunk_hdr.length)), member)
467 #define _sctp_walk_params(pos, chunk, end, member)\
468 for (pos.v = chunk->member;\
469 pos.v <= (void *)chunk + end - sizeof(sctp_paramhdr_t) &&\
470 pos.v <= (void *)chunk + end - WORD_ROUND(ntohs(pos.p->length)) &&\
471 ntohs(pos.p->length) >= sizeof(sctp_paramhdr_t);\
472 pos.v += WORD_ROUND(ntohs(pos.p->length)))
474 #define sctp_walk_errors(err, chunk_hdr)\
475 _sctp_walk_errors((err), (chunk_hdr), ntohs((chunk_hdr)->length))
477 #define _sctp_walk_errors(err, chunk_hdr, end)\
478 for (err = (sctp_errhdr_t *)((void *)chunk_hdr + \
479 sizeof(sctp_chunkhdr_t));\
480 (void *)err <= (void *)chunk_hdr + end - sizeof(sctp_errhdr_t) &&\
481 (void *)err <= (void *)chunk_hdr + end - WORD_ROUND(ntohs(err->length)) &&\
482 ntohs(err->length) >= sizeof(sctp_errhdr_t); \
483 err = (sctp_errhdr_t *)((void *)err + WORD_ROUND(ntohs(err->length))))
485 #define sctp_walk_fwdtsn(pos, chunk)\
486 _sctp_walk_fwdtsn((pos), (chunk), ntohs((chunk)->chunk_hdr->length) - sizeof(struct sctp_fwdtsn_chunk))
488 #define _sctp_walk_fwdtsn(pos, chunk, end)\
489 for (pos = chunk->subh.fwdtsn_hdr->skip;\
490 (void *)pos <= (void *)chunk->subh.fwdtsn_hdr->skip + end - sizeof(struct sctp_fwdtsn_skip);\
491 pos++)
493 /* Round an int up to the next multiple of 4. */
494 #define WORD_ROUND(s) (((s)+3)&~3)
496 /* Make a new instance of type. */
497 #define t_new(type, flags) (type *)kmalloc(sizeof(type), flags)
499 /* Compare two timevals. */
500 #define tv_lt(s, t) \
501 (s.tv_sec < t.tv_sec || (s.tv_sec == t.tv_sec && s.tv_usec < t.tv_usec))
503 /* Add tv1 to tv2. */
504 #define TIMEVAL_ADD(tv1, tv2) \
505 ({ \
506 suseconds_t usecs = (tv2).tv_usec + (tv1).tv_usec; \
507 time_t secs = (tv2).tv_sec + (tv1).tv_sec; \
509 if (usecs >= 1000000) { \
510 usecs -= 1000000; \
511 secs++; \
513 (tv2).tv_sec = secs; \
514 (tv2).tv_usec = usecs; \
517 /* External references. */
519 extern struct proto sctp_prot;
520 extern struct proto sctpv6_prot;
521 extern struct proc_dir_entry *proc_net_sctp;
522 void sctp_put_port(struct sock *sk);
524 extern struct idr sctp_assocs_id;
525 extern spinlock_t sctp_assocs_id_lock;
527 /* Static inline functions. */
529 /* Convert from an IP version number to an Address Family symbol. */
530 static inline int ipver2af(__u8 ipver)
532 switch (ipver) {
533 case 4:
534 return AF_INET;
535 case 6:
536 return AF_INET6;
537 default:
538 return 0;
542 /* Convert from an address parameter type to an address family. */
543 static inline int param_type2af(__u16 type)
545 switch (type) {
546 case SCTP_PARAM_IPV4_ADDRESS:
547 return AF_INET;
548 case SCTP_PARAM_IPV6_ADDRESS:
549 return AF_INET6;
550 default:
551 return 0;
555 /* Perform some sanity checks. */
556 static inline int sctp_sanity_check(void)
558 SCTP_ASSERT(sizeof(struct sctp_ulpevent) <=
559 sizeof(((struct sk_buff *)0)->cb),
560 "SCTP: ulpevent does not fit in skb!\n", return 0);
562 return 1;
565 /* Warning: The following hash functions assume a power of two 'size'. */
566 /* This is the hash function for the SCTP port hash table. */
567 static inline int sctp_phashfn(__u16 lport)
569 return (lport & (sctp_port_hashsize - 1));
572 /* This is the hash function for the endpoint hash table. */
573 static inline int sctp_ep_hashfn(__u16 lport)
575 return (lport & (sctp_ep_hashsize - 1));
578 /* This is the hash function for the association hash table. */
579 static inline int sctp_assoc_hashfn(__u16 lport, __u16 rport)
581 int h = (lport << 16) + rport;
582 h ^= h>>8;
583 return (h & (sctp_assoc_hashsize - 1));
586 /* This is the hash function for the association hash table. This is
587 * not used yet, but could be used as a better hash function when
588 * we have a vtag.
590 static inline int sctp_vtag_hashfn(__u16 lport, __u16 rport, __u32 vtag)
592 int h = (lport << 16) + rport;
593 h ^= vtag;
594 return (h & (sctp_assoc_hashsize-1));
597 /* Is a socket of this style? */
598 #define sctp_style(sk, style) __sctp_style((sk), (SCTP_SOCKET_##style))
599 static inline int __sctp_style(const struct sock *sk, sctp_socket_type_t style)
601 return sctp_sk(sk)->type == style;
604 /* Is the association in this state? */
605 #define sctp_state(asoc, state) __sctp_state((asoc), (SCTP_STATE_##state))
606 static inline int __sctp_state(const struct sctp_association *asoc,
607 sctp_state_t state)
609 return asoc->state == state;
612 /* Is the socket in this state? */
613 #define sctp_sstate(sk, state) __sctp_sstate((sk), (SCTP_SS_##state))
614 static inline int __sctp_sstate(const struct sock *sk, sctp_sock_state_t state)
616 return sk->sk_state == state;
619 /* Map v4-mapped v6 address back to v4 address */
620 static inline void sctp_v6_map_v4(union sctp_addr *addr)
622 addr->v4.sin_family = AF_INET;
623 addr->v4.sin_port = addr->v6.sin6_port;
624 addr->v4.sin_addr.s_addr = addr->v6.sin6_addr.s6_addr32[3];
627 /* Map v4 address to v4-mapped v6 address */
628 static inline void sctp_v4_map_v6(union sctp_addr *addr)
630 addr->v6.sin6_family = AF_INET6;
631 addr->v6.sin6_port = addr->v4.sin_port;
632 addr->v6.sin6_addr.s6_addr32[3] = addr->v4.sin_addr.s_addr;
633 addr->v6.sin6_addr.s6_addr32[0] = 0;
634 addr->v6.sin6_addr.s6_addr32[1] = 0;
635 addr->v6.sin6_addr.s6_addr32[2] = htonl(0x0000ffff);
638 #endif /* __net_sctp_h__ */