12        #include <security/pkcs11.h>
  13 
  14        CK_RV SUNW_C_GetMechSession(CK_MECHANISM_TYPE mech,
  15             CK_SESSION_HANDLE_PTR hSession);
  16 
  17 
  18        CK_RV SUNW_C_KeyToObject(CK_SESSION_HANDLE hSession,
  19             CK_MECHANISM_TYPE mech, const void *rawkey, size_t rawkey_len,
  20             CK_OBJECT_HANDLE_PTR obj);
  21 
  22 
  23 DESCRIPTION
  24        These functions implement the RSA PKCS#11 v2.20 specification by using
  25        plug-ins to provide the slots.
  26 
  27 
  28        The SUNW_C_GetMechSession() function initializes the PKCS#11
  29        cryptographic framework and performs all necessary calls to Standard
  30        PKCS#11 functions (see libpkcs11(3LIB)) to create a session capable of
  31        providing operations on the requested mechanism. It is not necessary to
  32        call C_Initalize() or C_GetSlotList() before the first call to
  33        SUNW_C_GetMechSession().
  34 
  35 
  36        If the SUNW_C_GetMechSession() function is called multiple times, it
  37        will return a new session each time without re-initalizing the
  38        framework. If it is unable to return a new session, CKR_SESSION_COUNT
  39        is returned.
  40 
  41 
  42        The C_CloseSession() function should be called to release the session
  43        when it is no longer required.
  44 
  45 
  46        The SUNW_C_KeyToObject() function creates a key object for the
  47        specified mechanism from the rawkey data. The object should be
  48        destroyed with C_DestroyObject() when it is no longer required.
  49 
  50 RETURN VALUES
  51        The SUNW_C_GetMechSession() function returns the following values:
  52 
  53        CKR_OK
  54                                 The function completed successfully.
  55 
  56 
  57        CKR_SESSION_COUNT

 117 
 118 
 119 
 120 
 121        +--------------------+-----------------+
 122        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 123        +--------------------+-----------------+
 124        |Interface Stability | Evolving        |
 125        +--------------------+-----------------+
 126        |MT-Level            | MT-Safe         |
 127        +--------------------+-----------------+
 128 
 129 SEE ALSO
 130        libpkcs11(3LIB), attributes(5)
 131 
 132 
 133        http://www.rsasecurity.com
 134 
 135 
 136 
 137                                  April 9, 2016     SUNW_C_GETMECHSESSION(3EXT)

  12        #include <security/pkcs11.h>
  13 
  14        CK_RV SUNW_C_GetMechSession(CK_MECHANISM_TYPE mech,
  15             CK_SESSION_HANDLE_PTR hSession);
  16 
  17 
  18        CK_RV SUNW_C_KeyToObject(CK_SESSION_HANDLE hSession,
  19             CK_MECHANISM_TYPE mech, const void *rawkey, size_t rawkey_len,
  20             CK_OBJECT_HANDLE_PTR obj);
  21 
  22 
  23 DESCRIPTION
  24        These functions implement the RSA PKCS#11 v2.20 specification by using
  25        plug-ins to provide the slots.
  26 
  27 
  28        The SUNW_C_GetMechSession() function initializes the PKCS#11
  29        cryptographic framework and performs all necessary calls to Standard
  30        PKCS#11 functions (see libpkcs11(3LIB)) to create a session capable of
  31        providing operations on the requested mechanism. It is not necessary to
  32        call C_Initialize() or C_GetSlotList() before the first call to
  33        SUNW_C_GetMechSession().
  34 
  35 
  36        If the SUNW_C_GetMechSession() function is called multiple times, it
  37        will return a new session each time without re-initializing the
  38        framework. If it is unable to return a new session, CKR_SESSION_COUNT
  39        is returned.
  40 
  41 
  42        The C_CloseSession() function should be called to release the session
  43        when it is no longer required.
  44 
  45 
  46        The SUNW_C_KeyToObject() function creates a key object for the
  47        specified mechanism from the rawkey data. The object should be
  48        destroyed with C_DestroyObject() when it is no longer required.
  49 
  50 RETURN VALUES
  51        The SUNW_C_GetMechSession() function returns the following values:
  52 
  53        CKR_OK
  54                                 The function completed successfully.
  55 
  56 
  57        CKR_SESSION_COUNT

 117 
 118 
 119 
 120 
 121        +--------------------+-----------------+
 122        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 123        +--------------------+-----------------+
 124        |Interface Stability | Evolving        |
 125        +--------------------+-----------------+
 126        |MT-Level            | MT-Safe         |
 127        +--------------------+-----------------+
 128 
 129 SEE ALSO
 130        libpkcs11(3LIB), attributes(5)
 131 
 132 
 133        http://www.rsasecurity.com
 134 
 135 
 136 
 137                                 August 27, 2019    SUNW_C_GETMECHSESSION(3EXT)