NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | NOTES | SEE ALSO | COLOPHON

The Linux Programming Interface

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

NAME         top

       shutdown - shut down part of a full-duplex connection

SYNOPSIS         top

       #include <sys/socket.h>

       int shutdown(int sockfd, int how);

DESCRIPTION         top

       The shutdown() call causes all or part of a full-duplex connection on the
       socket associated with sockfd to be shut down.  If how is SHUT_RD, further
       receptions will be disallowed.  If how is SHUT_WR, further transmissions will
       be disallowed.  If how is SHUT_RDWR, further receptions and transmissions will
       be disallowed.

RETURN VALUE         top

       On success, zero is returned.  On error, -1 is returned, and errno is set
       appropriately.

ERRORS         top

       EBADF  sockfd is not a valid descriptor.

       ENOTCONN
              The specified socket is not connected.

       ENOTSOCK
              sockfd is a file, not a socket.

CONFORMING TO         top

       POSIX.1-2001, 4.4BSD (the shutdown() function call first appeared in 4.2BSD).

NOTES         top

       The constants SHUT_RD, SHUT_WR, SHUT_RDWR have the value 0, 1, 2,
       respectively, and are defined in <sys/socket.h> since glibc-2.1.91.

SEE ALSO         top

       connect(2), socket(2), socket(7)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

Linux                                 2008-12-03                          SHUTDOWN(2)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface