sd-dlopen(3) — Linux manual page

SD-DLOPEN(3)                    sd-dlopen                    SD-DLOPEN(3)

NAME         top

       sd-dlopen - ELF dlopen metadata annotation macros

SYNOPSIS         top

       #include <systemd/sd-dlopen.h>

       pkg-config --cflags libsystemd

DESCRIPTION         top

       sd-dlopen.h provides macros for embedding .note.dlopen metadata in
       ELF binaries, implementing the ELF dlopen metadata[1]
       specification for declaring optional shared library dependencies
       that are loaded via dlopen(3) at runtime.

       The header is self-contained and does not require runtime linkage
       against libsystemd(3). Projects only need the installed header to
       use the macros.

       Package managers and build systems can read the embedded ELF notes
       to discover runtime dependencies that are not visible in ELF
       DT_NEEDED entries.

       See SD_ELF_NOTE_DLOPEN(3) for details on the available macros and
       constants.

NOTES         top

       The macros described here are header-only and do not require
       runtime linkage against libsystemd(3). Only the installed header
       and include path (as provided by pkg-config --cflags libsystemd)
       are needed.

HISTORY         top

       SD_ELF_NOTE_DLOPEN() and associated macros and constants were
       added in version 261.

SEE ALSO         top

       systemd(1), SD_ELF_NOTE_DLOPEN(3), dlopen(3)

NOTES         top

        1. ELF dlopen metadata
           https://uapi-group.org/specifications/specs/elf_dlopen_metadata/

COLOPHON         top

       This page is part of the systemd (systemd system and service
       manager) project.  Information about the project can be found at
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a
       bug report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2026-05-24.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2026-05-24.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

systemd 261~rc1                                              SD-DLOPEN(3)

Pages that refer to this page: SD_ELF_NOTE_DLOPEN(3),  systemd.directives(7),  systemd.index(7)

HTML rendering created 2026-05-24 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.