C语言 socket shutdown()函数（将与 sockfd 关联的套接字上的全双工连接全部或部分关闭）

Posted 2022-04-04 Dontla

man 2 文档

[root@ubuntu /arnold_test/20220324_hikflow_demo__socket_server_test]102# man -f shutdown
shutdown (8)         - Halt, power-off or reboot the machine
shutdown (2)         - shut down part of a full-duplex connection
shutdown (3posix)    - shut down socket send and receive operations

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 recep‐
       tions 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.
       //shutdown() 调用导致与 sockfd 关联的套接字上的全双工连接全部或部分关闭。 
       //如果 SHUT_RD 是怎样的，则不允许进一步的接收。 
       //如果 SHUT_WR 怎样，则不允许进一步传输。 如果 SHUT_RDWR 怎么样，将不允许进一步的接收和传输。

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

ERRORS
       EBADF  sockfd is not a valid 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, respectively, 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
       connect(2), socket(2), socket(7)

COLOPHON
       This page is part of release 4.04 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 http://www.kernel.org/doc/man-pages/.

Linux                                                                       2015-12-28                                                                 SHUTDOWN(2)

参考文章：socket–shutdown()函数