SoapySDR  0.4.4-gdb459f4f
Vendor and platform neutral SDR interface library
Functions
Modules.h File Reference
#include <SoapySDR/Config.h>
#include <SoapySDR/Types.h>
#include <stddef.h>

Go to the source code of this file.

Functions

SOAPY_SDR_API const char * SoapySDR_getRootPath (void)
 Query the root installation path. More...
 
SOAPY_SDR_API char ** SoapySDR_listModules (size_t *length)
 
SOAPY_SDR_API char ** SoapySDR_listModulesPath (const char *path, size_t *length)
 
SOAPY_SDR_API char * SoapySDR_loadModule (const char *path)
 
SOAPY_SDR_API SoapySDRKwargs SoapySDR_getLoaderResult (const char *path)
 
SOAPY_SDR_API char * SoapySDR_unloadModule (const char *path)
 
SOAPY_SDR_API void SoapySDR_loadModules (void)
 

Detailed Description

Utility functions to deal with modules. These utility functions are made available for advanced usage. For most use cases, the API will automatically load modules.

Function Documentation

SOAPY_SDR_API SoapySDRKwargs SoapySDR_getLoaderResult ( const char *  path)

List all registration loader errors for a given module path. The resulting dictionary contains all registry entry names provided by the specified module. The value of each entry is an error message string or empty on successful load.

Parameters
paththe path to a specific module file
Returns
a dictionary of registry names to error messages
SOAPY_SDR_API const char* SoapySDR_getRootPath ( void  )

Query the root installation path.

SOAPY_SDR_API char** SoapySDR_listModules ( size_t *  length)

List all modules found in default path. The result is an array of strings owned by the caller.

Parameters
[out]lengththe number of elements in the result.
Returns
a list of file paths to loadable modules
SOAPY_SDR_API char** SoapySDR_listModulesPath ( const char *  path,
size_t *  length 
)

List all modules found in the given path. The result is an array of strings owned by the caller.

Parameters
patha directory on the system
[out]lengththe number of elements in the result.
Returns
a list of file paths to loadable modules
SOAPY_SDR_API char* SoapySDR_loadModule ( const char *  path)

Load a single module given its file system path. The caller must free the result error string.

Parameters
paththe path to a specific module file
returnan error message, empty on success
SOAPY_SDR_API void SoapySDR_loadModules ( void  )

Load the support modules installed on this system. This call will only actually perform the load once. Subsequent calls are a NOP.

SOAPY_SDR_API char* SoapySDR_unloadModule ( const char *  path)

Unload a module that was loaded with loadModule(). The caller must free the result error string.

Parameters
paththe path to a specific module file
returnan error message, empty on success