RefreshFunctionTable(3)RefreshFunctionTable(3)NAMERefreshFunctionTable - Gets EMM-defined API function (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
CSSM_RETURN CSSMAPI RefreshFunctionTable (CSSM_FUNC_NAME_ADDR_PTR Func‐
NameAddrPtr, uint32 NumOfFuncNameAddr)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
A pointer to a table mapping function names to EMM-defined APIs. The
number of entries in the table referenced by FuncNameAddrPtr.
DESCRIPTION
CSSM invokes this function to obtain the EMM-defined API function. The
table is returned to CSSM in FuncNameAddrPtr and CSSM returns the table
to the application. The application uses this table to invoke the secu‐
rity services defined by the EMM's service category. CSSM must obtain
and forward the API table to the application on behalf of the EMM
because the application is not aware of the optional nature of the EMM.
Applications use CSSM to obtain the API function table for basic module
managers and elective module managers, providing a uniform application
programming model.
If the Elective Module Manager needs the service provider's SPI func‐
tion table in order to initialize the API function table, the EMM can
obtain the SPI function table by invoking the CSSM-provided service
cssm_GetAttachFunctions(). The service module may implement only a sub‐
set of the defined functions and the EMM may wish to manage these func‐
tions in a particular manner through the API mapping. The elective mod‐
ule manager uses the SPI function table to dispatch application calls
for service to attached modules.
Multiple applications and multiple instances of a service module can be
concurrently active. The single elective module manager is responsible
for managing all of these concurrent sessions. After completing ini‐
tialization of the API function table, the EMM returns the refreshed
API table to CSSM.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3).
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
RefreshFunctionTable(3)