Libevent
========

.. toctree::
   :maxdepth: 1
   :caption: Contents:

About
-----

Libevent is a library for event-driven programming, providing a platform-independent interface for handling various types of events, including I/O, timers, and signals. It is widely used in various applications, including networking, system monitoring, and event-driven programming. For more information, visit the `official Libevent website <https://libevent.org/>`_.

On Discoverer, the Libevent library is used to support the building of the ZeroMQ and other important libraries. It also supports the external packages compiled with LAMMPS and other important scientific applications. Even if the Linux distribution we use on the compute nodes of Discoverer comes with its own version of libevent, we regularly build the most recent version of the library to support the building and running of numerous packages.

Available versions
------------------

To view available Libevent versions::

    $ module avail libevent

Build recipes and configuration details are maintained in our GitLab repository:

* `Build Recipes <https://gitlab.discoverer.bg/vkolev/recipes/-/tree/main/libevent>`_


Access to the Libevent library
------------------------------

To access the latest version of the Libevent library, load the module without specifying the version:

.. code:: bash

    $ module load libevent


In case you need to access a specific version of the Libevent library, you can specify the version:

.. code:: bash 

    $ module load libevent/<version>


Compiler support
----------------

We use the recent :doc:`llvm` to build the Libevent library code. We do not support any other compilers for that purpose. The `LLVM.org <https://llvm.org/>`_ compilers are the default compilers on Discoverer Petascale Supercomputer. Since the code of the library includes both C and C++ components, the compiled binaries are compatible with various programming environments.

Getting Help
------------

For additional assistance:

* See the :doc:`help` documentation