12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667 |
- #ifndef _PCILIB_PLUGIN_H
- #define _PCILIB_PLUGIN_H
- #ifdef __cplusplus
- extern "C" {
- #endif
- /**
- * Loads the specified plugin
- * The plugin symbols are loaded localy and not available for symbol resolution, but should be requested
- * with pcilib_plugin_get_symbol() instead.
- * @param[in] name - the plugin name (with extension, but without path)
- * @return - dlopen'ed plugin or NULL in the case of error
- */
- void *pcilib_plugin_load(const char *name);
- /**
- * Cleans up the loaded plugin
- * @param[in] plug - plugin loaded with pcilib_plugin_load()
- */
- void pcilib_plugin_close(void *plug);
- /**
- * Resolves the specified symbol in the plugin
- * @param[in] plug - plugin loaded with pcilib_plugin_load()
- * @param[in] symbol - name of the symbol
- * @return - pointer to the symbol or NULL if not found
- */
- void *pcilib_plugin_get_symbol(void *plug, const char *symbol);
- /**
- * Verifies if plugin can handle the hardware and requests appropriate model description
- * @param[in,out] ctx - pcilib context
- * @param[in] plug - plugin loaded with pcilib_plugin_load()
- * @param[in] vendor_id - Vendor ID reported by hardware
- * @param[in] device_id - Device ID reported by hardware
- * @param[in] model - the requested pcilib model or NULL for autodetction
- * @return - the appropriate model description or NULL if the plugin does not handle the installed hardware or requested model
- */
- const pcilib_model_description_t *pcilib_get_plugin_model(pcilib_t *ctx, void *plug, unsigned short vendor_id, unsigned short device_id, const char *model);
- /**
- * Finds the appropriate plugin and returns model description.
- *
- * The function sequentially loads plugins available in ::PCILIB_PLUGIN_DIR and
- * checks if they support the installed hardware and requested model. If hardware
- * is not supported, the plugin is immideately unloaded. On a first success
- * the model description is returned to caller and no further plguins are loaded.
- * If no suitable plugin is found, the NULL is returned.
- *
- * If model is specified, first a plugin with the same name is loaded and check performed
- * if it can handle the installed hardware. If not, we iterate over all available
- * plugins as usual.
- *
- * @param[in,out] ctx - pcilib context
- * @param[in] vendor_id - Vendor ID reported by hardware
- * @param[in] device_id - Device ID reported by hardware
- * @param[in] model - the requested pcilib model or NULL for autodetction
- * @return - the appropriate model description or NULL if no plugin found able to handle the installed hardware or requested model
- */
- const pcilib_model_description_t *pcilib_find_plugin_model(pcilib_t *ctx, unsigned short vendor_id, unsigned short device_id, const char *model);
- #ifdef __cplusplus
- }
- #endif
- #endif /* _PCILIB_PLUGIN_H */
|