[翻译]Libevent 参考手册：前言

Libevent 参考手册：前言

从一万英尺外看 Libevent

Libevent 是一个用于编写高速的、可移植的非阻塞IO的应用库，其设计目标是：

可移植性

使用 Libevent 编写的程序应该可以在 Libevent 支持的所有平台上工作。即使没有一个真正好的方式来实现非阻塞IO，Libevent 也应该支持还过得去的方式，让程序可以在受限制的环境中运行。

速度

Libevent 在每个平台上尝试使用最高速的非阻塞IO实现方式，并且没有因为这做而引入太多的额外开销。

可扩展性

Libevent 被设计为即使程序需要上万个活动套接字的时候也可以良好工作。

方便性

无论何时，最自然的使用 Libevent 编写程序的方式应该是稳定的、可移植的。

Libevent 被划分为下列组件：

evutil

用于抽象不同平台网络实现差异的通用功能。

event and event_base

Libevent 的核心，为各种平台特定的、基于事件的非阻塞IO后端提供抽象API，让程序可以知道套接字何时已经准备好，可以读或者写，并且处理基本的超时功能，以及检测OS信号。

bufferevent

这些函数为基于事件的 Libevent 核心提供了更方便的封装。它们让你的程序可以请求缓冲的读取和写入，而不是当套接字准备好读或写的时候通知你，让你知道何时IO已经真正发生。

bufferevent 接口有多个后端，使它可以充分利用系统能够提供的更快的方式去实现非阻塞IO，如 Windows 中的 IOCP。

evbuffer

这个模块实现了 bufferevent 相关的缓冲区，并且提供了一些函数方便有效的进行 and/or 访问。

evhttp

一个简单的 HTTP 客户端/服务器实现。

evdns

一个简单的 DNS 客户端/服务器实现。

evrpc

一个简单的 RPC 实现。

相关的库

当 Libevent 创建时，默认情况下它会安装下列库：

libevent_core

所有核心的事件和缓冲功能，这个库包含了所有的event_base、evbuffer、bufferevent和工具函数。

libevent_extra

这个库定义了程序可能需要，也可能不需要的协议特定功能，包括 HTTP、DNS 和 RPC。

libevent

这个库因为历史原因而存在，它包含了 libevent_core 和 libevent_extra 的内容。你不应该使用这个库，未来的 Libevent 版本中可能去掉这个库。

某些平台上可能会安装下列库：

libevent_pthreads

这个库添加了基于 pthread 可移植线程库的线程和锁实现。它独立于 libevent_core，这样程序使用 Libevent 时就不需要链接到 pthread，除非是你真正的以多线程方式使用 Libevent。

libevent_openssl

这个库为使用 bufferevent 和 OpenSSL 进行加密的通信提供支持。它独立于 libevent_core，这样程序使用 Libevent 时就不需要链接到 OpenSSL，除非你是真正的要进行加密通信。

头文件

所有当前版本的 Libevent 公用头文件都安装在 event2 目录中，头文件分为三大类：

API headers (API头文件)

这些API头文件定义了当前的 Libevent 公用接口。这类头文件没有特定后缀。

Compatibility headers (兼容性头文件)

为已废弃的函数提供兼容的头文件定义。不应该使用这类头文件，除非是在移植旧版本的 Libevent 程序的时候。

Structure headers (结构体头文件)

这类头文件以相对不稳定的布局定义各种结构体。这些结构体中的一些是为了提供快速访问结构体组件而暴露，一些是因为历史原因而暴露。直接依赖这类头文件中的任何结构体都会破坏程序对其他版本 Libevent 的二进制兼容性，有时候是以非常难以调试的方式出现。这类头文件会以后缀“_struct.h”结尾。

(还存在一些不在 event2 目录中的较老版本 Libevent 的头文件，请参考下节：“如果你不得不使用一个老版本的 Libevent”)

如果你不得不使用一个老版本的 Libevent

Libevent 2.0以更合理的、不易出错的方式修正了API。如果可能，编写新程序时应该使用 Libevent 2.0。但是有时候可能需要同时支持较老的 API，要么是在升级已存在的应用程序时，或者支持因为某些原因不能安装2.0或者更新版本 Libevent 的环境时。

较老版本的 Libevent 头文件较少，也不安装在 event2 目录中：

旧的头文件…	…替换为当前版本的头文件
event.h	event2/event*.h, event2/buffer*.h event2/bufferevent*.h event2/tag*.h
evdns.h	event2/dns*.h
evhttp.h	event2/http*.h
evrpc.h	event2/rpc*.h
evutil.h	event2/util*.h

在2.0以及以后版本的 Libevent 中，老的头文件仍然会作为新头文件的封装而存在。

其他关于使用较老版本的提示：

• 1.4版之前只有一个库--"Libevent"，它包含现在分散到 libevent_core 和 libevent_extra 中的所有功能。

• 2.0版之前不支持锁定：只有确定不同时在多个线程中使用同一个结构体时，Libevent 才是线程安全的。

下面的一些章节还将讨论在特定代码库区域可能遇到的已经废弃的API。

关于版本状态的注意事项

1.4.7 及以前版本应该被认为是完全废弃的。1.3e 之前的版本应该被认为是无可救药的、且充满 bug 的。

(此外，不要向 Libevent 维护者发送任何关于 1.4.x 或者更早版本的新特征，这些版本被认为是稳定的发布版本。如果在 1.3x 或者更早版本中发现 bug，在报告之前请确定在最新的稳定发布版本中问题仍然存在：后续发布可能已经解决了问题。)

---

Last updated 2009-11-20 19:55:41 EDT