Common Components - Common Components - UG1586

Onload User Guide (UG1586)

Document ID
UG1586
Release Date
2026-01-22
Revision
1.4 English

For all applications employing the Extensions API the following components are provided:

  • #include <onload/extensions.h>

    An application should include the header file containing function prototypes and constant values required when using the API.

  • libonload_ext.a, libonload_ext.so

    This library provides stub implementations of the extended API. An application that wishes to use the extensions API should link against this library.

    When Onload is not present, the application will continue to function, but calls to the extensions API will have no effect (unless documented otherwise).

    • You are recommended to link against the libonload_ext.a static library if possible. When doing so, it is necessary to also link with the dynamic library by adding the -ldl option to the compiler command line.
      -ldl -l:libonload_ext.a
    • You can instead link dynamically to this library by including the -l linker option on the compiler command line:
      -lonload_ext