43#define DEBUG_TYPE "sancov"
72 "sancov.module_ctor_trace_pc_guard";
74 "sancov.module_ctor_8bit_counters";
100 switch (LegacyCoverageLevel) {
127 Options.TraceCmp |= Opts.sanitizer_coverage_trace_compares;
128 Options.TraceDiv |= Opts.sanitizer_coverage_trace_divs;
129 Options.TraceGep |= Opts.sanitizer_coverage_trace_geps;
130 Options.TracePC |= Opts.sanitizer_coverage_trace_pc;
131 Options.TracePCEntryExit |= Opts.sanitizer_coverage_trace_pc_entry_exit;
132 Options.TracePCGuard |= Opts.sanitizer_coverage_trace_pc_guard;
133 Options.Inline8bitCounters |= Opts.sanitizer_coverage_inline_8bit_counters;
134 Options.InlineBoolFlag |= Opts.sanitizer_coverage_inline_bool_flag;
135 Options.PCTable |= Opts.sanitizer_coverage_pc_table;
136 Options.NoPrune |= !Opts.sanitizer_coverage_prune_blocks;
137 Options.StackDepth |= Opts.sanitizer_coverage_stack_depth;
138 Options.StackDepthCallbackMin =
139 std::max(
Options.StackDepthCallbackMin,
140 Opts.sanitizer_coverage_stack_depth_callback_min);
141 Options.TraceLoads |= Opts.sanitizer_coverage_trace_loads;
142 Options.TraceStores |= Opts.sanitizer_coverage_trace_stores;
143 Options.GatedCallbacks |= Opts.sanitizer_coverage_gated_trace_callbacks;
148 Options.CollectControlFlow |= Opts.sanitizer_coverage_control_flow;
152class ModuleSanitizerCoverage {
155 using PostDomTreeCallback =
158 ModuleSanitizerCoverage(
const InstrumentationOptions &Opts,
Module &M,
159 DomTreeCallback DTCallback,
160 PostDomTreeCallback PDTCallback,
164 : Opts(Opts), M(M), DTCallback(DTCallback), PDTCallback(PDTCallback),
167 bool instrumentModule();
170 void createFunctionControlFlow(
Function &
F);
172 void InjectCoverageForIndirectCalls(
Function &
F,
175 Value *&FunctionGateCmp);
185 Value *&FunctionGateCmp);
187 Value *&FunctionGateCmp,
bool IsLeafFunc);
188 GlobalVariable *CreateFunctionLocalArrayInSection(
size_t NumElements,
190 const char *Section);
197 Value *&FunctionGateCmp,
bool IsLeafFunc);
198 Function *CreateInitCallsForSections(
Module &M,
const char *CtorName,
199 const char *InitFunctionName,
Type *Ty,
200 const char *Section);
201 std::pair<Value *, Value *> CreateSecStartEnd(
Module &M,
const char *Section,
205 std::string getSectionStart(
const std::string &Section)
const;
206 std::string getSectionEnd(
const std::string &Section)
const;
208 const InstrumentationOptions &Opts;
210 DomTreeCallback DTCallback;
211 PostDomTreeCallback PDTCallback;
217 std::array<FunctionCallee, 4> SanCovTraceCmpFunction;
218 std::array<FunctionCallee, 4> SanCovTraceConstCmpFunction;
219 std::array<FunctionCallee, 5> SanCovLoadFunction;
220 std::array<FunctionCallee, 5> SanCovStoreFunction;
221 std::array<FunctionCallee, 2> SanCovTraceDivFunction;
226 Type *PtrTy, *IntptrTy, *Int64Ty, *Int32Ty, *Int16Ty, *Int8Ty, *Int1Ty;
249 const std::vector<std::string> &AllowlistFiles,
250 const std::vector<std::string> &BlocklistFiles)
252 VFS(VFS ?
std::
move(VFS) :
vfs::getRealFileSystem()) {
253 if (AllowlistFiles.size() > 0)
255 if (BlocklistFiles.size() > 0)
268 const InstrumentationOptions &Opts =
269 M.getContext().getLibraryOptions().get<InstrumentationOptions>();
270 ModuleSanitizerCoverage ModuleSancov(Opts, M, DTCallback, PDTCallback,
271 overrideFromCL(Opts, Options),
272 Allowlist.get(), Blocklist.get());
273 if (!ModuleSancov.instrumentModule())
284std::pair<Value *, Value *>
285ModuleSanitizerCoverage::CreateSecStartEnd(
Module &M,
const char *Section,
295 getSectionStart(Section));
298 getSectionEnd(Section));
300 if (!TargetTriple.isOSBinFormatCOFF())
301 return std::make_pair(SecStart, SecEnd);
306 SecStart, ConstantInt::get(IntptrTy,
sizeof(uint64_t)));
307 return std::make_pair(
GEP, SecEnd);
310Function *ModuleSanitizerCoverage::CreateInitCallsForSections(
311 Module &M,
const char *CtorName,
const char *InitFunctionName,
Type *Ty,
312 const char *Section) {
313 if (Opts.sanitizer_coverage_drop_ctors)
315 auto SecStartEnd = CreateSecStartEnd(M, Section, Ty);
316 auto SecStart = SecStartEnd.first;
317 auto SecEnd = SecStartEnd.second;
320 M, CtorName, InitFunctionName, {PtrTy, PtrTy}, {SecStart, SecEnd});
323 if (TargetTriple.supportsCOMDAT()) {
325 CtorFunc->
setComdat(
M.getOrInsertComdat(CtorName));
331 if (TargetTriple.isOSBinFormatCOFF()) {
343bool ModuleSanitizerCoverage::instrumentModule() {
347 !Allowlist->inSection(
"coverage",
"src",
M.getSourceFileName()))
350 Blocklist->inSection(
"coverage",
"src",
M.getSourceFileName()))
352 C = &(
M.getContext());
353 DL = &
M.getDataLayout();
355 TargetTriple =
M.getTargetTriple();
356 FunctionGuardArray =
nullptr;
357 Function8bitCounterArray =
nullptr;
358 FunctionBoolArray =
nullptr;
359 FunctionPCsArray =
nullptr;
360 FunctionCFsArray =
nullptr;
365 Int64Ty = IRB.getInt64Ty();
366 Int32Ty = IRB.getInt32Ty();
367 Int16Ty = IRB.getInt16Ty();
368 Int8Ty = IRB.getInt8Ty();
369 Int1Ty = IRB.getInt1Ty();
375 AttributeList SanCovTraceCmpZeroExtAL;
376 SanCovTraceCmpZeroExtAL =
377 SanCovTraceCmpZeroExtAL.addParamAttribute(*
C, 0, Attribute::ZExt);
378 SanCovTraceCmpZeroExtAL =
379 SanCovTraceCmpZeroExtAL.addParamAttribute(*
C, 1, Attribute::ZExt);
381 SanCovTraceCmpFunction[0] =
383 IRB.getInt8Ty(), IRB.getInt8Ty());
384 SanCovTraceCmpFunction[1] =
386 IRB.getInt16Ty(), IRB.getInt16Ty());
387 SanCovTraceCmpFunction[2] =
389 IRB.getInt32Ty(), IRB.getInt32Ty());
390 SanCovTraceCmpFunction[3] =
393 SanCovTraceConstCmpFunction[0] =
M.getOrInsertFunction(
395 SanCovTraceConstCmpFunction[1] =
M.getOrInsertFunction(
397 SanCovTraceConstCmpFunction[2] =
M.getOrInsertFunction(
399 SanCovTraceConstCmpFunction[3] =
403 SanCovLoadFunction[0] =
M.getOrInsertFunction(
SanCovLoad1, VoidTy, PtrTy);
404 SanCovLoadFunction[1] =
M.getOrInsertFunction(
SanCovLoad2, VoidTy, PtrTy);
405 SanCovLoadFunction[2] =
M.getOrInsertFunction(
SanCovLoad4, VoidTy, PtrTy);
406 SanCovLoadFunction[3] =
M.getOrInsertFunction(
SanCovLoad8, VoidTy, PtrTy);
407 SanCovLoadFunction[4] =
M.getOrInsertFunction(
SanCovLoad16, VoidTy, PtrTy);
409 SanCovStoreFunction[0] =
M.getOrInsertFunction(
SanCovStore1, VoidTy, PtrTy);
410 SanCovStoreFunction[1] =
M.getOrInsertFunction(
SanCovStore2, VoidTy, PtrTy);
411 SanCovStoreFunction[2] =
M.getOrInsertFunction(
SanCovStore4, VoidTy, PtrTy);
412 SanCovStoreFunction[3] =
M.getOrInsertFunction(
SanCovStore8, VoidTy, PtrTy);
413 SanCovStoreFunction[4] =
M.getOrInsertFunction(
SanCovStore16, VoidTy, PtrTy);
417 AL =
AL.addParamAttribute(*
C, 0, Attribute::ZExt);
418 SanCovTraceDivFunction[0] =
421 SanCovTraceDivFunction[1] =
423 SanCovTraceGepFunction =
425 SanCovTraceSwitchFunction =
429 if (SanCovLowestStack->getValueType() != IntptrTy) {
431 "' should not be declared by the user");
434 SanCovLowestStack->setThreadLocalMode(
436 if (
Options.StackDepth && !SanCovLowestStack->isDeclaration())
441 C->emitError(
"'sanitizer-coverage-gated-trace-callbacks' is only "
442 "supported with trace-pc-guard or trace-cmp");
448 SanCovCallbackGate->setSection(
462 SanCovStackDepthCallback =
466 instrumentFunction(
F);
470 if (FunctionGuardArray)
474 if (Function8bitCounterArray)
478 if (FunctionBoolArray) {
488 IRBCtor.CreateCall(InitFunction, {SecStartEnd.first, SecStartEnd.second});
491 if (Ctor &&
Options.CollectControlFlow) {
496 IRBCtor.CreateCall(InitFunction, {SecStartEnd.first, SecStartEnd.second});
542 if (
Options.NoPrune || &
F.getEntryBlock() == BB)
546 &
F.getEntryBlock() != BB)
585void ModuleSanitizerCoverage::instrumentFunction(
Function &
F) {
588 if (
F.getName().contains(
".module_ctor"))
590 if (
F.getName().starts_with(
"__sanitizer_"))
597 if (
F.getName() ==
"__local_stdio_printf_options" ||
598 F.getName() ==
"__local_stdio_scanf_options")
605 if (
F.hasPersonalityFn() &&
608 if (Allowlist && !Allowlist->inSection(
"coverage",
"fun",
F.getName()))
610 if (Blocklist && Blocklist->inSection(
"coverage",
"fun",
F.getName()))
613 if (
F.hasFnAttribute(Attribute::Naked))
615 if (
F.hasFnAttribute(Attribute::NoSanitizeCoverage))
617 if (
F.hasFnAttribute(Attribute::DisableSanitizerInstrumentation))
634 bool IsLeafFunc =
true;
639 for (
auto &Inst : BB) {
654 if (BO->getOpcode() == Instruction::SDiv ||
655 BO->getOpcode() == Instruction::UDiv)
673 if (
Options.CollectControlFlow)
674 createFunctionControlFlow(
F);
676 Value *FunctionGateCmp =
nullptr;
677 InjectCoverage(
F, BlocksToInstrument, FunctionGateCmp, IsLeafFunc);
678 InjectCoverageForIndirectCalls(
F, IndirCalls);
679 InjectTraceForCmp(
F, CmpTraceTargets, FunctionGateCmp);
680 InjectTraceForSwitch(
F, SwitchTraceTargets, FunctionGateCmp);
681 InjectTraceForDiv(
F, DivTraceTargets);
682 InjectTraceForGep(
F, GepTraceTargets);
683 InjectTraceForLoadsAndStores(
F, Loads, Stores);
686 InjectTraceForExits(
F);
689GlobalVariable *ModuleSanitizerCoverage::CreateFunctionLocalArrayInSection(
690 size_t NumElements,
Function &
F,
Type *Ty,
const char *Section) {
702 if (TargetTriple.supportsCOMDAT() &&
703 (
F.hasComdat() || TargetTriple.isOSBinFormatELF() ||
704 !
F.isInterposable(
false)))
708 Array->setAlignment(
Align(
DL->getTypeStoreSize(Ty).getFixedValue()));
712 if (
Array->hasComdat())
713 GlobalsToAppendToCompilerUsed.push_back(Array);
715 GlobalsToAppendToUsed.push_back(Array);
721ModuleSanitizerCoverage::CreatePCArray(
Function &
F,
723 size_t N = AllBlocks.
size();
726 IRBuilder<> IRB(&*
F.getEntryBlock().getFirstInsertionPt());
727 for (
size_t i = 0; i <
N; i++) {
728 if (&
F.getEntryBlock() == AllBlocks[i]) {
731 (
Constant *)IRB.CreateIntToPtr(ConstantInt::get(IntptrTy, 1), PtrTy));
740 PCArray->setInitializer(
742 PCArray->setConstant(
true);
747void ModuleSanitizerCoverage::CreateFunctionLocalArrays(
750 FunctionGuardArray = CreateFunctionLocalArrayInSection(
753 if (
Options.Inline8bitCounters)
754 Function8bitCounterArray = CreateFunctionLocalArrayInSection(
757 FunctionBoolArray = CreateFunctionLocalArrayInSection(
761 FunctionPCsArray = CreatePCArray(
F, AllBlocks);
764Value *ModuleSanitizerCoverage::CreateFunctionLocalGateCmp(
IRBuilder<> &IRB) {
766 Load->setNoSanitizeMetadata();
768 Cmp->setName(
"sancov gate cmp");
773 Value *&FunctionGateCmp,
775 if (!FunctionGateCmp) {
781 FunctionGateCmp = CreateFunctionLocalGateCmp(EntryIRB);
790bool ModuleSanitizerCoverage::InjectCoverage(
Function &
F,
792 Value *&FunctionGateCmp,
794 if (AllBlocks.
empty())
796 CreateFunctionLocalArrays(
F, AllBlocks);
797 for (
size_t i = 0,
N = AllBlocks.
size(); i <
N; i++)
798 InjectCoverageAtBlock(
F, *AllBlocks[i], i, FunctionGateCmp, IsLeafFunc);
810void ModuleSanitizerCoverage::InjectCoverageForIndirectCalls(
812 if (IndirCalls.
empty())
816 for (
auto *
I : IndirCalls) {
830void ModuleSanitizerCoverage::InjectTraceForSwitch(
832 Value *&FunctionGateCmp) {
833 for (
auto *
I : SwitchTraceTargets) {
838 if (
Cond->getType()->getScalarSizeInBits() >
839 Int64Ty->getScalarSizeInBits())
841 Initializers.
push_back(ConstantInt::get(Int64Ty,
SI->getNumCases()));
843 ConstantInt::get(Int64Ty,
Cond->getType()->getScalarSizeInBits()));
844 if (
Cond->getType()->getScalarSizeInBits() <
845 Int64Ty->getScalarSizeInBits())
847 for (
auto It :
SI->cases()) {
849 if (
C->getType()->getScalarSizeInBits() < 64)
850 C = ConstantInt::get(
C->getContext(),
C->getValue().zext(64));
862 "__sancov_gen_cov_switch_values");
864 auto GateBranch = CreateGateBranch(
F, FunctionGateCmp,
I);
866 GateIRB.CreateCall(SanCovTraceSwitchFunction, {
Cond, GV});
874void ModuleSanitizerCoverage::InjectTraceForDiv(
876 for (
auto *BO : DivTraceTargets) {
878 Value *A1 = BO->getOperand(1);
888 IRB.
CreateCall(SanCovTraceDivFunction[CallbackIdx],
893void ModuleSanitizerCoverage::InjectTraceForGep(
895 for (
auto *
GEP : GepTraceTargets) {
897 for (
Use &Idx :
GEP->indices())
904void ModuleSanitizerCoverage::InjectTraceForLoadsAndStores(
906 auto CallbackIdx = [&](
Type *ElementTy) ->
int {
915 for (
auto *LI : Loads) {
917 auto Ptr = LI->getPointerOperand();
918 int Idx = CallbackIdx(LI->getType());
923 for (
auto *
SI : Stores) {
925 auto Ptr =
SI->getPointerOperand();
926 int Idx = CallbackIdx(
SI->getValueOperand()->getType());
929 IRB.
CreateCall(SanCovStoreFunction[Idx], Ptr);
933void ModuleSanitizerCoverage::InjectTraceForExits(
Function &
F) {
937 AtExit->CreateCall(SanCovTracePCExit, {})
942void ModuleSanitizerCoverage::InjectTraceForCmp(
944 Value *&FunctionGateCmp) {
945 for (
auto *
I : CmpTraceTargets) {
948 Value *A0 = ICMP->getOperand(0);
949 Value *A1 = ICMP->getOperand(1);
961 auto CallbackFunc = SanCovTraceCmpFunction[CallbackIdx];
965 if (FirstIsConst && SecondIsConst)
968 if (FirstIsConst || SecondIsConst) {
969 CallbackFunc = SanCovTraceConstCmpFunction[CallbackIdx];
976 auto GateBranch = CreateGateBranch(
F, FunctionGateCmp,
I);
978 GateIRB.CreateCall(CallbackFunc, {GateIRB.CreateIntCast(A0, Ty,
true),
979 GateIRB.CreateIntCast(A1, Ty,
true)});
990 Value *&FunctionGateCmp,
993 bool IsEntryBB = &BB == &
F.getEntryBlock();
996 if (
auto SP =
F.getSubprogram())
1007 if (
Options.TracePC || (IsEntryBB &&
Options.TracePCEntryExit)) {
1009 ? SanCovTracePCEntry
1016 FunctionGuardArray->getValueType(), FunctionGuardArray, 0, Idx);
1019 auto GateBranch = CreateGateBranch(
F, FunctionGateCmp,
I);
1021 GateIRB.CreateCall(SanCovTracePCGuard, GuardPtr)->setCannotMerge();
1026 if (
Options.Inline8bitCounters) {
1028 Function8bitCounterArray->getValueType(), Function8bitCounterArray,
1029 {ConstantInt::get(IntptrTy, 0), ConstantInt::get(IntptrTy, Idx)});
1031 auto Inc = IRB.
CreateAdd(
Load, ConstantInt::get(Int8Ty, 1));
1033 Load->setNoSanitizeMetadata();
1034 Store->setNoSanitizeMetadata();
1038 FunctionBoolArray->getValueType(), FunctionBoolArray,
1039 {ConstantInt::get(IntptrTy, 0), ConstantInt::get(IntptrTy, Idx)});
1047 Store->setDebugLoc(EntryLoc);
1048 Load->setNoSanitizeMetadata();
1049 Store->setNoSanitizeMetadata();
1051 if (
Options.StackDepth && IsEntryBB && !IsLeafFunc) {
1055 if (
Options.StackDepthCallbackMin) {
1057 int EstimatedStackSize = 0;
1059 bool HasDynamicAlloc =
false;
1066 for (
auto &
I : BB) {
1072 if (
auto AllocaSize = AI->getAllocationSize(
DL)) {
1073 if (AllocaSize->isFixed())
1074 EstimatedStackSize += AllocaSize->getFixedValue();
1076 HasDynamicAlloc =
true;
1078 HasDynamicAlloc =
true;
1083 if (HasDynamicAlloc ||
1084 EstimatedStackSize >=
Options.StackDepthCallbackMin) {
1095 Intrinsic::frameaddress, IRB.
getPtrTy(
DL.getAllocaAddrSpace()),
1096 {Constant::getNullValue(Int32Ty)});
1098 auto LowestStack = IRB.
CreateLoad(IntptrTy, SanCovLowestStack);
1099 auto IsStackLower = IRB.
CreateICmpULT(FrameAddrInt, LowestStack);
1101 IsStackLower, &*IP,
false,
1104 auto Store = ThenIRB.CreateStore(FrameAddrInt, SanCovLowestStack);
1106 Store->setDebugLoc(EntryLoc);
1107 LowestStack->setNoSanitizeMetadata();
1108 Store->setNoSanitizeMetadata();
1114ModuleSanitizerCoverage::getSectionName(
const std::string &Section)
const {
1115 if (TargetTriple.isOSBinFormatCOFF()) {
1124 if (TargetTriple.isOSBinFormatMachO())
1130ModuleSanitizerCoverage::getSectionStart(
const std::string &Section)
const {
1131 if (TargetTriple.isOSBinFormatMachO())
1132 return "\1section$start$__DATA$__" +
Section;
1133 return "__start___" +
Section;
1137ModuleSanitizerCoverage::getSectionEnd(
const std::string &Section)
const {
1138 if (TargetTriple.isOSBinFormatMachO())
1139 return "\1section$end$__DATA$__" +
Section;
1143void ModuleSanitizerCoverage::createFunctionControlFlow(
Function &
F) {
1145 IRBuilder<> IRB(&*
F.getEntryBlock().getFirstInsertionPt());
1147 for (
auto &BB :
F) {
1149 if (&BB == &
F.getEntryBlock())
1156 assert(SuccBB != &
F.getEntryBlock());
1163 for (
auto &Inst : BB) {
1171 if (CalledF && !CalledF->isIntrinsic())
1180 FunctionCFsArray = CreateFunctionLocalArrayInSection(CFs.
size(),
F, PtrTy,
1182 FunctionCFsArray->setInitializer(
1184 FunctionCFsArray->setConstant(
true);
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
static const IROptions & getOptions(const Module *M)
static GCRegistry::Add< ShadowStackGC > C("shadow-stack", "Very portable GC for uncooperative code generators")
static GCRegistry::Add< ErlangGC > A("erlang", "erlang-compatible garbage collector")
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
This file contains the declarations for the subclasses of Constant, which represent the different fla...
This is the interface for a simple mod/ref and alias analysis over globals.
Module.h This file contains the declarations for the Module class.
static cl::opt< bool > SplitAllCriticalEdges("phi-elim-split-all-critical-edges", cl::init(false), cl::Hidden, cl::desc("Split all critical edges during " "PHI elimination"))
FunctionAnalysisManager FAM
ModuleAnalysisManager MAM
const SmallVectorImpl< MachineOperand > & Cond
const char SanCovCFsSectionName[]
static bool isFullPostDominator(const BasicBlock *BB, const PostDominatorTree &PDT)
const char SanCovTraceConstCmp4[]
const char SanCovBoolFlagSectionName[]
const char SanCov8bitCountersInitName[]
const char SanCovTracePCEntryName[]
const char SanCovTraceSwitchName[]
const char SanCovTraceCmp1[]
const char SanCovModuleCtorTracePcGuardName[]
const char SanCovCountersSectionName[]
const char SanCovPCsInitName[]
const char SanCovTracePCGuardName[]
const char SanCovModuleCtor8bitCountersName[]
const char SanCovTracePCGuardInitName[]
const char SanCovTraceDiv4[]
static const uint64_t SanCtorAndDtorPriority
const char SanCovBoolFlagInitName[]
const char SanCovTraceGep[]
const char SanCovLoad16[]
const char SanCovTraceConstCmp8[]
const char SanCovGuardsSectionName[]
const char SanCovStore1[]
const char SanCovTraceConstCmp2[]
const char SanCovTraceConstCmp1[]
static bool IsBackEdge(BasicBlock *From, BasicBlock *To, const DominatorTree &DT)
const char SanCovCallbackGateName[]
const char SanCovTraceDiv8[]
const char SanCovStackDepthCallbackName[]
const char SanCovCFsInitName[]
const char SanCovStore2[]
const char SanCovPCsSectionName[]
const char SanCovTracePCExitName[]
static bool isFullDominator(const BasicBlock *BB, const DominatorTree &DT)
const char SanCovTraceCmp8[]
const char SanCovCallbackGateSectionName[]
const char SanCovStore16[]
static bool IsInterestingCmp(ICmpInst *CMP, const DominatorTree &DT, const SanitizerCoverageOptions &Options)
static bool shouldInstrumentBlock(const Function &F, const BasicBlock *BB, const DominatorTree &DT, const PostDominatorTree &PDT, const SanitizerCoverageOptions &Options)
const char SanCovModuleCtorBoolFlagName[]
const char SanCovTraceCmp2[]
const char SanCovStore8[]
const char SanCovTracePCName[]
const char SanCovStore4[]
const char SanCovTraceCmp4[]
const char SanCovLowestStackName[]
const char SanCovTracePCIndirName[]
This file defines the SmallVector class.
Defines the virtual file system interface vfs::FileSystem.
Represent a constant reference to an array (0 or more elements consecutively in memory),...
size_t size() const
Get the array size.
bool empty() const
Check if the array is empty.
Class to represent array types.
static LLVM_ABI ArrayType * get(Type *ElementType, uint64_t NumElements)
This static method is the primary way to construct an ArrayType.
LLVM Basic Block Representation.
LLVM_ABI const_iterator getFirstInsertionPt() const
Returns an iterator to the first instruction in this block that is suitable for inserting a non-PHI i...
LLVM_ABI const BasicBlock * getUniqueSuccessor() const
Return the successor of this block if it has a unique successor.
LLVM_ABI const BasicBlock * getSinglePredecessor() const
Return the predecessor of this block if it has a single predecessor block.
LLVM_ABI InstListType::const_iterator getFirstNonPHIOrLifetime() const
Returns an iterator to the first instruction in this block that is not a PHINode, a lifetime intrinsi...
InstListType::iterator iterator
Instruction iterators...
const Instruction * getTerminator() const LLVM_READONLY
Returns the terminator instruction; assumes that the block is well-formed.
static LLVM_ABI BlockAddress * get(Function *F, BasicBlock *BB)
Return a BlockAddress for the specified function and basic block.
Base class for all callable instructions (InvokeInst and CallInst) Holds everything related to callin...
Function * getCalledFunction() const
Returns the function called, or null if this is an indirect function invocation or the function signa...
LLVM_ABI bool isIndirectCall() const
Return true if the callsite is an indirect call.
Value * getCalledOperand() const
static LLVM_ABI Constant * get(ArrayType *T, ArrayRef< Constant * > V)
static Constant * getPtrAdd(Constant *Ptr, Constant *Offset, GEPNoWrapFlags NW=GEPNoWrapFlags::none(), std::optional< ConstantRange > InRange=std::nullopt, Type *OnlyIfReduced=nullptr)
Create a getelementptr i8, ptr, offset constant expression.
This is the shared class of boolean and integer constants.
static LLVM_ABI ConstantInt * getTrue(LLVMContext &Context)
This is an important base class in LLVM.
static LLVM_ABI Constant * getAllOnesValue(Type *Ty)
static LLVM_ABI Constant * getNullValue(Type *Ty)
Constructor to create a '0' constant of arbitrary type.
A parsed version of the target data layout string in and methods for querying it.
Analysis pass which computes a DominatorTree.
Concrete subclass of DominatorTreeBase that is used to compute a normal dominator tree.
LLVM_ABI bool dominates(const BasicBlock *BB, const Use &U) const
Return true if the (end of the) basic block BB dominates the use U.
EscapeEnumerator - This is a little algorithm to find all escape points from a function so that "fina...
A handy container for a FunctionType+Callee-pointer pair, which can be passed around as a single enti...
const BasicBlock & getEntryBlock() const
an instruction for type-safe pointer arithmetic to access elements of arrays and structs
LLVM_ABI void setComdat(Comdat *C)
void setLinkage(LinkageTypes LT)
@ HiddenVisibility
The GV is hidden.
void setVisibility(VisibilityTypes V)
LinkageTypes
An enumeration for the kinds of linkage for global values.
@ PrivateLinkage
Like Internal, but omit from symbol table.
@ InternalLinkage
Rename collisions when linking (static functions).
@ LinkOnceAnyLinkage
Keep one copy of function when linking (inline)
@ WeakODRLinkage
Same, but only replaced by something equivalent.
@ ExternalLinkage
Externally visible function.
@ AvailableExternallyLinkage
Available for inspection, not emission.
@ ExternalWeakLinkage
ExternalWeak linkage description.
Analysis pass providing a never-invalidated alias analysis result.
This instruction compares its operands according to the predicate given to the constructor.
Value * CreateICmpULT(Value *LHS, Value *RHS, const Twine &Name="")
Value * CreatePointerCast(Value *V, Type *DestTy, const Twine &Name="")
Value * CreateIntToPtr(Value *V, Type *DestTy, const Twine &Name="")
void SetCurrentDebugLocation(const DebugLoc &L)
Set location information used by debugging information.
Value * CreateGEP(Type *Ty, Value *Ptr, ArrayRef< Value * > IdxList, const Twine &Name="", GEPNoWrapFlags NW=GEPNoWrapFlags::none())
LoadInst * CreateLoad(Type *Ty, Value *Ptr, const char *Name)
Provided to resolve 'CreateLoad(Ty, Ptr, "...")' correctly, instead of converting the string to 'bool...
LLVMContext & getContext() const
LLVM_ABI Value * CreateIntrinsic(Intrinsic::ID ID, ArrayRef< Type * > OverloadTypes, ArrayRef< Value * > Args, FMFSource FMFSource={}, const Twine &Name="", ArrayRef< OperandBundleDef > OpBundles={}, function_ref< void(CallInst *)> SetFn=[](CallInst *) {})
Variant to create a possibly constant-folded intrinsic.
Value * CreateConstInBoundsGEP2_64(Type *Ty, Value *Ptr, uint64_t Idx0, uint64_t Idx1, const Twine &Name="")
StoreInst * CreateStore(Value *Val, Value *Ptr, bool isVolatile=false)
Value * CreateAdd(Value *LHS, Value *RHS, const Twine &Name="", bool HasNUW=false, bool HasNSW=false)
Value * CreatePtrToInt(Value *V, Type *DestTy, const Twine &Name="")
Value * CreateIsNotNull(Value *Arg, const Twine &Name="")
Return a boolean value testing if Arg != 0.
CallInst * CreateCall(FunctionType *FTy, Value *Callee, ArrayRef< Value * > Args={}, const Twine &Name="", MDNode *FPMathTag=nullptr)
PointerType * getPtrTy(unsigned AddrSpace=0)
Fetch the type representing a pointer.
Value * CreateIntCast(Value *V, Type *DestTy, bool isSigned, const Twine &Name="")
Value * CreateIsNull(Value *Arg, const Twine &Name="")
Return a boolean value testing if Arg == 0.
void SetInsertPoint(BasicBlock *TheBB)
This specifies that created instructions should be appended to the end of the specified block.
This provides a uniform API for creating instructions and inserting them into a basic block: either a...
Instruction * user_back()
void setDebugLoc(DebugLoc Loc)
Set the debug location information for this instruction.
A smart pointer to a reference-counted object that inherits from RefCountedBase or ThreadSafeRefCount...
This is an important class for using LLVM in a threaded context.
An instruction for reading from memory.
LLVM_ABI MDNode * createBranchWeights(uint32_t TrueWeight, uint32_t FalseWeight, bool IsExpected=false)
Return metadata containing two branch weights.
LLVM_ABI MDNode * createUnlikelyBranchWeights()
Return metadata containing two branch weights, with significant bias towards false destination.
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
A Module instance is used to store all the information related to an LLVM module.
static PointerType * getUnqual(LLVMContext &C)
This constructs an opaque pointer to an object in the default address space (address space zero).
Analysis pass which computes a PostDominatorTree.
PostDominatorTree Class - Concrete subclass of DominatorTree that is used to compute the post-dominat...
LLVM_ABI bool dominates(const Instruction *I1, const Instruction *I2) const
Return true if I1 dominates I2.
A set of analyses that are preserved following a run of a transformation pass.
static PreservedAnalyses none()
Convenience factory function for the empty preserved set.
static PreservedAnalyses all()
Construct a special preserved set that preserves all passes.
PreservedAnalyses & abandon()
Mark an analysis as abandoned.
LLVM_ABI PreservedAnalyses run(Module &M, ModuleAnalysisManager &AM)
LLVM_ABI SanitizerCoveragePass(SanitizerCoverageOptions Options=SanitizerCoverageOptions(), IntrusiveRefCntPtr< vfs::FileSystem > VFS=nullptr, const std::vector< std::string > &AllowlistFiles={}, const std::vector< std::string > &BlocklistFiles={})
void push_back(const T &Elt)
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
This is a utility class used to parse user-provided text files with "special case lists" for code san...
static LLVM_ABI std::unique_ptr< SpecialCaseList > createOrDie(const std::vector< std::string > &Paths, llvm::vfs::FileSystem &FS)
Parses the special case list entries from files.
An instruction for storing to memory.
Represent a constant reference to a string, i.e.
Triple - Helper class for working with autoconf configuration names.
The instances of the Type class are immutable: once they are created, they are never changed.
static LLVM_ABI Type * getVoidTy(LLVMContext &C)
bool isIntegerTy() const
True if this is an instance of IntegerType.
static LLVM_ABI IntegerType * getIntNTy(LLVMContext &C, unsigned N)
A Use represents the edge between a Value definition and its users.
LLVM Value Representation.
Type * getType() const
All values are typed, get the type of this value.
bool hasOneUse() const
Return true if there is exactly one use of this value.
LLVM_ABI StringRef getName() const
Return a constant reference to the value's name.
An efficient, type-erasing, non-owning reference to a callable.
NodeTy * getNextNode()
Get the next node, or nullptr for the list tail.
static constexpr const StringLiteral & getSectionName(DebugSectionKind SectionKind)
Return the name of the section.
This is an optimization pass for GlobalISel generic memory operations.
auto drop_begin(T &&RangeOrContainer, size_t N=1)
Return a range covering RangeOrContainer with the first N elements excluded.
bool all_of(R &&range, UnaryPredicate P)
Provide wrappers to std::all_of which take ranges instead of having to pass begin/end explicitly.
bool succ_empty(const Instruction *I)
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
auto successors(const MachineBasicBlock *BB)
@ Load
The value being inserted comes from a load (InsertElement only).
@ Store
The extracted value is stored (ExtractElement only).
InnerAnalysisManagerProxy< FunctionAnalysisManager, Module > FunctionAnalysisManagerModuleProxy
Provide the FunctionAnalysisManager to Module proxy.
LLVM_ABI FunctionCallee declareSanitizerInitFunction(Module &M, StringRef InitName, ArrayRef< Type * > InitArgTypes, bool Weak=false)
LLVM_ABI std::pair< Function *, FunctionCallee > createSanitizerCtorAndInitFunctions(Module &M, StringRef CtorName, StringRef InitName, ArrayRef< Type * > InitArgTypes, ArrayRef< Value * > InitArgs, StringRef VersionCheckName=StringRef(), bool Weak=false)
Creates sanitizer constructor function, and calls sanitizer's init function from it.
void sort(IteratorTy Start, IteratorTy End)
LLVM_ABI EHPersonality classifyEHPersonality(const Value *Pers)
See if the given exception handling personality function is one that we understand.
LLVM_ABI Comdat * getOrCreateFunctionComdat(Function &F, Triple &T)
bool isa(const From &Val)
isa<X> - Return true if the parameter to the template is an instance of one of the template type argu...
LLVM_ABI void appendToCompilerUsed(Module &M, ArrayRef< GlobalValue * > Values)
Adds global values to the llvm.compiler.used list.
bool isAsynchronousEHPersonality(EHPersonality Pers)
Returns true if this personality function catches asynchronous exceptions.
OutputIt move(R &&Range, OutputIt Out)
Provide wrappers to std::move which take ranges instead of having to pass begin/end explicitly.
LLVM_ABI void appendToGlobalCtors(Module &M, Function *F, int Priority, Constant *Data=nullptr)
Append F to the list of global ctors of module M with the given Priority.
decltype(auto) cast(const From &Val)
cast<X> - Return the argument parameter cast to the specified type.
auto predecessors(const MachineBasicBlock *BB)
RelativeUniformCounterPtr ValuesPtrExpr VTableAddr Next
bool pred_empty(const BasicBlock *BB)
LLVM_ABI BasicBlock::iterator PrepareToSplitEntryBlock(BasicBlock &BB, BasicBlock::iterator IP)
Instrumentation passes often insert conditional checks into entry blocks.
LLVM_ABI Instruction * SplitBlockAndInsertIfThen(Value *Cond, BasicBlock::iterator SplitBefore, bool Unreachable, MDNode *BranchWeights=nullptr, DomTreeUpdater *DTU=nullptr, LoopInfo *LI=nullptr, BasicBlock *ThenBlock=nullptr)
Split the containing block at the specified instruction - everything before SplitBefore stays in the ...
LLVM_ABI void appendToUsed(Module &M, ArrayRef< GlobalValue * > Values)
Adds global values to the llvm.used list.
AnalysisManager< Module > ModuleAnalysisManager
Convenience typedef for the Module analysis manager.
Implement std::hash so that hash_code can be used in STL containers.
void swap(llvm::BitVector &LHS, llvm::BitVector &RHS)
Implement std::swap in terms of BitVector swap.
This struct is a compact representation of a valid (non-zero power of two) alignment.
Option class for critical edge splitting.
static void ensureDebugInfo(IRBuilder<> &IRB, const Function &F)
enum llvm::SanitizerCoverageOptions::Type CoverageType