xref: /freebsd/contrib/llvm-project/llvm/include/llvm-c/Linker.h (revision 349cc55c9796c4596a5b9904cd3281af295f878f)
10b57cec5SDimitry Andric /*===-- llvm-c/Linker.h - Module Linker C Interface -------------*- C++ -*-===*\
20b57cec5SDimitry Andric |*                                                                            *|
30b57cec5SDimitry Andric |* Part of the LLVM Project, under the Apache License v2.0 with LLVM          *|
40b57cec5SDimitry Andric |* Exceptions.                                                                *|
50b57cec5SDimitry Andric |* See https://llvm.org/LICENSE.txt for license information.                  *|
60b57cec5SDimitry Andric |* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception                    *|
70b57cec5SDimitry Andric |*                                                                            *|
80b57cec5SDimitry Andric |*===----------------------------------------------------------------------===*|
90b57cec5SDimitry Andric |*                                                                            *|
100b57cec5SDimitry Andric |* This file defines the C interface to the module/file/archive linker.       *|
110b57cec5SDimitry Andric |*                                                                            *|
120b57cec5SDimitry Andric \*===----------------------------------------------------------------------===*/
130b57cec5SDimitry Andric 
140b57cec5SDimitry Andric #ifndef LLVM_C_LINKER_H
150b57cec5SDimitry Andric #define LLVM_C_LINKER_H
160b57cec5SDimitry Andric 
17480093f4SDimitry Andric #include "llvm-c/ExternC.h"
180b57cec5SDimitry Andric #include "llvm-c/Types.h"
190b57cec5SDimitry Andric 
20480093f4SDimitry Andric LLVM_C_EXTERN_C_BEGIN
210b57cec5SDimitry Andric 
22*349cc55cSDimitry Andric /**
23*349cc55cSDimitry Andric  * @defgroup LLVMCCoreLinker Linker
24*349cc55cSDimitry Andric  * @ingroup LLVMCCore
25*349cc55cSDimitry Andric  *
26*349cc55cSDimitry Andric  * @{
27*349cc55cSDimitry Andric  */
28*349cc55cSDimitry Andric 
290b57cec5SDimitry Andric /* This enum is provided for backwards-compatibility only. It has no effect. */
300b57cec5SDimitry Andric typedef enum {
310b57cec5SDimitry Andric   LLVMLinkerDestroySource = 0, /* This is the default behavior. */
320b57cec5SDimitry Andric   LLVMLinkerPreserveSource_Removed = 1 /* This option has been deprecated and
330b57cec5SDimitry Andric                                           should not be used. */
340b57cec5SDimitry Andric } LLVMLinkerMode;
350b57cec5SDimitry Andric 
360b57cec5SDimitry Andric /* Links the source module into the destination module. The source module is
370b57cec5SDimitry Andric  * destroyed.
380b57cec5SDimitry Andric  * The return value is true if an error occurred, false otherwise.
390b57cec5SDimitry Andric  * Use the diagnostic handler to get any diagnostic message.
400b57cec5SDimitry Andric */
410b57cec5SDimitry Andric LLVMBool LLVMLinkModules2(LLVMModuleRef Dest, LLVMModuleRef Src);
420b57cec5SDimitry Andric 
43480093f4SDimitry Andric LLVM_C_EXTERN_C_END
440b57cec5SDimitry Andric 
45*349cc55cSDimitry Andric /**
46*349cc55cSDimitry Andric  * @}
47*349cc55cSDimitry Andric  */
48*349cc55cSDimitry Andric 
490b57cec5SDimitry Andric #endif
50