Botan::PKCS11::Slot Class Reference

Represents a PKCS#11 Slot, i.e., a card reader. More...

#include <p11_slot.h>

Public Member Functions
MechanismInfo	get_mechanism_info (MechanismType mechanism_type) const
	Obtains information about a particular mechanism possibly supported by a slot (C_GetMechanismInfo) More...
std::vector< MechanismType >	get_mechanism_list () const
	Obtains a list of mechanism types supported by the slot (C_GetMechanismList) More...
SlotInfo	get_slot_info () const
TokenInfo	get_token_info () const
	Obtains information about a particular token in the system (C_GetTokenInfo) More...
void	initialize (const std::string &label, const secure_string &so_pin) const
Module &	module () const
	Slot (Module &module, SlotId slot_id)
SlotId	slot_id () const

Static Public Member Functions
static std::vector< SlotId >	get_available_slots (Module &module, bool token_present)

Detailed Description

Represents a PKCS#11 Slot, i.e., a card reader.

Definition at line 22 of file p11_slot.h.

Constructor & Destructor Documentation

Botan::PKCS11::Slot::Slot	(	Module &	module,
		SlotId	slot_id
	)

Parameters

module	the PKCS#11 module to use
slot_id	the slot id to use

Definition at line 15 of file p11_slot.cpp.

   : m_module(module), m_slot_id(slot_id)
   {}

Member Function Documentation

std::vector< SlotId > Botan::PKCS11::Slot::get_available_slots ( Module &  module, bool  token_present  )

static

Get available slots

Parameters

module	the module to use
token_present	true if only slots with attached tokens should be returned, false for all slots

Returns

a list of available slots (calls C_GetSlotList)

Definition at line 40 of file p11_slot.cpp.

References Botan::PKCS11::LowLevel::C_GetSlotList().

   {
   std::vector<SlotId> slot_vec;
   module->C_GetSlotList(token_present, slot_vec);
   return slot_vec;
   }

MechanismInfo Botan::PKCS11::Slot::get_mechanism_info

(

MechanismType

mechanism_type

)

const

Obtains information about a particular mechanism possibly supported by a slot (C_GetMechanismInfo)

Definition at line 33 of file p11_slot.cpp.

   {
   MechanismInfo mechanism_info = {};
   m_module.get()->C_GetMechanismInfo(m_slot_id, mechanism_type, &mechanism_info);
   return mechanism_info;
   }

std::vector< MechanismType > Botan::PKCS11::Slot::get_mechanism_list

(

)

const

Obtains a list of mechanism types supported by the slot (C_GetMechanismList)

Definition at line 26 of file p11_slot.cpp.

   {
   std::vector<MechanismType> mechanism_list;
   m_module.get()->C_GetMechanismList(m_slot_id, mechanism_list);
   return mechanism_list;
   }

SlotInfo Botan::PKCS11::Slot::get_slot_info

(

)

const

Returns

information about the slot (C_GetSlotInfo)

Definition at line 19 of file p11_slot.cpp.

   {
   SlotInfo slot_info = {};
   m_module.get()->C_GetSlotInfo(m_slot_id, &slot_info);
   return slot_info;
   }

TokenInfo Botan::PKCS11::Slot::get_token_info

(

)

const

Obtains information about a particular token in the system (C_GetTokenInfo)

Definition at line 47 of file p11_slot.cpp.

   {
   TokenInfo token_info;
   m_module.get()->C_GetTokenInfo(m_slot_id, &token_info);
   return token_info;
   }

void Botan::PKCS11::Slot::initialize	(	const std::string &	label,
		const secure_string &	so_pin
	)		const

Calls C_InitToken to initialize the token

Parameters

label	the label for the token (must not exceed 32 bytes according to PKCS#11)
so_pin	the PIN of the security officer

Definition at line 54 of file p11_slot.cpp.

Referenced by Botan::PKCS11::initialize_token().

   {
   m_module.get()->C_InitToken(m_slot_id, so_pin, label);
   }

Module& Botan::PKCS11::Slot::module ( ) const

inline

Returns

a reference to the module that is used

Definition at line 32 of file p11_slot.h.

         {
         return m_module;
         }

SlotId Botan::PKCS11::Slot::slot_id ( ) const

inline

Returns

the slot id

Definition at line 38 of file p11_slot.h.

Referenced by Botan::PKCS11::Session::Session().

         {
         return m_slot_id;
         }

---

The documentation for this class was generated from the following files:

• src/lib/prov/pkcs11/p11_slot.h
• src/lib/prov/pkcs11/p11_slot.cpp