NAME |SYNOPSIS |DESCRIPTION |RETURN VALUE |SEE ALSO |COLOPHON | |
SCTP_GETPADDRS(3) Linux Programmer's ManualSCTP_GETPADDRS(3)sctp_getpaddrs - Returns all peer addresses in an association.
#include <sys/types.h>#include <sys/socket.h>#include <netinet/sctp.h>int sctp_getpaddrs(intsd, sctp_assoc_tassoc_id,struct sockaddr **addrs);void sctp_freepaddrs(struct sockaddr *addrs);
sctp_getpaddrsreturns all peer addresses in an association. On return,addrs will point to a dynamically allocated packed array ofsockaddrstructures of the appropriate type for each address. The caller should usesctp_freepaddrsto free the memory. Note that the in/out parameteraddrs must not be NULL. Ifsd is an IPv4 socket, the addresses returned will be all IPv4 addresses. Ifsd 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_freepaddrsfrees all the resources allocated bysctp_getpaddrs.
On success,sctp_getpaddrsreturns 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_getpaddrsreturns -1 and the value of*addrs is undefined.
sctp(7)sctp_bindx(3),sctp_connectx(3),sctp_sendmsg(3),sctp_sendv(3),sctp_send(3),sctp_recvmsg(3),sctp_recvv(3),sctp_peeloff(3),sctp_getladdrs(3),sctp_opt_info(3),
This page is part of thelksctp-tools (Linux kernel SCTP tools) project. Information about the project can be found at [unknown -- if you know, please contact man-pages@man7.org] If you have a bug report for this manual page, send it to sctp@vger.kernel.org. This page was obtained from the project's upstream Git repository ⟨https://github.com/sctp/lksctp-tools.git⟩ on 2025-08-11. (At that time, the date of the most recent commit that was found in the repository was 2024-09-26.) If you discover any rendering problems in this HTML version of the page, or you believe there is a better or more up-to-date source for the page, or you have corrections or improvements to the information in this COLOPHON (which isnot part of the original manual page), send a mail to man-pages@man7.orgLinux 2.6 2005-10-25SCTP_GETPADDRS(3)Pages that refer to this page:sctp_bindx(3), sctp_connectx(3), sctp_getladdrs(3), sctp_opt_info(3), sctp_peeloff(3), sctp_recvmsg(3), sctp_recvv(3), sctp_send(3), sctp_sendmsg(3), sctp_sendv(3), sctp(7)
HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH. | ![]() |