Sockets Library Functions                   sctprecvmsg(3SOCKET)



NAME
     sctprecvmsg - receive message from an SCTP socket

SYNOPSIS
     cc [ flag... ] file... -lsocket  -lnsl   -lsctp  [ library... ]
     #include 
     #include 
     #include 

     ssizet sctprecvmsg(int s, void *msg, sizet len, struct sockaddr *from,
          socklent *fromlen, struct sctpsndrcvinfo *sinfo, int *msgflags);


DESCRIPTION
     The sctprecvmsg() 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 sctpsndrcvinfo structure, filled
                  in upon the receipt of the message


     msgflags    Message    flags    such     as     MSGCTRUNC,
                  MSGNOTIFICATION, MSGEOR



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

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

ERORS
     The sctprecvmsg() function fails under the following condi-
     tions.




SunOS 5.11          Last change: 14 Jul 2004                    1






Sockets Library Functions                   sctprecvmsg(3SOCKET)



     EBADF         The s argument is an invalid file descriptor.


     ENOTSOCK      The s argument is not a socket.


     EOPNOTSUP    MSGOB is set as a flag.


     ENOTCON      There is no established association.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     Safe                        
    


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






















SunOS 5.11          Last change: 14 Jul 2004                    2