SCTP_PEELOFF(3) Linux Programmer's Manual SCTP_PEELOFF(3)
sctp_peeloff - Branch off an association into a separate socket.
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 asso-
cations carrying high volume data traffic into their own separate
sctp_peeloff_flags is a variant of sctp_peeloff, in which flags de-
scribing the behavior of the newly peeled off socket can be specified.
Currently the supported flags are:
Specifies that the new socket should not block on io operations.
Specifies that the new socket should be closed when the owning
process calls exec.
On success, the new socket descriptor representing the branched-off
asociation is returned. On error, -1 is returned, and errno is set ap-
EBADF sd is not a valid descriptor.
EINVAL The assoc id passed is invalid or if the socket is a one-to-one
Argument is a descriptor for a file, not a socket.
sctp_peeloff_flags is a linux specific variant of sctp_peeloff. While
it will compile on other systems, its use will result in an error re-
turn. Portable code should use sctp_peeloff.
sctp(7) sctp_bindx(3), sctp_connectx(3), sctp_sendmsg(3),
sctp_sendv(3), sctp_send(3), sctp_recvmsg(3), sctp_recvv(3), sctp_get-
paddrs(3), sctp_getladdrs(3), sctp_opt_info(3),
Linux 2.6 2005-10-25 SCTP_PEELOFF(3)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2023
All Rights Reserved.