LLVM: include/llvm/Support/CodeGen.h Source File

LLVM 22.0.0git
CodeGen.h
Go to the documentation of this file.
1//===-- llvm/Support/CodeGen.h - CodeGen Concepts ---------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file define some types which define code generation concepts. For
10// example, relocation model.
11//
12//===----------------------------------------------------------------------===//
13
14#ifndef LLVM_SUPPORT_CODEGEN_H
15#define LLVM_SUPPORT_CODEGEN_H
16
17#include <cstdint>
18#include <optional>
19
20namespace llvm {
21
22 // Relocation model types.
23 namespace Reloc {
24 // Cannot be named PIC due to collision with -DPIC
26 }
27
28 // Code model types.
29 namespace CodeModel {
30 // Sync changes with CodeGenCWrappers.h.
32 }
33
34 namespace PICLevel {
35 // This is used to map -fpic/-fPIC.
36 enum Level { NotPIC=0, SmallPIC=1, BigPIC=2 };
37 }
38
39 namespace PIELevel {
40 enum Level { Default=0, Small=1, Large=2 };
41 }
42
43 // TLS models.
52
53 enum class ExceptionHandling {
54 None, ///< No exception support
55 DwarfCFI, ///< DWARF-like instruction based exceptions
56 SjLj, ///< setjmp/longjmp based exceptions
57 ARM, ///< ARM EHABI
58 WinEH, ///< Windows Exception Handling
59 Wasm, ///< WebAssembly Exception Handling
60 AIX, ///< AIX Exception Handling
61 ZOS, ///< z/OS MVS Exception Handling. Very similar to DwarfCFI, but the
62 ///< PPA1 is used instead of an .eh_frame section.
63 };
64
65 namespace FloatABI {
66 enum ABIType {
67 Default, // Target-specific (either soft or hard depending on triple, etc).
68 Soft, // Soft float.
69 Hard // Hard float.
70 };
71 }
72
73 enum class EABI {
75 Default, // Default means not specified
76 EABI4, // Target-specific (either 4, 5 or gnu depending on triple).
79 };
80
81 /// Code generation optimization level.
82 enum class CodeGenOptLevel {
83 None = 0, ///< -O0
84 Less = 1, ///< -O1
85 Default = 2, ///< -O2, -Os
86 Aggressive = 3 ///< -O3
87 };
88
89 namespace CodeGenOpt {
90 /// Get the \c Level identified by the integer \p OL.
91 ///
92 /// Returns std::nullopt if \p OL is invalid.
93 inline std::optional<CodeGenOptLevel> getLevel(int OL) {
94 if (OL < 0 || OL > 3)
95 return std::nullopt;
96 return static_cast<CodeGenOptLevel >(OL);
97 }
98 /// Parse \p C as a single digit integer and get matching \c CodeGenLevel.
99 ///
100 /// Returns std::nullopt if the input is not a valid optimization level.
101 inline std::optional<CodeGenOptLevel> parseLevel(char C) {
102 if (C < '0')
103 return std::nullopt;
104 return getLevel(static_cast<int>(C - '0'));
105 }
106 } // namespace CodeGenOpt
107
108 /// These enums are meant to be passed into addPassesToEmitFile to indicate
109 /// what type of file to emit, and returned by it to indicate what type of
110 /// file could actually be made.
111 enum class CodeGenFileType {
114 Null // Do not emit any output.
115 };
116
117 // Specify what functions should keep the frame pointer.
118 enum class FramePointerKind { None, NonLeaf, All, Reserved };
119
120 // Specify what type of zeroing callee-used registers.
122 const unsigned ONLY_USED = 1U << 1;
123 const unsigned ONLY_GPR = 1U << 2;
124 const unsigned ONLY_ARG = 1U << 3;
125
126 enum class ZeroCallUsedRegsKind : unsigned int {
127 // Don't zero any call-used regs.
128 Skip = 1U << 0,
129 // Only zeros call-used GPRs used in the fn and pass args.
131 // Only zeros call-used GPRs used in the fn.
133 // Only zeros call-used regs used in the fn and pass args.
135 // Only zeros call-used regs used in the fn.
137 // Zeros all call-used GPRs that pass args.
139 // Zeros all call-used GPRs.
141 // Zeros all call-used regs that pass args.
143 // Zeros all call-used regs.
144 All = 0,
145 };
146 } // namespace ZeroCallUsedRegs
147
148 enum class UWTableKind {
149 None = 0, ///< No unwind table requested
150 Sync = 1, ///< "Synchronous" unwind tables
151 Async = 2, ///< "Asynchronous" unwind tables (instr precise)
153 };
154
155 enum class FunctionReturnThunksKind : unsigned int {
156 Keep = 0, ///< No function return thunk.
157 Extern = 1, ///< Replace returns with jump to thunk, don't emit thunk.
158 Invalid = 2, ///< Not used.
159 };
160
162 // Don't use unwind v2 (i.e., use v1).
164 // Use unwind v2 here possible, otherwise fallback to v1.
166 // Use unwind v2 everywhere, otherwise raise an error.
168 };
169
170 } // namespace llvm
171
172#endif
This class is the base class for all object file types.
Definition ObjectFile.h:231
Define some predicates that are used for node matching.
Definition ARMEHABI.h:25
@ C
The default llvm calling convention, compatible with C.
Definition CallingConv.h:34
std::optional< CodeGenOptLevel > getLevel(int OL)
Get the Level identified by the integer OL.
Definition CodeGen.h:93
std::optional< CodeGenOptLevel > parseLevel(char C)
Parse C as a single digit integer and get matching CodeGenLevel.
Definition CodeGen.h:101
@ Static
Definition CodeGen.h:25
@ DynamicNoPIC
Definition CodeGen.h:25
@ ROPI_RWPI
Definition CodeGen.h:25
@ LocalDynamic
Definition CodeGen.h:47
@ InitialExec
Definition CodeGen.h:48
@ GeneralDynamic
Definition CodeGen.h:46
const unsigned ONLY_GPR
Definition CodeGen.h:123
const unsigned ONLY_USED
Definition CodeGen.h:122
const unsigned ONLY_ARG
Definition CodeGen.h:124
This is an optimization pass for GlobalISel generic memory operations.
Definition AddressRanges.h:18
FramePointerKind
Definition CodeGen.h:118
ExceptionHandling
Definition CodeGen.h:53
@ SjLj
setjmp/longjmp based exceptions
Definition CodeGen.h:56
@ ZOS
z/OS MVS Exception Handling.
Definition CodeGen.h:61
@ AIX
AIX Exception Handling.
Definition CodeGen.h:60
@ DwarfCFI
DWARF-like instruction based exceptions.
Definition CodeGen.h:55
@ Wasm
WebAssembly Exception Handling.
Definition CodeGen.h:59
UWTableKind
Definition CodeGen.h:148
@ Async
"Asynchronous" unwind tables (instr precise)
Definition CodeGen.h:151
@ Sync
"Synchronous" unwind tables
Definition CodeGen.h:150
CodeGenFileType
These enums are meant to be passed into addPassesToEmitFile to indicate what type of file to emit,...
Definition CodeGen.h:111
@ None
Definition CodeGenData.h:107
CodeGenOptLevel
Code generation optimization level.
Definition CodeGen.h:82
EABI
Definition CodeGen.h:73
@ EABI5
Definition CodeGen.h:77
@ GNU
Definition CodeGen.h:78
@ EABI4
Definition CodeGen.h:76
@ Default
The result values are uniform if and only if all operands are uniform.
Definition Uniformity.h:20
WinX64EHUnwindV2Mode
Definition CodeGen.h:161
FunctionReturnThunksKind
Definition CodeGen.h:155
@ Keep
No function return thunk.
Definition CodeGen.h:156
@ Extern
Replace returns with jump to thunk, don't emit thunk.
Definition CodeGen.h:157
Generated on for LLVM by doxygen 1.14.0

AltStyle によって変換されたページ (->オリジナル) /