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/Types.h"
18
19#ifdef __cplusplus
20extern "C" {
21#endif
22
23/* This enum is provided for backwards-compatibility only. It has no effect. */
24typedef 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. 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.
35 *
36 * Note that the linker mode parameter \p Unused is no longer used, and has
37 * no effect.
38 *
39 * This function is deprecated. Use LLVMLinkModules2 instead.
40 */
41LLVMBool LLVMLinkModules(LLVMModuleRef Dest, LLVMModuleRef Src,
42                         LLVMLinkerMode Unused, char **OutMessage);
43
44/* Links the source module into the destination module. The source module is
45 * destroyed.
46 * The return value is true if an error occurred, false otherwise.
47 * Use the diagnostic handler to get any diagnostic message.
48*/
49LLVMBool LLVMLinkModules2(LLVMModuleRef Dest, LLVMModuleRef Src);
50
51#ifdef __cplusplus
52}
53#endif
54
55#endif
56