1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* SCTP kernel implementation
3 * (C) Copyright IBM Corp. 2001, 2003
4 * Copyright (c) Cisco 1999,2000
5 * Copyright (c) Motorola 1999,2000,2001
6 * Copyright (c) La Monte H.P. Yarroll 2001
8 * This file is part of the SCTP kernel implementation.
10 * A collection class to handle the storage of transport addresses.
12 * Please send any bug reports or fixes you make to the
14 * lksctp developers <linux-sctp@vger.kernel.org>
16 * Written or modified by:
17 * La Monte H.P. Yarroll <piggy@acm.org>
18 * Karl Knutson <karl@athena.chicago.il.us>
19 * Jon Grimm <jgrimm@us.ibm.com>
20 * Daisy Chang <daisyc@us.ibm.com>
23 #include <linux/types.h>
24 #include <linux/slab.h>
28 #include <net/if_inet6.h>
29 #include <net/sctp/sctp.h>
30 #include <net/sctp/sm.h>
32 /* Forward declarations for internal helpers. */
33 static int sctp_copy_one_addr(struct net *net, struct sctp_bind_addr *dest,
34 union sctp_addr *addr, enum sctp_scope scope,
35 gfp_t gfp, int flags);
36 static void sctp_bind_addr_clean(struct sctp_bind_addr *);
38 /* First Level Abstractions. */
40 /* Copy 'src' to 'dest' taking 'scope' into account. Omit addresses
41 * in 'src' which have a broader scope than 'scope'.
43 int sctp_bind_addr_copy(struct net *net, struct sctp_bind_addr *dest,
44 const struct sctp_bind_addr *src,
45 enum sctp_scope scope, gfp_t gfp,
48 struct sctp_sockaddr_entry *addr;
51 /* All addresses share the same port. */
52 dest->port = src->port;
54 /* Extract the addresses which are relevant for this scope. */
55 list_for_each_entry(addr, &src->address_list, list) {
56 error = sctp_copy_one_addr(net, dest, &addr->a, scope,
62 /* If there are no addresses matching the scope and
63 * this is global scope, try to get a link scope address, with
64 * the assumption that we must be sitting behind a NAT.
66 if (list_empty(&dest->address_list) && (SCTP_SCOPE_GLOBAL == scope)) {
67 list_for_each_entry(addr, &src->address_list, list) {
68 error = sctp_copy_one_addr(net, dest, &addr->a,
76 /* If somehow no addresses were found that can be used with this
77 * scope, it's an error.
79 if (list_empty(&dest->address_list))
84 sctp_bind_addr_clean(dest);
89 /* Exactly duplicate the address lists. This is necessary when doing
90 * peer-offs and accepts. We don't want to put all the current system
91 * addresses into the endpoint. That's useless. But we do want duplicat
92 * the list of bound addresses that the older endpoint used.
94 int sctp_bind_addr_dup(struct sctp_bind_addr *dest,
95 const struct sctp_bind_addr *src,
98 struct sctp_sockaddr_entry *addr;
101 /* All addresses share the same port. */
102 dest->port = src->port;
104 list_for_each_entry(addr, &src->address_list, list) {
105 error = sctp_add_bind_addr(dest, &addr->a, sizeof(addr->a),
114 /* Initialize the SCTP_bind_addr structure for either an endpoint or
117 void sctp_bind_addr_init(struct sctp_bind_addr *bp, __u16 port)
119 INIT_LIST_HEAD(&bp->address_list);
123 /* Dispose of the address list. */
124 static void sctp_bind_addr_clean(struct sctp_bind_addr *bp)
126 struct sctp_sockaddr_entry *addr, *temp;
128 /* Empty the bind address list. */
129 list_for_each_entry_safe(addr, temp, &bp->address_list, list) {
130 list_del_rcu(&addr->list);
131 kfree_rcu(addr, rcu);
132 SCTP_DBG_OBJCNT_DEC(addr);
136 /* Dispose of an SCTP_bind_addr structure */
137 void sctp_bind_addr_free(struct sctp_bind_addr *bp)
139 /* Empty the bind address list. */
140 sctp_bind_addr_clean(bp);
143 /* Add an address to the bind address list in the SCTP_bind_addr structure. */
144 int sctp_add_bind_addr(struct sctp_bind_addr *bp, union sctp_addr *new,
145 int new_size, __u8 addr_state, gfp_t gfp)
147 struct sctp_sockaddr_entry *addr;
149 /* Add the address to the bind address list. */
150 addr = kzalloc(sizeof(*addr), gfp);
154 memcpy(&addr->a, new, min_t(size_t, sizeof(*new), new_size));
156 /* Fix up the port if it has not yet been set.
157 * Both v4 and v6 have the port at the same offset.
159 if (!addr->a.v4.sin_port)
160 addr->a.v4.sin_port = htons(bp->port);
162 addr->state = addr_state;
165 INIT_LIST_HEAD(&addr->list);
167 /* We always hold a socket lock when calling this function,
168 * and that acts as a writer synchronizing lock.
170 list_add_tail_rcu(&addr->list, &bp->address_list);
171 SCTP_DBG_OBJCNT_INC(addr);
176 /* Delete an address from the bind address list in the SCTP_bind_addr
179 int sctp_del_bind_addr(struct sctp_bind_addr *bp, union sctp_addr *del_addr)
181 struct sctp_sockaddr_entry *addr, *temp;
184 /* We hold the socket lock when calling this function,
185 * and that acts as a writer synchronizing lock.
187 list_for_each_entry_safe(addr, temp, &bp->address_list, list) {
188 if (sctp_cmp_addr_exact(&addr->a, del_addr)) {
189 /* Found the exact match. */
192 list_del_rcu(&addr->list);
198 kfree_rcu(addr, rcu);
199 SCTP_DBG_OBJCNT_DEC(addr);
206 /* Create a network byte-order representation of all the addresses
207 * formated as SCTP parameters.
209 * The second argument is the return value for the length.
211 union sctp_params sctp_bind_addrs_to_raw(const struct sctp_bind_addr *bp,
215 union sctp_params addrparms;
216 union sctp_params retval;
218 union sctp_addr_param rawaddr;
220 struct sctp_sockaddr_entry *addr;
221 struct list_head *pos;
227 /* Allocate enough memory at once. */
228 list_for_each(pos, &bp->address_list) {
229 len += sizeof(union sctp_addr_param);
232 /* Don't even bother embedding an address if there
235 if (len == sizeof(union sctp_addr_param)) {
240 retval.v = kmalloc(len, gfp);
246 list_for_each_entry(addr, &bp->address_list, list) {
247 af = sctp_get_af_specific(addr->a.v4.sin_family);
248 len = af->to_addr_param(&addr->a, &rawaddr);
249 memcpy(addrparms.v, &rawaddr, len);
251 addrparms_len += len;
255 *addrs_len = addrparms_len;
260 * Create an address list out of the raw address list format (IPv4 and IPv6
261 * address parameters).
263 int sctp_raw_to_bind_addrs(struct sctp_bind_addr *bp, __u8 *raw_addr_list,
264 int addrs_len, __u16 port, gfp_t gfp)
266 union sctp_addr_param *rawaddr;
267 struct sctp_paramhdr *param;
268 union sctp_addr addr;
273 /* Convert the raw address to standard address format */
275 param = (struct sctp_paramhdr *)raw_addr_list;
276 rawaddr = (union sctp_addr_param *)raw_addr_list;
278 af = sctp_get_af_specific(param_type2af(param->type));
280 !af->from_addr_param(&addr, rawaddr, htons(port), 0)) {
285 if (sctp_bind_addr_state(bp, &addr) != -1)
287 retval = sctp_add_bind_addr(bp, &addr, sizeof(addr),
290 /* Can't finish building the list, clean up. */
294 len = ntohs(param->length);
296 raw_addr_list += len;
303 sctp_bind_addr_clean(bp);
308 /********************************************************************
309 * 2nd Level Abstractions
310 ********************************************************************/
312 /* Does this contain a specified address? Allow wildcarding. */
313 int sctp_bind_addr_match(struct sctp_bind_addr *bp,
314 const union sctp_addr *addr,
315 struct sctp_sock *opt)
317 struct sctp_sockaddr_entry *laddr;
321 list_for_each_entry_rcu(laddr, &bp->address_list, list) {
324 if (opt->pf->cmp_addr(&laddr->a, addr, opt)) {
334 int sctp_bind_addrs_check(struct sctp_sock *sp,
335 struct sctp_sock *sp2, int cnt2)
337 struct sctp_bind_addr *bp2 = &sp2->ep->base.bind_addr;
338 struct sctp_bind_addr *bp = &sp->ep->base.bind_addr;
339 struct sctp_sockaddr_entry *laddr, *laddr2;
344 list_for_each_entry_rcu(laddr, &bp->address_list, list) {
345 list_for_each_entry_rcu(laddr2, &bp2->address_list, list) {
346 if (sp->pf->af->cmp_addr(&laddr->a, &laddr2->a) &&
347 laddr->valid && laddr2->valid) {
359 return (cnt == cnt2) ? 0 : (exist ? -EEXIST : 1);
362 /* Does the address 'addr' conflict with any addresses in
365 int sctp_bind_addr_conflict(struct sctp_bind_addr *bp,
366 const union sctp_addr *addr,
367 struct sctp_sock *bp_sp,
368 struct sctp_sock *addr_sp)
370 struct sctp_sockaddr_entry *laddr;
372 struct sctp_sock *sp;
374 /* Pick the IPv6 socket as the basis of comparison
375 * since it's usually a superset of the IPv4.
376 * If there is no IPv6 socket, then default to bind_addr.
378 if (sctp_opt2sk(bp_sp)->sk_family == AF_INET6)
380 else if (sctp_opt2sk(addr_sp)->sk_family == AF_INET6)
386 list_for_each_entry_rcu(laddr, &bp->address_list, list) {
390 conflict = sp->pf->cmp_addr(&laddr->a, addr, sp);
399 /* Get the state of the entry in the bind_addr_list */
400 int sctp_bind_addr_state(const struct sctp_bind_addr *bp,
401 const union sctp_addr *addr)
403 struct sctp_sockaddr_entry *laddr;
406 af = sctp_get_af_specific(addr->sa.sa_family);
410 list_for_each_entry_rcu(laddr, &bp->address_list, list) {
413 if (af->cmp_addr(&laddr->a, addr))
420 /* Find the first address in the bind address list that is not present in
421 * the addrs packed array.
423 union sctp_addr *sctp_find_unmatch_addr(struct sctp_bind_addr *bp,
424 const union sctp_addr *addrs,
426 struct sctp_sock *opt)
428 struct sctp_sockaddr_entry *laddr;
429 union sctp_addr *addr;
434 /* This is only called sctp_send_asconf_del_ip() and we hold
435 * the socket lock in that code patch, so that address list
438 list_for_each_entry(laddr, &bp->address_list, list) {
439 addr_buf = (union sctp_addr *)addrs;
440 for (i = 0; i < addrcnt; i++) {
442 af = sctp_get_af_specific(addr->v4.sin_family);
446 if (opt->pf->cmp_addr(&laddr->a, addr, opt))
449 addr_buf += af->sockaddr_len;
458 /* Copy out addresses from the global local address list. */
459 static int sctp_copy_one_addr(struct net *net, struct sctp_bind_addr *dest,
460 union sctp_addr *addr, enum sctp_scope scope,
461 gfp_t gfp, int flags)
465 if (sctp_is_any(NULL, addr)) {
466 error = sctp_copy_local_addr_list(net, dest, scope, gfp, flags);
467 } else if (sctp_in_scope(net, addr, scope)) {
468 /* Now that the address is in scope, check to see if
469 * the address type is supported by local sock as
470 * well as the remote peer.
472 if ((((AF_INET == addr->sa.sa_family) &&
473 (flags & SCTP_ADDR4_ALLOWED) &&
474 (flags & SCTP_ADDR4_PEERSUPP))) ||
475 (((AF_INET6 == addr->sa.sa_family) &&
476 (flags & SCTP_ADDR6_ALLOWED) &&
477 (flags & SCTP_ADDR6_PEERSUPP))))
478 error = sctp_add_bind_addr(dest, addr, sizeof(*addr),
485 /* Is this a wildcard address? */
486 int sctp_is_any(struct sock *sk, const union sctp_addr *addr)
488 unsigned short fam = 0;
491 /* Try to get the right address family */
492 if (addr->sa.sa_family != AF_UNSPEC)
493 fam = addr->sa.sa_family;
497 af = sctp_get_af_specific(fam);
501 return af->is_any(addr);
504 /* Is 'addr' valid for 'scope'? */
505 int sctp_in_scope(struct net *net, const union sctp_addr *addr,
506 enum sctp_scope scope)
508 enum sctp_scope addr_scope = sctp_scope(addr);
510 /* The unusable SCTP addresses will not be considered with
511 * any defined scopes.
513 if (SCTP_SCOPE_UNUSABLE == addr_scope)
516 * For INIT and INIT-ACK address list, let L be the level of
517 * requested destination address, sender and receiver
518 * SHOULD include all of its addresses with level greater
519 * than or equal to L.
521 * Address scoping can be selectively controlled via sysctl
524 switch (net->sctp.scope_policy) {
525 case SCTP_SCOPE_POLICY_DISABLE:
527 case SCTP_SCOPE_POLICY_ENABLE:
528 if (addr_scope <= scope)
531 case SCTP_SCOPE_POLICY_PRIVATE:
532 if (addr_scope <= scope || SCTP_SCOPE_PRIVATE == addr_scope)
535 case SCTP_SCOPE_POLICY_LINK:
536 if (addr_scope <= scope || SCTP_SCOPE_LINK == addr_scope)
546 int sctp_is_ep_boundall(struct sock *sk)
548 struct sctp_bind_addr *bp;
549 struct sctp_sockaddr_entry *addr;
551 bp = &sctp_sk(sk)->ep->base.bind_addr;
552 if (sctp_list_single_entry(&bp->address_list)) {
553 addr = list_entry(bp->address_list.next,
554 struct sctp_sockaddr_entry, list);
555 if (sctp_is_any(sk, &addr->a))
561 /********************************************************************
562 * 3rd Level Abstractions
563 ********************************************************************/
565 /* What is the scope of 'addr'? */
566 enum sctp_scope sctp_scope(const union sctp_addr *addr)
570 af = sctp_get_af_specific(addr->sa.sa_family);
572 return SCTP_SCOPE_UNUSABLE;
574 return af->scope((union sctp_addr *)addr);