1 /*===-- IPO.h - Interprocedural Transformations 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 header declares the C interface to libLLVMIPO.a, which implements     *|
11 |* various interprocedural transformations of the LLVM IR.                    *|
12 |*                                                                            *|
13 \*===----------------------------------------------------------------------===*/
14 
15 #ifndef LLVM_C_TRANSFORMS_IPO_H
16 #define LLVM_C_TRANSFORMS_IPO_H
17 
18 #include "llvm-c/ExternC.h"
19 #include "llvm-c/Types.h"
20 
21 LLVM_C_EXTERN_C_BEGIN
22 
23 /**
24  * @defgroup LLVMCTransformsIPO Interprocedural transformations
25  * @ingroup LLVMCTransforms
26  *
27  * @{
28  */
29 
30 /** See llvm::createArgumentPromotionPass function. */
31 void LLVMAddArgumentPromotionPass(LLVMPassManagerRef PM);
32 
33 /** See llvm::createConstantMergePass function. */
34 void LLVMAddConstantMergePass(LLVMPassManagerRef PM);
35 
36 /** See llvm::createMergeFunctionsPass function. */
37 void LLVMAddMergeFunctionsPass(LLVMPassManagerRef PM);
38 
39 /** See llvm::createCalledValuePropagationPass function. */
40 void LLVMAddCalledValuePropagationPass(LLVMPassManagerRef PM);
41 
42 /** See llvm::createDeadArgEliminationPass function. */
43 void LLVMAddDeadArgEliminationPass(LLVMPassManagerRef PM);
44 
45 /** See llvm::createFunctionAttrsPass function. */
46 void LLVMAddFunctionAttrsPass(LLVMPassManagerRef PM);
47 
48 /** See llvm::createFunctionInliningPass function. */
49 void LLVMAddFunctionInliningPass(LLVMPassManagerRef PM);
50 
51 /** See llvm::createAlwaysInlinerPass function. */
52 void LLVMAddAlwaysInlinerPass(LLVMPassManagerRef PM);
53 
54 /** See llvm::createGlobalDCEPass function. */
55 void LLVMAddGlobalDCEPass(LLVMPassManagerRef PM);
56 
57 /** See llvm::createGlobalOptimizerPass function. */
58 void LLVMAddGlobalOptimizerPass(LLVMPassManagerRef PM);
59 
60 /** See llvm::createPruneEHPass function. */
61 void LLVMAddPruneEHPass(LLVMPassManagerRef PM);
62 
63 /** See llvm::createIPSCCPPass function. */
64 void LLVMAddIPSCCPPass(LLVMPassManagerRef PM);
65 
66 /** See llvm::createInternalizePass function. */
67 void LLVMAddInternalizePass(LLVMPassManagerRef, unsigned AllButMain);
68 
69 /**
70  * Create and add the internalize pass to the given pass manager with the
71  * provided preservation callback.
72  *
73  * The context parameter is forwarded to the callback on each invocation.
74  * As such, it is the responsibility of the caller to extend its lifetime
75  * until execution of this pass has finished.
76  *
77  * @see llvm::createInternalizePass function.
78  */
79 void LLVMAddInternalizePassWithMustPreservePredicate(
80     LLVMPassManagerRef PM,
81     void *Context,
82     LLVMBool (*MustPreserve)(LLVMValueRef, void *));
83 
84 /** See llvm::createStripDeadPrototypesPass function. */
85 void LLVMAddStripDeadPrototypesPass(LLVMPassManagerRef PM);
86 
87 /** See llvm::createStripSymbolsPass function. */
88 void LLVMAddStripSymbolsPass(LLVMPassManagerRef PM);
89 
90 /**
91  * @}
92  */
93 
94 LLVM_C_EXTERN_C_END
95 
96 #endif
97