X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/406291e530b14c6a2f4537ce59647d88b3ccde7c..f17fb297676dd3231b849ab7e55486473aa6ee21:/src/common/dynlib.cpp diff --git a/src/common/dynlib.cpp b/src/common/dynlib.cpp index 177e21a773..3660cc21f8 100644 --- a/src/common/dynlib.cpp +++ b/src/common/dynlib.cpp @@ -9,26 +9,106 @@ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// +// ============================================================================ +// declarations +// ============================================================================ + +// ---------------------------------------------------------------------------- +// headers +// ---------------------------------------------------------------------------- + #ifdef __GNUG__ -#pragma implementation "dynlib.h" +# pragma implementation "dynlib.h" #endif -#include -#include -#include -#include +#include "wx/wxprec.h" -// --------------------------------------------------------------------------- -// System dependent include -// --------------------------------------------------------------------------- +#ifdef __BORLANDC__ + #pragma hdrstop +#endif + +#if wxUSE_DYNLIB_CLASS -#if defined(__LINUX__) || defined(__SGI__) -#include +#if defined(__WINDOWS__) + #include "wx/msw/private.h" #endif -#ifdef __WINDOWS__ -#include +#include "wx/dynlib.h" +#include "wx/filefn.h" +#include "wx/intl.h" +#include "wx/log.h" +#include "wx/tokenzr.h" + +// ---------------------------------------------------------------------------- +// conditional compilation +// ---------------------------------------------------------------------------- + +#if defined(__WXPM__) || defined(__EMX__) +# define INCL_DOS +# include +# define wxDllOpen(error, lib, handle) DosLoadModule(error, sizeof(error), lib, &handle) +# define wxDllGetSymbol(handle, modaddr) DosQueryProcAddr(handle, 1L, NULL, (PFN*)modaddr) +# define wxDllClose(handle) DosFreeModule(handle) +#elif defined(HAVE_DLOPEN) + // note about dlopen() flags: we use RTLD_NOW to have more Windows-like + // behaviour (Win won't let you load a library with missing symbols) and + // RTLD_GLOBAL because it is needed sometimes and probably doesn't hurt + // otherwise. On True64-Unix RTLD_GLOBAL is not allowed and on VMS the + // second argument on dlopen is ignored. +#ifdef __VMS +# define wxDllOpen(lib) dlopen(lib.fn_str(), 0 ) +#elif defined( __osf__ ) +# define wxDllOpen(lib) dlopen(lib.fn_str(), RTLD_LAZY ) +#else +# define wxDllOpen(lib) dlopen(lib.fn_str(), RTLD_LAZY | RTLD_GLOBAL) +#endif +#define wxDllGetSymbol(handle, name) dlsym(handle, name) +# define wxDllClose dlclose +#elif defined(HAVE_SHL_LOAD) +# define wxDllOpen(lib) shl_load(lib.fn_str(), BIND_DEFERRED, 0) +# define wxDllClose shl_unload + + static inline void *wxDllGetSymbol(shl_t handle, const wxString& name) + { + void *sym; + if ( shl_findsym(&handle, name.mb_str(), TYPE_UNDEFINED, &sym) == 0 ) + return sym; + else + return (void *)0; + } +#elif defined(__DARWIN__) +/* Porting notes: + * The dlopen port is a port from dl_next.xs by Anno Siegel. + * dl_next.xs is itself a port from dl_dlopen.xs by Paul Marquess. + * The method used here is just to supply the sun style dlopen etc. + * functions in terms of Darwin NS*. + */ +void *dlopen(const char *path, int mode /* mode is ignored */); +void *dlsym(void *handle, const char *symbol); +int dlclose(void *handle); +const char *dlerror(void); + +# define wxDllOpen(lib) dlopen(lib.fn_str(), 0) +# define wxDllGetSymbol(handle, name) dlsym(handle, name) +# define wxDllClose dlclose +#elif defined(__WINDOWS__) + // using LoadLibraryEx under Win32 to avoid name clash with LoadLibrary +# ifdef __WIN32__ +#ifdef _UNICODE +# define wxDllOpen(lib) ::LoadLibraryExW(lib, 0, 0) +#else +# define wxDllOpen(lib) ::LoadLibraryExA(lib, 0, 0) #endif +# else // Win16 +# define wxDllOpen(lib) ::LoadLibrary(lib) +# endif // Win32/16 +# define wxDllGetSymbol(handle, name) ::GetProcAddress(handle, name) +# define wxDllClose ::FreeLibrary +#elif defined(__WXMAC__) +# define wxDllClose(handle) CloseConnection(&handle) +#else +# error "Don't know how to load shared libraries on this platform." +#endif // OS // --------------------------------------------------------------------------- // Global variables @@ -36,212 +116,421 @@ wxLibraries wxTheLibraries; +// ============================================================================ +// implementation +// ============================================================================ + +// construct the full name from the base shared object name: adds a .dll +// suffix under Windows or .so under Unix +static wxString ConstructLibraryName(const wxString& basename) +{ + wxString fullname; + fullname << basename << wxDllLoader::GetDllExt(); + + return fullname; +} + // --------------------------------------------------------------------------- -// wxLibrary (one instance per dynamic library +// wxLibrary (one instance per dynamic library) // --------------------------------------------------------------------------- -wxLibrary::wxLibrary(void *handle) +wxLibrary::wxLibrary(wxDllType handle) { - typedef wxClassLibrary *(*t_get_list)(void); - t_get_list get_list; + typedef wxClassInfo *(*t_get_first)(void); + t_get_first get_first; - m_handle = handle; + m_handle = handle; - get_list = (t_get_list)GetSymbol("GetClassList"); - m_liblist = (*get_list)(); + // Some system may use a local heap for library. + get_first = (t_get_first)GetSymbol("wxGetClassFirst"); + // It is a wxWindows DLL. + if (get_first) + PrepareClasses(get_first()); } wxLibrary::~wxLibrary() { - if (m_handle) { - typedef void (*t_free_list)(wxClassLibrary *); - t_free_list free_list; + if ( m_handle ) + { + wxDllClose(m_handle); + } +} - free_list = (t_free_list) GetSymbol("FreeClassList"); - if (free_list != NULL) - free_list(m_liblist); - else - delete m_liblist; +wxObject *wxLibrary::CreateObject(const wxString& name) +{ + wxClassInfo *info = (wxClassInfo *)classTable.Get(name); -#if defined(__LINUX__) || defined(__SGI__) - dlclose(m_handle); -#endif -#ifdef __WINDOWS__ - FreeLibrary((HMODULE)m_handle); -#endif - } + if (!info) + return NULL; + + return info->CreateObject(); } -wxObject *wxLibrary::CreateObject(const wxString& name) +void wxLibrary::PrepareClasses(wxClassInfo *first) { - return m_liblist->CreateObject(name); + // Index all class infos by their class name + wxClassInfo *info = first; + while (info) + { + if (info->m_className) + classTable.Put(info->m_className, (wxObject *)info); + info = (wxClassInfo *)info->GetNext(); + } + + // Set base pointers for each wxClassInfo + info = first; + while (info) + { + if (info->GetBaseClassName1()) + info->m_baseInfo1 = (wxClassInfo *)classTable.Get(info->GetBaseClassName1()); + if (info->GetBaseClassName2()) + info->m_baseInfo2 = (wxClassInfo *)classTable.Get(info->GetBaseClassName2()); + info = info->m_next; + } } void *wxLibrary::GetSymbol(const wxString& symbname) { -#if defined(__LINUX__) || defined(__SGI__) - return dlsym(m_handle, WXSTRINGCAST symbname); -#endif -#ifdef __WINDOWS__ - return GetProcAddress(m_handle, WXSTRINGCAST symbname); -#endif - return NULL; + return wxDllLoader::GetSymbol(m_handle, symbname); } // --------------------------------------------------------------------------- -// wxLibraries (only one instance should normally exist) +// wxDllLoader // --------------------------------------------------------------------------- -wxLibraries::wxLibraries() +/* static */ +wxString wxDllLoader::GetDllExt() { + wxString ext; + +#if defined(__WINDOWS__) || defined(__WXPM__) || defined(__EMX__) + ext = _T(".dll"); +#elif defined(__UNIX__) +# if defined(__HPUX__) + ext = _T(".sl"); +# else //__HPUX__ + ext = _T(".so"); +# endif //__HPUX__ +#endif + + return ext; } -wxLibraries::~wxLibraries() +/* static */ +wxDllType +wxDllLoader::GetProgramHandle(void) { - wxNode *node = m_loaded.First(); - - while (node) { - wxLibrary *lib = (wxLibrary *)node->Data(); - delete lib; - - node = node->Next(); - } +#if defined( HAVE_DLOPEN ) && !defined(__EMX__) + // optain handle for main program + return dlopen(NULL, RTLD_NOW/*RTLD_LAZY*/); +#elif defined (HAVE_SHL_LOAD) + // shl_findsymbol with NULL handle looks up in main program + return 0; +#else + wxFAIL_MSG( wxT("This method is not implemented under Windows or OS/2")); + return 0; +#endif } -wxLibrary *wxLibraries::LoadLibrary(const wxString& name) +/* static */ +wxDllType +wxDllLoader::LoadLibrary(const wxString & libname, bool *success) { - wxString lib_name = name; - wxNode *node; - wxLibrary *lib; + wxDllType handle; + +#if defined(__WXMAC__) && !defined(__UNIX__) + FSSpec myFSSpec ; + Ptr myMainAddr ; + Str255 myErrName ; + + wxMacFilename2FSSpec( libname , &myFSSpec ) ; + if (GetDiskFragment( &myFSSpec , 0 , kCFragGoesToEOF , "\p" , kPrivateCFragCopy , &handle , &myMainAddr , + myErrName ) != noErr ) + { + p2cstr( myErrName ) ; + wxLogSysError( _("Failed to load shared library '%s' Error '%s'") , libname.c_str() , (char*)myErrName ) ; + handle = NULL ; + } +#elif defined(__WXPM__) || defined(__EMX__) + char zError[256] = ""; + wxDllOpen(zError, libname, handle); +#else // !Mac + handle = wxDllOpen(libname); +#endif // OS + + if ( !handle ) + { + wxString msg(_("Failed to load shared library '%s'")); + +#ifdef HAVE_DLERROR + const char *errmsg = dlerror(); + if ( errmsg ) + { + // the error string format is "libname: ...", but we already have + // libname, so cut it off + const char *p = strchr(errmsg, ':'); + if ( p ) + { + if ( *++p == ' ' ) + p++; + } + else + { + p = errmsg; + } + + msg += _T(" (%s)"); + wxLogError(msg, libname.c_str(), p); + } + else +#endif // HAVE_DLERROR + { + wxLogSysError(msg, libname.c_str()); + } + } - if ( (node = m_loaded.Find(name.GetData())) ) - return ((wxLibrary *)node->Data()); + if ( success ) + { + *success = handle != 0; + } -#if defined(__LINUX__) || defined(__SGI__) - lib_name.Prepend("lib"); - lib_name += ".so"; + return handle; +} - printf("lib_name = %s\n", WXSTRINGCAST lib_name); - void *handle = dlopen(WXSTRINGCAST lib_name, RTLD_LAZY); +/* static */ +void +wxDllLoader::UnloadLibrary(wxDllType handle) +{ + wxDllClose(handle); +} + +/* static */ +void * +wxDllLoader::GetSymbol(wxDllType dllHandle, const wxString &name) +{ + void *symbol = NULL; // return value - if (!handle) - return NULL; -#elif defined( __WINDOWS__ ) - lib_name += ".dll"; +#if defined(__WXMAC__) && !defined(__UNIX__) + Ptr symAddress ; + CFragSymbolClass symClass ; + Str255 symName ; - HMODULE handle = LoadLibrary(lib_name); - if (!handle) - return NULL; +#if TARGET_CARBON + c2pstrcpy( (StringPtr) symName , name ) ; #else - return NULL; + strcpy( (char *) symName , name ) ; + c2pstr( (char *) symName ) ; #endif -#if defined(__LINUX__) || defined(__SGI__) || defined (__WINDOWS__) - lib = new wxLibrary((void *)handle); - m_loaded.Append(name.GetData(), lib); - return lib; + if ( FindSymbol( dllHandle , symName , &symAddress , &symClass ) == noErr ) + symbol = (void *)symAddress ; +#elif defined( __WXPM__ ) || defined(__EMX__) + wxDllGetSymbol(dllHandle, symbol); +#else + // mb_str() is necessary in Unicode build + symbol = wxDllGetSymbol(dllHandle, name.mb_str()); #endif -} - -wxObject *wxLibraries::CreateObject(const wxString& path) -{ - wxNode *node = m_loaded.First(); - wxObject *obj; - - while (node) { - obj = ((wxLibrary *)node->Data())->CreateObject(path); - if (obj) - return obj; - node = node->Next(); - } - return NULL; + if ( !symbol ) + { + wxLogSysError(_("Couldn't find symbol '%s' in a dynamic library"), + name.c_str()); + } + return symbol; } // --------------------------------------------------------------------------- -// wxClassLibrary (this class is used to access the internal class) +// wxLibraries (only one instance should normally exist) // --------------------------------------------------------------------------- -wxClassLibrary::wxClassLibrary(void) +wxLibraries::wxLibraries():m_loaded(wxKEY_STRING) { } -wxClassLibrary::~wxClassLibrary(void) +wxLibraries::~wxLibraries() { - uint i; + wxNode *node = m_loaded.First(); + + while (node) { + wxLibrary *lib = (wxLibrary *)node->Data(); + delete lib; - for (i=0;iNext(); + } } -void wxClassLibrary::RegisterClass(wxClassInfo *class_info, - const wxString& path) +wxLibrary *wxLibraries::LoadLibrary(const wxString& name) { - wxClassLibInfo *info = new wxClassLibInfo; + wxNode *node; + wxLibrary *lib; + wxClassInfo *old_sm_first; + +#if defined(__VISAGECPP__) + node = m_loaded.Find(name.GetData()); + if (node != NULL) + return ((wxLibrary *)node->Data()); +#else // !OS/2 + if ( (node = m_loaded.Find(name.GetData())) != NULL) + return ((wxLibrary *)node->Data()); +#endif + // If DLL shares data, this is necessary. + old_sm_first = wxClassInfo::sm_first; + wxClassInfo::sm_first = NULL; + + wxString libname = ConstructLibraryName(name); + +/* + Unix automatically builds that library name, at least for dlopen() +*/ +#if 0 +#if defined(__UNIX__) + // found the first file in LD_LIBRARY_PATH with this name + wxString libPath("/lib:/usr/lib"); // system path first + const char *envLibPath = getenv("LD_LIBRARY_PATH"); + if ( envLibPath ) + libPath << wxT(':') << envLibPath; + wxStringTokenizer tokenizer(libPath, wxT(':')); + while ( tokenizer.HasMoreToken() ) + { + wxString fullname(tokenizer.NextToken()); + + fullname << wxT('/') << libname; + if ( wxFileExists(fullname) ) + { + libname = fullname; + + // found the library + break; + } + } + //else: not found in the path, leave the name as is (secutiry risk?) + +#endif // __UNIX__ +#endif - info->class_info = class_info; - info->path = path; - m_list.Add(info); + bool success = FALSE; + wxDllType handle = wxDllLoader::LoadLibrary(libname, &success); + if(success) + { + lib = new wxLibrary(handle); + wxClassInfo::sm_first = old_sm_first; + m_loaded.Append(name.GetData(), lib); + } + else + lib = NULL; + return lib; } -void wxClassLibrary::UnregisterClass(wxClassInfo *class_info) +wxObject *wxLibraries::CreateObject(const wxString& path) { - uint i = 0; + wxNode *node = m_loaded.First(); + wxObject *obj; + + while (node) { + obj = ((wxLibrary *)node->Data())->CreateObject(path); + if (obj) + return obj; - while (i < m_list.Count()) { - if (m_list[i]->class_info == class_info) { - delete (m_list[i]); - m_list.Remove(i); - return; + node = node->Next(); } - i++; - } + return NULL; } -bool wxClassLibrary::CreateObjects(const wxString& path, - wxArrayClassInfo& objs) +#ifdef __DARWIN__ +// --------------------------------------------------------------------------- +// For Darwin/Mac OS X +// supply the sun style dlopen functions in terms of Darwin NS* +// --------------------------------------------------------------------------- + +extern "C" { +#import +}; + +enum dyldErrorSource { - wxClassLibInfo *info; - uint i = 0; + OFImage, +}; + +static char dl_last_error[1024]; - while (i < m_list.Count()) { - info = m_list[i]; - if (wxMatchWild(path, info->path)) - objs.Add(info->class_info); - i++; - } - return (i > 0); +static +void TranslateError(const char *path, enum dyldErrorSource type, int number) +{ + unsigned int index; + static char *OFIErrorStrings[] = + { + "%s(%d): Object Image Load Failure\n", + "%s(%d): Object Image Load Success\n", + "%s(%d): Not an recognisable object file\n", + "%s(%d): No valid architecture\n", + "%s(%d): Object image has an invalid format\n", + "%s(%d): Invalid access (permissions?)\n", + "%s(%d): Unknown error code from NSCreateObjectFileImageFromFile\n", + }; +#define NUM_OFI_ERRORS (sizeof(OFIErrorStrings) / sizeof(OFIErrorStrings[0])) + + switch (type) + { + case OFImage: + index = number; + if (index > NUM_OFI_ERRORS - 1) { + index = NUM_OFI_ERRORS - 1; + } + sprintf(dl_last_error, OFIErrorStrings[index], path, number); + break; + + default: + sprintf(dl_last_error, "%s(%d): Totally unknown error type %d\n", + path, number, type); + break; + } } -bool wxClassLibrary::FetchInfos(const wxString& path, - wxArrayClassLibInfo& infos) +const char *dlerror() { - wxClassLibInfo *info; - uint i = 0; + return dl_last_error; +} - while (i < m_list.Count()) { - info = m_list[i]; - if (wxMatchWild(path, info->path)) { - wxClassLibInfo *inf = new wxClassLibInfo; - *inf = *info; - infos.Add(inf); +void *dlopen(const char *path, int mode /* mode is ignored */) +{ + int dyld_result; + NSObjectFileImage ofile; + NSModule handle = NULL; + + dyld_result = NSCreateObjectFileImageFromFile(path, &ofile); + if (dyld_result != NSObjectFileImageSuccess) + { + TranslateError(path, OFImage, dyld_result); + } + else + { + // NSLinkModule will cause the run to abort on any link error's + // not very friendly but the error recovery functionality is limited. + handle = NSLinkModule(ofile, path, TRUE); } - i++; - } - return (i > 0); + + return handle; } -wxObject *wxClassLibrary::CreateObject(const wxString& path) +int dlclose(void *handle) /* stub only */ { - wxClassLibInfo *info; - uint i = 0; + return 0; +} - while (i < m_list.Count()) { - info = m_list[i]; - if (wxMatchWild(path, info->path)) - return info->class_info->CreateObject(); - i++; - } - return NULL; +void *dlsym(void *handle, const char *symbol) +{ + void *addr; + + if (NSIsSymbolNameDefined(symbol)) { + addr = NSAddressOfSymbol(NSLookupAndBindSymbol(symbol)); + } + else { + addr = NULL; + } + return addr; } + +#endif // __DARWIN__ + +#endif // wxUSE_DYNLIB_CLASS