SCTP_PEELOFF(3) Linux Programmer's Manual SCTP_PEELOFF(3)
NAME
sctp_peeloff - Branch off an association into a separate socket.
SYNOPSIS
#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);
DESCRIPTION
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
socket descriptors.
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:
SOCK_NONBLOCK
Specifies that the new socket should not block on io operations.
SOCK_CLOEXEC
Specifies that the new socket should be closed when the owning
process calls exec.
RETURN VALUE
On success, the new socket descriptor representing the branched-off
asociation is returned. On error, -1 is returned, and errno is set ap-
propriately.
ERRORS
EBADF sd is not a valid descriptor.
EINVAL The assoc id passed is invalid or if the socket is a one-to-one
style socket.
ENOTSOCK
Argument is a descriptor for a file, not a socket.
NOTES
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.
SEE ALSO
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)
Generated by dwww version 1.14 on Fri Jan 24 14:07:12 CET 2025.