NAME
shutdown —
shut down part of a
full-duplex connection
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/socket.h>
int
shutdown(
int
s,
int how);
DESCRIPTION
The
shutdown() 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
connect(2),
socket(2)
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”).