Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sunw_c_getmechsession(3ext) [opensolaris man page]

SUNW_C_GetMechSession(3EXT)				    Extended Library Functions				       SUNW_C_GetMechSession(3EXT)

NAME
SUNW_C_GetMechSession, SUNW_C_KeyToObject - PKCS#11 Cryptographic Framework functions SYNOPSIS
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); DESCRIPTION
These functions implement the RSA PKCS#11 v2.20 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 neccessary to call C_Initalize() 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-initalizing the frame- work. 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. RETURN VALUES
The SUNW_C_GetMechSession() function returns the following values: CKR_OK The function completed successfully. CKR_SESSION_COUNT No sessions are available. CKR_ARGUMENTS_BAD A null pointer was passed for the return session handle. CKR_MECHANISM_INVALID The requested mechanism is invalid or no available plug-in provider supports it. CKR_FUNCTION_FAILED The function failed. CKR_GENERAL_ERROR A general error occurred. The SUNW_C_KeyToObject() function returns the following values: CKR_OK The function completed successfully. CKR_ARGUMENTS_BAD A null pointer was passed for the session handle or the key material. CKR_MECHANISM_INVALID The requested mechanism is invalid or no available plug-in provider supports it. CKR_FUNCTION_FAILED The function failed. CKR_GENERAL_ERROR A general error occurred. The return values of each of the implemented functions are defined and listed in the RSA PKCS#11 v2.20 specification. See http://www.rsase- curity.com. USAGE
These functions are not part of the RSA PKCS#11 v2.20 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. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
libpkcs11(3LIB), attributes(5) http://www.rsasecurity.com SunOS 5.11 27 Oct 2005 SUNW_C_GetMechSession(3EXT)

Check Out this Related Man Page

SUNW_C_GetMechSession(3EXT)											       SUNW_C_GetMechSession(3EXT)

NAME
SUNW_C_GetMechSession, SUNW_C_KeyToObject - PKCS#11 Cryptographic Framework functions SYNOPSIS
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 RSA PKCS#11 v2.11 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 neccessary to call C_Initalize() 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-initalizing the frame- work. 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: CKR_OK The function completed successfully. CKR_SESSION_COUNT No sessions are available. CKR_ARGUMENTS_BAD A null pointer was passed for the return session handle. CKR_MECHANISM_INVALID The requested mechanism is invalid or no available plug-in provider supports it. CKR_FUNCTION_FAILED The function failed. CKR_GENERAL_ERROR A general error occurred. The SUNW_C_KeyToObject() function returns the following values: CKR_OK The function completed successfully. CKR_ARGUMENTS_BAD A null pointer was passed for the session handle or the key material. CKR_MECHANISM_INVALID The requested mechanism is invalid or no available plug-in provider supports it. CKR_FUNCTION_FAILED The function failed. CKR_GENERAL_ERROR A general error occurred. The return values of each of the implemented functions are defined and listed in the RSA PKCS#11 v2.11 specification. See http://www.rsase- curity.com/rsalabs/pkcs/pkcs-11. These functions are not part of the RSA PKCS#11 v2.11 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(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ libpkcs11(3LIB), attributes(5) http://www.rsasecurity.com/rsalabs/pkcs/pkcs-11 26 Apr 2005 SUNW_C_GetMechSession(3EXT)
Man Page