/usr/include/SoapySDR/Modules.h is in libsoapysdr-dev 0.6.1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 | ///
/// \file SoapySDR/Modules.h
///
/// 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.
///
/// \copyright
/// Copyright (c) 2014-2016 Josh Blum
/// SPDX-License-Identifier: BSL-1.0
///
#pragma once
#include <SoapySDR/Config.h>
#include <SoapySDR/Types.h>
#include <stddef.h> //size_t
#ifdef __cplusplus
extern "C" {
#endif
//! Query the root installation path
SOAPY_SDR_API const char *SoapySDR_getRootPath(void);
/*!
* The list of paths automatically searched by loadModules().
* \param [out] length the number of elements in the result.
* \return a list of automatically searched file paths
*/
SOAPY_SDR_API char **SoapySDR_listSearchPaths(size_t *length);
/*!
* List all modules found in default path.
* The result is an array of strings owned by the caller.
* \param [out] length the number of elements in the result.
* \return a list of file paths to loadable modules
*/
SOAPY_SDR_API char **SoapySDR_listModules(size_t *length);
/*!
* List all modules found in the given path.
* The result is an array of strings owned by the caller.
* \param path a directory on the system
* \param [out] length the number of elements in the result.
* \return a list of file paths to loadable modules
*/
SOAPY_SDR_API char **SoapySDR_listModulesPath(const char *path, size_t *length);
/*!
* Load a single module given its file system path.
* The caller must free the result error string.
* \param path the path to a specific module file
* \return an error message, empty on success
*/
SOAPY_SDR_API char *SoapySDR_loadModule(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.
* \param path the path to a specific module file
* \return a dictionary of registry names to error messages
*/
SOAPY_SDR_API SoapySDRKwargs SoapySDR_getLoaderResult(const char *path);
/*!
* Unload a module that was loaded with loadModule().
* The caller must free the result error string.
* \param path the path to a specific module file
* \return an error message, empty on success
*/
SOAPY_SDR_API char *SoapySDR_unloadModule(const char *path);
/*!
* 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 void SoapySDR_loadModules(void);
#ifdef __cplusplus
}
#endif
|