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
21LLVM_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  */
29LLVMBool 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 */
39void 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 */
49void *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 */
58void LLVMAddSymbol(const char *symbolName, void *symbolValue);
59
60LLVM_C_EXTERN_C_END
61
62#endif
63