The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group

NAME

shutdown - shut down socket send and receive operations

SYNOPSIS



#include <sys/socket.h>

int shutdown(int socket, int how);

DESCRIPTION

socket
Specifies the file descriptor of the socket.
how
Specifies the type of shutdown. The values are as follows:
SHUT_RD
Disables further receive operations.
SHUT_WR
Disables further send operations.
SHUT_RDWR
Disables further send and receive operations.

The shutdown() function disables subsequent send and/or receive operations on a socket, depending on the value of the how argument.

RETURN VALUE

Upon successful completion, shutdown() returns 0. Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS

The shutdown() function will fail if:
[EBADF]
The socket argument is not a valid file descriptor.
[EINVAL]
The how argument is invalid.
[ENOTCONN]
The socket is not connected.
[ENOTSOCK]
The socket argument does not refer to a socket.

The shutdown() function may fail if:

[ENOBUFS]
Insufficient resources were available in the system to perform the operation.
[ENOSR]
There were insufficient STREAMS resources available for the operation to complete.

SEE ALSO

getsockopt(), read(), recv(), recvfrom(), recvmsg(), select(), send(), sendto(), setsockopt(), socket(), write(), <sys/socket.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]