1 //===-- CommandFlags.h - Command Line Flags Interface -----------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file contains codegen-specific flags that are shared between different
11 // command line tools. The tools "llc" and "opt" both use this file to prevent
14 //===----------------------------------------------------------------------===//
16 #ifndef LLVM_CODEGEN_COMMANDFLAGS_H
17 #define LLVM_CODEGEN_COMMANDFLAGS_H
19 #include "llvm/MC/MCTargetOptionsCommandFlags.h"
20 #include "llvm/Support/CodeGen.h"
21 #include "llvm/Support/CommandLine.h"
22 #include "llvm/Target/TargetMachine.h"
23 #include "llvm/Target/TargetOptions.h"
28 MArch("march", cl::desc("Architecture to generate code for (see --version)"));
32 cl::desc("Target a specific cpu type (-mcpu=help for details)"),
33 cl::value_desc("cpu-name"),
39 cl::desc("Target specific attributes (-mattr=help for details)"),
40 cl::value_desc("a1,+a2,-a3,..."));
43 RelocModel("relocation-model",
44 cl::desc("Choose relocation model"),
45 cl::init(Reloc::Default
),
47 clEnumValN(Reloc::Default
, "default",
48 "Target default relocation model"),
49 clEnumValN(Reloc::Static
, "static",
50 "Non-relocatable code"),
51 clEnumValN(Reloc::PIC_
, "pic",
52 "Fully relocatable, position independent code"),
53 clEnumValN(Reloc::DynamicNoPIC
, "dynamic-no-pic",
54 "Relocatable external references, non-relocatable code"),
57 cl::opt
<ThreadModel::Model
>
58 TMModel("thread-model",
59 cl::desc("Choose threading model"),
60 cl::init(ThreadModel::POSIX
),
61 cl::values(clEnumValN(ThreadModel::POSIX
, "posix",
62 "POSIX thread model"),
63 clEnumValN(ThreadModel::Single
, "single",
64 "Single thread model"),
67 cl::opt
<llvm::CodeModel::Model
>
69 cl::desc("Choose code model"),
70 cl::init(CodeModel::Default
),
71 cl::values(clEnumValN(CodeModel::Default
, "default",
72 "Target default code model"),
73 clEnumValN(CodeModel::Small
, "small",
75 clEnumValN(CodeModel::Kernel
, "kernel",
77 clEnumValN(CodeModel::Medium
, "medium",
79 clEnumValN(CodeModel::Large
, "large",
83 cl::opt
<TargetMachine::CodeGenFileType
>
84 FileType("filetype", cl::init(TargetMachine::CGFT_AssemblyFile
),
85 cl::desc("Choose a file type (not all types are supported by all targets):"),
87 clEnumValN(TargetMachine::CGFT_AssemblyFile
, "asm",
88 "Emit an assembly ('.s') file"),
89 clEnumValN(TargetMachine::CGFT_ObjectFile
, "obj",
90 "Emit a native object ('.o') file"),
91 clEnumValN(TargetMachine::CGFT_Null
, "null",
92 "Emit nothing, for performance testing"),
96 EnableFPMAD("enable-fp-mad",
97 cl::desc("Enable less precise MAD instructions to be generated"),
101 DisableFPElim("disable-fp-elim",
102 cl::desc("Disable frame pointer elimination optimization"),
106 EnableUnsafeFPMath("enable-unsafe-fp-math",
107 cl::desc("Enable optimizations that may decrease FP precision"),
111 EnableNoInfsFPMath("enable-no-infs-fp-math",
112 cl::desc("Enable FP math optimizations that assume no +-Infs"),
116 EnableNoNaNsFPMath("enable-no-nans-fp-math",
117 cl::desc("Enable FP math optimizations that assume no NaNs"),
121 EnableHonorSignDependentRoundingFPMath("enable-sign-dependent-rounding-fp-math",
123 cl::desc("Force codegen to assume rounding mode can change dynamically"),
127 GenerateSoftFloatCalls("soft-float",
128 cl::desc("Generate software floating point library calls"),
131 cl::opt
<llvm::FloatABI::ABIType
>
132 FloatABIForCalls("float-abi",
133 cl::desc("Choose float ABI type"),
134 cl::init(FloatABI::Default
),
136 clEnumValN(FloatABI::Default
, "default",
137 "Target default float ABI type"),
138 clEnumValN(FloatABI::Soft
, "soft",
139 "Soft float ABI (implied by -soft-float)"),
140 clEnumValN(FloatABI::Hard
, "hard",
141 "Hard float ABI (uses FP registers)"),
144 cl::opt
<llvm::FPOpFusion::FPOpFusionMode
>
145 FuseFPOps("fp-contract",
146 cl::desc("Enable aggressive formation of fused FP ops"),
147 cl::init(FPOpFusion::Standard
),
149 clEnumValN(FPOpFusion::Fast
, "fast",
150 "Fuse FP ops whenever profitable"),
151 clEnumValN(FPOpFusion::Standard
, "on",
152 "Only fuse 'blessed' FP ops."),
153 clEnumValN(FPOpFusion::Strict
, "off",
154 "Only fuse FP ops when the result won't be effected."),
158 DontPlaceZerosInBSS("nozero-initialized-in-bss",
159 cl::desc("Don't place zero-initialized symbols into bss section"),
163 EnableGuaranteedTailCallOpt("tailcallopt",
164 cl::desc("Turn fastcc calls into tail calls by (potentially) changing ABI."),
168 DisableTailCalls("disable-tail-calls",
169 cl::desc("Never emit tail calls"),
173 OverrideStackAlignment("stack-alignment",
174 cl::desc("Override default stack alignment"),
178 TrapFuncName("trap-func", cl::Hidden
,
179 cl::desc("Emit a call to trap function rather than a trap instruction"),
183 EnablePIE("enable-pie",
184 cl::desc("Assume the creation of a position independent executable."),
188 UseCtors("use-ctors",
189 cl::desc("Use .ctors instead of .init_array."),
192 cl::opt
<std::string
> StopAfter("stop-after",
193 cl::desc("Stop compilation after a specific pass"),
194 cl::value_desc("pass-name"),
196 cl::opt
<std::string
> StartAfter("start-after",
197 cl::desc("Resume compilation after a specific pass"),
198 cl::value_desc("pass-name"),
201 cl::opt
<bool> DataSections("data-sections",
202 cl::desc("Emit data into separate sections"),
206 FunctionSections("function-sections",
207 cl::desc("Emit functions into separate sections"),
210 cl::opt
<llvm::JumpTable::JumpTableType
>
211 JTableType("jump-table-type",
212 cl::desc("Choose the type of Jump-Instruction Table for jumptable."),
213 cl::init(JumpTable::Single
),
215 clEnumValN(JumpTable::Single
, "single",
216 "Create a single table for all jumptable functions"),
217 clEnumValN(JumpTable::Arity
, "arity",
218 "Create one table per number of parameters."),
219 clEnumValN(JumpTable::Simplified
, "simplified",
220 "Create one table per simplified function type."),
221 clEnumValN(JumpTable::Full
, "full",
222 "Create one table per unique function type."),
227 cl::desc("Apply forward-edge control-flow integrity"),
230 cl::opt
<llvm::CFIntegrity
>
232 cl::desc("Choose the type of Control-Flow Integrity check to add"),
233 cl::init(CFIntegrity::Sub
),
235 clEnumValN(CFIntegrity::Sub
, "sub",
236 "Subtract the pointer from the table base, then mask."),
237 clEnumValN(CFIntegrity::Ror
, "ror",
238 "Use rotate to check the offset from a table base."),
239 clEnumValN(CFIntegrity::Add
, "add",
240 "Mask out the high bits and add to an aligned base."),
244 CFIEnforcing("cfi-enforcing",
245 cl::desc("Enforce CFI or pass the violation to a function."),
248 // Note that this option is linked to the cfi-enforcing option above: if
249 // cfi-enforcing is set, then the cfi-func-name option is entirely ignored. If
250 // cfi-enforcing is false and no cfi-func-name is set, then a default function
251 // will be generated that ignores all CFI violations. The expected signature for
252 // functions called with CFI violations is
256 // The first pointer is a C string containing the name of the function in which
257 // the violation occurs, and the second pointer is the pointer that violated
260 CFIFuncName("cfi-func-name", cl::desc("The name of the CFI function to call"),
263 // Common utility function tightly tied to the options listed here. Initializes
264 // a TargetOptions object with CodeGen flags and returns it.
265 static inline TargetOptions
InitTargetOptionsFromCodeGenFlags() {
266 TargetOptions Options
;
267 Options
.LessPreciseFPMADOption
= EnableFPMAD
;
268 Options
.NoFramePointerElim
= DisableFPElim
;
269 Options
.AllowFPOpFusion
= FuseFPOps
;
270 Options
.UnsafeFPMath
= EnableUnsafeFPMath
;
271 Options
.NoInfsFPMath
= EnableNoInfsFPMath
;
272 Options
.NoNaNsFPMath
= EnableNoNaNsFPMath
;
273 Options
.HonorSignDependentRoundingFPMathOption
=
274 EnableHonorSignDependentRoundingFPMath
;
275 Options
.UseSoftFloat
= GenerateSoftFloatCalls
;
276 if (FloatABIForCalls
!= FloatABI::Default
)
277 Options
.FloatABIType
= FloatABIForCalls
;
278 Options
.NoZerosInBSS
= DontPlaceZerosInBSS
;
279 Options
.GuaranteedTailCallOpt
= EnableGuaranteedTailCallOpt
;
280 Options
.DisableTailCalls
= DisableTailCalls
;
281 Options
.StackAlignmentOverride
= OverrideStackAlignment
;
282 Options
.TrapFuncName
= TrapFuncName
;
283 Options
.PositionIndependentExecutable
= EnablePIE
;
284 Options
.UseInitArray
= !UseCtors
;
285 Options
.DataSections
= DataSections
;
286 Options
.FunctionSections
= FunctionSections
;
288 Options
.MCOptions
= InitMCTargetOptionsFromFlags();
289 Options
.JTType
= JTableType
;
291 Options
.CFIType
= CFIType
;
292 Options
.CFIEnforcing
= CFIEnforcing
;
293 Options
.CFIFuncName
= CFIFuncName
;
295 Options
.ThreadModel
= TMModel
;