1 /*===-- llvm-c/Linker.h - Module Linker C Interface -------------*- C++ -*-===*\
2 |*                                                                            *|
3 |*                     The LLVM Compiler Infrastructure                       *|
4 |*                                                                            *|
5 |* This file is distributed under the University of Illinois Open Source      *|
6 |* License. See LICENSE.TXT for details.                                      *|
7 |*                                                                            *|
8 |*===----------------------------------------------------------------------===*|
9 |*                                                                            *|
10 |* This file defines the C interface to the module/file/archive linker.       *|
11 |*                                                                            *|
12 \*===----------------------------------------------------------------------===*/
13 
14 #ifndef LLVM_C_LINKER_H
15 #define LLVM_C_LINKER_H
16 
17 #include "llvm-c/Core.h"
18 
19 #ifdef __cplusplus
20 extern "C" {
21 #endif
22 
23 /* This enum is provided for backwards-compatibility only. It has no effect. */
24 typedef enum {
25   LLVMLinkerDestroySource = 0, /* This is the default behavior. */
26   LLVMLinkerPreserveSource_Removed = 1 /* This option has been deprecated and
27                                           should not be used. */
28 } LLVMLinkerMode;
29 
30 /* Links the source module into the destination module, taking ownership
31  * of the source module away from the caller. Optionally returns a
32  * human-readable description of any errors that occurred in linking.
33  * OutMessage must be disposed with LLVMDisposeMessage. The return value
34  * is true if an error occurred, false otherwise.
35  *
36  * Note that the linker mode parameter \p Unused is no longer used, and has
37  * no effect. */
38 LLVMBool LLVMLinkModules(LLVMModuleRef Dest, LLVMModuleRef Src,
39                          LLVMLinkerMode Unused, char **OutMessage);
40 
41 #ifdef __cplusplus
42 }
43 #endif
44 
45 #endif
46