shutdown

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

NAME
       shutdown - shut down part of a full-duplex connection

SYNOPSIS
       #include <sys/socket.h>

       int shutdown(int sockfd, int how);

DESCRIPTION
       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  recep-
       tions and transmissions will be disallowed.

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

ERRORS
       EBADF  sockfd is not a valid file descriptor.

       EINVAL An invalid value was specified in how (but see BUGS).

       ENOTCONN
              The specified socket is not connected.

       ENOTSOCK
              The file descriptor sockfd does not refer to a socket.

CONFORMING TO
       POSIX.1-2001,  POSIX.1-2008,  4.4BSD  (shutdown()  first  appeared   in
       4.2BSD).

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

BUGS
       Checks for the validity of how are done in  domain-specific  code,  and
       before Linux 3.7 not all domains performed these checks.  Most notably,
       UNIX domain sockets simply ignored invalid values.   This  problem  was
       fixed for UNIX domain sockets in Linux 3.7.

SEE ALSO
       close(2), connect(2), socket(2), socket(7)

COLOPHON
       This  page  is  part of release 5.05 of the Linux man-pages project.  A
       description of the project, information about reporting bugs,  and  the
       latest     version     of     this    page,    can    be    found    at
       https://www.kernel.org/doc/man-pages/.

Linux                             2018-04-30                       SHUTDOWN(2)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2024 Hurricane Electric. All Rights Reserved.