1 /* SCTP kernel implementation
2 * Copyright (c) 1999-2000 Cisco, Inc.
3 * Copyright (c) 1999-2001 Motorola, Inc.
4 * Copyright (c) 2001-2003 International Business Machines, Corp.
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 * These functions handle all input from the IP layer into SCTP.
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)
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
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 * Xingang Guo <xingang.guo@intel.com>
41 * Jon Grimm <jgrimm@us.ibm.com>
42 * Hui Huang <hui.huang@nokia.com>
43 * Daisy Chang <daisyc@us.ibm.com>
44 * Sridhar Samudrala <sri@us.ibm.com>
45 * Ardelle Fan <ardelle.fan@intel.com>
47 * Any bugs reported given to us we will try to fix... any fixes shared will
48 * be incorporated into the next SCTP release.
51 #include <linux/types.h>
52 #include <linux/list.h> /* For struct list_head */
53 #include <linux/socket.h>
55 #include <linux/time.h> /* For struct timeval */
61 #include <net/sctp/sctp.h>
62 #include <net/sctp/sm.h>
63 #include <net/sctp/checksum.h>
64 #include <net/net_namespace.h>
66 /* Forward declarations for internal helpers. */
67 static int sctp_rcv_ootb(struct sk_buff *);
68 static struct sctp_association *__sctp_rcv_lookup(struct sk_buff *skb,
69 const union sctp_addr *laddr,
70 const union sctp_addr *paddr,
71 struct sctp_transport **transportp);
72 static struct sctp_endpoint *__sctp_rcv_lookup_endpoint(const union sctp_addr *laddr);
73 static struct sctp_association *__sctp_lookup_association(
74 const union sctp_addr *local,
75 const union sctp_addr *peer,
76 struct sctp_transport **pt);
78 static void sctp_add_backlog(struct sock *sk, struct sk_buff *skb);
81 /* Calculate the SCTP checksum of an SCTP packet. */
82 static inline int sctp_rcv_checksum(struct sk_buff *skb)
84 struct sk_buff *list = skb_shinfo(skb)->frag_list;
85 struct sctphdr *sh = sctp_hdr(skb);
86 __be32 cmp = sh->checksum;
87 __be32 val = sctp_start_cksum((__u8 *)sh, skb_headlen(skb));
89 for (; list; list = list->next)
90 val = sctp_update_cksum((__u8 *)list->data, skb_headlen(list),
93 val = sctp_end_cksum(val);
96 /* CRC failure, dump it. */
97 SCTP_INC_STATS_BH(SCTP_MIB_CHECKSUMERRORS);
103 struct sctp_input_cb {
105 struct inet_skb_parm h4;
106 #if defined(CONFIG_IPV6) || defined (CONFIG_IPV6_MODULE)
107 struct inet6_skb_parm h6;
110 struct sctp_chunk *chunk;
112 #define SCTP_INPUT_CB(__skb) ((struct sctp_input_cb *)&((__skb)->cb[0]))
115 * This is the routine which IP calls when receiving an SCTP packet.
117 int sctp_rcv(struct sk_buff *skb)
120 struct sctp_association *asoc;
121 struct sctp_endpoint *ep = NULL;
122 struct sctp_ep_common *rcvr;
123 struct sctp_transport *transport = NULL;
124 struct sctp_chunk *chunk;
127 union sctp_addr dest;
131 if (skb->pkt_type!=PACKET_HOST)
134 SCTP_INC_STATS_BH(SCTP_MIB_INSCTPPACKS);
136 if (skb_linearize(skb))
141 /* Pull up the IP and SCTP headers. */
142 __skb_pull(skb, skb_transport_offset(skb));
143 if (skb->len < sizeof(struct sctphdr))
145 if (!skb_csum_unnecessary(skb) && sctp_rcv_checksum(skb) < 0)
148 skb_pull(skb, sizeof(struct sctphdr));
150 /* Make sure we at least have chunk headers worth of data left. */
151 if (skb->len < sizeof(struct sctp_chunkhdr))
154 family = ipver2af(ip_hdr(skb)->version);
155 af = sctp_get_af_specific(family);
159 /* Initialize local addresses for lookups. */
160 af->from_skb(&src, skb, 1);
161 af->from_skb(&dest, skb, 0);
163 /* If the packet is to or from a non-unicast address,
164 * silently discard the packet.
166 * This is not clearly defined in the RFC except in section
167 * 8.4 - OOTB handling. However, based on the book "Stream Control
168 * Transmission Protocol" 2.1, "It is important to note that the
169 * IP address of an SCTP transport address must be a routable
170 * unicast address. In other words, IP multicast addresses and
171 * IP broadcast addresses cannot be used in an SCTP transport
174 if (!af->addr_valid(&src, NULL, skb) ||
175 !af->addr_valid(&dest, NULL, skb))
178 asoc = __sctp_rcv_lookup(skb, &src, &dest, &transport);
181 ep = __sctp_rcv_lookup_endpoint(&dest);
183 /* Retrieve the common input handling substructure. */
184 rcvr = asoc ? &asoc->base : &ep->base;
188 * If a frame arrives on an interface and the receiving socket is
189 * bound to another interface, via SO_BINDTODEVICE, treat it as OOTB
191 if (sk->sk_bound_dev_if && (sk->sk_bound_dev_if != af->skb_iif(skb)))
194 sctp_association_put(asoc);
197 sctp_endpoint_put(ep);
200 sk = sctp_get_ctl_sock();
201 ep = sctp_sk(sk)->ep;
202 sctp_endpoint_hold(ep);
207 * RFC 2960, 8.4 - Handle "Out of the blue" Packets.
208 * An SCTP packet is called an "out of the blue" (OOTB)
209 * packet if it is correctly formed, i.e., passed the
210 * receiver's checksum check, but the receiver is not
211 * able to identify the association to which this
215 if (sctp_rcv_ootb(skb)) {
216 SCTP_INC_STATS_BH(SCTP_MIB_OUTOFBLUES);
217 goto discard_release;
221 if (!xfrm_policy_check(sk, XFRM_POLICY_IN, skb, family))
222 goto discard_release;
225 if (sk_filter(sk, skb))
226 goto discard_release;
228 /* Create an SCTP packet structure. */
229 chunk = sctp_chunkify(skb, asoc, sk);
231 goto discard_release;
232 SCTP_INPUT_CB(skb)->chunk = chunk;
234 /* Remember what endpoint is to handle this packet. */
237 /* Remember the SCTP header. */
238 chunk->sctp_hdr = sh;
240 /* Set the source and destination addresses of the incoming chunk. */
241 sctp_init_addrs(chunk, &src, &dest);
243 /* Remember where we came from. */
244 chunk->transport = transport;
246 /* Acquire access to the sock lock. Note: We are safe from other
247 * bottom halves on this lock, but a user may be in the lock too,
248 * so check if it is busy.
250 sctp_bh_lock_sock(sk);
252 if (sock_owned_by_user(sk)) {
253 SCTP_INC_STATS_BH(SCTP_MIB_IN_PKT_BACKLOG);
254 sctp_add_backlog(sk, skb);
256 SCTP_INC_STATS_BH(SCTP_MIB_IN_PKT_SOFTIRQ);
257 sctp_inq_push(&chunk->rcvr->inqueue, chunk);
260 sctp_bh_unlock_sock(sk);
262 /* Release the asoc/ep ref we took in the lookup calls. */
264 sctp_association_put(asoc);
266 sctp_endpoint_put(ep);
271 SCTP_INC_STATS_BH(SCTP_MIB_IN_PKT_DISCARDS);
276 /* Release the asoc/ep ref we took in the lookup calls. */
278 sctp_association_put(asoc);
280 sctp_endpoint_put(ep);
285 /* Process the backlog queue of the socket. Every skb on
286 * the backlog holds a ref on an association or endpoint.
287 * We hold this ref throughout the state machine to make
288 * sure that the structure we need is still around.
290 int sctp_backlog_rcv(struct sock *sk, struct sk_buff *skb)
292 struct sctp_chunk *chunk = SCTP_INPUT_CB(skb)->chunk;
293 struct sctp_inq *inqueue = &chunk->rcvr->inqueue;
294 struct sctp_ep_common *rcvr = NULL;
299 /* If the rcvr is dead then the association or endpoint
300 * has been deleted and we can safely drop the chunk
301 * and refs that we are holding.
304 sctp_chunk_free(chunk);
308 if (unlikely(rcvr->sk != sk)) {
309 /* In this case, the association moved from one socket to
310 * another. We are currently sitting on the backlog of the
311 * old socket, so we need to move.
312 * However, since we are here in the process context we
313 * need to take make sure that the user doesn't own
314 * the new socket when we process the packet.
315 * If the new socket is user-owned, queue the chunk to the
316 * backlog of the new socket without dropping any refs.
317 * Otherwise, we can safely push the chunk on the inqueue.
321 sctp_bh_lock_sock(sk);
323 if (sock_owned_by_user(sk)) {
324 sk_add_backlog(sk, skb);
327 sctp_inq_push(inqueue, chunk);
329 sctp_bh_unlock_sock(sk);
331 /* If the chunk was backloged again, don't drop refs */
335 sctp_inq_push(inqueue, chunk);
339 /* Release the refs we took in sctp_add_backlog */
340 if (SCTP_EP_TYPE_ASSOCIATION == rcvr->type)
341 sctp_association_put(sctp_assoc(rcvr));
342 else if (SCTP_EP_TYPE_SOCKET == rcvr->type)
343 sctp_endpoint_put(sctp_ep(rcvr));
350 static void sctp_add_backlog(struct sock *sk, struct sk_buff *skb)
352 struct sctp_chunk *chunk = SCTP_INPUT_CB(skb)->chunk;
353 struct sctp_ep_common *rcvr = chunk->rcvr;
355 /* Hold the assoc/ep while hanging on the backlog queue.
356 * This way, we know structures we need will not disappear from us
358 if (SCTP_EP_TYPE_ASSOCIATION == rcvr->type)
359 sctp_association_hold(sctp_assoc(rcvr));
360 else if (SCTP_EP_TYPE_SOCKET == rcvr->type)
361 sctp_endpoint_hold(sctp_ep(rcvr));
365 sk_add_backlog(sk, skb);
368 /* Handle icmp frag needed error. */
369 void sctp_icmp_frag_needed(struct sock *sk, struct sctp_association *asoc,
370 struct sctp_transport *t, __u32 pmtu)
372 if (!t || (t->pathmtu <= pmtu))
375 if (sock_owned_by_user(sk)) {
376 asoc->pmtu_pending = 1;
381 if (t->param_flags & SPP_PMTUD_ENABLE) {
382 /* Update transports view of the MTU */
383 sctp_transport_update_pmtu(t, pmtu);
385 /* Update association pmtu. */
386 sctp_assoc_sync_pmtu(asoc);
389 /* Retransmit with the new pmtu setting.
390 * Normally, if PMTU discovery is disabled, an ICMP Fragmentation
391 * Needed will never be sent, but if a message was sent before
392 * PMTU discovery was disabled that was larger than the PMTU, it
393 * would not be fragmented, so it must be re-transmitted fragmented.
395 sctp_retransmit(&asoc->outqueue, t, SCTP_RTXR_PMTUD);
399 * SCTP Implementer's Guide, 2.37 ICMP handling procedures
401 * ICMP8) If the ICMP code is a "Unrecognized next header type encountered"
402 * or a "Protocol Unreachable" treat this message as an abort
403 * with the T bit set.
405 * This function sends an event to the state machine, which will abort the
409 void sctp_icmp_proto_unreachable(struct sock *sk,
410 struct sctp_association *asoc,
411 struct sctp_transport *t)
413 SCTP_DEBUG_PRINTK("%s\n", __func__);
415 sctp_do_sm(SCTP_EVENT_T_OTHER,
416 SCTP_ST_OTHER(SCTP_EVENT_ICMP_PROTO_UNREACH),
417 asoc->state, asoc->ep, asoc, t,
422 /* Common lookup code for icmp/icmpv6 error handler. */
423 struct sock *sctp_err_lookup(int family, struct sk_buff *skb,
424 struct sctphdr *sctphdr,
425 struct sctp_association **app,
426 struct sctp_transport **tpp)
428 union sctp_addr saddr;
429 union sctp_addr daddr;
431 struct sock *sk = NULL;
432 struct sctp_association *asoc;
433 struct sctp_transport *transport = NULL;
434 struct sctp_init_chunk *chunkhdr;
435 __u32 vtag = ntohl(sctphdr->vtag);
436 int len = skb->len - ((void *)sctphdr - (void *)skb->data);
438 *app = NULL; *tpp = NULL;
440 af = sctp_get_af_specific(family);
445 /* Initialize local addresses for lookups. */
446 af->from_skb(&saddr, skb, 1);
447 af->from_skb(&daddr, skb, 0);
449 /* Look for an association that matches the incoming ICMP error
452 asoc = __sctp_lookup_association(&saddr, &daddr, &transport);
458 /* RFC 4960, Appendix C. ICMP Handling
460 * ICMP6) An implementation MUST validate that the Verification Tag
461 * contained in the ICMP message matches the Verification Tag of
462 * the peer. If the Verification Tag is not 0 and does NOT
463 * match, discard the ICMP message. If it is 0 and the ICMP
464 * message contains enough bytes to verify that the chunk type is
465 * an INIT chunk and that the Initiate Tag matches the tag of the
466 * peer, continue with ICMP7. If the ICMP message is too short
467 * or the chunk type or the Initiate Tag does not match, silently
468 * discard the packet.
471 chunkhdr = (struct sctp_init_chunk *)((void *)sctphdr
472 + sizeof(struct sctphdr));
473 if (len < sizeof(struct sctphdr) + sizeof(sctp_chunkhdr_t)
475 chunkhdr->chunk_hdr.type != SCTP_CID_INIT ||
476 ntohl(chunkhdr->init_hdr.init_tag) != asoc->c.my_vtag) {
479 } else if (vtag != asoc->c.peer_vtag) {
483 sctp_bh_lock_sock(sk);
485 /* If too many ICMPs get dropped on busy
486 * servers this needs to be solved differently.
488 if (sock_owned_by_user(sk))
489 NET_INC_STATS_BH(&init_net, LINUX_MIB_LOCKDROPPEDICMPS);
497 sctp_association_put(asoc);
501 /* Common cleanup code for icmp/icmpv6 error handler. */
502 void sctp_err_finish(struct sock *sk, struct sctp_association *asoc)
504 sctp_bh_unlock_sock(sk);
506 sctp_association_put(asoc);
510 * This routine is called by the ICMP module when it gets some
511 * sort of error condition. If err < 0 then the socket should
512 * be closed and the error returned to the user. If err > 0
513 * it's just the icmp type << 8 | icmp code. After adjustment
514 * header points to the first 8 bytes of the sctp header. We need
515 * to find the appropriate port.
517 * The locking strategy used here is very "optimistic". When
518 * someone else accesses the socket the ICMP is just dropped
519 * and for some paths there is no check at all.
520 * A more general error queue to queue errors for later handling
521 * is probably better.
524 void sctp_v4_err(struct sk_buff *skb, __u32 info)
526 struct iphdr *iph = (struct iphdr *)skb->data;
527 const int ihlen = iph->ihl * 4;
528 const int type = icmp_hdr(skb)->type;
529 const int code = icmp_hdr(skb)->code;
531 struct sctp_association *asoc = NULL;
532 struct sctp_transport *transport;
533 struct inet_sock *inet;
534 sk_buff_data_t saveip, savesctp;
537 if (skb->len < ihlen + 8) {
538 ICMP_INC_STATS_BH(&init_net, ICMP_MIB_INERRORS);
542 /* Fix up skb to look at the embedded net header. */
543 saveip = skb->network_header;
544 savesctp = skb->transport_header;
545 skb_reset_network_header(skb);
546 skb_set_transport_header(skb, ihlen);
547 sk = sctp_err_lookup(AF_INET, skb, sctp_hdr(skb), &asoc, &transport);
548 /* Put back, the original values. */
549 skb->network_header = saveip;
550 skb->transport_header = savesctp;
552 ICMP_INC_STATS_BH(&init_net, ICMP_MIB_INERRORS);
555 /* Warning: The sock lock is held. Remember to call
560 case ICMP_PARAMETERPROB:
563 case ICMP_DEST_UNREACH:
564 if (code > NR_ICMP_UNREACH)
567 /* PMTU discovery (RFC1191) */
568 if (ICMP_FRAG_NEEDED == code) {
569 sctp_icmp_frag_needed(sk, asoc, transport, info);
573 if (ICMP_PROT_UNREACH == code) {
574 sctp_icmp_proto_unreachable(sk, asoc,
579 err = icmp_err_convert[code].errno;
581 case ICMP_TIME_EXCEEDED:
582 /* Ignore any time exceeded errors due to fragment reassembly
585 if (ICMP_EXC_FRAGTIME == code)
595 if (!sock_owned_by_user(sk) && inet->recverr) {
597 sk->sk_error_report(sk);
598 } else { /* Only an error on timeout */
599 sk->sk_err_soft = err;
603 sctp_err_finish(sk, asoc);
607 * RFC 2960, 8.4 - Handle "Out of the blue" Packets.
609 * This function scans all the chunks in the OOTB packet to determine if
610 * the packet should be discarded right away. If a response might be needed
611 * for this packet, or, if further processing is possible, the packet will
612 * be queued to a proper inqueue for the next phase of handling.
615 * Return 0 - If further processing is needed.
616 * Return 1 - If the packet can be discarded right away.
618 static int sctp_rcv_ootb(struct sk_buff *skb)
624 ch = (sctp_chunkhdr_t *) skb->data;
626 /* Scan through all the chunks in the packet. */
628 /* Break out if chunk length is less then minimal. */
629 if (ntohs(ch->length) < sizeof(sctp_chunkhdr_t))
632 ch_end = ((__u8 *)ch) + WORD_ROUND(ntohs(ch->length));
633 if (ch_end > skb_tail_pointer(skb))
636 /* RFC 8.4, 2) If the OOTB packet contains an ABORT chunk, the
637 * receiver MUST silently discard the OOTB packet and take no
640 if (SCTP_CID_ABORT == ch->type)
643 /* RFC 8.4, 6) If the packet contains a SHUTDOWN COMPLETE
644 * chunk, the receiver should silently discard the packet
645 * and take no further action.
647 if (SCTP_CID_SHUTDOWN_COMPLETE == ch->type)
651 * This will discard packets with INIT chunk bundled as
652 * subsequent chunks in the packet. When INIT is first,
653 * the normal INIT processing will discard the chunk.
655 if (SCTP_CID_INIT == ch->type && (void *)ch != skb->data)
658 /* RFC 8.4, 7) If the packet contains a "Stale cookie" ERROR
659 * or a COOKIE ACK the SCTP Packet should be silently
662 if (SCTP_CID_COOKIE_ACK == ch->type)
665 if (SCTP_CID_ERROR == ch->type) {
666 sctp_walk_errors(err, ch) {
667 if (SCTP_ERROR_STALE_COOKIE == err->cause)
672 ch = (sctp_chunkhdr_t *) ch_end;
673 } while (ch_end < skb_tail_pointer(skb));
681 /* Insert endpoint into the hash table. */
682 static void __sctp_hash_endpoint(struct sctp_endpoint *ep)
684 struct sctp_ep_common *epb;
685 struct sctp_hashbucket *head;
689 epb->hashent = sctp_ep_hashfn(epb->bind_addr.port);
690 head = &sctp_ep_hashtable[epb->hashent];
692 sctp_write_lock(&head->lock);
693 hlist_add_head(&epb->node, &head->chain);
694 sctp_write_unlock(&head->lock);
697 /* Add an endpoint to the hash. Local BH-safe. */
698 void sctp_hash_endpoint(struct sctp_endpoint *ep)
700 sctp_local_bh_disable();
701 __sctp_hash_endpoint(ep);
702 sctp_local_bh_enable();
705 /* Remove endpoint from the hash table. */
706 static void __sctp_unhash_endpoint(struct sctp_endpoint *ep)
708 struct sctp_hashbucket *head;
709 struct sctp_ep_common *epb;
713 if (hlist_unhashed(&epb->node))
716 epb->hashent = sctp_ep_hashfn(epb->bind_addr.port);
718 head = &sctp_ep_hashtable[epb->hashent];
720 sctp_write_lock(&head->lock);
721 __hlist_del(&epb->node);
722 sctp_write_unlock(&head->lock);
725 /* Remove endpoint from the hash. Local BH-safe. */
726 void sctp_unhash_endpoint(struct sctp_endpoint *ep)
728 sctp_local_bh_disable();
729 __sctp_unhash_endpoint(ep);
730 sctp_local_bh_enable();
733 /* Look up an endpoint. */
734 static struct sctp_endpoint *__sctp_rcv_lookup_endpoint(const union sctp_addr *laddr)
736 struct sctp_hashbucket *head;
737 struct sctp_ep_common *epb;
738 struct sctp_endpoint *ep;
739 struct hlist_node *node;
742 hash = sctp_ep_hashfn(ntohs(laddr->v4.sin_port));
743 head = &sctp_ep_hashtable[hash];
744 read_lock(&head->lock);
745 sctp_for_each_hentry(epb, node, &head->chain) {
747 if (sctp_endpoint_is_match(ep, laddr))
751 ep = sctp_sk((sctp_get_ctl_sock()))->ep;
754 sctp_endpoint_hold(ep);
755 read_unlock(&head->lock);
759 /* Insert association into the hash table. */
760 static void __sctp_hash_established(struct sctp_association *asoc)
762 struct sctp_ep_common *epb;
763 struct sctp_hashbucket *head;
767 /* Calculate which chain this entry will belong to. */
768 epb->hashent = sctp_assoc_hashfn(epb->bind_addr.port, asoc->peer.port);
770 head = &sctp_assoc_hashtable[epb->hashent];
772 sctp_write_lock(&head->lock);
773 hlist_add_head(&epb->node, &head->chain);
774 sctp_write_unlock(&head->lock);
777 /* Add an association to the hash. Local BH-safe. */
778 void sctp_hash_established(struct sctp_association *asoc)
783 sctp_local_bh_disable();
784 __sctp_hash_established(asoc);
785 sctp_local_bh_enable();
788 /* Remove association from the hash table. */
789 static void __sctp_unhash_established(struct sctp_association *asoc)
791 struct sctp_hashbucket *head;
792 struct sctp_ep_common *epb;
796 epb->hashent = sctp_assoc_hashfn(epb->bind_addr.port,
799 head = &sctp_assoc_hashtable[epb->hashent];
801 sctp_write_lock(&head->lock);
802 __hlist_del(&epb->node);
803 sctp_write_unlock(&head->lock);
806 /* Remove association from the hash table. Local BH-safe. */
807 void sctp_unhash_established(struct sctp_association *asoc)
812 sctp_local_bh_disable();
813 __sctp_unhash_established(asoc);
814 sctp_local_bh_enable();
817 /* Look up an association. */
818 static struct sctp_association *__sctp_lookup_association(
819 const union sctp_addr *local,
820 const union sctp_addr *peer,
821 struct sctp_transport **pt)
823 struct sctp_hashbucket *head;
824 struct sctp_ep_common *epb;
825 struct sctp_association *asoc;
826 struct sctp_transport *transport;
827 struct hlist_node *node;
830 /* Optimize here for direct hit, only listening connections can
831 * have wildcards anyways.
833 hash = sctp_assoc_hashfn(ntohs(local->v4.sin_port), ntohs(peer->v4.sin_port));
834 head = &sctp_assoc_hashtable[hash];
835 read_lock(&head->lock);
836 sctp_for_each_hentry(epb, node, &head->chain) {
837 asoc = sctp_assoc(epb);
838 transport = sctp_assoc_is_match(asoc, local, peer);
843 read_unlock(&head->lock);
849 sctp_association_hold(asoc);
850 read_unlock(&head->lock);
854 /* Look up an association. BH-safe. */
856 struct sctp_association *sctp_lookup_association(const union sctp_addr *laddr,
857 const union sctp_addr *paddr,
858 struct sctp_transport **transportp)
860 struct sctp_association *asoc;
862 sctp_local_bh_disable();
863 asoc = __sctp_lookup_association(laddr, paddr, transportp);
864 sctp_local_bh_enable();
869 /* Is there an association matching the given local and peer addresses? */
870 int sctp_has_association(const union sctp_addr *laddr,
871 const union sctp_addr *paddr)
873 struct sctp_association *asoc;
874 struct sctp_transport *transport;
876 if ((asoc = sctp_lookup_association(laddr, paddr, &transport))) {
877 sctp_association_put(asoc);
885 * SCTP Implementors Guide, 2.18 Handling of address
886 * parameters within the INIT or INIT-ACK.
888 * D) When searching for a matching TCB upon reception of an INIT
889 * or INIT-ACK chunk the receiver SHOULD use not only the
890 * source address of the packet (containing the INIT or
891 * INIT-ACK) but the receiver SHOULD also use all valid
892 * address parameters contained within the chunk.
894 * 2.18.3 Solution description
896 * This new text clearly specifies to an implementor the need
897 * to look within the INIT or INIT-ACK. Any implementation that
898 * does not do this, may not be able to establish associations
899 * in certain circumstances.
902 static struct sctp_association *__sctp_rcv_init_lookup(struct sk_buff *skb,
903 const union sctp_addr *laddr, struct sctp_transport **transportp)
905 struct sctp_association *asoc;
906 union sctp_addr addr;
907 union sctp_addr *paddr = &addr;
908 struct sctphdr *sh = sctp_hdr(skb);
910 union sctp_params params;
911 sctp_init_chunk_t *init;
912 struct sctp_transport *transport;
915 ch = (sctp_chunkhdr_t *) skb->data;
918 * This code will NOT touch anything inside the chunk--it is
919 * strictly READ-ONLY.
921 * RFC 2960 3 SCTP packet Format
923 * Multiple chunks can be bundled into one SCTP packet up to
924 * the MTU size, except for the INIT, INIT ACK, and SHUTDOWN
925 * COMPLETE chunks. These chunks MUST NOT be bundled with any
926 * other chunk in a packet. See Section 6.10 for more details
930 /* Find the start of the TLVs and the end of the chunk. This is
931 * the region we search for address parameters.
933 init = (sctp_init_chunk_t *)skb->data;
935 /* Walk the parameters looking for embedded addresses. */
936 sctp_walk_params(params, init, init_hdr.params) {
938 /* Note: Ignoring hostname addresses. */
939 af = sctp_get_af_specific(param_type2af(params.p->type));
943 af->from_addr_param(paddr, params.addr, sh->source, 0);
945 asoc = __sctp_lookup_association(laddr, paddr, &transport);
953 /* ADD-IP, Section 5.2
954 * When an endpoint receives an ASCONF Chunk from the remote peer
955 * special procedures may be needed to identify the association the
956 * ASCONF Chunk is associated with. To properly find the association
957 * the following procedures SHOULD be followed:
959 * D2) If the association is not found, use the address found in the
960 * Address Parameter TLV combined with the port number found in the
961 * SCTP common header. If found proceed to rule D4.
963 * D2-ext) If more than one ASCONF Chunks are packed together, use the
964 * address found in the ASCONF Address Parameter TLV of each of the
965 * subsequent ASCONF Chunks. If found, proceed to rule D4.
967 static struct sctp_association *__sctp_rcv_asconf_lookup(
969 const union sctp_addr *laddr,
971 struct sctp_transport **transportp)
973 sctp_addip_chunk_t *asconf = (struct sctp_addip_chunk *)ch;
975 union sctp_addr_param *param;
976 union sctp_addr paddr;
978 /* Skip over the ADDIP header and find the Address parameter */
979 param = (union sctp_addr_param *)(asconf + 1);
981 af = sctp_get_af_specific(param_type2af(param->v4.param_hdr.type));
985 af->from_addr_param(&paddr, param, peer_port, 0);
987 return __sctp_lookup_association(laddr, &paddr, transportp);
991 /* SCTP-AUTH, Section 6.3:
992 * If the receiver does not find a STCB for a packet containing an AUTH
993 * chunk as the first chunk and not a COOKIE-ECHO chunk as the second
994 * chunk, it MUST use the chunks after the AUTH chunk to look up an existing
997 * This means that any chunks that can help us identify the association need
998 * to be looked at to find this assocation.
1000 static struct sctp_association *__sctp_rcv_walk_lookup(struct sk_buff *skb,
1001 const union sctp_addr *laddr,
1002 struct sctp_transport **transportp)
1004 struct sctp_association *asoc = NULL;
1005 sctp_chunkhdr_t *ch;
1007 unsigned int chunk_num = 1;
1010 /* Walk through the chunks looking for AUTH or ASCONF chunks
1011 * to help us find the association.
1013 ch = (sctp_chunkhdr_t *) skb->data;
1015 /* Break out if chunk length is less then minimal. */
1016 if (ntohs(ch->length) < sizeof(sctp_chunkhdr_t))
1019 ch_end = ((__u8 *)ch) + WORD_ROUND(ntohs(ch->length));
1020 if (ch_end > skb_tail_pointer(skb))
1025 have_auth = chunk_num;
1028 case SCTP_CID_COOKIE_ECHO:
1029 /* If a packet arrives containing an AUTH chunk as
1030 * a first chunk, a COOKIE-ECHO chunk as the second
1031 * chunk, and possibly more chunks after them, and
1032 * the receiver does not have an STCB for that
1033 * packet, then authentication is based on
1034 * the contents of the COOKIE- ECHO chunk.
1036 if (have_auth == 1 && chunk_num == 2)
1040 case SCTP_CID_ASCONF:
1041 if (have_auth || sctp_addip_noauth)
1042 asoc = __sctp_rcv_asconf_lookup(ch, laddr,
1043 sctp_hdr(skb)->source,
1052 ch = (sctp_chunkhdr_t *) ch_end;
1054 } while (ch_end < skb_tail_pointer(skb));
1060 * There are circumstances when we need to look inside the SCTP packet
1061 * for information to help us find the association. Examples
1062 * include looking inside of INIT/INIT-ACK chunks or after the AUTH
1065 static struct sctp_association *__sctp_rcv_lookup_harder(struct sk_buff *skb,
1066 const union sctp_addr *laddr,
1067 struct sctp_transport **transportp)
1069 sctp_chunkhdr_t *ch;
1071 ch = (sctp_chunkhdr_t *) skb->data;
1073 /* The code below will attempt to walk the chunk and extract
1074 * parameter information. Before we do that, we need to verify
1075 * that the chunk length doesn't cause overflow. Otherwise, we'll
1078 if (WORD_ROUND(ntohs(ch->length)) > skb->len)
1081 /* If this is INIT/INIT-ACK look inside the chunk too. */
1084 case SCTP_CID_INIT_ACK:
1085 return __sctp_rcv_init_lookup(skb, laddr, transportp);
1089 return __sctp_rcv_walk_lookup(skb, laddr, transportp);
1097 /* Lookup an association for an inbound skb. */
1098 static struct sctp_association *__sctp_rcv_lookup(struct sk_buff *skb,
1099 const union sctp_addr *paddr,
1100 const union sctp_addr *laddr,
1101 struct sctp_transport **transportp)
1103 struct sctp_association *asoc;
1105 asoc = __sctp_lookup_association(laddr, paddr, transportp);
1107 /* Further lookup for INIT/INIT-ACK packets.
1108 * SCTP Implementors Guide, 2.18 Handling of address
1109 * parameters within the INIT or INIT-ACK.
1112 asoc = __sctp_rcv_lookup_harder(skb, laddr, transportp);