NAME

       sctp_recvmsg - Receive a message from a SCTP socket.

SYNOPSIS

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

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

DESCRIPTION

       sctp_recvmsg  is  a  wrapper  library  function that can be used to receive a message from a socket while
       using the advanced features of SCTP.  sd is the socket descriptor on which the message pointed to by  msg
       of length len is received.

       If  from  is  not  NULL, the source address of the message is filled in. The argument fromlen is a value-
       result parameter. initialized to the size of the buffer associated with from , and modified on return  to
       indicate the actual size of the address stored.

       sinfo is a pointer to a sctp_sndrcvinfo structure to be filled upon receipt of the message.  msg_flags is
       a pointer to a integer that is filled with any message flags like MSG_NOTIFICATION or MSG_EOR.  The value
       of  msg_flags  pointer should be initialized to 0 to avoid unexpected behavior; msg_flags is also used as
       an input flags argument to recvmsg function.

RETURN VALUE

       On success, sctp_recvmsg returns the number of bytes received or -1 if an error occurred.

SEE ALSO

       sctp(7) sctp_bindx(3), sctp_connectx(3), sctp_sendmsg(3), sctp_sendv(3),  sctp_send(3),  sctp_peeloff(3),
       sctp_getpaddrs(3), sctp_getladdrs(3), sctp_opt_info(3)