C_GetTokenInfo

This function operates as specified in PKCS#11. The information returned will vary depending on the type of slot specified by the slotID parameter. This information is returned in the CK_TOKEN_INFO structure.

Label

This is the string specified by the user during the C_InitToken command, unless the token is the administration token, in which case the value is:

AdminToken(ssss)

Where ssss is the HSM serial number.

ManufacturerID "SafeNet, Inc.”
Model

“PSI-E2:PLxxx”

Where xxx is the performance level or smartcard manufacturer.

SerialNumber

“xxxx-xxxx”

Where the first field is the HSM serial number and the second field is a randomly assigned token serial  number or the smartcard serial number.

Flags CKF_RNG (for non-smart card slots only) + CKF_CLOCK_ON_TOKEN (if the module’s clock has been set) + CKF_DUAL_CRYPTO_OPERATIONS + Other flags based on the current state of the slot. CKF_LOGIN_REQUIRED flag is set if the security mode specifies “no public crypto”. Admin slot have CKF_ADMIN_TOKEN and CKF_LOGIN_REQUIRED set.
ulMaxSessionCount The value of that CKA_MAX_SESSIONS for the associated slot object.
ulSessionCount Determined at run time – this is the total number of session to this Token by all applications.
ulMaxRwSessionCount The value of that CKA_MAX_SESSIONS for the associated slot object.
ulRwSessionCount Determined at run time – this is the number of RW sessions the calling application has to the Token.
ulMaxPinLen CK_MAX_PIN_LEN = 32.
UlMinPinLength This is the value specified in the configuration as shown by the CKA_MIN_PIN attribute of the slot object.
UlTotalPublicMemory Determined at run time.
ulFreePublicMemory Determined at run time.
ulTotalPrivateMemory Determined at run time.
ulFreePrivateMemory Determined at run time.
hardwareVersion ‘G’.0 (or later)
FirmwareVersion 1.0 (or later)
UtcTime Current time is returned if the modules clock has been set (else ASCII zeros are returned).

Synopsis

C_GetTokenInfo(
        CK_SLOT_ID slotID,
        CK_TOKEN_INFO_PTR pInfo
); 

Operation in WLD Mode

When SafeNet ProtectToolkit is configured to operate in WLD mode, a random slot from the HSM Token List for the provided slot ID is chosen, so as not to overload a particular device and the command is forwarded to that slot. The following WLD specific information is returned in the CK_TOKEN_INFO structure:

SerialNumber The serial number specified for the virtual WLD Slot in environment variables ET_PTKC_WLD_SLOT_n. Refer to SafeNet ProtectToolkit-C Administration Manual for details.
Flags The CKF_WLD_TOKEN bit is set to indicate that it is a WLD Token.