---
name: "sctp_peeloff"
section: "2freebsd"
platform: "linux"
package: "freebsd-manpages"
version: "12.2-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sctp_peeloff/2freebsd"
---

# sctp\_peeloff(2freebsd)

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

## 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**() system call 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**() system call can return the following errors:

- \[ENOTCONN\]

  The *id* given to the call does not map to a valid association.

- \[E2BIG\]

  The size of the address list exceeds the amount of data provided.

- \[EBADF\]

  The argument *s* is not a valid descriptor.

- \[ENOTSOCK\]

  The argument *s* is not a socket.

## SEE ALSO

[sctp(4)](/sctp/4.md)