此文編寫的時候，使用到的 Libevent 為 2.0.21

Libevent 之跨平臺

在處理大量 SOCKET 連線時，使用 select 並不高效。各個系統都提供了處理大量 SOCKET 連線時的解決方案：

1. Linux 下的 epoll()
2. BSD 下的 kqueue()
3. Solaris 下的 evports
4. Windows 下的 IOCP

由於各個平臺使用了不同的介面，那麼我們需要編寫跨平臺的高效能非同步程式時就需要做一層跨平臺封裝。
這個時候 Libevent 就成為一個較好的選擇，其最底層 API（event 和 event_base API）為各個平臺實現高效能非同步程式提供了一致的介面。

Libevent 2 提供的 bufferevent 介面，一方面簡化了程式設計的難度，另一方面保證了在 Windows 和 Unix 上都很高效。

一些基本的概念

1. event 會繫結檔案描述符、回撥函式並表示一個或者多個條件（例如，檔案描述符可以讀或者寫了、發生了超時等）。event 表示的條件如果被觸發了，那麼 event 會變為活躍的，它繫結的回撥函式就會被執行
2. event_base 用於持有一組 event 並進行事件迴圈，event_base 會存在一個後端（也叫做方法），常見的後端包括 epoll、kqueue 等

Libevent 的結構

元件：

1. evutil 用於抽象不同的平臺的網路（基礎的）實現
2. event、event_base 為 Libevent 的核心，為不同的平臺下基於事件的非阻塞 I/O 提供了一套抽象的介面
3. bufferevent 對 Libevent 的基於事件的核心的封裝。應用程式的讀寫請求是基於緩衝區的
4. evbuffer 為 bufferevent 實現的緩衝區
5. evhttp 一個簡單的 HTTP client/server 的實現
6. evdns 一個簡單的 DNS client/server 的實現
7. evrpc 一個簡單的 RPC 實現

庫：

1. libevent_core 包括 util、event_base、evbuffer、bufferevent
2. libevent_extra 包括 HTTP、DNS、RPC
3. libevent 此庫由於歷史原因而存在，不要使用它
4. libevent_pthreads 此庫為基於 pthread 的執行緒和鎖的實現
5. libevent_openssl 此庫通過 openssl 和 bufferevent 提供了加密通訊

標頭檔案：
所有的公用標頭檔案位於 event2 目錄中。

編譯 Libevent 庫

Linux 下編譯的方式為（詳細見 README）：

1. $ ./configure
2. $ make

常用的 configure 標誌有：

1. --disable-shared 只編譯靜態庫
2. --disable-openssl 關閉OpenSSL加密支援

Windows 下編譯的方式為：

1. nmake /f Makefile.nmake

需要注意的是，雖然官方提供了此 makefile，但是此檔案尚未編寫完善（詳見 Makefile.nmake 的註釋）
編譯完成之後，需要將 WIN32-Code 目錄加入到 VS 的 include paths 中去

設定 Libevent 庫

在具體的介紹之前，這裡首先需要明確的一點是，我們總是先設定 Libevent，然後才去使用 Libevent。

關於輸出日誌的設定

Libevent 的日誌資訊預設被寫入 stderr（標準錯誤），我們可以提供自己的日誌處理函式給 Libevent：

1. // 日誌的型別
2. #define EVENT_LOG_DEBUG 0
3. #define EVENT_LOG_MSG 1
4. #define EVENT_LOG_WARN 2
5. #define EVENT_LOG_ERR 3
6. // 日誌處理函式原型
7. // severity 引數對應了上面的各種日誌型別
8. typedefvoid(*event_log_cb)(int severity,constchar*msg);
9. // 設定一個新的日誌處理函式
10. void event_set_log_callback(event_log_cb cb);

設定日誌處理函式的範例：

