https://github.com/spriteray/libevlite

libevlite - A simple Network library that contains the Event library, Thread library, Communications library. Event library is LIBEVENT Lite Edition, so named for the LIBEVLITE
https://github.com/spriteray/libevlite

curl-multi kcp libevent

Last synced: 18 days ago
JSON representation

libevlite - A simple Network library that contains the Event library, Thread library, Communications library. Event library is LIBEVENT Lite Edition, so named for the LIBEVLITE

• Host: GitHub
• URL: https://github.com/spriteray/libevlite
• Owner: spriteray
• License: bsd-2-clause
• Created: 2012-09-23T08:38:02.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2023-11-09T06:57:23.000Z (about 1 year ago)
• Last Synced: 2024-07-31T22:56:18.407Z (3 months ago)
• Topics: curl-multi, kcp, libevent
• Language: C
• Homepage:
• Size: 420 KB
• Stars: 9
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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()`