---
name: "sctp_getladdrs"
section: "3"
platform: "linux"
package: "lksctp-tools"
version: "1.0.21-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/sctp_getladdrs"
---

# sctp\_getladdrs(3)

Returns all locally bound addresses on a socket.

## NAME

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

## 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

**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

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

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