Botan::LibraryInitializer Class Reference

#include <init.h>

Public Member Functions
	LibraryInitializer (const std::string &options="")
	~LibraryInitializer ()

Static Public Member Functions
static void	deinitialize ()
static void	initialize (const std::string &options="")

Detailed Description

This class represents the Library Initialization/Shutdown Object. It has to exceed the lifetime of any Botan object used in an application. You can call initialize/deinitialize or use LibraryInitializer in the RAII style.

Definition at line 22 of file init.h.

Constructor & Destructor Documentation

LibraryInitializer()

Botan::LibraryInitializer::LibraryInitializer ( const std::string & options = "" )

inline

Initialize the library

Parameters

options

a string listing initialization options

Definition at line 40 of file init.h.

         { LibraryInitializer::initialize(options); }

References initialize().

~LibraryInitializer()

Botan::LibraryInitializer::~LibraryInitializer ( )

inline

Definition at line 43 of file init.h.

{ LibraryInitializer::deinitialize(); }

References deinitialize().

Member Function Documentation

deinitialize()

void Botan::LibraryInitializer::deinitialize ( )

static

Shutdown the library

Definition at line 71 of file init.cpp.

   {
   Global_State_Management::set_global_state(0);
   }

References Botan::Global_State_Management::set_global_state().

Referenced by initialize(), and ~LibraryInitializer().

initialize()

void Botan::LibraryInitializer::initialize ( const std::string & options = "" )

static

Initialize the library

Parameters

options

a string listing initialization options

Definition at line 18 of file init.cpp.

   {
   bool thread_safe = false;
 
   const std::vector<std::string> arg_list = split_on(arg_string, ' ');
   for(size_t i = 0; i != arg_list.size(); ++i)
      {
      if(arg_list[i].size() == 0)
         continue;
 
      std::string name, value;
 
      if(arg_list[i].find('=') == std::string::npos)
         {
         name = arg_list[i];
         value = "true";
         }
      else
         {
         std::vector<std::string> name_and_value = split_on(arg_list[i], '=');
         name = name_and_value[0];
         value = name_and_value[1];
         }
 
      bool is_on =
         (value == "1" || value == "true" || value == "yes" || value == "on");
 
      if(name == "thread_safe")
         thread_safe = is_on;
      }
 
   try
      {
      /*
      This two stage initialization process is because Library_State's
      constructor will implicitly refer to global state through the
      allocators and so forth, so global_state() has to be a valid
      reference before initialize() can be called. Yeah, gross.
      */
      Global_State_Management::set_global_state(new Library_State);
 
      global_state().initialize(thread_safe);
      }
   catch(...)
      {
      deinitialize();
      throw;
      }
   }

References deinitialize(), Botan::global_state(), Botan::Library_State::initialize(), Botan::Global_State_Management::set_global_state(), and Botan::split_on().

Referenced by LibraryInitializer().

---

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

• src/libstate/init.h
• src/libstate/init.cpp