1 /*===-- llvm-c/Linker.h - Module Linker C Interface -------------*- C++ -*-===*\
3 |* The LLVM Compiler Infrastructure *|
5 |* This file is distributed under the University of Illinois Open Source *|
6 |* License. See LICENSE.TXT for details. *|
8 |*===----------------------------------------------------------------------===*|
10 |* This file defines the C interface to the module/file/archive linker. *|
12 \*===----------------------------------------------------------------------===*/
14 #ifndef LLVM_C_LINKER_H
15 #define LLVM_C_LINKER_H
17 #include "llvm-c/Types.h"
23 /* This enum is provided for backwards-compatibility only. It has no effect. */
25 LLVMLinkerDestroySource = 0, /* This is the default behavior. */
26 LLVMLinkerPreserveSource_Removed = 1 /* This option has been deprecated and
27 should not be used. */
30 /* Links the source module into the destination module. The source module is
31 * damaged. The only thing that can be done is destroy it. Optionally returns a
32 * human-readable description of any errors that occurred in linking. OutMessage
33 * must be disposed with LLVMDisposeMessage. The return value is true if an
34 * error occurred, false otherwise.
36 * Note that the linker mode parameter \p Unused is no longer used, and has
39 * This function is deprecated. Use LLVMLinkModules2 instead.
41 LLVMBool LLVMLinkModules(LLVMModuleRef Dest, LLVMModuleRef Src,
42 LLVMLinkerMode Unused, char **OutMessage);
44 /* Links the source module into the destination module. The source module is
46 * The return value is true if an error occurred, false otherwise.
47 * Use the diagnostic handler to get any diagnostic message.
49 LLVMBool LLVMLinkModules2(LLVMModuleRef Dest, LLVMModuleRef Src);