---
name: "sctp_getpaddrs"
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_getpaddrs"
---

# sctp\_getpaddrs(3)

Returns all peer addresses in an association.

## NAME

sctp\_getpaddrs - Returns all peer addresses in an association.

## SYNOPSIS

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

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

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

## DESCRIPTION

**sctp\_getpaddrs** returns all peer addresses in an association. On return, *addrs* will point to a dynamically allocated packed array of **sockaddr** structures of the appropriate type for each address. The caller should use  **sctp\_freepaddrs** 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.

**sctp\_freepaddrs** frees all the resources allocated by **sctp\_getpaddrs.**

## RETURN VALUE

On success, **sctp\_getpaddrs** returns the number of peer addresses in the association. If there is no association on this socket, 0 is returned and the value of  *\*addrs* is undefined. On error, **sctp\_getpaddrs** 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\_getladdrs**(3)](/sctp_getladdrs/3.md), [**sctp\_opt\_info**(3)](/sctp_opt_info/3.md),