Sockets Library Functions sctp_peeloff(3SOCKET)
NAME
sctp_peeloff - branch off existing association from a one-
to-many SCTP socket to create a one-to-one STP socket
SYNOPSIS
cc [ flag... ] file... -lsocket -lnsl -lsctp [ library... ]
#include
#include
#include
int sctp_peeloff(int sock, sctp_assoc_t id);
DESCRIPTION
The sctp_peeloff() function branches off an existing associ-
ation from a one-to-many style SCTP socket into a separate
socket file descriptor. The resulting branched-off socket is
a one-to-one style SCTP socket and is confined to operations
allowed on a one-to-one style SCTP socket.
The sock argument is a one-to-many socket. The association
specified by the id argument is branched off sock.RETURN VALUES
Upon successful completion, the sctp_peeloff() function
returns the file descriptor that references the branched-off
socket. The function returns -1 if an error occurs.
ERRORS
The sctp_peeloff() function fails under the following condi-
tions.EOPTNOTSUPP The sock argument is not a one-to-many style
SCTP socket. EINVAL The id is 0 or greater than the maximum number of associations for sock. EMFILE Failure to create a new user file descriptor or file structure.ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:SunOS 5.11 Last change: 05 Mar 2004 1
Sockets Library Functions sctp_peeloff(3SOCKET)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | Safe |
|_____________________________|_____________________________|
SEE ALSO
in.h(3HEAD), libsctp(3LIB), socket(3SOCKET), sctp(7P)SunOS 5.11 Last change: 05 Mar 2004 2