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)
Generated by dwww version 1.14 on Fri Jan 24 09:36:29 CET 2025.