1 /*===-- llvm-c/Support.h - Support C Interface --------------------*- C -*-===*\ 2 |* *| 3 |* Part of the LLVM Project, under the Apache License v2.0 with LLVM *| 4 |* Exceptions. *| 5 |* See https://llvm.org/LICENSE.txt for license information. *| 6 |* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception *| 7 |* *| 8 |*===----------------------------------------------------------------------===*| 9 |* *| 10 |* This file defines the C interface to the LLVM support library. *| 11 |* *| 12 \*===----------------------------------------------------------------------===*/ 13 14 #ifndef LLVM_C_SUPPORT_H 15 #define LLVM_C_SUPPORT_H 16 17 #include "llvm-c/DataTypes.h" 18 #include "llvm-c/ExternC.h" 19 #include "llvm-c/Types.h" 20 21 LLVM_C_EXTERN_C_BEGIN 22 23 /** 24 * This function permanently loads the dynamic library at the given path. 25 * It is safe to call this function multiple times for the same library. 26 * 27 * @see sys::DynamicLibrary::LoadLibraryPermanently() 28 */ 29 LLVMBool LLVMLoadLibraryPermanently(const char* Filename); 30 31 /** 32 * This function parses the given arguments using the LLVM command line parser. 33 * Note that the only stable thing about this function is its signature; you 34 * cannot rely on any particular set of command line arguments being interpreted 35 * the same way across LLVM versions. 36 * 37 * @see llvm::cl::ParseCommandLineOptions() 38 */ 39 void LLVMParseCommandLineOptions(int argc, const char *const *argv, 40 const char *Overview); 41 42 /** 43 * This function will search through all previously loaded dynamic 44 * libraries for the symbol \p symbolName. If it is found, the address of 45 * that symbol is returned. If not, null is returned. 46 * 47 * @see sys::DynamicLibrary::SearchForAddressOfSymbol() 48 */ 49 void *LLVMSearchForAddressOfSymbol(const char *symbolName); 50 51 /** 52 * This functions permanently adds the symbol \p symbolName with the 53 * value \p symbolValue. These symbols are searched before any 54 * libraries. 55 * 56 * @see sys::DynamicLibrary::AddSymbol() 57 */ 58 void LLVMAddSymbol(const char *symbolName, void *symbolValue); 59 60 LLVM_C_EXTERN_C_END 61 62 #endif 63