LLVM 23.0.0git
LowerTypeTests.cpp
Go to the documentation of this file.
1//===- LowerTypeTests.cpp - type metadata lowering pass -------------------===//
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 lowers type metadata and calls to the llvm.type.test intrinsic.
10// It also ensures that globals are properly laid out for the
11// llvm.icall.branch.funnel intrinsic.
12// See http://llvm.org/docs/TypeMetadata.html for more information.
13//
14//===----------------------------------------------------------------------===//
15
17#include "llvm/ADT/APInt.h"
18#include "llvm/ADT/ArrayRef.h"
19#include "llvm/ADT/DenseMap.h"
22#include "llvm/ADT/STLExtras.h"
24#include "llvm/ADT/SetVector.h"
26#include "llvm/ADT/Statistic.h"
27#include "llvm/ADT/StringRef.h"
35#include "llvm/IR/Attributes.h"
36#include "llvm/IR/BasicBlock.h"
37#include "llvm/IR/Constant.h"
38#include "llvm/IR/Constants.h"
39#include "llvm/IR/DIBuilder.h"
40#include "llvm/IR/DataLayout.h"
42#include "llvm/IR/Function.h"
43#include "llvm/IR/GlobalAlias.h"
45#include "llvm/IR/GlobalValue.h"
47#include "llvm/IR/IRBuilder.h"
48#include "llvm/IR/InlineAsm.h"
49#include "llvm/IR/Instruction.h"
52#include "llvm/IR/Intrinsics.h"
53#include "llvm/IR/LLVMContext.h"
54#include "llvm/IR/MDBuilder.h"
55#include "llvm/IR/Metadata.h"
56#include "llvm/IR/Module.h"
59#include "llvm/IR/Operator.h"
60#include "llvm/IR/PassManager.h"
63#include "llvm/IR/Type.h"
64#include "llvm/IR/Use.h"
65#include "llvm/IR/User.h"
66#include "llvm/IR/Value.h"
70#include "llvm/Support/Debug.h"
71#include "llvm/Support/Error.h"
80#include "llvm/Transforms/IPO.h"
83#include <algorithm>
84#include <cassert>
85#include <cstdint>
86#include <set>
87#include <string>
88#include <system_error>
89#include <utility>
90#include <vector>
91
92using namespace llvm;
93using namespace lowertypetests;
94
95#define DEBUG_TYPE "lowertypetests"
96
97STATISTIC(ByteArraySizeBits, "Byte array size in bits");
98STATISTIC(ByteArraySizeBytes, "Byte array size in bytes");
99STATISTIC(NumByteArraysCreated, "Number of byte arrays created");
100STATISTIC(NumTypeTestCallsLowered, "Number of type test calls lowered");
101STATISTIC(NumTypeIdDisjointSets, "Number of disjoint sets of type identifiers");
102
104 "lowertypetests-avoid-reuse",
105 cl::desc("Try to avoid reuse of byte array addresses using aliases"),
106 cl::Hidden, cl::init(true));
107
109 "lowertypetests-summary-action",
110 cl::desc("What to do with the summary when running this pass"),
111 cl::values(clEnumValN(PassSummaryAction::None, "none", "Do nothing"),
113 "Import typeid resolutions from summary and globals"),
115 "Export typeid resolutions to summary and globals")),
116 cl::Hidden);
117
119 "lowertypetests-read-summary",
120 cl::desc("Read summary from given YAML file before running pass"),
121 cl::Hidden);
122
124 "lowertypetests-write-summary",
125 cl::desc("Write summary to given YAML file after running pass"),
126 cl::Hidden);
127
128// FIXME: Remove in clang 24.
130 "lowertypetests-jump-table-debug-info", cl::init(true), cl::Hidden,
131 cl::desc("Enable debug info generation for jump tables"));
132
134 if (Offset < ByteOffset)
135 return false;
136
137 if ((Offset - ByteOffset) % (uint64_t(1) << AlignLog2) != 0)
138 return false;
139
140 uint64_t BitOffset = (Offset - ByteOffset) >> AlignLog2;
141 if (BitOffset >= BitSize)
142 return false;
143
144 return Bits.count(BitSize - 1 - BitOffset);
145}
146
148 OS << "offset " << ByteOffset << " size " << BitSize << " align "
149 << (1 << AlignLog2);
150
151 if (isAllOnes()) {
152 OS << " all-ones\n";
153 return;
154 }
155
156 OS << " { ";
157 for (uint64_t B : Bits)
158 OS << B << ' ';
159 OS << "}\n";
160}
161
163 if (Min > Max)
164 Min = 0;
165
166 // Normalize each offset against the minimum observed offset, and compute
167 // the bitwise OR of each of the offsets. The number of trailing zeros
168 // in the mask gives us the log2 of the alignment of all offsets, which
169 // allows us to compress the bitset by only storing one bit per aligned
170 // address.
171 uint64_t Mask = 0;
172 for (uint64_t &Offset : Offsets) {
173 Offset -= Min;
174 Mask |= Offset;
175 }
176
177 BitSetInfo BSI;
178 BSI.ByteOffset = Min;
179
180 BSI.AlignLog2 = 0;
181 if (Mask != 0)
182 BSI.AlignLog2 = llvm::countr_zero(Mask);
183
184 // Build the compressed bitset while normalizing the offsets against the
185 // computed alignment.
186 BSI.BitSize = ((Max - Min) >> BSI.AlignLog2) + 1;
187 for (uint64_t Offset : Offsets) {
188 Offset >>= BSI.AlignLog2;
189 // We invert the order of bits when adding them to the bitset. This is
190 // because the offset that we test against is computed by subtracting the
191 // address that we are testing from the global's address, which means that
192 // the offset increases as the tested address decreases.
193 BSI.Bits.insert(BSI.BitSize - 1 - Offset);
194 }
195
196 return BSI;
197}
198
199void GlobalLayoutBuilder::addFragment(const std::set<uint64_t> &F) {
200 // Create a new fragment to hold the layout for F.
201 Fragments.emplace_back();
202 std::vector<uint64_t> &Fragment = Fragments.back();
203 uint64_t FragmentIndex = Fragments.size() - 1;
204
205 for (auto ObjIndex : F) {
206 uint64_t OldFragmentIndex = FragmentMap[ObjIndex];
207 if (OldFragmentIndex == 0) {
208 // We haven't seen this object index before, so just add it to the current
209 // fragment.
210 Fragment.push_back(ObjIndex);
211 } else {
212 // This index belongs to an existing fragment. Copy the elements of the
213 // old fragment into this one and clear the old fragment. We don't update
214 // the fragment map just yet, this ensures that any further references to
215 // indices from the old fragment in this fragment do not insert any more
216 // indices.
217 std::vector<uint64_t> &OldFragment = Fragments[OldFragmentIndex];
218 llvm::append_range(Fragment, OldFragment);
219 OldFragment.clear();
220 }
221 }
222
223 // Update the fragment map to point our object indices to this fragment.
224 for (uint64_t ObjIndex : Fragment)
225 FragmentMap[ObjIndex] = FragmentIndex;
226}
227
228void ByteArrayBuilder::allocate(const std::set<uint64_t> &Bits,
229 uint64_t BitSize, uint64_t &AllocByteOffset,
230 uint8_t &AllocMask) {
231 // Find the smallest current allocation.
232 unsigned Bit = 0;
233 for (unsigned I = 1; I != BitsPerByte; ++I)
234 if (BitAllocs[I] < BitAllocs[Bit])
235 Bit = I;
236
237 AllocByteOffset = BitAllocs[Bit];
238
239 // Add our size to it.
240 unsigned ReqSize = AllocByteOffset + BitSize;
241 BitAllocs[Bit] = ReqSize;
242 if (Bytes.size() < ReqSize)
243 Bytes.resize(ReqSize);
244
245 // Set our bits.
246 AllocMask = 1 << Bit;
247 for (uint64_t B : Bits)
248 Bytes[AllocByteOffset + B] |= AllocMask;
249}
250
252 if (F->isDeclarationForLinker())
253 return false;
255 F->getParent()->getModuleFlag("CFI Canonical Jump Tables"));
256 if (!CI || !CI->isZero())
257 return true;
258 return F->hasFnAttribute("cfi-canonical-jump-table");
259}
260
261namespace {
262
263struct ByteArrayInfo {
264 std::set<uint64_t> Bits;
265 uint64_t BitSize;
266 GlobalVariable *ByteArray;
267 GlobalVariable *MaskGlobal;
268 uint8_t *MaskPtr = nullptr;
269};
270
271/// A POD-like structure that we use to store a global reference together with
272/// its metadata types. In this pass we frequently need to query the set of
273/// metadata types referenced by a global, which at the IR level is an expensive
274/// operation involving a map lookup; this data structure helps to reduce the
275/// number of times we need to do this lookup.
276class GlobalTypeMember final : TrailingObjects<GlobalTypeMember, MDNode *> {
277 friend TrailingObjects;
278
279 GlobalObject *GO;
280 size_t NTypes;
281
282 // For functions: true if the jump table is canonical. This essentially means
283 // whether the canonical address (i.e. the symbol table entry) of the function
284 // is provided by the local jump table. This is normally the same as whether
285 // the function is defined locally, but if canonical jump tables are disabled
286 // by the user then the jump table never provides a canonical definition.
287 bool IsJumpTableCanonical;
288
289 // For functions: true if this function is either defined or used in a thinlto
290 // module and its jumptable entry needs to be exported to thinlto backends.
291 bool IsExported;
292
293public:
294 static GlobalTypeMember *create(BumpPtrAllocator &Alloc, GlobalObject *GO,
295 bool IsJumpTableCanonical, bool IsExported,
296 ArrayRef<MDNode *> Types) {
297 auto *GTM = static_cast<GlobalTypeMember *>(Alloc.Allocate(
298 totalSizeToAlloc<MDNode *>(Types.size()), alignof(GlobalTypeMember)));
299 GTM->GO = GO;
300 GTM->NTypes = Types.size();
301 GTM->IsJumpTableCanonical = IsJumpTableCanonical;
302 GTM->IsExported = IsExported;
303 llvm::copy(Types, GTM->getTrailingObjects());
304 return GTM;
305 }
306
307 GlobalObject *getGlobal() const {
308 return GO;
309 }
310
311 bool isJumpTableCanonical() const {
312 return IsJumpTableCanonical;
313 }
314
315 bool isExported() const {
316 return IsExported;
317 }
318
319 ArrayRef<MDNode *> types() const { return getTrailingObjects(NTypes); }
320};
321
322struct ICallBranchFunnel final
323 : TrailingObjects<ICallBranchFunnel, GlobalTypeMember *> {
324 static ICallBranchFunnel *create(BumpPtrAllocator &Alloc, CallInst *CI,
326 unsigned UniqueId) {
327 auto *Call = static_cast<ICallBranchFunnel *>(
328 Alloc.Allocate(totalSizeToAlloc<GlobalTypeMember *>(Targets.size()),
329 alignof(ICallBranchFunnel)));
330 Call->CI = CI;
331 Call->UniqueId = UniqueId;
332 Call->NTargets = Targets.size();
333 llvm::copy(Targets, Call->getTrailingObjects());
334 return Call;
335 }
336
337 CallInst *CI;
338 ArrayRef<GlobalTypeMember *> targets() const {
339 return getTrailingObjects(NTargets);
340 }
341
342 unsigned UniqueId;
343
344private:
345 size_t NTargets;
346};
347
348struct ScopedSaveAliaseesAndUsed {
349 Module &M;
351 std::vector<std::pair<GlobalAlias *, Function *>> FunctionAliases;
352 std::vector<std::pair<GlobalIFunc *, Function *>> ResolverIFuncs;
353
354 // This function only removes functions from llvm.used and llvm.compiler.used.
355 // We cannot remove global variables because they need to follow RAUW, as
356 // they may be deleted by buildBitSetsFromGlobalVariables.
357 void collectAndEraseUsedFunctions(Module &M,
358 SmallVectorImpl<GlobalValue *> &Vec,
359 bool CompilerUsed) {
360 auto *GV = collectUsedGlobalVariables(M, Vec, CompilerUsed);
361 if (!GV)
362 return;
363 // There's no API to only remove certain array elements from
364 // llvm.used/llvm.compiler.used, so we remove all of them and add back only
365 // the non-functions.
366 GV->eraseFromParent();
367 auto NonFuncBegin =
368 std::stable_partition(Vec.begin(), Vec.end(), [](GlobalValue *GV) {
369 return isa<Function>(GV);
370 });
371 if (CompilerUsed)
372 appendToCompilerUsed(M, {NonFuncBegin, Vec.end()});
373 else
374 appendToUsed(M, {NonFuncBegin, Vec.end()});
375 Vec.resize(NonFuncBegin - Vec.begin());
376 }
377
378 ScopedSaveAliaseesAndUsed(Module &M) : M(M) {
379 // The users of this class want to replace all function references except
380 // for aliases and llvm.used/llvm.compiler.used with references to a jump
381 // table. We avoid replacing aliases in order to avoid introducing a double
382 // indirection (or an alias pointing to a declaration in ThinLTO mode), and
383 // we avoid replacing llvm.used/llvm.compiler.used because these global
384 // variables describe properties of the global, not the jump table (besides,
385 // offseted references to the jump table in llvm.used are invalid).
386 // Unfortunately, LLVM doesn't have a "RAUW except for these (possibly
387 // indirect) users", so what we do is save the list of globals referenced by
388 // llvm.used/llvm.compiler.used and aliases, erase the used lists, let RAUW
389 // replace the aliasees and then set them back to their original values at
390 // the end.
391 collectAndEraseUsedFunctions(M, Used, false);
392 collectAndEraseUsedFunctions(M, CompilerUsed, true);
393
394 for (auto &GA : M.aliases()) {
395 // FIXME: This should look past all aliases not just interposable ones,
396 // see discussion on D65118.
397 if (auto *F = dyn_cast<Function>(GA.getAliasee()->stripPointerCasts()))
398 FunctionAliases.push_back({&GA, F});
399 }
400
401 for (auto &GI : M.ifuncs())
402 if (auto *F = dyn_cast<Function>(GI.getResolver()->stripPointerCasts()))
403 ResolverIFuncs.push_back({&GI, F});
404 }
405
406 ~ScopedSaveAliaseesAndUsed() {
407 appendToUsed(M, Used);
408 appendToCompilerUsed(M, CompilerUsed);
409
410 for (auto P : FunctionAliases)
411 P.first->setAliasee(P.second);
412
413 for (auto P : ResolverIFuncs) {
414 // This does not preserve pointer casts that may have been stripped by the
415 // constructor, but the resolver's type is different from that of the
416 // ifunc anyway.
417 P.first->setResolver(P.second);
418 }
419 }
420};
421
422class LowerTypeTestsModule {
423 Module &M;
424
425 ModuleSummaryIndex *ExportSummary;
426 const ModuleSummaryIndex *ImportSummary;
427
428 Triple::ArchType Arch;
430 Triple::ObjectFormatType ObjectFormat;
431
432 // Determines which kind of Thumb jump table we generate. If arch is
433 // either 'arm' or 'thumb' we need to find this out, because
434 // selectJumpTableArmEncoding may decide to use Thumb in either case.
435 bool CanUseArmJumpTable = false, CanUseThumbBWJumpTable = false;
436
437 // Cache variable used by hasBranchTargetEnforcement().
438 int HasBranchTargetEnforcement = -1;
439
440 IntegerType *Int1Ty = Type::getInt1Ty(M.getContext());
441 IntegerType *Int8Ty = Type::getInt8Ty(M.getContext());
442 PointerType *PtrTy = PointerType::getUnqual(M.getContext());
443 ArrayType *Int8Arr0Ty = ArrayType::get(Type::getInt8Ty(M.getContext()), 0);
444 IntegerType *Int32Ty = Type::getInt32Ty(M.getContext());
445 IntegerType *Int64Ty = Type::getInt64Ty(M.getContext());
446 IntegerType *IntPtrTy = M.getDataLayout().getIntPtrType(M.getContext(), 0);
447
448 // Indirect function call index assignment counter for WebAssembly
449 uint64_t IndirectIndex = 1;
450
451 // Mapping from type identifiers to the call sites that test them, as well as
452 // whether the type identifier needs to be exported to ThinLTO backends as
453 // part of the regular LTO phase of the ThinLTO pipeline (see exportTypeId).
454 struct TypeIdUserInfo {
455 std::vector<CallInst *> CallSites;
456 bool IsExported = false;
457 };
458 DenseMap<Metadata *, TypeIdUserInfo> TypeIdUsers;
459
460 /// This structure describes how to lower type tests for a particular type
461 /// identifier. It is either built directly from the global analysis (during
462 /// regular LTO or the regular LTO phase of ThinLTO), or indirectly using type
463 /// identifier summaries and external symbol references (in ThinLTO backends).
464 struct TypeIdLowering {
466
467 /// All except Unsat: the address of the last element within the combined
468 /// global.
469 Constant *OffsetedGlobal;
470
471 /// ByteArray, Inline, AllOnes: log2 of the required global alignment
472 /// relative to the start address.
473 Constant *AlignLog2;
474
475 /// ByteArray, Inline, AllOnes: one less than the size of the memory region
476 /// covering members of this type identifier as a multiple of 2^AlignLog2.
477 Constant *SizeM1;
478
479 /// ByteArray: the byte array to test the address against.
480 Constant *TheByteArray;
481
482 /// ByteArray: the bit mask to apply to bytes loaded from the byte array.
483 Constant *BitMask;
484
485 /// Inline: the bit mask to test the address against.
486 Constant *InlineBits;
487 };
488
489 std::vector<ByteArrayInfo> ByteArrayInfos;
490
491 Function *WeakInitializerFn = nullptr;
492
493 GlobalVariable *GlobalAnnotation;
494 DenseSet<Value *> FunctionAnnotations;
495
496 // Cross-DSO CFI emits jumptable entries for exported functions as well as
497 // address taken functions in case they are address taken in other modules.
498 bool CrossDsoCfi = M.getModuleFlag("Cross-DSO CFI") != nullptr;
499
500 bool shouldExportConstantsAsAbsoluteSymbols();
501 uint8_t *exportTypeId(StringRef TypeId, const TypeIdLowering &TIL);
502 TypeIdLowering importTypeId(StringRef TypeId);
503 void importTypeTest(CallInst *CI);
504 void importFunction(Function *F, bool isJumpTableCanonical);
505
506 ByteArrayInfo *createByteArray(const BitSetInfo &BSI);
507 void allocateByteArrays();
508 Value *createBitSetTest(IRBuilder<> &B, const TypeIdLowering &TIL,
509 Value *BitOffset);
510 void lowerTypeTestCalls(
511 ArrayRef<Metadata *> TypeIds, Constant *CombinedGlobalAddr,
512 const DenseMap<GlobalTypeMember *, uint64_t> &GlobalLayout);
513 Value *lowerTypeTestCall(Metadata *TypeId, CallInst *CI,
514 const TypeIdLowering &TIL);
515
516 void buildBitSetsFromGlobalVariables(ArrayRef<Metadata *> TypeIds,
519 selectJumpTableArmEncoding(ArrayRef<GlobalTypeMember *> Functions);
520 bool hasBranchTargetEnforcement();
521 unsigned getJumpTableEntrySize(Triple::ArchType JumpTableArch);
522 InlineAsm *createJumpTableEntryAsm(Triple::ArchType JumpTableArch);
523 void verifyTypeMDNode(GlobalObject *GO, MDNode *Type);
524 void buildBitSetsFromFunctions(ArrayRef<Metadata *> TypeIds,
526 void buildBitSetsFromFunctionsNative(ArrayRef<Metadata *> TypeIds,
528 void buildBitSetsFromFunctionsWASM(ArrayRef<Metadata *> TypeIds,
530 void
531 buildBitSetsFromDisjointSet(ArrayRef<Metadata *> TypeIds,
533 ArrayRef<ICallBranchFunnel *> ICallBranchFunnels);
534
535 void replaceWeakDeclarationWithJumpTablePtr(Function *F, Constant *JT,
536 bool IsJumpTableCanonical);
537 void moveInitializerToModuleConstructor(GlobalVariable *GV);
538 void findGlobalVariableUsersOf(Constant *C,
539 SmallSetVector<GlobalVariable *, 8> &Out);
540
541 void createJumpTable(Function *F, ArrayRef<GlobalTypeMember *> Functions,
542 Triple::ArchType JumpTableArch);
543
544 /// replaceCfiUses - Go through the uses list for this definition
545 /// and make each use point to "V" instead of "this" when the use is outside
546 /// the block. 'This's use list is expected to have at least one element.
547 /// Unlike replaceAllUsesWith this function skips blockaddr and direct call
548 /// uses.
549 void replaceCfiUses(Function *Old, Value *New, bool IsJumpTableCanonical);
550
551 /// replaceDirectCalls - Go through the uses list for this definition and
552 /// replace each use, which is a direct function call.
553 void replaceDirectCalls(Value *Old, Value *New);
554
555 bool isFunctionAnnotation(Value *V) const {
556 return FunctionAnnotations.contains(V);
557 }
558
559 void maybeReplaceComdat(Function *F, StringRef OriginalName);
560
561public:
562 LowerTypeTestsModule(Module &M, ModuleAnalysisManager &AM,
563 ModuleSummaryIndex *ExportSummary,
564 const ModuleSummaryIndex *ImportSummary);
565
566 bool lower();
567
568 // Lower the module using the action and summary passed as command line
569 // arguments. For testing purposes only.
570 static bool runForTesting(Module &M, ModuleAnalysisManager &AM);
571};
572} // end anonymous namespace
573
574/// Build a bit set for list of offsets.
576 // Compute the byte offset of each address associated with this type
577 // identifier.
578 return BitSetBuilder(Offsets).build();
579}
580
581/// Build a test that bit BitOffset mod sizeof(Bits)*8 is set in
582/// Bits. This pattern matches to the bt instruction on x86.
584 Value *BitOffset) {
585 auto BitsType = cast<IntegerType>(Bits->getType());
586 unsigned BitWidth = BitsType->getBitWidth();
587
588 BitOffset = B.CreateZExtOrTrunc(BitOffset, BitsType);
589 Value *BitIndex =
590 B.CreateAnd(BitOffset, ConstantInt::get(BitsType, BitWidth - 1));
591 Value *BitMask = B.CreateShl(ConstantInt::get(BitsType, 1), BitIndex);
592 Value *MaskedBits = B.CreateAnd(Bits, BitMask);
593 return B.CreateICmpNE(MaskedBits, ConstantInt::get(BitsType, 0));
594}
595
596ByteArrayInfo *LowerTypeTestsModule::createByteArray(const BitSetInfo &BSI) {
597 // Create globals to stand in for byte arrays and masks. These never actually
598 // get initialized, we RAUW and erase them later in allocateByteArrays() once
599 // we know the offset and mask to use.
600 auto ByteArrayGlobal = new GlobalVariable(
601 M, Int8Ty, /*isConstant=*/true, GlobalValue::PrivateLinkage, nullptr);
602 auto MaskGlobal = new GlobalVariable(M, Int8Ty, /*isConstant=*/true,
604
605 ByteArrayInfos.emplace_back();
606 ByteArrayInfo *BAI = &ByteArrayInfos.back();
607
608 BAI->Bits = BSI.Bits;
609 BAI->BitSize = BSI.BitSize;
610 BAI->ByteArray = ByteArrayGlobal;
611 BAI->MaskGlobal = MaskGlobal;
612 return BAI;
613}
614
615void LowerTypeTestsModule::allocateByteArrays() {
616 llvm::stable_sort(ByteArrayInfos,
617 [](const ByteArrayInfo &BAI1, const ByteArrayInfo &BAI2) {
618 return BAI1.BitSize > BAI2.BitSize;
619 });
620
621 std::vector<uint64_t> ByteArrayOffsets(ByteArrayInfos.size());
622
624 for (unsigned I = 0; I != ByteArrayInfos.size(); ++I) {
625 ByteArrayInfo *BAI = &ByteArrayInfos[I];
626
627 uint8_t Mask;
628 BAB.allocate(BAI->Bits, BAI->BitSize, ByteArrayOffsets[I], Mask);
629
630 BAI->MaskGlobal->replaceAllUsesWith(
631 ConstantExpr::getIntToPtr(ConstantInt::get(Int8Ty, Mask), PtrTy));
632 BAI->MaskGlobal->eraseFromParent();
633 if (BAI->MaskPtr)
634 *BAI->MaskPtr = Mask;
635 }
636
637 Constant *ByteArrayConst = ConstantDataArray::get(M.getContext(), BAB.Bytes);
638 auto ByteArray =
639 new GlobalVariable(M, ByteArrayConst->getType(), /*isConstant=*/true,
640 GlobalValue::PrivateLinkage, ByteArrayConst);
641
642 for (unsigned I = 0; I != ByteArrayInfos.size(); ++I) {
643 ByteArrayInfo *BAI = &ByteArrayInfos[I];
645 ByteArray, ConstantInt::get(IntPtrTy, ByteArrayOffsets[I]));
646
647 // Create an alias instead of RAUW'ing the gep directly. On x86 this ensures
648 // that the pc-relative displacement is folded into the lea instead of the
649 // test instruction getting another displacement.
650 GlobalAlias *Alias = GlobalAlias::create(
651 Int8Ty, 0, GlobalValue::PrivateLinkage, "bits", GEP, &M);
652 BAI->ByteArray->replaceAllUsesWith(Alias);
653 BAI->ByteArray->eraseFromParent();
654 }
655
656 ByteArraySizeBits = BAB.BitAllocs[0] + BAB.BitAllocs[1] + BAB.BitAllocs[2] +
657 BAB.BitAllocs[3] + BAB.BitAllocs[4] + BAB.BitAllocs[5] +
658 BAB.BitAllocs[6] + BAB.BitAllocs[7];
659 ByteArraySizeBytes = BAB.Bytes.size();
660}
661
662/// Build a test that bit BitOffset is set in the type identifier that was
663/// lowered to TIL, which must be either an Inline or a ByteArray.
664Value *LowerTypeTestsModule::createBitSetTest(IRBuilder<> &B,
665 const TypeIdLowering &TIL,
666 Value *BitOffset) {
667 if (TIL.TheKind == TypeTestResolution::Inline) {
668 // If the bit set is sufficiently small, we can avoid a load by bit testing
669 // a constant.
670 return createMaskedBitTest(B, TIL.InlineBits, BitOffset);
671 } else {
672 Constant *ByteArray = TIL.TheByteArray;
673 if (AvoidReuse && !ImportSummary) {
674 // Each use of the byte array uses a different alias. This makes the
675 // backend less likely to reuse previously computed byte array addresses,
676 // improving the security of the CFI mechanism based on this pass.
677 // This won't work when importing because TheByteArray is external.
679 "bits_use", ByteArray, &M);
680 }
681
682 Value *ByteAddr = B.CreateGEP(Int8Ty, ByteArray, BitOffset);
683 Value *Byte = B.CreateLoad(Int8Ty, ByteAddr);
684
685 Value *ByteAndMask =
686 B.CreateAnd(Byte, ConstantExpr::getPtrToInt(TIL.BitMask, Int8Ty));
687 return B.CreateICmpNE(ByteAndMask, ConstantInt::get(Int8Ty, 0));
688 }
689}
690
691static bool isKnownTypeIdMember(Metadata *TypeId, const DataLayout &DL,
692 Value *V, uint64_t COffset) {
693 if (auto GV = dyn_cast<GlobalObject>(V)) {
695 GV->getMetadata(LLVMContext::MD_type, Types);
696 for (MDNode *Type : Types) {
697 if (Type->getOperand(1) != TypeId)
698 continue;
701 cast<ConstantAsMetadata>(Type->getOperand(0))->getValue())
702 ->getZExtValue();
703 if (COffset == Offset)
704 return true;
705 }
706 return false;
707 }
708
709 if (auto GEP = dyn_cast<GEPOperator>(V)) {
710 APInt APOffset(DL.getIndexSizeInBits(0), 0);
711 bool Result = GEP->accumulateConstantOffset(DL, APOffset);
712 if (!Result)
713 return false;
714 COffset += APOffset.getZExtValue();
715 return isKnownTypeIdMember(TypeId, DL, GEP->getPointerOperand(), COffset);
716 }
717
718 if (auto Op = dyn_cast<Operator>(V)) {
719 if (Op->getOpcode() == Instruction::BitCast)
720 return isKnownTypeIdMember(TypeId, DL, Op->getOperand(0), COffset);
721
722 if (Op->getOpcode() == Instruction::Select)
723 return isKnownTypeIdMember(TypeId, DL, Op->getOperand(1), COffset) &&
724 isKnownTypeIdMember(TypeId, DL, Op->getOperand(2), COffset);
725 }
726
727 return false;
728}
729
730/// Lower a llvm.type.test call to its implementation. Returns the value to
731/// replace the call with.
732Value *LowerTypeTestsModule::lowerTypeTestCall(Metadata *TypeId, CallInst *CI,
733 const TypeIdLowering &TIL) {
734 // Delay lowering if the resolution is currently unknown.
735 if (TIL.TheKind == TypeTestResolution::Unknown)
736 return nullptr;
737 if (TIL.TheKind == TypeTestResolution::Unsat)
738 return ConstantInt::getFalse(M.getContext());
739
740 Value *Ptr = CI->getArgOperand(0);
741 const DataLayout &DL = M.getDataLayout();
742 if (isKnownTypeIdMember(TypeId, DL, Ptr, 0))
743 return ConstantInt::getTrue(M.getContext());
744
745 BasicBlock *InitialBB = CI->getParent();
746
747 IRBuilder<> B(CI);
748
749 Value *PtrAsInt = B.CreatePtrToInt(Ptr, IntPtrTy);
750
751 Constant *OffsetedGlobalAsInt =
752 ConstantExpr::getPtrToInt(TIL.OffsetedGlobal, IntPtrTy);
753 if (TIL.TheKind == TypeTestResolution::Single)
754 return B.CreateICmpEQ(PtrAsInt, OffsetedGlobalAsInt);
755
756 // Here we compute `last element - address`. The reason why we do this instead
757 // of computing `address - first element` is that it leads to a slightly
758 // shorter instruction sequence on x86. Because it doesn't matter how we do
759 // the subtraction on other architectures, we do so unconditionally.
760 Value *PtrOffset = B.CreateSub(OffsetedGlobalAsInt, PtrAsInt);
761
762 // We need to check that the offset both falls within our range and is
763 // suitably aligned. We can check both properties at the same time by
764 // performing a right rotate by log2(alignment) followed by an integer
765 // comparison against the bitset size. The rotate will move the lower
766 // order bits that need to be zero into the higher order bits of the
767 // result, causing the comparison to fail if they are nonzero. The rotate
768 // also conveniently gives us a bit offset to use during the load from
769 // the bitset.
770 Value *BitOffset = B.CreateIntrinsic(IntPtrTy, Intrinsic::fshr,
771 {PtrOffset, PtrOffset, TIL.AlignLog2});
772
773 Value *OffsetInRange = B.CreateICmpULE(BitOffset, TIL.SizeM1);
774
775 // If the bit set is all ones, testing against it is unnecessary.
776 if (TIL.TheKind == TypeTestResolution::AllOnes)
777 return OffsetInRange;
778
779 // See if the intrinsic is used in the following common pattern:
780 // br(llvm.type.test(...), thenbb, elsebb)
781 // where nothing happens between the type test and the br.
782 // If so, create slightly simpler IR.
783 if (CI->hasOneUse())
784 if (auto *Br = dyn_cast<CondBrInst>(*CI->user_begin()))
785 if (CI->getNextNode() == Br) {
786 BasicBlock *Then = InitialBB->splitBasicBlock(CI->getIterator());
787 BasicBlock *Else = Br->getSuccessor(1);
788 CondBrInst *NewBr = CondBrInst::Create(OffsetInRange, Then, Else);
789 NewBr->setMetadata(LLVMContext::MD_prof,
790 Br->getMetadata(LLVMContext::MD_prof));
791 ReplaceInstWithInst(InitialBB->getTerminator(), NewBr);
792
793 // Update phis in Else resulting from InitialBB being split
794 for (auto &Phi : Else->phis())
795 Phi.addIncoming(Phi.getIncomingValueForBlock(Then), InitialBB);
796
797 IRBuilder<> ThenB(CI);
798 return createBitSetTest(ThenB, TIL, BitOffset);
799 }
800
801 MDBuilder MDB(M.getContext());
802 IRBuilder<> ThenB(SplitBlockAndInsertIfThen(OffsetInRange, CI, false,
803 MDB.createLikelyBranchWeights()));
804
805 // Now that we know that the offset is in range and aligned, load the
806 // appropriate bit from the bitset.
807 Value *Bit = createBitSetTest(ThenB, TIL, BitOffset);
808
809 // The value we want is 0 if we came directly from the initial block
810 // (having failed the range or alignment checks), or the loaded bit if
811 // we came from the block in which we loaded it.
812 B.SetInsertPoint(CI);
813 PHINode *P = B.CreatePHI(Int1Ty, 2);
814 P->addIncoming(ConstantInt::get(Int1Ty, 0), InitialBB);
815 P->addIncoming(Bit, ThenB.GetInsertBlock());
816 return P;
817}
818
819/// Given a disjoint set of type identifiers and globals, lay out the globals,
820/// build the bit sets and lower the llvm.type.test calls.
821void LowerTypeTestsModule::buildBitSetsFromGlobalVariables(
823 // Build a new global with the combined contents of the referenced globals.
824 // This global is a struct whose even-indexed elements contain the original
825 // contents of the referenced globals and whose odd-indexed elements contain
826 // any padding required to align the next element to the next power of 2 plus
827 // any additional padding required to meet its alignment requirements.
828 std::vector<Constant *> GlobalInits;
829 const DataLayout &DL = M.getDataLayout();
830 DenseMap<GlobalTypeMember *, uint64_t> GlobalLayout;
831 Align MaxAlign;
832 uint64_t CurOffset = 0;
833 uint64_t DesiredPadding = 0;
834 for (GlobalTypeMember *G : Globals) {
835 auto *GV = cast<GlobalVariable>(G->getGlobal());
836 Align Alignment =
837 DL.getValueOrABITypeAlignment(GV->getAlign(), GV->getValueType());
838 MaxAlign = std::max(MaxAlign, Alignment);
839 uint64_t GVOffset = alignTo(CurOffset + DesiredPadding, Alignment);
840 GlobalLayout[G] = GVOffset;
841 if (GVOffset != 0) {
842 uint64_t Padding = GVOffset - CurOffset;
843 GlobalInits.push_back(
845 }
846
847 GlobalInits.push_back(GV->getInitializer());
848 uint64_t InitSize = GV->getGlobalSize(DL);
849 CurOffset = GVOffset + InitSize;
850
851 // Compute the amount of padding that we'd like for the next element.
852 DesiredPadding = NextPowerOf2(InitSize - 1) - InitSize;
853
854 // Experiments of different caps with Chromium on both x64 and ARM64
855 // have shown that the 32-byte cap generates the smallest binary on
856 // both platforms while different caps yield similar performance.
857 // (see https://lists.llvm.org/pipermail/llvm-dev/2018-July/124694.html)
858 if (DesiredPadding > 32)
859 DesiredPadding = alignTo(InitSize, 32) - InitSize;
860 }
861
862 Constant *NewInit = ConstantStruct::getAnon(M.getContext(), GlobalInits);
863 auto *CombinedGlobal =
864 new GlobalVariable(M, NewInit->getType(), /*isConstant=*/true,
866 CombinedGlobal->setAlignment(MaxAlign);
867
868 StructType *NewTy = cast<StructType>(NewInit->getType());
869 lowerTypeTestCalls(TypeIds, CombinedGlobal, GlobalLayout);
870
871 // Build aliases pointing to offsets into the combined global for each
872 // global from which we built the combined global, and replace references
873 // to the original globals with references to the aliases.
874 for (unsigned I = 0; I != Globals.size(); ++I) {
875 GlobalVariable *GV = cast<GlobalVariable>(Globals[I]->getGlobal());
876
877 // Multiply by 2 to account for padding elements.
878 Constant *CombinedGlobalIdxs[] = {ConstantInt::get(Int32Ty, 0),
879 ConstantInt::get(Int32Ty, I * 2)};
880 Constant *CombinedGlobalElemPtr = ConstantExpr::getInBoundsGetElementPtr(
881 NewInit->getType(), CombinedGlobal, CombinedGlobalIdxs);
882 assert(GV->getType()->getAddressSpace() == 0);
883 GlobalAlias *GAlias =
884 GlobalAlias::create(NewTy->getElementType(I * 2), 0, GV->getLinkage(),
885 "", CombinedGlobalElemPtr, &M);
886 GAlias->setVisibility(GV->getVisibility());
887 GAlias->takeName(GV);
888 GV->replaceAllUsesWith(GAlias);
889 GV->eraseFromParent();
890 }
891}
892
893bool LowerTypeTestsModule::shouldExportConstantsAsAbsoluteSymbols() {
894 return (Arch == Triple::x86 || Arch == Triple::x86_64) &&
895 ObjectFormat == Triple::ELF;
896}
897
898/// Export the given type identifier so that ThinLTO backends may import it.
899/// Type identifiers are exported by adding coarse-grained information about how
900/// to test the type identifier to the summary, and creating symbols in the
901/// object file (aliases and absolute symbols) containing fine-grained
902/// information about the type identifier.
903///
904/// Returns a pointer to the location in which to store the bitmask, if
905/// applicable.
906uint8_t *LowerTypeTestsModule::exportTypeId(StringRef TypeId,
907 const TypeIdLowering &TIL) {
908 TypeTestResolution &TTRes =
909 ExportSummary->getOrInsertTypeIdSummary(TypeId).TTRes;
910 TTRes.TheKind = TIL.TheKind;
911
912 auto ExportGlobal = [&](StringRef Name, Constant *C) {
913 GlobalAlias *GA =
915 "__typeid_" + TypeId + "_" + Name, C, &M);
917 };
918
919 auto ExportConstant = [&](StringRef Name, uint64_t &Storage, Constant *C) {
920 if (shouldExportConstantsAsAbsoluteSymbols())
921 ExportGlobal(Name, ConstantExpr::getIntToPtr(C, PtrTy));
922 else
923 Storage = cast<ConstantInt>(C)->getZExtValue();
924 };
925
926 if (TIL.TheKind != TypeTestResolution::Unsat)
927 ExportGlobal("global_addr", TIL.OffsetedGlobal);
928
929 if (TIL.TheKind == TypeTestResolution::ByteArray ||
930 TIL.TheKind == TypeTestResolution::Inline ||
931 TIL.TheKind == TypeTestResolution::AllOnes) {
932 ExportConstant("align", TTRes.AlignLog2, TIL.AlignLog2);
933 ExportConstant("size_m1", TTRes.SizeM1, TIL.SizeM1);
934
935 uint64_t BitSize = cast<ConstantInt>(TIL.SizeM1)->getZExtValue() + 1;
936 if (TIL.TheKind == TypeTestResolution::Inline)
937 TTRes.SizeM1BitWidth = (BitSize <= 32) ? 5 : 6;
938 else
939 TTRes.SizeM1BitWidth = (BitSize <= 128) ? 7 : 32;
940 }
941
942 if (TIL.TheKind == TypeTestResolution::ByteArray) {
943 ExportGlobal("byte_array", TIL.TheByteArray);
944 if (shouldExportConstantsAsAbsoluteSymbols())
945 ExportGlobal("bit_mask", TIL.BitMask);
946 else
947 return &TTRes.BitMask;
948 }
949
950 if (TIL.TheKind == TypeTestResolution::Inline)
951 ExportConstant("inline_bits", TTRes.InlineBits, TIL.InlineBits);
952
953 return nullptr;
954}
955
956LowerTypeTestsModule::TypeIdLowering
957LowerTypeTestsModule::importTypeId(StringRef TypeId) {
958 const TypeIdSummary *TidSummary = ImportSummary->getTypeIdSummary(TypeId);
959 if (!TidSummary)
960 return {}; // Unsat: no globals match this type id.
961 const TypeTestResolution &TTRes = TidSummary->TTRes;
962
963 TypeIdLowering TIL;
964 TIL.TheKind = TTRes.TheKind;
965
966 auto ImportGlobal = [&](StringRef Name) {
967 // Give the global a type of length 0 so that it is not assumed not to alias
968 // with any other global.
969 GlobalVariable *GV = M.getOrInsertGlobal(
970 ("__typeid_" + TypeId + "_" + Name).str(), Int8Arr0Ty);
972 return GV;
973 };
974
975 auto ImportConstant = [&](StringRef Name, uint64_t Const, unsigned AbsWidth,
976 Type *Ty) {
977 if (!shouldExportConstantsAsAbsoluteSymbols()) {
978 Constant *C =
979 ConstantInt::get(isa<IntegerType>(Ty) ? Ty : Int64Ty, Const);
980 if (!isa<IntegerType>(Ty))
982 return C;
983 }
984
985 Constant *C = ImportGlobal(Name);
986 auto *GV = cast<GlobalVariable>(C->stripPointerCasts());
987 if (isa<IntegerType>(Ty))
989 if (GV->getMetadata(LLVMContext::MD_absolute_symbol))
990 return C;
991
992 auto SetAbsRange = [&](uint64_t Min, uint64_t Max) {
993 auto *MinC = ConstantAsMetadata::get(ConstantInt::get(IntPtrTy, Min));
994 auto *MaxC = ConstantAsMetadata::get(ConstantInt::get(IntPtrTy, Max));
995 GV->setMetadata(LLVMContext::MD_absolute_symbol,
996 MDNode::get(M.getContext(), {MinC, MaxC}));
997 };
998 if (AbsWidth == IntPtrTy->getBitWidth()) {
999 uint64_t AllOnes = IntPtrTy->getBitMask();
1000 SetAbsRange(AllOnes, AllOnes); // Full set.
1001 } else {
1002 SetAbsRange(0, 1ull << AbsWidth);
1003 }
1004 return C;
1005 };
1006
1007 if (TIL.TheKind != TypeTestResolution::Unsat) {
1008 auto *GV = ImportGlobal("global_addr");
1009 // This is either a vtable (in .data.rel.ro) or a jump table (in .text).
1010 // Either way it's expected to be in the low 2 GiB, so set the small code
1011 // model.
1012 //
1013 // For .data.rel.ro, we currently place all such sections in the low 2 GiB
1014 // [1], and for .text the sections are expected to be in the low 2 GiB under
1015 // the small and medium code models [2] and this pass only supports those
1016 // code models (e.g. jump tables use jmp instead of movabs/jmp).
1017 //
1018 // [1]https://github.com/llvm/llvm-project/pull/137742
1019 // [2]https://maskray.me/blog/2023-05-14-relocation-overflow-and-code-models
1021 TIL.OffsetedGlobal = GV;
1022 }
1023
1024 if (TIL.TheKind == TypeTestResolution::ByteArray ||
1025 TIL.TheKind == TypeTestResolution::Inline ||
1026 TIL.TheKind == TypeTestResolution::AllOnes) {
1027 TIL.AlignLog2 = ImportConstant("align", TTRes.AlignLog2, 8, IntPtrTy);
1028 TIL.SizeM1 =
1029 ImportConstant("size_m1", TTRes.SizeM1, TTRes.SizeM1BitWidth, IntPtrTy);
1030 }
1031
1032 if (TIL.TheKind == TypeTestResolution::ByteArray) {
1033 TIL.TheByteArray = ImportGlobal("byte_array");
1034 TIL.BitMask = ImportConstant("bit_mask", TTRes.BitMask, 8, PtrTy);
1035 }
1036
1037 if (TIL.TheKind == TypeTestResolution::Inline)
1038 TIL.InlineBits = ImportConstant(
1039 "inline_bits", TTRes.InlineBits, 1 << TTRes.SizeM1BitWidth,
1040 TTRes.SizeM1BitWidth <= 5 ? Int32Ty : Int64Ty);
1041
1042 return TIL;
1043}
1044
1045void LowerTypeTestsModule::importTypeTest(CallInst *CI) {
1046 auto TypeIdMDVal = dyn_cast<MetadataAsValue>(CI->getArgOperand(1));
1047 if (!TypeIdMDVal)
1048 report_fatal_error("Second argument of llvm.type.test must be metadata");
1049
1050 auto TypeIdStr = dyn_cast<MDString>(TypeIdMDVal->getMetadata());
1051 // If this is a local unpromoted type, which doesn't have a metadata string,
1052 // treat as Unknown and delay lowering, so that we can still utilize it for
1053 // later optimizations.
1054 if (!TypeIdStr)
1055 return;
1056
1057 TypeIdLowering TIL = importTypeId(TypeIdStr->getString());
1058 Value *Lowered = lowerTypeTestCall(TypeIdStr, CI, TIL);
1059 if (Lowered) {
1060 CI->replaceAllUsesWith(Lowered);
1061 CI->eraseFromParent();
1062 }
1063}
1064
1065void LowerTypeTestsModule::maybeReplaceComdat(Function *F,
1066 StringRef OriginalName) {
1067 // For COFF we should also rename the comdat if this function also
1068 // happens to be the key function. Even if the comdat name changes, this
1069 // should still be fine since comdat and symbol resolution happens
1070 // before LTO, so all symbols which would prevail have been selected.
1071 if (F->hasComdat() && ObjectFormat == Triple::COFF &&
1072 F->getComdat()->getName() == OriginalName) {
1073 Comdat *OldComdat = F->getComdat();
1074 Comdat *NewComdat = M.getOrInsertComdat(F->getName());
1075 for (GlobalObject &GO : M.global_objects()) {
1076 if (GO.getComdat() == OldComdat)
1077 GO.setComdat(NewComdat);
1078 }
1079 }
1080}
1081
1082// ThinLTO backend: the function F has a jump table entry; update this module
1083// accordingly. isJumpTableCanonical describes the type of the jump table entry.
1084void LowerTypeTestsModule::importFunction(Function *F,
1085 bool isJumpTableCanonical) {
1086 assert(F->getType()->getAddressSpace() == 0);
1087
1088 GlobalValue::VisibilityTypes Visibility = F->getVisibility();
1089 std::string Name = std::string(F->getName());
1090
1091 if (F->isDeclarationForLinker() && isJumpTableCanonical) {
1092 // Non-dso_local functions may be overriden at run time,
1093 // don't short curcuit them
1094 if (F->isDSOLocal()) {
1095 Function *RealF = Function::Create(F->getFunctionType(),
1097 F->getAddressSpace(),
1098 Name + ".cfi", &M);
1100 replaceDirectCalls(F, RealF);
1101 }
1102 return;
1103 }
1104
1105 Function *FDecl;
1106 if (!isJumpTableCanonical) {
1107 // Either a declaration of an external function or a reference to a locally
1108 // defined jump table.
1109 FDecl = Function::Create(F->getFunctionType(), GlobalValue::ExternalLinkage,
1110 F->getAddressSpace(), Name + ".cfi_jt", &M);
1112 } else {
1113 F->setName(Name + ".cfi");
1114 maybeReplaceComdat(F, Name);
1115 FDecl = Function::Create(F->getFunctionType(), GlobalValue::ExternalLinkage,
1116 F->getAddressSpace(), Name, &M);
1117 FDecl->setVisibility(Visibility);
1118 Visibility = GlobalValue::HiddenVisibility;
1119
1120 // Update aliases pointing to this function to also include the ".cfi" suffix,
1121 // We expect the jump table entry to either point to the real function or an
1122 // alias. Redirect all other users to the jump table entry.
1123 for (auto &U : F->uses()) {
1124 if (auto *A = dyn_cast<GlobalAlias>(U.getUser())) {
1125 std::string AliasName = A->getName().str() + ".cfi";
1126 Function *AliasDecl = Function::Create(
1127 F->getFunctionType(), GlobalValue::ExternalLinkage,
1128 F->getAddressSpace(), "", &M);
1129 AliasDecl->takeName(A);
1130 A->replaceAllUsesWith(AliasDecl);
1131 A->setName(AliasName);
1132 }
1133 }
1134 }
1135
1136 if (F->hasExternalWeakLinkage())
1137 replaceWeakDeclarationWithJumpTablePtr(F, FDecl, isJumpTableCanonical);
1138 else
1139 replaceCfiUses(F, FDecl, isJumpTableCanonical);
1140
1141 // Set visibility late because it's used in replaceCfiUses() to determine
1142 // whether uses need to be replaced.
1143 F->setVisibility(Visibility);
1144}
1145
1146static auto
1148 const DenseMap<GlobalTypeMember *, uint64_t> &GlobalLayout) {
1150 // Pre-populate the map with interesting type identifiers.
1151 for (Metadata *TypeId : TypeIds)
1152 OffsetsByTypeID[TypeId];
1153 for (const auto &[Mem, MemOff] : GlobalLayout) {
1154 for (MDNode *Type : Mem->types()) {
1155 auto It = OffsetsByTypeID.find(Type->getOperand(1));
1156 if (It == OffsetsByTypeID.end())
1157 continue;
1160 cast<ConstantAsMetadata>(Type->getOperand(0))->getValue())
1161 ->getZExtValue();
1162 It->second.push_back(MemOff + Offset);
1163 }
1164 }
1165
1167 BitSets.reserve(TypeIds.size());
1168 for (Metadata *TypeId : TypeIds) {
1169 BitSets.emplace_back(TypeId, buildBitSet(OffsetsByTypeID[TypeId]));
1170 LLVM_DEBUG({
1171 if (auto MDS = dyn_cast<MDString>(TypeId))
1172 dbgs() << MDS->getString() << ": ";
1173 else
1174 dbgs() << "<unnamed>: ";
1175 BitSets.back().second.print(dbgs());
1176 });
1177 }
1178
1179 return BitSets;
1180}
1181
1182void LowerTypeTestsModule::lowerTypeTestCalls(
1183 ArrayRef<Metadata *> TypeIds, Constant *CombinedGlobalAddr,
1184 const DenseMap<GlobalTypeMember *, uint64_t> &GlobalLayout) {
1185 // For each type identifier in this disjoint set...
1186 for (const auto &[TypeId, BSI] : buildBitSets(TypeIds, GlobalLayout)) {
1187 ByteArrayInfo *BAI = nullptr;
1188 TypeIdLowering TIL;
1189
1190 uint64_t GlobalOffset =
1191 BSI.ByteOffset + ((BSI.BitSize - 1) << BSI.AlignLog2);
1192 TIL.OffsetedGlobal = ConstantExpr::getPtrAdd(
1193 CombinedGlobalAddr, ConstantInt::get(IntPtrTy, GlobalOffset)),
1194 TIL.AlignLog2 = ConstantInt::get(IntPtrTy, BSI.AlignLog2);
1195 TIL.SizeM1 = ConstantInt::get(IntPtrTy, BSI.BitSize - 1);
1196 if (BSI.isAllOnes()) {
1197 TIL.TheKind = (BSI.BitSize == 1) ? TypeTestResolution::Single
1198 : TypeTestResolution::AllOnes;
1199 } else if (BSI.BitSize <= IntPtrTy->getBitWidth()) {
1200 TIL.TheKind = TypeTestResolution::Inline;
1201 uint64_t InlineBits = 0;
1202 for (auto Bit : BSI.Bits)
1203 InlineBits |= uint64_t(1) << Bit;
1204 if (InlineBits == 0)
1205 TIL.TheKind = TypeTestResolution::Unsat;
1206 else
1207 TIL.InlineBits = ConstantInt::get(
1208 (BSI.BitSize <= 32) ? Int32Ty : Int64Ty, InlineBits);
1209 } else {
1210 TIL.TheKind = TypeTestResolution::ByteArray;
1211 ++NumByteArraysCreated;
1212 BAI = createByteArray(BSI);
1213 TIL.TheByteArray = BAI->ByteArray;
1214 TIL.BitMask = BAI->MaskGlobal;
1215 }
1216
1217 TypeIdUserInfo &TIUI = TypeIdUsers[TypeId];
1218
1219 if (TIUI.IsExported) {
1220 uint8_t *MaskPtr = exportTypeId(cast<MDString>(TypeId)->getString(), TIL);
1221 if (BAI)
1222 BAI->MaskPtr = MaskPtr;
1223 }
1224
1225 // Lower each call to llvm.type.test for this type identifier.
1226 for (CallInst *CI : TIUI.CallSites) {
1227 ++NumTypeTestCallsLowered;
1228 Value *Lowered = lowerTypeTestCall(TypeId, CI, TIL);
1229 if (Lowered) {
1230 CI->replaceAllUsesWith(Lowered);
1231 CI->eraseFromParent();
1232 }
1233 }
1234 }
1235}
1236
1237void LowerTypeTestsModule::verifyTypeMDNode(GlobalObject *GO, MDNode *Type) {
1238 if (Type->getNumOperands() != 2)
1239 report_fatal_error("All operands of type metadata must have 2 elements");
1240
1241 if (GO->isThreadLocal())
1242 report_fatal_error("Bit set element may not be thread-local");
1243 if (isa<GlobalVariable>(GO) && GO->hasSection())
1245 "A member of a type identifier may not have an explicit section");
1246
1247 // FIXME: We previously checked that global var member of a type identifier
1248 // must be a definition, but the IR linker may leave type metadata on
1249 // declarations. We should restore this check after fixing PR31759.
1250
1251 auto OffsetConstMD = dyn_cast<ConstantAsMetadata>(Type->getOperand(0));
1252 if (!OffsetConstMD)
1253 report_fatal_error("Type offset must be a constant");
1254 auto OffsetInt = dyn_cast<ConstantInt>(OffsetConstMD->getValue());
1255 if (!OffsetInt)
1256 report_fatal_error("Type offset must be an integer constant");
1257}
1258
1259static const unsigned kX86JumpTableEntrySize = 8;
1260static const unsigned kX86IBTJumpTableEntrySize = 16;
1261static const unsigned kARMJumpTableEntrySize = 4;
1262static const unsigned kARMBTIJumpTableEntrySize = 8;
1263static const unsigned kARMv6MJumpTableEntrySize = 16;
1264static const unsigned kRISCVJumpTableEntrySize = 8;
1265static const unsigned kLOONGARCH64JumpTableEntrySize = 8;
1266static const unsigned kHexagonJumpTableEntrySize = 4;
1267
1268bool LowerTypeTestsModule::hasBranchTargetEnforcement() {
1269 if (HasBranchTargetEnforcement == -1) {
1270 // First time this query has been called. Find out the answer by checking
1271 // the module flags.
1272 if (const auto *BTE = mdconst::extract_or_null<ConstantInt>(
1273 M.getModuleFlag("branch-target-enforcement")))
1274 HasBranchTargetEnforcement = !BTE->isZero();
1275 else
1276 HasBranchTargetEnforcement = 0;
1277 }
1278 return HasBranchTargetEnforcement;
1279}
1280
1281unsigned
1282LowerTypeTestsModule::getJumpTableEntrySize(Triple::ArchType JumpTableArch) {
1283 switch (JumpTableArch) {
1284 case Triple::x86:
1285 case Triple::x86_64:
1286 if (const auto *MD = mdconst::extract_or_null<ConstantInt>(
1287 M.getModuleFlag("cf-protection-branch")))
1288 if (MD->getZExtValue())
1291 case Triple::arm:
1293 case Triple::thumb:
1294 if (CanUseThumbBWJumpTable) {
1295 if (hasBranchTargetEnforcement())
1298 } else {
1300 }
1301 case Triple::aarch64:
1302 if (hasBranchTargetEnforcement())
1305 case Triple::riscv32:
1306 case Triple::riscv64:
1310 case Triple::hexagon:
1312 default:
1313 report_fatal_error("Unsupported architecture for jump tables");
1314 }
1315}
1316
1317// Create an inline asm constant representing a jump table entry for the target.
1318// This consists of an instruction sequence containing a relative branch to
1319// Dest.
1320InlineAsm *
1321LowerTypeTestsModule::createJumpTableEntryAsm(Triple::ArchType JumpTableArch) {
1322 std::string Asm;
1323 raw_string_ostream AsmOS(Asm);
1324
1325 if (JumpTableArch == Triple::x86 || JumpTableArch == Triple::x86_64) {
1326 bool Endbr = false;
1327 if (const auto *MD = mdconst::extract_or_null<ConstantInt>(
1328 M.getModuleFlag("cf-protection-branch")))
1329 Endbr = !MD->isZero();
1330 if (Endbr)
1331 AsmOS << (JumpTableArch == Triple::x86 ? "endbr32\n" : "endbr64\n");
1332 AsmOS << "jmp ${0:c}@plt\n";
1333 if (Endbr)
1334 AsmOS << ".balign 16, 0xcc\n";
1335 else
1336 AsmOS << "int3\nint3\nint3\n";
1337 } else if (JumpTableArch == Triple::arm) {
1338 AsmOS << "b $0\n";
1339 } else if (JumpTableArch == Triple::aarch64) {
1340 if (hasBranchTargetEnforcement())
1341 AsmOS << "bti c\n";
1342 AsmOS << "b $0\n";
1343 } else if (JumpTableArch == Triple::thumb) {
1344 if (!CanUseThumbBWJumpTable) {
1345 // In Armv6-M, this sequence will generate a branch without corrupting
1346 // any registers. We use two stack words; in the second, we construct the
1347 // address we'll pop into pc, and the first is used to save and restore
1348 // r0 which we use as a temporary register.
1349 //
1350 // To support position-independent use cases, the offset of the target
1351 // function is stored as a relative offset (which will expand into an
1352 // R_ARM_REL32 relocation in ELF, and presumably the equivalent in other
1353 // object file types), and added to pc after we load it. (The alternative
1354 // B.W is automatically pc-relative.)
1355 //
1356 // There are five 16-bit Thumb instructions here, so the .balign 4 adds a
1357 // sixth halfword of padding, and then the offset consumes a further 4
1358 // bytes, for a total of 16, which is very convenient since entries in
1359 // this jump table need to have power-of-two size.
1360 AsmOS << "push {r0,r1}\n"
1361 << "ldr r0, 1f\n"
1362 << "0: add r0, r0, pc\n"
1363 << "str r0, [sp, #4]\n"
1364 << "pop {r0,pc}\n"
1365 << ".balign 4\n"
1366 << "1: .word $0 - (0b + 4)\n";
1367 } else {
1368 if (hasBranchTargetEnforcement())
1369 AsmOS << "bti\n";
1370 AsmOS << "b.w $0\n";
1371 }
1372 } else if (JumpTableArch == Triple::riscv32 ||
1373 JumpTableArch == Triple::riscv64) {
1374 AsmOS << "tail $0@plt\n";
1375 } else if (JumpTableArch == Triple::loongarch64) {
1376 AsmOS << "pcalau12i $$t0, %pc_hi20($0)\n"
1377 << "jirl $$r0, $$t0, %pc_lo12($0)\n";
1378 } else if (JumpTableArch == Triple::hexagon) {
1379 AsmOS << "jump $0\n";
1380 } else {
1381 report_fatal_error("Unsupported architecture for jump tables");
1382 }
1383
1384 return InlineAsm::get(
1385 FunctionType::get(Type::getVoidTy(M.getContext()), PtrTy, false),
1386 AsmOS.str(), "s",
1387 /*hasSideEffects=*/true);
1388}
1389
1390/// Given a disjoint set of type identifiers and functions, build the bit sets
1391/// and lower the llvm.type.test calls, architecture dependently.
1392void LowerTypeTestsModule::buildBitSetsFromFunctions(
1394 if (Arch == Triple::x86 || Arch == Triple::x86_64 || Arch == Triple::arm ||
1395 Arch == Triple::thumb || Arch == Triple::aarch64 ||
1396 Arch == Triple::riscv32 || Arch == Triple::riscv64 ||
1397 Arch == Triple::loongarch64 || Arch == Triple::hexagon)
1398 buildBitSetsFromFunctionsNative(TypeIds, Functions);
1399 else if (Arch == Triple::wasm32 || Arch == Triple::wasm64)
1400 buildBitSetsFromFunctionsWASM(TypeIds, Functions);
1401 else
1402 report_fatal_error("Unsupported architecture for jump tables");
1403}
1404
1405void LowerTypeTestsModule::moveInitializerToModuleConstructor(
1406 GlobalVariable *GV) {
1407 if (WeakInitializerFn == nullptr) {
1408 WeakInitializerFn = Function::Create(
1409 FunctionType::get(Type::getVoidTy(M.getContext()),
1410 /* IsVarArg */ false),
1412 M.getDataLayout().getProgramAddressSpace(),
1413 "__cfi_global_var_init", &M);
1414 BasicBlock *BB =
1415 BasicBlock::Create(M.getContext(), "entry", WeakInitializerFn);
1416 ReturnInst::Create(M.getContext(), BB);
1417 WeakInitializerFn->setSection(
1418 ObjectFormat == Triple::MachO
1419 ? "__TEXT,__StaticInit,regular,pure_instructions"
1420 : ".text.startup");
1421 // This code is equivalent to relocation application, and should run at the
1422 // earliest possible time (i.e. with the highest priority).
1423 appendToGlobalCtors(M, WeakInitializerFn, /* Priority */ 0);
1424 }
1425
1426 IRBuilder<> IRB(WeakInitializerFn->getEntryBlock().getTerminator());
1427 GV->setConstant(false);
1428 IRB.CreateAlignedStore(GV->getInitializer(), GV, GV->getAlign());
1430}
1431
1432void LowerTypeTestsModule::findGlobalVariableUsersOf(
1433 Constant *C, SmallSetVector<GlobalVariable *, 8> &Out) {
1434 for (auto *U : C->users()){
1435 if (auto *GV = dyn_cast<GlobalVariable>(U))
1436 Out.insert(GV);
1437 else if (auto *C2 = dyn_cast<Constant>(U))
1438 findGlobalVariableUsersOf(C2, Out);
1439 }
1440}
1441
1442// Replace all uses of F with (F ? JT : 0).
1443void LowerTypeTestsModule::replaceWeakDeclarationWithJumpTablePtr(
1444 Function *F, Constant *JT, bool IsJumpTableCanonical) {
1445 // The target expression can not appear in a constant initializer on most
1446 // (all?) targets. Switch to a runtime initializer.
1447 SmallSetVector<GlobalVariable *, 8> GlobalVarUsers;
1448 findGlobalVariableUsersOf(F, GlobalVarUsers);
1449 for (auto *GV : GlobalVarUsers) {
1450 if (GV == GlobalAnnotation)
1451 continue;
1452 moveInitializerToModuleConstructor(GV);
1453 }
1454
1455 // Can not RAUW F with an expression that uses F. Replace with a temporary
1456 // placeholder first.
1457 Function *PlaceholderFn =
1459 F->getAddressSpace(), "", &M);
1460 replaceCfiUses(F, PlaceholderFn, IsJumpTableCanonical);
1461
1463 // Don't use range based loop, because use list will be modified.
1464 while (!PlaceholderFn->use_empty()) {
1465 Use &U = *PlaceholderFn->use_begin();
1466 auto *InsertPt = dyn_cast<Instruction>(U.getUser());
1467 assert(InsertPt && "Non-instruction users should have been eliminated");
1468 auto *PN = dyn_cast<PHINode>(InsertPt);
1469 if (PN)
1470 InsertPt = PN->getIncomingBlock(U)->getTerminator();
1471 IRBuilder Builder(InsertPt);
1472 Value *ICmp = Builder.CreateICmp(CmpInst::ICMP_NE, F,
1473 Constant::getNullValue(F->getType()));
1474 Value *Select = Builder.CreateSelect(ICmp, JT,
1475 Constant::getNullValue(F->getType()));
1476
1477 if (auto *SI = dyn_cast<SelectInst>(Select))
1479 // For phi nodes, we need to update the incoming value for all operands
1480 // with the same predecessor.
1481 if (PN)
1482 PN->setIncomingValueForBlock(InsertPt->getParent(), Select);
1483 else
1484 U.set(Select);
1485 }
1486 PlaceholderFn->eraseFromParent();
1487}
1488
1489static bool isThumbFunction(Function *F, Triple::ArchType ModuleArch) {
1490 Attribute TFAttr = F->getFnAttribute("target-features");
1491 if (TFAttr.isValid()) {
1493 TFAttr.getValueAsString().split(Features, ',');
1494 for (StringRef Feature : Features) {
1495 if (Feature == "-thumb-mode")
1496 return false;
1497 else if (Feature == "+thumb-mode")
1498 return true;
1499 }
1500 }
1501
1502 return ModuleArch == Triple::thumb;
1503}
1504
1505// Each jump table must be either ARM or Thumb as a whole for the bit-test math
1506// to work. Pick one that matches the majority of members to minimize interop
1507// veneers inserted by the linker.
1508Triple::ArchType LowerTypeTestsModule::selectJumpTableArmEncoding(
1509 ArrayRef<GlobalTypeMember *> Functions) {
1510 if (Arch != Triple::arm && Arch != Triple::thumb)
1511 return Arch;
1512
1513 if (!CanUseThumbBWJumpTable && CanUseArmJumpTable) {
1514 // In architectures that provide Arm and Thumb-1 but not Thumb-2,
1515 // we should always prefer the Arm jump table format, because the
1516 // Thumb-1 one is larger and slower.
1517 return Triple::arm;
1518 }
1519
1520 // Otherwise, go with majority vote.
1521 unsigned ArmCount = 0, ThumbCount = 0;
1522 for (const auto GTM : Functions) {
1523 if (!GTM->isJumpTableCanonical()) {
1524 // PLT stubs are always ARM.
1525 // FIXME: This is the wrong heuristic for non-canonical jump tables.
1526 ++ArmCount;
1527 continue;
1528 }
1529
1530 Function *F = cast<Function>(GTM->getGlobal());
1531 ++(isThumbFunction(F, Arch) ? ThumbCount : ArmCount);
1532 }
1533
1534 return ArmCount > ThumbCount ? Triple::arm : Triple::thumb;
1535}
1536
1537// Create location for each function entry which should look like this:
1538// frame #0: c::c() (.cfi_jt) at sanitizer/ubsan_interface.h:0:0
1539// frame #1: __ubsan_check_cfi_icall_jt at sanitizer/ubsan_interface.h:0
1542 Module &M = *F->getParent();
1543 DICompileUnit *CU = nullptr;
1544 auto CUs = M.debug_compile_units();
1545 if (!CUs.empty())
1546 CU = *CUs.begin();
1547
1548 DIBuilder DIB(M, /*AllowUnresolved=*/true, CU);
1549 DIFile *File = DIB.createFile("ubsan_interface.h", "sanitizer");
1550 if (!CU) {
1551 // Synthetic module (like ld-temp.o), it frequently lacks a DICompileUnit
1552 // even if the rest of the program has debug info.
1553 CU = DIB.createCompileUnit(
1554 DISourceLanguageName(dwarf::DW_LANG_C), File, "llvm", true, "", 0, "",
1556 }
1557
1558 DISubroutineType *DIFnTy = DIB.createSubroutineType(nullptr);
1559
1560 DISubprogram *UbsanSP = DIB.createFunction(
1561 CU, "__ubsan_check_cfi_icall_jt", {}, File, 0, DIFnTy, 0,
1562 DINode::FlagArtificial, DISubprogram::SPFlagDefinition);
1563
1564 F->setSubprogram(UbsanSP);
1565
1566 DILocation *UbsanLoc = DILocation::get(M.getContext(), 0, 0, UbsanSP);
1567
1568 SmallVector<DILocation *> Locations;
1569 Locations.reserve(Functions.size());
1570
1571 for (auto *Func : Functions) {
1572 StringRef FuncName = Func->getGlobal()->getName();
1573 FuncName.consume_back(".cfi");
1574 DISubprogram *JumpSP = DIB.createFunction(
1575 CU, (FuncName + ".cfi_jt").str(), {}, File, 0, DIFnTy, 0,
1576 DINode::FlagArtificial, DISubprogram::SPFlagDefinition);
1577
1578 DILocation *EntryLoc =
1579 DILocation::get(M.getContext(), 0, 0, JumpSP, UbsanLoc);
1580
1581 Locations.push_back(EntryLoc);
1582 }
1583
1584 DIB.finalize();
1585
1586 return Locations;
1587}
1588
1589void LowerTypeTestsModule::createJumpTable(
1590 Function *F, ArrayRef<GlobalTypeMember *> Functions,
1591 Triple::ArchType JumpTableArch) {
1592 unsigned JumpTableEntrySize = getJumpTableEntrySize(JumpTableArch);
1593 // Give the jumptable section this type in order to enable jumptable
1594 // relaxation. Only do this if cross-DSO CFI is disabled because jumptable
1595 // relaxation violates cross-DSO CFI's restrictions on the ordering of the
1596 // jumptable relative to other sections.
1597 if (!CrossDsoCfi)
1598 F->setMetadata(LLVMContext::MD_elf_section_properties,
1599 MDNode::get(F->getContext(),
1601 ConstantAsMetadata::get(ConstantInt::get(
1602 Int64Ty, ELF::SHT_LLVM_CFI_JUMP_TABLE)),
1603 ConstantAsMetadata::get(ConstantInt::get(
1604 Int64Ty, JumpTableEntrySize))}));
1605
1606 BasicBlock *BB = BasicBlock::Create(M.getContext(), "entry", F);
1607 IRBuilder<> IRB(BB);
1608
1610 if (M.getDwarfVersion() != 0 && EnableJumpTableDebugInfo)
1611 Locations = createJumpTableDebugInfo(F, Functions);
1612
1613 InlineAsm *JumpTableAsm = createJumpTableEntryAsm(JumpTableArch);
1614
1615 // Check if all entries have the NoUnwind attribute.
1616 // If all entries have it, we can safely mark the
1617 // cfi.jumptable as NoUnwind, otherwise, direct calls
1618 // to the jump table will not handle exceptions properly
1619 bool areAllEntriesNounwind = true;
1620 assert(Locations.empty() || Functions.size() == Locations.size());
1621 for (auto [GTM, Loc] : zip_longest(Functions, Locations)) {
1622 if (Loc.has_value())
1623 IRB.SetCurrentDebugLocation(*Loc);
1624 if (!cast<Function>((*GTM)->getGlobal())
1625 ->hasFnAttribute(Attribute::NoUnwind)) {
1626 areAllEntriesNounwind = false;
1627 }
1628 IRB.CreateCall(JumpTableAsm, (*GTM)->getGlobal());
1629 }
1630 IRB.CreateUnreachable();
1631
1632 // Align the whole table by entry size.
1633 F->setPreferredAlignment(Align(JumpTableEntrySize));
1634 F->addFnAttr(Attribute::Naked);
1635 if (JumpTableArch == Triple::arm)
1636 F->addFnAttr("target-features", "-thumb-mode");
1637 if (JumpTableArch == Triple::thumb) {
1638 if (hasBranchTargetEnforcement()) {
1639 // If we're generating a Thumb jump table with BTI, add a target-features
1640 // setting to ensure BTI can be assembled.
1641 F->addFnAttr("target-features", "+thumb-mode,+pacbti");
1642 } else {
1643 F->addFnAttr("target-features", "+thumb-mode");
1644 if (CanUseThumbBWJumpTable) {
1645 // Thumb jump table assembly needs Thumb2. The following attribute is
1646 // added by Clang for -march=armv7.
1647 F->addFnAttr("target-cpu", "cortex-a8");
1648 }
1649 }
1650 }
1651 // When -mbranch-protection= is used, the inline asm adds a BTI. Suppress BTI
1652 // for the function to avoid double BTI. This is a no-op without
1653 // -mbranch-protection=.
1654 if (JumpTableArch == Triple::aarch64 || JumpTableArch == Triple::thumb) {
1655 if (F->hasFnAttribute("branch-target-enforcement"))
1656 F->removeFnAttr("branch-target-enforcement");
1657 if (F->hasFnAttribute("sign-return-address"))
1658 F->removeFnAttr("sign-return-address");
1659 }
1660 if (JumpTableArch == Triple::riscv32 || JumpTableArch == Triple::riscv64) {
1661 // Make sure the jump table assembly is not modified by the assembler or
1662 // the linker.
1663 F->addFnAttr("target-features", "-c,-relax");
1664 }
1665 // When -fcf-protection= is used, the inline asm adds an ENDBR. Suppress ENDBR
1666 // for the function to avoid double ENDBR. This is a no-op without
1667 // -fcf-protection=.
1668 if (JumpTableArch == Triple::x86 || JumpTableArch == Triple::x86_64)
1669 F->addFnAttr(Attribute::NoCfCheck);
1670
1671 // Make sure we don't emit .eh_frame for this function if it isn't needed.
1672 if (areAllEntriesNounwind)
1673 F->addFnAttr(Attribute::NoUnwind);
1674
1675 // Make sure we do not inline any calls to the cfi.jumptable.
1676 F->addFnAttr(Attribute::NoInline);
1677}
1678
1679/// Given a disjoint set of type identifiers and functions, build a jump table
1680/// for the functions, build the bit sets and lower the llvm.type.test calls.
1681void LowerTypeTestsModule::buildBitSetsFromFunctionsNative(
1683 // Unlike the global bitset builder, the function bitset builder cannot
1684 // re-arrange functions in a particular order and base its calculations on the
1685 // layout of the functions' entry points, as we have no idea how large a
1686 // particular function will end up being (the size could even depend on what
1687 // this pass does!) Instead, we build a jump table, which is a block of code
1688 // consisting of one branch instruction for each of the functions in the bit
1689 // set that branches to the target function, and redirect any taken function
1690 // addresses to the corresponding jump table entry. In the object file's
1691 // symbol table, the symbols for the target functions also refer to the jump
1692 // table entries, so that addresses taken outside the module will pass any
1693 // verification done inside the module.
1694 //
1695 // In more concrete terms, suppose we have three functions f, g, h which are
1696 // of the same type, and a function foo that returns their addresses:
1697 //
1698 // f:
1699 // mov 0, %eax
1700 // ret
1701 //
1702 // g:
1703 // mov 1, %eax
1704 // ret
1705 //
1706 // h:
1707 // mov 2, %eax
1708 // ret
1709 //
1710 // foo:
1711 // mov f, %eax
1712 // mov g, %edx
1713 // mov h, %ecx
1714 // ret
1715 //
1716 // We output the jump table as module-level inline asm string. The end result
1717 // will (conceptually) look like this:
1718 //
1719 // f = .cfi.jumptable
1720 // g = .cfi.jumptable + 4
1721 // h = .cfi.jumptable + 8
1722 // .cfi.jumptable:
1723 // jmp f.cfi ; 5 bytes
1724 // int3 ; 1 byte
1725 // int3 ; 1 byte
1726 // int3 ; 1 byte
1727 // jmp g.cfi ; 5 bytes
1728 // int3 ; 1 byte
1729 // int3 ; 1 byte
1730 // int3 ; 1 byte
1731 // jmp h.cfi ; 5 bytes
1732 // int3 ; 1 byte
1733 // int3 ; 1 byte
1734 // int3 ; 1 byte
1735 //
1736 // f.cfi:
1737 // mov 0, %eax
1738 // ret
1739 //
1740 // g.cfi:
1741 // mov 1, %eax
1742 // ret
1743 //
1744 // h.cfi:
1745 // mov 2, %eax
1746 // ret
1747 //
1748 // foo:
1749 // mov f, %eax
1750 // mov g, %edx
1751 // mov h, %ecx
1752 // ret
1753 //
1754 // Because the addresses of f, g, h are evenly spaced at a power of 2, in the
1755 // normal case the check can be carried out using the same kind of simple
1756 // arithmetic that we normally use for globals.
1757
1758 // FIXME: find a better way to represent the jumptable in the IR.
1759 assert(!Functions.empty());
1760
1761 // Decide on the jump table encoding, so that we know how big the
1762 // entries will be.
1763 Triple::ArchType JumpTableArch = selectJumpTableArmEncoding(Functions);
1764
1765 // Build a simple layout based on the regular layout of jump tables.
1766 DenseMap<GlobalTypeMember *, uint64_t> GlobalLayout;
1767 unsigned EntrySize = getJumpTableEntrySize(JumpTableArch);
1768 for (unsigned I = 0; I != Functions.size(); ++I)
1769 GlobalLayout[Functions[I]] = I * EntrySize;
1770
1771 Function *JumpTableFn =
1773 /* IsVarArg */ false),
1775 M.getDataLayout().getProgramAddressSpace(),
1776 ".cfi.jumptable", &M);
1777 ArrayType *JumpTableEntryType = ArrayType::get(Int8Ty, EntrySize);
1779 ArrayType::get(JumpTableEntryType, Functions.size());
1781 JumpTableFn, PointerType::getUnqual(M.getContext()));
1782
1783 lowerTypeTestCalls(TypeIds, JumpTable, GlobalLayout);
1784
1785 // Build aliases pointing to offsets into the jump table, and replace
1786 // references to the original functions with references to the aliases.
1787 for (unsigned I = 0; I != Functions.size(); ++I) {
1788 Function *F = cast<Function>(Functions[I]->getGlobal());
1789 bool IsJumpTableCanonical = Functions[I]->isJumpTableCanonical();
1790
1791 Constant *CombinedGlobalElemPtr = ConstantExpr::getInBoundsGetElementPtr(
1792 JumpTableType, JumpTable,
1793 ArrayRef<Constant *>{ConstantInt::get(IntPtrTy, 0),
1794 ConstantInt::get(IntPtrTy, I)});
1795
1796 const bool IsExported = Functions[I]->isExported();
1797 if (!IsJumpTableCanonical) {
1800 GlobalAlias *JtAlias = GlobalAlias::create(JumpTableEntryType, 0, LT,
1801 F->getName() + ".cfi_jt",
1802 CombinedGlobalElemPtr, &M);
1803 if (IsExported)
1805 else
1806 appendToUsed(M, {JtAlias});
1807 }
1808
1809 if (IsExported) {
1810 GlobalValue::GUID GUID = F->getGUID();
1811 if (IsJumpTableCanonical)
1812 ExportSummary->cfiFunctionDefs().addSymbolWithThinLTOGUID(F->getName(),
1813 GUID);
1814 else
1815 ExportSummary->cfiFunctionDecls().addSymbolWithThinLTOGUID(F->getName(),
1816 GUID);
1817 }
1818
1819 if (!IsJumpTableCanonical) {
1820 if (F->hasExternalWeakLinkage())
1821 replaceWeakDeclarationWithJumpTablePtr(F, CombinedGlobalElemPtr,
1822 IsJumpTableCanonical);
1823 else
1824 replaceCfiUses(F, CombinedGlobalElemPtr, IsJumpTableCanonical);
1825 } else {
1826 assert(F->getType()->getAddressSpace() == 0);
1827
1828 GlobalAlias *FAlias =
1829 GlobalAlias::create(JumpTableEntryType, 0, F->getLinkage(), "",
1830 CombinedGlobalElemPtr, &M);
1831 FAlias->setVisibility(F->getVisibility());
1832 FAlias->takeName(F);
1833 if (FAlias->hasName()) {
1834 F->setName(FAlias->getName() + ".cfi");
1835 maybeReplaceComdat(F, FAlias->getName());
1836 }
1837 replaceCfiUses(F, FAlias, IsJumpTableCanonical);
1838 if (!F->hasLocalLinkage())
1839 F->setVisibility(GlobalVariable::HiddenVisibility);
1840 }
1841 }
1842
1843 createJumpTable(JumpTableFn, Functions, JumpTableArch);
1844}
1845
1846/// Assign a dummy layout using an incrementing counter, tag each function
1847/// with its index represented as metadata, and lower each type test to an
1848/// integer range comparison. During generation of the indirect function call
1849/// table in the backend, it will assign the given indexes.
1850/// Note: Dynamic linking is not supported, as the WebAssembly ABI has not yet
1851/// been finalized.
1852void LowerTypeTestsModule::buildBitSetsFromFunctionsWASM(
1854 assert(!Functions.empty());
1855
1856 // Build consecutive monotonic integer ranges for each call target set
1857 DenseMap<GlobalTypeMember *, uint64_t> GlobalLayout;
1858
1859 for (GlobalTypeMember *GTM : Functions) {
1860 Function *F = cast<Function>(GTM->getGlobal());
1861
1862 // Skip functions that are not address taken, to avoid bloating the table
1863 if (!F->hasAddressTaken())
1864 continue;
1865
1866 // Store metadata with the index for each function
1867 MDNode *MD = MDNode::get(F->getContext(),
1869 ConstantInt::get(Int64Ty, IndirectIndex))));
1870 F->setMetadata("wasm.index", MD);
1871
1872 // Assign the counter value
1873 GlobalLayout[GTM] = IndirectIndex++;
1874 }
1875
1876 // The indirect function table index space starts at zero, so pass a NULL
1877 // pointer as the subtracted "jump table" offset.
1878 lowerTypeTestCalls(TypeIds, ConstantPointerNull::get(PtrTy),
1879 GlobalLayout);
1880}
1881
1882void LowerTypeTestsModule::buildBitSetsFromDisjointSet(
1884 ArrayRef<ICallBranchFunnel *> ICallBranchFunnels) {
1885 DenseMap<Metadata *, uint64_t> TypeIdIndices;
1886 for (unsigned I = 0; I != TypeIds.size(); ++I)
1887 TypeIdIndices[TypeIds[I]] = I;
1888
1889 // For each type identifier, build a set of indices that refer to members of
1890 // the type identifier.
1891 std::vector<std::set<uint64_t>> TypeMembers(TypeIds.size());
1892 unsigned GlobalIndex = 0;
1893 DenseMap<GlobalTypeMember *, uint64_t> GlobalIndices;
1894 for (GlobalTypeMember *GTM : Globals) {
1895 for (MDNode *Type : GTM->types()) {
1896 // Type = { offset, type identifier }
1897 auto I = TypeIdIndices.find(Type->getOperand(1));
1898 if (I != TypeIdIndices.end())
1899 TypeMembers[I->second].insert(GlobalIndex);
1900 }
1901 GlobalIndices[GTM] = GlobalIndex;
1902 GlobalIndex++;
1903 }
1904
1905 for (ICallBranchFunnel *JT : ICallBranchFunnels) {
1906 TypeMembers.emplace_back();
1907 std::set<uint64_t> &TMSet = TypeMembers.back();
1908 for (GlobalTypeMember *T : JT->targets())
1909 TMSet.insert(GlobalIndices[T]);
1910 }
1911
1912 // Order the sets of indices by size. The GlobalLayoutBuilder works best
1913 // when given small index sets first.
1914 llvm::stable_sort(TypeMembers, [](const std::set<uint64_t> &O1,
1915 const std::set<uint64_t> &O2) {
1916 return O1.size() < O2.size();
1917 });
1918
1919 // Create a GlobalLayoutBuilder and provide it with index sets as layout
1920 // fragments. The GlobalLayoutBuilder tries to lay out members of fragments as
1921 // close together as possible.
1922 GlobalLayoutBuilder GLB(Globals.size());
1923 for (auto &&MemSet : TypeMembers)
1924 GLB.addFragment(MemSet);
1925
1926 // Build a vector of globals with the computed layout.
1927 bool IsGlobalSet =
1928 Globals.empty() || isa<GlobalVariable>(Globals[0]->getGlobal());
1929 std::vector<GlobalTypeMember *> OrderedGTMs(Globals.size());
1930 auto OGTMI = OrderedGTMs.begin();
1931 for (auto &&F : GLB.Fragments) {
1932 for (auto &&Offset : F) {
1933 if (IsGlobalSet != isa<GlobalVariable>(Globals[Offset]->getGlobal()))
1934 report_fatal_error("Type identifier may not contain both global "
1935 "variables and functions");
1936 *OGTMI++ = Globals[Offset];
1937 }
1938 }
1939
1940 // Build the bitsets from this disjoint set.
1941 if (IsGlobalSet)
1942 buildBitSetsFromGlobalVariables(TypeIds, OrderedGTMs);
1943 else
1944 buildBitSetsFromFunctions(TypeIds, OrderedGTMs);
1945}
1946
1947/// Lower all type tests in this module.
1948LowerTypeTestsModule::LowerTypeTestsModule(
1949 Module &M, ModuleAnalysisManager &AM, ModuleSummaryIndex *ExportSummary,
1950 const ModuleSummaryIndex *ImportSummary)
1951 : M(M), ExportSummary(ExportSummary), ImportSummary(ImportSummary) {
1952 assert(!(ExportSummary && ImportSummary));
1953 Triple TargetTriple(M.getTargetTriple());
1954 Arch = TargetTriple.getArch();
1955 if (Arch == Triple::arm)
1956 CanUseArmJumpTable = true;
1957 if (Arch == Triple::arm || Arch == Triple::thumb) {
1958 auto &FAM =
1960 for (Function &F : M) {
1961 // Skip declarations since we should not query the TTI for them.
1962 if (F.isDeclaration())
1963 continue;
1964 auto &TTI = FAM.getResult<TargetIRAnalysis>(F);
1965 if (TTI.hasArmWideBranch(false))
1966 CanUseArmJumpTable = true;
1967 if (TTI.hasArmWideBranch(true))
1968 CanUseThumbBWJumpTable = true;
1969 }
1970 }
1971 OS = TargetTriple.getOS();
1972 ObjectFormat = TargetTriple.getObjectFormat();
1973
1974 // Function annotation describes or applies to function itself, and
1975 // shouldn't be associated with jump table thunk generated for CFI.
1976 GlobalAnnotation = M.getGlobalVariable("llvm.global.annotations");
1977 if (GlobalAnnotation && GlobalAnnotation->hasInitializer()) {
1978 const ConstantArray *CA =
1979 cast<ConstantArray>(GlobalAnnotation->getInitializer());
1980 FunctionAnnotations.insert_range(CA->operands());
1981 }
1982}
1983
1984bool LowerTypeTestsModule::runForTesting(Module &M, ModuleAnalysisManager &AM) {
1985 ModuleSummaryIndex Summary(/*HaveGVs=*/false);
1986
1987 // Handle the command-line summary arguments. This code is for testing
1988 // purposes only, so we handle errors directly.
1989 if (!ClReadSummary.empty()) {
1990 ExitOnError ExitOnErr("-lowertypetests-read-summary: " + ClReadSummary +
1991 ": ");
1992 auto ReadSummaryFile = ExitOnErr(errorOrToExpected(
1993 MemoryBuffer::getFile(ClReadSummary, /*IsText=*/true)));
1994
1995 yaml::Input In(ReadSummaryFile->getBuffer());
1996 In >> Summary;
1997 ExitOnErr(errorCodeToError(In.error()));
1998 }
1999
2000 bool Changed =
2001 LowerTypeTestsModule(
2002 M, AM,
2003 ClSummaryAction == PassSummaryAction::Export ? &Summary : nullptr,
2004 ClSummaryAction == PassSummaryAction::Import ? &Summary : nullptr)
2005 .lower();
2006
2007 if (!ClWriteSummary.empty()) {
2008 ExitOnError ExitOnErr("-lowertypetests-write-summary: " + ClWriteSummary +
2009 ": ");
2010 std::error_code EC;
2011 raw_fd_ostream OS(ClWriteSummary, EC, sys::fs::OF_TextWithCRLF);
2012 ExitOnErr(errorCodeToError(EC));
2013
2014 yaml::Output Out(OS);
2015 Out << Summary;
2016 }
2017
2018 return Changed;
2019}
2020
2021static bool isDirectCall(Use& U) {
2022 auto *Usr = dyn_cast<CallInst>(U.getUser());
2023 return Usr && Usr->isCallee(&U);
2024}
2025
2026void LowerTypeTestsModule::replaceCfiUses(Function *Old, Value *New,
2027 bool IsJumpTableCanonical) {
2028 SmallSetVector<Constant *, 4> Constants;
2029 for (Use &U : llvm::make_early_inc_range(Old->uses())) {
2030 // Skip no_cfi values, which refer to the function body instead of the jump
2031 // table.
2032 if (isa<NoCFIValue>(U.getUser()))
2033 continue;
2034
2035 // Skip direct calls to externally defined or non-dso_local functions.
2036 if (isDirectCall(U) && (Old->isDSOLocal() || !IsJumpTableCanonical))
2037 continue;
2038
2039 // Skip function annotation.
2040 if (isFunctionAnnotation(U.getUser()))
2041 continue;
2042
2043 // Must handle Constants specially, we cannot call replaceUsesOfWith on a
2044 // constant because they are uniqued.
2045 if (auto *C = dyn_cast<Constant>(U.getUser())) {
2046 if (!isa<GlobalValue>(C)) {
2047 // Save unique users to avoid processing operand replacement
2048 // more than once.
2049 Constants.insert(C);
2050 continue;
2051 }
2052 }
2053
2054 U.set(New);
2055 }
2056
2057 // Process operand replacement of saved constants.
2058 for (auto *C : Constants)
2059 C->handleOperandChange(Old, New);
2060}
2061
2062void LowerTypeTestsModule::replaceDirectCalls(Value *Old, Value *New) {
2064}
2065
2066static void dropTypeTests(Module &M, Function &TypeTestFunc,
2067 bool ShouldDropAll) {
2068 for (Use &U : llvm::make_early_inc_range(TypeTestFunc.uses())) {
2069 auto *CI = cast<CallInst>(U.getUser());
2070 // Find and erase llvm.assume intrinsics for this llvm.type.test call.
2071 for (Use &CIU : llvm::make_early_inc_range(CI->uses()))
2072 if (auto *Assume = dyn_cast<AssumeInst>(CIU.getUser()))
2073 Assume->eraseFromParent();
2074 // If the assume was merged with another assume, we might have a use on a
2075 // phi or select (which will feed the assume). Simply replace the use on
2076 // the phi/select with "true" and leave the merged assume.
2077 //
2078 // If ShouldDropAll is set, then we we need to update any remaining uses,
2079 // regardless of the instruction type.
2080 if (!CI->use_empty()) {
2081 assert(ShouldDropAll || all_of(CI->users(), [](User *U) -> bool {
2082 return isa<PHINode>(U) || isa<SelectInst>(U);
2083 }));
2084 CI->replaceAllUsesWith(ConstantInt::getTrue(M.getContext()));
2085 }
2086 CI->eraseFromParent();
2087 }
2088}
2089
2090static bool dropTypeTests(Module &M, bool ShouldDropAll) {
2091 Function *TypeTestFunc =
2092 Intrinsic::getDeclarationIfExists(&M, Intrinsic::type_test);
2093 if (TypeTestFunc)
2094 dropTypeTests(M, *TypeTestFunc, ShouldDropAll);
2095 // Normally we'd have already removed all @llvm.public.type.test calls,
2096 // except for in the case where we originally were performing ThinLTO but
2097 // decided not to in the backend.
2098 Function *PublicTypeTestFunc =
2099 Intrinsic::getDeclarationIfExists(&M, Intrinsic::public_type_test);
2100 if (PublicTypeTestFunc)
2101 dropTypeTests(M, *PublicTypeTestFunc, ShouldDropAll);
2102 if (TypeTestFunc || PublicTypeTestFunc) {
2103 // We have deleted the type intrinsics, so we no longer have enough
2104 // information to reason about the liveness of virtual function pointers
2105 // in GlobalDCE.
2106 for (GlobalVariable &GV : M.globals())
2107 GV.eraseMetadata(LLVMContext::MD_vcall_visibility);
2108 return true;
2109 }
2110 return false;
2111}
2112
2113bool LowerTypeTestsModule::lower() {
2114 Function *TypeTestFunc =
2115 Intrinsic::getDeclarationIfExists(&M, Intrinsic::type_test);
2116
2117 // If only some of the modules were split, we cannot correctly perform
2118 // this transformation. We already checked for the presense of type tests
2119 // with partially split modules during the thin link, and would have emitted
2120 // an error if any were found, so here we can simply return.
2121 if ((ExportSummary && ExportSummary->partiallySplitLTOUnits()) ||
2122 (ImportSummary && ImportSummary->partiallySplitLTOUnits()))
2123 return false;
2124
2125 Function *ICallBranchFunnelFunc =
2126 Intrinsic::getDeclarationIfExists(&M, Intrinsic::icall_branch_funnel);
2127 if ((!TypeTestFunc || TypeTestFunc->use_empty()) &&
2128 (!ICallBranchFunnelFunc || ICallBranchFunnelFunc->use_empty()) &&
2129 !ExportSummary && !ImportSummary)
2130 return false;
2131
2132 if (ImportSummary) {
2133 if (TypeTestFunc)
2134 for (Use &U : llvm::make_early_inc_range(TypeTestFunc->uses()))
2135 importTypeTest(cast<CallInst>(U.getUser()));
2136
2137 if (ICallBranchFunnelFunc && !ICallBranchFunnelFunc->use_empty())
2139 "unexpected call to llvm.icall.branch.funnel during import phase");
2140
2143 for (auto &F : M) {
2144 // CFI functions are either external, or promoted. A local function may
2145 // have the same name, but it's not the one we are looking for.
2146 if (F.hasLocalLinkage())
2147 continue;
2148 if (ImportSummary->cfiFunctionDefs().contains(F.getName()))
2149 Defs.push_back(&F);
2150 else if (ImportSummary->cfiFunctionDecls().contains(F.getName()))
2151 Decls.push_back(&F);
2152 }
2153
2154 {
2155 ScopedSaveAliaseesAndUsed S(M);
2156 for (auto *F : Defs)
2157 importFunction(F, /*isJumpTableCanonical*/ true);
2158 for (auto *F : Decls)
2159 importFunction(F, /*isJumpTableCanonical*/ false);
2160 }
2161
2162 return true;
2163 }
2164
2165 // Equivalence class set containing type identifiers and the globals that
2166 // reference them. This is used to partition the set of type identifiers in
2167 // the module into disjoint sets.
2168 using GlobalClassesTy = EquivalenceClasses<
2169 PointerUnion<GlobalTypeMember *, Metadata *, ICallBranchFunnel *>>;
2170 GlobalClassesTy GlobalClasses;
2171
2172 // Verify the type metadata and build a few data structures to let us
2173 // efficiently enumerate the type identifiers associated with a global:
2174 // a list of GlobalTypeMembers (a GlobalObject stored alongside a vector
2175 // of associated type metadata) and a mapping from type identifiers to their
2176 // list of GlobalTypeMembers and last observed index in the list of globals.
2177 // The indices will be used later to deterministically order the list of type
2178 // identifiers.
2180 struct TIInfo {
2181 unsigned UniqueId;
2182 std::vector<GlobalTypeMember *> RefGlobals;
2183 };
2184 DenseMap<Metadata *, TIInfo> TypeIdInfo;
2185 unsigned CurUniqueId = 0;
2187
2188 struct ExportedFunctionInfo {
2190 MDNode *FuncMD; // {name, linkage, type[, type...]}
2191 };
2192 MapVector<StringRef, ExportedFunctionInfo> ExportedFunctions;
2193 if (ExportSummary) {
2194 NamedMDNode *CfiFunctionsMD = M.getNamedMetadata("cfi.functions");
2195 if (CfiFunctionsMD) {
2196 // A set of all functions that are address taken by a live global object.
2197 DenseSet<GlobalValue::GUID> AddressTaken;
2198 for (auto &I : *ExportSummary)
2199 for (auto &GVS : I.second.getSummaryList())
2200 if (GVS->isLive())
2201 for (const auto &Ref : GVS->refs()) {
2202 AddressTaken.insert(Ref.getGUID());
2203 for (auto &RefGVS : Ref.getSummaryList())
2204 if (auto Alias = dyn_cast<AliasSummary>(RefGVS.get()))
2205 AddressTaken.insert(Alias->getAliaseeGUID());
2206 }
2208 if (AddressTaken.count(GUID))
2209 return true;
2210 auto VI = ExportSummary->getValueInfo(GUID);
2211 if (!VI)
2212 return false;
2213 for (auto &I : VI.getSummaryList())
2214 if (auto Alias = dyn_cast<AliasSummary>(I.get()))
2215 if (AddressTaken.count(Alias->getAliaseeGUID()))
2216 return true;
2217 return false;
2218 };
2219 for (auto *FuncMD : CfiFunctionsMD->operands()) {
2220 assert(FuncMD->getNumOperands() >= 2);
2221 StringRef FunctionName =
2222 cast<MDString>(FuncMD->getOperand(0))->getString();
2224 cast<ConstantAsMetadata>(FuncMD->getOperand(1))
2225 ->getValue()
2226 ->getUniqueInteger()
2227 .getZExtValue());
2228 const GlobalValue::GUID GUID =
2229 cast<ConstantAsMetadata>(FuncMD->getOperand(2))
2230 ->getValue()
2231 ->getUniqueInteger()
2232 .getZExtValue();
2233 // Do not emit jumptable entries for functions that are not-live and
2234 // have no live references (and are not exported with cross-DSO CFI.)
2235 if (!ExportSummary->isGUIDLive(GUID))
2236 continue;
2237 if (!IsAddressTaken(GUID)) {
2238 if (!CrossDsoCfi || Linkage != CFL_Definition)
2239 continue;
2240
2241 bool Exported = false;
2242 if (auto VI = ExportSummary->getValueInfo(GUID))
2243 for (const auto &GVS : VI.getSummaryList())
2244 if (GVS->isLive() && !GlobalValue::isLocalLinkage(GVS->linkage()))
2245 Exported = true;
2246
2247 if (!Exported)
2248 continue;
2249 }
2250 auto P = ExportedFunctions.insert({FunctionName, {Linkage, FuncMD}});
2251 if (!P.second && P.first->second.Linkage != CFL_Definition)
2252 P.first->second = {Linkage, FuncMD};
2253 }
2254
2255 for (const auto &P : ExportedFunctions) {
2256 StringRef FunctionName = P.first;
2257 CfiFunctionLinkage Linkage = P.second.Linkage;
2258 MDNode *FuncMD = P.second.FuncMD;
2259 Function *F = M.getFunction(FunctionName);
2260 if (F && F->hasLocalLinkage()) {
2261 // Locally defined function that happens to have the same name as a
2262 // function defined in a ThinLTO module. Rename it to move it out of
2263 // the way of the external reference that we're about to create.
2264 // Note that setName will find a unique name for the function, so even
2265 // if there is an existing function with the suffix there won't be a
2266 // name collision.
2267 F->setName(F->getName() + ".1");
2268 F = nullptr;
2269 }
2270
2271 if (!F) {
2273 FunctionType::get(Type::getVoidTy(M.getContext()), false),
2274 GlobalVariable::ExternalLinkage,
2275 M.getDataLayout().getProgramAddressSpace(), FunctionName, &M);
2276 F->setMetadata(
2277 LLVMContext::MD_unique_id,
2278 MDTuple::get(M.getContext(), {FuncMD->getOperand(2).get()}));
2279 }
2280 // If the function is available_externally, remove its definition so
2281 // that it is handled the same way as a declaration. Later we will try
2282 // to create an alias using this function's linkage, which will fail if
2283 // the linkage is available_externally. This will also result in us
2284 // following the code path below to replace the type metadata.
2285 if (F->hasAvailableExternallyLinkage()) {
2286 // Maintain !guid metadata.
2287 auto *OrigGUIDMD = F->getMetadata(LLVMContext::MD_unique_id);
2288 F->setLinkage(GlobalValue::ExternalLinkage);
2289 F->deleteBody();
2290 F->setComdat(nullptr);
2291 F->clearMetadata();
2292 F->setMetadata(LLVMContext::MD_unique_id, OrigGUIDMD);
2293 }
2294
2295 // Update the linkage for extern_weak declarations when a definition
2296 // exists.
2297 if (Linkage == CFL_Definition && F->hasExternalWeakLinkage())
2298 F->setLinkage(GlobalValue::ExternalLinkage);
2299
2300 // If the function in the full LTO module is a declaration, replace its
2301 // type metadata with the type metadata we found in cfi.functions. That
2302 // metadata is presumed to be more accurate than the metadata attached
2303 // to the declaration.
2304 if (F->isDeclaration()) {
2307
2308 F->eraseMetadata(LLVMContext::MD_type);
2309 for (unsigned I = 3; I < FuncMD->getNumOperands(); ++I)
2310 F->addMetadata(LLVMContext::MD_type,
2311 *cast<MDNode>(FuncMD->getOperand(I).get()));
2312 }
2313 }
2314 }
2315 }
2316
2317 struct AliasToCreate {
2318 Function *Alias;
2319 std::string TargetName;
2320 };
2321 std::vector<AliasToCreate> AliasesToCreate;
2322
2323 // Parse alias data to replace stand-in function declarations for aliases
2324 // with an alias to the intended target.
2325 if (ExportSummary) {
2326 if (NamedMDNode *AliasesMD = M.getNamedMetadata("aliases")) {
2327 for (auto *AliasMD : AliasesMD->operands()) {
2329 for (Metadata *MD : AliasMD->operands()) {
2330 auto *MDS = dyn_cast<MDString>(MD);
2331 if (!MDS)
2332 continue;
2333 StringRef AliasName = MDS->getString();
2334 if (!ExportedFunctions.count(AliasName))
2335 continue;
2336 auto *AliasF = M.getFunction(AliasName);
2337 if (AliasF)
2338 Aliases.push_back(AliasF);
2339 }
2340
2341 if (Aliases.empty())
2342 continue;
2343
2344 for (unsigned I = 1; I != Aliases.size(); ++I) {
2345 auto *AliasF = Aliases[I];
2346 ExportedFunctions.erase(AliasF->getName());
2347 AliasesToCreate.push_back(
2348 {AliasF, std::string(Aliases[0]->getName())});
2349 }
2350 }
2351 }
2352 }
2353
2354 DenseMap<GlobalObject *, GlobalTypeMember *> GlobalTypeMembers;
2355 for (GlobalObject &GO : M.global_objects()) {
2357 continue;
2358
2359 Types.clear();
2360 GO.getMetadata(LLVMContext::MD_type, Types);
2361
2362 bool IsJumpTableCanonical = false;
2363 bool IsExported = false;
2364 if (Function *F = dyn_cast<Function>(&GO)) {
2365 IsJumpTableCanonical = isJumpTableCanonical(F);
2366 if (auto It = ExportedFunctions.find(F->getName());
2367 It != ExportedFunctions.end()) {
2368 IsJumpTableCanonical |= It->second.Linkage == CFL_Definition;
2369 IsExported = true;
2370 // TODO: The logic here checks only that the function is address taken,
2371 // not that the address takers are live. This can be updated to check
2372 // their liveness and emit fewer jumptable entries once monolithic LTO
2373 // builds also emit summaries.
2374 } else if (!F->hasAddressTaken()) {
2375 if (!CrossDsoCfi || !IsJumpTableCanonical || F->hasLocalLinkage())
2376 continue;
2377 }
2378 }
2379
2380 auto *GTM = GlobalTypeMember::create(Alloc, &GO, IsJumpTableCanonical,
2381 IsExported, Types);
2382 GlobalTypeMembers[&GO] = GTM;
2383 for (MDNode *Type : Types) {
2384 verifyTypeMDNode(&GO, Type);
2385 auto &Info = TypeIdInfo[Type->getOperand(1)];
2386 Info.UniqueId = ++CurUniqueId;
2387 Info.RefGlobals.push_back(GTM);
2388 }
2389 }
2390
2391 auto AddTypeIdUse = [&](Metadata *TypeId) -> TypeIdUserInfo & {
2392 // Add the call site to the list of call sites for this type identifier. We
2393 // also use TypeIdUsers to keep track of whether we have seen this type
2394 // identifier before. If we have, we don't need to re-add the referenced
2395 // globals to the equivalence class.
2396 auto Ins = TypeIdUsers.insert({TypeId, {}});
2397 if (Ins.second) {
2398 // Add the type identifier to the equivalence class.
2399 auto &GCI = GlobalClasses.insert(TypeId);
2400 GlobalClassesTy::member_iterator CurSet = GlobalClasses.findLeader(GCI);
2401
2402 // Add the referenced globals to the type identifier's equivalence class.
2403 for (GlobalTypeMember *GTM : TypeIdInfo[TypeId].RefGlobals)
2404 CurSet = GlobalClasses.unionSets(
2405 CurSet, GlobalClasses.findLeader(GlobalClasses.insert(GTM)));
2406 }
2407
2408 return Ins.first->second;
2409 };
2410
2411 if (TypeTestFunc) {
2412 for (const Use &U : TypeTestFunc->uses()) {
2413 auto CI = cast<CallInst>(U.getUser());
2414 // If this type test is only used by llvm.assume instructions, it
2415 // was used for whole program devirtualization, and is being kept
2416 // for use by other optimization passes. We do not need or want to
2417 // lower it here. We also don't want to rewrite any associated globals
2418 // unnecessarily. These will be removed by a subsequent LTT invocation
2419 // with the DropTypeTests flag set.
2420 bool OnlyAssumeUses = !CI->use_empty();
2421 for (const Use &CIU : CI->uses()) {
2422 if (isa<AssumeInst>(CIU.getUser()))
2423 continue;
2424 OnlyAssumeUses = false;
2425 break;
2426 }
2427 if (OnlyAssumeUses)
2428 continue;
2429
2430 auto TypeIdMDVal = dyn_cast<MetadataAsValue>(CI->getArgOperand(1));
2431 if (!TypeIdMDVal)
2432 report_fatal_error("Second argument of llvm.type.test must be metadata");
2433 auto TypeId = TypeIdMDVal->getMetadata();
2434 AddTypeIdUse(TypeId).CallSites.push_back(CI);
2435 }
2436 }
2437
2438 if (ICallBranchFunnelFunc) {
2439 for (const Use &U : ICallBranchFunnelFunc->uses()) {
2440 if (Arch != Triple::x86_64)
2442 "llvm.icall.branch.funnel not supported on this target");
2443
2444 auto CI = cast<CallInst>(U.getUser());
2445
2446 std::vector<GlobalTypeMember *> Targets;
2447 if (CI->arg_size() % 2 != 1)
2448 report_fatal_error("number of arguments should be odd");
2449
2450 GlobalClassesTy::member_iterator CurSet;
2451 for (unsigned I = 1; I != CI->arg_size(); I += 2) {
2452 int64_t Offset;
2454 CI->getOperand(I), Offset, M.getDataLayout()));
2455 if (!Base)
2457 "Expected branch funnel operand to be global value");
2458
2459 GlobalTypeMember *GTM = GlobalTypeMembers[Base];
2460 Targets.push_back(GTM);
2461 GlobalClassesTy::member_iterator NewSet =
2462 GlobalClasses.findLeader(GlobalClasses.insert(GTM));
2463 if (I == 1)
2464 CurSet = NewSet;
2465 else
2466 CurSet = GlobalClasses.unionSets(CurSet, NewSet);
2467 }
2468
2469 GlobalClasses.unionSets(
2470 CurSet, GlobalClasses.findLeader(
2471 GlobalClasses.insert(ICallBranchFunnel::create(
2472 Alloc, CI, Targets, ++CurUniqueId))));
2473 }
2474 }
2475
2476 if (ExportSummary) {
2477 DenseMap<GlobalValue::GUID, TinyPtrVector<Metadata *>> MetadataByGUID;
2478 for (auto &P : TypeIdInfo) {
2479 if (auto *TypeId = dyn_cast<MDString>(P.first))
2481 TypeId->getString())]
2482 .push_back(TypeId);
2483 }
2484
2485 for (auto &P : *ExportSummary) {
2486 for (auto &S : P.second.getSummaryList()) {
2487 if (!ExportSummary->isGlobalValueLive(S.get()))
2488 continue;
2489 if (auto *FS = dyn_cast<FunctionSummary>(S->getBaseObject()))
2490 for (GlobalValue::GUID G : FS->type_tests())
2491 for (Metadata *MD : MetadataByGUID[G])
2492 AddTypeIdUse(MD).IsExported = true;
2493 }
2494 }
2495 }
2496
2497 if (GlobalClasses.empty())
2498 return false;
2499
2500 {
2501 ScopedSaveAliaseesAndUsed S(M);
2502 // For each disjoint set we found...
2503 for (const auto &C : GlobalClasses) {
2504 if (!C->isLeader())
2505 continue;
2506
2507 ++NumTypeIdDisjointSets;
2508 // Build the list of type identifiers in this disjoint set.
2509 std::vector<Metadata *> TypeIds;
2510 std::vector<GlobalTypeMember *> Globals;
2511 std::vector<ICallBranchFunnel *> ICallBranchFunnels;
2512 for (auto M : GlobalClasses.members(*C)) {
2513 if (isa<Metadata *>(M))
2514 TypeIds.push_back(cast<Metadata *>(M));
2515 else if (isa<GlobalTypeMember *>(M))
2516 Globals.push_back(cast<GlobalTypeMember *>(M));
2517 else
2518 ICallBranchFunnels.push_back(cast<ICallBranchFunnel *>(M));
2519 }
2520
2521 // Order type identifiers by unique ID for determinism. This ordering is
2522 // stable as there is a one-to-one mapping between metadata and unique
2523 // IDs.
2524 llvm::sort(TypeIds, [&](Metadata *M1, Metadata *M2) {
2525 return TypeIdInfo[M1].UniqueId < TypeIdInfo[M2].UniqueId;
2526 });
2527
2528 // Same for the branch funnels.
2529 llvm::sort(ICallBranchFunnels,
2530 [&](ICallBranchFunnel *F1, ICallBranchFunnel *F2) {
2531 return F1->UniqueId < F2->UniqueId;
2532 });
2533
2534 // Build bitsets for this disjoint set.
2535 buildBitSetsFromDisjointSet(TypeIds, Globals, ICallBranchFunnels);
2536 }
2537 }
2538
2539 allocateByteArrays();
2540
2541 for (auto A : AliasesToCreate) {
2542 auto *Target = M.getNamedValue(A.TargetName);
2543 if (!isa<GlobalAlias>(Target))
2544 continue;
2545 auto *AliasGA = GlobalAlias::create("", Target);
2546 AliasGA->setVisibility(A.Alias->getVisibility());
2547 AliasGA->setLinkage(A.Alias->getLinkage());
2548 AliasGA->takeName(A.Alias);
2549 A.Alias->replaceAllUsesWith(AliasGA);
2550 A.Alias->eraseFromParent();
2551 }
2552
2553 // Emit .symver directives for exported functions, if they exist.
2554 if (ExportSummary) {
2555 if (NamedMDNode *SymversMD = M.getNamedMetadata("symvers")) {
2556 for (auto *Symver : SymversMD->operands()) {
2557 assert(Symver->getNumOperands() >= 2);
2558 StringRef SymbolName =
2559 cast<MDString>(Symver->getOperand(0))->getString();
2560 StringRef Alias = cast<MDString>(Symver->getOperand(1))->getString();
2561
2562 if (!ExportedFunctions.count(SymbolName))
2563 continue;
2564
2565 M.appendModuleInlineAsm(
2566 (llvm::Twine(".symver ") + SymbolName + ", " + Alias).str());
2567 }
2568 }
2569 }
2570
2571 return true;
2572}
2573
2576 bool Changed;
2577 if (UseCommandLine)
2578 Changed = LowerTypeTestsModule::runForTesting(M, AM);
2579 else
2580 Changed = LowerTypeTestsModule(M, AM, ExportSummary, ImportSummary).lower();
2581 if (!Changed)
2582 return PreservedAnalyses::all();
2583 return PreservedAnalyses::none();
2584}
2585
2587 raw_ostream &OS, function_ref<StringRef(StringRef)> MapClassName2PassName) {
2588 static_cast<PassInfoMixin<DropTypeTestsPass> *>(this)->printPipeline(
2589 OS, MapClassName2PassName);
2590 OS << '<';
2591 switch (Kind) {
2592 case DropTestKind::Assume:
2593 OS << "assume";
2594 break;
2595 case DropTestKind::All:
2596 OS << "all";
2597 break;
2598 }
2599 OS << '>';
2600}
2601
2606
2609 bool Changed = false;
2610 // Figure out whether inlining has exposed a constant address to a lowered
2611 // type test, and remove the test if so and the address is known to pass the
2612 // test. Unfortunately this pass ends up needing to reverse engineer what
2613 // LowerTypeTests did; this is currently inherent to the design of ThinLTO
2614 // importing where LowerTypeTests needs to run at the start.
2615 //
2616 // We look for things like:
2617 //
2618 // sub (i64 ptrtoint (ptr @_Z2fpv to i64), i64 ptrtoint (ptr
2619 // @__typeid__ZTSFvvE_global_addr to i64))
2620 //
2621 // which gets replaced with 0 if _Z2fpv (more specifically _Z2fpv.cfi, the
2622 // function referred to by the jump table) is a member of the type _ZTSFvv, as
2623 // well as things like
2624 //
2625 // icmp eq ptr @_Z2fpv, @__typeid__ZTSFvvE_global_addr
2626 //
2627 // which gets replaced with true if _Z2fpv is a member.
2628 for (auto &GV : M.globals()) {
2629 if (!GV.getName().starts_with("__typeid_") ||
2630 !GV.getName().ends_with("_global_addr"))
2631 continue;
2632 // __typeid_foo_global_addr -> foo
2633 auto *MD = MDString::get(M.getContext(),
2634 GV.getName().substr(9, GV.getName().size() - 21));
2635 auto MaySimplifyPtr = [&](Value *Ptr) {
2636 if (auto *GV = dyn_cast<GlobalValue>(Ptr))
2637 if (auto *CFIGV = M.getNamedValue((GV->getName() + ".cfi").str()))
2638 Ptr = CFIGV;
2639 return isKnownTypeIdMember(MD, M.getDataLayout(), Ptr, 0);
2640 };
2641 auto MaySimplifyInt = [&](Value *Op) {
2642 auto *PtrAsInt = dyn_cast<ConstantExpr>(Op);
2643 if (!PtrAsInt || PtrAsInt->getOpcode() != Instruction::PtrToInt)
2644 return false;
2645 return MaySimplifyPtr(PtrAsInt->getOperand(0));
2646 };
2647 for (User *U : make_early_inc_range(GV.users())) {
2648 if (auto *CI = dyn_cast<ICmpInst>(U)) {
2649 if (CI->getPredicate() == CmpInst::ICMP_EQ &&
2650 MaySimplifyPtr(CI->getOperand(0))) {
2651 // This is an equality comparison (TypeTestResolution::Single case in
2652 // lowerTypeTestCall). In this case we just replace the comparison
2653 // with true.
2654 CI->replaceAllUsesWith(ConstantInt::getTrue(M.getContext()));
2655 CI->eraseFromParent();
2656 Changed = true;
2657 continue;
2658 }
2659 }
2660 auto *CE = dyn_cast<ConstantExpr>(U);
2661 if (!CE || CE->getOpcode() != Instruction::PtrToInt)
2662 continue;
2663 for (Use &U : make_early_inc_range(CE->uses())) {
2664 auto *CE = dyn_cast<ConstantExpr>(U.getUser());
2665 if (U.getOperandNo() == 0 && CE &&
2666 CE->getOpcode() == Instruction::Sub &&
2667 MaySimplifyInt(CE->getOperand(1))) {
2668 // This is a computation of PtrOffset as generated by
2669 // LowerTypeTestsModule::lowerTypeTestCall above. If
2670 // isKnownTypeIdMember passes we just pretend it evaluated to 0. This
2671 // should cause later passes to remove the range and alignment checks.
2672 // The bitset checks won't be removed but those are uncommon.
2673 CE->replaceAllUsesWith(ConstantInt::get(CE->getType(), 0));
2674 Changed = true;
2675 }
2676 auto *CI = dyn_cast<ICmpInst>(U.getUser());
2677 if (U.getOperandNo() == 1 && CI &&
2678 CI->getPredicate() == CmpInst::ICMP_EQ &&
2679 MaySimplifyInt(CI->getOperand(0))) {
2680 // This is an equality comparison. Unlike in the case above it
2681 // remained as an integer compare.
2682 CI->replaceAllUsesWith(ConstantInt::getTrue(M.getContext()));
2683 CI->eraseFromParent();
2684 Changed = true;
2685 }
2686 }
2687 }
2688 }
2689
2690 if (!Changed)
2691 return PreservedAnalyses::all();
2695 PA.preserve<LoopAnalysis>();
2696 return PA;
2697}
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
AMDGPU Register Bank Select
This file implements a class to represent arbitrary precision integral constant values and operations...
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
This file defines the BumpPtrAllocator interface.
This file contains the simple types necessary to represent the attributes associated with functions a...
static GCRegistry::Add< ErlangGC > A("erlang", "erlang-compatible garbage collector")
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
#define clEnumValN(ENUMVAL, FLAGNAME, DESC)
This file contains the declarations for the subclasses of Constant, which represent the different fla...
DXIL Finalize Linkage
dxil translate DXIL Translate Metadata
This file defines the DenseMap class.
Generic implementation of equivalence classes through the use Tarjan's efficient union-find algorithm...
#define DEBUG_TYPE
Hexagon Common GEP
Module.h This file contains the declarations for the Module class.
This header defines various interfaces for pass management in LLVM.
This defines the Use class.
static const unsigned kARMJumpTableEntrySize
static const unsigned kLOONGARCH64JumpTableEntrySize
static bool isKnownTypeIdMember(Metadata *TypeId, const DataLayout &DL, Value *V, uint64_t COffset)
static const unsigned kX86IBTJumpTableEntrySize
static SmallVector< DILocation * > createJumpTableDebugInfo(Function *F, ArrayRef< GlobalTypeMember * > Functions)
static cl::opt< std::string > ClReadSummary("lowertypetests-read-summary", cl::desc("Read summary from given YAML file before running pass"), cl::Hidden)
static const unsigned kRISCVJumpTableEntrySize
static auto buildBitSets(ArrayRef< Metadata * > TypeIds, const DenseMap< GlobalTypeMember *, uint64_t > &GlobalLayout)
static void dropTypeTests(Module &M, Function &TypeTestFunc, bool ShouldDropAll)
static Value * createMaskedBitTest(IRBuilder<> &B, Value *Bits, Value *BitOffset)
Build a test that bit BitOffset mod sizeof(Bits)*8 is set in Bits.
static bool isThumbFunction(Function *F, Triple::ArchType ModuleArch)
static const unsigned kX86JumpTableEntrySize
static cl::opt< bool > AvoidReuse("lowertypetests-avoid-reuse", cl::desc("Try to avoid reuse of byte array addresses using aliases"), cl::Hidden, cl::init(true))
static cl::opt< PassSummaryAction > ClSummaryAction("lowertypetests-summary-action", cl::desc("What to do with the summary when running this pass"), cl::values(clEnumValN(PassSummaryAction::None, "none", "Do nothing"), clEnumValN(PassSummaryAction::Import, "import", "Import typeid resolutions from summary and globals"), clEnumValN(PassSummaryAction::Export, "export", "Export typeid resolutions to summary and globals")), cl::Hidden)
static const unsigned kARMBTIJumpTableEntrySize
static cl::opt< bool > EnableJumpTableDebugInfo("lowertypetests-jump-table-debug-info", cl::init(true), cl::Hidden, cl::desc("Enable debug info generation for jump tables"))
static cl::opt< std::string > ClWriteSummary("lowertypetests-write-summary", cl::desc("Write summary to given YAML file after running pass"), cl::Hidden)
static BitSetInfo buildBitSet(ArrayRef< uint64_t > Offsets)
Build a bit set for list of offsets.
static bool isDirectCall(Use &U)
static const unsigned kARMv6MJumpTableEntrySize
static const unsigned kHexagonJumpTableEntrySize
#define F(x, y, z)
Definition MD5.cpp:54
#define I(x, y, z)
Definition MD5.cpp:57
#define G(x, y, z)
Definition MD5.cpp:55
Machine Check Debug Module
This file contains the declarations for metadata subclasses.
#define T
ModuleSummaryIndex.h This file contains the declarations the classes that hold the module index and s...
#define P(N)
FunctionAnalysisManager FAM
This file defines the PointerUnion class, which is a discriminated union of pointer types.
This file contains the declarations for profiling metadata utility functions.
static StringRef getName(Value *V)
This file contains some templates that are useful if you are working with the STL at all.
This file contains library features backported from future STL versions.
This file implements a set that has insertion order iteration characteristics.
This file defines the SmallVector class.
This file defines the 'Statistic' class, which is designed to be an easy way to expose various metric...
#define STATISTIC(VARNAME, DESC)
Definition Statistic.h:171
#define LLVM_DEBUG(...)
Definition Debug.h:119
This pass exposes codegen information to IR-level passes.
This header defines support for implementing classes that have some trailing object (or arrays of obj...
Class for arbitrary precision integers.
Definition APInt.h:78
uint64_t getZExtValue() const
Get zero extended value.
Definition APInt.h:1565
PassT::Result & getResult(IRUnitT &IR, ExtraArgTs... ExtraArgs)
Get the result of an analysis pass for a given IR unit.
Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition ArrayRef.h:40
size_t size() const
Get the array size.
Definition ArrayRef.h:141
bool empty() const
Check if the array is empty.
Definition ArrayRef.h:136
static LLVM_ABI ArrayType * get(Type *ElementType, uint64_t NumElements)
This static method is the primary way to construct an ArrayType.
Functions, function parameters, and return types can have attributes to indicate how they should be t...
Definition Attributes.h:105
LLVM_ABI StringRef getValueAsString() const
Return the attribute's value as a string.
bool isValid() const
Return true if the attribute is any kind of attribute.
Definition Attributes.h:261
LLVM_ABI BasicBlock * splitBasicBlock(iterator I, const Twine &BBName="")
Split the basic block into two basic blocks at the specified instruction.
static BasicBlock * Create(LLVMContext &Context, const Twine &Name="", Function *Parent=nullptr, BasicBlock *InsertBefore=nullptr)
Creates a new BasicBlock.
Definition BasicBlock.h:206
const Instruction * getTerminator() const LLVM_READONLY
Returns the terminator instruction; assumes that the block is well-formed.
Definition BasicBlock.h:237
Value * getArgOperand(unsigned i) const
unsigned arg_size() const
void addSymbolWithThinLTOGUID(StringRef Name, GlobalValue::GUID GUID)
Add the function name and the GUID that ThinLTO uses for it.
bool contains(StringRef Name) const
@ ICMP_NE
not equal
Definition InstrTypes.h:762
static CondBrInst * Create(Value *Cond, BasicBlock *IfTrue, BasicBlock *IfFalse, InsertPosition InsertBefore=nullptr)
static LLVM_ABI ConstantAggregateZero * get(Type *Ty)
ConstantArray - Constant Array Declarations.
Definition Constants.h:590
static ConstantAsMetadata * get(Constant *C)
Definition Metadata.h:537
static Constant * get(LLVMContext &Context, ArrayRef< ElementTy > Elts)
get() constructor - Return a constant with array type with an element count and element type matching...
Definition Constants.h:878
static LLVM_ABI Constant * getIntToPtr(Constant *C, Type *Ty, bool OnlyIfReduced=false)
static Constant * getInBoundsGetElementPtr(Type *Ty, Constant *C, ArrayRef< Constant * > IdxList)
Create an "inbounds" getelementptr.
Definition Constants.h:1507
static LLVM_ABI Constant * getPointerCast(Constant *C, Type *Ty)
Create a BitCast, AddrSpaceCast, or a PtrToInt cast constant expression.
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.
Definition Constants.h:1497
static LLVM_ABI Constant * getPtrToInt(Constant *C, Type *Ty, bool OnlyIfReduced=false)
static Constant * getInBoundsPtrAdd(Constant *Ptr, Constant *Offset)
Create a getelementptr inbounds i8, ptr, offset constant expression.
Definition Constants.h:1524
static LLVM_ABI ConstantInt * getTrue(LLVMContext &Context)
static LLVM_ABI ConstantInt * getFalse(LLVMContext &Context)
static LLVM_ABI ConstantPointerNull * get(PointerType *T)
Static factory methods - Return objects of the specified value.
static Constant * getAnon(ArrayRef< Constant * > V, bool Packed=false)
Return an anonymous struct that has the specified elements.
Definition Constants.h:643
static LLVM_ABI Constant * getNullValue(Type *Ty)
Constructor to create a '0' constant of arbitrary type.
LLVM_ABI void finalize()
Construct any deferred debug info descriptors.
Definition DIBuilder.cpp:74
LLVM_ABI DISubroutineType * createSubroutineType(DITypeArray ParameterTypes, DINode::DIFlags Flags=DINode::FlagZero, unsigned CC=0)
Create subroutine type.
LLVM_ABI DISubprogram * createFunction(DIScope *Scope, StringRef Name, StringRef LinkageName, DIFile *File, unsigned LineNo, DISubroutineType *Ty, unsigned ScopeLine, DINode::DIFlags Flags=DINode::FlagZero, DISubprogram::DISPFlags SPFlags=DISubprogram::SPFlagZero, DITemplateParameterArray TParams=nullptr, DISubprogram *Decl=nullptr, DITypeArray ThrownTypes=nullptr, DINodeArray Annotations=nullptr, StringRef TargetFuncName="", bool UseKeyInstructions=false)
Create a new descriptor for the specified subprogram.
LLVM_ABI DICompileUnit * createCompileUnit(DISourceLanguageName Lang, DIFile *File, StringRef Producer, bool isOptimized, StringRef Flags, unsigned RV, StringRef SplitName=StringRef(), DICompileUnit::DebugEmissionKind Kind=DICompileUnit::DebugEmissionKind::FullDebug, uint64_t DWOId=0, bool SplitDebugInlining=true, bool DebugInfoForProfiling=false, DICompileUnit::DebugNameTableKind NameTableKind=DICompileUnit::DebugNameTableKind::Default, bool RangesBaseAddress=false, StringRef SysRoot={}, StringRef SDK={})
A CompileUnit provides an anchor for all debugging information generated during this instance of comp...
LLVM_ABI DIFile * createFile(StringRef Filename, StringRef Directory, std::optional< DIFile::ChecksumInfo< StringRef > > Checksum=std::nullopt, std::optional< StringRef > Source=std::nullopt)
Create a file descriptor to hold debugging information for a file.
Wrapper structure that holds source language identity metadata that includes language name,...
Subprogram description. Uses SubclassData1.
Type array for a subprogram.
A parsed version of the target data layout string in and methods for querying it.
Definition DataLayout.h:64
iterator find(const_arg_type_t< KeyT > Val)
Definition DenseMap.h:223
iterator end()
Definition DenseMap.h:141
std::pair< iterator, bool > insert(const std::pair< KeyT, ValueT > &KV)
Definition DenseMap.h:284
Analysis pass which computes a DominatorTree.
Definition Dominators.h:270
LLVM_ABI PreservedAnalyses run(Module &M, ModuleAnalysisManager &AM)
LLVM_ABI void printPipeline(raw_ostream &OS, function_ref< StringRef(StringRef)> MapClassName2PassName)
static LLVM_ABI FunctionType * get(Type *Result, ArrayRef< Type * > Params, bool isVarArg)
This static method is the primary way of constructing a FunctionType.
static Function * Create(FunctionType *Ty, LinkageTypes Linkage, unsigned AddrSpace, const Twine &N="", Module *M=nullptr)
Definition Function.h:168
const BasicBlock & getEntryBlock() const
Definition Function.h:783
void eraseFromParent()
eraseFromParent - This method unlinks 'this' from the containing module and deletes it.
Definition Function.cpp:444
static LLVM_ABI GlobalAlias * create(Type *Ty, unsigned AddressSpace, LinkageTypes Linkage, const Twine &Name, Constant *Aliasee, Module *Parent)
If a parent module is specified, the alias is automatically inserted into the end of the specified mo...
Definition Globals.cpp:692
LLVM_ABI void setMetadata(unsigned KindID, MDNode *Node)
Set a particular kind of metadata attachment.
LLVM_ABI void setComdat(Comdat *C)
Definition Globals.cpp:287
LLVM_ABI void setSection(StringRef S)
Change the section for this global.
Definition Globals.cpp:348
const Comdat * getComdat() const
LLVM_ABI bool eraseMetadata(unsigned KindID)
Erase all metadata attachments with the given kind.
MDNode * getMetadata(unsigned KindID) const
Get the metadata of given kind attached to this GlobalObject.
bool hasSection() const
Check if this global has a custom object file section.
static LLVM_ABI GUID getGUIDAssumingExternalLinkage(StringRef GlobalName)
Return a 64-bit global unique ID constructed from the name of a global symbol.
Definition Globals.cpp:80
bool isDSOLocal() const
bool isThreadLocal() const
If the value is "Thread Local", its value isn't shared by the threads.
VisibilityTypes getVisibility() const
static bool isLocalLinkage(LinkageTypes Linkage)
LinkageTypes getLinkage() const
uint64_t GUID
Declare a type to represent a global unique identifier for a global value.
bool isDeclarationForLinker() const
PointerType * getType() const
Global values are always pointers.
VisibilityTypes
An enumeration for the kinds of visibility of global values.
Definition GlobalValue.h:67
@ HiddenVisibility
The GV is hidden.
Definition GlobalValue.h:69
void setVisibility(VisibilityTypes V)
LinkageTypes
An enumeration for the kinds of linkage for global values.
Definition GlobalValue.h:52
@ PrivateLinkage
Like Internal, but omit from symbol table.
Definition GlobalValue.h:61
@ InternalLinkage
Rename collisions when linking (static functions).
Definition GlobalValue.h:60
@ ExternalLinkage
Externally visible function.
Definition GlobalValue.h:53
@ ExternalWeakLinkage
ExternalWeak linkage description.
Definition GlobalValue.h:62
Type * getValueType() const
const Constant * getInitializer() const
getInitializer - Return the initializer for this global variable.
LLVM_ABI void setInitializer(Constant *InitVal)
setInitializer - Sets the initializer for this global variable, removing any existing initializer if ...
Definition Globals.cpp:613
bool hasInitializer() const
Definitions have initializers, declarations don't.
MaybeAlign getAlign() const
Returns the alignment of the given variable.
void setConstant(bool Val)
LLVM_ABI void setCodeModel(CodeModel::Model CM)
Change the code model for this global.
Definition Globals.cpp:660
LLVM_ABI void eraseFromParent()
eraseFromParent - This method unlinks 'this' from the containing module and deletes it.
Definition Globals.cpp:609
This provides a uniform API for creating instructions and inserting them into a basic block: either a...
Definition IRBuilder.h:2893
static LLVM_ABI InlineAsm * get(FunctionType *Ty, StringRef AsmString, StringRef Constraints, bool hasSideEffects, bool isAlignStack=false, AsmDialect asmDialect=AD_ATT, bool canThrow=false)
InlineAsm::get - Return the specified uniqued inline asm string.
Definition InlineAsm.cpp:43
LLVM_ABI InstListType::iterator eraseFromParent()
This method unlinks 'this' from the containing basic block and deletes it.
Analysis pass that exposes the LoopInfo for a function.
Definition LoopInfo.h:587
LLVM_ABI PreservedAnalyses run(Module &M, ModuleAnalysisManager &AM)
Metadata node.
Definition Metadata.h:1069
const MDOperand & getOperand(unsigned I) const
Definition Metadata.h:1426
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
Definition Metadata.h:1565
unsigned getNumOperands() const
Return number of MDNode operands.
Definition Metadata.h:1432
Metadata * get() const
Definition Metadata.h:920
static LLVM_ABI MDString * get(LLVMContext &Context, StringRef Str)
Definition Metadata.cpp:614
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
Definition Metadata.h:1511
std::pair< iterator, bool > insert(const std::pair< KeyT, ValueT > &KV)
Definition MapVector.h:126
static ErrorOr< std::unique_ptr< MemoryBuffer > > getFile(const Twine &Filename, bool IsText=false, bool RequiresNullTerminator=true, bool IsVolatile=false, std::optional< Align > Alignment=std::nullopt)
Open the specified file as a MemoryBuffer, returning a new MemoryBuffer if successful,...
Root of the metadata hierarchy.
Definition Metadata.h:64
TypeIdSummary & getOrInsertTypeIdSummary(StringRef TypeId)
Return an existing or new TypeIdSummary entry for TypeId.
const TypeIdSummary * getTypeIdSummary(StringRef TypeId) const
This returns either a pointer to the type id summary (if present in the summary map) or null (if not ...
CfiFunctionIndex & cfiFunctionDecls()
CfiFunctionIndex & cfiFunctionDefs()
A Module instance is used to store all the information related to an LLVM module.
Definition Module.h:67
iterator_range< op_iterator > operands()
Definition Metadata.h:1849
static PointerType * getUnqual(Type *ElementType)
This constructs a pointer to an object of the specified type in the default address space (address sp...
unsigned getAddressSpace() const
Return the address space of the Pointer type.
Analysis pass which computes a PostDominatorTree.
A set of analyses that are preserved following a run of a transformation pass.
Definition Analysis.h:112
static PreservedAnalyses none()
Convenience factory function for the empty preserved set.
Definition Analysis.h:115
static PreservedAnalyses all()
Construct a special preserved set that preserves all passes.
Definition Analysis.h:118
PreservedAnalyses & preserve()
Mark an analysis as preserved.
Definition Analysis.h:132
static ReturnInst * Create(LLVMContext &C, Value *retVal=nullptr, InsertPosition InsertBefore=nullptr)
bool insert(const value_type &X)
Insert a new element into the SetVector.
Definition SetVector.h:151
LLVM_ABI PreservedAnalyses run(Module &M, ModuleAnalysisManager &AM)
reference emplace_back(ArgTypes &&... Args)
void reserve(size_type N)
iterator erase(const_iterator CI)
void resize(size_type N)
void push_back(const T &Elt)
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Represent a constant reference to a string, i.e.
Definition StringRef.h:56
std::pair< StringRef, StringRef > split(char Separator) const
Split into two substrings around the first occurrence of a separator character.
Definition StringRef.h:736
bool consume_back(StringRef Suffix)
Returns true if this StringRef has the given suffix and removes that suffix.
Definition StringRef.h:691
constexpr StringRef substr(size_t Start, size_t N=npos) const
Return a reference to the substring from [Start, Start + N).
Definition StringRef.h:597
bool starts_with(StringRef Prefix) const
Check if this string starts with the given Prefix.
Definition StringRef.h:258
constexpr size_t size() const
Get the string size.
Definition StringRef.h:144
bool ends_with(StringRef Suffix) const
Check if this string ends with the given Suffix.
Definition StringRef.h:270
Type * getElementType(unsigned N) const
Analysis pass providing the TargetTransformInfo.
See the file comment for details on the usage of the TrailingObjects type.
Triple - Helper class for working with autoconf configuration names.
Definition Triple.h:47
@ loongarch64
Definition Triple.h:65
The instances of the Type class are immutable: once they are created, they are never changed.
Definition Type.h:46
static LLVM_ABI Type * getVoidTy(LLVMContext &C)
Definition Type.cpp:282
A Use represents the edge between a Value definition and its users.
Definition Use.h:35
op_range operands()
Definition User.h:267
Value * getOperand(unsigned i) const
Definition User.h:207
LLVM Value Representation.
Definition Value.h:75
Type * getType() const
All values are typed, get the type of this value.
Definition Value.h:255
user_iterator user_begin()
Definition Value.h:402
bool hasOneUse() const
Return true if there is exactly one use of this value.
Definition Value.h:439
LLVM_ABI void replaceAllUsesWith(Value *V)
Change all uses of this to point to a new Value.
Definition Value.cpp:553
iterator_range< user_iterator > users()
Definition Value.h:426
use_iterator use_begin()
Definition Value.h:364
bool use_empty() const
Definition Value.h:346
LLVM_ABI bool replaceUsesWithIf(Value *New, llvm::function_ref< bool(Use &U)> ShouldReplace)
Go through the uses list for this definition and make each use point to "V" if the callback ShouldRep...
Definition Value.cpp:561
iterator_range< use_iterator > uses()
Definition Value.h:380
bool hasName() const
Definition Value.h:261
LLVM_ABI StringRef getName() const
Return a constant reference to the value's name.
Definition Value.cpp:319
LLVM_ABI void takeName(Value *V)
Transfer the name from V to this value.
Definition Value.cpp:400
std::pair< iterator, bool > insert(const ValueT &V)
Definition DenseSet.h:209
bool contains(const_arg_type_t< ValueT > V) const
Check if the set contains the given element.
Definition DenseSet.h:182
void insert_range(Range &&R)
Definition DenseSet.h:235
size_type count(const_arg_type_t< ValueT > V) const
Return 1 if the specified key is in the set, 0 otherwise.
Definition DenseSet.h:187
An efficient, type-erasing, non-owning reference to a callable.
const ParentTy * getParent() const
Definition ilist_node.h:34
self_iterator getIterator()
Definition ilist_node.h:123
NodeTy * getNextNode()
Get the next node, or nullptr for the list tail.
Definition ilist_node.h:348
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition raw_ostream.h:53
CallInst * Call
Changed
constexpr char Align[]
Key for Kernel::Arg::Metadata::mAlign.
constexpr char SymbolName[]
Key for Kernel::Metadata::mSymbolName.
constexpr std::underlying_type_t< E > Mask()
Get a bitmask with 1s in all places up to the high-order bit of E's largest value.
@ C
The default llvm calling convention, compatible with C.
Definition CallingConv.h:34
@ BasicBlock
Various leaf nodes.
Definition ISDOpcodes.h:81
LLVM_ABI Function * getDeclarationIfExists(const Module *M, ID id)
Look up the Function declaration of the intrinsic id in the Module M and return it if it exists.
ValuesClass values(OptsTy... Options)
Helper to build a ValuesClass by forwarding a variable number of arguments as an initializer list to ...
initializer< Ty > init(const Ty &Val)
LLVM_ABI bool isJumpTableCanonical(Function *F)
std::enable_if_t< detail::IsValidPointer< X, Y >::value, X * > extract_or_null(Y &&MD)
Extract a Value from Metadata, allowing null.
Definition Metadata.h:683
SmallVector< unsigned char, 0 > ByteArray
Definition PropertySet.h:25
NodeAddr< PhiNode * > Phi
Definition RDFGraph.h:392
NodeAddr< UseNode * > Use
Definition RDFGraph.h:387
@ OF_TextWithCRLF
The file should be opened in text mode and use a carriage linefeed '\r '.
Definition FileSystem.h:804
This is an optimization pass for GlobalISel generic memory operations.
LLVM_ABI void ReplaceInstWithInst(BasicBlock *BB, BasicBlock::iterator &BI, Instruction *I)
Replace the instruction specified by BI with the instruction specified by I.
@ Offset
Definition DWP.cpp:573
void stable_sort(R &&Range)
Definition STLExtras.h:2116
bool all_of(R &&range, UnaryPredicate P)
Provide wrappers to std::all_of which take ranges instead of having to pass begin/end explicitly.
Definition STLExtras.h:1739
detail::zip_longest_range< T, U, Args... > zip_longest(T &&t, U &&u, Args &&... args)
Iterate over two or more iterators at the same time.
Definition STLExtras.h:981
LLVM_ABI void setExplicitlyUnknownBranchWeightsIfProfiled(Instruction &I, StringRef PassName, const Function *F=nullptr)
Like setExplicitlyUnknownBranchWeights(...), but only sets unknown branch weights in the new instruct...
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:643
@ Export
Export information to summary.
Definition IPO.h:57
@ None
Do nothing.
Definition IPO.h:55
@ Import
Import information from summary.
Definition IPO.h:56
void append_range(Container &C, Range &&R)
Wrapper function to append range R to container C.
Definition STLExtras.h:2208
Value * GetPointerBaseWithConstantOffset(Value *Ptr, int64_t &Offset, const DataLayout &DL, bool AllowNonInbounds=true)
Analyze the specified pointer to see if it can be expressed as a base pointer plus a constant offset.
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:633
InnerAnalysisManagerProxy< FunctionAnalysisManager, Module > FunctionAnalysisManagerModuleProxy
Provide the FunctionAnalysisManager to Module proxy.
RelativeUniformCounterPtr ValuesPtrExpr VTableAddr Value
Definition InstrProf.h:143
int countr_zero(T Val)
Count number of 0's from the least significant bit to the most stopping at the first 1.
Definition bit.h:204
unsigned M1(unsigned Val)
Definition VE.h:377
LLVM_ABI bool convertUsersOfConstantsToInstructions(ArrayRef< Constant * > Consts, Function *RestrictToFunc=nullptr, bool RemoveDeadConstants=true, bool IncludeSelf=false)
Replace constant expressions users of the given constants with instructions.
void sort(IteratorTy Start, IteratorTy End)
Definition STLExtras.h:1636
LLVM_ABI raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition Debug.cpp:209
LLVM_ABI void report_fatal_error(Error Err, bool gen_crash_diag=true)
Definition Error.cpp:163
constexpr uint64_t alignTo(uint64_t Size, Align A)
Returns a multiple of A needed to store Size bytes.
Definition Alignment.h:144
class LLVM_GSL_OWNER SmallVector
Forward declaration of SmallVector so that calculateSmallVectorDefaultInlinedElements can reference s...
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...
Definition Casting.h:547
@ Ref
The access may reference the value stored in memory.
Definition ModRef.h:32
TargetTransformInfo TTI
IRBuilder(LLVMContext &, FolderTy, InserterTy, MDNode *, ArrayRef< OperandBundleDef >) -> IRBuilder< FolderTy, InserterTy >
LLVM_ABI void appendToCompilerUsed(Module &M, ArrayRef< GlobalValue * > Values)
Adds global values to the llvm.compiler.used list.
IntPtrTy
Definition InstrProf.h:82
DWARFExpression::Operation Op
Expected< T > errorOrToExpected(ErrorOr< T > &&EO)
Convert an ErrorOr<T> to an Expected<T>.
Definition Error.h:1261
ArrayRef(const T &OneElt) -> ArrayRef< T >
OutputIt copy(R &&Range, OutputIt Out)
Definition STLExtras.h:1885
constexpr unsigned BitWidth
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.
Definition Casting.h:559
LLVM_ABI Error errorCodeToError(std::error_code EC)
Helper for converting an std::error_code to a Error.
Definition Error.cpp:107
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 ...
BumpPtrAllocatorImpl<> BumpPtrAllocator
The standard BumpPtrAllocator which just uses the default template parameters.
Definition Allocator.h:390
LLVM_ABI void appendToUsed(Module &M, ArrayRef< GlobalValue * > Values)
Adds global values to the llvm.used list.
CfiFunctionLinkage
The type of CFI jumptable needed for a function.
@ CFL_WeakDeclaration
AnalysisManager< Module > ModuleAnalysisManager
Convenience typedef for the Module analysis manager.
Definition MIRParser.h:39
constexpr uint64_t NextPowerOf2(uint64_t A)
Returns the next power of two (in 64-bits) that is strictly greater than A.
Definition MathExtras.h:373
LLVM_ABI GlobalVariable * collectUsedGlobalVariables(const Module &M, SmallVectorImpl< GlobalValue * > &Vec, bool CompilerUsed)
Given "llvm.used" or "llvm.compiler.used" as a global name, collect the initializer elements of that ...
Definition Module.cpp:898
A CRTP mix-in to automatically provide informational APIs needed for passes.
Definition PassManager.h:89
TypeTestResolution TTRes
Kind
Specifies which kind of type check we should emit for this byte array.
@ Unknown
Unknown (analysis not performed, don't lower)
@ Single
Single element (last example in "Short Inline Bit Vectors")
@ Inline
Inlined bit vector ("Short Inline Bit Vectors")
@ Unsat
Unsatisfiable type (i.e. no global has this type metadata)
@ AllOnes
All-ones bit vector ("Eliminating Bit Vector Checks for All-Ones Bit Vectors")
@ ByteArray
Test a byte array (first example)
unsigned SizeM1BitWidth
Range of size-1 expressed as a bit width.
enum llvm::TypeTestResolution::Kind TheKind
SmallVector< uint64_t, 16 > Offsets
LLVM_ABI bool containsGlobalOffset(uint64_t Offset) const
LLVM_ABI void print(raw_ostream &OS) const
This class is used to build a byte array containing overlapping bit sets.
uint64_t BitAllocs[BitsPerByte]
The number of bytes allocated so far for each of the bits.
std::vector< uint8_t > Bytes
The byte array built so far.
LLVM_ABI void allocate(const std::set< uint64_t > &Bits, uint64_t BitSize, uint64_t &AllocByteOffset, uint8_t &AllocMask)
Allocate BitSize bits in the byte array where Bits contains the bits to set.
This class implements a layout algorithm for globals referenced by bit sets that tries to keep member...
std::vector< std::vector< uint64_t > > Fragments
The computed layout.
LLVM_ABI void addFragment(const std::set< uint64_t > &F)
Add F to the layout while trying to keep its indices contiguous.
std::vector< uint64_t > FragmentMap
Mapping from object index to fragment index.