search..
No manual entry for -- in section 3
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_get-
       paddrs(3), sctp_opt_info(3),

Linux 2.6			   2005-10-25		      SCTP_GETLADDRS(3)