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 = InstrumentationOptions::Global;
269 ModuleSanitizerCoverage ModuleSancov(Opts, M, DTCallback, PDTCallback,
270 overrideFromCL(Opts, Options),
271 Allowlist.get(), Blocklist.get());
272 if (!ModuleSancov.instrumentModule())
283std::pair<Value *, Value *>
284ModuleSanitizerCoverage::CreateSecStartEnd(
Module &M,
const char *Section,
294 getSectionStart(Section));
297 getSectionEnd(Section));
299 if (!TargetTriple.isOSBinFormatCOFF())
300 return std::make_pair(SecStart, SecEnd);
305 SecStart, ConstantInt::get(IntptrTy,
sizeof(uint64_t)));
306 return std::make_pair(
GEP, SecEnd);
309Function *ModuleSanitizerCoverage::CreateInitCallsForSections(
310 Module &M,
const char *CtorName,
const char *InitFunctionName,
Type *Ty,
311 const char *Section) {
312 if (Opts.sanitizer_coverage_drop_ctors)
314 auto SecStartEnd = CreateSecStartEnd(M, Section, Ty);
315 auto SecStart = SecStartEnd.first;
316 auto SecEnd = SecStartEnd.second;
319 M, CtorName, InitFunctionName, {PtrTy, PtrTy}, {SecStart, SecEnd});
322 if (TargetTriple.supportsCOMDAT()) {
324 CtorFunc->
setComdat(
M.getOrInsertComdat(CtorName));
330 if (TargetTriple.isOSBinFormatCOFF()) {
342bool ModuleSanitizerCoverage::instrumentModule() {
346 !Allowlist->inSection(
"coverage",
"src",
M.getSourceFileName()))
349 Blocklist->inSection(
"coverage",
"src",
M.getSourceFileName()))
351 C = &(
M.getContext());
352 DL = &
M.getDataLayout();
354 TargetTriple =
M.getTargetTriple();
355 FunctionGuardArray =
nullptr;
356 Function8bitCounterArray =
nullptr;
357 FunctionBoolArray =
nullptr;
358 FunctionPCsArray =
nullptr;
359 FunctionCFsArray =
nullptr;
364 Int64Ty = IRB.getInt64Ty();
365 Int32Ty = IRB.getInt32Ty();
366 Int16Ty = IRB.getInt16Ty();
367 Int8Ty = IRB.getInt8Ty();
368 Int1Ty = IRB.getInt1Ty();
374 AttributeList SanCovTraceCmpZeroExtAL;
375 SanCovTraceCmpZeroExtAL =
376 SanCovTraceCmpZeroExtAL.addParamAttribute(*
C, 0, Attribute::ZExt);
377 SanCovTraceCmpZeroExtAL =
378 SanCovTraceCmpZeroExtAL.addParamAttribute(*
C, 1, Attribute::ZExt);
380 SanCovTraceCmpFunction[0] =
382 IRB.getInt8Ty(), IRB.getInt8Ty());
383 SanCovTraceCmpFunction[1] =
385 IRB.getInt16Ty(), IRB.getInt16Ty());
386 SanCovTraceCmpFunction[2] =
388 IRB.getInt32Ty(), IRB.getInt32Ty());
389 SanCovTraceCmpFunction[3] =
392 SanCovTraceConstCmpFunction[0] =
M.getOrInsertFunction(
394 SanCovTraceConstCmpFunction[1] =
M.getOrInsertFunction(
396 SanCovTraceConstCmpFunction[2] =
M.getOrInsertFunction(
398 SanCovTraceConstCmpFunction[3] =
402 SanCovLoadFunction[0] =
M.getOrInsertFunction(
SanCovLoad1, VoidTy, PtrTy);
403 SanCovLoadFunction[1] =
M.getOrInsertFunction(
SanCovLoad2, VoidTy, PtrTy);
404 SanCovLoadFunction[2] =
M.getOrInsertFunction(
SanCovLoad4, VoidTy, PtrTy);
405 SanCovLoadFunction[3] =
M.getOrInsertFunction(
SanCovLoad8, VoidTy, PtrTy);
406 SanCovLoadFunction[4] =
M.getOrInsertFunction(
SanCovLoad16, VoidTy, PtrTy);
408 SanCovStoreFunction[0] =
M.getOrInsertFunction(
SanCovStore1, VoidTy, PtrTy);
409 SanCovStoreFunction[1] =
M.getOrInsertFunction(
SanCovStore2, VoidTy, PtrTy);
410 SanCovStoreFunction[2] =
M.getOrInsertFunction(
SanCovStore4, VoidTy, PtrTy);
411 SanCovStoreFunction[3] =
M.getOrInsertFunction(
SanCovStore8, VoidTy, PtrTy);
412 SanCovStoreFunction[4] =
M.getOrInsertFunction(
SanCovStore16, VoidTy, PtrTy);
416 AL =
AL.addParamAttribute(*
C, 0, Attribute::ZExt);
417 SanCovTraceDivFunction[0] =
420 SanCovTraceDivFunction[1] =
422 SanCovTraceGepFunction =
424 SanCovTraceSwitchFunction =
428 if (SanCovLowestStack->getValueType() != IntptrTy) {
430 "' should not be declared by the user");
433 SanCovLowestStack->setThreadLocalMode(
435 if (
Options.StackDepth && !SanCovLowestStack->isDeclaration())
440 C->emitError(
"'sanitizer-coverage-gated-trace-callbacks' is only "
441 "supported with trace-pc-guard or trace-cmp");
447 SanCovCallbackGate->setSection(
461 SanCovStackDepthCallback =
465 instrumentFunction(
F);
469 if (FunctionGuardArray)
473 if (Function8bitCounterArray)
477 if (FunctionBoolArray) {
487 IRBCtor.CreateCall(InitFunction, {SecStartEnd.first, SecStartEnd.second});
490 if (Ctor &&
Options.CollectControlFlow) {
495 IRBCtor.CreateCall(InitFunction, {SecStartEnd.first, SecStartEnd.second});
541 if (
Options.NoPrune || &
F.getEntryBlock() == BB)
545 &
F.getEntryBlock() != BB)
584void ModuleSanitizerCoverage::instrumentFunction(
Function &
F) {
587 if (
F.getName().contains(
".module_ctor"))
589 if (
F.getName().starts_with(
"__sanitizer_"))
596 if (
F.getName() ==
"__local_stdio_printf_options" ||
597 F.getName() ==
"__local_stdio_scanf_options")
604 if (
F.hasPersonalityFn() &&
607 if (Allowlist && !Allowlist->inSection(
"coverage",
"fun",
F.getName()))
609 if (Blocklist && Blocklist->inSection(
"coverage",
"fun",
F.getName()))
612 if (
F.hasFnAttribute(Attribute::Naked))
614 if (
F.hasFnAttribute(Attribute::NoSanitizeCoverage))
616 if (
F.hasFnAttribute(Attribute::DisableSanitizerInstrumentation))
633 bool IsLeafFunc =
true;
638 for (
auto &Inst : BB) {
653 if (BO->getOpcode() == Instruction::SDiv ||
654 BO->getOpcode() == Instruction::UDiv)
672 if (
Options.CollectControlFlow)
673 createFunctionControlFlow(
F);
675 Value *FunctionGateCmp =
nullptr;
676 InjectCoverage(
F, BlocksToInstrument, FunctionGateCmp, IsLeafFunc);
677 InjectCoverageForIndirectCalls(
F, IndirCalls);
678 InjectTraceForCmp(
F, CmpTraceTargets, FunctionGateCmp);
679 InjectTraceForSwitch(
F, SwitchTraceTargets, FunctionGateCmp);
680 InjectTraceForDiv(
F, DivTraceTargets);
681 InjectTraceForGep(
F, GepTraceTargets);
682 InjectTraceForLoadsAndStores(
F, Loads, Stores);
685 InjectTraceForExits(
F);
688GlobalVariable *ModuleSanitizerCoverage::CreateFunctionLocalArrayInSection(
689 size_t NumElements,
Function &
F,
Type *Ty,
const char *Section) {
701 if (TargetTriple.supportsCOMDAT() &&
702 (
F.hasComdat() || TargetTriple.isOSBinFormatELF() ||
703 !
F.isInterposable(
false)))
707 Array->setAlignment(
Align(
DL->getTypeStoreSize(Ty).getFixedValue()));
711 if (
Array->hasComdat())
712 GlobalsToAppendToCompilerUsed.push_back(Array);
714 GlobalsToAppendToUsed.push_back(Array);
720ModuleSanitizerCoverage::CreatePCArray(
Function &
F,
722 size_t N = AllBlocks.
size();
725 IRBuilder<> IRB(&*
F.getEntryBlock().getFirstInsertionPt());
726 for (
size_t i = 0; i <
N; i++) {
727 if (&
F.getEntryBlock() == AllBlocks[i]) {
730 (
Constant *)IRB.CreateIntToPtr(ConstantInt::get(IntptrTy, 1), PtrTy));
739 PCArray->setInitializer(
741 PCArray->setConstant(
true);
746void ModuleSanitizerCoverage::CreateFunctionLocalArrays(
749 FunctionGuardArray = CreateFunctionLocalArrayInSection(
752 if (
Options.Inline8bitCounters)
753 Function8bitCounterArray = CreateFunctionLocalArrayInSection(
756 FunctionBoolArray = CreateFunctionLocalArrayInSection(
760 FunctionPCsArray = CreatePCArray(
F, AllBlocks);
763Value *ModuleSanitizerCoverage::CreateFunctionLocalGateCmp(
IRBuilder<> &IRB) {
765 Load->setNoSanitizeMetadata();
767 Cmp->setName(
"sancov gate cmp");
772 Value *&FunctionGateCmp,
774 if (!FunctionGateCmp) {
780 FunctionGateCmp = CreateFunctionLocalGateCmp(EntryIRB);
789bool ModuleSanitizerCoverage::InjectCoverage(
Function &
F,
791 Value *&FunctionGateCmp,
793 if (AllBlocks.
empty())
795 CreateFunctionLocalArrays(
F, AllBlocks);
796 for (
size_t i = 0,
N = AllBlocks.
size(); i <
N; i++)
797 InjectCoverageAtBlock(
F, *AllBlocks[i], i, FunctionGateCmp, IsLeafFunc);
809void ModuleSanitizerCoverage::InjectCoverageForIndirectCalls(
811 if (IndirCalls.
empty())
815 for (
auto *
I : IndirCalls) {
829void ModuleSanitizerCoverage::InjectTraceForSwitch(
831 Value *&FunctionGateCmp) {
832 for (
auto *
I : SwitchTraceTargets) {
837 if (
Cond->getType()->getScalarSizeInBits() >
838 Int64Ty->getScalarSizeInBits())
840 Initializers.
push_back(ConstantInt::get(Int64Ty,
SI->getNumCases()));
842 ConstantInt::get(Int64Ty,
Cond->getType()->getScalarSizeInBits()));
843 if (
Cond->getType()->getScalarSizeInBits() <
844 Int64Ty->getScalarSizeInBits())
846 for (
auto It :
SI->cases()) {
848 if (
C->getType()->getScalarSizeInBits() < 64)
849 C = ConstantInt::get(
C->getContext(),
C->getValue().zext(64));
861 "__sancov_gen_cov_switch_values");
863 auto GateBranch = CreateGateBranch(
F, FunctionGateCmp,
I);
865 GateIRB.CreateCall(SanCovTraceSwitchFunction, {
Cond, GV});
873void ModuleSanitizerCoverage::InjectTraceForDiv(
875 for (
auto *BO : DivTraceTargets) {
877 Value *A1 = BO->getOperand(1);
887 IRB.
CreateCall(SanCovTraceDivFunction[CallbackIdx],
892void ModuleSanitizerCoverage::InjectTraceForGep(
894 for (
auto *
GEP : GepTraceTargets) {
896 for (
Use &Idx :
GEP->indices())
903void ModuleSanitizerCoverage::InjectTraceForLoadsAndStores(
905 auto CallbackIdx = [&](
Type *ElementTy) ->
int {
914 for (
auto *LI : Loads) {
916 auto Ptr = LI->getPointerOperand();
917 int Idx = CallbackIdx(LI->getType());
922 for (
auto *
SI : Stores) {
924 auto Ptr =
SI->getPointerOperand();
925 int Idx = CallbackIdx(
SI->getValueOperand()->getType());
928 IRB.
CreateCall(SanCovStoreFunction[Idx], Ptr);
932void ModuleSanitizerCoverage::InjectTraceForExits(
Function &
F) {
936 AtExit->CreateCall(SanCovTracePCExit, {})
941void ModuleSanitizerCoverage::InjectTraceForCmp(
943 Value *&FunctionGateCmp) {
944 for (
auto *
I : CmpTraceTargets) {
947 Value *A0 = ICMP->getOperand(0);
948 Value *A1 = ICMP->getOperand(1);
960 auto CallbackFunc = SanCovTraceCmpFunction[CallbackIdx];
964 if (FirstIsConst && SecondIsConst)
967 if (FirstIsConst || SecondIsConst) {
968 CallbackFunc = SanCovTraceConstCmpFunction[CallbackIdx];
975 auto GateBranch = CreateGateBranch(
F, FunctionGateCmp,
I);
977 GateIRB.CreateCall(CallbackFunc, {GateIRB.CreateIntCast(A0, Ty,
true),
978 GateIRB.CreateIntCast(A1, Ty,
true)});
989 Value *&FunctionGateCmp,
992 bool IsEntryBB = &BB == &
F.getEntryBlock();
995 if (
auto SP =
F.getSubprogram())
1006 if (
Options.TracePC || (IsEntryBB &&
Options.TracePCEntryExit)) {
1008 ? SanCovTracePCEntry
1015 FunctionGuardArray->getValueType(), FunctionGuardArray, 0, Idx);
1018 auto GateBranch = CreateGateBranch(
F, FunctionGateCmp,
I);
1020 GateIRB.CreateCall(SanCovTracePCGuard, GuardPtr)->setCannotMerge();
1025 if (
Options.Inline8bitCounters) {
1027 Function8bitCounterArray->getValueType(), Function8bitCounterArray,
1028 {ConstantInt::get(IntptrTy, 0), ConstantInt::get(IntptrTy, Idx)});
1030 auto Inc = IRB.
CreateAdd(
Load, ConstantInt::get(Int8Ty, 1));
1032 Load->setNoSanitizeMetadata();
1033 Store->setNoSanitizeMetadata();
1037 FunctionBoolArray->getValueType(), FunctionBoolArray,
1038 {ConstantInt::get(IntptrTy, 0), ConstantInt::get(IntptrTy, Idx)});
1046 Store->setDebugLoc(EntryLoc);
1047 Load->setNoSanitizeMetadata();
1048 Store->setNoSanitizeMetadata();
1050 if (
Options.StackDepth && IsEntryBB && !IsLeafFunc) {
1054 if (
Options.StackDepthCallbackMin) {
1056 int EstimatedStackSize = 0;
1058 bool HasDynamicAlloc =
false;
1065 for (
auto &
I : BB) {
1071 if (
auto AllocaSize = AI->getAllocationSize(
DL)) {
1072 if (AllocaSize->isFixed())
1073 EstimatedStackSize += AllocaSize->getFixedValue();
1075 HasDynamicAlloc =
true;
1077 HasDynamicAlloc =
true;
1082 if (HasDynamicAlloc ||
1083 EstimatedStackSize >=
Options.StackDepthCallbackMin) {
1094 Intrinsic::frameaddress, IRB.
getPtrTy(
DL.getAllocaAddrSpace()),
1095 {Constant::getNullValue(Int32Ty)});
1097 auto LowestStack = IRB.
CreateLoad(IntptrTy, SanCovLowestStack);
1098 auto IsStackLower = IRB.
CreateICmpULT(FrameAddrInt, LowestStack);
1100 IsStackLower, &*IP,
false,
1103 auto Store = ThenIRB.CreateStore(FrameAddrInt, SanCovLowestStack);
1105 Store->setDebugLoc(EntryLoc);
1106 LowestStack->setNoSanitizeMetadata();
1107 Store->setNoSanitizeMetadata();
1113ModuleSanitizerCoverage::getSectionName(
const std::string &Section)
const {
1114 if (TargetTriple.isOSBinFormatCOFF()) {
1123 if (TargetTriple.isOSBinFormatMachO())
1129ModuleSanitizerCoverage::getSectionStart(
const std::string &Section)
const {
1130 if (TargetTriple.isOSBinFormatMachO())
1131 return "\1section$start$__DATA$__" +
Section;
1132 return "__start___" +
Section;
1136ModuleSanitizerCoverage::getSectionEnd(
const std::string &Section)
const {
1137 if (TargetTriple.isOSBinFormatMachO())
1138 return "\1section$end$__DATA$__" +
Section;
1142void ModuleSanitizerCoverage::createFunctionControlFlow(
Function &
F) {
1144 IRBuilder<> IRB(&*
F.getEntryBlock().getFirstInsertionPt());
1146 for (
auto &BB :
F) {
1148 if (&BB == &
F.getEntryBlock())
1155 assert(SuccBB != &
F.getEntryBlock());
1162 for (
auto &Inst : BB) {
1170 if (CalledF && !CalledF->isIntrinsic())
1179 FunctionCFsArray = CreateFunctionLocalArrayInSection(CFs.
size(),
F, PtrTy,
1181 FunctionCFsArray->setInitializer(
1183 FunctionCFsArray->setConstant(
true);
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
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.
InstListType::iterator iterator
Instruction iterators...
LLVM_ABI InstListType::const_iterator getFirstNonPHIOrDbgOrLifetime(bool SkipPseudoOp=true) const
Returns a pointer to the first instruction in this block that is not a PHINode, a debug intrinsic,...
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