libevent evconnlistener_new() 创建监听器函数

// Parameters:

//        listener         The evconnlistener

//        fd                 The new file descriptor

//        addr             The source address of the connection

//        socklen        The length of addr

//        user_arg       the pointer passed to evconnlistener_new()

typedef void (* evconnlistener_cb)(struct evconnlistener *listener, evutil_socket_t fd, struct sockaddr *addr, int socklen, void *user_arg);

//  struct event_base *base, 为已初始化成功的指针。

// evconnlistener_cb cb, 一个回调函数，当有客户端连接上来时，该函数被调用。

// void *ptr, 传递给evconnlistener_cb cb 的参数，即上面typedef 的最后一个参数：void *user_arg.

// unsigned flags, 这个控制回调函数的行为，我一般用两个：LEV_OPT_REUSEABLE | LEV_OPT_CLOSE_ON_FREE

// int backlog, 这个跟listen() 函数的参数一个解释

// evutil_socket_t fd, 这个是已经绑定成功的SOCKET 文件描述符。

// 最后，使用完后记得释放资源，使用：evconnlistener_free()  函数。

struct evconnlistener * evconnlistener_new(struct event_base *base,

          evconnlistener_cb cb, void *ptr, unsigned flags, int backlog,

          evutil_socket_t fd);

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*()函数都分配和返回一个新的连接监听器对象。连接监听器使用
event_base 来得知什么时候在给定的监听套接字上有新的 TCP 连接。 新连接到达时， 监听
器调用你给出的回调函数。
     两个函数中，base 参数都是监听器用于监听连接的 event_base。cb 是收到新连接时要调
用的回调函数；如果 cb 为 NULL，则监听器是禁用的，直到设置了回调函数为止。ptr 指针
将传递给回调函数。flags 参数控制回调函数的行为，下面会更详细论述。backlog 是任何
时刻网络栈允许处于还未接受状态的最大未决连接数。更多细节请查看系统的 listen()函数
文档。如果 backlog 是负的，libevent 会试图挑选一个较好的值；如果为0，libevent 认为已
经对提供的套接字调用了 listen()。
     两个函数的不同在于如何建立监听套接字。evconnlistener_new()函数假定已经将套接字绑
定到要监听的端口，然后通过 fd 传入这个套接字。如果要 libevent 分配和绑定套接字，可
以调用 evconnlistener_new_bind()，传输要绑定到的地址和地址长度。
     要释放连接监听器，调用 evconnlistener_free()。