sctp_peeloff (3)
Leading comments
(C) Copyright Sridhar Samudrala IBM Corp. 2004, 2005. Permission is granted to distribute possibly modified copies of this manual provided the header is included verbatim, and in case of nontrivial modification author and date of the modification is added to the header.
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);
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 assocations carrying high volume data traffic into their own separate socket descriptors.
RETURN VALUE
On success, the new socket descriptor representing the branched-off asociation is returned. On error, -1 is returned, and errno is set appropriately.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.