shutdown2
Disable sends and/or receives on a socket
Usage
#include <sys/types.h>
#include <sys/socket.h>
int
shutdown(int s, int how);
Library
Standard C Library (libc, -lc)
Overview
The shutdown() system call disables sends or receives on a socket. The how argument specifies the type of shutdown. Possible values are:
- SHUT_RD
-
Further receives will be disallowed.
- SHUT_WR
-
Further sends will be disallowed. This may cause actions specific to the protocol family of the socket s to happen; see IMPLEMENTATION NOTES.
- SHUT_RDWR
-
Further sends and receives will be disallowed. Implies SHUT_WR.
If the file descriptor s is associated with a SOCK_STREAM socket, all or part of the full-duplex connection will be shut down.
Implementation notes
The following protocol specific actions apply to the use of SHUT_WR (and potentially also SHUT_RDWR), based on the properties of the socket associated with the file descriptor s.
| Domain | Type | Protocol | Action |
| PF_INET | SOCK_DGRAM | IPPROTO_SCTP | |
| PF_INET | SOCK_DGRAM | IPPROTO_UDP | |
| PF_INET | SOCK_STREAM | IPPROTO_SCTP | |
| PF_INET | SOCK_STREAM | IPPROTO_TCP | |
| PF_INET6 | SOCK_DGRAM | IPPROTO_SCTP | |
| PF_INET6 | SOCK_DGRAM | IPPROTO_UDP | |
| PF_INET6 | SOCK_STREAM | IPPROTO_SCTP | |
| PF_INET6 | SOCK_STREAM | IPPROTO_TCP |
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 shutdown() system call fails if:
- [EBADF]
-
The s argument is not a valid file descriptor.
- [EINVAL]
-
The how argument is invalid.
- [ENOTCONN]
-
The s argument specifies a socket which is not connected.
- [ENOTSOCK]
-
The s argument does not refer to a socket.
Releases
87 releases since FreeBSD 2.0.5-RELEASE; the text changed 46 times.