SCTP\_GETLADDRS(3) Linux Programmer's Manual SCTP\_GETLADDRS(3)

# [NAME](#NAME)

sctp\_getladdrs - Returns all locally bound addresses on a socket.

# [SYNOPSIS](#SYNOPSIS)

```
#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/sctp.h>

int sctp_getladdrs(int sd, sctp_assoc_t assoc_id,
                   struct sockaddr **addrs);

void sctp_freeladdrs(struct sockaddr *addrs);
```

# [DESCRIPTION](#DESCRIPTION)

**sctp\_getladdrs** returns all locally bound addresses on a socket. On return, *addrs* will point to a dynamically allocated packed array of **sockaddr** structures of the appropriate type for each local address. The caller should use **sctp\_freeladdrs** to free the memory. Note that the in/out parameter *addrs* must not be NULL.

If *sd* is an IPv4 socket, the addresses returned will be all IPv4 addresses. If *sd* is an IPv6 socket, the addresses returned can be a mix of IPv4 or IPv6 addresses.

For one-to-many style sockets, *id* specifies the association to query. For one-to-one style sockets, *id* is ignored.

If the *id* field is set to 0, then the locally bound addresses are returned without regard to any particular association.

**sctp\_freeladdrs** frees all the resources allocated by **sctp\_getladdrs**

# [RETURN VALUE](#RETURN_VALUE)

On success, **sctp\_getladdrs** returns the number of local addresses bound to the socket. If the socket is unbound, 0 is returned and the value of *\*addrs* is undefined. On error, **sctp\_getladdrs** returns -1 and the value of *\*addrs* is undefined.

# [SEE ALSO](#SEE_ALSO)

[**sctp**(7)](/man/os/libsctp/sctp.7) [**sctp\_bindx**(3)](/man/os/libsctp/sctp_bindx.3), [**sctp\_connectx**(3)](/man/os/libsctp/sctp_connectx.3), [**sctp\_sendmsg**(3)](/man/os/libsctp/sctp_sendmsg.3), [**sctp\_sendv**(3)](/man/os/libsctp/sctp_sendv.3), [**sctp\_send**(3)](/man/os/libsctp/sctp_send.3), [**sctp\_recvmsg**(3)](/man/os/libsctp/sctp_recvmsg.3), [**sctp\_recvv**(3)](/man/os/libsctp/sctp_recvv.3), [**sctp\_peeloff**(3)](/man/os/libsctp/sctp_peeloff.3), [**sctp\_getpaddrs**(3)](/man/os/libsctp/sctp_getpaddrs.3), [**sctp\_opt\_info**(3)](/man/os/libsctp/sctp_opt_info.3),

2005-10-25 Linux 2.6

---

Document: sctp_getladdrs(3) from libsctp 1.0.21-r4 (Chainguard OS)
Source: https://github.com/sctp/lksctp-tools