libevlite网络通信库(Linux, Darwin, *BSD)

1. 基础事件模块( `include/event.h` )

==支持的IO复用机制: epoll和kqueue==

1.1 事件类型说明

读事件(EV_READ)
写事件(EV_WRITE)
超时事件(EV_TIMEOUT)
在三种事件类型的基础上, 支持事件驻留在事件集中的永久模式(EV_PERSIST)

1.2 基于事件(`event_t`)的方法说明

设置事件属性 event_set()
设置事件回调函数 event_set_callback()

1.3 基于事件集(`evsets_t`)的方法说明

向事件集中添加事件 evsets_add()
从事件集中删除事件 evsets_del()
分发并处理事件 evsets_dispatch()

2. 网络线程模块( `include/threads.h` )

3. 通信模块( `include/networks.h` )

3.1 创建网络通信层 `iolayer_create()`

nthreads: 指定网络线程的个数
nclients: 推荐连接数
precision: 事件集的时间精度(建议值8ms)
immediately: 数据是否会立刻推送到网络层，对实时性要求很高的场景, 建议设置为1

3.2 设置网络通信层的方法(仅在IO线程中才能使用)

设置线程上下文: iolayer_set_iocontext()
设置网络层数据改造方法: iolayer_set_transform()

3.3 监听端口/开启服务端 `iolayer_listen()`

type: 网络类型, 支持TCP, UDP和KCP
host: 绑定的地址
port: 监听的端口号
options: 服务器全局参数(当前主要是KCP的参数配置)
callback: 新会话创建成功的回调
context: 上下文参数

3.4 连接远程服务/开启客户端 `iolayer_connect()`

3.5 关联描述符的读写事件 `iolayer_associate()`

3.6 设置会话的方法(仅在IO线程中才能使用)

设置会话的超时时间 iolayer_set_timeout()
设置会话的保活时间 iolayer_set_keepalive()
设置会话的IO服务逻辑 iolayer_set_service()
设置会话的读事件常驻事件集 iolayer_set_persist()
设置会话的发送队列长度限制 iolayer_set_sndqlimit()
设置会话的最大传输单元(仅限KCP有效) iolayer_set_mtu()
设置会话的最小重传时间(仅限KCP有效) iolayer_set_minrto()
设置会话的发送接收窗口(仅限KCP有效) iolayer_set_wndsize()

3.7 发送数据 `iolayer_send()`

3.8 广播数据 `iolayer_broadcast()`, `iolayer_broadcast2()`

3.9 关闭会话 `iolayer_shutdown()`, `iolayer_shutdowns()`

3.10 提交任务到网络层 `iolayer_invoke()`, `iolayer_perform()`

3.11 停止服务 `iolayer_stop()`

停止对外提供接入服务, 不再接受新的连接;
停止所有连接的接收服务, 不再回调ioservice_t::process()

3.12 销毁网络层 `iolayer_destroy()`