xref: /linux/net/sctp/associola.c (revision 9d19ca5d0e8b4a3f4b2eaa14e86a25f1c93ff35b)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* SCTP kernel implementation
3  * (C) Copyright IBM Corp. 2001, 2004
4  * Copyright (c) 1999-2000 Cisco, Inc.
5  * Copyright (c) 1999-2001 Motorola, Inc.
6  * Copyright (c) 2001 Intel Corp.
7  * Copyright (c) 2001 La Monte H.P. Yarroll
8  *
9  * This file is part of the SCTP kernel implementation
10  *
11  * This module provides the abstraction for an SCTP association.
12  *
13  * Please send any bug reports or fixes you make to the
14  * email address(es):
15  *    lksctp developers <linux-sctp@vger.kernel.org>
16  *
17  * Written or modified by:
18  *    La Monte H.P. Yarroll <piggy@acm.org>
19  *    Karl Knutson          <karl@athena.chicago.il.us>
20  *    Jon Grimm             <jgrimm@us.ibm.com>
21  *    Xingang Guo           <xingang.guo@intel.com>
22  *    Hui Huang             <hui.huang@nokia.com>
23  *    Sridhar Samudrala	    <sri@us.ibm.com>
24  *    Daisy Chang	    <daisyc@us.ibm.com>
25  *    Ryan Layer	    <rmlayer@us.ibm.com>
26  *    Kevin Gao             <kevin.gao@intel.com>
27  */
28 
29 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
30 
31 #include <linux/types.h>
32 #include <linux/fcntl.h>
33 #include <linux/poll.h>
34 #include <linux/init.h>
35 
36 #include <linux/slab.h>
37 #include <linux/in.h>
38 #include <net/ipv6.h>
39 #include <net/sctp/sctp.h>
40 #include <net/sctp/sm.h>
41 
42 /* Forward declarations for internal functions. */
43 static void sctp_select_active_and_retran_path(struct sctp_association *asoc);
44 static void sctp_assoc_bh_rcv(struct work_struct *work);
45 static void sctp_assoc_free_asconf_acks(struct sctp_association *asoc);
46 static void sctp_assoc_free_asconf_queue(struct sctp_association *asoc);
47 
48 /* 1st Level Abstractions. */
49 
50 /* Initialize a new association from provided memory. */
51 static struct sctp_association *sctp_association_init(
52 					struct sctp_association *asoc,
53 					const struct sctp_endpoint *ep,
54 					const struct sock *sk,
55 					enum sctp_scope scope, gfp_t gfp)
56 {
57 	struct sctp_sock *sp;
58 	struct sctp_paramhdr *p;
59 	int i;
60 
61 	/* Retrieve the SCTP per socket area.  */
62 	sp = sctp_sk((struct sock *)sk);
63 
64 	/* Discarding const is appropriate here.  */
65 	asoc->ep = (struct sctp_endpoint *)ep;
66 	asoc->base.sk = (struct sock *)sk;
67 	asoc->base.net = sock_net(sk);
68 
69 	sctp_endpoint_hold(asoc->ep);
70 	sock_hold(asoc->base.sk);
71 
72 	/* Initialize the common base substructure.  */
73 	asoc->base.type = SCTP_EP_TYPE_ASSOCIATION;
74 
75 	/* Initialize the object handling fields.  */
76 	refcount_set(&asoc->base.refcnt, 1);
77 
78 	/* Initialize the bind addr area.  */
79 	sctp_bind_addr_init(&asoc->base.bind_addr, ep->base.bind_addr.port);
80 
81 	asoc->state = SCTP_STATE_CLOSED;
82 	asoc->cookie_life = ms_to_ktime(sp->assocparams.sasoc_cookie_life);
83 	asoc->user_frag = sp->user_frag;
84 
85 	/* Set the association max_retrans and RTO values from the
86 	 * socket values.
87 	 */
88 	asoc->max_retrans = sp->assocparams.sasoc_asocmaxrxt;
89 	asoc->pf_retrans  = sp->pf_retrans;
90 	asoc->ps_retrans  = sp->ps_retrans;
91 	asoc->pf_expose   = sp->pf_expose;
92 
93 	asoc->rto_initial = msecs_to_jiffies(sp->rtoinfo.srto_initial);
94 	asoc->rto_max = msecs_to_jiffies(sp->rtoinfo.srto_max);
95 	asoc->rto_min = msecs_to_jiffies(sp->rtoinfo.srto_min);
96 
97 	/* Initialize the association's heartbeat interval based on the
98 	 * sock configured value.
99 	 */
100 	asoc->hbinterval = msecs_to_jiffies(sp->hbinterval);
101 	asoc->probe_interval = msecs_to_jiffies(sp->probe_interval);
102 
103 	asoc->encap_port = sp->encap_port;
104 
105 	/* Initialize path max retrans value. */
106 	asoc->pathmaxrxt = sp->pathmaxrxt;
107 
108 	asoc->flowlabel = sp->flowlabel;
109 	asoc->dscp = sp->dscp;
110 
111 	/* Set association default SACK delay */
112 	asoc->sackdelay = msecs_to_jiffies(sp->sackdelay);
113 	asoc->sackfreq = sp->sackfreq;
114 
115 	/* Set the association default flags controlling
116 	 * Heartbeat, SACK delay, and Path MTU Discovery.
117 	 */
118 	asoc->param_flags = sp->param_flags;
119 
120 	/* Initialize the maximum number of new data packets that can be sent
121 	 * in a burst.
122 	 */
123 	asoc->max_burst = sp->max_burst;
124 
125 	asoc->subscribe = sp->subscribe;
126 
127 	/* initialize association timers */
128 	asoc->timeouts[SCTP_EVENT_TIMEOUT_T1_COOKIE] = asoc->rto_initial;
129 	asoc->timeouts[SCTP_EVENT_TIMEOUT_T1_INIT] = asoc->rto_initial;
130 	asoc->timeouts[SCTP_EVENT_TIMEOUT_T2_SHUTDOWN] = asoc->rto_initial;
131 
132 	/* sctpimpguide Section 2.12.2
133 	 * If the 'T5-shutdown-guard' timer is used, it SHOULD be set to the
134 	 * recommended value of 5 times 'RTO.Max'.
135 	 */
136 	asoc->timeouts[SCTP_EVENT_TIMEOUT_T5_SHUTDOWN_GUARD]
137 		= 5 * asoc->rto_max;
138 
139 	asoc->timeouts[SCTP_EVENT_TIMEOUT_SACK] = asoc->sackdelay;
140 	asoc->timeouts[SCTP_EVENT_TIMEOUT_AUTOCLOSE] =
141 		(unsigned long)sp->autoclose * HZ;
142 
143 	/* Initializes the timers */
144 	for (i = SCTP_EVENT_TIMEOUT_NONE; i < SCTP_NUM_TIMEOUT_TYPES; ++i)
145 		timer_setup(&asoc->timers[i], sctp_timer_events[i], 0);
146 
147 	/* Pull default initialization values from the sock options.
148 	 * Note: This assumes that the values have already been
149 	 * validated in the sock.
150 	 */
151 	asoc->c.sinit_max_instreams = sp->initmsg.sinit_max_instreams;
152 	asoc->c.sinit_num_ostreams  = sp->initmsg.sinit_num_ostreams;
153 	asoc->max_init_attempts	= sp->initmsg.sinit_max_attempts;
154 
155 	asoc->max_init_timeo =
156 		 msecs_to_jiffies(sp->initmsg.sinit_max_init_timeo);
157 
158 	/* Set the local window size for receive.
159 	 * This is also the rcvbuf space per association.
160 	 * RFC 6 - A SCTP receiver MUST be able to receive a minimum of
161 	 * 1500 bytes in one SCTP packet.
162 	 */
163 	if ((sk->sk_rcvbuf/2) < SCTP_DEFAULT_MINWINDOW)
164 		asoc->rwnd = SCTP_DEFAULT_MINWINDOW;
165 	else
166 		asoc->rwnd = sk->sk_rcvbuf/2;
167 
168 	asoc->a_rwnd = asoc->rwnd;
169 
170 	/* Use my own max window until I learn something better.  */
171 	asoc->peer.rwnd = SCTP_DEFAULT_MAXWINDOW;
172 
173 	/* Initialize the receive memory counter */
174 	atomic_set(&asoc->rmem_alloc, 0);
175 
176 	init_waitqueue_head(&asoc->wait);
177 
178 	asoc->c.my_vtag = sctp_generate_tag(ep);
179 	asoc->c.my_port = ep->base.bind_addr.port;
180 
181 	asoc->c.initial_tsn = sctp_generate_tsn(ep);
182 
183 	asoc->next_tsn = asoc->c.initial_tsn;
184 
185 	asoc->ctsn_ack_point = asoc->next_tsn - 1;
186 	asoc->adv_peer_ack_point = asoc->ctsn_ack_point;
187 	asoc->highest_sacked = asoc->ctsn_ack_point;
188 	asoc->last_cwr_tsn = asoc->ctsn_ack_point;
189 
190 	/* ADDIP Section 4.1 Asconf Chunk Procedures
191 	 *
192 	 * When an endpoint has an ASCONF signaled change to be sent to the
193 	 * remote endpoint it should do the following:
194 	 * ...
195 	 * A2) a serial number should be assigned to the chunk. The serial
196 	 * number SHOULD be a monotonically increasing number. The serial
197 	 * numbers SHOULD be initialized at the start of the
198 	 * association to the same value as the initial TSN.
199 	 */
200 	asoc->addip_serial = asoc->c.initial_tsn;
201 	asoc->strreset_outseq = asoc->c.initial_tsn;
202 
203 	INIT_LIST_HEAD(&asoc->addip_chunk_list);
204 	INIT_LIST_HEAD(&asoc->asconf_ack_list);
205 
206 	/* Make an empty list of remote transport addresses.  */
207 	INIT_LIST_HEAD(&asoc->peer.transport_addr_list);
208 
209 	/* RFC 2960 5.1 Normal Establishment of an Association
210 	 *
211 	 * After the reception of the first data chunk in an
212 	 * association the endpoint must immediately respond with a
213 	 * sack to acknowledge the data chunk.  Subsequent
214 	 * acknowledgements should be done as described in Section
215 	 * 6.2.
216 	 *
217 	 * [We implement this by telling a new association that it
218 	 * already received one packet.]
219 	 */
220 	asoc->peer.sack_needed = 1;
221 	asoc->peer.sack_generation = 1;
222 
223 	/* Create an input queue.  */
224 	sctp_inq_init(&asoc->base.inqueue);
225 	sctp_inq_set_th_handler(&asoc->base.inqueue, sctp_assoc_bh_rcv);
226 
227 	/* Create an output queue.  */
228 	sctp_outq_init(asoc, &asoc->outqueue);
229 
230 	sctp_ulpq_init(&asoc->ulpq, asoc);
231 
232 	if (sctp_stream_init(&asoc->stream, asoc->c.sinit_num_ostreams, 0, gfp))
233 		goto stream_free;
234 
235 	/* Initialize default path MTU. */
236 	asoc->pathmtu = sp->pathmtu;
237 	sctp_assoc_update_frag_point(asoc);
238 
239 	/* Assume that peer would support both address types unless we are
240 	 * told otherwise.
241 	 */
242 	asoc->peer.ipv4_address = 1;
243 	if (asoc->base.sk->sk_family == PF_INET6)
244 		asoc->peer.ipv6_address = 1;
245 	INIT_LIST_HEAD(&asoc->asocs);
246 
247 	asoc->default_stream = sp->default_stream;
248 	asoc->default_ppid = sp->default_ppid;
249 	asoc->default_flags = sp->default_flags;
250 	asoc->default_context = sp->default_context;
251 	asoc->default_timetolive = sp->default_timetolive;
252 	asoc->default_rcv_context = sp->default_rcv_context;
253 
254 	/* AUTH related initializations */
255 	INIT_LIST_HEAD(&asoc->endpoint_shared_keys);
256 	if (sctp_auth_asoc_copy_shkeys(ep, asoc, gfp))
257 		goto stream_free;
258 
259 	asoc->active_key_id = ep->active_key_id;
260 	asoc->strreset_enable = ep->strreset_enable;
261 
262 	/* Save the hmacs and chunks list into this association */
263 	if (ep->auth_hmacs_list)
264 		memcpy(asoc->c.auth_hmacs, ep->auth_hmacs_list,
265 			ntohs(ep->auth_hmacs_list->param_hdr.length));
266 	if (ep->auth_chunk_list)
267 		memcpy(asoc->c.auth_chunks, ep->auth_chunk_list,
268 			ntohs(ep->auth_chunk_list->param_hdr.length));
269 
270 	/* Get the AUTH random number for this association */
271 	p = (struct sctp_paramhdr *)asoc->c.auth_random;
272 	p->type = SCTP_PARAM_RANDOM;
273 	p->length = htons(sizeof(*p) + SCTP_AUTH_RANDOM_LENGTH);
274 	get_random_bytes(p+1, SCTP_AUTH_RANDOM_LENGTH);
275 
276 	return asoc;
277 
278 stream_free:
279 	sctp_stream_free(&asoc->stream);
280 	sock_put(asoc->base.sk);
281 	sctp_endpoint_put(asoc->ep);
282 	return NULL;
283 }
284 
285 /* Allocate and initialize a new association */
286 struct sctp_association *sctp_association_new(const struct sctp_endpoint *ep,
287 					      const struct sock *sk,
288 					      enum sctp_scope scope, gfp_t gfp)
289 {
290 	struct sctp_association *asoc;
291 
292 	asoc = kzalloc_obj(*asoc, gfp);
293 	if (!asoc)
294 		goto fail;
295 
296 	if (!sctp_association_init(asoc, ep, sk, scope, gfp))
297 		goto fail_init;
298 
299 	SCTP_DBG_OBJCNT_INC(assoc);
300 
301 	pr_debug("Created asoc %p\n", asoc);
302 
303 	return asoc;
304 
305 fail_init:
306 	kfree(asoc);
307 fail:
308 	return NULL;
309 }
310 
311 /* Free this association if possible.  There may still be users, so
312  * the actual deallocation may be delayed.
313  */
314 void sctp_association_free(struct sctp_association *asoc)
315 {
316 	struct sock *sk = asoc->base.sk;
317 	struct sctp_transport *transport;
318 	struct list_head *pos, *temp;
319 	int i;
320 
321 	/* Only real associations count against the endpoint, so
322 	 * don't bother for if this is a temporary association.
323 	 */
324 	if (!list_empty(&asoc->asocs)) {
325 		list_del(&asoc->asocs);
326 
327 		/* Decrement the backlog value for a TCP-style listening
328 		 * socket.
329 		 */
330 		if (sctp_style(sk, TCP) && sctp_sstate(sk, LISTENING))
331 			sk_acceptq_removed(sk);
332 	}
333 
334 	/* Mark as dead, so other users can know this structure is
335 	 * going away.
336 	 */
337 	asoc->base.dead = true;
338 
339 	/* Dispose of any data lying around in the outqueue. */
340 	sctp_outq_free(&asoc->outqueue);
341 
342 	/* Dispose of any pending messages for the upper layer. */
343 	sctp_ulpq_free(&asoc->ulpq);
344 
345 	/* Dispose of any pending chunks on the inqueue. */
346 	sctp_inq_free(&asoc->base.inqueue);
347 
348 	sctp_tsnmap_free(&asoc->peer.tsn_map);
349 
350 	/* Free stream information. */
351 	sctp_stream_free(&asoc->stream);
352 
353 	if (asoc->strreset_chunk)
354 		sctp_chunk_free(asoc->strreset_chunk);
355 
356 	/* Clean up the bound address list. */
357 	sctp_bind_addr_free(&asoc->base.bind_addr);
358 
359 	/* Do we need to go through all of our timers and
360 	 * delete them?   To be safe we will try to delete all, but we
361 	 * should be able to go through and make a guess based
362 	 * on our state.
363 	 */
364 	for (i = SCTP_EVENT_TIMEOUT_NONE; i < SCTP_NUM_TIMEOUT_TYPES; ++i) {
365 		if (timer_delete(&asoc->timers[i]))
366 			sctp_association_put(asoc);
367 	}
368 
369 	/* Free peer's cached cookie. */
370 	kfree(asoc->peer.cookie);
371 	kfree(asoc->peer.peer_random);
372 	kfree(asoc->peer.peer_chunks);
373 	kfree(asoc->peer.peer_hmacs);
374 
375 	/* Release the transport structures. */
376 	list_for_each_safe(pos, temp, &asoc->peer.transport_addr_list) {
377 		transport = list_entry(pos, struct sctp_transport, transports);
378 		list_del_rcu(pos);
379 		sctp_unhash_transport(transport);
380 		sctp_transport_free(transport);
381 	}
382 
383 	asoc->peer.transport_count = 0;
384 
385 	sctp_asconf_queue_teardown(asoc);
386 
387 	/* Free pending address space being deleted */
388 	kfree(asoc->asconf_addr_del_pending);
389 
390 	/* AUTH - Free the endpoint shared keys */
391 	sctp_auth_destroy_keys(&asoc->endpoint_shared_keys);
392 
393 	/* AUTH - Free the association shared key */
394 	sctp_auth_key_put(asoc->asoc_shared_key);
395 
396 	sctp_association_put(asoc);
397 }
398 
399 /* Cleanup and free up an association. */
400 static void sctp_association_destroy(struct sctp_association *asoc)
401 {
402 	if (unlikely(!asoc->base.dead)) {
403 		WARN(1, "Attempt to destroy undead association %p!\n", asoc);
404 		return;
405 	}
406 
407 	sctp_endpoint_put(asoc->ep);
408 	sock_put(asoc->base.sk);
409 
410 	if (asoc->assoc_id != 0) {
411 		spin_lock_bh(&sctp_assocs_id_lock);
412 		idr_remove(&sctp_assocs_id, asoc->assoc_id);
413 		spin_unlock_bh(&sctp_assocs_id_lock);
414 	}
415 
416 	WARN_ON(atomic_read(&asoc->rmem_alloc));
417 
418 	kfree_rcu(asoc, rcu);
419 	SCTP_DBG_OBJCNT_DEC(assoc);
420 }
421 
422 /* Change the primary destination address for the peer. */
423 void sctp_assoc_set_primary(struct sctp_association *asoc,
424 			    struct sctp_transport *transport)
425 {
426 	int changeover = 0;
427 
428 	/* it's a changeover only if we already have a primary path
429 	 * that we are changing
430 	 */
431 	if (asoc->peer.primary_path != NULL &&
432 	    asoc->peer.primary_path != transport)
433 		changeover = 1 ;
434 
435 	asoc->peer.primary_path = transport;
436 	sctp_ulpevent_notify_peer_addr_change(transport,
437 					      SCTP_ADDR_MADE_PRIM, 0);
438 
439 	/* Set a default msg_name for events. */
440 	memcpy(&asoc->peer.primary_addr, &transport->ipaddr,
441 	       sizeof(union sctp_addr));
442 
443 	/* If the primary path is changing, assume that the
444 	 * user wants to use this new path.
445 	 */
446 	if ((transport->state == SCTP_ACTIVE) ||
447 	    (transport->state == SCTP_UNKNOWN))
448 		asoc->peer.active_path = transport;
449 
450 	/*
451 	 * SFR-CACC algorithm:
452 	 * Upon the receipt of a request to change the primary
453 	 * destination address, on the data structure for the new
454 	 * primary destination, the sender MUST do the following:
455 	 *
456 	 * 1) If CHANGEOVER_ACTIVE is set, then there was a switch
457 	 * to this destination address earlier. The sender MUST set
458 	 * CYCLING_CHANGEOVER to indicate that this switch is a
459 	 * double switch to the same destination address.
460 	 *
461 	 * Really, only bother is we have data queued or outstanding on
462 	 * the association.
463 	 */
464 	if (!asoc->outqueue.outstanding_bytes && !asoc->outqueue.out_qlen)
465 		return;
466 
467 	if (transport->cacc.changeover_active)
468 		transport->cacc.cycling_changeover = changeover;
469 
470 	/* 2) The sender MUST set CHANGEOVER_ACTIVE to indicate that
471 	 * a changeover has occurred.
472 	 */
473 	transport->cacc.changeover_active = changeover;
474 
475 	/* 3) The sender MUST store the next TSN to be sent in
476 	 * next_tsn_at_change.
477 	 */
478 	transport->cacc.next_tsn_at_change = asoc->next_tsn;
479 }
480 
481 /* Remove a transport from an association.  */
482 void sctp_assoc_rm_peer(struct sctp_association *asoc,
483 			struct sctp_transport *peer)
484 {
485 	struct sctp_transport *transport;
486 	struct list_head *pos;
487 	struct sctp_chunk *ch;
488 
489 	pr_debug("%s: association:%p addr:%pISpc\n",
490 		 __func__, asoc, &peer->ipaddr.sa);
491 
492 	/* If we are to remove the current retran_path, update it
493 	 * to the next peer before removing this peer from the list.
494 	 */
495 	if (asoc->peer.retran_path == peer)
496 		sctp_assoc_update_retran_path(asoc);
497 
498 	/* Remove this peer from the list. */
499 	list_del_rcu(&peer->transports);
500 	/* Remove this peer from the transport hashtable */
501 	sctp_unhash_transport(peer);
502 
503 	/* Get the first transport of asoc. */
504 	pos = asoc->peer.transport_addr_list.next;
505 	transport = list_entry(pos, struct sctp_transport, transports);
506 
507 	/* Update any entries that match the peer to be deleted. */
508 	if (asoc->peer.primary_path == peer)
509 		sctp_assoc_set_primary(asoc, transport);
510 	if (asoc->peer.active_path == peer)
511 		asoc->peer.active_path = transport;
512 	if (asoc->peer.retran_path == peer)
513 		asoc->peer.retran_path = transport;
514 	if (asoc->peer.last_data_from == peer)
515 		asoc->peer.last_data_from = transport;
516 
517 	if (asoc->strreset_chunk &&
518 	    asoc->strreset_chunk->transport == peer) {
519 		asoc->strreset_chunk->transport = transport;
520 		sctp_transport_reset_reconf_timer(transport);
521 	}
522 
523 	/* If we remove the transport an INIT was last sent to, set it to
524 	 * NULL. Combined with the update of the retran path above, this
525 	 * will cause the next INIT to be sent to the next available
526 	 * transport, maintaining the cycle.
527 	 */
528 	if (asoc->init_last_sent_to == peer)
529 		asoc->init_last_sent_to = NULL;
530 
531 	/* If we remove the transport an SHUTDOWN was last sent to, set it
532 	 * to NULL. Combined with the update of the retran path above, this
533 	 * will cause the next SHUTDOWN to be sent to the next available
534 	 * transport, maintaining the cycle.
535 	 */
536 	if (asoc->shutdown_last_sent_to == peer)
537 		asoc->shutdown_last_sent_to = NULL;
538 
539 	/* If we remove the transport an ASCONF was last sent to, set it to
540 	 * NULL.
541 	 */
542 	if (asoc->addip_last_asconf &&
543 	    asoc->addip_last_asconf->transport == peer)
544 		asoc->addip_last_asconf->transport = NULL;
545 
546 	/* If we have something on the transmitted list, we have to
547 	 * save it off.  The best place is the active path.
548 	 */
549 	if (!list_empty(&peer->transmitted)) {
550 		struct sctp_transport *active = asoc->peer.active_path;
551 
552 		/* Reset the transport of each chunk on this list */
553 		list_for_each_entry(ch, &peer->transmitted,
554 					transmitted_list) {
555 			ch->transport = NULL;
556 			ch->rtt_in_progress = 0;
557 		}
558 
559 		list_splice_tail_init(&peer->transmitted,
560 					&active->transmitted);
561 
562 		/* Start a T3 timer here in case it wasn't running so
563 		 * that these migrated packets have a chance to get
564 		 * retransmitted.
565 		 */
566 		if (!timer_pending(&active->T3_rtx_timer))
567 			if (!mod_timer(&active->T3_rtx_timer,
568 					jiffies + active->rto))
569 				sctp_transport_hold(active);
570 	}
571 
572 	list_for_each_entry(ch, &asoc->outqueue.out_chunk_list, list)
573 		if (ch->transport == peer)
574 			ch->transport = NULL;
575 
576 	list_for_each_entry(ch, &asoc->outqueue.control_chunk_list, list)
577 		if (ch->transport == peer)
578 			ch->transport = NULL;
579 
580 	asoc->peer.transport_count--;
581 
582 	sctp_ulpevent_notify_peer_addr_change(peer, SCTP_ADDR_REMOVED, 0);
583 	sctp_transport_free(peer);
584 }
585 
586 /* Add a transport address to an association.  */
587 struct sctp_transport *sctp_assoc_add_peer(struct sctp_association *asoc,
588 					   const union sctp_addr *addr,
589 					   const gfp_t gfp,
590 					   const int peer_state)
591 {
592 	struct sctp_transport *peer;
593 	struct sctp_sock *sp;
594 	unsigned short port;
595 
596 	sp = sctp_sk(asoc->base.sk);
597 
598 	/* AF_INET and AF_INET6 share common port field. */
599 	port = ntohs(addr->v4.sin_port);
600 
601 	pr_debug("%s: association:%p addr:%pISpc state:%d\n", __func__,
602 		 asoc, &addr->sa, peer_state);
603 
604 	/* Set the port if it has not been set yet.  */
605 	if (0 == asoc->peer.port)
606 		asoc->peer.port = port;
607 
608 	/* Check to see if this is a duplicate. */
609 	peer = sctp_assoc_lookup_paddr(asoc, addr);
610 	if (peer) {
611 		/* An UNKNOWN state is only set on transports added by
612 		 * user in sctp_connectx() call.  Such transports should be
613 		 * considered CONFIRMED per RFC 4960, Section 5.4.
614 		 */
615 		if (peer->state == SCTP_UNKNOWN) {
616 			peer->state = SCTP_ACTIVE;
617 		}
618 		return peer;
619 	}
620 
621 	if (asoc->peer.transport_count == U16_MAX)
622 		return NULL;
623 
624 	peer = sctp_transport_new(asoc->base.net, addr, gfp);
625 	if (!peer)
626 		return NULL;
627 
628 	sctp_transport_set_owner(peer, asoc);
629 
630 	/* Initialize the peer's heartbeat interval based on the
631 	 * association configured value.
632 	 */
633 	peer->hbinterval = asoc->hbinterval;
634 	peer->probe_interval = asoc->probe_interval;
635 
636 	peer->encap_port = asoc->encap_port;
637 
638 	/* Set the path max_retrans.  */
639 	peer->pathmaxrxt = asoc->pathmaxrxt;
640 
641 	/* And the partial failure retrans threshold */
642 	peer->pf_retrans = asoc->pf_retrans;
643 	/* And the primary path switchover retrans threshold */
644 	peer->ps_retrans = asoc->ps_retrans;
645 
646 	/* Initialize the peer's SACK delay timeout based on the
647 	 * association configured value.
648 	 */
649 	peer->sackdelay = asoc->sackdelay;
650 	peer->sackfreq = asoc->sackfreq;
651 
652 	if (addr->sa.sa_family == AF_INET6) {
653 		__be32 info = addr->v6.sin6_flowinfo;
654 
655 		if (info) {
656 			peer->flowlabel = ntohl(info & IPV6_FLOWLABEL_MASK);
657 			peer->flowlabel |= SCTP_FLOWLABEL_SET_MASK;
658 		} else {
659 			peer->flowlabel = asoc->flowlabel;
660 		}
661 	}
662 	peer->dscp = asoc->dscp;
663 
664 	/* Enable/disable heartbeat, SACK delay, and path MTU discovery
665 	 * based on association setting.
666 	 */
667 	peer->param_flags = asoc->param_flags;
668 
669 	/* Initialize the pmtu of the transport. */
670 	sctp_transport_route(peer, NULL, sp);
671 
672 	/* If this is the first transport addr on this association,
673 	 * initialize the association PMTU to the peer's PMTU.
674 	 * If not and the current association PMTU is higher than the new
675 	 * peer's PMTU, reset the association PMTU to the new peer's PMTU.
676 	 */
677 	sctp_assoc_set_pmtu(asoc, asoc->pathmtu ?
678 				  min_t(int, peer->pathmtu, asoc->pathmtu) :
679 				  peer->pathmtu);
680 
681 	peer->pmtu_pending = 0;
682 
683 	/* The asoc->peer.port might not be meaningful yet, but
684 	 * initialize the packet structure anyway.
685 	 */
686 	sctp_packet_init(&peer->packet, peer, asoc->base.bind_addr.port,
687 			 asoc->peer.port);
688 
689 	/* 7.2.1 Slow-Start
690 	 *
691 	 * o The initial cwnd before DATA transmission or after a sufficiently
692 	 *   long idle period MUST be set to
693 	 *      min(4*MTU, max(2*MTU, 4380 bytes))
694 	 *
695 	 * o The initial value of ssthresh MAY be arbitrarily high
696 	 *   (for example, implementations MAY use the size of the
697 	 *   receiver advertised window).
698 	 */
699 	peer->cwnd = min(4*asoc->pathmtu, max_t(__u32, 2*asoc->pathmtu, 4380));
700 
701 	/* At this point, we may not have the receiver's advertised window,
702 	 * so initialize ssthresh to the default value and it will be set
703 	 * later when we process the INIT.
704 	 */
705 	peer->ssthresh = SCTP_DEFAULT_MAXWINDOW;
706 
707 	peer->partial_bytes_acked = 0;
708 	peer->flight_size = 0;
709 	peer->burst_limited = 0;
710 
711 	/* Set the transport's RTO.initial value */
712 	peer->rto = asoc->rto_initial;
713 	sctp_max_rto(asoc, peer);
714 
715 	/* Set the peer's active state. */
716 	peer->state = peer_state;
717 
718 	/* Add this peer into the transport hashtable */
719 	if (sctp_hash_transport(peer)) {
720 		sctp_transport_free(peer);
721 		return NULL;
722 	}
723 
724 	sctp_transport_pl_reset(peer);
725 
726 	/* Attach the remote transport to our asoc.  */
727 	list_add_tail_rcu(&peer->transports, &asoc->peer.transport_addr_list);
728 	asoc->peer.transport_count++;
729 
730 	sctp_ulpevent_notify_peer_addr_change(peer, SCTP_ADDR_ADDED, 0);
731 
732 	/* If we do not yet have a primary path, set one.  */
733 	if (!asoc->peer.primary_path) {
734 		sctp_assoc_set_primary(asoc, peer);
735 		asoc->peer.retran_path = peer;
736 	}
737 
738 	if (asoc->peer.active_path == asoc->peer.retran_path &&
739 	    peer->state != SCTP_UNCONFIRMED) {
740 		asoc->peer.retran_path = peer;
741 	}
742 
743 	return peer;
744 }
745 
746 /* Lookup a transport by address. */
747 struct sctp_transport *sctp_assoc_lookup_paddr(
748 					const struct sctp_association *asoc,
749 					const union sctp_addr *address)
750 {
751 	struct sctp_transport *t;
752 
753 	/* Cycle through all transports searching for a peer address. */
754 
755 	list_for_each_entry(t, &asoc->peer.transport_addr_list,
756 			transports) {
757 		if (sctp_cmp_addr_exact(address, &t->ipaddr))
758 			return t;
759 	}
760 
761 	return NULL;
762 }
763 
764 /* Remove all transports except a give one */
765 void sctp_assoc_del_nonprimary_peers(struct sctp_association *asoc,
766 				     struct sctp_transport *primary)
767 {
768 	struct sctp_transport	*temp;
769 	struct sctp_transport	*t;
770 
771 	list_for_each_entry_safe(t, temp, &asoc->peer.transport_addr_list,
772 				 transports) {
773 		/* if the current transport is not the primary one, delete it */
774 		if (t != primary)
775 			sctp_assoc_rm_peer(asoc, t);
776 	}
777 }
778 
779 /* Engage in transport control operations.
780  * Mark the transport up or down and send a notification to the user.
781  * Select and update the new active and retran paths.
782  */
783 void sctp_assoc_control_transport(struct sctp_association *asoc,
784 				  struct sctp_transport *transport,
785 				  enum sctp_transport_cmd command,
786 				  sctp_sn_error_t error)
787 {
788 	int spc_state = SCTP_ADDR_AVAILABLE;
789 	bool ulp_notify = true;
790 
791 	/* Record the transition on the transport.  */
792 	switch (command) {
793 	case SCTP_TRANSPORT_UP:
794 		/* If we are moving from UNCONFIRMED state due
795 		 * to heartbeat success, report the SCTP_ADDR_CONFIRMED
796 		 * state to the user, otherwise report SCTP_ADDR_AVAILABLE.
797 		 */
798 		if (transport->state == SCTP_PF &&
799 		    asoc->pf_expose != SCTP_PF_EXPOSE_ENABLE)
800 			ulp_notify = false;
801 		else if (transport->state == SCTP_UNCONFIRMED &&
802 			 error == SCTP_HEARTBEAT_SUCCESS)
803 			spc_state = SCTP_ADDR_CONFIRMED;
804 
805 		transport->state = SCTP_ACTIVE;
806 		sctp_transport_pl_reset(transport);
807 		break;
808 
809 	case SCTP_TRANSPORT_DOWN:
810 		/* If the transport was never confirmed, do not transition it
811 		 * to inactive state.  Also, release the cached route since
812 		 * there may be a better route next time.
813 		 */
814 		if (transport->state != SCTP_UNCONFIRMED) {
815 			transport->state = SCTP_INACTIVE;
816 			sctp_transport_pl_reset(transport);
817 			spc_state = SCTP_ADDR_UNREACHABLE;
818 		} else {
819 			sctp_transport_dst_release(transport);
820 			ulp_notify = false;
821 		}
822 		break;
823 
824 	case SCTP_TRANSPORT_PF:
825 		transport->state = SCTP_PF;
826 		if (asoc->pf_expose != SCTP_PF_EXPOSE_ENABLE)
827 			ulp_notify = false;
828 		else
829 			spc_state = SCTP_ADDR_POTENTIALLY_FAILED;
830 		break;
831 
832 	default:
833 		return;
834 	}
835 
836 	/* Generate and send a SCTP_PEER_ADDR_CHANGE notification
837 	 * to the user.
838 	 */
839 	if (ulp_notify)
840 		sctp_ulpevent_notify_peer_addr_change(transport,
841 						      spc_state, error);
842 
843 	/* Select new active and retran paths. */
844 	sctp_select_active_and_retran_path(asoc);
845 }
846 
847 /* Hold a reference to an association. */
848 void sctp_association_hold(struct sctp_association *asoc)
849 {
850 	refcount_inc(&asoc->base.refcnt);
851 }
852 
853 /* Release a reference to an association and cleanup
854  * if there are no more references.
855  */
856 void sctp_association_put(struct sctp_association *asoc)
857 {
858 	if (refcount_dec_and_test(&asoc->base.refcnt))
859 		sctp_association_destroy(asoc);
860 }
861 
862 /* Allocate the next TSN, Transmission Sequence Number, for the given
863  * association.
864  */
865 __u32 sctp_association_get_next_tsn(struct sctp_association *asoc)
866 {
867 	/* From Section 1.6 Serial Number Arithmetic:
868 	 * Transmission Sequence Numbers wrap around when they reach
869 	 * 2**32 - 1.  That is, the next TSN a DATA chunk MUST use
870 	 * after transmitting TSN = 2*32 - 1 is TSN = 0.
871 	 */
872 	__u32 retval = asoc->next_tsn;
873 	asoc->next_tsn++;
874 	asoc->unack_data++;
875 
876 	return retval;
877 }
878 
879 /* Compare two addresses to see if they match.  Wildcard addresses
880  * only match themselves.
881  */
882 int sctp_cmp_addr_exact(const union sctp_addr *ss1,
883 			const union sctp_addr *ss2)
884 {
885 	struct sctp_af *af;
886 
887 	af = sctp_get_af_specific(ss1->sa.sa_family);
888 	if (unlikely(!af))
889 		return 0;
890 
891 	return af->cmp_addr(ss1, ss2);
892 }
893 
894 /* Return an ecne chunk to get prepended to a packet.
895  * Note:  We are sly and return a shared, prealloced chunk.  FIXME:
896  * No we don't, but we could/should.
897  */
898 struct sctp_chunk *sctp_get_ecne_prepend(struct sctp_association *asoc)
899 {
900 	if (!asoc->need_ecne)
901 		return NULL;
902 
903 	/* Send ECNE if needed.
904 	 * Not being able to allocate a chunk here is not deadly.
905 	 */
906 	return sctp_make_ecne(asoc, asoc->last_ecne_tsn);
907 }
908 
909 /*
910  * Find which transport this TSN was sent on.
911  */
912 struct sctp_transport *sctp_assoc_lookup_tsn(struct sctp_association *asoc,
913 					     __u32 tsn)
914 {
915 	struct sctp_transport *active;
916 	struct sctp_transport *match;
917 	struct sctp_transport *transport;
918 	struct sctp_chunk *chunk;
919 	__be32 key = htonl(tsn);
920 
921 	match = NULL;
922 
923 	/*
924 	 * FIXME: In general, find a more efficient data structure for
925 	 * searching.
926 	 */
927 
928 	/*
929 	 * The general strategy is to search each transport's transmitted
930 	 * list.   Return which transport this TSN lives on.
931 	 *
932 	 * Let's be hopeful and check the active_path first.
933 	 * Another optimization would be to know if there is only one
934 	 * outbound path and not have to look for the TSN at all.
935 	 *
936 	 */
937 
938 	active = asoc->peer.active_path;
939 
940 	list_for_each_entry(chunk, &active->transmitted,
941 			transmitted_list) {
942 
943 		if (key == chunk->subh.data_hdr->tsn) {
944 			match = active;
945 			goto out;
946 		}
947 	}
948 
949 	/* If not found, go search all the other transports. */
950 	list_for_each_entry(transport, &asoc->peer.transport_addr_list,
951 			transports) {
952 
953 		if (transport == active)
954 			continue;
955 		list_for_each_entry(chunk, &transport->transmitted,
956 				transmitted_list) {
957 			if (key == chunk->subh.data_hdr->tsn) {
958 				match = transport;
959 				goto out;
960 			}
961 		}
962 	}
963 out:
964 	return match;
965 }
966 
967 /* Do delayed input processing.  This is scheduled by sctp_rcv(). */
968 static void sctp_assoc_bh_rcv(struct work_struct *work)
969 {
970 	struct sctp_association *asoc =
971 		container_of(work, struct sctp_association,
972 			     base.inqueue.immediate);
973 	struct net *net = asoc->base.net;
974 	union sctp_subtype subtype;
975 	struct sctp_endpoint *ep;
976 	struct sctp_chunk *chunk;
977 	struct sctp_inq *inqueue;
978 	int first_time = 1;	/* is this the first time through the loop */
979 	int error = 0;
980 	int state;
981 
982 	/* The association should be held so we should be safe. */
983 	ep = asoc->ep;
984 
985 	inqueue = &asoc->base.inqueue;
986 	sctp_association_hold(asoc);
987 	while (NULL != (chunk = sctp_inq_pop(inqueue))) {
988 		state = asoc->state;
989 		subtype = SCTP_ST_CHUNK(chunk->chunk_hdr->type);
990 
991 		/* If the first chunk in the packet is AUTH, do special
992 		 * processing specified in Section 6.3 of SCTP-AUTH spec
993 		 */
994 		if (first_time && subtype.chunk == SCTP_CID_AUTH) {
995 			struct sctp_chunkhdr *next_hdr;
996 
997 			next_hdr = sctp_inq_peek(inqueue);
998 			if (!next_hdr)
999 				goto normal;
1000 
1001 			/* If the next chunk is COOKIE-ECHO, skip the AUTH
1002 			 * chunk while saving a pointer to it so we can do
1003 			 * Authentication later (during cookie-echo
1004 			 * processing).
1005 			 */
1006 			if (next_hdr->type == SCTP_CID_COOKIE_ECHO) {
1007 				chunk->auth_chunk = skb_clone(chunk->skb,
1008 							      GFP_ATOMIC);
1009 				chunk->auth = 1;
1010 				continue;
1011 			}
1012 		}
1013 
1014 normal:
1015 		/* SCTP-AUTH, Section 6.3:
1016 		 *    The receiver has a list of chunk types which it expects
1017 		 *    to be received only after an AUTH-chunk.  This list has
1018 		 *    been sent to the peer during the association setup.  It
1019 		 *    MUST silently discard these chunks if they are not placed
1020 		 *    after an AUTH chunk in the packet.
1021 		 */
1022 		if (sctp_auth_recv_cid(subtype.chunk, asoc) && !chunk->auth)
1023 			continue;
1024 
1025 		/* Remember where the last DATA chunk came from so we
1026 		 * know where to send the SACK.
1027 		 */
1028 		if (sctp_chunk_is_data(chunk))
1029 			asoc->peer.last_data_from = chunk->transport;
1030 		else {
1031 			SCTP_INC_STATS(net, SCTP_MIB_INCTRLCHUNKS);
1032 			asoc->stats.ictrlchunks++;
1033 			if (chunk->chunk_hdr->type == SCTP_CID_SACK)
1034 				asoc->stats.isacks++;
1035 		}
1036 
1037 		if (chunk->transport)
1038 			chunk->transport->last_time_heard = ktime_get();
1039 
1040 		/* Run through the state machine. */
1041 		error = sctp_do_sm(net, SCTP_EVENT_T_CHUNK, subtype,
1042 				   state, ep, asoc, chunk, GFP_ATOMIC);
1043 
1044 		/* Check to see if the association is freed in response to
1045 		 * the incoming chunk.  If so, get out of the while loop.
1046 		 */
1047 		if (asoc->base.dead)
1048 			break;
1049 
1050 		/* If there is an error on chunk, discard this packet. */
1051 		if (error && chunk)
1052 			chunk->pdiscard = 1;
1053 
1054 		if (first_time)
1055 			first_time = 0;
1056 	}
1057 	sctp_association_put(asoc);
1058 }
1059 
1060 /* This routine moves an association from its old sk to a new sk.  */
1061 void sctp_assoc_migrate(struct sctp_association *assoc, struct sock *newsk)
1062 {
1063 	struct sctp_sock *newsp = sctp_sk(newsk);
1064 	struct sock *oldsk = assoc->base.sk;
1065 
1066 	/* Delete the association from the old endpoint's list of
1067 	 * associations.
1068 	 */
1069 	list_del_init(&assoc->asocs);
1070 
1071 	/* Decrement the backlog value for a TCP-style socket. */
1072 	if (sctp_style(oldsk, TCP))
1073 		sk_acceptq_removed(oldsk);
1074 
1075 	/* Release references to the old endpoint and the sock.  */
1076 	sctp_endpoint_put(assoc->ep);
1077 	sock_put(assoc->base.sk);
1078 
1079 	/* Get a reference to the new endpoint.  */
1080 	assoc->ep = newsp->ep;
1081 	sctp_endpoint_hold(assoc->ep);
1082 
1083 	/* Get a reference to the new sock.  */
1084 	assoc->base.sk = newsk;
1085 	sock_hold(assoc->base.sk);
1086 
1087 	/* Add the association to the new endpoint's list of associations.  */
1088 	sctp_endpoint_add_asoc(newsp->ep, assoc);
1089 }
1090 
1091 /* Update an association (possibly from unexpected COOKIE-ECHO processing).  */
1092 int sctp_assoc_update(struct sctp_association *asoc,
1093 		      struct sctp_association *new)
1094 {
1095 	struct sctp_transport *trans;
1096 	struct list_head *pos, *temp;
1097 
1098 	/* Copy in new parameters of peer. */
1099 	asoc->c = new->c;
1100 	asoc->peer.rwnd = new->peer.rwnd;
1101 	asoc->peer.sack_needed = new->peer.sack_needed;
1102 	asoc->peer.auth_capable = new->peer.auth_capable;
1103 	asoc->peer.i = new->peer.i;
1104 
1105 	if (!sctp_tsnmap_init(&asoc->peer.tsn_map, SCTP_TSN_MAP_INITIAL,
1106 			      asoc->peer.i.initial_tsn, GFP_ATOMIC))
1107 		return -ENOMEM;
1108 
1109 	/* Remove any peer addresses not present in the new association. */
1110 	list_for_each_safe(pos, temp, &asoc->peer.transport_addr_list) {
1111 		trans = list_entry(pos, struct sctp_transport, transports);
1112 		if (!sctp_assoc_lookup_paddr(new, &trans->ipaddr)) {
1113 			sctp_assoc_rm_peer(asoc, trans);
1114 			continue;
1115 		}
1116 
1117 		if (asoc->state >= SCTP_STATE_ESTABLISHED)
1118 			sctp_transport_reset(trans);
1119 	}
1120 
1121 	/* If the case is A (association restart), use
1122 	 * initial_tsn as next_tsn. If the case is B, use
1123 	 * current next_tsn in case data sent to peer
1124 	 * has been discarded and needs retransmission.
1125 	 */
1126 	if (asoc->state >= SCTP_STATE_ESTABLISHED) {
1127 		asoc->next_tsn = new->next_tsn;
1128 		asoc->ctsn_ack_point = new->ctsn_ack_point;
1129 		asoc->adv_peer_ack_point = new->adv_peer_ack_point;
1130 
1131 		/* Reinitialize SSN for both local streams
1132 		 * and peer's streams.
1133 		 */
1134 		sctp_stream_clear(&asoc->stream);
1135 
1136 		/* Flush the ULP reassembly and ordered queue.
1137 		 * Any data there will now be stale and will
1138 		 * cause problems.
1139 		 */
1140 		sctp_ulpq_flush(&asoc->ulpq);
1141 
1142 		/* reset the overall association error count so
1143 		 * that the restarted association doesn't get torn
1144 		 * down on the next retransmission timer.
1145 		 */
1146 		asoc->overall_error_count = 0;
1147 
1148 	} else {
1149 		/* Add any peer addresses from the new association. */
1150 		list_for_each_entry(trans, &new->peer.transport_addr_list,
1151 				    transports)
1152 			if (!sctp_assoc_add_peer(asoc, &trans->ipaddr,
1153 						 GFP_ATOMIC, trans->state))
1154 				return -ENOMEM;
1155 
1156 		asoc->ctsn_ack_point = asoc->next_tsn - 1;
1157 		asoc->adv_peer_ack_point = asoc->ctsn_ack_point;
1158 
1159 		if (sctp_state(asoc, COOKIE_WAIT))
1160 			sctp_stream_update(&asoc->stream, &new->stream);
1161 
1162 		/* get a new assoc id if we don't have one yet. */
1163 		if (sctp_assoc_set_id(asoc, GFP_ATOMIC))
1164 			return -ENOMEM;
1165 	}
1166 
1167 	/* SCTP-AUTH: Save the peer parameters from the new associations
1168 	 * and also move the association shared keys over
1169 	 */
1170 	kfree(asoc->peer.peer_random);
1171 	asoc->peer.peer_random = new->peer.peer_random;
1172 	new->peer.peer_random = NULL;
1173 
1174 	kfree(asoc->peer.peer_chunks);
1175 	asoc->peer.peer_chunks = new->peer.peer_chunks;
1176 	new->peer.peer_chunks = NULL;
1177 
1178 	kfree(asoc->peer.peer_hmacs);
1179 	asoc->peer.peer_hmacs = new->peer.peer_hmacs;
1180 	new->peer.peer_hmacs = NULL;
1181 
1182 	return sctp_auth_asoc_init_active_key(asoc, GFP_ATOMIC);
1183 }
1184 
1185 /* Update the retran path for sending a retransmitted packet.
1186  * See also RFC4960, 6.4. Multi-Homed SCTP Endpoints:
1187  *
1188  *   When there is outbound data to send and the primary path
1189  *   becomes inactive (e.g., due to failures), or where the
1190  *   SCTP user explicitly requests to send data to an
1191  *   inactive destination transport address, before reporting
1192  *   an error to its ULP, the SCTP endpoint should try to send
1193  *   the data to an alternate active destination transport
1194  *   address if one exists.
1195  *
1196  *   When retransmitting data that timed out, if the endpoint
1197  *   is multihomed, it should consider each source-destination
1198  *   address pair in its retransmission selection policy.
1199  *   When retransmitting timed-out data, the endpoint should
1200  *   attempt to pick the most divergent source-destination
1201  *   pair from the original source-destination pair to which
1202  *   the packet was transmitted.
1203  *
1204  *   Note: Rules for picking the most divergent source-destination
1205  *   pair are an implementation decision and are not specified
1206  *   within this document.
1207  *
1208  * Our basic strategy is to round-robin transports in priorities
1209  * according to sctp_trans_score() e.g., if no such
1210  * transport with state SCTP_ACTIVE exists, round-robin through
1211  * SCTP_UNKNOWN, etc. You get the picture.
1212  */
1213 static u8 sctp_trans_score(const struct sctp_transport *trans)
1214 {
1215 	switch (trans->state) {
1216 	case SCTP_ACTIVE:
1217 		return 3;	/* best case */
1218 	case SCTP_UNKNOWN:
1219 		return 2;
1220 	case SCTP_PF:
1221 		return 1;
1222 	default: /* case SCTP_INACTIVE */
1223 		return 0;	/* worst case */
1224 	}
1225 }
1226 
1227 static struct sctp_transport *sctp_trans_elect_tie(struct sctp_transport *trans1,
1228 						   struct sctp_transport *trans2)
1229 {
1230 	if (trans1->error_count > trans2->error_count) {
1231 		return trans2;
1232 	} else if (trans1->error_count == trans2->error_count &&
1233 		   ktime_after(trans2->last_time_heard,
1234 			       trans1->last_time_heard)) {
1235 		return trans2;
1236 	} else {
1237 		return trans1;
1238 	}
1239 }
1240 
1241 static struct sctp_transport *sctp_trans_elect_best(struct sctp_transport *curr,
1242 						    struct sctp_transport *best)
1243 {
1244 	u8 score_curr, score_best;
1245 
1246 	if (best == NULL || curr == best)
1247 		return curr;
1248 
1249 	score_curr = sctp_trans_score(curr);
1250 	score_best = sctp_trans_score(best);
1251 
1252 	/* First, try a score-based selection if both transport states
1253 	 * differ. If we're in a tie, lets try to make a more clever
1254 	 * decision here based on error counts and last time heard.
1255 	 */
1256 	if (score_curr > score_best)
1257 		return curr;
1258 	else if (score_curr == score_best)
1259 		return sctp_trans_elect_tie(best, curr);
1260 	else
1261 		return best;
1262 }
1263 
1264 void sctp_assoc_update_retran_path(struct sctp_association *asoc)
1265 {
1266 	struct sctp_transport *trans = asoc->peer.retran_path;
1267 	struct sctp_transport *trans_next = NULL;
1268 
1269 	/* We're done as we only have the one and only path. */
1270 	if (asoc->peer.transport_count == 1)
1271 		return;
1272 	/* If active_path and retran_path are the same and active,
1273 	 * then this is the only active path. Use it.
1274 	 */
1275 	if (asoc->peer.active_path == asoc->peer.retran_path &&
1276 	    asoc->peer.active_path->state == SCTP_ACTIVE)
1277 		return;
1278 
1279 	/* Iterate from retran_path's successor back to retran_path. */
1280 	for (trans = list_next_entry(trans, transports); 1;
1281 	     trans = list_next_entry(trans, transports)) {
1282 		/* Manually skip the head element. */
1283 		if (&trans->transports == &asoc->peer.transport_addr_list)
1284 			continue;
1285 		if (trans->state == SCTP_UNCONFIRMED)
1286 			continue;
1287 		trans_next = sctp_trans_elect_best(trans, trans_next);
1288 		/* Active is good enough for immediate return. */
1289 		if (trans_next->state == SCTP_ACTIVE)
1290 			break;
1291 		/* We've reached the end, time to update path. */
1292 		if (trans == asoc->peer.retran_path)
1293 			break;
1294 	}
1295 
1296 	asoc->peer.retran_path = trans_next;
1297 
1298 	pr_debug("%s: association:%p updated new path to addr:%pISpc\n",
1299 		 __func__, asoc, &asoc->peer.retran_path->ipaddr.sa);
1300 }
1301 
1302 static void sctp_select_active_and_retran_path(struct sctp_association *asoc)
1303 {
1304 	struct sctp_transport *trans, *trans_pri = NULL, *trans_sec = NULL;
1305 	struct sctp_transport *trans_pf = NULL;
1306 
1307 	/* Look for the two most recently used active transports. */
1308 	list_for_each_entry(trans, &asoc->peer.transport_addr_list,
1309 			    transports) {
1310 		/* Skip uninteresting transports. */
1311 		if (trans->state == SCTP_INACTIVE ||
1312 		    trans->state == SCTP_UNCONFIRMED)
1313 			continue;
1314 		/* Keep track of the best PF transport from our
1315 		 * list in case we don't find an active one.
1316 		 */
1317 		if (trans->state == SCTP_PF) {
1318 			trans_pf = sctp_trans_elect_best(trans, trans_pf);
1319 			continue;
1320 		}
1321 		/* For active transports, pick the most recent ones. */
1322 		if (trans_pri == NULL ||
1323 		    ktime_after(trans->last_time_heard,
1324 				trans_pri->last_time_heard)) {
1325 			trans_sec = trans_pri;
1326 			trans_pri = trans;
1327 		} else if (trans_sec == NULL ||
1328 			   ktime_after(trans->last_time_heard,
1329 				       trans_sec->last_time_heard)) {
1330 			trans_sec = trans;
1331 		}
1332 	}
1333 
1334 	/* RFC 2960 6.4 Multi-Homed SCTP Endpoints
1335 	 *
1336 	 * By default, an endpoint should always transmit to the primary
1337 	 * path, unless the SCTP user explicitly specifies the
1338 	 * destination transport address (and possibly source transport
1339 	 * address) to use. [If the primary is active but not most recent,
1340 	 * bump the most recently used transport.]
1341 	 */
1342 	if ((asoc->peer.primary_path->state == SCTP_ACTIVE ||
1343 	     asoc->peer.primary_path->state == SCTP_UNKNOWN) &&
1344 	     asoc->peer.primary_path != trans_pri) {
1345 		trans_sec = trans_pri;
1346 		trans_pri = asoc->peer.primary_path;
1347 	}
1348 
1349 	/* We did not find anything useful for a possible retransmission
1350 	 * path; either primary path that we found is the same as
1351 	 * the current one, or we didn't generally find an active one.
1352 	 */
1353 	if (trans_sec == NULL)
1354 		trans_sec = trans_pri;
1355 
1356 	/* If we failed to find a usable transport, just camp on the
1357 	 * active or pick a PF iff it's the better choice.
1358 	 */
1359 	if (trans_pri == NULL) {
1360 		trans_pri = sctp_trans_elect_best(asoc->peer.active_path, trans_pf);
1361 		trans_sec = trans_pri;
1362 	}
1363 
1364 	/* Set the active and retran transports. */
1365 	asoc->peer.active_path = trans_pri;
1366 	asoc->peer.retran_path = trans_sec;
1367 }
1368 
1369 struct sctp_transport *
1370 sctp_assoc_choose_alter_transport(struct sctp_association *asoc,
1371 				  struct sctp_transport *last_sent_to)
1372 {
1373 	/* If this is the first time packet is sent, use the active path,
1374 	 * else use the retran path. If the last packet was sent over the
1375 	 * retran path, update the retran path and use it.
1376 	 */
1377 	if (last_sent_to == NULL) {
1378 		return asoc->peer.active_path;
1379 	} else {
1380 		if (last_sent_to == asoc->peer.retran_path)
1381 			sctp_assoc_update_retran_path(asoc);
1382 
1383 		return asoc->peer.retran_path;
1384 	}
1385 }
1386 
1387 void sctp_assoc_update_frag_point(struct sctp_association *asoc)
1388 {
1389 	int frag = sctp_mtu_payload(sctp_sk(asoc->base.sk), asoc->pathmtu,
1390 				    sctp_datachk_len(&asoc->stream));
1391 
1392 	if (asoc->user_frag)
1393 		frag = min_t(int, frag, asoc->user_frag);
1394 
1395 	frag = min_t(int, frag, SCTP_MAX_CHUNK_LEN -
1396 				sctp_datachk_len(&asoc->stream));
1397 
1398 	asoc->frag_point = SCTP_TRUNC4(frag);
1399 }
1400 
1401 void sctp_assoc_set_pmtu(struct sctp_association *asoc, __u32 pmtu)
1402 {
1403 	if (asoc->pathmtu != pmtu) {
1404 		asoc->pathmtu = pmtu;
1405 		sctp_assoc_update_frag_point(asoc);
1406 	}
1407 
1408 	pr_debug("%s: asoc:%p, pmtu:%d, frag_point:%d\n", __func__, asoc,
1409 		 asoc->pathmtu, asoc->frag_point);
1410 }
1411 
1412 /* Update the association's pmtu and frag_point by going through all the
1413  * transports. This routine is called when a transport's PMTU has changed.
1414  */
1415 void sctp_assoc_sync_pmtu(struct sctp_association *asoc)
1416 {
1417 	struct sctp_transport *t;
1418 	__u32 pmtu = 0;
1419 
1420 	if (!asoc)
1421 		return;
1422 
1423 	/* Get the lowest pmtu of all the transports. */
1424 	list_for_each_entry(t, &asoc->peer.transport_addr_list, transports) {
1425 		if (t->pmtu_pending && t->dst) {
1426 			sctp_transport_update_pmtu(t,
1427 						   atomic_read(&t->mtu_info));
1428 			t->pmtu_pending = 0;
1429 		}
1430 		if (!pmtu || (t->pathmtu < pmtu))
1431 			pmtu = t->pathmtu;
1432 	}
1433 
1434 	sctp_assoc_set_pmtu(asoc, pmtu);
1435 }
1436 
1437 /* Should we send a SACK to update our peer? */
1438 static inline bool sctp_peer_needs_update(struct sctp_association *asoc)
1439 {
1440 	struct net *net = asoc->base.net;
1441 
1442 	switch (asoc->state) {
1443 	case SCTP_STATE_ESTABLISHED:
1444 	case SCTP_STATE_SHUTDOWN_PENDING:
1445 	case SCTP_STATE_SHUTDOWN_RECEIVED:
1446 	case SCTP_STATE_SHUTDOWN_SENT:
1447 		if ((asoc->rwnd > asoc->a_rwnd) &&
1448 		    ((asoc->rwnd - asoc->a_rwnd) >= max_t(__u32,
1449 			   (asoc->base.sk->sk_rcvbuf >> net->sctp.rwnd_upd_shift),
1450 			   asoc->pathmtu)))
1451 			return true;
1452 		break;
1453 	default:
1454 		break;
1455 	}
1456 	return false;
1457 }
1458 
1459 /* Increase asoc's rwnd by len and send any window update SACK if needed. */
1460 void sctp_assoc_rwnd_increase(struct sctp_association *asoc, unsigned int len)
1461 {
1462 	struct sctp_chunk *sack;
1463 	struct timer_list *timer;
1464 
1465 	if (asoc->rwnd_over) {
1466 		if (asoc->rwnd_over >= len) {
1467 			asoc->rwnd_over -= len;
1468 		} else {
1469 			asoc->rwnd += (len - asoc->rwnd_over);
1470 			asoc->rwnd_over = 0;
1471 		}
1472 	} else {
1473 		asoc->rwnd += len;
1474 	}
1475 
1476 	/* If we had window pressure, start recovering it
1477 	 * once our rwnd had reached the accumulated pressure
1478 	 * threshold.  The idea is to recover slowly, but up
1479 	 * to the initial advertised window.
1480 	 */
1481 	if (asoc->rwnd_press) {
1482 		int change = min(asoc->pathmtu, asoc->rwnd_press);
1483 		asoc->rwnd += change;
1484 		asoc->rwnd_press -= change;
1485 	}
1486 
1487 	pr_debug("%s: asoc:%p rwnd increased by %d to (%u, %u) - %u\n",
1488 		 __func__, asoc, len, asoc->rwnd, asoc->rwnd_over,
1489 		 asoc->a_rwnd);
1490 
1491 	/* Send a window update SACK if the rwnd has increased by at least the
1492 	 * minimum of the association's PMTU and half of the receive buffer.
1493 	 * The algorithm used is similar to the one described in
1494 	 * Section 4.2.3.3 of RFC 1122.
1495 	 */
1496 	if (sctp_peer_needs_update(asoc)) {
1497 		asoc->a_rwnd = asoc->rwnd;
1498 
1499 		pr_debug("%s: sending window update SACK- asoc:%p rwnd:%u "
1500 			 "a_rwnd:%u\n", __func__, asoc, asoc->rwnd,
1501 			 asoc->a_rwnd);
1502 
1503 		sack = sctp_make_sack(asoc);
1504 		if (!sack)
1505 			return;
1506 
1507 		asoc->peer.sack_needed = 0;
1508 
1509 		sctp_outq_tail(&asoc->outqueue, sack, GFP_ATOMIC);
1510 
1511 		/* Stop the SACK timer.  */
1512 		timer = &asoc->timers[SCTP_EVENT_TIMEOUT_SACK];
1513 		if (timer_delete(timer))
1514 			sctp_association_put(asoc);
1515 	}
1516 }
1517 
1518 /* Decrease asoc's rwnd by len. */
1519 void sctp_assoc_rwnd_decrease(struct sctp_association *asoc, unsigned int len)
1520 {
1521 	int rx_count;
1522 	int over = 0;
1523 
1524 	if (unlikely(!asoc->rwnd || asoc->rwnd_over))
1525 		pr_debug("%s: association:%p has asoc->rwnd:%u, "
1526 			 "asoc->rwnd_over:%u!\n", __func__, asoc,
1527 			 asoc->rwnd, asoc->rwnd_over);
1528 
1529 	if (asoc->ep->rcvbuf_policy)
1530 		rx_count = atomic_read(&asoc->rmem_alloc);
1531 	else
1532 		rx_count = atomic_read(&asoc->base.sk->sk_rmem_alloc);
1533 
1534 	/* If we've reached or overflowed our receive buffer, announce
1535 	 * a 0 rwnd if rwnd would still be positive.  Store the
1536 	 * potential pressure overflow so that the window can be restored
1537 	 * back to original value.
1538 	 */
1539 	if (rx_count >= asoc->base.sk->sk_rcvbuf)
1540 		over = 1;
1541 
1542 	if (asoc->rwnd >= len) {
1543 		asoc->rwnd -= len;
1544 		if (over) {
1545 			asoc->rwnd_press += asoc->rwnd;
1546 			asoc->rwnd = 0;
1547 		}
1548 	} else {
1549 		asoc->rwnd_over += len - asoc->rwnd;
1550 		asoc->rwnd = 0;
1551 	}
1552 
1553 	pr_debug("%s: asoc:%p rwnd decreased by %d to (%u, %u, %u)\n",
1554 		 __func__, asoc, len, asoc->rwnd, asoc->rwnd_over,
1555 		 asoc->rwnd_press);
1556 }
1557 
1558 /* Build the bind address list for the association based on info from the
1559  * local endpoint and the remote peer.
1560  */
1561 int sctp_assoc_set_bind_addr_from_ep(struct sctp_association *asoc,
1562 				     enum sctp_scope scope, gfp_t gfp)
1563 {
1564 	struct sock *sk = asoc->base.sk;
1565 	int flags;
1566 
1567 	/* Use scoping rules to determine the subset of addresses from
1568 	 * the endpoint.
1569 	 */
1570 	flags = (PF_INET6 == sk->sk_family) ? SCTP_ADDR6_ALLOWED : 0;
1571 	if (!inet_v6_ipv6only(sk))
1572 		flags |= SCTP_ADDR4_ALLOWED;
1573 	if (asoc->peer.ipv4_address)
1574 		flags |= SCTP_ADDR4_PEERSUPP;
1575 	if (asoc->peer.ipv6_address)
1576 		flags |= SCTP_ADDR6_PEERSUPP;
1577 
1578 	return sctp_bind_addr_copy(asoc->base.net,
1579 				   &asoc->base.bind_addr,
1580 				   &asoc->ep->base.bind_addr,
1581 				   scope, gfp, flags);
1582 }
1583 
1584 /* Build the association's bind address list from the cookie.  */
1585 int sctp_assoc_set_bind_addr_from_cookie(struct sctp_association *asoc,
1586 					 struct sctp_cookie *cookie,
1587 					 gfp_t gfp)
1588 {
1589 	struct sctp_init_chunk *peer_init = (struct sctp_init_chunk *)(cookie + 1);
1590 	int var_size2 = ntohs(peer_init->chunk_hdr.length);
1591 	int var_size3 = cookie->raw_addr_list_len;
1592 	__u8 *raw = (__u8 *)peer_init + var_size2;
1593 
1594 	return sctp_raw_to_bind_addrs(&asoc->base.bind_addr, raw, var_size3,
1595 				      asoc->ep->base.bind_addr.port, gfp);
1596 }
1597 
1598 /* Lookup laddr in the bind address list of an association. */
1599 int sctp_assoc_lookup_laddr(struct sctp_association *asoc,
1600 			    const union sctp_addr *laddr)
1601 {
1602 	int found = 0;
1603 
1604 	if ((asoc->base.bind_addr.port == ntohs(laddr->v4.sin_port)) &&
1605 	    sctp_bind_addr_match(&asoc->base.bind_addr, laddr,
1606 				 sctp_sk(asoc->base.sk)))
1607 		found = 1;
1608 
1609 	return found;
1610 }
1611 
1612 /* Set an association id for a given association */
1613 int sctp_assoc_set_id(struct sctp_association *asoc, gfp_t gfp)
1614 {
1615 	bool preload = gfpflags_allow_blocking(gfp);
1616 	int ret;
1617 
1618 	/* If the id is already assigned, keep it. */
1619 	if (asoc->assoc_id)
1620 		return 0;
1621 
1622 	if (preload)
1623 		idr_preload(gfp);
1624 	spin_lock_bh(&sctp_assocs_id_lock);
1625 	/* 0, 1, 2 are used as SCTP_FUTURE_ASSOC, SCTP_CURRENT_ASSOC and
1626 	 * SCTP_ALL_ASSOC, so an available id must be > SCTP_ALL_ASSOC.
1627 	 */
1628 	ret = idr_alloc_cyclic(&sctp_assocs_id, asoc, SCTP_ALL_ASSOC + 1, 0,
1629 			       GFP_NOWAIT);
1630 	spin_unlock_bh(&sctp_assocs_id_lock);
1631 	if (preload)
1632 		idr_preload_end();
1633 	if (ret < 0)
1634 		return ret;
1635 
1636 	asoc->assoc_id = (sctp_assoc_t)ret;
1637 	return 0;
1638 }
1639 
1640 /* Free the ASCONF queue */
1641 static void sctp_assoc_free_asconf_queue(struct sctp_association *asoc)
1642 {
1643 	struct sctp_chunk *asconf;
1644 	struct sctp_chunk *tmp;
1645 
1646 	list_for_each_entry_safe(asconf, tmp, &asoc->addip_chunk_list, list) {
1647 		list_del_init(&asconf->list);
1648 		sctp_chunk_free(asconf);
1649 	}
1650 }
1651 
1652 /* Free asconf_ack cache */
1653 static void sctp_assoc_free_asconf_acks(struct sctp_association *asoc)
1654 {
1655 	struct sctp_chunk *ack;
1656 	struct sctp_chunk *tmp;
1657 
1658 	list_for_each_entry_safe(ack, tmp, &asoc->asconf_ack_list,
1659 				transmitted_list) {
1660 		list_del_init(&ack->transmitted_list);
1661 		sctp_chunk_free(ack);
1662 	}
1663 }
1664 
1665 /* Clean up the ASCONF_ACK queue */
1666 void sctp_assoc_clean_asconf_ack_cache(const struct sctp_association *asoc)
1667 {
1668 	struct sctp_chunk *ack;
1669 	struct sctp_chunk *tmp;
1670 
1671 	/* We can remove all the entries from the queue up to
1672 	 * the "Peer-Sequence-Number".
1673 	 */
1674 	list_for_each_entry_safe(ack, tmp, &asoc->asconf_ack_list,
1675 				transmitted_list) {
1676 		if (ack->subh.addip_hdr->serial ==
1677 				htonl(asoc->peer.addip_serial))
1678 			break;
1679 
1680 		list_del_init(&ack->transmitted_list);
1681 		sctp_chunk_free(ack);
1682 	}
1683 }
1684 
1685 /* Find the ASCONF_ACK whose serial number matches ASCONF */
1686 struct sctp_chunk *sctp_assoc_lookup_asconf_ack(
1687 					const struct sctp_association *asoc,
1688 					__be32 serial)
1689 {
1690 	struct sctp_chunk *ack;
1691 
1692 	/* Walk through the list of cached ASCONF-ACKs and find the
1693 	 * ack chunk whose serial number matches that of the request.
1694 	 */
1695 	list_for_each_entry(ack, &asoc->asconf_ack_list, transmitted_list) {
1696 		if (sctp_chunk_pending(ack))
1697 			continue;
1698 		if (ack->subh.addip_hdr->serial == serial) {
1699 			sctp_chunk_hold(ack);
1700 			return ack;
1701 		}
1702 	}
1703 
1704 	return NULL;
1705 }
1706 
1707 void sctp_asconf_queue_teardown(struct sctp_association *asoc)
1708 {
1709 	/* Free any cached ASCONF_ACK chunk. */
1710 	sctp_assoc_free_asconf_acks(asoc);
1711 
1712 	/* Free the ASCONF queue. */
1713 	sctp_assoc_free_asconf_queue(asoc);
1714 
1715 	/* Free any cached ASCONF chunk. */
1716 	if (asoc->addip_last_asconf)
1717 		sctp_chunk_free(asoc->addip_last_asconf);
1718 }
1719