1. #include<event2/event.h>
2. #include<stdio.h>
3. staticvoid discard_cb(int severity,constchar*msg)
4. {
5. // 此函式不做任何事情
6. }
7. static FILE *logfile = NULL;
8. staticvoid write_to_file_cb(int severity,constchar*msg)
9. {
10. constchar*s;
11. if(!logfile)
12. return;
13. switch(severity){
14. case _EVENT_LOG_DEBUG: s ="debug";break;
15. case _EVENT_LOG_MSG: s ="msg";break;
16. case _EVENT_LOG_WARN: s ="warn";break;
17. case _EVENT_LOG_ERR: s ="error";break;
18. default: s ="?";break;/* never reached */
19. }
20. fprintf(logfile,"[%s] %s\n", s, msg);
21. }
22. // 關閉 Libevent 的日誌資訊的輸出
23. void suppress_logging(void)
24. {
25. event_set_log_callback(discard_cb);
26. }
27. // 設定 Libevent 的日誌資訊輸出到特定檔案
28. void set_logfile(FILE *f)
29. {
30. logfile = f;
31. event_set_log_callback(write_to_file_cb);
32. }

關於日誌的注意事項：

1. 日誌處理函式中不要呼叫任何的 Libevent 函式
2. Debug 日誌資訊預設不會被輸出，一般也不需要

Libevent 處理致命錯誤的做法是呼叫 exit() 或者 abort() 函式，你可以修改此行為（例如，你希望此時輸出呼叫棧資訊）：

1. typedefvoid(*event_fatal_cb)(int err);
2. void event_set_fatal_callback(event_fatal_cb cb);

注意事項：

1. 我們定義的 event_fatal_cb 函式不要將控制權再返回給 Libevent
2. 不要在 event_fatal_cb 函式中呼叫任何的 Libevent 函式

為 Libevent 定義自己的記憶體管理器

預設的情況下 Libevent 使用 C 庫的記憶體管理函式從堆上分配記憶體。替換 Libevent 預設記憶體管理函式主要有以下幾個目的：

1. 更加高效的分配記憶體
2. 檢測記憶體洩漏

設定自己定義的記憶體管理函式：

1. void event_set_mem_functions(void*(*malloc_fn)(size_t sz),
2. void*(*realloc_fn)(void*ptr,size_t sz),
3. void(*free_fn)(void*ptr));

替換 Libevent 記憶體管理函式時需要注意的地方：

1. 正如前面說到的，所有設定應該在 Libevent 被使用之前完成，對於記憶體管理的配置來說更加是如此，否則可能引起崩潰
2. 你設定的記憶體管理函式必須是執行緒安全的
3. 你設定的 malloc 和 realloc 返回的記憶體地址的對齊需要和 C 庫一致
4. 你設定的 realloc 需要能夠處理 realloc(NULL, sz)
5. 你設定的 realloc 需要能夠處理 realloc(ptr, 0)

關閉和清理

我們關閉程式的時候，需要完成一些清理工作：

1. void libevent_global_shutdown(void);

此函式在 2.1.1-alpha 才被引入。

Libevent 多執行緒的問題

如果你希望 Libevent 函式分配的結構能夠被多個執行緒共享，那麼首先需要告知 Libevent 我們使用的鎖定函式。如果使用 pthreads 庫或者使用 Windows 執行緒，可以呼叫以下函式來進行設定：

1. // 這兩個函式成功返回 0 失敗返回 -1
2. #ifdef WIN32
3. int evthread_use_windows_threads(void);
4. #define EVTHREAD_USE_WINDOWS_THREADS_IMPLEMENTED
5. #endif
6. #ifdef _EVENT_HAVE_PTHREADS
7. int evthread_use_pthreads(void);
8. #define EVTHREAD_USE_PTHREADS_IMPLEMENTED
9. #endif

void evthread_enable_lock_debuging(void) 函式可以讓 Libevent 通過 assert 告知我們關於鎖的一些錯誤資訊，主要是告知我們解鎖了一個未持有的鎖。我們需要在任意一個鎖被建立或使用之前呼叫此函式。

void event_enable_debug_mode(void) 函式可以讓 Libevent 檢測 event 使用上的一些錯誤：

1. 認為一個未初始化的 event 已經初始化了
2. 嘗試重新初始化一個 pending event（pending event 為一個術語，之後的文章會談到）

注意的是，開啟 debug 模式（也就是呼叫 event_enable_debug_mode）後，會有額外的記憶體和 CPU 開銷，所以應該在真正除錯的時候再開啟。event_enable_debug_mode 函式需要在任意的 event_base 被建立前呼叫。