BLOCXX_NAMESPACE::dlSharedLibrary Class Reference

dlSharedLibrary loads and queries shared libraries. More...

#include <dlSharedLibrary.hpp>

Inheritance diagram for BLOCXX_NAMESPACE::dlSharedLibrary:

BLOCXX_NAMESPACE::SharedLibrary BLOCXX_NAMESPACE::IntrusiveCountableBase List of all members.

Public Member Functions

 dlSharedLibrary (void *libhandle, const String &libName)
virtual ~dlSharedLibrary ()

Static Public Member Functions

static void setCallDlclose (bool callDlclose)
 on some platforms (e.g.
static bool isFakeLibrary (const String &library_path)
 Returns if the given path is a fake library or not.

Protected Member Functions

virtual bool doGetFunctionPointer (const String &functionName, void **fp) const
 Derived classes have to override this function to implement the symbol loading.

Private Member Functions

 dlSharedLibrary (const dlSharedLibrary &)
dlSharedLibraryoperator= (const dlSharedLibrary &)

Private Attributes

void * m_libhandle
String m_libName

Static Private Attributes

static bool s_call_dlclose = true

Detailed Description

dlSharedLibrary loads and queries shared libraries.

Using dlsym & friends.

Definition at line 59 of file dlSharedLibrary.hpp.


Constructor & Destructor Documentation

BLOCXX_NAMESPACE::dlSharedLibrary::dlSharedLibrary void *  libhandle,
const String libName
 

Definition at line 80 of file dlSharedLibrary.cpp.

References isFakeLibrary().

BLOCXX_NAMESPACE::dlSharedLibrary::~dlSharedLibrary  )  [virtual]
 

Definition at line 94 of file dlSharedLibrary.cpp.

References m_libhandle, and s_call_dlclose.

BLOCXX_NAMESPACE::dlSharedLibrary::dlSharedLibrary const dlSharedLibrary  )  [private]
 


Member Function Documentation

bool BLOCXX_NAMESPACE::dlSharedLibrary::doGetFunctionPointer const String functionName,
void **  fp
const [protected, virtual]
 

Derived classes have to override this function to implement the symbol loading.

The symbol to be looked up is contained in functionName, and the pointer to the function should be written into *fp. Return true if the function succeeded, false otherwise.

Parameters:
functionName The name of the function to resolve.
fp Where to store the function pointer.
Returns:
true if function succeeded, false otherwise.

Implements BLOCXX_NAMESPACE::SharedLibrary.

Definition at line 103 of file dlSharedLibrary.cpp.

References BLOCXX_NAMESPACE::dlSharedLibrary_guard, and BLOCXX_NAMESPACE::Map< Key, T, Compare >::end().

bool BLOCXX_NAMESPACE::dlSharedLibrary::isFakeLibrary const String library_path  )  [static]
 

Returns if the given path is a fake library or not.

Definition at line 132 of file dlSharedLibrary.cpp.

References BLOCXX_NAMESPACE::FileSystem::canRead(), BLOCXX_NAMESPACE::FileSystem::openFile(), and BLOCXX_NAMESPACE::File::read().

Referenced by dlSharedLibrary(), and BLOCXX_NAMESPACE::dlSharedLibraryLoader::loadSharedLibrary().

dlSharedLibrary& BLOCXX_NAMESPACE::dlSharedLibrary::operator= const dlSharedLibrary  )  [private]
 

static void BLOCXX_NAMESPACE::dlSharedLibrary::setCallDlclose bool  callDlclose  )  [inline, static]
 

on some platforms (e.g.

glibc 2.2.x), there are bugs in the dl* functions, and the workaround is to not call dlclose. Setting this variable to 0 will cause dlclose to never be called. Doing this has some problems: memory mapped to the shared library will never be freed up. New versions of the library can't be loaded (if a provider is updated)

Definition at line 72 of file dlSharedLibrary.hpp.

References s_call_dlclose.


Member Data Documentation

void* BLOCXX_NAMESPACE::dlSharedLibrary::m_libhandle [private]
 

Definition at line 95 of file dlSharedLibrary.hpp.

Referenced by ~dlSharedLibrary().

String BLOCXX_NAMESPACE::dlSharedLibrary::m_libName [private]
 

Definition at line 96 of file dlSharedLibrary.hpp.

bool BLOCXX_NAMESPACE::dlSharedLibrary::s_call_dlclose = true [static, private]
 

Definition at line 109 of file dlSharedLibrary.hpp.

Referenced by setCallDlclose(), and ~dlSharedLibrary().


The documentation for this class was generated from the following files:
Generated on Fri Jun 16 15:39:10 2006 for blocxx by  doxygen 1.4.6