Libevent应用 (五) 连接监听器，接收tcp连接

5 连接监听器，接收tcp连接

5.1  创建和释放evconnlistener

#include <event2/listener.h>
struct evconnlistener *evconnlistener_new_bind(struct event_base *base,
    evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,
    const struct sockaddr *sa, int socklen);
​
void evconnlistener_free(struct evconnlistener *lev);

​

​ 两个evconnlistener_new_bind()函数分配和返回一个新的连接监听器对象。连接监听器使用event_base来得知什么时候在给定的监听套接字上有新的TCP连接。新连接到达时，监听器调用你给出的回调函数。

​ 两个函数中，base参数都是监听器用于监听连接的event_base。cb是收到新连接时要调用的回调函数；如果cb为NULL，则监听器是禁用的，直到设置了回调函数为止。ptr指针将传递给回调函数。flags参数控制回调函数的行为，下面会更详细论述。backlog是任何时刻网络栈允许处于还未接受状态的最大未决连接数。如果backlog是负的，libevent会试图挑选一个较好的值；如果为0，libevent认为已经对提供的套接字调用了listen()。

​ 两个函数的不同在于如何建立监听套接字。evconnlistener_new()函数假定已经将套接字绑定到要监听的端口，然后通过fd传入这个套接字。如果要libevent分配和绑定套接字，可以调用evconnlistener_new_bind()，传输要绑定到的地址和地址长度。

​

可以给evconnlistener_new()函数的flags参数传入一些标志。可以用或(OR)运算任意连接下述标志：

LEV_OPT_LEAVE_SOCKETS_BLOCKING
/*默认情况下，连接监听器接收新套接字后，会将其设置为非阻塞的，
以便将其用于libevent。如果不想要这种行为，可以设置这个标志。*/
  
LEV_OPT_CLOSE_ON_FREE
/*如果设置了这个选项，释放连接监听器会关闭底层套接字。*/
  
LEV_OPT_CLOSE_ON_EXEC
/*如果设置了这个选项，连接监听器会为底层套接字设置close-on-exec标志。*/
  
LEV_OPT_REUSEABLE
/*设置这个标志会让libevent标记套接字是可重用的，这样一旦关闭，
可以立即打开其他套接字，在相同端口进行监听。*/
  
LEV_OPT_THREADSAFE
/*为监听器分配锁，这样就可以在多个线程中安全地使用了。*/

连接监听器回调函数:

typedef void (*evconnlistener_cb)(struct evconnlistener *listener,
    evutil_socket_t sock, struct sockaddr *addr, int len, void *ptr)

​ 接收到新连接会调用提供的回调函数。listener参数是接收连接的连接监听器。sock参数是新接收的套接字。addr和len参数是接收连接的地址和地址长度。ptr是调用evconnlistener_new()时用户提供的指针。

​ 要释放连接监听器，调用evconnlistener_free()。

5.2 启用和禁用evconnlistener

int evconnlistener_disable(struct evconnlistener *lev);
int evconnlistener_enable(struct evconnlistener *lev);

这两个函数暂时禁止或者重新允许监听新连接。

5.3 调整evconnlistener的回调函数

void evconnlistener_set_cb(struct evconnlistener *lev,
    evconnlistener_cb cb, void *arg);

函数调