SCTP_PEELOFF
Section: Linux Programmer's Manual (3)
Updated: 2005-10-25
Index
Return to Main Contents
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.
SEE ALSO
sctp(7)
sctp_bindx(3),
sctp_connectx(3),
sctp_sendmsg(3),
sctp_send(3),
sctp_recvmsg(3),
sctp_getpaddrs(3),
sctp_getladdrs(3),
sctp_opt_info(3),