LLVM 19.0.0git
SPIRVPrepareFunctions.cpp
Go to the documentation of this file.
1//===-- SPIRVPrepareFunctions.cpp - modify function signatures --*- 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 pass modifies function signatures containing aggregate arguments
10// and/or return value before IRTranslator. Information about the original
11// signatures is stored in metadata. It is used during call lowering to
12// restore correct SPIR-V types of function arguments and return values.
13// This pass also substitutes some llvm intrinsic calls with calls to newly
14// generated functions (as the Khronos LLVM/SPIR-V Translator does).
15//
16// NOTE: this pass is a module-level one due to the necessity to modify
17// GVs/functions.
18//
19//===----------------------------------------------------------------------===//
20
21#include "SPIRV.h"
22#include "SPIRVSubtarget.h"
23#include "SPIRVTargetMachine.h"
24#include "SPIRVUtils.h"
27#include "llvm/IR/IRBuilder.h"
29#include "llvm/IR/Intrinsics.h"
30#include "llvm/IR/IntrinsicsSPIRV.h"
33#include <charconv>
34#include <regex>
35
36using namespace llvm;
37
38namespace llvm {
40}
41
42namespace {
43
44class SPIRVPrepareFunctions : public ModulePass {
46 bool substituteIntrinsicCalls(Function *F);
47 Function *removeAggregateTypesFromSignature(Function *F);
48
49public:
50 static char ID;
51 SPIRVPrepareFunctions(const SPIRVTargetMachine &TM) : ModulePass(ID), TM(TM) {
53 }
54
55 bool runOnModule(Module &M) override;
56
57 StringRef getPassName() const override { return "SPIRV prepare functions"; }
58
59 void getAnalysisUsage(AnalysisUsage &AU) const override {
61 }
62};
63
64} // namespace
65
66char SPIRVPrepareFunctions::ID = 0;
67
68INITIALIZE_PASS(SPIRVPrepareFunctions, "prepare-functions",
69 "SPIRV prepare functions", false, false)
70
71std::string lowerLLVMIntrinsicName(IntrinsicInst *II) {
72 Function *IntrinsicFunc = II->getCalledFunction();
73 assert(IntrinsicFunc && "Missing function");
74 std::string FuncName = IntrinsicFunc->getName().str();
75 std::replace(FuncName.begin(), FuncName.end(), '.', '_');
76 FuncName = "spirv." + FuncName;
77 return FuncName;
78}
79
81 ArrayRef<Type *> ArgTypes,
83 FunctionType *FT = FunctionType::get(RetTy, ArgTypes, false);
84 Function *F = M->getFunction(Name);
85 if (F && F->getFunctionType() == FT)
86 return F;
88 if (F)
89 NewF->setDSOLocal(F->isDSOLocal());
91 return NewF;
92}
93
94static bool lowerIntrinsicToFunction(IntrinsicInst *Intrinsic) {
95 // For @llvm.memset.* intrinsic cases with constant value and length arguments
96 // are emulated via "storing" a constant array to the destination. For other
97 // cases we wrap the intrinsic in @spirv.llvm_memset_* function and expand the
98 // intrinsic to a loop via expandMemSetAsLoop().
99 if (auto *MSI = dyn_cast<MemSetInst>(Intrinsic))
100 if (isa<Constant>(MSI->getValue()) && isa<ConstantInt>(MSI->getLength()))
101 return false; // It is handled later using OpCopyMemorySized.
102
103 Module *M = Intrinsic->getModule();
104 std::string FuncName = lowerLLVMIntrinsicName(Intrinsic);
105 if (Intrinsic->isVolatile())
106 FuncName += ".volatile";
107 // Redirect @llvm.intrinsic.* call to @spirv.llvm_intrinsic_*
108 Function *F = M->getFunction(FuncName);
109 if (F) {
110 Intrinsic->setCalledFunction(F);
111 return true;
112 }
113 // TODO copy arguments attributes: nocapture writeonly.
114 FunctionCallee FC =
115 M->getOrInsertFunction(FuncName, Intrinsic->getFunctionType());
116 auto IntrinsicID = Intrinsic->getIntrinsicID();
117 Intrinsic->setCalledFunction(FC);
118
119 F = dyn_cast<Function>(FC.getCallee());
120 assert(F && "Callee must be a function");
121
122 switch (IntrinsicID) {
123 case Intrinsic::memset: {
124 auto *MSI = static_cast<MemSetInst *>(Intrinsic);
125 Argument *Dest = F->getArg(0);
126 Argument *Val = F->getArg(1);
127 Argument *Len = F->getArg(2);
128 Argument *IsVolatile = F->getArg(3);
129 Dest->setName("dest");
130 Val->setName("val");
131 Len->setName("len");
132 IsVolatile->setName("isvolatile");
133 BasicBlock *EntryBB = BasicBlock::Create(M->getContext(), "entry", F);
134 IRBuilder<> IRB(EntryBB);
135 auto *MemSet = IRB.CreateMemSet(Dest, Val, Len, MSI->getDestAlign(),
136 MSI->isVolatile());
137 IRB.CreateRetVoid();
138 expandMemSetAsLoop(cast<MemSetInst>(MemSet));
139 MemSet->eraseFromParent();
140 break;
141 }
142 case Intrinsic::bswap: {
143 BasicBlock *EntryBB = BasicBlock::Create(M->getContext(), "entry", F);
144 IRBuilder<> IRB(EntryBB);
145 auto *BSwap = IRB.CreateIntrinsic(Intrinsic::bswap, Intrinsic->getType(),
146 F->getArg(0));
147 IRB.CreateRet(BSwap);
148 IntrinsicLowering IL(M->getDataLayout());
149 IL.LowerIntrinsicCall(BSwap);
150 break;
151 }
152 default:
153 break;
154 }
155 return true;
156}
157
158static std::string getAnnotation(Value *AnnoVal, Value *OptAnnoVal) {
159 if (auto *Ref = dyn_cast_or_null<GetElementPtrInst>(AnnoVal))
160 AnnoVal = Ref->getOperand(0);
161 if (auto *Ref = dyn_cast_or_null<BitCastInst>(OptAnnoVal))
162 OptAnnoVal = Ref->getOperand(0);
163
164 std::string Anno;
165 if (auto *C = dyn_cast_or_null<Constant>(AnnoVal)) {
166 StringRef Str;
167 if (getConstantStringInfo(C, Str))
168 Anno = Str;
169 }
170 // handle optional annotation parameter in a way that Khronos Translator do
171 // (collect integers wrapped in a struct)
172 if (auto *C = dyn_cast_or_null<Constant>(OptAnnoVal);
173 C && C->getNumOperands()) {
174 Value *MaybeStruct = C->getOperand(0);
175 if (auto *Struct = dyn_cast<ConstantStruct>(MaybeStruct)) {
176 for (unsigned I = 0, E = Struct->getNumOperands(); I != E; ++I) {
177 if (auto *CInt = dyn_cast<ConstantInt>(Struct->getOperand(I)))
178 Anno += (I == 0 ? ": " : ", ") +
179 std::to_string(CInt->getType()->getIntegerBitWidth() == 1
180 ? CInt->getZExtValue()
181 : CInt->getSExtValue());
182 }
183 } else if (auto *Struct = dyn_cast<ConstantAggregateZero>(MaybeStruct)) {
184 // { i32 i32 ... } zeroinitializer
185 for (unsigned I = 0, E = Struct->getType()->getStructNumElements();
186 I != E; ++I)
187 Anno += I == 0 ? ": 0" : ", 0";
188 }
189 }
190 return Anno;
191}
192
194 const std::string &Anno,
195 LLVMContext &Ctx,
196 Type *Int32Ty) {
197 // Try to parse the annotation string according to the following rules:
198 // annotation := ({kind} | {kind:value,value,...})+
199 // kind := number
200 // value := number | string
201 static const std::regex R(
202 "\\{(\\d+)(?:[:,](\\d+|\"[^\"]*\")(?:,(\\d+|\"[^\"]*\"))*)?\\}");
204 int Pos = 0;
205 for (std::sregex_iterator
206 It = std::sregex_iterator(Anno.begin(), Anno.end(), R),
207 ItEnd = std::sregex_iterator();
208 It != ItEnd; ++It) {
209 if (It->position() != Pos)
211 Pos = It->position() + It->length();
212 std::smatch Match = *It;
214 for (std::size_t i = 1; i < Match.size(); ++i) {
215 std::ssub_match SMatch = Match[i];
216 std::string Item = SMatch.str();
217 if (Item.length() == 0)
218 break;
219 if (Item[0] == '"') {
220 Item = Item.substr(1, Item.length() - 2);
221 // Acceptable format of the string snippet is:
222 static const std::regex RStr("^(\\d+)(?:,(\\d+))*$");
223 if (std::smatch MatchStr; std::regex_match(Item, MatchStr, RStr)) {
224 for (std::size_t SubIdx = 1; SubIdx < MatchStr.size(); ++SubIdx)
225 if (std::string SubStr = MatchStr[SubIdx].str(); SubStr.length())
227 ConstantInt::get(Int32Ty, std::stoi(SubStr))));
228 } else {
229 MDsItem.push_back(MDString::get(Ctx, Item));
230 }
231 } else if (int32_t Num;
232 std::from_chars(Item.data(), Item.data() + Item.size(), Num)
233 .ec == std::errc{}) {
234 MDsItem.push_back(
235 ConstantAsMetadata::get(ConstantInt::get(Int32Ty, Num)));
236 } else {
237 MDsItem.push_back(MDString::get(Ctx, Item));
238 }
239 }
240 if (MDsItem.size() == 0)
242 MDs.push_back(MDNode::get(Ctx, MDsItem));
243 }
244 return Pos == static_cast<int>(Anno.length()) ? MDs
246}
247
249 LLVMContext &Ctx = II->getContext();
250 Type *Int32Ty = Type::getInt32Ty(Ctx);
251
252 // Retrieve an annotation string from arguments.
253 Value *PtrArg = nullptr;
254 if (auto *BI = dyn_cast<BitCastInst>(II->getArgOperand(0)))
255 PtrArg = BI->getOperand(0);
256 else
257 PtrArg = II->getOperand(0);
258 std::string Anno =
259 getAnnotation(II->getArgOperand(1),
260 4 < II->arg_size() ? II->getArgOperand(4) : nullptr);
261
262 // Parse the annotation.
263 SmallVector<Metadata *> MDs = parseAnnotation(II, Anno, Ctx, Int32Ty);
264
265 // If the annotation string is not parsed successfully we don't know the
266 // format used and output it as a general UserSemantic decoration.
267 // Otherwise MDs is a Metadata tuple (a decoration list) in the format
268 // expected by `spirv.Decorations`.
269 if (MDs.size() == 0) {
270 auto UserSemantic = ConstantAsMetadata::get(ConstantInt::get(
271 Int32Ty, static_cast<uint32_t>(SPIRV::Decoration::UserSemantic)));
272 MDs.push_back(MDNode::get(Ctx, {UserSemantic, MDString::get(Ctx, Anno)}));
273 }
274
275 // Build the internal intrinsic function.
276 IRBuilder<> IRB(II->getParent());
277 IRB.SetInsertPoint(II);
278 IRB.CreateIntrinsic(
279 Intrinsic::spv_assign_decoration, {PtrArg->getType()},
280 {PtrArg, MetadataAsValue::get(Ctx, MDNode::get(Ctx, MDs))});
281 II->replaceAllUsesWith(II->getOperand(0));
282}
283
284static void lowerFunnelShifts(IntrinsicInst *FSHIntrinsic) {
285 // Get a separate function - otherwise, we'd have to rework the CFG of the
286 // current one. Then simply replace the intrinsic uses with a call to the new
287 // function.
288 // Generate LLVM IR for i* @spirv.llvm_fsh?_i* (i* %a, i* %b, i* %c)
289 Module *M = FSHIntrinsic->getModule();
290 FunctionType *FSHFuncTy = FSHIntrinsic->getFunctionType();
291 Type *FSHRetTy = FSHFuncTy->getReturnType();
292 const std::string FuncName = lowerLLVMIntrinsicName(FSHIntrinsic);
293 Function *FSHFunc =
294 getOrCreateFunction(M, FSHRetTy, FSHFuncTy->params(), FuncName);
295
296 if (!FSHFunc->empty()) {
297 FSHIntrinsic->setCalledFunction(FSHFunc);
298 return;
299 }
300 BasicBlock *RotateBB = BasicBlock::Create(M->getContext(), "rotate", FSHFunc);
301 IRBuilder<> IRB(RotateBB);
302 Type *Ty = FSHFunc->getReturnType();
303 // Build the actual funnel shift rotate logic.
304 // In the comments, "int" is used interchangeably with "vector of int
305 // elements".
306 FixedVectorType *VectorTy = dyn_cast<FixedVectorType>(Ty);
307 Type *IntTy = VectorTy ? VectorTy->getElementType() : Ty;
308 unsigned BitWidth = IntTy->getIntegerBitWidth();
309 ConstantInt *BitWidthConstant = IRB.getInt({BitWidth, BitWidth});
310 Value *BitWidthForInsts =
311 VectorTy
312 ? IRB.CreateVectorSplat(VectorTy->getNumElements(), BitWidthConstant)
313 : BitWidthConstant;
314 Value *RotateModVal =
315 IRB.CreateURem(/*Rotate*/ FSHFunc->getArg(2), BitWidthForInsts);
316 Value *FirstShift = nullptr, *SecShift = nullptr;
317 if (FSHIntrinsic->getIntrinsicID() == Intrinsic::fshr) {
318 // Shift the less significant number right, the "rotate" number of bits
319 // will be 0-filled on the left as a result of this regular shift.
320 FirstShift = IRB.CreateLShr(FSHFunc->getArg(1), RotateModVal);
321 } else {
322 // Shift the more significant number left, the "rotate" number of bits
323 // will be 0-filled on the right as a result of this regular shift.
324 FirstShift = IRB.CreateShl(FSHFunc->getArg(0), RotateModVal);
325 }
326 // We want the "rotate" number of the more significant int's LSBs (MSBs) to
327 // occupy the leftmost (rightmost) "0 space" left by the previous operation.
328 // Therefore, subtract the "rotate" number from the integer bitsize...
329 Value *SubRotateVal = IRB.CreateSub(BitWidthForInsts, RotateModVal);
330 if (FSHIntrinsic->getIntrinsicID() == Intrinsic::fshr) {
331 // ...and left-shift the more significant int by this number, zero-filling
332 // the LSBs.
333 SecShift = IRB.CreateShl(FSHFunc->getArg(0), SubRotateVal);
334 } else {
335 // ...and right-shift the less significant int by this number, zero-filling
336 // the MSBs.
337 SecShift = IRB.CreateLShr(FSHFunc->getArg(1), SubRotateVal);
338 }
339 // A simple binary addition of the shifted ints yields the final result.
340 IRB.CreateRet(IRB.CreateOr(FirstShift, SecShift));
341
342 FSHIntrinsic->setCalledFunction(FSHFunc);
343}
344
345static void buildUMulWithOverflowFunc(Function *UMulFunc) {
346 // The function body is already created.
347 if (!UMulFunc->empty())
348 return;
349
350 BasicBlock *EntryBB = BasicBlock::Create(UMulFunc->getParent()->getContext(),
351 "entry", UMulFunc);
352 IRBuilder<> IRB(EntryBB);
353 // Build the actual unsigned multiplication logic with the overflow
354 // indication. Do unsigned multiplication Mul = A * B. Then check
355 // if unsigned division Div = Mul / A is not equal to B. If so,
356 // then overflow has happened.
357 Value *Mul = IRB.CreateNUWMul(UMulFunc->getArg(0), UMulFunc->getArg(1));
358 Value *Div = IRB.CreateUDiv(Mul, UMulFunc->getArg(0));
359 Value *Overflow = IRB.CreateICmpNE(UMulFunc->getArg(0), Div);
360
361 // umul.with.overflow intrinsic return a structure, where the first element
362 // is the multiplication result, and the second is an overflow bit.
363 Type *StructTy = UMulFunc->getReturnType();
364 Value *Agg = IRB.CreateInsertValue(PoisonValue::get(StructTy), Mul, {0});
365 Value *Res = IRB.CreateInsertValue(Agg, Overflow, {1});
366 IRB.CreateRet(Res);
367}
368
370 // If we cannot use the SPV_KHR_expect_assume extension, then we need to
371 // ignore the intrinsic and move on. It should be removed later on by LLVM.
372 // Otherwise we should lower the intrinsic to the corresponding SPIR-V
373 // instruction.
374 // For @llvm.assume we have OpAssumeTrueKHR.
375 // For @llvm.expect we have OpExpectKHR.
376 //
377 // We need to lower this into a builtin and then the builtin into a SPIR-V
378 // instruction.
379 if (II->getIntrinsicID() == Intrinsic::assume) {
381 II->getModule(), Intrinsic::SPVIntrinsics::spv_assume);
382 II->setCalledFunction(F);
383 } else if (II->getIntrinsicID() == Intrinsic::expect) {
385 II->getModule(), Intrinsic::SPVIntrinsics::spv_expect,
386 {II->getOperand(0)->getType()});
387 II->setCalledFunction(F);
388 } else {
389 llvm_unreachable("Unknown intrinsic");
390 }
391
392 return;
393}
394
396 ArrayRef<unsigned> OpNos) {
397 Function *F = nullptr;
398 if (OpNos.empty()) {
399 F = Intrinsic::getDeclaration(II->getModule(), NewID);
400 } else {
402 for (unsigned OpNo : OpNos)
403 Tys.push_back(II->getOperand(OpNo)->getType());
404 F = Intrinsic::getDeclaration(II->getModule(), NewID, Tys);
405 }
406 II->setCalledFunction(F);
407 return true;
408}
409
410static void lowerUMulWithOverflow(IntrinsicInst *UMulIntrinsic) {
411 // Get a separate function - otherwise, we'd have to rework the CFG of the
412 // current one. Then simply replace the intrinsic uses with a call to the new
413 // function.
414 Module *M = UMulIntrinsic->getModule();
415 FunctionType *UMulFuncTy = UMulIntrinsic->getFunctionType();
416 Type *FSHLRetTy = UMulFuncTy->getReturnType();
417 const std::string FuncName = lowerLLVMIntrinsicName(UMulIntrinsic);
418 Function *UMulFunc =
419 getOrCreateFunction(M, FSHLRetTy, UMulFuncTy->params(), FuncName);
421 UMulIntrinsic->setCalledFunction(UMulFunc);
422}
423
424// Substitutes calls to LLVM intrinsics with either calls to SPIR-V intrinsics
425// or calls to proper generated functions. Returns True if F was modified.
426bool SPIRVPrepareFunctions::substituteIntrinsicCalls(Function *F) {
427 bool Changed = false;
428 for (BasicBlock &BB : *F) {
429 for (Instruction &I : BB) {
430 auto Call = dyn_cast<CallInst>(&I);
431 if (!Call)
432 continue;
433 Function *CF = Call->getCalledFunction();
434 if (!CF || !CF->isIntrinsic())
435 continue;
436 auto *II = cast<IntrinsicInst>(Call);
437 switch (II->getIntrinsicID()) {
438 case Intrinsic::memset:
439 case Intrinsic::bswap:
440 Changed |= lowerIntrinsicToFunction(II);
441 break;
442 case Intrinsic::fshl:
443 case Intrinsic::fshr:
445 Changed = true;
446 break;
447 case Intrinsic::umul_with_overflow:
449 Changed = true;
450 break;
451 case Intrinsic::assume:
452 case Intrinsic::expect: {
453 const SPIRVSubtarget &STI = TM.getSubtarget<SPIRVSubtarget>(*F);
454 if (STI.canUseExtension(SPIRV::Extension::SPV_KHR_expect_assume))
456 Changed = true;
457 } break;
458 case Intrinsic::lifetime_start:
459 Changed |= toSpvOverloadedIntrinsic(
460 II, Intrinsic::SPVIntrinsics::spv_lifetime_start, {1});
461 break;
462 case Intrinsic::lifetime_end:
463 Changed |= toSpvOverloadedIntrinsic(
464 II, Intrinsic::SPVIntrinsics::spv_lifetime_end, {1});
465 break;
466 case Intrinsic::ptr_annotation:
468 Changed = true;
469 break;
470 }
471 }
472 }
473 return Changed;
474}
475
476// Returns F if aggregate argument/return types are not present or cloned F
477// function with the types replaced by i32 types. The change in types is
478// noted in 'spv.cloned_funcs' metadata for later restoration.
479Function *
480SPIRVPrepareFunctions::removeAggregateTypesFromSignature(Function *F) {
481 IRBuilder<> B(F->getContext());
482
483 bool IsRetAggr = F->getReturnType()->isAggregateType();
484 bool HasAggrArg =
485 std::any_of(F->arg_begin(), F->arg_end(), [](Argument &Arg) {
486 return Arg.getType()->isAggregateType();
487 });
488 bool DoClone = IsRetAggr || HasAggrArg;
489 if (!DoClone)
490 return F;
491 SmallVector<std::pair<int, Type *>, 4> ChangedTypes;
492 Type *RetType = IsRetAggr ? B.getInt32Ty() : F->getReturnType();
493 if (IsRetAggr)
494 ChangedTypes.push_back(std::pair<int, Type *>(-1, F->getReturnType()));
495 SmallVector<Type *, 4> ArgTypes;
496 for (const auto &Arg : F->args()) {
497 if (Arg.getType()->isAggregateType()) {
498 ArgTypes.push_back(B.getInt32Ty());
499 ChangedTypes.push_back(
500 std::pair<int, Type *>(Arg.getArgNo(), Arg.getType()));
501 } else
502 ArgTypes.push_back(Arg.getType());
503 }
504 FunctionType *NewFTy =
505 FunctionType::get(RetType, ArgTypes, F->getFunctionType()->isVarArg());
506 Function *NewF =
507 Function::Create(NewFTy, F->getLinkage(), F->getName(), *F->getParent());
508
510 auto NewFArgIt = NewF->arg_begin();
511 for (auto &Arg : F->args()) {
512 StringRef ArgName = Arg.getName();
513 NewFArgIt->setName(ArgName);
514 VMap[&Arg] = &(*NewFArgIt++);
515 }
517
518 CloneFunctionInto(NewF, F, VMap, CloneFunctionChangeType::LocalChangesOnly,
519 Returns);
520 NewF->takeName(F);
521
522 NamedMDNode *FuncMD =
523 F->getParent()->getOrInsertNamedMetadata("spv.cloned_funcs");
525 MDArgs.push_back(MDString::get(B.getContext(), NewF->getName()));
526 for (auto &ChangedTyP : ChangedTypes)
527 MDArgs.push_back(MDNode::get(
528 B.getContext(),
529 {ConstantAsMetadata::get(B.getInt32(ChangedTyP.first)),
530 ValueAsMetadata::get(Constant::getNullValue(ChangedTyP.second))}));
531 MDNode *ThisFuncMD = MDNode::get(B.getContext(), MDArgs);
532 FuncMD->addOperand(ThisFuncMD);
533
534 for (auto *U : make_early_inc_range(F->users())) {
535 if (auto *CI = dyn_cast<CallInst>(U))
536 CI->mutateFunctionType(NewF->getFunctionType());
537 U->replaceUsesOfWith(F, NewF);
538 }
539 return NewF;
540}
541
542bool SPIRVPrepareFunctions::runOnModule(Module &M) {
543 bool Changed = false;
544 for (Function &F : M)
545 Changed |= substituteIntrinsicCalls(&F);
546
547 std::vector<Function *> FuncsWorklist;
548 for (auto &F : M)
549 FuncsWorklist.push_back(&F);
550
551 for (auto *F : FuncsWorklist) {
552 Function *NewF = removeAggregateTypesFromSignature(F);
553
554 if (NewF != F) {
555 F->eraseFromParent();
556 Changed = true;
557 }
558 }
559 return Changed;
560}
561
564 return new SPIRVPrepareFunctions(TM);
565}
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
return RetTy
std::string Name
#define F(x, y, z)
Definition: MD5.cpp:55
#define I(x, y, z)
Definition: MD5.cpp:58
uint64_t IntrinsicInst * II
const char LLVMTargetMachineRef TM
#define INITIALIZE_PASS(passName, arg, name, cfg, analysis)
Definition: PassSupport.h:38
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
static void lowerFunnelShifts(IntrinsicInst *FSHIntrinsic)
static std::string getAnnotation(Value *AnnoVal, Value *OptAnnoVal)
static bool toSpvOverloadedIntrinsic(IntrinsicInst *II, Intrinsic::ID NewID, ArrayRef< unsigned > OpNos)
static bool lowerIntrinsicToFunction(IntrinsicInst *Intrinsic)
static void lowerPtrAnnotation(IntrinsicInst *II)
static void lowerUMulWithOverflow(IntrinsicInst *UMulIntrinsic)
static SmallVector< Metadata * > parseAnnotation(Value *I, const std::string &Anno, LLVMContext &Ctx, Type *Int32Ty)
static void lowerExpectAssume(IntrinsicInst *II)
static void buildUMulWithOverflowFunc(Function *UMulFunc)
static Function * getOrCreateFunction(Module *M, Type *RetTy, ArrayRef< Type * > ArgTypes, StringRef Name)
@ Struct
BinaryOperator * Mul
Represent the analysis usage information of a pass.
This class represents an incoming formal argument to a Function.
Definition: Argument.h:31
ArrayRef - Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition: ArrayRef.h:41
bool empty() const
empty - Check if the array is empty.
Definition: ArrayRef.h:160
LLVM Basic Block Representation.
Definition: BasicBlock.h:61
static BasicBlock * Create(LLVMContext &Context, const Twine &Name="", Function *Parent=nullptr, BasicBlock *InsertBefore=nullptr)
Creates a new BasicBlock.
Definition: BasicBlock.h:202
FunctionType * getFunctionType() const
Definition: InstrTypes.h:1323
void setCalledFunction(Function *Fn)
Sets the function called, including updating the function type.
Definition: InstrTypes.h:1504
static ConstantAsMetadata * get(Constant *C)
Definition: Metadata.h:528
This is the shared class of boolean and integer constants.
Definition: Constants.h:81
Class to represent fixed width SIMD vectors.
Definition: DerivedTypes.h:539
unsigned getNumElements() const
Definition: DerivedTypes.h:582
A handy container for a FunctionType+Callee-pointer pair, which can be passed around as a single enti...
Definition: DerivedTypes.h:168
static Function * Create(FunctionType *Ty, LinkageTypes Linkage, unsigned AddrSpace, const Twine &N="", Module *M=nullptr)
Definition: Function.h:165
bool empty() const
Definition: Function.h:822
FunctionType * getFunctionType() const
Returns the FunctionType for me.
Definition: Function.h:207
arg_iterator arg_begin()
Definition: Function.h:831
bool isIntrinsic() const
isIntrinsic - Returns true if the function's name starts with "llvm.".
Definition: Function.h:247
Type * getReturnType() const
Returns the type of the ret val.
Definition: Function.h:212
void setCallingConv(CallingConv::ID CC)
Definition: Function.h:278
Argument * getArg(unsigned i) const
Definition: Function.h:849
Module * getParent()
Get the module that this global value is contained inside of...
Definition: GlobalValue.h:656
void setDSOLocal(bool Local)
Definition: GlobalValue.h:303
@ ExternalLinkage
Externally visible function.
Definition: GlobalValue.h:52
Value * CreateNUWMul(Value *LHS, Value *RHS, const Twine &Name="")
Definition: IRBuilder.h:1372
Value * CreateInsertValue(Value *Agg, Value *Val, ArrayRef< unsigned > Idxs, const Twine &Name="")
Definition: IRBuilder.h:2521
Value * CreateVectorSplat(unsigned NumElts, Value *V, const Twine &Name="")
Return a vector value that contains.
Definition: IRBuilder.cpp:1192
CallInst * CreateIntrinsic(Intrinsic::ID ID, ArrayRef< Type * > Types, ArrayRef< Value * > Args, Instruction *FMFSource=nullptr, const Twine &Name="")
Create a call to intrinsic ID with Args, mangled using Types.
Definition: IRBuilder.cpp:932
CallInst * CreateMemSet(Value *Ptr, Value *Val, uint64_t Size, MaybeAlign Align, bool isVolatile=false, MDNode *TBAATag=nullptr, MDNode *ScopeTag=nullptr, MDNode *NoAliasTag=nullptr)
Create and insert a memset to the specified pointer and the specified value.
Definition: IRBuilder.h:593
Value * CreateLShr(Value *LHS, Value *RHS, const Twine &Name="", bool isExact=false)
Definition: IRBuilder.h:1435
ReturnInst * CreateRet(Value *V)
Create a 'ret <val>' instruction.
Definition: IRBuilder.h:1093
Value * CreateUDiv(Value *LHS, Value *RHS, const Twine &Name="", bool isExact=false)
Definition: IRBuilder.h:1376
Value * CreateICmpNE(Value *LHS, Value *RHS, const Twine &Name="")
Definition: IRBuilder.h:2243
Value * CreateSub(Value *LHS, Value *RHS, const Twine &Name="", bool HasNUW=false, bool HasNSW=false)
Definition: IRBuilder.h:1342
Value * CreateShl(Value *LHS, Value *RHS, const Twine &Name="", bool HasNUW=false, bool HasNSW=false)
Definition: IRBuilder.h:1414
ReturnInst * CreateRetVoid()
Create a 'ret void' instruction.
Definition: IRBuilder.h:1088
Value * CreateOr(Value *LHS, Value *RHS, const Twine &Name="")
Definition: IRBuilder.h:1495
void SetInsertPoint(BasicBlock *TheBB)
This specifies that created instructions should be appended to the end of the specified block.
Definition: IRBuilder.h:178
ConstantInt * getInt(const APInt &AI)
Get a constant integer value.
Definition: IRBuilder.h:500
Value * CreateURem(Value *LHS, Value *RHS, const Twine &Name="")
Definition: IRBuilder.h:1402
This provides a uniform API for creating instructions and inserting them into a basic block: either a...
Definition: IRBuilder.h:2664
const Module * getModule() const
Return the module owning the function this instruction belongs to or nullptr it the function does not...
Definition: Instruction.cpp:66
A wrapper class for inspecting calls to intrinsic functions.
Definition: IntrinsicInst.h:48
Intrinsic::ID getIntrinsicID() const
Return the intrinsic ID of this intrinsic.
Definition: IntrinsicInst.h:55
void LowerIntrinsicCall(CallInst *CI)
Replace a call to the specified intrinsic function.
This is an important class for using LLVM in a threaded context.
Definition: LLVMContext.h:67
Metadata node.
Definition: Metadata.h:1067
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
Definition: Metadata.h:1541
static MDString * get(LLVMContext &Context, StringRef Str)
Definition: Metadata.cpp:600
This class wraps the llvm.memset and llvm.memset.inline intrinsics.
static MetadataAsValue * get(LLVMContext &Context, Metadata *MD)
Definition: Metadata.cpp:103
ModulePass class - This class is used to implement unstructured interprocedural optimizations and ana...
Definition: Pass.h:251
virtual bool runOnModule(Module &M)=0
runOnModule - Virtual method overriden by subclasses to process the module being operated on.
A Module instance is used to store all the information related to an LLVM module.
Definition: Module.h:65
LLVMContext & getContext() const
Get the global data context.
Definition: Module.h:301
A tuple of MDNodes.
Definition: Metadata.h:1729
void addOperand(MDNode *M)
Definition: Metadata.cpp:1387
PassRegistry - This class manages the registration and intitialization of the pass subsystem as appli...
Definition: PassRegistry.h:37
static PassRegistry * getPassRegistry()
getPassRegistry - Access the global registry object, which is automatically initialized at applicatio...
virtual void getAnalysisUsage(AnalysisUsage &) const
getAnalysisUsage - This function should be overriden by passes that need analysis information to do t...
Definition: Pass.cpp:98
virtual StringRef getPassName() const
getPassName - Return a nice clean name for a pass.
Definition: Pass.cpp:81
static PoisonValue * get(Type *T)
Static factory methods - Return an 'poison' object of the specified type.
Definition: Constants.cpp:1814
bool canUseExtension(SPIRV::Extension::Extension E) const
size_t size() const
Definition: SmallVector.h:91
void push_back(const T &Elt)
Definition: SmallVector.h:426
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1209
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
std::string str() const
str - Get the contents as an std::string.
Definition: StringRef.h:223
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
unsigned getIntegerBitWidth() const
static IntegerType * getInt32Ty(LLVMContext &C)
LLVM Value Representation.
Definition: Value.h:74
Type * getType() const
All values are typed, get the type of this value.
Definition: Value.h:255
void setName(const Twine &Name)
Change the name of the value.
Definition: Value.cpp:377
StringRef getName() const
Return a constant reference to the value's name.
Definition: Value.cpp:309
void takeName(Value *V)
Transfer the name from V to this value.
Definition: Value.cpp:383
Type * getElementType() const
Definition: DerivedTypes.h:436
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
unsigned ID
LLVM IR allows to use arbitrary numbers as calling convention identifiers.
Definition: CallingConv.h:24
@ SPIR_FUNC
Used for SPIR non-kernel device functions.
Definition: CallingConv.h:138
@ C
The default llvm calling convention, compatible with C.
Definition: CallingConv.h:34
Function * getDeclaration(Module *M, ID id, ArrayRef< Type * > Tys=std::nullopt)
Create or insert an LLVM Function declaration for an intrinsic, and return it.
Definition: Function.cpp:1484
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
void initializeSPIRVPrepareFunctionsPass(PassRegistry &)
bool getConstantStringInfo(const Value *V, StringRef &Str, bool TrimAtNul=true)
This function computes the length of a null-terminated C string pointed to by V.
iterator_range< early_inc_iterator_impl< detail::IterOfRange< RangeT > > > make_early_inc_range(RangeT &&Range)
Make a range that does early increment to allow mutation of the underlying range without disrupting i...
Definition: STLExtras.h:656
@ Ref
The access may reference the value stored in memory.
constexpr unsigned BitWidth
Definition: BitmaskEnum.h:191
void CloneFunctionInto(Function *NewFunc, const Function *OldFunc, ValueToValueMapTy &VMap, CloneFunctionChangeType Changes, SmallVectorImpl< ReturnInst * > &Returns, const char *NameSuffix="", ClonedCodeInfo *CodeInfo=nullptr, ValueMapTypeRemapper *TypeMapper=nullptr, ValueMaterializer *Materializer=nullptr)
Clone OldFunc into NewFunc, transforming the old arguments into references to VMap values.
ModulePass * createSPIRVPrepareFunctionsPass(const SPIRVTargetMachine &TM)
void expandMemSetAsLoop(MemSetInst *MemSet)
Expand MemSet as a loop. MemSet is not deleted.
Implement std::hash so that hash_code can be used in STL containers.
Definition: BitVector.h:858