#include <vmtoolsApp.h>
Data Fields | |
const gchar * | name |
ToolsAppType | regType |
size_t | regSize |
void(* | activate )(ToolsAppCtx *ctx, struct ToolsAppProvider *prov, GError **err) |
void(* | registerApp )(ToolsAppCtx *ctx, struct ToolsAppProvider *prov, gpointer reg) |
void(* | shutdown )(ToolsAppCtx *ctx, struct ToolsAppProvider *prov) |
void(* | dumpState )(ToolsAppCtx *ctx, struct ToolsAppProvider *prov, gpointer reg) |
Application providers will be loaded during startup but not activated until at least one plugin provides registration data for that provider.
const gchar* ToolsAppProvider::name |
A name describing the provider.
Application type. Optimally, new providers would request a new type to be added to the "official" ToolsAppType enum declared above, although that is not strictly necessary. Providers should at least try to choose an unused value.
size_t ToolsAppProvider::regSize |
Size of the registration structure for this provider.
void(* ToolsAppProvider::activate)(ToolsAppCtx *ctx, struct ToolsAppProvider *prov, GError **err) |
Activation callback (optional). This is called when vmtoolsd detects that there is at least one application that needs to be registered with this provider.
[in] | ctx | The application context. |
[in] | prov | The provider instance. |
[out] | err | Where to store any error information. |
void(* ToolsAppProvider::registerApp)(ToolsAppCtx *ctx, struct ToolsAppProvider *prov, gpointer reg) |
Registration callback. This is called after "activate", to register an application provided by a plugin.
[in] | ctx | The application context. |
[in] | prov | The provider instance. |
[in] | reg | The application registration data. |
void(* ToolsAppProvider::shutdown)(ToolsAppCtx *ctx, struct ToolsAppProvider *prov) |
Shutdown callback (optional). Called when the service is being shut down. The provider is responsible for keeping track of registrations and cleaning them up during shutdown.
[in] | ctx | The application context. |
[in] | prov | The provider instance. |
void(* ToolsAppProvider::dumpState)(ToolsAppCtx *ctx, struct ToolsAppProvider *prov, gpointer reg) |
Debugging callback (optional). This callback is called when dumping the service state to the logs for debugging purposes.
This callback is called once with a "NULL" reg, so that the provider can log its internal state, and then once for each registration struct provided by loaded plugins.
[in] | ctx | The application context. |
[in] | prov | The provider instance. |
[in] | reg | The application registration data. |