sctp_getladdrs

SCTP_GETLADDRS(3)          Linux Programmer's Manual         SCTP_GETLADDRS(3)

NAME
       sctp_getladdrs - Returns all locally bound addresses on a socket.

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

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

       void sctp_freeladdrs(struct sockaddr *addrs);

DESCRIPTION
       sctp_getladdrs  returns all locally bound addresses on a socket. On re-
       turn, addrs will point to a dynamically allocated packed array of sock-
       addr  structures  of  the  appropriate type for each local address. The
       caller should use sctp_freeladdrs 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 ad-
       dresses. 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.

       If the id field is set to 0, then the locally bound addresses  are  re-
       turned without regard to any particular association.

       sctp_freeladdrs frees all the resources allocated by sctp_getladdrs

RETURN VALUE
       On  success, sctp_getladdrs returns the number of local addresses bound
       to the socket. If the socket is unbound, 0 is returned and the value of
       *addrs  is undefined. On error, sctp_getladdrs returns -1 and the value
       of *addrs is undefined.

SEE ALSO
       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_getpaddrs(3), sctp_opt_info(3),

Linux 2.6                         2005-10-25                 SCTP_GETLADDRS(3)