Linux程序员手册 第2部分
更新日期： 2018-04-30

名称

shutdown-关闭全双工连接的一部分

语法

＃包括

int shutdown(int sockfd，int how);

说明

shutdown()调用导致与sockfd关联的套接字上的全双工连接的全部或部分被关闭。如果SHUT_RD如何，将不允许进一步的接收。如果如何SHUT_WR，将不允许进一步的传输。如果SHUT_RDWR如何，将不允许进一步的接收和发送。

返回值

成功时，返回零。如果出错，则返回-1，并正确设置errno。

错误说明

EBADF

sockfd不是有效的文件描述符。

EINVAL

在方式中指定了无效的值(但请参见BUGS)。

ENOTCONN

指定的套接字未连接。

ENOTSOCK

文件描述符sockfd不引用套接字。

遵循规范

POSIX.1-2001，POSIX.1-2008、4.4BSD(shutdown()首次出现在4.2BSD中)。

备注

常量SHUT_RD，SHUT_WR，SHUT_RDWR的值分别为0、1、2，并且自glibc-2.1.91开始定义。

BUGS

检查在特定于域的代码中如何完成操作的有效性，并且在Linux 3.7之前，并非所有域都执行这些检查。最值得注意的是，UNIX域套接字只是忽略了无效值。对于Linux 3.7中的UNIX域套接字，此问题已修复。

另外参见

close(2)，connect(2)，socket(2)，socket(7)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。