clang 23.0.0git
CodeGenOptions.h
Go to the documentation of this file.
1//===--- CodeGenOptions.h ---------------------------------------*- 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 defines the CodeGenOptions interface.
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef LLVM_CLANG_BASIC_CODEGENOPTIONS_H
14#define LLVM_CLANG_BASIC_CODEGENOPTIONS_H
15
20#include "llvm/ADT/FloatingPointMode.h"
21#include "llvm/Frontend/Debug/Options.h"
22#include "llvm/Frontend/Driver/CodeGenOptions.h"
23#include "llvm/MC/MCTargetOptions.h"
24#include "llvm/Support/CodeGen.h"
25#include "llvm/Support/Hash.h"
26#include "llvm/Support/Regex.h"
27#include "llvm/Target/TargetOptions.h"
28#include "llvm/Transforms/Instrumentation/AddressSanitizerOptions.h"
29#include <map>
30#include <memory>
31#include <string>
32#include <vector>
33
34namespace llvm {
35class PassBuilder;
36}
37namespace clang {
38
39/// Bitfields of CodeGenOptions, split out from CodeGenOptions to ensure
40/// that this large collection of bitfields is a trivial class type.
42 friend class CompilerInvocation;
44
45public:
46 /// For ASTs produced with different option value, signifies their level of
47 /// compatibility.
48 enum class CompatibilityKind {
49 /// Does affect the construction of the AST in a way that does prevent
50 /// module interoperability.
52 /// Does affect the construction of the AST in a way that doesn't prevent
53 /// interoperability (that is, the value can be different between an
54 /// explicit module and the user of that module).
56 /// Does not affect the construction of the AST in any way (that is, the
57 /// value can be different between an implicit module and the user of that
58 /// module).
60 };
61
63 using ProfileInstrKind = llvm::driver::ProfileInstrKind;
65 llvm::AsanDetectStackUseAfterReturnMode;
66 using AsanDtorKind = llvm::AsanDtorKind;
67 using VectorLibrary = llvm::driver::VectorLibrary;
68 using ZeroCallUsedRegsKind = llvm::ZeroCallUsedRegs::ZeroCallUsedRegsKind;
69 using WinX64EHUnwindV2Mode = llvm::WinX64EHUnwindV2Mode;
70 using ControlFlowGuardMechanism = llvm::ControlFlowGuardMechanism;
71
72 using DebugCompressionType = llvm::DebugCompressionType;
73 using EmitDwarfUnwindType = llvm::EmitDwarfUnwindType;
74 using DebugTemplateNamesKind = llvm::codegenoptions::DebugTemplateNamesKind;
75 using DebugInfoKind = llvm::codegenoptions::DebugInfoKind;
76 using DebuggerKind = llvm::DebuggerKind;
77 using RelocSectionSymType = llvm::RelocSectionSymType;
78
79#define CODEGENOPT(Name, Bits, Default, Compatibility) unsigned Name : Bits;
80#define ENUM_CODEGENOPT(Name, Type, Bits, Default, Compatibility)
81#include "clang/Basic/CodeGenOptions.def"
82
83protected:
84#define CODEGENOPT(Name, Bits, Default, Compatibility)
85#define ENUM_CODEGENOPT(Name, Type, Bits, Default, Compatibility) \
86 unsigned Name : Bits;
87#include "clang/Basic/CodeGenOptions.def"
88};
89
90/// CodeGenOptions - Track various options which control how the code
91/// is optimized and passed to the backend.
93public:
95 NormalInlining, // Use the standard function inlining pass.
96 OnlyHintInlining, // Inline only (implicitly) hinted functions.
97 OnlyAlwaysInlining // Only run the always inlining pass.
98 };
99
105
112
114 SRCK_Default, // No special option was passed.
115 SRCK_OnStack, // Small structs on the stack (-fpcc-struct-return).
116 SRCK_InRegs // Small structs in registers (-freg-struct-return).
117 };
118
120 Embed_Off, // No embedded bitcode.
121 Embed_All, // Embed both bitcode and commandline in the output.
122 Embed_Bitcode, // Embed just the bitcode in the output.
123 Embed_Marker // Embed a marker as a placeholder for bitcode.
124 };
125
131
136
143
144 // This field stores one of the allowed values for the option
145 // -fbasic-block-sections=. The allowed values with this option are:
146 // {"all", "list=<file>", "none"}.
147 //
148 // "all" : Generate basic block sections for all basic blocks.
149 // "list=<file>": Generate basic block sections for a subset of basic blocks.
150 // The functions and the machine basic block ids are specified
151 // in the file.
152 // "none": Disable sections for basic blocks.
153 std::string BBSections;
154
155 // If set, override the default value of MCAsmInfo::BinutilsVersion. If
156 // DisableIntegratedAS is specified, the assembly output will consider GNU as
157 // support. "none" means that all ELF features can be used, regardless of
158 // binutils support.
159 std::string BinutilsVersion;
160
161 enum class FramePointerKind {
162 NonLeafNoReserve, // Keep non-leaf frame pointers, allow the FP to be used
163 // as a GPR in leaf functions.
164 None, // Omit all frame pointers.
165 Reserved, // Maintain valid frame pointer chain.
166 NonLeaf, // Keep non-leaf frame pointers, don't allow the FP to be used as a
167 // GPR in leaf functions.
168 All, // Keep all frame pointers.
169 };
170
172 switch (Kind) {
174 return "none";
176 return "reserved";
178 return "non-leaf-no-reserve";
180 return "non-leaf";
182 return "all";
183 }
184
185 llvm_unreachable("invalid FramePointerKind");
186 }
187
188 /// Possible exception handling behavior.
190
192 Auto, // Choose Swift async extended frame info based on deployment target.
193 Always, // Unconditionally emit Swift async extended frame info.
194 Never, // Don't emit Swift async extended frame info.
196 };
197
199 Language, // Not specified, use language standard.
200 Always, // All loops are assumed to be finite.
201 Never, // No loop is assumed to be finite.
202 };
203
209
211 None, ///< Trap Messages are omitted. This offers the smallest debug info
212 ///< size but at the cost of making traps hard to debug.
213 Basic, ///< Trap Message is fixed per SanitizerKind. Produces smaller debug
214 ///< info than `Detailed` but is not as helpful for debugging.
215 Detailed, ///< Trap Message includes more context (e.g. the expression being
216 ///< overflowed). This is more helpful for debugging but produces
217 ///< larger debug info than `Basic`.
218 };
219
220 /// The code model to use (-mcmodel).
221 std::string CodeModel;
222
223 /// The code model-specific large data threshold to use
224 /// (-mlarge-data-threshold).
226
227 /// The filename with path we use for coverage data files. The runtime
228 /// allows further manipulation with the GCOV_PREFIX and GCOV_PREFIX_STRIP
229 /// environment variables.
230 std::string CoverageDataFile;
231
232 /// The filename with path we use for coverage notes files.
233 std::string CoverageNotesFile;
234
235 /// Regexes separated by a semi-colon to filter the files to instrument.
237
238 /// Regexes separated by a semi-colon to filter the files to not instrument.
240
241 /// The version string to put into coverage files.
242 char CoverageVersion[4] = {'0', '0', '0', '0'};
243
244 /// Enable additional debugging information.
245 std::string DebugPass;
246
247 /// The string to embed in debug information as the current working directory.
249
250 /// The string to embed in coverage mapping as the current working directory.
252
253 /// The string to embed in the debug information for the compile unit, if
254 /// non-empty.
255 std::string DwarfDebugFlags;
256
257 /// The string containing the commandline for the llvm.commandline metadata,
258 /// if non-empty.
259 std::string RecordCommandLine;
260
262
263 /// Prefix replacement map for source-based code coverage to remap source
264 /// file paths in coverage mapping.
266
267 /// The ABI to use for passing floating point arguments.
268 std::string FloatABI;
269
270 /// The file to use for dumping bug report by `Debugify` for original
271 /// debug info.
273
274 /// The floating-point denormal mode to use.
275 llvm::DenormalMode FPDenormalMode = llvm::DenormalMode::getIEEE();
276
277 /// The floating-point denormal mode to use, for float.
278 llvm::DenormalMode FP32DenormalMode = llvm::DenormalMode::getIEEE();
279
280 /// The float precision limit to use, if non-empty.
282
284 /// The filename of the bitcode file to link in.
285 std::string Filename;
286 /// If true, we set attributes functions in the bitcode library according to
287 /// our CodeGenOptions, much as we set attrs on functions that we generate
288 /// ourselves.
289 bool PropagateAttrs = false;
290 /// If true, we use LLVM module internalizer.
291 bool Internalize = false;
292 /// Bitwise combination of llvm::Linker::Flags, passed to the LLVM linker.
293 unsigned LinkFlags = 0;
294 };
295
296 /// The files specified here are linked in to the module before optimizations.
297 std::vector<BitcodeFileToLink> LinkBitcodeFiles;
298
299 /// The user provided name for the "main file", if non-empty. This is useful
300 /// in situations where the input file name does not match the original input
301 /// file, for example with -save-temps.
302 std::string MainFileName;
303
304 /// The name for the split debug info file used for the DW_AT_[GNU_]dwo_name
305 /// attribute in the skeleton CU.
306 std::string SplitDwarfFile;
307
308 /// Output filename for the split debug info, not used in the skeleton CU.
309 std::string SplitDwarfOutput;
310
311 /// Output filename used in the COFF debug information.
313
314 /// The name of the relocation model to use.
315 llvm::Reloc::Model RelocationModel;
316
317 /// If not an empty string, trap intrinsics are lowered to calls to this
318 /// function instead of to trap instructions.
319 std::string TrapFuncName;
320
321 /// A list of dependent libraries.
322 std::vector<std::string> DependentLibraries;
323
324 /// A list of linker options to embed in the object file.
325 std::vector<std::string> LinkerOptions;
326
327 /// Name of the profile file to use as output for -fprofile-instr-generate,
328 /// -fprofile-generate, and -fcs-profile-generate.
330
331 /// Name of the patchable function entry section with
332 /// -fpatchable-function-entry.
334
335 /// Name of the profile file to use with -fprofile-sample-use.
336 std::string SampleProfileFile;
337
338 /// Name of the profile file to use as output for with -fmemory-profile.
340
341 /// Name of the profile file to use as input for -fmemory-profile-use.
343
344 /// Name of the profile file to use as input for -fprofile-instr-use
346
347 /// Name of the profile remapping file to apply to the profile data supplied
348 /// by -fprofile-sample-use or -fprofile-instr-use.
350
351 /// Name of the function summary index file to use for ThinLTO function
352 /// importing.
353 std::string ThinLTOIndexFile;
354
355 /// Name of a file that can optionally be written with minimized bitcode
356 /// to be used as input for the ThinLTO thin link step, which only needs
357 /// the summary and module symbol table (and not, e.g. any debug metadata).
359
360 /// Prefix to use for -save-temps output.
362
363 /// Name of file passed with -fcuda-include-gpubinary option to forward to
364 /// CUDA runtime back-end for incorporating them into host-side object file.
366
367 /// List of filenames passed in using the -fembed-offload-object option. These
368 /// are offloading binaries containing device images and metadata.
369 std::vector<std::string> OffloadObjects;
370
371 /// The name of the file to which the backend should save YAML optimization
372 /// records.
373 std::string OptRecordFile;
374
375 /// The regex that filters the passes that should be saved to the optimization
376 /// records.
377 std::string OptRecordPasses;
378
379 /// The format used for serializing remarks (default: YAML)
380 std::string OptRecordFormat;
381
382 /// The name of the partition that symbols are assigned to, specified with
383 /// -fsymbol-partition (see https://lld.llvm.org/Partitions.html).
384 std::string SymbolPartition;
385
386 /// If non-empty, allow the compiler to assume that the given source file
387 /// identifier is unique at link time.
389
391 RK_Missing, // Remark argument not present on the command line.
392 RK_Enabled, // Remark enabled via '-Rgroup'.
393 RK_EnabledEverything, // Remark enabled via '-Reverything'.
394 RK_Disabled, // Remark disabled via '-Rno-group'.
395 RK_DisabledEverything, // Remark disabled via '-Rno-everything'.
396 RK_WithPattern, // Remark pattern specified via '-Rgroup=regexp'.
397 };
398
399 /// Optimization remark with an optional regular expression pattern.
400 struct OptRemark {
402 std::string Pattern;
403 std::shared_ptr<llvm::Regex> Regex;
404
405 /// By default, optimization remark is missing.
406 OptRemark() = default;
407
408 /// Returns true iff the optimization remark holds a valid regular
409 /// expression.
410 bool hasValidPattern() const { return Regex != nullptr; }
411
412 /// Matches the given string against the regex, if there is some.
413 bool patternMatches(StringRef String) const {
414 return hasValidPattern() && Regex->match(String);
415 }
416 };
417
418 /// Selected optimizations for which we should enable optimization remarks.
419 /// Transformation passes whose name matches the contained (optional) regular
420 /// expression (and support this feature), will emit a diagnostic whenever
421 /// they perform a transformation.
423
424 /// Selected optimizations for which we should enable missed optimization
425 /// remarks. Transformation passes whose name matches the contained (optional)
426 /// regular expression (and support this feature), will emit a diagnostic
427 /// whenever they tried but failed to perform a transformation.
429
430 /// Selected optimizations for which we should enable optimization analyses.
431 /// Transformation passes whose name matches the contained (optional) regular
432 /// expression (and support this feature), will emit a diagnostic whenever
433 /// they want to explain why they decided to apply or not apply a given
434 /// transformation.
436
437 /// Set of sanitizer checks that are non-fatal (i.e. execution should be
438 /// continued when possible).
440
441 /// Set of sanitizer checks that trap rather than diagnose.
443
444 /// Set of sanitizer checks that can merge handlers (smaller code size at
445 /// the expense of debuggability).
447
448 /// Set of thresholds in a range [0.0, 1.0]: the top hottest code responsible
449 /// for the given fraction of PGO counters will be excluded from sanitization
450 /// (0.0 [default] to skip none, 1.0 to skip all).
452
453 /// Set of sanitizer checks, for which the instrumentation will be annotated
454 /// with extra debug info.
456
457 std::optional<double> AllowRuntimeCheckSkipHotCutoff;
458
459 /// List of backend command-line options for -fembed-bitcode.
460 std::vector<uint8_t> CmdArgs;
461
462 /// A list of all -fno-builtin-* function names (e.g., memset).
463 std::vector<std::string> NoBuiltinFuncs;
464
465 std::vector<std::string> Reciprocals;
466
467 /// Configuration for pointer-signing.
469
470 /// The preferred width for auto-vectorization transforms. This is intended to
471 /// override default transforms based on the width of the architected vector
472 /// registers.
473 std::string PreferVectorWidth;
474
475 /// Set of XRay instrumentation kinds to emit.
477
478 std::vector<std::string> DefaultFunctionAttrs;
479
480 /// List of dynamic shared object files to be loaded as pass plugins.
481 std::vector<std::string> PassPlugins;
482
483 /// List of pass builder callbacks.
484 std::vector<std::function<void(llvm::PassBuilder &)>> PassBuilderCallbacks;
485
486 /// List of global variables explicitly specified by the user as toc-data.
487 std::vector<std::string> TocDataVarsUserSpecified;
488
489 /// List of global variables that over-ride the toc-data default.
490 std::vector<std::string> NoTocDataVars;
491
492 /// Path to allowlist file specifying which objects
493 /// (files, functions) should exclusively be instrumented
494 /// by sanitizer coverage pass.
495 std::vector<std::string> SanitizeCoverageAllowlistFiles;
496
497 /// The guard style used for stack protector to get a initial value, this
498 /// value usually be gotten from TLS or get from __stack_chk_guard, or some
499 /// other styles we may implement in the future.
501
502 /// The TLS base register when StackProtectorGuard is "tls", or register used
503 /// to store the stack canary for "sysreg".
504 /// On x86 this can be "fs" or "gs".
505 /// On AArch64 this can only be "sp_el0".
507
508 /// Specify a symbol to be the guard value.
510
511 /// Path to ignorelist file specifying which objects
512 /// (files, functions) listed for instrumentation by sanitizer
513 /// coverage pass should actually not be instrumented.
514 std::vector<std::string> SanitizeCoverageIgnorelistFiles;
515
516 /// Path to ignorelist file specifying which objects
517 /// (files, functions) listed for instrumentation by sanitizer
518 /// binary metadata pass should not be instrumented.
519 std::vector<std::string> SanitizeMetadataIgnorelistFiles;
520
521 /// Hash algorithm to use for KCFI type IDs.
522 llvm::KCFIHashAlgorithm SanitizeKcfiHash;
523
524 /// Name of the stack usage file (i.e., .su file) if user passes
525 /// -fstack-usage. If empty, it can be implied that -fstack-usage is not
526 /// passed on the command line.
527 std::string StackUsageFile;
528
529 /// Executable and command-line used to create a given CompilerInvocation.
530 /// Most of the time this will be the full -cc1 command.
531 const char *Argv0 = nullptr;
532 std::vector<std::string> CommandLineArgs;
533
534 /// The minimum hotness value a diagnostic needs in order to be included in
535 /// optimization diagnostics.
536 ///
537 /// The threshold is an Optional value, which maps to one of the 3 states:
538 /// 1. 0 => threshold disabled. All remarks will be printed.
539 /// 2. positive int => manual threshold by user. Remarks with hotness exceed
540 /// threshold will be printed.
541 /// 3. None => 'auto' threshold by user. The actual value is not
542 /// available at command line, but will be synced with
543 /// hotness threshold from profile summary during
544 /// compilation.
545 ///
546 /// If threshold option is not specified, it is disabled by default.
547 std::optional<uint64_t> DiagnosticsHotnessThreshold = 0;
548
549 /// The maximum percentage profiling weights can deviate from the expected
550 /// values in order to be included in misexpect diagnostics.
551 std::optional<uint32_t> DiagnosticsMisExpectTolerance = 0;
552
553 /// The name of a file to use with \c .secure_log_unique directives.
554 std::string AsSecureLogFile;
555
556 /// A list of functions that are replacable by the loader.
557 std::vector<std::string> LoaderReplaceableFunctionNames;
558 /// The name of a file that contains functions which will be compiled for
559 /// hotpatching. See -fms-secure-hotpatch-functions-file.
561
562 /// A list of functions which will be compiled for hotpatching.
563 /// See -fms-secure-hotpatch-functions-list.
564 std::vector<std::string> MSSecureHotPatchFunctionsList;
565
566public:
567 // Define accessors/mutators for code generation options of enumeration type.
568#define CODEGENOPT(Name, Bits, Default, Compatibility)
569#define ENUM_CODEGENOPT(Name, Type, Bits, Default, Compatibility) \
570 Type get##Name() const { return static_cast<Type>(Name); } \
571 void set##Name(Type Value) { Name = static_cast<unsigned>(Value); }
572#include "clang/Basic/CodeGenOptions.def"
573
575
576 const std::vector<std::string> &getNoBuiltinFuncs() const {
577 return NoBuiltinFuncs;
578 }
579
580 bool hasSjLjExceptions() const {
581 return getExceptionHandling() == ExceptionHandlingKind::SjLj;
582 }
583
584 bool hasSEHExceptions() const {
585 return getExceptionHandling() == ExceptionHandlingKind::WinEH;
586 }
587
588 bool hasDWARFExceptions() const {
589 return getExceptionHandling() == ExceptionHandlingKind::DwarfCFI;
590 }
591
592 bool hasWasmExceptions() const {
593 return getExceptionHandling() == ExceptionHandlingKind::Wasm;
594 }
595
596 /// Check if Clang profile instrumenation is on.
597 bool hasProfileClangInstr() const {
598 return getProfileInstr() ==
599 llvm::driver::ProfileInstrKind::ProfileClangInstr;
600 }
601
602 /// Check if IR level profile instrumentation is on.
603 bool hasProfileIRInstr() const {
604 return getProfileInstr() == llvm::driver::ProfileInstrKind::ProfileIRInstr;
605 }
606
607 /// Check if CS IR level profile instrumentation is on.
608 bool hasProfileCSIRInstr() const {
609 return getProfileInstr() ==
610 llvm::driver::ProfileInstrKind::ProfileCSIRInstr;
611 }
612
613 /// Check if any form of instrumentation is on.
614 bool hasProfileInstr() const {
615 return getProfileInstr() != llvm::driver::ProfileInstrKind::ProfileNone;
616 }
617
618 /// Check if Clang profile use is on.
619 bool hasProfileClangUse() const {
620 return getProfileUse() == llvm::driver::ProfileInstrKind::ProfileClangInstr;
621 }
622
623 /// Check if IR level profile use is on.
624 bool hasProfileIRUse() const {
625 return getProfileUse() == llvm::driver::ProfileInstrKind::ProfileIRInstr ||
626 getProfileUse() == llvm::driver::ProfileInstrKind::ProfileCSIRInstr;
627 }
628
629 /// Check if CSIR profile use is on.
630 bool hasProfileCSIRUse() const {
631 return getProfileUse() == llvm::driver::ProfileInstrKind::ProfileCSIRInstr;
632 }
633
634 /// Check if type and variable info should be emitted.
635 bool hasReducedDebugInfo() const {
636 return getDebugInfo() >= llvm::codegenoptions::DebugInfoConstructor;
637 }
638
639 /// Check if maybe unused type info should be emitted.
641 return getDebugInfo() >= llvm::codegenoptions::UnusedTypeInfo;
642 }
643
644 // Check if any one of SanitizeCoverage* is enabled.
645 bool hasSanitizeCoverage() const {
646 return SanitizeCoverageType || SanitizeCoverageIndirectCalls ||
647 SanitizeCoverageTraceCmp || SanitizeCoverageTraceLoads ||
648 SanitizeCoverageTraceStores || SanitizeCoverageControlFlow;
649 }
650
651 // Check if any one of SanitizeBinaryMetadata* is enabled.
653 return SanitizeBinaryMetadataCovered || SanitizeBinaryMetadataAtomics ||
654 SanitizeBinaryMetadataUAR;
655 }
656
657 /// Reset all of the options that are not considered when building a
658 /// module.
659 void resetNonModularOptions(StringRef ModuleFormat);
660
661 // Is the given function name one of the functions that can be replaced by the
662 // loader?
663 bool isLoaderReplaceableFunctionName(StringRef FuncName) const {
664 return llvm::is_contained(LoaderReplaceableFunctionNames, FuncName);
665 }
666};
667
668} // end namespace clang
669
670#endif
Defines the clang::SanitizerKind enum.
Defines the clang::XRayInstrKind enum.
Bitfields of CodeGenOptions, split out from CodeGenOptions to ensure that this large collection of bi...
llvm::driver::ProfileInstrKind ProfileInstrKind
llvm::AsanDtorKind AsanDtorKind
llvm::ZeroCallUsedRegs::ZeroCallUsedRegsKind ZeroCallUsedRegsKind
llvm::codegenoptions::DebugInfoKind DebugInfoKind
llvm::DebuggerKind DebuggerKind
llvm::WinX64EHUnwindV2Mode WinX64EHUnwindV2Mode
llvm::EmitDwarfUnwindType EmitDwarfUnwindType
llvm::AsanDetectStackUseAfterReturnMode AsanDetectStackUseAfterReturnMode
CompatibilityKind
For ASTs produced with different option value, signifies their level of compatibility.
@ NotCompatible
Does affect the construction of the AST in a way that does prevent module interoperability.
@ Compatible
Does affect the construction of the AST in a way that doesn't prevent interoperability (that is,...
@ Benign
Does not affect the construction of the AST in any way (that is, the value can be different between a...
friend class CompilerInvocationBase
llvm::ControlFlowGuardMechanism ControlFlowGuardMechanism
llvm::DebugCompressionType DebugCompressionType
llvm::RelocSectionSymType RelocSectionSymType
llvm::driver::VectorLibrary VectorLibrary
llvm::codegenoptions::DebugTemplateNamesKind DebugTemplateNamesKind
clang::CFBranchLabelSchemeKind CFBranchLabelSchemeKind
llvm::SmallVector< std::pair< std::string, std::string >, 0 > CoveragePrefixMap
Prefix replacement map for source-based code coverage to remap source file paths in coverage mapping.
std::string StackProtectorGuardSymbol
Specify a symbol to be the guard value.
SanitizerSet SanitizeMergeHandlers
Set of sanitizer checks that can merge handlers (smaller code size at the expense of debuggability).
std::string StackUsageFile
Name of the stack usage file (i.e., .su file) if user passes -fstack-usage.
std::string UniqueSourceFileIdentifier
If non-empty, allow the compiler to assume that the given source file identifier is unique at link ti...
std::string MSSecureHotPatchFunctionsFile
The name of a file that contains functions which will be compiled for hotpatching.
const std::vector< std::string > & getNoBuiltinFuncs() const
std::vector< std::string > LoaderReplaceableFunctionNames
A list of functions that are replacable by the loader.
llvm::SmallVector< std::pair< std::string, std::string >, 0 > DebugPrefixMap
@ None
Trap Messages are omitted.
@ Detailed
Trap Message includes more context (e.g.
@ Basic
Trap Message is fixed per SanitizerKind.
std::string OptRecordFile
The name of the file to which the backend should save YAML optimization records.
std::string InstrProfileOutput
Name of the profile file to use as output for -fprofile-instr-generate, -fprofile-generate,...
std::string StackProtectorGuard
The guard style used for stack protector to get a initial value, this value usually be gotten from TL...
bool hasDWARFExceptions() const
std::vector< BitcodeFileToLink > LinkBitcodeFiles
The files specified here are linked in to the module before optimizations.
std::string RecordCommandLine
The string containing the commandline for the llvm.commandline metadata, if non-empty.
std::optional< uint64_t > DiagnosticsHotnessThreshold
The minimum hotness value a diagnostic needs in order to be included in optimization diagnostics.
bool hasProfileInstr() const
Check if any form of instrumentation is on.
bool hasProfileIRUse() const
Check if IR level profile use is on.
char CoverageVersion[4]
The version string to put into coverage files.
std::string FloatABI
The ABI to use for passing floating point arguments.
std::string ThinLinkBitcodeFile
Name of a file that can optionally be written with minimized bitcode to be used as input for the Thin...
bool hasProfileCSIRInstr() const
Check if CS IR level profile instrumentation is on.
std::vector< std::string > DependentLibraries
A list of dependent libraries.
std::string DebugPass
Enable additional debugging information.
llvm::Reloc::Model RelocationModel
The name of the relocation model to use.
llvm::DenormalMode FPDenormalMode
The floating-point denormal mode to use.
std::string CoverageNotesFile
The filename with path we use for coverage notes files.
std::string ProfileInstrumentUsePath
Name of the profile file to use as input for -fprofile-instr-use.
std::string SampleProfileFile
Name of the profile file to use with -fprofile-sample-use.
uint64_t LargeDataThreshold
The code model-specific large data threshold to use (-mlarge-data-threshold).
static StringRef getFramePointerKindName(FramePointerKind Kind)
std::string MemoryProfileOutput
Name of the profile file to use as output for with -fmemory-profile.
std::vector< std::function< void(llvm::PassBuilder &)> > PassBuilderCallbacks
List of pass builder callbacks.
std::string LimitFloatPrecision
The float precision limit to use, if non-empty.
std::string CodeModel
The code model to use (-mcmodel).
std::vector< std::string > TocDataVarsUserSpecified
List of global variables explicitly specified by the user as toc-data.
std::string CoverageDataFile
The filename with path we use for coverage data files.
std::vector< std::string > PassPlugins
List of dynamic shared object files to be loaded as pass plugins.
bool hasProfileClangInstr() const
Check if Clang profile instrumenation is on.
std::string DebugCompilationDir
The string to embed in debug information as the current working directory.
std::optional< uint32_t > DiagnosticsMisExpectTolerance
The maximum percentage profiling weights can deviate from the expected values in order to be included...
std::string OptRecordPasses
The regex that filters the passes that should be saved to the optimization records.
std::vector< std::string > SanitizeCoverageAllowlistFiles
Path to allowlist file specifying which objects (files, functions) should exclusively be instrumented...
std::string SaveTempsFilePrefix
Prefix to use for -save-temps output.
std::string PatchableFunctionEntrySection
Name of the patchable function entry section with -fpatchable-function-entry.
XRayInstrSet XRayInstrumentationBundle
Set of XRay instrumentation kinds to emit.
std::vector< std::string > SanitizeCoverageIgnorelistFiles
Path to ignorelist file specifying which objects (files, functions) listed for instrumentation by san...
bool hasSanitizeCoverage() const
std::vector< std::string > Reciprocals
std::string MainFileName
The user provided name for the "main file", if non-empty.
std::string CudaGpuBinaryFileName
Name of file passed with -fcuda-include-gpubinary option to forward to CUDA runtime back-end for inco...
SanitizerSet SanitizeAnnotateDebugInfo
Set of sanitizer checks, for which the instrumentation will be annotated with extra debug info.
PointerAuthOptions PointerAuth
Configuration for pointer-signing.
llvm::DenormalMode FP32DenormalMode
The floating-point denormal mode to use, for float.
bool hasProfileIRInstr() const
Check if IR level profile instrumentation is on.
bool hasProfileCSIRUse() const
Check if CSIR profile use is on.
std::string CoverageCompilationDir
The string to embed in coverage mapping as the current working directory.
SanitizerSet SanitizeTrap
Set of sanitizer checks that trap rather than diagnose.
std::vector< std::string > SanitizeMetadataIgnorelistFiles
Path to ignorelist file specifying which objects (files, functions) listed for instrumentation by san...
SanitizerSet SanitizeRecover
Set of sanitizer checks that are non-fatal (i.e.
std::string ProfileExcludeFiles
Regexes separated by a semi-colon to filter the files to not instrument.
std::string AsSecureLogFile
The name of a file to use with .secure_log_unique directives.
std::string ProfileRemappingFile
Name of the profile remapping file to apply to the profile data supplied by -fprofile-sample-use or -...
bool hasReducedDebugInfo() const
Check if type and variable info should be emitted.
bool hasSanitizeBinaryMetadata() const
OptRemark OptimizationRemark
Selected optimizations for which we should enable optimization remarks.
llvm::KCFIHashAlgorithm SanitizeKcfiHash
Hash algorithm to use for KCFI type IDs.
std::string ThinLTOIndexFile
Name of the function summary index file to use for ThinLTO function importing.
const char * Argv0
Executable and command-line used to create a given CompilerInvocation.
bool hasWasmExceptions() const
bool hasSjLjExceptions() const
std::string TrapFuncName
If not an empty string, trap intrinsics are lowered to calls to this function instead of to trap inst...
SanitizerMaskCutoffs SanitizeSkipHotCutoffs
Set of thresholds in a range [0.0, 1.0]: the top hottest code responsible for the given fraction of P...
std::string SplitDwarfFile
The name for the split debug info file used for the DW_AT_[GNU_]dwo_name attribute in the skeleton CU...
std::string StackProtectorGuardReg
The TLS base register when StackProtectorGuard is "tls", or register used to store the stack canary f...
std::vector< std::string > DefaultFunctionAttrs
std::vector< std::string > NoBuiltinFuncs
A list of all -fno-builtin-* function names (e.g., memset).
std::vector< uint8_t > CmdArgs
List of backend command-line options for -fembed-bitcode.
OptRemark OptimizationRemarkAnalysis
Selected optimizations for which we should enable optimization analyses.
std::optional< double > AllowRuntimeCheckSkipHotCutoff
std::vector< std::string > CommandLineArgs
std::vector< std::string > LinkerOptions
A list of linker options to embed in the object file.
bool hasSEHExceptions() const
std::string MemoryProfileUsePath
Name of the profile file to use as input for -fmemory-profile-use.
std::vector< std::string > MSSecureHotPatchFunctionsList
A list of functions which will be compiled for hotpatching.
void resetNonModularOptions(StringRef ModuleFormat)
Reset all of the options that are not considered when building a module.
ExceptionHandlingKind
Possible exception handling behavior.
std::string OptRecordFormat
The format used for serializing remarks (default: YAML)
bool hasProfileClangUse() const
Check if Clang profile use is on.
std::vector< std::string > OffloadObjects
List of filenames passed in using the -fembed-offload-object option.
std::string SymbolPartition
The name of the partition that symbols are assigned to, specified with -fsymbol-partition (see https:...
std::vector< std::string > NoTocDataVars
List of global variables that over-ride the toc-data default.
std::string ProfileFilterFiles
Regexes separated by a semi-colon to filter the files to instrument.
bool hasMaybeUnusedDebugInfo() const
Check if maybe unused type info should be emitted.
std::string PreferVectorWidth
The preferred width for auto-vectorization transforms.
std::string ObjectFilenameForDebug
Output filename used in the COFF debug information.
std::string SplitDwarfOutput
Output filename for the split debug info, not used in the skeleton CU.
bool isLoaderReplaceableFunctionName(StringRef FuncName) const
std::string DwarfDebugFlags
The string to embed in the debug information for the compile unit, if non-empty.
std::string DIBugsReportFilePath
The file to use for dumping bug report by Debugify for original debug info.
OptRemark OptimizationRemarkMissed
Selected optimizations for which we should enable missed optimization remarks.
The JSON file list parser is used to communicate input to InstallAPI.
Diagnostic wrappers for TextAPI types for error reporting.
Definition Dominators.h:30
int const char * function
Definition c++config.h:31
Optimization remark with an optional regular expression pattern.
std::shared_ptr< llvm::Regex > Regex
bool patternMatches(StringRef String) const
Matches the given string against the regex, if there is some.
OptRemark()=default
By default, optimization remark is missing.
bool hasValidPattern() const
Returns true iff the optimization remark holds a valid regular expression.