NAME
shutdown —
shut down part of a full-duplex
connection
LIBRARY
library “libc”
SYNOPSIS
#include
<sys/socket.h>
int
shutdown(int
s, int how);
DESCRIPTION
Theshutdown()
call causes all or part of a full-duplex connection on the socket associated
with s to be shut down. The how
argument specifies which part of the connection will be shut down. Permissible
values are:
- SHUT_RD
- further receives will be disallowed.
- SHUT_WR
- further sends will be disallowed.
- SHUT_RDWR
- further sends and receives will be disallowed.
RETURN VALUES
A 0 is returned if the call succeeds, -1 if it fails.
ERRORS
The call succeeds unless:
- [
EBADF] - s is not a valid descriptor.
- [
EINVAL] - The how argument is invalid.
- [
ENOTCONN] - The specified socket is not connected.
- [
ENOTSOCK] - s is a file, not a socket.
SEE ALSO
HISTORY
The shutdown() function call appeared in
4.2BSD. The how arguments used
to be simply 0, 1, and 2, but now have named values as specified by
X/Open Portability Guide Issue 4
(“XPG4”).