NAME    [Toc]    [Back]

     shutdown - shut down part of a full-duplex connection

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/socket.h>

     int
     shutdown(int s, int how);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     A 0 is returned if the call succeeds, -1 if it fails.

ERRORS    [Toc]    [Back]

     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    [Toc]    [Back]

     connect(2), socket(2)

HISTORY    [Toc]    [Back]

     The shutdown() function call appeared in 4.2BSD.

BSD                              June 4, 1993                              BSD