sctp_peeloff - Branch off an association into a separate socket.
int sctp_peeloff(int sd, sctp_assoc_t assoc_id);
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
On success, the new socket descriptor representing the branched-off asociation
is returned. On error, -1 is returned, and errno is set appropriately.
- sd is not a valid descriptor.
- The assoc id passed is invalid or if the socket is a one-to-one style
- Argument is a descriptor for a file, not a socket.