pips_load_provider()

Updated: April 19, 2023

Dynamically load a provider implementation

Synopsis:

#include <pips/pips.h>
int pips_load_provider(const char *const dll)

Arguments:

dll
The name of a DLL module containing a provider implementation. The name is a file path that's relative to the directory specified by the -rpath option to ld, or one of the directories given in LD_LIBRARY_PATH.

Library:

pips-client

Description:

This function opens the specified DLL module and loads the provider implementation defined therein. If the provider is successfully loaded, it's registered with the PiPS framework, making it available to clients.

Returns:

EOK
The provider was loaded and registered successfully
-1
An error occurred (errno is set)

Errors:

  • EINVAL: The DLL name is invalid.
  • ENODEV: The provider defined in the DLL is invalid.