1 .\" (C) Copyright Sridhar Samudrala IBM Corp. 2004, 2005.
3 .\" Permission is granted to distribute possibly modified copies
4 .\" of this manual provided the header is included verbatim,
5 .\" and in case of nontrivial modification author and date
6 .\" of the modification is added to the header.
8 .TH SCTP_GETPADDRS 3 2005-10-25 "Linux 2.6" "Linux Programmer's Manual"
10 sctp_getpaddrs \- Returns all peer addresses in an association.
13 .B #include <sys/types.h>
14 .B #include <sys/socket.h>
15 .B #include <netinet/sctp.h>
17 .BI "int sctp_getpaddrs(int " sd ", sctp_assoc_t " assoc_id ,
18 .BI " struct sockaddr **" addrs );
20 .BI "void sctp_freepaddrs(struct sockaddr *" addrs );
24 returns all peer addresses in an association. On return,
26 will point to a dynamically allocated packed array of
28 structures of the appropriate type for each address. The caller should use
30 to free the memory. Note that the in/out parameter
36 is an IPv4 socket, the addresses returned will be all IPv4 addresses. If
38 is an IPv6 socket, the addresses returned can be a mix of IPv4 or IPv6
41 For one-to-many style sockets,
43 specifies the association to query. For one-to-one style sockets,
48 frees all the resources allocated by
53 returns the number of peer addresses in the association. If there is no
54 association on this socket, 0 is returned and the value of
56 is undefined. On error,
58 returns -1 and the value of
64 .BR sctp_connectx (3),
69 .BR sctp_getladdrs (3),
70 .BR sctp_opt_info (3),