sctp_freeladdrs(3socket) [sunos man page]

sctp_getladdrs(3SOCKET) 				     Sockets Library Functions					   sctp_getladdrs(3SOCKET)

NAME

       sctp_getladdrs, sctp_freeladdrs - returns all locally bound addresses on an SCTP socket

SYNOPSIS

       cc [ flag... ] file... -lsocket -lnsl -lsctp [ library... ]
       #include <sys/types.h>
       #include <sys/socket.h>
       #include <netinet/sctp.h>

       int sctp_getladdrs(int sock, sctp_assoc_t id, void **addrs, void sctp_freeladdrs(void *addrs);

DESCRIPTION

       The  sctp_getladdrs()  function	queries addresses to which an SCTP socket is bound. The sctp_freeladdrs() function releases resources that
       are allocated to hold the addresses.

       The sctp_getladdrs() function returns all the locally bound addresses on the SCTP socket sock. On completion addrs points to a  dynamically
       allocated  array  of  sockaddr_in  structures for an Internet Protocol (IPv4) socket or an array of sockaddr_in6 structures for an Internet
       Protocol Version 6 (IPv6) socket. The addrs parameter must not be NULL. For an IPv4 SCTP socket, the addresses returned in the  sockaddr_in
       structures  are	IPv4 addresses. For an IPv6 SCTP socket, the addresses in the sockaddr_in6 structures can be IPv6 addresses or IPv4-mapped
       IPv6 addresses.

       If sock is a one-to-many style SCTP socket, id specifies the association of interest. A value of 0 to id  returns  locally-bound  addresses
       regardless of a particular association. If sock is a one-to-one style SCTP socket, id is ignored.

       The  sctp_freeladdrs()  function frees the resources allocated by sctp_getladdrs(). The addrs parameter is the array of addresses allocated
       by sctp_getladdrs().

RETURN VALUES

       Upon successful completion, the sctp_getladdrs() function returns the number of addresses in  the  addrs  array.  Otherwise,  the  function
       returns -1 and sets errno to indicate the error.

ERRORS

       The sctp_getladdrs() call fails under the following conditions.

       EBADF	       The sock argument is an invalid file descriptor.

       ENOTSOCK        The sock argument is not a socket.

       EINVAL	       The addrs argument is NULL.

       EINVAL	       The id argument is an invalid socket.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       bind(3SOCKET), in.h(3HEAD), libsctp(3LIB), sctp_freepaddrs(3SOCKET), sctp_getpaddrs(3SOCKET), socket(3SOCKET), inet(7P), inet6(7P), ip(7P),
       ip6(7P), sctp(7P)

SunOS 5.10							    05 Mar 2004 					   sctp_getladdrs(3SOCKET)

sctp_getpaddrs(3SOCKET) 				     Sockets Library Functions					   sctp_getpaddrs(3SOCKET)

NAME

       sctp_getpaddrs, sctp_freepaddrs - returns all peer addresses on an SCTP association

SYNOPSIS

       cc [ flag... ] file... -lsocket	-lnsl	-lsctp	[ library... ]
       #include <sys/types.h>
       #include <sys/socket.h>
       #include <netinet/sctp.h>

       int sctp_getpaddrs(int sock, sctp_assoc_t id, void **addrs);

       void sctp_freepaddrs(void *addrs);

DESCRIPTION

       The  sctp_getpaddrs()  queries  the peer addresses in an SCTP association. The sctp_freepaddrs() function releases resources that are allo-
       cated to hold the addresses.

       The sctp_getpaddrs() function returns all the peer addresses in the SCTP association identified by sock. On completion addrs  points  to  a
       dynamically  allocated array of sockaddr_in structures for an Internet Protocol (IPv4) socket or an array of sockaddr_in6 structures for an
       Internet Protocol Version 6 (IPv6) socket. The addrs parameter must not be NULL. For an IPv4 SCTP socket, the  addresses  returned  in  the
       sockaddr_in  structures	are IPv4 addresses. For an IPv6 SCTP socket, the addresses in the sockaddr_in6 structures can be IPv6 addresses or
       IPv4-mapped IPv6 addresses.

       If sock is a one-to-many style SCTP socket, id specifies the association of interest. If sock is a one-to-one  style  SCTP  socket,  id	is
       ignored.

       The  sctp_freepaddrs()  function frees the resources allocated by sctp_getpaddrs(). The addrs parameter is the array of addresses allocated
       by sctp_getpaddrs().

RETURN VALUES

       Upon successful completion, the sctp_getpaddrs() function returns the number of addresses in  the  addrs  array.  Otherwise,  the  function
       returns -1 and sets errno to indicate the error.

ERRORS

       The sctp_getpaddrs() succeeds unless one of the following conditions exist.

       EBADF	   The sock argument is an invalid file descriptor.

       ENOTSOCK    The sock argument is not a socket.

       EINVAL	   The addrs argument is NULL.

       EINVAL	   The id argument is an invalid association identifier for a one-to-many style STP socket.

       ENOTCONN    The specified socket is not connected.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       bind(3SOCKET),  in.h(3HEAD),  libsctp(3LIB),  sctp_freeladdrs(3SOCKET),	sctp_getladdrs(3SOCKET), socket(3SOCKET), attributes(5), inet(7P),
       inet6(7P), ip(7P), ip6(7P), sctp(7P)

SunOS 5.11							    23 Jan 2008 					   sctp_getpaddrs(3SOCKET)