Previous section.

Networking Services (XNS) Issue 5
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>.

CHANGE HISTORY

First released in Issue 4.

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index