shutdown(2) - NetBSD Manual Pages

SHUTDOWN(2)               NetBSD Programmer's Manual               SHUTDOWN(2)


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.

NetBSD 1.5                       June 4, 1993                                1