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

# [NAME](#NAME)

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

# [SYNOPSIS](#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](#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](#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](#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\_getladdrs**(3)](/man/os/libsctp/sctp_getladdrs.3), [**sctp\_opt\_info**(3)](/man/os/libsctp/sctp_opt_info.3),

2005-10-25 Linux 2.6

---

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