//===-- DynamicLibrary.cpp - Runtime link/load libraries --------*- C++ -*-===// // // The LLVM Compiler Infrastructure // // This file is distributed under the University of Illinois Open Source // License. See LICENSE.TXT for details. // //===----------------------------------------------------------------------===// // // This file implements the operating system DynamicLibrary concept. // //===----------------------------------------------------------------------===// #include "llvm/Support/DynamicLibrary.h" #include "llvm-c/Support.h" #include "llvm/ADT/DenseSet.h" #include "llvm/ADT/StringMap.h" #include "llvm/Config/config.h" #include "llvm/Support/ManagedStatic.h" #include "llvm/Support/Mutex.h" #include #include #include using namespace llvm; using namespace llvm::sys; // All methods for HandleSet should be used holding SymbolsMutex. class DynamicLibrary::HandleSet { typedef std::vector HandleList; HandleList Handles; void *Process; public: static void *DLOpen(const char *Filename, std::string *Err); static void DLClose(void *Handle); static void *DLSym(void *Handle, const char *Symbol); HandleSet() : Process(nullptr) {} ~HandleSet(); HandleList::iterator Find(void *Handle) { return std::find(Handles.begin(), Handles.end(), Handle); } bool Contains(void *Handle) { return Handle == Process || Find(Handle) != Handles.end(); } bool AddLibrary(void *Handle, bool IsProcess = false, bool CanClose = true) { #ifdef LLVM_ON_WIN32 assert((Handle == this ? IsProcess : !IsProcess) && "Bad Handle."); #endif if (LLVM_LIKELY(!IsProcess)) { if (Find(Handle) != Handles.end()) { if (CanClose) DLClose(Handle); return false; } Handles.push_back(Handle); } else { #ifndef LLVM_ON_WIN32 if (Process) { if (CanClose) DLClose(Process); if (Process == Handle) return false; } #endif Process = Handle; } return true; } void *Lookup(const char *Symbol) { // Process handle gets first try. if (Process) { if (void *Ptr = DLSym(Process, Symbol)) return Ptr; #ifndef NDEBUG for (void *Handle : Handles) assert(!DLSym(Handle, Symbol) && "Symbol exists in non process handle"); #endif } else { // Iterate in reverse, so newer libraries/symbols override older. for (auto &&I = Handles.rbegin(), E = Handles.rend(); I != E; ++I) { if (void *Ptr = DLSym(*I, Symbol)) return Ptr; } } return nullptr; } }; namespace { // Collection of symbol name/value pairs to be searched prior to any libraries. static llvm::ManagedStatic> ExplicitSymbols; // Collection of known library handles. static llvm::ManagedStatic OpenedHandles; // Lock for ExplicitSymbols and OpenedHandles. static llvm::ManagedStatic> SymbolsMutex; } #ifdef LLVM_ON_WIN32 #include "Windows/DynamicLibrary.inc" #else #include "Unix/DynamicLibrary.inc" #endif char DynamicLibrary::Invalid; namespace llvm { void *SearchForAddressOfSpecialSymbol(const char *SymbolName) { return DoSearch(SymbolName); // DynamicLibrary.inc } } void DynamicLibrary::AddSymbol(StringRef SymbolName, void *SymbolValue) { SmartScopedLock Lock(*SymbolsMutex); (*ExplicitSymbols)[SymbolName] = SymbolValue; } DynamicLibrary DynamicLibrary::getPermanentLibrary(const char *FileName, std::string *Err) { SmartScopedLock Lock(*SymbolsMutex); void *Handle = HandleSet::DLOpen(FileName, Err); if (Handle != &Invalid) OpenedHandles->AddLibrary(Handle, /*IsProcess*/ FileName == nullptr); return DynamicLibrary(Handle); } DynamicLibrary DynamicLibrary::addPermanentLibrary(void *Handle, std::string *Err) { SmartScopedLock Lock(*SymbolsMutex); // If we've already loaded this library, tell the caller. if (!OpenedHandles->AddLibrary(Handle, /*IsProcess*/false, /*CanClose*/false)) *Err = "Library already loaded"; return DynamicLibrary(Handle); } void *DynamicLibrary::getAddressOfSymbol(const char *SymbolName) { if (!isValid()) return nullptr; return HandleSet::DLSym(Data, SymbolName); } void *DynamicLibrary::SearchForAddressOfSymbol(const char *SymbolName) { { SmartScopedLock Lock(*SymbolsMutex); // First check symbols added via AddSymbol(). if (ExplicitSymbols.isConstructed()) { StringMap::iterator i = ExplicitSymbols->find(SymbolName); if (i != ExplicitSymbols->end()) return i->second; } // Now search the libraries. if (OpenedHandles.isConstructed()) { if (void *Ptr = OpenedHandles->Lookup(SymbolName)) return Ptr; } } return llvm::SearchForAddressOfSpecialSymbol(SymbolName); } //===----------------------------------------------------------------------===// // C API. //===----------------------------------------------------------------------===// LLVMBool LLVMLoadLibraryPermanently(const char *Filename) { return llvm::sys::DynamicLibrary::LoadLibraryPermanently(Filename); } void *LLVMSearchForAddressOfSymbol(const char *symbolName) { return llvm::sys::DynamicLibrary::SearchForAddressOfSymbol(symbolName); } void LLVMAddSymbol(const char *symbolName, void *symbolValue) { return llvm::sys::DynamicLibrary::AddSymbol(symbolName, symbolValue); }