SUNW_C_GetMechSession, SUNW_C_KeyToObject - PKCS#11 Cryptographic Framework functions
cc [ flag … ] file… –lpkcs11 [ library… ]
#include <security/cryptoki.h>
#include <security/pkcs11.h>
CK_RV SUNW_C_GetMechSession(CK_MECHANISM_TYPE mech,
CK_SESSION_HANDLE_PTR hSession);
CK_RV SUNW_C_KeyToObject(CK_SESSION_HANDLE hSession,
CK_MECHANISM_TYPE mech, const void *rawkey,
size_t rawkey_len, CK_OBJECT_HANDLE_PTR obj);
These functions implement the OASIS PKCS#11 v2.40 specification by using plug-ins to provide the slots.
The SUNW_C_GetMechSession() function initializes the PKCS#11 cryptographic framework and performs all necessary calls to Standard PKCS#11 functions (see libpkcs11(3LIB)) to create a session capable of providing operations on the requested mechanism. It is not necessary to call C_Initialize() or C_GetSlotList() before the first call to SUNW_C_GetMechSession().
If the SUNW_C_GetMechSession() function is called multiple times, it will return a new session each time without re-initializing the framework. If it is unable to return a new session, CKR_SESSION_COUNT is returned.
The C_CloseSession() function should be called to release the session when it is no longer required.
The SUNW_C_KeyToObject() function creates a key object for the specified mechanism from the rawkey data. The object should be destroyed with C_DestroyObject() when it is no longer required.
The SUNW_C_GetMechSession() function returns the following values:
The function completed successfully.
No sessions are available.
A null pointer was passed for the return session handle.
The requested mechanism is invalid or no available plug-in provider supports it.
The function failed.
A general error occurred.
The SUNW_C_KeyToObject() function returns the following values:
The function completed successfully.
A null pointer was passed for the session handle or the key material.
The requested mechanism is invalid or no available plug-in provider supports it.
The function failed.
A general error occurred.
The return values of each of the implemented functions are defined and listed in the OASIS PKCS#11 v2.40 specification. See https://www.oasis-open.org/committees/pkcs11/ .
These functions are not part of the OASIS PKCS#11 v2.40 specification. They are not likely to exist on non-Solaris systems. They are provided as a convenience to application programmers. Use of these functions will make the application non-portable to other systems.
See attributes(7) for descriptions of the following attributes:
|