Back to home page

OSCL-LXR

 
 

    


0001 // SPDX-License-Identifier: GPL-2.0-or-later
0002 /* SCTP kernel implementation
0003  * (C) Copyright IBM Corp. 2001, 2004
0004  * Copyright (c) 1999-2000 Cisco, Inc.
0005  * Copyright (c) 1999-2001 Motorola, Inc.
0006  * Copyright (c) 2001 Intel Corp.
0007  * Copyright (c) 2001 La Monte H.P. Yarroll
0008  *
0009  * This file is part of the SCTP kernel implementation
0010  *
0011  * This module provides the abstraction for an SCTP association.
0012  *
0013  * Please send any bug reports or fixes you make to the
0014  * email address(es):
0015  *    lksctp developers <linux-sctp@vger.kernel.org>
0016  *
0017  * Written or modified by:
0018  *    La Monte H.P. Yarroll <piggy@acm.org>
0019  *    Karl Knutson          <karl@athena.chicago.il.us>
0020  *    Jon Grimm             <jgrimm@us.ibm.com>
0021  *    Xingang Guo           <xingang.guo@intel.com>
0022  *    Hui Huang             <hui.huang@nokia.com>
0023  *    Sridhar Samudrala     <sri@us.ibm.com>
0024  *    Daisy Chang       <daisyc@us.ibm.com>
0025  *    Ryan Layer        <rmlayer@us.ibm.com>
0026  *    Kevin Gao             <kevin.gao@intel.com>
0027  */
0028 
0029 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
0030 
0031 #include <linux/types.h>
0032 #include <linux/fcntl.h>
0033 #include <linux/poll.h>
0034 #include <linux/init.h>
0035 
0036 #include <linux/slab.h>
0037 #include <linux/in.h>
0038 #include <net/ipv6.h>
0039 #include <net/sctp/sctp.h>
0040 #include <net/sctp/sm.h>
0041 
0042 /* Forward declarations for internal functions. */
0043 static void sctp_select_active_and_retran_path(struct sctp_association *asoc);
0044 static void sctp_assoc_bh_rcv(struct work_struct *work);
0045 static void sctp_assoc_free_asconf_acks(struct sctp_association *asoc);
0046 static void sctp_assoc_free_asconf_queue(struct sctp_association *asoc);
0047 
0048 /* 1st Level Abstractions. */
0049 
0050 /* Initialize a new association from provided memory. */
0051 static struct sctp_association *sctp_association_init(
0052                     struct sctp_association *asoc,
0053                     const struct sctp_endpoint *ep,
0054                     const struct sock *sk,
0055                     enum sctp_scope scope, gfp_t gfp)
0056 {
0057     struct sctp_sock *sp;
0058     struct sctp_paramhdr *p;
0059     int i;
0060 
0061     /* Retrieve the SCTP per socket area.  */
0062     sp = sctp_sk((struct sock *)sk);
0063 
0064     /* Discarding const is appropriate here.  */
0065     asoc->ep = (struct sctp_endpoint *)ep;
0066     asoc->base.sk = (struct sock *)sk;
0067     asoc->base.net = sock_net(sk);
0068 
0069     sctp_endpoint_hold(asoc->ep);
0070     sock_hold(asoc->base.sk);
0071 
0072     /* Initialize the common base substructure.  */
0073     asoc->base.type = SCTP_EP_TYPE_ASSOCIATION;
0074 
0075     /* Initialize the object handling fields.  */
0076     refcount_set(&asoc->base.refcnt, 1);
0077 
0078     /* Initialize the bind addr area.  */
0079     sctp_bind_addr_init(&asoc->base.bind_addr, ep->base.bind_addr.port);
0080 
0081     asoc->state = SCTP_STATE_CLOSED;
0082     asoc->cookie_life = ms_to_ktime(sp->assocparams.sasoc_cookie_life);
0083     asoc->user_frag = sp->user_frag;
0084 
0085     /* Set the association max_retrans and RTO values from the
0086      * socket values.
0087      */
0088     asoc->max_retrans = sp->assocparams.sasoc_asocmaxrxt;
0089     asoc->pf_retrans  = sp->pf_retrans;
0090     asoc->ps_retrans  = sp->ps_retrans;
0091     asoc->pf_expose   = sp->pf_expose;
0092 
0093     asoc->rto_initial = msecs_to_jiffies(sp->rtoinfo.srto_initial);
0094     asoc->rto_max = msecs_to_jiffies(sp->rtoinfo.srto_max);
0095     asoc->rto_min = msecs_to_jiffies(sp->rtoinfo.srto_min);
0096 
0097     /* Initialize the association's heartbeat interval based on the
0098      * sock configured value.
0099      */
0100     asoc->hbinterval = msecs_to_jiffies(sp->hbinterval);
0101     asoc->probe_interval = msecs_to_jiffies(sp->probe_interval);
0102 
0103     asoc->encap_port = sp->encap_port;
0104 
0105     /* Initialize path max retrans value. */
0106     asoc->pathmaxrxt = sp->pathmaxrxt;
0107 
0108     asoc->flowlabel = sp->flowlabel;
0109     asoc->dscp = sp->dscp;
0110 
0111     /* Set association default SACK delay */
0112     asoc->sackdelay = msecs_to_jiffies(sp->sackdelay);
0113     asoc->sackfreq = sp->sackfreq;
0114 
0115     /* Set the association default flags controlling
0116      * Heartbeat, SACK delay, and Path MTU Discovery.
0117      */
0118     asoc->param_flags = sp->param_flags;
0119 
0120     /* Initialize the maximum number of new data packets that can be sent
0121      * in a burst.
0122      */
0123     asoc->max_burst = sp->max_burst;
0124 
0125     asoc->subscribe = sp->subscribe;
0126 
0127     /* initialize association timers */
0128     asoc->timeouts[SCTP_EVENT_TIMEOUT_T1_COOKIE] = asoc->rto_initial;
0129     asoc->timeouts[SCTP_EVENT_TIMEOUT_T1_INIT] = asoc->rto_initial;
0130     asoc->timeouts[SCTP_EVENT_TIMEOUT_T2_SHUTDOWN] = asoc->rto_initial;
0131 
0132     /* sctpimpguide Section 2.12.2
0133      * If the 'T5-shutdown-guard' timer is used, it SHOULD be set to the
0134      * recommended value of 5 times 'RTO.Max'.
0135      */
0136     asoc->timeouts[SCTP_EVENT_TIMEOUT_T5_SHUTDOWN_GUARD]
0137         = 5 * asoc->rto_max;
0138 
0139     asoc->timeouts[SCTP_EVENT_TIMEOUT_SACK] = asoc->sackdelay;
0140     asoc->timeouts[SCTP_EVENT_TIMEOUT_AUTOCLOSE] = sp->autoclose * HZ;
0141 
0142     /* Initializes the timers */
0143     for (i = SCTP_EVENT_TIMEOUT_NONE; i < SCTP_NUM_TIMEOUT_TYPES; ++i)
0144         timer_setup(&asoc->timers[i], sctp_timer_events[i], 0);
0145 
0146     /* Pull default initialization values from the sock options.
0147      * Note: This assumes that the values have already been
0148      * validated in the sock.
0149      */
0150     asoc->c.sinit_max_instreams = sp->initmsg.sinit_max_instreams;
0151     asoc->c.sinit_num_ostreams  = sp->initmsg.sinit_num_ostreams;
0152     asoc->max_init_attempts = sp->initmsg.sinit_max_attempts;
0153 
0154     asoc->max_init_timeo =
0155          msecs_to_jiffies(sp->initmsg.sinit_max_init_timeo);
0156 
0157     /* Set the local window size for receive.
0158      * This is also the rcvbuf space per association.
0159      * RFC 6 - A SCTP receiver MUST be able to receive a minimum of
0160      * 1500 bytes in one SCTP packet.
0161      */
0162     if ((sk->sk_rcvbuf/2) < SCTP_DEFAULT_MINWINDOW)
0163         asoc->rwnd = SCTP_DEFAULT_MINWINDOW;
0164     else
0165         asoc->rwnd = sk->sk_rcvbuf/2;
0166 
0167     asoc->a_rwnd = asoc->rwnd;
0168 
0169     /* Use my own max window until I learn something better.  */
0170     asoc->peer.rwnd = SCTP_DEFAULT_MAXWINDOW;
0171 
0172     /* Initialize the receive memory counter */
0173     atomic_set(&asoc->rmem_alloc, 0);
0174 
0175     init_waitqueue_head(&asoc->wait);
0176 
0177     asoc->c.my_vtag = sctp_generate_tag(ep);
0178     asoc->c.my_port = ep->base.bind_addr.port;
0179 
0180     asoc->c.initial_tsn = sctp_generate_tsn(ep);
0181 
0182     asoc->next_tsn = asoc->c.initial_tsn;
0183 
0184     asoc->ctsn_ack_point = asoc->next_tsn - 1;
0185     asoc->adv_peer_ack_point = asoc->ctsn_ack_point;
0186     asoc->highest_sacked = asoc->ctsn_ack_point;
0187     asoc->last_cwr_tsn = asoc->ctsn_ack_point;
0188 
0189     /* ADDIP Section 4.1 Asconf Chunk Procedures
0190      *
0191      * When an endpoint has an ASCONF signaled change to be sent to the
0192      * remote endpoint it should do the following:
0193      * ...
0194      * A2) a serial number should be assigned to the chunk. The serial
0195      * number SHOULD be a monotonically increasing number. The serial
0196      * numbers SHOULD be initialized at the start of the
0197      * association to the same value as the initial TSN.
0198      */
0199     asoc->addip_serial = asoc->c.initial_tsn;
0200     asoc->strreset_outseq = asoc->c.initial_tsn;
0201 
0202     INIT_LIST_HEAD(&asoc->addip_chunk_list);
0203     INIT_LIST_HEAD(&asoc->asconf_ack_list);
0204 
0205     /* Make an empty list of remote transport addresses.  */
0206     INIT_LIST_HEAD(&asoc->peer.transport_addr_list);
0207 
0208     /* RFC 2960 5.1 Normal Establishment of an Association
0209      *
0210      * After the reception of the first data chunk in an
0211      * association the endpoint must immediately respond with a
0212      * sack to acknowledge the data chunk.  Subsequent
0213      * acknowledgements should be done as described in Section
0214      * 6.2.
0215      *
0216      * [We implement this by telling a new association that it
0217      * already received one packet.]
0218      */
0219     asoc->peer.sack_needed = 1;
0220     asoc->peer.sack_generation = 1;
0221 
0222     /* Create an input queue.  */
0223     sctp_inq_init(&asoc->base.inqueue);
0224     sctp_inq_set_th_handler(&asoc->base.inqueue, sctp_assoc_bh_rcv);
0225 
0226     /* Create an output queue.  */
0227     sctp_outq_init(asoc, &asoc->outqueue);
0228 
0229     if (!sctp_ulpq_init(&asoc->ulpq, asoc))
0230         goto fail_init;
0231 
0232     if (sctp_stream_init(&asoc->stream, asoc->c.sinit_num_ostreams, 0, gfp))
0233         goto stream_free;
0234 
0235     /* Initialize default path MTU. */
0236     asoc->pathmtu = sp->pathmtu;
0237     sctp_assoc_update_frag_point(asoc);
0238 
0239     /* Assume that peer would support both address types unless we are
0240      * told otherwise.
0241      */
0242     asoc->peer.ipv4_address = 1;
0243     if (asoc->base.sk->sk_family == PF_INET6)
0244         asoc->peer.ipv6_address = 1;
0245     INIT_LIST_HEAD(&asoc->asocs);
0246 
0247     asoc->default_stream = sp->default_stream;
0248     asoc->default_ppid = sp->default_ppid;
0249     asoc->default_flags = sp->default_flags;
0250     asoc->default_context = sp->default_context;
0251     asoc->default_timetolive = sp->default_timetolive;
0252     asoc->default_rcv_context = sp->default_rcv_context;
0253 
0254     /* AUTH related initializations */
0255     INIT_LIST_HEAD(&asoc->endpoint_shared_keys);
0256     if (sctp_auth_asoc_copy_shkeys(ep, asoc, gfp))
0257         goto stream_free;
0258 
0259     asoc->active_key_id = ep->active_key_id;
0260     asoc->strreset_enable = ep->strreset_enable;
0261 
0262     /* Save the hmacs and chunks list into this association */
0263     if (ep->auth_hmacs_list)
0264         memcpy(asoc->c.auth_hmacs, ep->auth_hmacs_list,
0265             ntohs(ep->auth_hmacs_list->param_hdr.length));
0266     if (ep->auth_chunk_list)
0267         memcpy(asoc->c.auth_chunks, ep->auth_chunk_list,
0268             ntohs(ep->auth_chunk_list->param_hdr.length));
0269 
0270     /* Get the AUTH random number for this association */
0271     p = (struct sctp_paramhdr *)asoc->c.auth_random;
0272     p->type = SCTP_PARAM_RANDOM;
0273     p->length = htons(sizeof(*p) + SCTP_AUTH_RANDOM_LENGTH);
0274     get_random_bytes(p+1, SCTP_AUTH_RANDOM_LENGTH);
0275 
0276     return asoc;
0277 
0278 stream_free:
0279     sctp_stream_free(&asoc->stream);
0280 fail_init:
0281     sock_put(asoc->base.sk);
0282     sctp_endpoint_put(asoc->ep);
0283     return NULL;
0284 }
0285 
0286 /* Allocate and initialize a new association */
0287 struct sctp_association *sctp_association_new(const struct sctp_endpoint *ep,
0288                           const struct sock *sk,
0289                           enum sctp_scope scope, gfp_t gfp)
0290 {
0291     struct sctp_association *asoc;
0292 
0293     asoc = kzalloc(sizeof(*asoc), gfp);
0294     if (!asoc)
0295         goto fail;
0296 
0297     if (!sctp_association_init(asoc, ep, sk, scope, gfp))
0298         goto fail_init;
0299 
0300     SCTP_DBG_OBJCNT_INC(assoc);
0301 
0302     pr_debug("Created asoc %p\n", asoc);
0303 
0304     return asoc;
0305 
0306 fail_init:
0307     kfree(asoc);
0308 fail:
0309     return NULL;
0310 }
0311 
0312 /* Free this association if possible.  There may still be users, so
0313  * the actual deallocation may be delayed.
0314  */
0315 void sctp_association_free(struct sctp_association *asoc)
0316 {
0317     struct sock *sk = asoc->base.sk;
0318     struct sctp_transport *transport;
0319     struct list_head *pos, *temp;
0320     int i;
0321 
0322     /* Only real associations count against the endpoint, so
0323      * don't bother for if this is a temporary association.
0324      */
0325     if (!list_empty(&asoc->asocs)) {
0326         list_del(&asoc->asocs);
0327 
0328         /* Decrement the backlog value for a TCP-style listening
0329          * socket.
0330          */
0331         if (sctp_style(sk, TCP) && sctp_sstate(sk, LISTENING))
0332             sk_acceptq_removed(sk);
0333     }
0334 
0335     /* Mark as dead, so other users can know this structure is
0336      * going away.
0337      */
0338     asoc->base.dead = true;
0339 
0340     /* Dispose of any data lying around in the outqueue. */
0341     sctp_outq_free(&asoc->outqueue);
0342 
0343     /* Dispose of any pending messages for the upper layer. */
0344     sctp_ulpq_free(&asoc->ulpq);
0345 
0346     /* Dispose of any pending chunks on the inqueue. */
0347     sctp_inq_free(&asoc->base.inqueue);
0348 
0349     sctp_tsnmap_free(&asoc->peer.tsn_map);
0350 
0351     /* Free stream information. */
0352     sctp_stream_free(&asoc->stream);
0353 
0354     if (asoc->strreset_chunk)
0355         sctp_chunk_free(asoc->strreset_chunk);
0356 
0357     /* Clean up the bound address list. */
0358     sctp_bind_addr_free(&asoc->base.bind_addr);
0359 
0360     /* Do we need to go through all of our timers and
0361      * delete them?   To be safe we will try to delete all, but we
0362      * should be able to go through and make a guess based
0363      * on our state.
0364      */
0365     for (i = SCTP_EVENT_TIMEOUT_NONE; i < SCTP_NUM_TIMEOUT_TYPES; ++i) {
0366         if (del_timer(&asoc->timers[i]))
0367             sctp_association_put(asoc);
0368     }
0369 
0370     /* Free peer's cached cookie. */
0371     kfree(asoc->peer.cookie);
0372     kfree(asoc->peer.peer_random);
0373     kfree(asoc->peer.peer_chunks);
0374     kfree(asoc->peer.peer_hmacs);
0375 
0376     /* Release the transport structures. */
0377     list_for_each_safe(pos, temp, &asoc->peer.transport_addr_list) {
0378         transport = list_entry(pos, struct sctp_transport, transports);
0379         list_del_rcu(pos);
0380         sctp_unhash_transport(transport);
0381         sctp_transport_free(transport);
0382     }
0383 
0384     asoc->peer.transport_count = 0;
0385 
0386     sctp_asconf_queue_teardown(asoc);
0387 
0388     /* Free pending address space being deleted */
0389     kfree(asoc->asconf_addr_del_pending);
0390 
0391     /* AUTH - Free the endpoint shared keys */
0392     sctp_auth_destroy_keys(&asoc->endpoint_shared_keys);
0393 
0394     /* AUTH - Free the association shared key */
0395     sctp_auth_key_put(asoc->asoc_shared_key);
0396 
0397     sctp_association_put(asoc);
0398 }
0399 
0400 /* Cleanup and free up an association. */
0401 static void sctp_association_destroy(struct sctp_association *asoc)
0402 {
0403     if (unlikely(!asoc->base.dead)) {
0404         WARN(1, "Attempt to destroy undead association %p!\n", asoc);
0405         return;
0406     }
0407 
0408     sctp_endpoint_put(asoc->ep);
0409     sock_put(asoc->base.sk);
0410 
0411     if (asoc->assoc_id != 0) {
0412         spin_lock_bh(&sctp_assocs_id_lock);
0413         idr_remove(&sctp_assocs_id, asoc->assoc_id);
0414         spin_unlock_bh(&sctp_assocs_id_lock);
0415     }
0416 
0417     WARN_ON(atomic_read(&asoc->rmem_alloc));
0418 
0419     kfree_rcu(asoc, rcu);
0420     SCTP_DBG_OBJCNT_DEC(assoc);
0421 }
0422 
0423 /* Change the primary destination address for the peer. */
0424 void sctp_assoc_set_primary(struct sctp_association *asoc,
0425                 struct sctp_transport *transport)
0426 {
0427     int changeover = 0;
0428 
0429     /* it's a changeover only if we already have a primary path
0430      * that we are changing
0431      */
0432     if (asoc->peer.primary_path != NULL &&
0433         asoc->peer.primary_path != transport)
0434         changeover = 1 ;
0435 
0436     asoc->peer.primary_path = transport;
0437     sctp_ulpevent_notify_peer_addr_change(transport,
0438                           SCTP_ADDR_MADE_PRIM, 0);
0439 
0440     /* Set a default msg_name for events. */
0441     memcpy(&asoc->peer.primary_addr, &transport->ipaddr,
0442            sizeof(union sctp_addr));
0443 
0444     /* If the primary path is changing, assume that the
0445      * user wants to use this new path.
0446      */
0447     if ((transport->state == SCTP_ACTIVE) ||
0448         (transport->state == SCTP_UNKNOWN))
0449         asoc->peer.active_path = transport;
0450 
0451     /*
0452      * SFR-CACC algorithm:
0453      * Upon the receipt of a request to change the primary
0454      * destination address, on the data structure for the new
0455      * primary destination, the sender MUST do the following:
0456      *
0457      * 1) If CHANGEOVER_ACTIVE is set, then there was a switch
0458      * to this destination address earlier. The sender MUST set
0459      * CYCLING_CHANGEOVER to indicate that this switch is a
0460      * double switch to the same destination address.
0461      *
0462      * Really, only bother is we have data queued or outstanding on
0463      * the association.
0464      */
0465     if (!asoc->outqueue.outstanding_bytes && !asoc->outqueue.out_qlen)
0466         return;
0467 
0468     if (transport->cacc.changeover_active)
0469         transport->cacc.cycling_changeover = changeover;
0470 
0471     /* 2) The sender MUST set CHANGEOVER_ACTIVE to indicate that
0472      * a changeover has occurred.
0473      */
0474     transport->cacc.changeover_active = changeover;
0475 
0476     /* 3) The sender MUST store the next TSN to be sent in
0477      * next_tsn_at_change.
0478      */
0479     transport->cacc.next_tsn_at_change = asoc->next_tsn;
0480 }
0481 
0482 /* Remove a transport from an association.  */
0483 void sctp_assoc_rm_peer(struct sctp_association *asoc,
0484             struct sctp_transport *peer)
0485 {
0486     struct sctp_transport *transport;
0487     struct list_head *pos;
0488     struct sctp_chunk *ch;
0489 
0490     pr_debug("%s: association:%p addr:%pISpc\n",
0491          __func__, asoc, &peer->ipaddr.sa);
0492 
0493     /* If we are to remove the current retran_path, update it
0494      * to the next peer before removing this peer from the list.
0495      */
0496     if (asoc->peer.retran_path == peer)
0497         sctp_assoc_update_retran_path(asoc);
0498 
0499     /* Remove this peer from the list. */
0500     list_del_rcu(&peer->transports);
0501     /* Remove this peer from the transport hashtable */
0502     sctp_unhash_transport(peer);
0503 
0504     /* Get the first transport of asoc. */
0505     pos = asoc->peer.transport_addr_list.next;
0506     transport = list_entry(pos, struct sctp_transport, transports);
0507 
0508     /* Update any entries that match the peer to be deleted. */
0509     if (asoc->peer.primary_path == peer)
0510         sctp_assoc_set_primary(asoc, transport);
0511     if (asoc->peer.active_path == peer)
0512         asoc->peer.active_path = transport;
0513     if (asoc->peer.retran_path == peer)
0514         asoc->peer.retran_path = transport;
0515     if (asoc->peer.last_data_from == peer)
0516         asoc->peer.last_data_from = transport;
0517 
0518     if (asoc->strreset_chunk &&
0519         asoc->strreset_chunk->transport == peer) {
0520         asoc->strreset_chunk->transport = transport;
0521         sctp_transport_reset_reconf_timer(transport);
0522     }
0523 
0524     /* If we remove the transport an INIT was last sent to, set it to
0525      * NULL. Combined with the update of the retran path above, this
0526      * will cause the next INIT to be sent to the next available
0527      * transport, maintaining the cycle.
0528      */
0529     if (asoc->init_last_sent_to == peer)
0530         asoc->init_last_sent_to = NULL;
0531 
0532     /* If we remove the transport an SHUTDOWN was last sent to, set it
0533      * to NULL. Combined with the update of the retran path above, this
0534      * will cause the next SHUTDOWN to be sent to the next available
0535      * transport, maintaining the cycle.
0536      */
0537     if (asoc->shutdown_last_sent_to == peer)
0538         asoc->shutdown_last_sent_to = NULL;
0539 
0540     /* If we remove the transport an ASCONF was last sent to, set it to
0541      * NULL.
0542      */
0543     if (asoc->addip_last_asconf &&
0544         asoc->addip_last_asconf->transport == peer)
0545         asoc->addip_last_asconf->transport = NULL;
0546 
0547     /* If we have something on the transmitted list, we have to
0548      * save it off.  The best place is the active path.
0549      */
0550     if (!list_empty(&peer->transmitted)) {
0551         struct sctp_transport *active = asoc->peer.active_path;
0552 
0553         /* Reset the transport of each chunk on this list */
0554         list_for_each_entry(ch, &peer->transmitted,
0555                     transmitted_list) {
0556             ch->transport = NULL;
0557             ch->rtt_in_progress = 0;
0558         }
0559 
0560         list_splice_tail_init(&peer->transmitted,
0561                     &active->transmitted);
0562 
0563         /* Start a T3 timer here in case it wasn't running so
0564          * that these migrated packets have a chance to get
0565          * retransmitted.
0566          */
0567         if (!timer_pending(&active->T3_rtx_timer))
0568             if (!mod_timer(&active->T3_rtx_timer,
0569                     jiffies + active->rto))
0570                 sctp_transport_hold(active);
0571     }
0572 
0573     list_for_each_entry(ch, &asoc->outqueue.out_chunk_list, list)
0574         if (ch->transport == peer)
0575             ch->transport = NULL;
0576 
0577     asoc->peer.transport_count--;
0578 
0579     sctp_ulpevent_notify_peer_addr_change(peer, SCTP_ADDR_REMOVED, 0);
0580     sctp_transport_free(peer);
0581 }
0582 
0583 /* Add a transport address to an association.  */
0584 struct sctp_transport *sctp_assoc_add_peer(struct sctp_association *asoc,
0585                        const union sctp_addr *addr,
0586                        const gfp_t gfp,
0587                        const int peer_state)
0588 {
0589     struct sctp_transport *peer;
0590     struct sctp_sock *sp;
0591     unsigned short port;
0592 
0593     sp = sctp_sk(asoc->base.sk);
0594 
0595     /* AF_INET and AF_INET6 share common port field. */
0596     port = ntohs(addr->v4.sin_port);
0597 
0598     pr_debug("%s: association:%p addr:%pISpc state:%d\n", __func__,
0599          asoc, &addr->sa, peer_state);
0600 
0601     /* Set the port if it has not been set yet.  */
0602     if (0 == asoc->peer.port)
0603         asoc->peer.port = port;
0604 
0605     /* Check to see if this is a duplicate. */
0606     peer = sctp_assoc_lookup_paddr(asoc, addr);
0607     if (peer) {
0608         /* An UNKNOWN state is only set on transports added by
0609          * user in sctp_connectx() call.  Such transports should be
0610          * considered CONFIRMED per RFC 4960, Section 5.4.
0611          */
0612         if (peer->state == SCTP_UNKNOWN) {
0613             peer->state = SCTP_ACTIVE;
0614         }
0615         return peer;
0616     }
0617 
0618     peer = sctp_transport_new(asoc->base.net, addr, gfp);
0619     if (!peer)
0620         return NULL;
0621 
0622     sctp_transport_set_owner(peer, asoc);
0623 
0624     /* Initialize the peer's heartbeat interval based on the
0625      * association configured value.
0626      */
0627     peer->hbinterval = asoc->hbinterval;
0628     peer->probe_interval = asoc->probe_interval;
0629 
0630     peer->encap_port = asoc->encap_port;
0631 
0632     /* Set the path max_retrans.  */
0633     peer->pathmaxrxt = asoc->pathmaxrxt;
0634 
0635     /* And the partial failure retrans threshold */
0636     peer->pf_retrans = asoc->pf_retrans;
0637     /* And the primary path switchover retrans threshold */
0638     peer->ps_retrans = asoc->ps_retrans;
0639 
0640     /* Initialize the peer's SACK delay timeout based on the
0641      * association configured value.
0642      */
0643     peer->sackdelay = asoc->sackdelay;
0644     peer->sackfreq = asoc->sackfreq;
0645 
0646     if (addr->sa.sa_family == AF_INET6) {
0647         __be32 info = addr->v6.sin6_flowinfo;
0648 
0649         if (info) {
0650             peer->flowlabel = ntohl(info & IPV6_FLOWLABEL_MASK);
0651             peer->flowlabel |= SCTP_FLOWLABEL_SET_MASK;
0652         } else {
0653             peer->flowlabel = asoc->flowlabel;
0654         }
0655     }
0656     peer->dscp = asoc->dscp;
0657 
0658     /* Enable/disable heartbeat, SACK delay, and path MTU discovery
0659      * based on association setting.
0660      */
0661     peer->param_flags = asoc->param_flags;
0662 
0663     /* Initialize the pmtu of the transport. */
0664     sctp_transport_route(peer, NULL, sp);
0665 
0666     /* If this is the first transport addr on this association,
0667      * initialize the association PMTU to the peer's PMTU.
0668      * If not and the current association PMTU is higher than the new
0669      * peer's PMTU, reset the association PMTU to the new peer's PMTU.
0670      */
0671     sctp_assoc_set_pmtu(asoc, asoc->pathmtu ?
0672                   min_t(int, peer->pathmtu, asoc->pathmtu) :
0673                   peer->pathmtu);
0674 
0675     peer->pmtu_pending = 0;
0676 
0677     /* The asoc->peer.port might not be meaningful yet, but
0678      * initialize the packet structure anyway.
0679      */
0680     sctp_packet_init(&peer->packet, peer, asoc->base.bind_addr.port,
0681              asoc->peer.port);
0682 
0683     /* 7.2.1 Slow-Start
0684      *
0685      * o The initial cwnd before DATA transmission or after a sufficiently
0686      *   long idle period MUST be set to
0687      *      min(4*MTU, max(2*MTU, 4380 bytes))
0688      *
0689      * o The initial value of ssthresh MAY be arbitrarily high
0690      *   (for example, implementations MAY use the size of the
0691      *   receiver advertised window).
0692      */
0693     peer->cwnd = min(4*asoc->pathmtu, max_t(__u32, 2*asoc->pathmtu, 4380));
0694 
0695     /* At this point, we may not have the receiver's advertised window,
0696      * so initialize ssthresh to the default value and it will be set
0697      * later when we process the INIT.
0698      */
0699     peer->ssthresh = SCTP_DEFAULT_MAXWINDOW;
0700 
0701     peer->partial_bytes_acked = 0;
0702     peer->flight_size = 0;
0703     peer->burst_limited = 0;
0704 
0705     /* Set the transport's RTO.initial value */
0706     peer->rto = asoc->rto_initial;
0707     sctp_max_rto(asoc, peer);
0708 
0709     /* Set the peer's active state. */
0710     peer->state = peer_state;
0711 
0712     /* Add this peer into the transport hashtable */
0713     if (sctp_hash_transport(peer)) {
0714         sctp_transport_free(peer);
0715         return NULL;
0716     }
0717 
0718     sctp_transport_pl_reset(peer);
0719 
0720     /* Attach the remote transport to our asoc.  */
0721     list_add_tail_rcu(&peer->transports, &asoc->peer.transport_addr_list);
0722     asoc->peer.transport_count++;
0723 
0724     sctp_ulpevent_notify_peer_addr_change(peer, SCTP_ADDR_ADDED, 0);
0725 
0726     /* If we do not yet have a primary path, set one.  */
0727     if (!asoc->peer.primary_path) {
0728         sctp_assoc_set_primary(asoc, peer);
0729         asoc->peer.retran_path = peer;
0730     }
0731 
0732     if (asoc->peer.active_path == asoc->peer.retran_path &&
0733         peer->state != SCTP_UNCONFIRMED) {
0734         asoc->peer.retran_path = peer;
0735     }
0736 
0737     return peer;
0738 }
0739 
0740 /* Delete a transport address from an association.  */
0741 void sctp_assoc_del_peer(struct sctp_association *asoc,
0742              const union sctp_addr *addr)
0743 {
0744     struct list_head    *pos;
0745     struct list_head    *temp;
0746     struct sctp_transport   *transport;
0747 
0748     list_for_each_safe(pos, temp, &asoc->peer.transport_addr_list) {
0749         transport = list_entry(pos, struct sctp_transport, transports);
0750         if (sctp_cmp_addr_exact(addr, &transport->ipaddr)) {
0751             /* Do book keeping for removing the peer and free it. */
0752             sctp_assoc_rm_peer(asoc, transport);
0753             break;
0754         }
0755     }
0756 }
0757 
0758 /* Lookup a transport by address. */
0759 struct sctp_transport *sctp_assoc_lookup_paddr(
0760                     const struct sctp_association *asoc,
0761                     const union sctp_addr *address)
0762 {
0763     struct sctp_transport *t;
0764 
0765     /* Cycle through all transports searching for a peer address. */
0766 
0767     list_for_each_entry(t, &asoc->peer.transport_addr_list,
0768             transports) {
0769         if (sctp_cmp_addr_exact(address, &t->ipaddr))
0770             return t;
0771     }
0772 
0773     return NULL;
0774 }
0775 
0776 /* Remove all transports except a give one */
0777 void sctp_assoc_del_nonprimary_peers(struct sctp_association *asoc,
0778                      struct sctp_transport *primary)
0779 {
0780     struct sctp_transport   *temp;
0781     struct sctp_transport   *t;
0782 
0783     list_for_each_entry_safe(t, temp, &asoc->peer.transport_addr_list,
0784                  transports) {
0785         /* if the current transport is not the primary one, delete it */
0786         if (t != primary)
0787             sctp_assoc_rm_peer(asoc, t);
0788     }
0789 }
0790 
0791 /* Engage in transport control operations.
0792  * Mark the transport up or down and send a notification to the user.
0793  * Select and update the new active and retran paths.
0794  */
0795 void sctp_assoc_control_transport(struct sctp_association *asoc,
0796                   struct sctp_transport *transport,
0797                   enum sctp_transport_cmd command,
0798                   sctp_sn_error_t error)
0799 {
0800     int spc_state = SCTP_ADDR_AVAILABLE;
0801     bool ulp_notify = true;
0802 
0803     /* Record the transition on the transport.  */
0804     switch (command) {
0805     case SCTP_TRANSPORT_UP:
0806         /* If we are moving from UNCONFIRMED state due
0807          * to heartbeat success, report the SCTP_ADDR_CONFIRMED
0808          * state to the user, otherwise report SCTP_ADDR_AVAILABLE.
0809          */
0810         if (transport->state == SCTP_PF &&
0811             asoc->pf_expose != SCTP_PF_EXPOSE_ENABLE)
0812             ulp_notify = false;
0813         else if (transport->state == SCTP_UNCONFIRMED &&
0814              error == SCTP_HEARTBEAT_SUCCESS)
0815             spc_state = SCTP_ADDR_CONFIRMED;
0816 
0817         transport->state = SCTP_ACTIVE;
0818         sctp_transport_pl_reset(transport);
0819         break;
0820 
0821     case SCTP_TRANSPORT_DOWN:
0822         /* If the transport was never confirmed, do not transition it
0823          * to inactive state.  Also, release the cached route since
0824          * there may be a better route next time.
0825          */
0826         if (transport->state != SCTP_UNCONFIRMED) {
0827             transport->state = SCTP_INACTIVE;
0828             sctp_transport_pl_reset(transport);
0829             spc_state = SCTP_ADDR_UNREACHABLE;
0830         } else {
0831             sctp_transport_dst_release(transport);
0832             ulp_notify = false;
0833         }
0834         break;
0835 
0836     case SCTP_TRANSPORT_PF:
0837         transport->state = SCTP_PF;
0838         if (asoc->pf_expose != SCTP_PF_EXPOSE_ENABLE)
0839             ulp_notify = false;
0840         else
0841             spc_state = SCTP_ADDR_POTENTIALLY_FAILED;
0842         break;
0843 
0844     default:
0845         return;
0846     }
0847 
0848     /* Generate and send a SCTP_PEER_ADDR_CHANGE notification
0849      * to the user.
0850      */
0851     if (ulp_notify)
0852         sctp_ulpevent_notify_peer_addr_change(transport,
0853                               spc_state, error);
0854 
0855     /* Select new active and retran paths. */
0856     sctp_select_active_and_retran_path(asoc);
0857 }
0858 
0859 /* Hold a reference to an association. */
0860 void sctp_association_hold(struct sctp_association *asoc)
0861 {
0862     refcount_inc(&asoc->base.refcnt);
0863 }
0864 
0865 /* Release a reference to an association and cleanup
0866  * if there are no more references.
0867  */
0868 void sctp_association_put(struct sctp_association *asoc)
0869 {
0870     if (refcount_dec_and_test(&asoc->base.refcnt))
0871         sctp_association_destroy(asoc);
0872 }
0873 
0874 /* Allocate the next TSN, Transmission Sequence Number, for the given
0875  * association.
0876  */
0877 __u32 sctp_association_get_next_tsn(struct sctp_association *asoc)
0878 {
0879     /* From Section 1.6 Serial Number Arithmetic:
0880      * Transmission Sequence Numbers wrap around when they reach
0881      * 2**32 - 1.  That is, the next TSN a DATA chunk MUST use
0882      * after transmitting TSN = 2*32 - 1 is TSN = 0.
0883      */
0884     __u32 retval = asoc->next_tsn;
0885     asoc->next_tsn++;
0886     asoc->unack_data++;
0887 
0888     return retval;
0889 }
0890 
0891 /* Compare two addresses to see if they match.  Wildcard addresses
0892  * only match themselves.
0893  */
0894 int sctp_cmp_addr_exact(const union sctp_addr *ss1,
0895             const union sctp_addr *ss2)
0896 {
0897     struct sctp_af *af;
0898 
0899     af = sctp_get_af_specific(ss1->sa.sa_family);
0900     if (unlikely(!af))
0901         return 0;
0902 
0903     return af->cmp_addr(ss1, ss2);
0904 }
0905 
0906 /* Return an ecne chunk to get prepended to a packet.
0907  * Note:  We are sly and return a shared, prealloced chunk.  FIXME:
0908  * No we don't, but we could/should.
0909  */
0910 struct sctp_chunk *sctp_get_ecne_prepend(struct sctp_association *asoc)
0911 {
0912     if (!asoc->need_ecne)
0913         return NULL;
0914 
0915     /* Send ECNE if needed.
0916      * Not being able to allocate a chunk here is not deadly.
0917      */
0918     return sctp_make_ecne(asoc, asoc->last_ecne_tsn);
0919 }
0920 
0921 /*
0922  * Find which transport this TSN was sent on.
0923  */
0924 struct sctp_transport *sctp_assoc_lookup_tsn(struct sctp_association *asoc,
0925                          __u32 tsn)
0926 {
0927     struct sctp_transport *active;
0928     struct sctp_transport *match;
0929     struct sctp_transport *transport;
0930     struct sctp_chunk *chunk;
0931     __be32 key = htonl(tsn);
0932 
0933     match = NULL;
0934 
0935     /*
0936      * FIXME: In general, find a more efficient data structure for
0937      * searching.
0938      */
0939 
0940     /*
0941      * The general strategy is to search each transport's transmitted
0942      * list.   Return which transport this TSN lives on.
0943      *
0944      * Let's be hopeful and check the active_path first.
0945      * Another optimization would be to know if there is only one
0946      * outbound path and not have to look for the TSN at all.
0947      *
0948      */
0949 
0950     active = asoc->peer.active_path;
0951 
0952     list_for_each_entry(chunk, &active->transmitted,
0953             transmitted_list) {
0954 
0955         if (key == chunk->subh.data_hdr->tsn) {
0956             match = active;
0957             goto out;
0958         }
0959     }
0960 
0961     /* If not found, go search all the other transports. */
0962     list_for_each_entry(transport, &asoc->peer.transport_addr_list,
0963             transports) {
0964 
0965         if (transport == active)
0966             continue;
0967         list_for_each_entry(chunk, &transport->transmitted,
0968                 transmitted_list) {
0969             if (key == chunk->subh.data_hdr->tsn) {
0970                 match = transport;
0971                 goto out;
0972             }
0973         }
0974     }
0975 out:
0976     return match;
0977 }
0978 
0979 /* Do delayed input processing.  This is scheduled by sctp_rcv(). */
0980 static void sctp_assoc_bh_rcv(struct work_struct *work)
0981 {
0982     struct sctp_association *asoc =
0983         container_of(work, struct sctp_association,
0984                  base.inqueue.immediate);
0985     struct net *net = asoc->base.net;
0986     union sctp_subtype subtype;
0987     struct sctp_endpoint *ep;
0988     struct sctp_chunk *chunk;
0989     struct sctp_inq *inqueue;
0990     int first_time = 1; /* is this the first time through the loop */
0991     int error = 0;
0992     int state;
0993 
0994     /* The association should be held so we should be safe. */
0995     ep = asoc->ep;
0996 
0997     inqueue = &asoc->base.inqueue;
0998     sctp_association_hold(asoc);
0999     while (NULL != (chunk = sctp_inq_pop(inqueue))) {
1000         state = asoc->state;
1001         subtype = SCTP_ST_CHUNK(chunk->chunk_hdr->type);
1002 
1003         /* If the first chunk in the packet is AUTH, do special
1004          * processing specified in Section 6.3 of SCTP-AUTH spec
1005          */
1006         if (first_time && subtype.chunk == SCTP_CID_AUTH) {
1007             struct sctp_chunkhdr *next_hdr;
1008 
1009             next_hdr = sctp_inq_peek(inqueue);
1010             if (!next_hdr)
1011                 goto normal;
1012 
1013             /* If the next chunk is COOKIE-ECHO, skip the AUTH
1014              * chunk while saving a pointer to it so we can do
1015              * Authentication later (during cookie-echo
1016              * processing).
1017              */
1018             if (next_hdr->type == SCTP_CID_COOKIE_ECHO) {
1019                 chunk->auth_chunk = skb_clone(chunk->skb,
1020                                   GFP_ATOMIC);
1021                 chunk->auth = 1;
1022                 continue;
1023             }
1024         }
1025 
1026 normal:
1027         /* SCTP-AUTH, Section 6.3:
1028          *    The receiver has a list of chunk types which it expects
1029          *    to be received only after an AUTH-chunk.  This list has
1030          *    been sent to the peer during the association setup.  It
1031          *    MUST silently discard these chunks if they are not placed
1032          *    after an AUTH chunk in the packet.
1033          */
1034         if (sctp_auth_recv_cid(subtype.chunk, asoc) && !chunk->auth)
1035             continue;
1036 
1037         /* Remember where the last DATA chunk came from so we
1038          * know where to send the SACK.
1039          */
1040         if (sctp_chunk_is_data(chunk))
1041             asoc->peer.last_data_from = chunk->transport;
1042         else {
1043             SCTP_INC_STATS(net, SCTP_MIB_INCTRLCHUNKS);
1044             asoc->stats.ictrlchunks++;
1045             if (chunk->chunk_hdr->type == SCTP_CID_SACK)
1046                 asoc->stats.isacks++;
1047         }
1048 
1049         if (chunk->transport)
1050             chunk->transport->last_time_heard = ktime_get();
1051 
1052         /* Run through the state machine. */
1053         error = sctp_do_sm(net, SCTP_EVENT_T_CHUNK, subtype,
1054                    state, ep, asoc, chunk, GFP_ATOMIC);
1055 
1056         /* Check to see if the association is freed in response to
1057          * the incoming chunk.  If so, get out of the while loop.
1058          */
1059         if (asoc->base.dead)
1060             break;
1061 
1062         /* If there is an error on chunk, discard this packet. */
1063         if (error && chunk)
1064             chunk->pdiscard = 1;
1065 
1066         if (first_time)
1067             first_time = 0;
1068     }
1069     sctp_association_put(asoc);
1070 }
1071 
1072 /* This routine moves an association from its old sk to a new sk.  */
1073 void sctp_assoc_migrate(struct sctp_association *assoc, struct sock *newsk)
1074 {
1075     struct sctp_sock *newsp = sctp_sk(newsk);
1076     struct sock *oldsk = assoc->base.sk;
1077 
1078     /* Delete the association from the old endpoint's list of
1079      * associations.
1080      */
1081     list_del_init(&assoc->asocs);
1082 
1083     /* Decrement the backlog value for a TCP-style socket. */
1084     if (sctp_style(oldsk, TCP))
1085         sk_acceptq_removed(oldsk);
1086 
1087     /* Release references to the old endpoint and the sock.  */
1088     sctp_endpoint_put(assoc->ep);
1089     sock_put(assoc->base.sk);
1090 
1091     /* Get a reference to the new endpoint.  */
1092     assoc->ep = newsp->ep;
1093     sctp_endpoint_hold(assoc->ep);
1094 
1095     /* Get a reference to the new sock.  */
1096     assoc->base.sk = newsk;
1097     sock_hold(assoc->base.sk);
1098 
1099     /* Add the association to the new endpoint's list of associations.  */
1100     sctp_endpoint_add_asoc(newsp->ep, assoc);
1101 }
1102 
1103 /* Update an association (possibly from unexpected COOKIE-ECHO processing).  */
1104 int sctp_assoc_update(struct sctp_association *asoc,
1105               struct sctp_association *new)
1106 {
1107     struct sctp_transport *trans;
1108     struct list_head *pos, *temp;
1109 
1110     /* Copy in new parameters of peer. */
1111     asoc->c = new->c;
1112     asoc->peer.rwnd = new->peer.rwnd;
1113     asoc->peer.sack_needed = new->peer.sack_needed;
1114     asoc->peer.auth_capable = new->peer.auth_capable;
1115     asoc->peer.i = new->peer.i;
1116 
1117     if (!sctp_tsnmap_init(&asoc->peer.tsn_map, SCTP_TSN_MAP_INITIAL,
1118                   asoc->peer.i.initial_tsn, GFP_ATOMIC))
1119         return -ENOMEM;
1120 
1121     /* Remove any peer addresses not present in the new association. */
1122     list_for_each_safe(pos, temp, &asoc->peer.transport_addr_list) {
1123         trans = list_entry(pos, struct sctp_transport, transports);
1124         if (!sctp_assoc_lookup_paddr(new, &trans->ipaddr)) {
1125             sctp_assoc_rm_peer(asoc, trans);
1126             continue;
1127         }
1128 
1129         if (asoc->state >= SCTP_STATE_ESTABLISHED)
1130             sctp_transport_reset(trans);
1131     }
1132 
1133     /* If the case is A (association restart), use
1134      * initial_tsn as next_tsn. If the case is B, use
1135      * current next_tsn in case data sent to peer
1136      * has been discarded and needs retransmission.
1137      */
1138     if (asoc->state >= SCTP_STATE_ESTABLISHED) {
1139         asoc->next_tsn = new->next_tsn;
1140         asoc->ctsn_ack_point = new->ctsn_ack_point;
1141         asoc->adv_peer_ack_point = new->adv_peer_ack_point;
1142 
1143         /* Reinitialize SSN for both local streams
1144          * and peer's streams.
1145          */
1146         sctp_stream_clear(&asoc->stream);
1147 
1148         /* Flush the ULP reassembly and ordered queue.
1149          * Any data there will now be stale and will
1150          * cause problems.
1151          */
1152         sctp_ulpq_flush(&asoc->ulpq);
1153 
1154         /* reset the overall association error count so
1155          * that the restarted association doesn't get torn
1156          * down on the next retransmission timer.
1157          */
1158         asoc->overall_error_count = 0;
1159 
1160     } else {
1161         /* Add any peer addresses from the new association. */
1162         list_for_each_entry(trans, &new->peer.transport_addr_list,
1163                     transports)
1164             if (!sctp_assoc_lookup_paddr(asoc, &trans->ipaddr) &&
1165                 !sctp_assoc_add_peer(asoc, &trans->ipaddr,
1166                          GFP_ATOMIC, trans->state))
1167                 return -ENOMEM;
1168 
1169         asoc->ctsn_ack_point = asoc->next_tsn - 1;
1170         asoc->adv_peer_ack_point = asoc->ctsn_ack_point;
1171 
1172         if (sctp_state(asoc, COOKIE_WAIT))
1173             sctp_stream_update(&asoc->stream, &new->stream);
1174 
1175         /* get a new assoc id if we don't have one yet. */
1176         if (sctp_assoc_set_id(asoc, GFP_ATOMIC))
1177             return -ENOMEM;
1178     }
1179 
1180     /* SCTP-AUTH: Save the peer parameters from the new associations
1181      * and also move the association shared keys over
1182      */
1183     kfree(asoc->peer.peer_random);
1184     asoc->peer.peer_random = new->peer.peer_random;
1185     new->peer.peer_random = NULL;
1186 
1187     kfree(asoc->peer.peer_chunks);
1188     asoc->peer.peer_chunks = new->peer.peer_chunks;
1189     new->peer.peer_chunks = NULL;
1190 
1191     kfree(asoc->peer.peer_hmacs);
1192     asoc->peer.peer_hmacs = new->peer.peer_hmacs;
1193     new->peer.peer_hmacs = NULL;
1194 
1195     return sctp_auth_asoc_init_active_key(asoc, GFP_ATOMIC);
1196 }
1197 
1198 /* Update the retran path for sending a retransmitted packet.
1199  * See also RFC4960, 6.4. Multi-Homed SCTP Endpoints:
1200  *
1201  *   When there is outbound data to send and the primary path
1202  *   becomes inactive (e.g., due to failures), or where the
1203  *   SCTP user explicitly requests to send data to an
1204  *   inactive destination transport address, before reporting
1205  *   an error to its ULP, the SCTP endpoint should try to send
1206  *   the data to an alternate active destination transport
1207  *   address if one exists.
1208  *
1209  *   When retransmitting data that timed out, if the endpoint
1210  *   is multihomed, it should consider each source-destination
1211  *   address pair in its retransmission selection policy.
1212  *   When retransmitting timed-out data, the endpoint should
1213  *   attempt to pick the most divergent source-destination
1214  *   pair from the original source-destination pair to which
1215  *   the packet was transmitted.
1216  *
1217  *   Note: Rules for picking the most divergent source-destination
1218  *   pair are an implementation decision and are not specified
1219  *   within this document.
1220  *
1221  * Our basic strategy is to round-robin transports in priorities
1222  * according to sctp_trans_score() e.g., if no such
1223  * transport with state SCTP_ACTIVE exists, round-robin through
1224  * SCTP_UNKNOWN, etc. You get the picture.
1225  */
1226 static u8 sctp_trans_score(const struct sctp_transport *trans)
1227 {
1228     switch (trans->state) {
1229     case SCTP_ACTIVE:
1230         return 3;   /* best case */
1231     case SCTP_UNKNOWN:
1232         return 2;
1233     case SCTP_PF:
1234         return 1;
1235     default: /* case SCTP_INACTIVE */
1236         return 0;   /* worst case */
1237     }
1238 }
1239 
1240 static struct sctp_transport *sctp_trans_elect_tie(struct sctp_transport *trans1,
1241                            struct sctp_transport *trans2)
1242 {
1243     if (trans1->error_count > trans2->error_count) {
1244         return trans2;
1245     } else if (trans1->error_count == trans2->error_count &&
1246            ktime_after(trans2->last_time_heard,
1247                    trans1->last_time_heard)) {
1248         return trans2;
1249     } else {
1250         return trans1;
1251     }
1252 }
1253 
1254 static struct sctp_transport *sctp_trans_elect_best(struct sctp_transport *curr,
1255                             struct sctp_transport *best)
1256 {
1257     u8 score_curr, score_best;
1258 
1259     if (best == NULL || curr == best)
1260         return curr;
1261 
1262     score_curr = sctp_trans_score(curr);
1263     score_best = sctp_trans_score(best);
1264 
1265     /* First, try a score-based selection if both transport states
1266      * differ. If we're in a tie, lets try to make a more clever
1267      * decision here based on error counts and last time heard.
1268      */
1269     if (score_curr > score_best)
1270         return curr;
1271     else if (score_curr == score_best)
1272         return sctp_trans_elect_tie(best, curr);
1273     else
1274         return best;
1275 }
1276 
1277 void sctp_assoc_update_retran_path(struct sctp_association *asoc)
1278 {
1279     struct sctp_transport *trans = asoc->peer.retran_path;
1280     struct sctp_transport *trans_next = NULL;
1281 
1282     /* We're done as we only have the one and only path. */
1283     if (asoc->peer.transport_count == 1)
1284         return;
1285     /* If active_path and retran_path are the same and active,
1286      * then this is the only active path. Use it.
1287      */
1288     if (asoc->peer.active_path == asoc->peer.retran_path &&
1289         asoc->peer.active_path->state == SCTP_ACTIVE)
1290         return;
1291 
1292     /* Iterate from retran_path's successor back to retran_path. */
1293     for (trans = list_next_entry(trans, transports); 1;
1294          trans = list_next_entry(trans, transports)) {
1295         /* Manually skip the head element. */
1296         if (&trans->transports == &asoc->peer.transport_addr_list)
1297             continue;
1298         if (trans->state == SCTP_UNCONFIRMED)
1299             continue;
1300         trans_next = sctp_trans_elect_best(trans, trans_next);
1301         /* Active is good enough for immediate return. */
1302         if (trans_next->state == SCTP_ACTIVE)
1303             break;
1304         /* We've reached the end, time to update path. */
1305         if (trans == asoc->peer.retran_path)
1306             break;
1307     }
1308 
1309     asoc->peer.retran_path = trans_next;
1310 
1311     pr_debug("%s: association:%p updated new path to addr:%pISpc\n",
1312          __func__, asoc, &asoc->peer.retran_path->ipaddr.sa);
1313 }
1314 
1315 static void sctp_select_active_and_retran_path(struct sctp_association *asoc)
1316 {
1317     struct sctp_transport *trans, *trans_pri = NULL, *trans_sec = NULL;
1318     struct sctp_transport *trans_pf = NULL;
1319 
1320     /* Look for the two most recently used active transports. */
1321     list_for_each_entry(trans, &asoc->peer.transport_addr_list,
1322                 transports) {
1323         /* Skip uninteresting transports. */
1324         if (trans->state == SCTP_INACTIVE ||
1325             trans->state == SCTP_UNCONFIRMED)
1326             continue;
1327         /* Keep track of the best PF transport from our
1328          * list in case we don't find an active one.
1329          */
1330         if (trans->state == SCTP_PF) {
1331             trans_pf = sctp_trans_elect_best(trans, trans_pf);
1332             continue;
1333         }
1334         /* For active transports, pick the most recent ones. */
1335         if (trans_pri == NULL ||
1336             ktime_after(trans->last_time_heard,
1337                 trans_pri->last_time_heard)) {
1338             trans_sec = trans_pri;
1339             trans_pri = trans;
1340         } else if (trans_sec == NULL ||
1341                ktime_after(trans->last_time_heard,
1342                        trans_sec->last_time_heard)) {
1343             trans_sec = trans;
1344         }
1345     }
1346 
1347     /* RFC 2960 6.4 Multi-Homed SCTP Endpoints
1348      *
1349      * By default, an endpoint should always transmit to the primary
1350      * path, unless the SCTP user explicitly specifies the
1351      * destination transport address (and possibly source transport
1352      * address) to use. [If the primary is active but not most recent,
1353      * bump the most recently used transport.]
1354      */
1355     if ((asoc->peer.primary_path->state == SCTP_ACTIVE ||
1356          asoc->peer.primary_path->state == SCTP_UNKNOWN) &&
1357          asoc->peer.primary_path != trans_pri) {
1358         trans_sec = trans_pri;
1359         trans_pri = asoc->peer.primary_path;
1360     }
1361 
1362     /* We did not find anything useful for a possible retransmission
1363      * path; either primary path that we found is the same as
1364      * the current one, or we didn't generally find an active one.
1365      */
1366     if (trans_sec == NULL)
1367         trans_sec = trans_pri;
1368 
1369     /* If we failed to find a usable transport, just camp on the
1370      * active or pick a PF iff it's the better choice.
1371      */
1372     if (trans_pri == NULL) {
1373         trans_pri = sctp_trans_elect_best(asoc->peer.active_path, trans_pf);
1374         trans_sec = trans_pri;
1375     }
1376 
1377     /* Set the active and retran transports. */
1378     asoc->peer.active_path = trans_pri;
1379     asoc->peer.retran_path = trans_sec;
1380 }
1381 
1382 struct sctp_transport *
1383 sctp_assoc_choose_alter_transport(struct sctp_association *asoc,
1384                   struct sctp_transport *last_sent_to)
1385 {
1386     /* If this is the first time packet is sent, use the active path,
1387      * else use the retran path. If the last packet was sent over the
1388      * retran path, update the retran path and use it.
1389      */
1390     if (last_sent_to == NULL) {
1391         return asoc->peer.active_path;
1392     } else {
1393         if (last_sent_to == asoc->peer.retran_path)
1394             sctp_assoc_update_retran_path(asoc);
1395 
1396         return asoc->peer.retran_path;
1397     }
1398 }
1399 
1400 void sctp_assoc_update_frag_point(struct sctp_association *asoc)
1401 {
1402     int frag = sctp_mtu_payload(sctp_sk(asoc->base.sk), asoc->pathmtu,
1403                     sctp_datachk_len(&asoc->stream));
1404 
1405     if (asoc->user_frag)
1406         frag = min_t(int, frag, asoc->user_frag);
1407 
1408     frag = min_t(int, frag, SCTP_MAX_CHUNK_LEN -
1409                 sctp_datachk_len(&asoc->stream));
1410 
1411     asoc->frag_point = SCTP_TRUNC4(frag);
1412 }
1413 
1414 void sctp_assoc_set_pmtu(struct sctp_association *asoc, __u32 pmtu)
1415 {
1416     if (asoc->pathmtu != pmtu) {
1417         asoc->pathmtu = pmtu;
1418         sctp_assoc_update_frag_point(asoc);
1419     }
1420 
1421     pr_debug("%s: asoc:%p, pmtu:%d, frag_point:%d\n", __func__, asoc,
1422          asoc->pathmtu, asoc->frag_point);
1423 }
1424 
1425 /* Update the association's pmtu and frag_point by going through all the
1426  * transports. This routine is called when a transport's PMTU has changed.
1427  */
1428 void sctp_assoc_sync_pmtu(struct sctp_association *asoc)
1429 {
1430     struct sctp_transport *t;
1431     __u32 pmtu = 0;
1432 
1433     if (!asoc)
1434         return;
1435 
1436     /* Get the lowest pmtu of all the transports. */
1437     list_for_each_entry(t, &asoc->peer.transport_addr_list, transports) {
1438         if (t->pmtu_pending && t->dst) {
1439             sctp_transport_update_pmtu(t,
1440                            atomic_read(&t->mtu_info));
1441             t->pmtu_pending = 0;
1442         }
1443         if (!pmtu || (t->pathmtu < pmtu))
1444             pmtu = t->pathmtu;
1445     }
1446 
1447     sctp_assoc_set_pmtu(asoc, pmtu);
1448 }
1449 
1450 /* Should we send a SACK to update our peer? */
1451 static inline bool sctp_peer_needs_update(struct sctp_association *asoc)
1452 {
1453     struct net *net = asoc->base.net;
1454 
1455     switch (asoc->state) {
1456     case SCTP_STATE_ESTABLISHED:
1457     case SCTP_STATE_SHUTDOWN_PENDING:
1458     case SCTP_STATE_SHUTDOWN_RECEIVED:
1459     case SCTP_STATE_SHUTDOWN_SENT:
1460         if ((asoc->rwnd > asoc->a_rwnd) &&
1461             ((asoc->rwnd - asoc->a_rwnd) >= max_t(__u32,
1462                (asoc->base.sk->sk_rcvbuf >> net->sctp.rwnd_upd_shift),
1463                asoc->pathmtu)))
1464             return true;
1465         break;
1466     default:
1467         break;
1468     }
1469     return false;
1470 }
1471 
1472 /* Increase asoc's rwnd by len and send any window update SACK if needed. */
1473 void sctp_assoc_rwnd_increase(struct sctp_association *asoc, unsigned int len)
1474 {
1475     struct sctp_chunk *sack;
1476     struct timer_list *timer;
1477 
1478     if (asoc->rwnd_over) {
1479         if (asoc->rwnd_over >= len) {
1480             asoc->rwnd_over -= len;
1481         } else {
1482             asoc->rwnd += (len - asoc->rwnd_over);
1483             asoc->rwnd_over = 0;
1484         }
1485     } else {
1486         asoc->rwnd += len;
1487     }
1488 
1489     /* If we had window pressure, start recovering it
1490      * once our rwnd had reached the accumulated pressure
1491      * threshold.  The idea is to recover slowly, but up
1492      * to the initial advertised window.
1493      */
1494     if (asoc->rwnd_press) {
1495         int change = min(asoc->pathmtu, asoc->rwnd_press);
1496         asoc->rwnd += change;
1497         asoc->rwnd_press -= change;
1498     }
1499 
1500     pr_debug("%s: asoc:%p rwnd increased by %d to (%u, %u) - %u\n",
1501          __func__, asoc, len, asoc->rwnd, asoc->rwnd_over,
1502          asoc->a_rwnd);
1503 
1504     /* Send a window update SACK if the rwnd has increased by at least the
1505      * minimum of the association's PMTU and half of the receive buffer.
1506      * The algorithm used is similar to the one described in
1507      * Section 4.2.3.3 of RFC 1122.
1508      */
1509     if (sctp_peer_needs_update(asoc)) {
1510         asoc->a_rwnd = asoc->rwnd;
1511 
1512         pr_debug("%s: sending window update SACK- asoc:%p rwnd:%u "
1513              "a_rwnd:%u\n", __func__, asoc, asoc->rwnd,
1514              asoc->a_rwnd);
1515 
1516         sack = sctp_make_sack(asoc);
1517         if (!sack)
1518             return;
1519 
1520         asoc->peer.sack_needed = 0;
1521 
1522         sctp_outq_tail(&asoc->outqueue, sack, GFP_ATOMIC);
1523 
1524         /* Stop the SACK timer.  */
1525         timer = &asoc->timers[SCTP_EVENT_TIMEOUT_SACK];
1526         if (del_timer(timer))
1527             sctp_association_put(asoc);
1528     }
1529 }
1530 
1531 /* Decrease asoc's rwnd by len. */
1532 void sctp_assoc_rwnd_decrease(struct sctp_association *asoc, unsigned int len)
1533 {
1534     int rx_count;
1535     int over = 0;
1536 
1537     if (unlikely(!asoc->rwnd || asoc->rwnd_over))
1538         pr_debug("%s: association:%p has asoc->rwnd:%u, "
1539              "asoc->rwnd_over:%u!\n", __func__, asoc,
1540              asoc->rwnd, asoc->rwnd_over);
1541 
1542     if (asoc->ep->rcvbuf_policy)
1543         rx_count = atomic_read(&asoc->rmem_alloc);
1544     else
1545         rx_count = atomic_read(&asoc->base.sk->sk_rmem_alloc);
1546 
1547     /* If we've reached or overflowed our receive buffer, announce
1548      * a 0 rwnd if rwnd would still be positive.  Store the
1549      * potential pressure overflow so that the window can be restored
1550      * back to original value.
1551      */
1552     if (rx_count >= asoc->base.sk->sk_rcvbuf)
1553         over = 1;
1554 
1555     if (asoc->rwnd >= len) {
1556         asoc->rwnd -= len;
1557         if (over) {
1558             asoc->rwnd_press += asoc->rwnd;
1559             asoc->rwnd = 0;
1560         }
1561     } else {
1562         asoc->rwnd_over += len - asoc->rwnd;
1563         asoc->rwnd = 0;
1564     }
1565 
1566     pr_debug("%s: asoc:%p rwnd decreased by %d to (%u, %u, %u)\n",
1567          __func__, asoc, len, asoc->rwnd, asoc->rwnd_over,
1568          asoc->rwnd_press);
1569 }
1570 
1571 /* Build the bind address list for the association based on info from the
1572  * local endpoint and the remote peer.
1573  */
1574 int sctp_assoc_set_bind_addr_from_ep(struct sctp_association *asoc,
1575                      enum sctp_scope scope, gfp_t gfp)
1576 {
1577     struct sock *sk = asoc->base.sk;
1578     int flags;
1579 
1580     /* Use scoping rules to determine the subset of addresses from
1581      * the endpoint.
1582      */
1583     flags = (PF_INET6 == sk->sk_family) ? SCTP_ADDR6_ALLOWED : 0;
1584     if (!inet_v6_ipv6only(sk))
1585         flags |= SCTP_ADDR4_ALLOWED;
1586     if (asoc->peer.ipv4_address)
1587         flags |= SCTP_ADDR4_PEERSUPP;
1588     if (asoc->peer.ipv6_address)
1589         flags |= SCTP_ADDR6_PEERSUPP;
1590 
1591     return sctp_bind_addr_copy(asoc->base.net,
1592                    &asoc->base.bind_addr,
1593                    &asoc->ep->base.bind_addr,
1594                    scope, gfp, flags);
1595 }
1596 
1597 /* Build the association's bind address list from the cookie.  */
1598 int sctp_assoc_set_bind_addr_from_cookie(struct sctp_association *asoc,
1599                      struct sctp_cookie *cookie,
1600                      gfp_t gfp)
1601 {
1602     int var_size2 = ntohs(cookie->peer_init->chunk_hdr.length);
1603     int var_size3 = cookie->raw_addr_list_len;
1604     __u8 *raw = (__u8 *)cookie->peer_init + var_size2;
1605 
1606     return sctp_raw_to_bind_addrs(&asoc->base.bind_addr, raw, var_size3,
1607                       asoc->ep->base.bind_addr.port, gfp);
1608 }
1609 
1610 /* Lookup laddr in the bind address list of an association. */
1611 int sctp_assoc_lookup_laddr(struct sctp_association *asoc,
1612                 const union sctp_addr *laddr)
1613 {
1614     int found = 0;
1615 
1616     if ((asoc->base.bind_addr.port == ntohs(laddr->v4.sin_port)) &&
1617         sctp_bind_addr_match(&asoc->base.bind_addr, laddr,
1618                  sctp_sk(asoc->base.sk)))
1619         found = 1;
1620 
1621     return found;
1622 }
1623 
1624 /* Set an association id for a given association */
1625 int sctp_assoc_set_id(struct sctp_association *asoc, gfp_t gfp)
1626 {
1627     bool preload = gfpflags_allow_blocking(gfp);
1628     int ret;
1629 
1630     /* If the id is already assigned, keep it. */
1631     if (asoc->assoc_id)
1632         return 0;
1633 
1634     if (preload)
1635         idr_preload(gfp);
1636     spin_lock_bh(&sctp_assocs_id_lock);
1637     /* 0, 1, 2 are used as SCTP_FUTURE_ASSOC, SCTP_CURRENT_ASSOC and
1638      * SCTP_ALL_ASSOC, so an available id must be > SCTP_ALL_ASSOC.
1639      */
1640     ret = idr_alloc_cyclic(&sctp_assocs_id, asoc, SCTP_ALL_ASSOC + 1, 0,
1641                    GFP_NOWAIT);
1642     spin_unlock_bh(&sctp_assocs_id_lock);
1643     if (preload)
1644         idr_preload_end();
1645     if (ret < 0)
1646         return ret;
1647 
1648     asoc->assoc_id = (sctp_assoc_t)ret;
1649     return 0;
1650 }
1651 
1652 /* Free the ASCONF queue */
1653 static void sctp_assoc_free_asconf_queue(struct sctp_association *asoc)
1654 {
1655     struct sctp_chunk *asconf;
1656     struct sctp_chunk *tmp;
1657 
1658     list_for_each_entry_safe(asconf, tmp, &asoc->addip_chunk_list, list) {
1659         list_del_init(&asconf->list);
1660         sctp_chunk_free(asconf);
1661     }
1662 }
1663 
1664 /* Free asconf_ack cache */
1665 static void sctp_assoc_free_asconf_acks(struct sctp_association *asoc)
1666 {
1667     struct sctp_chunk *ack;
1668     struct sctp_chunk *tmp;
1669 
1670     list_for_each_entry_safe(ack, tmp, &asoc->asconf_ack_list,
1671                 transmitted_list) {
1672         list_del_init(&ack->transmitted_list);
1673         sctp_chunk_free(ack);
1674     }
1675 }
1676 
1677 /* Clean up the ASCONF_ACK queue */
1678 void sctp_assoc_clean_asconf_ack_cache(const struct sctp_association *asoc)
1679 {
1680     struct sctp_chunk *ack;
1681     struct sctp_chunk *tmp;
1682 
1683     /* We can remove all the entries from the queue up to
1684      * the "Peer-Sequence-Number".
1685      */
1686     list_for_each_entry_safe(ack, tmp, &asoc->asconf_ack_list,
1687                 transmitted_list) {
1688         if (ack->subh.addip_hdr->serial ==
1689                 htonl(asoc->peer.addip_serial))
1690             break;
1691 
1692         list_del_init(&ack->transmitted_list);
1693         sctp_chunk_free(ack);
1694     }
1695 }
1696 
1697 /* Find the ASCONF_ACK whose serial number matches ASCONF */
1698 struct sctp_chunk *sctp_assoc_lookup_asconf_ack(
1699                     const struct sctp_association *asoc,
1700                     __be32 serial)
1701 {
1702     struct sctp_chunk *ack;
1703 
1704     /* Walk through the list of cached ASCONF-ACKs and find the
1705      * ack chunk whose serial number matches that of the request.
1706      */
1707     list_for_each_entry(ack, &asoc->asconf_ack_list, transmitted_list) {
1708         if (sctp_chunk_pending(ack))
1709             continue;
1710         if (ack->subh.addip_hdr->serial == serial) {
1711             sctp_chunk_hold(ack);
1712             return ack;
1713         }
1714     }
1715 
1716     return NULL;
1717 }
1718 
1719 void sctp_asconf_queue_teardown(struct sctp_association *asoc)
1720 {
1721     /* Free any cached ASCONF_ACK chunk. */
1722     sctp_assoc_free_asconf_acks(asoc);
1723 
1724     /* Free the ASCONF queue. */
1725     sctp_assoc_free_asconf_queue(asoc);
1726 
1727     /* Free any cached ASCONF chunk. */
1728     if (asoc->addip_last_asconf)
1729         sctp_chunk_free(asoc->addip_last_asconf);
1730 }