1SCTP_PEELOFF(3)            Linux Programmer's Manual           SCTP_PEELOFF(3)
2
3
4

NAME

6       sctp_peeloff - Branch off an association into a separate socket.
7

SYNOPSIS

9       #include <sys/types.h>
10       #include <sys/socket.h>
11       #include <netinet/sctp.h>
12
13       int sctp_peeloff(int sd, sctp_assoc_t assoc_id);
14

DESCRIPTION

16       sctp_peeloff branches off an existing association assoc_id on a one-to-
17       many style socket sd into a separate socket. The new socket is  a  one-
18       to-one style socket.
19
20       This  is  particularly  desirable  when,  for instance, the application
21       wishes to have a number of sporadic  message  senders/receivers  remain
22       under the original one-to-many style socket, but branch off those asso‐
23       cations carrying high volume  data  traffic  into  their  own  separate
24       socket descriptors.
25

RETURN VALUE

27       On  success,  the  new  socket descriptor representing the branched-off
28       asociation is returned.  On error, -1 is returned,  and  errno  is  set
29       appropriately.
30

ERRORS

32       EBADF  sd is not a valid descriptor.
33
34       EINVAL The  assoc id passed is invalid or if the socket is a one-to-one
35              style socket.
36
37       ENOTSOCK
38              Argument is a descriptor for a file, not a socket.
39

SEE ALSO

41       sctp(7) sctp_bindx(3), sctp_connectx(3), sctp_sendmsg(3), sctp_send(3),
42       sctp_recvmsg(3),          sctp_getpaddrs(3),         sctp_getladdrs(3),
43       sctp_opt_info(3),
44
45
46
47Linux 2.6                         2005-10-25                   SCTP_PEELOFF(3)
Impressum