Libevent(5)— 连接监听器

转自:http://name5566.com/4220.html

 

参考文献列表:
http://www.wangafu.net/~nickm/libevent-book/

此文编写的时候,使用到的 Libevent 为 2.0.21

Libevent 提供了连接监听器 evconnlistener

创建 evconnlistener 实例

  1. // 连接监听器回调函数原型
  2. typedef void (*evconnlistener_cb)(
  3. struct evconnlistener *listener,
  4. // 新的 socket
  5. evutil_socket_t sock,
  6. // 新的 socket 对应的地址
  7. struct sockaddr *addr,
  8. int len,
  9. // 用户自定义数据
  10. void *ptr
  11. );
  12.  
  13. // 创建一个新的连接监听器
  14. struct evconnlistener *evconnlistener_new(
  15. struct event_base *base,
  16. // 一个新的连接到来时此回调被调用
  17. evconnlistener_cb cb,
  18. // 用户自定义数据,会被传递给 cb 回调函数
  19. void *ptr,
  20. // 连接监听器的选项(下面会详细谈到)
  21. unsigned flags,
  22. // 为标准的 listen 函数的 backlog 参数
  23. // 如果为负数,Libevent 将尝试选择一个合适的值
  24. int backlog,
  25. // socket
  26. // Libevent 假定此 socket 已经绑定
  27. evutil_socket_t fd
  28. );
  29.  
  30. // 创建一个新的连接监听器
  31. // 大多数参数含义同于 evconnlistener_new
  32. struct evconnlistener *evconnlistener_new_bind(
  33. struct event_base *base,
  34. evconnlistener_cb cb,
  35. void *ptr,
  36. unsigned flags,
  37. int backlog,
  38. // 指定需要绑定的 socket 地址
  39. const struct sockaddr *sa,
  40. int socklen
  41. );

连接监听器的常用选项如下:

  1. LEV_OPT_CLOSE_ON_FREE
    当关闭连接监听器其底层 socket 也被自动释放
  2. LEV_OPT_REUSEABLE
    设置 socket 绑定的地址可以重用
  3. LEV_OPT_THREADSAFE
    设置连接监听器为线程安全的

释放连接监听器

  1. void evconnlistener_free(struct evconnlistener *lev);

错误检测
如果连接监听器出错,我们可以得到通知:

  1. // 连接监听器错误回调函数原型
  2. typedef void (*evconnlistener_errorcb)(struct evconnlistener *lis, void *ptr);
  3.  
  4. // 为连接监听器设置错误回调函数
  5. void evconnlistener_set_error_cb(struct evconnlistener *lev,
  6. evconnlistener_errorcb errorcb);

一个详细的范例(echo 服务器)

    1. #include <event2/listener.h>
    2. #include <event2/bufferevent.h>
    3. #include <event2/buffer.h>
    4.  
    5. #include <arpa/inet.h>
    6.  
    7. #include <string.h>
    8. #include <stdlib.h>
    9. #include <stdio.h>
    10. #include <errno.h>
    11.  
    12. // 读取回调函数
    13. static void
    14. echo_read_cb(struct bufferevent *bev, void *ctx)
    15. {
    16. struct evbuffer *input = bufferevent_get_input(bev);
    17. struct evbuffer *output = bufferevent_get_output(bev);
    18.  
    19. // 将输入缓冲区的数据直接拷贝到输出缓冲区
    20. evbuffer_add_buffer(output, input);
    21. }
    22.  
    23. // 事件回调函数
    24. static void
    25. echo_event_cb(struct bufferevent *bev, short events, void *ctx)
    26. {
    27. if (events & BEV_EVENT_ERROR)
    28. perror("Error from bufferevent");
    29. if (events & (BEV_EVENT_EOF | BEV_EVENT_ERROR)) {
    30. bufferevent_free(bev);
    31. }
    32. }
    33.  
    34. // 连接监听器回调函数
    35. static void
    36. accept_conn_cb(struct evconnlistener *listener,
    37. evutil_socket_t fd, struct sockaddr *address, int socklen,
    38. void *ctx)
    39. {
    40. // 为新的连接分配并设置 bufferevent
    41. struct event_base *base = evconnlistener_get_base(listener);
    42. struct bufferevent *bev = bufferevent_socket_new(
    43. base, fd, BEV_OPT_CLOSE_ON_FREE);
    44.  
    45. bufferevent_setcb(bev, echo_read_cb, NULL, echo_event_cb, NULL);
    46.  
    47. bufferevent_enable(bev, EV_READ|EV_WRITE);
    48. }
    49.  
    50. // 连接监听器错误回调函数
    51. static void
    52. accept_error_cb(struct evconnlistener *listener, void *ctx)
    53. {
    54. struct event_base *base = evconnlistener_get_base(listener);
    55. // 获取到错误信息
    56. int err = EVUTIL_SOCKET_ERROR();
    57. fprintf(stderr, "Got an error %d (%s) on the listener. "
    58. "Shutting down.\n", err, evutil_socket_error_to_string(err));
    59.  
    60. // 退出事件循环
    61. event_base_loopexit(base, NULL);
    62. }
    63.  
    64. int
    65. main(int argc, char **argv)
    66. {
    67. struct event_base *base;
    68. struct evconnlistener *listener;
    69. struct sockaddr_in sin;
    70.  
    71. int port = 9876;
    72.  
    73. if (argc > 1) {
    74. port = atoi(argv[1]);
    75. }
    76. if (port<=0 || port>65535) {
    77. puts("Invalid port");
    78. return 1;
    79. }
    80.  
    81. base = event_base_new();
    82. if (!base) {
    83. puts("Couldn't open event base");
    84. return 1;
    85. }
    86.  
    87. memset(&sin, 0, sizeof(sin));
    88. sin.sin_family = AF_INET;
    89. sin.sin_addr.s_addr = htonl(0);
    90. sin.sin_port = htons(port);
    91.  
    92. listener = evconnlistener_new_bind(base, accept_conn_cb, NULL,
    93. LEV_OPT_CLOSE_ON_FREE | LEV_OPT_REUSEABLE, -1,
    94. (struct sockaddr*) & sin, sizeof(sin));
    95. if (!listener) {
    96. perror("Couldn't create listener");
    97. return 1;
    98. }
    99. evconnlistener_set_error_cb(listener, accept_error_cb);
    100.  
    101. event_base_dispatch(base);
    102. return 0;
    103. }

你可能感兴趣的:(libevent)