sctp_sendv

SCTP_SENDV(3)                        Linux                       SCTP_SENDV(3)

NAME
       sctp_sendv - Send messages from a SCTP socket with an extensible way.

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

       int sctp_sendv(int sd, const struct iovec * iov, int iovcnt,
                      struct sockaddr *addrs, int addrcnt, void * info,
                      socklen_t infolen, unsigned int infotype, int flags);

DESCRIPTION
       sctp_sendv provides an extensible way for an application to communicate
       different send attributes to the SCTP stack  when  sending  a  message.
       There are three types of attributes that can be used to describe a mes-
       sage to be sent. They are struct sctp_sndinfo, struct sctp_prinfo,  and
       struct  sctp_authinfo.  The following structure, sctp_sendv_spa, is de-
       fined to be used when more than one of the above attributes are  needed
       to describe a message to be sent.

          struct sctp_sendv_spa {
            uint32_t sendv_flags;
            struct sctp_sndinfo sendv_sndinfo;
            struct sctp_prinfo sendv_prinfo;
            struct sctp_authinfo sendv_authinfo;
          };

       The  sendv_flags  field  holds a bitwise OR of SCTP_SEND_SNDINFO_VALID,
       SCTP_SEND_PRINFO_VALID, and SCTP_SEND_AUTHINFO_VALID indicating if  the
       sendv_sndinfo/sendv_prinfo/sendv_authinfo fields contain valid informa-
       tion.

       sd is the socket descriptor.  iov is the gather buffer,   the  data  in
       the  buffer  is treated as a single user message.  iovcnt is the number
       of elements in iov.  addrs is an array of addresses to be used  to  set
       up  an  association or a single address to be used to send the message,
       and  NULL is passed in if the caller neither wants to set up an associ-
       ation  nor wants to send the message to a specific address.  addrcnt is
       the number of addresses in the addrs array.  info is a pointer  to  the
       buffer containing the attribute associated with the message to be sent,
       and the type is indicated by the info_type parameter.  infolen  is  the
       length of info, in bytes.  infotype identifies the type of the informa-
       tion provided in info ,and the current defined values are as follows:

       SCTP_SENDV_NOINFO
              No information is  provided.   The  parameter  info  is  a  NULL
              pointer, and infolen is 0.

       SCTP_SENDV_SNDINFO
              The parameter info is pointing to a struct sctp_sndinfo.

       SCTP_SENDV_PRINFO
              The parameter info is pointing to a struct sctp_prinfo.

       SCTP_SENDV_AUTHINFO
              The parameter info is pointing to a struct sctp_authinfo.

       SCTP_SENDV_SPA
              The parameter info is pointing to a struct sctp_sendv_spa.

       flags  The  same  flags  as  used  by  the  sendmsg() call flags (e.g.,
       MSG_DONTROUTE).

RETURN VALUE
       On success, sctp_sendv returns the number of bytes sent or -1 if an er-
       ror occurred.

SEE ALSO
       sctp(7) sctp_bindx(3), sctp_connectx(3), sctp_send(3), sctp_recvmsg(3),
       sctp_recvv(3), sctp_peeloff(3),  sctp_getpaddrs(3),  sctp_getladdrs(3),
       sctp_opt_info(3),

Linux 4.16                        2018-04-29                     SCTP_SENDV(3)