listen函数

函数原型

#include <sys/types.h>          /* See NOTES */
#include <sys/socket.h>
int listen(int sockfd, int backlog);

功能

将套接字文件描述符，从主动文件描述符变为被动描述符，然后用于被动监听客户的连接。

返回值

成功返回0，失败返回-1，ernno被设置

参数

sockfd

socket所返回的套接字文件描述符。
socket返回的“套接字文件描述符”默认是主动的，如果你想让它变为被动的话，你需要自己调用listen函数来实现。

backlog

指定队列的容量。

这个队列用于记录正在连接，但是还没有连接完成的客户，一般将队列容量指定为2、3就可以了。

这个容量并没有什么统一个设定值，一般来说只要小于30即可。

代码演示

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <sys/types.h>
#include <sys/socket.h>
#include <string.h>
#include <strings.h>
#include <errno.h>
#include <sys/stat.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#define SPROT 5006
#define SIP "192.168.31.162"
void  print_err(char * str,int line,int err_no)//出错处理函数
{printf("%d,%s: %s\n",line,str,strerror(err_no));exit(-1);
}
int main(void)
{int ret = -1;int sockfd = -1; //存放套接字文件描述符/*创建使用TCP协议通信的套接字文件*/sockfd =  socket(PF_INET,SOCK_STREAM,0); //指定TCP协议if(-1 == sockfd) //进行出错处理print_err("socket fail",__LINE__,errno);/*调用bind函数绑定套接字文件/ip/端口*/struct sockaddr_in saddr;saddr.sin_family = AF_INET;//指定ip格式saddr.sin_port= htons(SPROT);//指定端口saddr.sin_addr.s_addr = inet_addr(SIP);//设置ipret = bind(sockfd,(struct sockaddr*)&saddr,sizeof(saddr));//绑定if(-1 ==ret)print_err("bind fail",__LINE__,errno);/*将主动的套接字文件描述符转换为被动的文件描述符，用于被动监听客户连接。*/ret = listen(sockfd,3);if(-1 ==ret)print_err("listen fail",__LINE__,errno);return 0;
}

实现被动监听客户端连接使用的是另外一个函数，listen函数本身并不会去监听，只是把主动描述符转化为被动描述符，真正等待监听的函数时另外的函数。

不要因为listen有听的意思，就想当然的认为，listen就是用于被动监听客户连接的函数，事实上真正用于被动监听客户连接的函数，并不是listen，而是其它函数。

listen的作用仅仅只是用于将“套接字文件描述符”变成被动描述符，以供“监听函数”用于被动监听客户连接而已。

TCP服务器为什么要listen

一定要注意 : 只有TCP服务器才会调用listen

图解说明：TCP编程模型

TCP服务器调用listen函数的目的。

TCP服务器监听客户连接时，是使用socket返回的“套接字文件描述符”来实现的，但是这个文件描述符默认是主动文件描述符，所以需要使用listen函数将其转为被动描述符，否者无法用于被动监听客户的连接。

什么是主动描述符？
使用主动描述符可以主动的向对方发送数据。

什么是被动描述符？
只能被动的等别人主动想你发数据，然后再回答数据，不能主动的发送数据。

为什么要将“套接字文件描述符”转为被动描述符后，才能监听连接？
TCP服务器和客户端必须要建立连接，建立连接时的三次握手是由客户端主动先发起的，
也就是由客户端率先主动向服务器发送三次握手的数据，而服务器这一端则被动的接收，然后回答。

图解说明：

正是由于服务器在三次握手时的这一被动属性，所以使用“套接字文件描述符”监听客户连接时，描述符必须是被动的描述符，否则服务器无法监听被动连接。