Botan::Dynamically_Loaded_Library Class Reference

#include <dyn_load.h>

Public Member Functions
	Dynamically_Loaded_Library (const Dynamically_Loaded_Library &)=delete
	Dynamically_Loaded_Library (Dynamically_Loaded_Library &&)=default
	Dynamically_Loaded_Library (std::string_view lib_name)
Dynamically_Loaded_Library &	operator= (const Dynamically_Loaded_Library &)=delete
Dynamically_Loaded_Library &	operator= (Dynamically_Loaded_Library &&)=default
template<typename T>
T	resolve (const std::string &symbol)
void *	resolve_symbol (const std::string &symbol)
	~Dynamically_Loaded_Library ()

Detailed Description

Represents a DLL or shared object

Definition at line 19 of file dyn_load.h.

Constructor & Destructor Documentation

Dynamically_Loaded_Library() [1/3]

Botan::Dynamically_Loaded_Library::Dynamically_Loaded_Library ( std::string_view lib_name )

explicit

Load a DLL (or fail with an exception)

Parameters

lib_name

name or path to a library

If you don't use a full path, the search order will be defined by whatever the system linker does by default. Always using fully qualified pathnames can help prevent code injection attacks (eg via manipulation of LD_LIBRARY_PATH on Linux)

Definition at line 64 of file dyn_load.cpp.

                                                                             :
      m_lib_name(library), m_lib(open_shared_library(m_lib_name)) {}

Referenced by Dynamically_Loaded_Library(), Dynamically_Loaded_Library(), operator=(), and operator=().

~Dynamically_Loaded_Library()

Botan::Dynamically_Loaded_Library::~Dynamically_Loaded_Library

(

)

Unload the DLL

Warning

Any pointers returned by resolve()/resolve_symbol() should not be used after this destructor runs.

Definition at line 67 of file dyn_load.cpp.

                                                        {
#if defined(BOTAN_TARGET_OS_HAS_POSIX1)
   ::dlclose(m_lib);
#elif defined(BOTAN_TARGET_OS_HAS_WIN32)
   ::FreeLibrary(reinterpret_cast<HMODULE>(m_lib));
#endif
}

Dynamically_Loaded_Library() [2/3]

Botan::Dynamically_Loaded_Library::Dynamically_Loaded_Library ( const Dynamically_Loaded_Library & )

delete

References Dynamically_Loaded_Library().

Dynamically_Loaded_Library() [3/3]

Botan::Dynamically_Loaded_Library::Dynamically_Loaded_Library ( Dynamically_Loaded_Library && )

default

References Dynamically_Loaded_Library().

Member Function Documentation

operator=() [1/2]

Dynamically_Loaded_Library & Botan::Dynamically_Loaded_Library::operator= ( const Dynamically_Loaded_Library & )

delete

References Dynamically_Loaded_Library().

operator=() [2/2]

Dynamically_Loaded_Library & Botan::Dynamically_Loaded_Library::operator= ( Dynamically_Loaded_Library && )

default

References Dynamically_Loaded_Library().

resolve()

template<typename T>

T Botan::Dynamically_Loaded_Library::resolve ( const std::string & symbol )

inline

Convenience function for casting symbol to the right type

Parameters

symbol

names the symbol to load

Returns

address of the loaded symbol

Definition at line 52 of file dyn_load.h.

                                         {
         return reinterpret_cast<T>(resolve_symbol(symbol));
      }

References resolve_symbol().

Referenced by Botan::PKCS11::LowLevel::C_GetFunctionList().

resolve_symbol()

void * Botan::Dynamically_Loaded_Library::resolve_symbol

(

const std::string &

symbol

)

Load a symbol (or fail with an exception)

Parameters

symbol

names the symbol to load

Returns

address of the loaded symbol

Definition at line 75 of file dyn_load.cpp.

                                                                        {
   void* addr = nullptr;
 
#if defined(BOTAN_TARGET_OS_HAS_POSIX1)
   addr = ::dlsym(m_lib, symbol.c_str());
#elif defined(BOTAN_TARGET_OS_HAS_WIN32)
   addr = reinterpret_cast<void*>(::GetProcAddress(reinterpret_cast<HMODULE>(m_lib), symbol.c_str()));
#endif
 
   if(addr == nullptr) {
      throw Invalid_Argument(fmt("Failed to resolve symbol {} in {}", symbol, m_lib_name));
   }
 
   return addr;
}

References Botan::fmt().

Referenced by resolve().

---

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

• src/lib/utils/dyn_load/dyn_load.h
• src/lib/utils/dyn_load/dyn_load.cpp