shutdown(2)

shutdown2

Shut down part of a full-duplex connection

Usage

#include <sys/socket.h>

int

shutdown(int socket, int how);

Overview

The shutdown() call causes all or part of a full-duplex connection on the socket associated with socket to be shut down. If how is SHUT_RD, further receives will be disallowed. If how is SHUT_WR, further sends will be disallowed. If how is SHUT_RDWR, further sends and receives will be disallowed.

Return values

The shutdown() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

Errors

The call succeeds unless:

[EBADF]

Socket is not a valid descriptor.

[EINVAL]

The how argument is invalid.

[ENOTCONN]

The specified socket is not connected.

[ENOTSOCK]

Socket is a file, not a socket.

Releases

155 releases since Mac OS X 10.0; the text changed 3 times.

  1. 10.0–10.3.9
  2. 10.4–10.4.11
  3. 10.5–10.10.5
  4. 10.11–26.5

History

The shutdown() function call appeared in 4.2BSD.

From xnu 12377.121.6 in macOS 26.5. Parsed by carta from the page's mdoc source.