libevent参考手册翻译：热身

Table of Contents

• 1 libevent参考手册：热身
  • 1.1 简介
  • 1.2 模块划分
    • 1.2.1 evutil
    • 1.2.2 event and event_base
    • 1.2.3 bufferevent
    • 1.2.4 evbuffer
    • 1.2.5 evhttp
    • 1.2.6 evdns
    • 1.2.7 evrpc
  • 1.3 目标库说明
    • 1.3.1 libevent_core
    • 1.3.2 libevent_extra
    • 1.3.3 libevent
    • 1.3.4 libevent_pthreads
    • 1.3.5 libevent_openssl
  • 1.4 头文件说明
    • 1.4.1 API头文件
    • 1.4.2 兼容头文件
    • 1.4.3 结构化头文件

所有者：Nick Mathewson

翻译者：Magic_Gcc

1 libevent参考手册：热身

1.1 简介

libevent是一个用于编写高效、可移植、无阻塞IO的库。它的设计目标是：

可移植性：利用libevent编写的程序必须能在所有支持libevent的平台上工作。甚至当没有好的方式去实现无阻塞IO，libevent也应做到一定水准，以便应用能在严格的环境下运行。

效率：libevent试图使用每个平台上最快使用的无阻塞IO实现，而不引进其他开销。

可扩展性：libevent设计成让需要激活成千上万个socket的程序都能正常运行。

易用性：用libevent编写应用最自然的方式什么时候都应该是稳定和可移植的。

1.2 模块划分

1.2.1 evutil

提供通用功能，将在不同平台上网络实现的差异抽象出来。

1.2.2 event and event_base

这是libevent的核心部分。为不同特定平台、基于事件的无阻塞IO后端提供抽象的接口；能当sockets就绪时，通知你去做读写操作，或者做超时功能及检测系统信号。

1.2.3 bufferevent

这些函数在libevent event_base核心模块基础上提供更易用的封装。让程序请求带缓存的读和写，并当IO确实发生时通知程序，而不是当socket就绪时通知你。

1.2.4 evbuffer

该模块在bufferevent下面实现buffer，并为高效易用的访问提供接口。

1.2.5 evhttp

简单实现HTTP客户端/服务端

1.2.6 evdns

简单实现DNS客户端/服务端

1.2.7 evrpc

简单RPC实现

1.3 目标库说明

编译完libevent后，默认安装以下库：

1.3.1 libevent_core

所有关于核心的event和buffer的功能都在其中，它包含event_{base，evbuffer，bufferevent，和utility函数。}

1.3.2 libevent_extra

定义应用可能会/可能不会用到的特定协议功能，包含HTTP，DNS和RPC。

1.3.3 libevent

这个库存在时有历史原因的；包含了以上提到的两个库的内容；目前不应该使用它，它将在未来的版本被去掉。

1.3.4 libevent_pthreads

增加基于可移植的三方线程库实现线程和锁。它和libevent_core_{分开以便开发者按是否需要多线程而去自主选择是否链接该库。}

1.3.5 libevent_openssl

使用bufferevent和OpenSSL库实现加密通信，同样按项目需求决定是否链接该库。

1.4 头文件说明

当前所有公用的libevent头文件被安装在event2目录下,大体分为以下三类：

1.4.1 API头文件

开放当前libevent版本所有公用接口，这些接口都没有特殊的前缀。

1.4.2 兼容头文件

兼容的头文件包含被弃用函数的定义。如果你的程序不是从旧版本移植过来的话，请不要使用这些头文件。

1.4.3 结构化头文件

这些头文件定义一些相对易变的结构体。当你需要对一些结构化的模块进行快速访问时，这些接口是透明的。任何直接依赖这些结构体的程序都难以与旧版本兼容，有时候很难进行调试。