Provided by: libsctp-dev_1.0.11+dfsg-1_i386 bug

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),