|SCTP_PEELOFF(3)||Linux Programmer's Manual||SCTP_PEELOFF(3)|
sctp_peeloff - Branch off an association into a separate socket.
#include <sys/types.h> #include <sys/socket.h> #include <netinet/sctp.h> int sctp_peeloff(int sd, sctp_assoc_t assoc_id); int sctp_peeloff_flags(int sd, sctp_assoc_t assoc_id, unsigned flags);
sctp_peeloff branches off an existing association assoc_id on a one-to-many style socket sd into a separate socket. The new socket is a one-to-one style socket.
This is particularly desirable when, for instance, the application wishes to have a number of sporadic message senders/receivers remain under the original one-to-many style socket, but branch off those assocations carrying high volume data traffic into their own separate socket descriptors.
sctp_peeloff_flags is a variant of sctp_peeloff, in which flags describing the behavior of the newly peeled off socket can be specified. Currently the supported flags are:
On success, the new socket descriptor representing the branched-off asociation is returned. On error, -1 is returned, and errno is set appropriately.