Libmd
=====

Message Digest functions from BSD systems

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

Overview
--------

`Libmd <https://www.hadrons.org/software/libmd/>`_ provides message digest functions from BSD systems, including:

* MD2, MD4, MD5
* RIPEMD-160
* SHA-1, SHA-2 (SHA-256, SHA-384, SHA-512)

.. note::
    We provide Libmd installation that backs the libbsd library. Libmd and libbsd together support the building the dependency tree required for running ZeroMQ.

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

To view available libmd versions::

    $ module avail libmd

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

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

Linking your code against libmd installation
--------------------------------------------

When compiling programming code that uses libmd through its API, load the appropriate module and link with ``-lmd``::

    $ module load libmd/<version>
    $ <compiler or linker> <flags> <source_files or object files> -lmd

.. note:: Both dynamic and static linking are supported.

Replacing the system-wide libmd installation
--------------------------------------------

Currently, we do not support system-wide libmd installation on Discoverer and Discoverer+ clusters. But just in case we need to do that, here is an explanation about how to replace the system-wide libmd installation with our optimized installation that lives in the software repository::

    $ module load libmd/<version>
    $ ./your_program   # will automatically use libmd.so from libmd installation


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

For additional assistance:

* See the :doc:`help` documentation