C_GetSlotInfo

Synopsis

C_GetSlotInfo(
        CK_SLOT_ID slotID,
        CK_SLOT_INFO_PTR pInfo
); 

Description

This function operates as specified in PKCS#11.

The information returned will vary depending on the SafeNet ProtectToolkit-C runtime in use as well as the actual slot type, for example, if it is a SafeNet ProtectToolkit-C user slot or a Smart Card slot.

This information is returned in the CK_SLOT_INFO structure.

SlotDescription

“ProtectServer :xxxx, “Safenet Software Only.” or smart card reader type.*

Where xxxx is the slot serialnumber

ManufacturerID

"SafeNet, Inc.” or smart card reader manufacturer.

Flags

CKF_HW_SLOT (hardware only), CKF_REMOVABLE_DEVICE (smart card slots only).

HardwareVersion

Current hardware revision or 0.0 for software only.

FirmwareVersion

Current firmware version or 0.0 for software only.

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_SLOT_INFO structure:

SlotDescription

The slot description 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_SLOT bit is set to indicate that it is a WLD Slot.

If there are no HSM Tokens available for the particular slot, then the CKF_TOKEN_PRESENT bit in is set to 0.1

1 This breaks PKCS#11 compliance, as this bit should be set to 0 if and only if CKF_REMOVABLE_DEVICE is set. The CKF_REMOVABLE_DEVICE bit is set only for Smart card Slots in the SafeNet implementation.