sctp_peeloff(2)

sctp_peeloff2

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

Usage

#include <sys/types.h>

#include <sys/socket.h>

#include <netinet/sctp.h>

int

sctp_peeloff(int s, sctp_assoc_t id);

Library

Standard C Library (libc, -lc)

Overview

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.

Releases

44 releases since FreeBSD 7.0-RELEASE; the text changed 31 times.

  1. 7.0
  2. 7.1
  3. 7.2
  4. 7.3
  5. 7.4
  6. 8.0
  7. 8.1
  8. 8.2
  9. 8.3
  10. 8.4
  11. 9.0
  12. 9.1
  13. 9.2
  14. 9.3
  15. 10.0
  16. 10.1
  17. 10.2
  18. 10.3
  19. 10.4
  20. 11.0
  21. 11.1
  22. 11.2
  23. 11.3
  24. 11.4
  25. 12.0
  26. 12.1
  27. 12.2
  28. 12.3
  29. 12.4
  30. 13.0–13.2
  31. 13.3–14.5
  32. 15.0–16.0

Standards

The sctp_peeloff() function conforms to RFC 6458.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.