shutdown(2) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
SHUTDOWN(2)               NetBSD System Calls 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.  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'').

NetBSD 5.1                      August 18, 2002                     NetBSD 5.1