禁止在一个套接口上进行数据的接收与传送。

s：用于标识一个套接口的描述字。

how：标誌，用于描述禁止哪些操作。

Linux：

#include<sys/socket.h>

int shutdown(int sockfd,int how);

linux下成功则返回0，错误返回-1，错误码errno：EBADF表示sockfd不是一个有效描述符；ENOTCONN表示sockfd未连线；ENOTSOCK表示sockfd是一个描述符而不是socket描述符。

how的方式有三种分别是

SHUT_RD（0）：关闭sockfd上的读功能，此选项将不允许sockfd进行读操作。

SHUT_WR（1）：关闭sockfd的写功能，此选项将不允许sockfd进行写操作。

SHUT_RDWR（2）：关闭sockfd的读写功能。

Windows：

#include <winsock.h>或#include <winsock2.h>

int PASCAL FAR shutdown( SOCKET s, int how);

how的方式有三种分别是

SD_RECEIVE（0）：Shutdown receive operations.

SD_SEND（1）：Shutdown send operations.

SD_BOTH（2）：Shutdown both send and receive operations.

shutdown()函式用于任何类型的套接口禁止接收、禁止传送或禁止收发。

如果how参数为0，则该套接口上的后续接收操作将被禁止。这对于低层协定无影响。对于TCP协定，TCP视窗不改变并接收前来的数据（但不确认）直至视窗满。对于UDP协定，接收并排队前来的数据。任何情况下都不会产生ICMP错误包。

若how为1，则禁止后续传送操作。对于TCP，将传送FIN。

若how为2，则同时禁止收和发。

请注意shutdown()函式并不关闭套接口，且套接口所占有的资源将被一直保持到closesocket()调用。

无论SO_LINGER设定与否，shutdown()函式不会阻塞。

一个应用程式不应依赖于重用一个已被shutdown()禁止的套接口。特别地，一个WINDOWS套接口实现不必支持在这样的套接口上使用connect()调用。

返回值：

如果没有错误发生，shutdown()返回0。否则的话，返回SOCKET_ERROR错误，应用程式可通过WSAGetLastError()获取相应错误代码。

错误代码：

WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。

WSAENETDOWN：WINDOWS套接口实现检测到网路子系统失效。

WSAEINVAL：how参数非法。

WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。

WSAENOTCONN：套接口未连线（仅适用于SOCK_STREAM类型套接口）。

WSAENOTSOCK：描述字不是一个套接口。

扩展知识：

Socket的close与shutdown

close-----关闭本进程的socket id，但连结还是开着的，用这个socket id的其它进程还能用这个连结，能读或写这个socket id。

shutdown--则破坏了socket 连结，读的时候可能侦探到EOF结束符，写的时候可能会收到一个SIGPIPE信号，这个信号可能直到socket buffer被填充了才收到。

更多关于close和shutdown的说明：

1. 如果有多个进程共享一个套接字，close每被调用一次，计数减1，直到计数为0时，也就是所用进程都调用了close，套接字将被释放。

2. 在多进程中如果一个进程中shutdown(sfd, SHUT_RDWR)后其它的进程将无法进行通信. 如果一个进程close(sfd)将不会影响到其它进程. 得自己理解引用计数的用法了. 有Kernel编程知识的更好理解了.

3. 只要TCP栈的读缓冲里还有未读取（read）数据，则调用close时会直接向对端传送RST。

4. shutdown与socket描述符没有关係，即使调用shutdown(fd, SHUT_RDWR)也不会关闭fd，最终还需close(fd)。

5. 可以认为shutdown(fd, SHUT_RD)是空操作，因为shutdown后还可以继续从该socket读取数据，这点也许还需要进一步证实。

6. 在已传送FIN包后write该socket描述符会引发EPIPE/SIGPIPE。

7. 当有多个socket描述符指向同一socket对象时，调用close时首先会递减该对象的引用计数，计数为0时才会传送FIN包结束TCP连线。shutdown不同，只要以SHUT_WR/SHUT_RDWR方式调用即传送FIN包。

8. SO_LINGER与close，当SO_LINGER选项开启但逾时值为0时，调用close直接传送RST（这样可以避免进入TIME_WAIT状态，但破坏了TCP协定的正常工作方式），SO_LINGER对shutdown无影响。

9. TCP连线上出现RST与随后可能的TIME_WAIT状态没有直接关係，主动发FIN包方必然会进入TIME_WAIT状态，除非不传送FIN而直接以传送RST结束连线。

参见：

connect(), socket(),bind()