sctp_getpaddrssctp_getladdrs
- return a list of addresses to the caller
LIBRARY
Lb libc
SYNOPSIS
#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/sctp.h> int
sctp_getpaddrs (int s sctp_assoc_t asocid struct sockaddr **addrs); int
sctp_getladdrs (int s sctp_assoc_t asocid struct sockaddr **addrs);
DESCRIPTION
The
sctp_getpaddrs ();
function is used to get the list of the peers addresses.
The
sctp_getladdrs ();
function is used to get the list of the local addresses.
The association of interest is identified by the
Fa asocid
argument.
The addresses are returned in a newly allocated
array of socket addresses returned in the argument
Fa addrs
upon success.
After the caller is through the function
sctp_freepaddrs ();
or
sctp_freeladdrs ();
should be used to release the memory allocated by these
calls.
RETURN VALUES
The call returns -1 upon failure and a count of
the number of addresses returned in
Fa addrs
upon success.
ERRORS
The functions can return the following errors.
Bq Er EINVAL
An address listed has an invalid family or no
addresses were provided.
Bq Er ENOMEM
The call cannot allocate memory to hold the
socket addresses.
