int recv( SOCKET s, char *buf, int len, int flags);

参数说明

1. 第一个参数指定接收端套接字描述符； 
2. 第二个参数指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据； 
3. 第三个参数指明buf的长度；
4. 第四个参数一般置0。

同步Socket的recv函数的执行流程

当应用程序调用recv函数时：

1. recv先等待 SOCKET s 的发送缓冲中的数据被协议传送完毕，如果协议在传送s的发送缓冲中的数据时出现网络错误，那么recv函数返回SOCKET_ERROR；
2. 如果s的发送缓冲区中没有数据或者数据被协议成功发送完毕后，recv先检查套接字s的接收缓冲区；
3. 如果s的接收缓冲区中没有数据或者协议正在接收数据，那么recv就一直等待，直到协议把数据接收完毕；
4. 当协议把数据接收完毕，recv函数就把s的接收缓冲区中的数据copy到buf中。（注意协议接收到的数据可能大于buf的长度，所以 在这种情况下要调用几次recv函数才能把s的接收缓冲中的数据copy完。recv函数仅仅是copy数据，真正的接收数据是协议来完成的）， recv函数返回其实际copy的字节数。如果recv在copy时出错，那么它返回SOCKET_ERROR；
5. 如果recv函数在等待协议接收数据时网络中断了，那么它返回0。

默认 socket 是阻塞的，阻塞与非阻塞recv()返回值没有区分，都是

<0 出错，
=0 连接关闭，
>0 接收到的数据长度大小

返回值

1. 成功执行时，返回接收到的字节数。
2. 另一端已关闭则返回0。
3. 失败返回-1，errno被设为以下的某个值 ：

• EAGAIN：套接字已标记为非阻塞，而接收操作被阻塞或者接收超时 
• EBADF：sock不是有效的描述词 
• ECONNREFUSE：远程主机阻绝网络连接 
• EFAULT：内存空间访问出错 
• EINTR：操作被信号中断 
• EINVAL：参数无效 
• ENOMEM：内存不足 
• ENOTCONN：与面向连接关联的套接字尚未被连接上 
• ENOTSOCK：sock索引的不是套接字 当返回值是0时，为正常关闭连接；

特别

返回值<0时并且(errno == EINTR || errno == EWOULDBLOCK || errno == EAGAIN)的情况下认为连接是正常的，继续接收。

EAGAIN、EWOULDBLOCK、EINTR与非阻塞

• EWOULDBLOCK：用于非阻塞模式，不需要重新读或者写
• EINTR：指操作被中断唤醒，需要重新读/写

如果出现EINTR即errno为4，错误描述Interrupted system call，操作应该继续。

• EAGAIN：Linux - 非阻塞socket编程处理EAGAIN错误

在linux进行非阻塞的socket接收数据时经常出现Resource temporarily unavailable，errno代码为11(EAGAIN)。从字面上来看，是提示再试一次。这个错误经常出现在当应用程序进行一些非阻塞(non-blocking)操作(对文件或socket)的时候。这个错误不会破坏socket的同步，不用管它，下次循环接着recv就可以。

对非阻塞socket而言，EAGAIN不是一种错误。在VxWorks和Windows上，EAGAIN的名字叫做EWOULDBLOCK。

　　例如，以 O_NONBLOCK的标志打开文件/socket/FIFO，如果你连续做read操作而没有数据可读。此时程序不会阻塞起来等待数据准备就绪返 回，read函数会返回一个错误EAGAIN，提示你的应用程序现在没有数据可读请稍后再试。

　　又例如，当一个系统调用(比如fork)因为没有足够的资源(比如虚拟内存)而执行失败，返回EAGAIN提示其再调用一次(也许下次就能成功)。

 

参考：

https://segmentfault.com/a/1190000003780387

https://blog.csdn.net/haluoluo211/article/details/48381649

https://blog.csdn.net/wm_1991/article/details/51858997