Beyond Linux® From Scratch (System V Edition) - Version r12.4-426

Chapter 17. Networking Libraries

libevent-2.1.12

Introduction to libevent

libevent is an asynchronous event notification software library. The libevent API provides a mechanism to execute a callback function when a specific event occurs on a file descriptor or after a timeout has been reached. Furthermore, libevent also supports callbacks due to signals or regular timeouts.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

libevent Dependencies

Optional

Doxygen-1.15.0 (for API documentation)

Installation of libevent

First, fix an issue that prevents event_rpcgen.py from working: 

sed -i 's/python/&3/' event_rpcgen.py

Install libevent by running the following commands: 

./configure --prefix=/usr --disable-static &&
make

If you have Doxygen-1.15.0 installed and wish to build API documentation, issue : 

doxygen Doxyfile

To test the results, issue: make verify. Six tests in every suite related to regress_ssl.c and regress_http.c are known to fail due to incompatibilities with OpenSSL-3. Some tests that are related to regress_dns.c are also known to fail intermittently due to insufficient test timeouts.

Now, as the root user: 

make install

If you built the API documentation, install it by issuing the following commands as the root user: 

install -v -m755 -d /usr/share/doc/libevent-2.1.12/api &&
cp      -v -R       doxygen/html/* \
                    /usr/share/doc/libevent-2.1.12/api

Command Explanations

--disable-static: This switch prevents installation of static versions of the libraries.

Contents

Installed Program: event_rpcgen.py
Installed Libraries: libevent_core.so, libevent_extra.so, libevent_openssl.so, libevent_pthreads.so and libevent.so
Installed Directory: /usr/include/event2 and /usr/share/doc/libevent-2.1.12