Updated: 2025/Nov/16

Please read Privacy Policy. It's for your privacy.

SCTP_PEELOFF(3)            Library Functions Manual            SCTP_PEELOFF(3)

NAME
     sctp_peeloff - detach an association from a one-to-many socket to its own
     fd

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/types.h>
     #include <sys/socket.h>
     #include <netinet/sctp.h>

     int
     sctp_peeloff(int s, sctp_assoc_t id);

DESCRIPTION
     The sctp_peeloff() function attempts detach the association specified by
     id into its own separate socket.

RETURN VALUES
     The call returns -1 on failure and the new socket descriptor upon
     success.

ERRORS
     The sctp_peeloff() function can return the following errors:

     [E2BIG]            The size of the address list exceeds the amount of
                        data provided.

     [EBADF]            The argument s is not a valid descriptor.

     [ENOTCONN]         The id given to the call does not map to a valid
                        association.

     [ENOTSOCK]         The argument s is not a socket.

SEE ALSO
     sctp(4)

     Sockets API Extensions for the Stream Control Transmission Protocol
     (SCTP), RFC, 6458, December 2011.

HISTORY
     This function first appeared in NetBSD 9.0.

NetBSD 11.99                    August 1, 2018                    NetBSD 11.99