獲取libevent
libevent官網：https://libevent.org/
GitHub-libevent專案鏈接：https://github.com/libevent/libevent
要獲取libevent原始碼包，可以在上面兩個網址鏈接上獲取到，本人下載的是libevent-2.1.8-stable版本，原始碼包檔案名為：libevent-2.1.8-stable.tar.gz，
《注意》安裝需要有root權限，最好是在root用戶下進行，如果不是root用戶，執行編譯安裝操作時需要在命令前加上 sudo ，本人是在root用戶下進行操作的，
安裝步驟
一、解壓縮原始碼包，
tar -xzvf libevent-2.1.8-stable.tar.gz
二、進入libevent-2.1.8-stable目錄，執行 configure 配置腳本
1、查看configure 腳本的使用幫助及其選項，可以執行命令：./configure --help 查看，
如果直接執行：./configure，那么默認安裝路徑是/usr/local，對應的頭檔案、可執行檔案和庫檔案分別對應的目錄是：'/usr/local/include'、'/usr/local/bin'，'/usr/local/lib'，
2、我本人設定了自定義安裝路徑，執行命令如下：
./configure --prefix=/usr/local/libevent
3、第2步執行成功后，會生成Makefile檔案，然后使用make命令進行原始碼編譯，
make
4、編譯成功后，執行安裝命令，
make install
5、進入/usr/local目錄下，可以看到一個libevent目錄，查看下這個目錄的樹形結構，
[root@centos7 local]# tree -L 3 libevent/
libevent/
├── bin
│ └── event_rpcgen.py
├── include
│ ├── evdns.h
│ ├── event2
│ │ ├── buffer_compat.h
│ │ ├── bufferevent_compat.h
│ │ ├── bufferevent.h
│ │ ├── bufferevent_ssl.h
│ │ ├── bufferevent_struct.h
│ │ ├── buffer.h
│ │ ├── dns_compat.h
│ │ ├── dns.h
│ │ ├── dns_struct.h
│ │ ├── event_compat.h
│ │ ├── event-config.h
│ │ ├── event.h
│ │ ├── event_struct.h
│ │ ├── http_compat.h
│ │ ├── http.h
│ │ ├── http_struct.h
│ │ ├── keyvalq_struct.h
│ │ ├── listener.h
│ │ ├── rpc_compat.h
│ │ ├── rpc.h
│ │ ├── rpc_struct.h
│ │ ├── tag_compat.h
│ │ ├── tag.h
│ │ ├── thread.h
│ │ ├── util.h
│ │ └── visibility.h
│ ├── event.h
│ ├── evhttp.h
│ ├── evrpc.h
│ └── evutil.h
└── lib
├── libevent-2.1.so.6 -> libevent-2.1.so.6.0.2
├── libevent-2.1.so.6.0.2
├── libevent.a
├── libevent_core-2.1.so.6 -> libevent_core-2.1.so.6.0.2
├── libevent_core-2.1.so.6.0.2
├── libevent_core.a
├── libevent_core.la
├── libevent_core.so -> libevent_core-2.1.so.6.0.2
├── libevent_extra-2.1.so.6 -> libevent_extra-2.1.so.6.0.2
├── libevent_extra-2.1.so.6.0.2
├── libevent_extra.a
├── libevent_extra.la
├── libevent_extra.so -> libevent_extra-2.1.so.6.0.2
├── libevent.la
├── libevent_pthreads-2.1.so.6 -> libevent_pthreads-2.1.so.6.0.2
├── libevent_pthreads-2.1.so.6.0.2
├── libevent_pthreads.a
├── libevent_pthreads.la
├── libevent_pthreads.so -> libevent_pthreads-2.1.so.6.0.2
├── libevent.so -> libevent-2.1.so.6.0.2
└── pkgconfig
├── libevent_core.pc
├── libevent_extra.pc
├── libevent.pc
└── libevent_pthreads.pc
5 directories, 56 files
可以看到libevent目錄下有3個一級子目錄：bin/，include/ 和 lib，下面分別作簡要的介紹：
bin/：這個目錄下存放的是可執行檔案，可以看到是一個event_rpcgen.py腳本檔案，具體功能是什么目前還不清楚，
include/：這個目錄下存放的是libevent三方庫的頭檔案，它下面還有個子目錄：event2/，存放的是支持libevent-2.x版本的頭檔案，以示區別libevent-1.x版本，因為libevent-1.x版本和libevent-2.x版本的變化有點大，為了向下兼容低版本的libevent，所以添加了event2這個子目錄，當在程式中要用到libevent-2.x版本的某些頭檔案時，使用#include宏命令包含頭檔案的方式，舉例如下：
#include <event2/bufferevent.h>
#include <event2/buffer.h>
#include <event2/listener.h>
#include <event2/util.h>
#include <event2/event.h>
#include <event2/thread.h>
lib/：lib目錄存放的是libevent的庫檔案，包括靜態庫、動態庫檔案等檔案，lib目錄下還有一個子目錄pkgconfig/，該子目錄下的xxx.pc檔案用于pkg-config工具的使用，具體用法這里不作說明了，這個工具可以幫助程式的原始碼編譯作業，對應的環境變數是PKG_CONFIG_PATH，通過配置這個環境變數，在編譯的時候編譯器就可以找到所依賴的頭檔案和庫檔案，配置方法會在下面說明，pkgconfig目錄下有4個.pc檔案，這四個.pc檔案對應著4個libevent庫模塊，
libevent_core.pc # libevent核心模塊
libevent_extra.pc # libevent擴展模塊
libevent.pc # libevent基礎模塊
libevent_pthreads.pc # libevent多執行緒模塊
查看其中一個.pc檔案的內容，# more libevent_core.pc
#libevent pkg-config source file
prefix=/usr/local/libevent
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
Name: libevent_core
Description: libevent_core
Version: 2.1.8-stable
Requires:
Conflicts:
Libs: -L${libdir} -levent_core
Libs.private:
Cflags: -I${includedir}
至此，libevent-2.1.8三方庫安裝成功了，但是，要使用libevent庫進行應用程式的開發作業，還需要配置libevent三方庫的開發環境，
配置libevent的開發環境
這里，我只說明最常見的配置三方庫的使用環境，即通過配置相關環境變數的方式，具體方法是：在當前用戶的home目錄下的.bashrc 或者 .bash_profile組態檔中配置libevent庫的使用環境，本人是在 .bash_profile 檔案下配置相關環境變數的值的，
1、配置C語言頭檔案的搜索路徑，對應的環境變數是C_INCLUDE_PATH ，C++頭檔案的環境變數是CPLUS_INCLUDE_PATH，
]$ vim ~/.bash_profile #添加內容如下：
#Add C header file path
export C_INCLUDE_PATH=/usr/local/libevent/include:$C_INCLUDE_PATH
保存成功后，執行：source ~/.bash_profile，令修改生效，下同，查看C_INCLUDE_PATH 環境變數的值：echo $C_INCLUDE_PATH
2、配置庫檔案的搜索路徑，對應的環境變數是：LIBRARY_PATH、LD_LIBRARY_PATH，添加內容如下：
# Add third_lib path
export LD_LIBRARY_PATH=/usr/local/libevent/lib:$LD_LIBRARY_PATH
export LIBRARY_PATH=/usr/local/libevent/lib:$LIBRARY_PATH
可能有人要問了，為什么 LD_LIBRARY_PATH、LIBRARY_PATH 配置的值是一樣的，是不是多此一舉呢？這里我解釋一下，之前我在安裝ZeroMQ三方庫的時候，只配置了LD_LIBRARY_PATH這一個環境變數，但是在編譯的時候仍然報了錯誤，錯誤描述資訊如下：
/usr/bin/ld: cannot find -lzmq
collect2: error: ld returned 1 exit status
后來，我去技術問答網站尋求幫助，發現還需要配置 LIBRARY_PATH 這個環境變數，配置了這個環境變數之后，編譯就通過了，這兩個環境變數還是有所區別的，因此建議都加上，
3、嘗試編譯一個libevent程式，源檔案名為：libevent_version.c，原始碼如下：
#include <stdio.h>
#include <event.h>
int main()
{
printf("The current libevent version is %s\n",event_get_version());
return 0;
}
編譯命令： gcc libevent_version.c -o libevent_version -levent
運行結果：The current libevent version is 2.1.8-stable
<分析> 可以看到，編譯運行通過了，因此我們的libevent三方庫的使用環境設定是沒有問題的，
【參考】
環境變數：LIBRARY_PATH 和 LD_LIBRARY_PATH的區別
使用 pkg-config 方式配置三方庫的搜索路徑
在撰寫多檔案專案或者大型專案的軟體開發時，我們編譯整個專案一般都是通過撰寫Makefile檔案，使用make命令來編譯的，在GCC編譯階段需要包含#include宏指令指定的頭檔案，在鏈接階段又需要連接相應的庫檔案，由于頭檔案的搜索路徑和庫檔案的搜索路徑是相互獨立的，這就可能帶來一個問題：頭檔案搜索路徑下的頭檔案和庫檔案搜索路徑下的庫檔案可能不是對應同一個三方庫的版本，比如說，頭檔案搜索路徑下的頭檔案是libevent-1.14.14b版本的，而庫檔案搜索路徑下的庫檔案是libevent-2.1.8版本的，這就帶來了版本的不一致性了，在編譯的時候可能會報錯，或者說編譯可以通過，但是在程式運行時可能會出現意想不到的錯誤，這就比較嚴重了，并且你還不好查錯，
pkg-config工具正好可以解決上面遇到的編譯鏈接不統一的問題，它的作業原理這里我就不作說明了，下面具體說明如何配置和使用pkg-config工具，以libevent為例來說明，
1、要使用pkg-config工具來設定三方庫的搜索路徑，需要配置一個環境變數PKG_CONFIG_PATH，配置值是xxx.pc檔案的絕對路徑，
]$ vim ~/.bash_profile
#Add pkg-config path
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH
我這里使用的xxx.pc檔案的路徑是：/usr/local/lib/pkgconfig，這個路徑是可以自定義的，修改保存后，執行：source ~/.bash_profile，令修改生效，
2、上文中我們提到，libevent的安裝路徑下的bin/pkgconfig目錄下有4個.pc檔案，我們將這4個.pc檔案復制到配置路徑下，
]# cd /usr/local/libevent/lib/pkgconfig/;ls
libevent_core.pc libevent_extra.pc libevent.pc libevent_pthreads.pc
]# cp *.pc /usr/local/lib/pkgconfig
3、配置完成后，我們使用pkg-config 的方式來編譯一下libevent_version.c這個源程式，編譯命令如下：
gcc `pkg-config --cflags --libs libevent` libevent_version.c -o libevent_version
<說明> --cflags 引數，可以給出編譯時所需的頭檔案搜索路徑，--libs 引數，可以給出編譯時所需的庫檔案搜索路徑，libevent 對應的是 /usr/local/lib/pkgconfig目錄下的libevent.pc檔案，同時，可以注意到我們的編譯命令并沒有加 -levent 引數，但是加上也無妨，
<Tips> 建議在撰寫Makefile檔案中，使用 pkg-config 的方式來設定三方庫的開發環境，這樣可以減少和規避潛在的開發風險，
【參考】
簡述configure、pkg-config、pkg_config_path三者的關系
總結
至此，libevent-2.1.8三方庫的原始碼安裝和開發環境配置就完成了，接下來就可以使用libevent庫來進行應用程式的開發作業了，
轉載請註明出處，本文鏈接：https://www.uj5u.com/caozuo/63238.html
標籤：Linux