sctp_recvmsg(3socket) [opensolaris man page]

sctp_recvmsg(3SOCKET)					     Sockets Library Functions					     sctp_recvmsg(3SOCKET)

NAME

       sctp_recvmsg - receive message from an SCTP socket

SYNOPSIS

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

       ssize_t sctp_recvmsg(int s, void *msg, size_t len, struct sockaddr *from,
	    socklen_t *fromlen, struct sctp_sndrcvinfo *sinfo, int *msg_flags);

DESCRIPTION

       The sctp_recvmsg() function receives a message from the SCTP endpoint s.

       In addition to specifying the message buffer msg and the length len of the buffer, the following parameters can be set:

       from	    Pointer to an address, filled in with the sender's address

       fromlen	    Size of the buffer associated with the from parameter

       sinfo	    Pointer to an sctp_sndrcvinfo structure, filled in upon the receipt of the message

       msg_flags    Message flags such as MSG_CTRUNC, MSG_NOTIFICATION, MSG_EOR

       The  sinfo  parameter  is  filled  in  only  when the caller has enabled sctp_data_io_events by calling setsockopt() with the socket option
       SCTP_EVENTS.

RETURN VALUES

       Upon successful completion, the sctp_recvmsg() function returns the number of bytes received. The function returns -1 if an error occurs.

ERRORS

       The sctp_recvmsg() function fails under the following conditions.

       EBADF	     The s argument is an invalid file descriptor.

       ENOTSOCK      The s argument is not a socket.

       EOPNOTSUPP    MSG_OOB is set as a flag.

       ENOTCONN      There is no established association.

ATTRIBUTES

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

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

SEE ALSO

       accept(3SOCKET), bind(3SOCKET), connect(3SOCKET), in.h(3HEAD), libsctp(3LIB),  listen(3SOCKET),	recvmsg(3SOCKET),  sctp_opt_info(3SOCKET),
       setsockopt(3SOCKET), socket(3SOCKET), socket.h(3HEAD), sctp(7P)

SunOS 5.11							    14 Jul 2004 					     sctp_recvmsg(3SOCKET)

Check Out this Related Man Page

sctp_peeloff(3SOCKET)					     Sockets Library Functions					     sctp_peeloff(3SOCKET)

NAME

       sctp_peeloff - branch off existing association from a one-to-many SCTP socket to create a one-to-one STP socket

SYNOPSIS

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

       int sctp_peeloff(int sock, sctp_assoc_t id);

DESCRIPTION

       The  sctp_peeloff() function branches off an existing association from a one-to-many style SCTP socket into a separate socket file descrip-
       tor. The resulting branched-off socket is a one-to-one style SCTP socket and is confined to operations allowed on a one-to-one  style  SCTP
       socket.

       The sock argument is a one-to-many socket. The association specified by the id argument is branched off sock.

RETURN VALUES

       Upon  successful  completion, the sctp_peeloff() function returns the file descriptor that references the branched-off socket. The function
       returns -1 if an error occurs.

ERRORS

       The sctp_peeloff() function fails under the following conditions.

       EOPTNOTSUPP     The sock argument is not a one-to-many style SCTP socket.

       EINVAL	       The id is 0 or greater than the maximum number of associations for sock.

       EMFILE	       Failure to create a new user file descriptor or file structure.

ATTRIBUTES

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

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

SEE ALSO

       in.h(3HEAD), libsctp(3LIB), socket(3SOCKET), sctp(7P)

SunOS 5.10							    05 Mar 2004 					     sctp_peeloff(3SOCKET)

Linux and UNIX Man Pages

sctp_recvmsg(3socket) [opensolaris man page]

Check Out this Related Man Page