翻譯自：http://www.wangafu.net/~nickm/libevent-book/Ref0_meta.html
轉(zhuǎn)自:http://blog.sina.com.cn/s/blog_56dee71a0100q7j6.html

1  從一萬英尺外看Libevent

Libevent是用于編寫高速可移植非阻塞IO應(yīng)用的庫，其設(shè)計(jì)目標(biāo)是：

v 可移植性：使用libevent編寫的程序應(yīng)該可以在libevent支持的所有平臺上工作。即使沒有好的方式進(jìn)行非阻塞IO，libevent也應(yīng)該支持一般的方式，讓程序可以在受限的環(huán)境中運(yùn)行。

v 速度：libevent嘗試使用每個(gè)平臺上最高速的非阻塞IO實(shí)現(xiàn)，并且不引入太多的額外開銷。

v 可擴(kuò)展性：libevent被設(shè)計(jì)為程序即使需要上萬個(gè)活動(dòng)套接字的時(shí)候也可以良好工作。

v 方便：無論何時(shí)，最自然的使用libevent編寫程序的方式應(yīng)該是穩(wěn)定的、可移植的。

libevent由下列組件構(gòu)成：

v evutil：用于抽象不同平臺網(wǎng)絡(luò)實(shí)現(xiàn)差異的通用功能。

v event和event_base：libevent的核心，為各種平臺特定的、基于事件的非阻塞IO后端提供抽象API，讓程序可以知道套接字何時(shí)已經(jīng)準(zhǔn)備好，可以讀或者寫，并且處理基本的超時(shí)功能，檢測OS信號。

v bufferevent：為libevent基于事件的核心提供使用更方便的封裝。除了通知程序套接字已經(jīng)準(zhǔn)備好讀寫之外，還讓程序可以請求緩沖的讀寫操作，可以知道何時(shí)IO已經(jīng)真正發(fā)生。（bufferevent接口有多個(gè)后端，可以采用系統(tǒng)能夠提供的更快的非阻塞IO方式，如Windows中的IOCP。）

v evbuffer：在bufferevent層之下實(shí)現(xiàn)了緩沖功能，并且提供了方便有效的訪問函數(shù)。

v evhttp：一個(gè)簡單的HTTP客戶端/服務(wù)器實(shí)現(xiàn)。

v evdns：一個(gè)簡單的DNS客戶端/服務(wù)器實(shí)現(xiàn)。

v evrpc：一個(gè)簡單的RPC實(shí)現(xiàn)。

2  庫

創(chuàng)建libevent時(shí)，默認(rèn)安裝下列庫：

v libevent_core：所有核心的事件和緩沖功能，包含了所有的event_base、evbuffer、bufferevent和工具函數(shù)。

v libevent_extra：定義了程序可能需要，也可能不需要的協(xié)議特定功能，包括HTTP、DNS和RPC。

v libevent：這個(gè)庫因?yàn)闅v史原因而存在，它包含libevent_core和libevent_extra的內(nèi)容。不應(yīng)該使用這個(gè)庫，未來版本的libevent可能去掉這個(gè)庫。

某些平臺上可能安裝下列庫：

v libevent_pthreads：添加基于pthread可移植線程庫的線程和鎖定實(shí)現(xiàn)。它獨(dú)立于libevent_core，這樣程序使用libevent時(shí)就不需要鏈接到pthread，除非是以多線程方式使用libevent。

v libevent_openssl：這個(gè)庫為使用bufferevent和OpenSSL進(jìn)行加密的通信提供支持。它獨(dú)立于libevent_core，這樣程序使用libevent時(shí)就不需要鏈接到OpenSSL，除非是進(jìn)行加密通信。

3 頭文件

libevent公用頭文件都安裝在event2目錄中，分為三類：

v API頭文件：定義libevent公用接口。這類頭文件沒有特定后綴。

v 兼容頭文件：為已廢棄的函數(shù)提供兼容的頭部包含定義。不應(yīng)該使用這類頭文件，除非是在移植使用較老版本libevent的程序時(shí)。

v 結(jié)構(gòu)頭文件：這類頭文件以相對不穩(wěn)定的布局定義各種結(jié)構(gòu)體。這些結(jié)構(gòu)體中的一些是為了提供快速訪問而暴露；一些是因?yàn)闅v史原因而暴露。直接依賴這類頭文件中的任何結(jié)構(gòu)體都會(huì)破壞程序?qū)ζ渌姹緇ibevent的二進(jìn)制兼容性，有時(shí)候是以非常難以調(diào)試的方式出現(xiàn)。這類頭文件具有后綴“_struct.h”。

（還存在不在event2目錄中的較老版本libevent的頭文件，請參考下節(jié)：如果需要使用老版本libevent）

4 如果需要使用老版本libevent

libevent 2.0以更合理的、不易出錯(cuò)的方式修正了API。如果可能，編寫新程序時(shí)應(yīng)該使用libevent 2.0。但是有時(shí)候可能需要使用較老的API，例如在升級已存的應(yīng)用時(shí)，或者支持因?yàn)槟承┰虿荒馨惭b2.0或者更新版本libevent的環(huán)境時(shí)。

較老版本的libevent頭文件較少，也不安裝在event2目錄中。