CentOS7.6 源碼安裝 libevent-2.1.8-stable


獲取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_PATHLD_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_PATHLIBRARY_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庫來進行應用程序的開發工作了。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM