獲取libevent libevent官網:https://libevent.org/ GitHub-libevent項目鏈接:https://github.com/libevent/libevent 要獲取libevent源碼包,可以在上面兩個網址鏈接上獲取到。本人下載的是libevent-2.1 ...
獲取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庫來進行應用程式的開發工作了。