原文链接http://www.wangafu.net/~nickm/libevent-book/Ref0_meta.html
Libevent使用手册:前瞻
总览:
Libevent是一个用来写高性能跨平台非阻塞IO程序的库.它的设计目标如下:
跨平台
一个使用Libevent的程序应当能够运行于libevent支持的各种平台.即便有时(某平台可能)没有一种很好的实现非阻塞IO的方式,libevent也应该用一种还凑合(so-so)的方式,这样你的程序才能运行于一个严苛的环境下。
高速
libevent使用不同平台下可使用的最快的非阻塞IO实现,同时不引入过多的其他开销.
扩展性
libevent被设计为即便是要处理成千上万条活跃链接时也工作良好.
便捷性
无论何时,用libevent写程序的最自然的方式都应该是一种稳定的,跨平台的方式.
Libevent分为以下几个部分
evutil
对不同平台的网络实现抽象而出的一套通用函数
event和event_base
这是Libevent的核心部分.它针对各种各样的平台相关的,基于事件的非阻塞IO(platform-specific, event-based nonblocking IO backends),抽象出一套API.它能够告知你何时sockets可读或可写,提供了基本的超时函数,并能够侦测操作系统信号.
bufferevent
这些函数在Libevent的基于事件的核心代码之上(event-based core)提供了更为便捷的包装.他们使得你的应用程序请求已缓冲的读写,所以只有当真正的IO发生的时候,而不是socket可读写的时候,它们才会通知你.
bufferevent接口有不同的后端实现,所以他可以充分利用不同平台提供的实现非阻塞IO的快速的方式,例如WINDOWS下的IOCP API.
evbuffer
这个模块实现了作为bufferevents基础的buffer,并提供了高效的,易于使用的函数.
evhttp
一个简单的HTTP client/server实现
evdns
一个简单的DNS client/server实现
evrpc
一个简单的RPC实现
库
当安装了Libevent,默认地,会安装以下的库:
libevent_core
含有所有的核心的event和buffer功能.这个库包含所有的event_base,evbuffer,bufferevent以及公用函数.
libevent_extra
这个库包含了你的程序可能会用到的一些与特定协议有关的功能.比如HTTP,DNS,RPC.
libevent
这个库的存在是因为一些历史原因.它包括了libevent_core和libevent_extra的功能.你不应该用这个库,它在未来版本的Libevent中会消失.
以下的库在部分平台上才会被安装:
libevent_pthreads
这个库添加了基于跨平台线程库的线程和锁的实现.这个库和libevent_core是分开的,所以当你使用Libevent的时候除非你真的需要以多线程的方式使用Libevent,否则你是不需要链接这个库的.
libevent_openssl
这个库使用bufferevents和OpenSSL库,提供了加密通信的功能.这个库和libevent_core是分开的,所以当你使用Libevent的时候除非你真的需要使用加密连接,否则你是不需要链接OpenSSL的.
头文件
所有的头文件都放在event2目录下.这些头文件大体可以分为3种:
API 头文件
一个API头文件定义了一些LIbevent的公共接口.这些头文件的名字不带后缀.
兼容性头文件
兼容性头文件定义了一些已经弃用的函数.除非你想将你的程序从旧版本的Libevent迁移过来,否则你不该使用这些头文件
结构体头文件
这些头文件定义了相对不稳定的组件的结构(These headers define structures with relatively volatile layouts).这些结构被暴露给你一是以防你需要快速地访问该结构,还有一些是出于历史原因.如果你的程序直接依赖于这些头文件中的结构,可能会导致你的程序与不同版本的Libevent有二进制兼容性问题,并且很难调试.这些头文件有“_struct.h”的后缀.