Sun Oracle Crypto Accelerator 6000 Board, User Manual, Page: 144 / 266

122 Sun Crypto Accelerator 6000 Board User’s Guide for Version 1.1 • February 2013
Library Open Function
fs_lib_open()
Financial services applications must issue the
fs_lib_open()
function to initialize
the financial services library. This function locates the desired PKCS#11 provider and
verifies that it supports the financial services mechanism. The
fs_lib_open()
function returns a handle that must be used in subsequent financial services library
calls.
The syntax for the
fs_lib_open()
function is as follows:
TABLE 5-1
lists the parameters for the
fs_ lib_open ()
function.
TABLE 5-2
lists the return values for the
fs_
lib_open
()
function.
Library Shutdown Function
fs_lib_close()
Applications can close the financial services library services when the services are no
longer required.
fsLibHandle_t fs_lib_open(char *tokenName, fsReturn_t *err)
TABLE 5-1
fs_lib_open()
Function Parameters
Parameter Description
tokenName
Name of the desired token
err
Error value
TABLE 5-2
fs_lib_open()
Function Return Values
Return Value Description
fsOK
Successfully initialized, desired token found, and support for
financial services verified
fsNotFound
Token not found
NULL
Error occured
Non-NULL
Valid library handle returned when successfully initialized
err err
is set as follows:
•
fsOK
– Successfully initialized, the desired token found,
and support for financial services verified
•
fsNotFound
– Token not found
•
fsError
– Unable to initialize libary