Botan::PKCS11::Module Class Reference

#include <p11_module.h>

Public Member Functions
Info	get_info () const
	Module (const std::string &file_path, C_InitializeArgs init_args={nullptr, nullptr, nullptr, nullptr, static_cast< CK_FLAGS >(Flag::OsLockingOk), nullptr})
	Module (Module &&other)=default
	Module (const Module &other)=delete
LowLevel *	operator-> () const
Module &	operator= (Module &&other)=delete
Module &	operator= (const Module &other)=delete
void	reload (C_InitializeArgs init_args={nullptr, nullptr, nullptr, nullptr, static_cast< CK_FLAGS >(Flag::OsLockingOk), nullptr})
	~Module () noexcept
	Calls C_Finalize() More...

Detailed Description

Loads the PKCS#11 shared library Calls C_Initialize on load and C_Finalize on destruction

Definition at line 25 of file p11_module.h.

Constructor & Destructor Documentation

Botan::PKCS11::Module::Module	(	const std::string &	file_path,
		C_InitializeArgs	init_args = { nullptr, nullptr, nullptr, nullptr, static_cast< CK_FLAGS >(Flag::OsLockingOk), nullptr }
	)

Loads the shared library and calls C_Initialize

Parameters

file_path	the path to the PKCS#11 shared library
init_args	flags to use for C_Initialize

Definition at line 15 of file p11_module.cpp.

References reload().

   : m_file_path(file_path)
   {
   if(file_path.empty())
      throw Invalid_Argument("PKCS11 no module path specified");
   reload(init_args);
   }

Botan::PKCS11::Module::Module ( Module &&  other )

default

Botan::PKCS11::Module::Module ( const Module &  other )

delete

Botan::PKCS11::Module::~Module ( )

noexcept

Calls C_Finalize()

Definition at line 23 of file p11_module.cpp.

   {
   try
      {
      m_low_level->C_Finalize(nullptr, nullptr);
      }
   catch(...)
      {
      // we are noexcept and must swallow any exception here
      }
   }

Member Function Documentation

Info Botan::PKCS11::Module::get_info ( ) const

inline

Returns

general information about Cryptoki

Definition at line 58 of file p11_module.h.

         {
         Info info;
         m_low_level->C_GetInfo(&info);
         return info;
         }

LowLevel* Botan::PKCS11::Module::operator-> ( ) const

inline

Definition at line 52 of file p11_module.h.

         {
         return m_low_level.get();
         }

Module& Botan::PKCS11::Module::operator= ( Module &&  other )

delete

Module& Botan::PKCS11::Module::operator= ( const Module &  other )

delete

void Botan::PKCS11::Module::reload

(

C_InitializeArgs

init_args = { nullptr, nullptr, nullptr, nullptr, static_cast< CK_FLAGS >(Flag::OsLockingOk), nullptr }

)

Reloads the module and reinitializes it

Parameters

init_args

flags to use for C_Initialize

Definition at line 35 of file p11_module.cpp.

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

Referenced by Module().

   {
   if(m_low_level)
      {
      m_low_level->C_Finalize(nullptr);
      }

   m_library.reset(new Dynamically_Loaded_Library(m_file_path));
   LowLevel::C_GetFunctionList(*m_library, &m_func_list);
   m_low_level.reset(new LowLevel(m_func_list));

   m_low_level->C_Initialize(&init_args);
   }

---

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

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