|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON |
SCTP_SENDV(3) Linux SCTP_SENDV(3)
sctp_sendv - Send messages from a SCTP socket with an extensible way.
#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);
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).
On success, sctp_sendv returns the number of bytes sent or -1 if an
error occurred.
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),
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 man-pages@man7.org] If you have a bug
report for this manual page, send it to sctp@vger.kernel.org. This
page was obtained from the project's upstream Git repository
⟨https://github.com/sctp/lksctp-tools.git⟩ on 2020-08-13. (At that
time, the date of the most recent commit that was found in the
repository was 2019-05-02.) 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 man-pages@man7.org
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_optinfo(3) , sctp_peeloff(3) , sctp_recvmsg(3) , sctp_recvv(3) , sctp_send(3) , sctp_sendmsg(3) , sctp(7)