IMA_PluginIOCtl - Sends a vendor specific command to a specified plugin
cc [ flag... ] file... -lima [ library... ] #include <ima.h> IMA_STATUS IMA_PluginIOCtl( /* in */ IMA_OID pluginOid, /* in */ IMA_UINT command, /* in */ const void *pInputBuffer, /* in */ IMA_UINT inputBufferLength, /* out */ void *pOutputBuffer, /* in, out */ IMA_UINT *pOutputBufferLength, );
The object ID of the plugin to which the command is set.
The command to be sent to the plugin.
A pointer to a buffer allocated by the caller. The buffer contains the input parameters that the specified command needs. A value of NULL for this parameter indicates that there are no input parameters provided by the caller. In this case, the value of the inputBufferLength argument is also 0.
The length, in bytes, of the input buffer. The plugin does not attempt to read more data than is specified by the caller.
A pointer to a buffer allocated by the caller that contains any output of the specified command. A value of NULL for this parameter indicates that the caller expects to receive no output data from the plugin. In this case, the value of the pOutputBufferLength argument is also NULL.
A pointer to a value that, on entry, contains the length, in bytes, of the output buffer. If returned successfully, this value is the number of bytes returned in the pOutputBuffer argument. If this value is NULL, then both the pInputBuffer argument and the pOutputBuffer argument are NULL, and the inputBufferLength argument is 0.
The IMA_PluginIOCtl() API sends a vendor specific command to a specified plugin.
Returned if the plugin does not support this API call
Returned if the pInputBuffer argument is NULL, and the inputBufferLength argument is not 0
Returned if the pOutputBuffer argument is NULL, and the pInputBufferLength argument points to a value that is not 0
Returned if the pOutputBuffer argument is not NULL, and the pOutputBufferLength argument is NULL, or points to a value that is 0
Returned if the plugin does not support the specified command or if the input or output buffers, or the lengths of these buffers are not correct for the given command
Returned if the pluginOid argument does not specify a valid object type
Returned if the pluginOid argument does not specify a plugin object
Returned if the pluginOid argument does not specify a plugin known to the system
See attributes(7) for descriptions of the following attributes:
|
libima(3LIB), attributes(7), IMA_GetPluginOidList(3IMA), IMA_GetPluginProperties(3IMA)