wepoll 技术文档
2024-12-27 09:26:46作者:鲍丁臣Ursa
1. 安装指南
系统要求
- 操作系统:Windows Vista 或更高版本
- 编译器:近期版本的 MSVC、Clang 或 GCC
安装步骤
- 从 wepoll GitHub 仓库 下载
wepoll.c
和wepoll.h
文件。 - 将这些文件添加到您的项目中。
- 使用您的编译器编译项目,确保包含
wepoll.c
和wepoll.h
。
2. 项目的使用说明
wepoll
是一个在 Windows 应用程序中实现 epoll API 的库。它快速且可扩展,与 Linux 的 epoll API 行为和接口非常相似。
主要功能
- 支持高效地轮询数以十万计的套接字。
- 全线程安全。
- 多个线程可以轮询同一个 epoll 端口。
- 套接字可以被添加到多个 epoll 集合中。
- 支持
EPOLLIN
、EPOLLOUT
、EPOLLPRI
、EPOLLRDHUP
等所有 epoll 事件。 - 支持边缘触发和单次触发模式。
限制
- 仅适用于套接字。
- 不支持边缘触发 (
EPOLLET
) 模式。
3. 项目API使用文档
通用说明
- epoll 端口是一个
HANDLE
类型,而不是文件描述符。 - 所有函数在失败时都会设置
errno
和GetLastError()
。
epoll_create/epoll_create1
HANDLE epoll_create(int size);
HANDLE epoll_create1(int flags);
- 创建一个新的 epoll 实例(端口)。
size
被忽略但必须大于零。flags
必须为零,因为没有支持的标志。- 失败时返回
NULL
。
epoll_close
int epoll_close(HANDLE ephnd);
- 关闭一个 epoll 端口。
- 不要尝试使用
close()
、CloseHandle()
或closesocket()
来关闭 epoll 端口。
epoll_ctl
int epoll_ctl(HANDLE ephnd, int op, SOCKET sock, struct epoll_event* event);
- 控制一个 epoll 端口监控的套接字事件。
ephnd
必须是一个由epoll_create()
或epoll_create1()
创建的 HANDLE。op
必须是EPOLL_CTL_ADD
、EPOLL_CTL_MOD
或EPOLL_CTL_DEL
之一。sock
必须是一个有效的套接字。event
应该指向一个struct epoll_event
。- 成功返回 0,失败返回 -1。
epoll_wait
int epoll_wait(HANDLE ephnd, struct epoll_event* events, int maxevents, int timeout);
- 从一个 epoll 端口接收套接字事件。
events
指向一个调用者分配的epoll_event
结构数组。maxevents
是events
数组中可以写入的最大事件数。timeout
指定在没有事件立即可用时的阻塞行为。- 返回值:-1 表示错误,0 表示超时,大于等于1 表示存储在
events
缓冲区中的事件数。
struct epoll_event
typedef union epoll_data {
void* ptr;
int fd;
uint32_t u32;
uint64_t u64;
SOCKET sock; /* Windows specific */
HANDLE hnd; /* Windows specific */
} epoll_data_t;
struct epoll_event {
uint32_t events; /* Epoll 事件和标志 */
epoll_data_t data; /* 用户数据变量 */
};
events
字段是一个包含正在监控/报告的事件和可选标志的位掩码。data
字段可以用于将应用程序特定的信息与套接字关联起来。
支持的事件和标志
事件 | 描述 |
---|---|
EPOLLIN |
有数据可读,或者有连接就绪接受 |
EPOLLOUT |
可发送数据,或者出站连接成功建立 |
EPOLLRDHUP |
远端发起优雅的套接字关闭 |
EPOLLPRI |
有带外数据可读 |
EPOLLERR |
套接字错误 |
EPOLLHUP |
套接字挂起 |
EPOLLRDNORM |
与 EPOLLIN 相同 |
EPOLLRDBAND |
与 EPOLLPRI 相同 |
EPOLLWRNORM |
与 EPOLLOUT 相同 |
EPOLLWRBAND |
与 EPOLLOUT 相同 |
EPOLLMSG |
从不报告 |
标志 | 描述 |
---|---|
EPOLLONESHOT |
只报告一次事件 |
EPOLLET |
不支持 |
EPOLLEXCLUSIVE |
不支持 |
EPOLLWAKEUP |
不支持 |
4. 项目安装方式
请参考上述的“安装指南”部分。
登录后查看全文
热门内容推荐
1 freeCodeCamp课程中关于单选框样式定制的技术解析2 freeCodeCamp React课程模块加载问题解析3 freeCodeCamp Python密码生成器课程中的动词一致性修正4 freeCodeCamp购物清单项目中的全局变量使用问题分析5 freeCodeCamp英语课程中动词时态一致性问题的分析与修正6 freeCodeCamp课程中"午餐选择器"实验的文档修正说明7 freeCodeCamp课程中关于学习习惯讲座的标点规范修正8 freeCodeCamp全栈开发课程中关于HTML可访问性讲座的字幕修正9 freeCodeCamp课程中CSS模态框描述优化分析10 freeCodeCamp国际化组件中未翻译内容的技术分析
最新内容推荐
项目优选
收起

🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
438
335

React Native鸿蒙化仓库
C++
97
171

openGauss kernel ~ openGauss is an open source relational database management system
C++
51
116

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
51
14

本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
273
446

前端智能化场景解决方案UI库,轻松构建你的AI应用,我们将持续完善更新,欢迎你的使用与建议。
官网地址:https://matechat.gitcode.com
634
75

旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
88
244

🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
344
34

微信小程序商城,微信小程序微店
JavaScript
27
2

基于仓颉编程语言构建的 LLM Agent 开发框架,其主要特点包括:Agent DSL、支持 MCP 协议,支持模块化调用,支持任务智能规划。
Cangjie
559
39