#include "ace/DLL.h" #include "ace/Log_Category.h" #include "ace/ACE.h" #include "ace/DLL_Manager.h" #include "ace/OS_NS_string.h" #include "ace/OS_NS_dlfcn.h" #include "ace/OS_NS_Thread.h" #include ACE_BEGIN_VERSIONED_NAMESPACE_DECL // Default constructor. Also, by default, the object will be closed // before it is destroyed. ACE_DLL::ACE_DLL (bool close_handle_on_destruction) : open_mode_ (0), dll_name_ (0), close_handle_on_destruction_ (close_handle_on_destruction), dll_handle_ (0), error_ (0) { ACE_TRACE ("ACE_DLL::ACE_DLL (int)"); } ACE_DLL::ACE_DLL (const ACE_DLL &rhs) : open_mode_ (0), dll_name_ (0), close_handle_on_destruction_ (false), dll_handle_ (0), error_ (0) { ACE_TRACE ("ACE_DLL::ACE_DLL (const ACE_DLL &)"); if (rhs.dll_name_ // This will automatically up the refcount. && this->open (rhs.dll_name_, rhs.open_mode_, rhs.close_handle_on_destruction_) != 0 && ACE::debug ()) ACELIB_ERROR ((LM_ERROR, ACE_TEXT ("ACE_DLL::copy_ctor: error: %s\n"), this->error ())); } // Assignment operator ACE_DLL & ACE_DLL::operator= (const ACE_DLL &rhs) { ACE_TRACE ("ACE_DLL::operator= (const ACE_DLL &)"); ACE_DLL tmp (rhs); std::swap (this->open_mode_, tmp.open_mode_); std::swap (this->dll_name_, tmp.dll_name_); std::swap (this->close_handle_on_destruction_, tmp.close_handle_on_destruction_); std::swap (this->dll_handle_, tmp.dll_handle_); std::swap (this->error_, tmp.error_); return *this; } // If the library name and the opening mode are specified than on // object creation the library is implicitly opened. ACE_DLL::ACE_DLL (const ACE_TCHAR *dll_name, int open_mode, bool close_handle_on_destruction) : open_mode_ (open_mode), dll_name_ (0), close_handle_on_destruction_ (close_handle_on_destruction), dll_handle_ (0), error_ (0) { ACE_TRACE ("ACE_DLL::ACE_DLL"); if (this->open (dll_name, this->open_mode_, close_handle_on_destruction) != 0 && ACE::debug ()) ACELIB_ERROR ((LM_ERROR, ACE_TEXT ("ACE_DLL::open: error calling open: %s\n"), this->error ())); } // The library is closed before the class gets destroyed depending on // the close_handle_on_destruction value specified which is stored in // close_handle_on_destruction_. ACE_DLL::~ACE_DLL () { ACE_TRACE ("ACE_DLL::~ACE_DLL"); this->close (); // Normally delete()d in ACE_DLL::close(). However, that may not // occur if full ACE_DLL initialization is interrupted due to errors // (e.g. attempting to open a DSO/DLL that does not exist). Make // sure this->dll_name_ is deallocated. #if defined (ACE_HAS_ALLOC_HOOKS) ACE_Allocator::instance()->free (this->dll_name_); #else delete [] this->dll_name_; #endif /* ACE_HAS_ALLOC_HOOKS */ } // This method opens the library based on the mode specified using the // ACE_SHLIB_HANDLE which is obtained on making the ACE_OS::dlopen call. // The default mode is: // RTLD_LAZY Only references to data symbols are relocate when the // object is first loaded. // The other modes include: // RTLD_NOW All necessary relocations are performed when the // object is first loaded. // RTLD_GLOBAL The object symbols are made available for the // relocation processing of any other object. int ACE_DLL::open (const ACE_TCHAR *dll_filename, int open_mode, bool close_handle_on_destruction) { ACE_TRACE ("ACE_DLL::open"); return open_i (dll_filename, open_mode, close_handle_on_destruction); } int ACE_DLL::open_i (const ACE_TCHAR *dll_filename, int open_mode, bool close_handle_on_destruction, ACE_SHLIB_HANDLE handle) { ACE_TRACE ("ACE_DLL::open_i"); this->error_ = 0; this->errmsg_.clear (true); if (!dll_filename) { if (ACE::debug ()) ACELIB_ERROR ((LM_ERROR, ACE_TEXT ("ACE_DLL::open_i: dll_name is %s\n"), this->dll_name_ == 0 ? ACE_TEXT ("(null)") : this->dll_name_)); return -1; } if (this->dll_handle_) { // If we have a good handle and its the same name, just return. if (ACE_OS::strcmp (this->dll_name_, dll_filename) == 0) return 0; else this->close (); } if (!this->dll_name_) this->dll_name_ = ACE::strnew (dll_filename); this->open_mode_ = open_mode; this->close_handle_on_destruction_ = close_handle_on_destruction; ACE_DLL_Handle::ERROR_STACK errors; this->dll_handle_ = ACE_DLL_Manager::instance()->open_dll (this->dll_name_, this->open_mode_, handle, &errors); if (!this->dll_handle_) { ACE_TString errtmp; while (!errors.is_empty ()) { errors.pop (errtmp); if (this->errmsg_.length () > 0) this->errmsg_ += ACE_TEXT ("\n"); this->errmsg_ += errtmp; } this->error_ = 1; } return this->error_ ? -1 : 0; } // The symbol refernce of the name specified is obtained. void * ACE_DLL::symbol (const ACE_TCHAR *sym_name, int ignore_errors) { ACE_TRACE ("ACE_DLL::symbol"); this->error_ = 0; this->errmsg_.clear (true); void *sym = 0; if (this->dll_handle_) sym = this->dll_handle_->symbol (sym_name, ignore_errors, this->errmsg_); if (!sym) this->error_ = 1; return sym; } // The library is closed using the ACE_SHLIB_HANDLE object, i.e., the // shared object is now disassociated form the current process. int ACE_DLL::close () { ACE_TRACE ("ACE_DLL::close"); int retval = 0; if (this->dll_handle_ && this->close_handle_on_destruction_ && this->dll_name_ && (retval = ACE_DLL_Manager::instance ()->close_dll (this->dll_name_)) != 0) this->error_ = 1; // Even if close_dll() failed, go ahead and cleanup. this->dll_handle_ = 0; #if defined (ACE_HAS_ALLOC_HOOKS) ACE_Allocator::instance()->free (this->dll_name_); #else delete [] this->dll_name_; #endif /* ACE_HAS_ALLOC_HOOKS */ this->dll_name_ = 0; this->close_handle_on_destruction_ = false; return retval; } // This method is used return the last error of a library operation. ACE_TCHAR * ACE_DLL::error () const { ACE_TRACE ("ACE_DLL::error"); if (this->error_) { return const_cast (this->errmsg_.c_str ()); } return 0; } // Return the handle to the user either temporarily or forever, thus // orphaning it. If 0 means the user wants the handle forever and if 1 // means the user temporarily wants to take the handle. ACE_SHLIB_HANDLE ACE_DLL::get_handle (bool become_owner) const { ACE_TRACE ("ACE_DLL::get_handle"); ACE_SHLIB_HANDLE handle = ACE_SHLIB_INVALID_HANDLE; if (this->dll_handle_) handle = this->dll_handle_->get_handle (become_owner); return handle; } // Set the handle for the DLL. By default, the object will be closed // before it is destroyed. int ACE_DLL::set_handle (ACE_SHLIB_HANDLE handle, bool close_handle_on_destruction) { ACE_TRACE ("ACE_DLL::set_handle"); // Create a unique name. Note that this name is only guaranteed // to be unique for the life of this object. ACE_TCHAR temp[ACE_UNIQUE_NAME_LEN]; ACE_OS::unique_name (this, temp, ACE_UNIQUE_NAME_LEN); return this->open_i (temp, 1, close_handle_on_destruction, handle); } ACE_END_VERSIONED_NAMESPACE_DECL