sctp_sendv(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON

SCTP_SENDV(3)                     Linux                    SCTP_SENDV(3)

NAME         top

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

SYNOPSIS         top

       #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         top

       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 message to be sent. They are struct
       sctp_sndinfo, struct sctp_prinfo, and struct sctp_authinfo. The
       following structure, sctp_sendv_spa, is defined 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
       information.

       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 association 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
       information 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         top

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

SEE ALSO         top

       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),

COLOPHON         top

       This page is part of the lksctp-tools (Linux kernel SCTP tools)
       project.  Information about the project can be found at [unknown
       -- if you know, please contact [email protected]] If you have a
       bug report for this manual page, send it to [email protected].
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/sctp/lksctp-tools.git⟩ on 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2024-02-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

Linux 4.16                     2018-04-29                  SCTP_SENDV(3)

Pages that refer to this page: sctp_bindx(3)sctp_connectx(3)sctp_getladdrs(3)sctp_getpaddrs(3)sctp_opt_info(3)sctp_peeloff(3)sctp_recvmsg(3)sctp_recvv(3)sctp_send(3)sctp_sendmsg(3)sctp(7)