1 2 //===-- AsmWriter.cpp - Printing LLVM as an assembly file -----------------===// 3 // 4 // The LLVM Compiler Infrastructure 5 // 6 // This file is distributed under the University of Illinois Open Source 7 // License. See LICENSE.TXT for details. 8 // 9 //===----------------------------------------------------------------------===// 10 // 11 // This library implements the functionality defined in llvm/IR/Writer.h 12 // 13 // Note that these routines must be extremely tolerant of various errors in the 14 // LLVM code, because it can be used for debugging transformations. 15 // 16 //===----------------------------------------------------------------------===// 17 18 #include "llvm/ADT/DenseMap.h" 19 #include "llvm/ADT/STLExtras.h" 20 #include "llvm/ADT/SetVector.h" 21 #include "llvm/ADT/SmallString.h" 22 #include "llvm/ADT/StringExtras.h" 23 #include "llvm/IR/AssemblyAnnotationWriter.h" 24 #include "llvm/IR/CFG.h" 25 #include "llvm/IR/CallingConv.h" 26 #include "llvm/IR/Constants.h" 27 #include "llvm/IR/DebugInfo.h" 28 #include "llvm/IR/DerivedTypes.h" 29 #include "llvm/IR/IRPrintingPasses.h" 30 #include "llvm/IR/InlineAsm.h" 31 #include "llvm/IR/IntrinsicInst.h" 32 #include "llvm/IR/LLVMContext.h" 33 #include "llvm/IR/Module.h" 34 #include "llvm/IR/ModuleSlotTracker.h" 35 #include "llvm/IR/Operator.h" 36 #include "llvm/IR/Statepoint.h" 37 #include "llvm/IR/TypeFinder.h" 38 #include "llvm/IR/UseListOrder.h" 39 #include "llvm/IR/ValueSymbolTable.h" 40 #include "llvm/Support/Debug.h" 41 #include "llvm/Support/Dwarf.h" 42 #include "llvm/Support/ErrorHandling.h" 43 #include "llvm/Support/Format.h" 44 #include "llvm/Support/FormattedStream.h" 45 #include "llvm/Support/MathExtras.h" 46 #include "llvm/Support/raw_ostream.h" 47 #include <algorithm> 48 #include <cctype> 49 using namespace llvm; 50 51 // Make virtual table appear in this compilation unit. 52 AssemblyAnnotationWriter::~AssemblyAnnotationWriter() {} 53 54 //===----------------------------------------------------------------------===// 55 // Helper Functions 56 //===----------------------------------------------------------------------===// 57 58 namespace { 59 struct OrderMap { 60 DenseMap<const Value *, std::pair<unsigned, bool>> IDs; 61 62 unsigned size() const { return IDs.size(); } 63 std::pair<unsigned, bool> &operator[](const Value *V) { return IDs[V]; } 64 std::pair<unsigned, bool> lookup(const Value *V) const { 65 return IDs.lookup(V); 66 } 67 void index(const Value *V) { 68 // Explicitly sequence get-size and insert-value operations to avoid UB. 69 unsigned ID = IDs.size() + 1; 70 IDs[V].first = ID; 71 } 72 }; 73 } 74 75 static void orderValue(const Value *V, OrderMap &OM) { 76 if (OM.lookup(V).first) 77 return; 78 79 if (const Constant *C = dyn_cast<Constant>(V)) 80 if (C->getNumOperands() && !isa<GlobalValue>(C)) 81 for (const Value *Op : C->operands()) 82 if (!isa<BasicBlock>(Op) && !isa<GlobalValue>(Op)) 83 orderValue(Op, OM); 84 85 // Note: we cannot cache this lookup above, since inserting into the map 86 // changes the map's size, and thus affects the other IDs. 87 OM.index(V); 88 } 89 90 static OrderMap orderModule(const Module *M) { 91 // This needs to match the order used by ValueEnumerator::ValueEnumerator() 92 // and ValueEnumerator::incorporateFunction(). 93 OrderMap OM; 94 95 for (const GlobalVariable &G : M->globals()) { 96 if (G.hasInitializer()) 97 if (!isa<GlobalValue>(G.getInitializer())) 98 orderValue(G.getInitializer(), OM); 99 orderValue(&G, OM); 100 } 101 for (const GlobalAlias &A : M->aliases()) { 102 if (!isa<GlobalValue>(A.getAliasee())) 103 orderValue(A.getAliasee(), OM); 104 orderValue(&A, OM); 105 } 106 for (const GlobalIFunc &I : M->ifuncs()) { 107 if (!isa<GlobalValue>(I.getResolver())) 108 orderValue(I.getResolver(), OM); 109 orderValue(&I, OM); 110 } 111 for (const Function &F : *M) { 112 for (const Use &U : F.operands()) 113 if (!isa<GlobalValue>(U.get())) 114 orderValue(U.get(), OM); 115 116 orderValue(&F, OM); 117 118 if (F.isDeclaration()) 119 continue; 120 121 for (const Argument &A : F.args()) 122 orderValue(&A, OM); 123 for (const BasicBlock &BB : F) { 124 orderValue(&BB, OM); 125 for (const Instruction &I : BB) { 126 for (const Value *Op : I.operands()) 127 if ((isa<Constant>(*Op) && !isa<GlobalValue>(*Op)) || 128 isa<InlineAsm>(*Op)) 129 orderValue(Op, OM); 130 orderValue(&I, OM); 131 } 132 } 133 } 134 return OM; 135 } 136 137 static void predictValueUseListOrderImpl(const Value *V, const Function *F, 138 unsigned ID, const OrderMap &OM, 139 UseListOrderStack &Stack) { 140 // Predict use-list order for this one. 141 typedef std::pair<const Use *, unsigned> Entry; 142 SmallVector<Entry, 64> List; 143 for (const Use &U : V->uses()) 144 // Check if this user will be serialized. 145 if (OM.lookup(U.getUser()).first) 146 List.push_back(std::make_pair(&U, List.size())); 147 148 if (List.size() < 2) 149 // We may have lost some users. 150 return; 151 152 bool GetsReversed = 153 !isa<GlobalVariable>(V) && !isa<Function>(V) && !isa<BasicBlock>(V); 154 if (auto *BA = dyn_cast<BlockAddress>(V)) 155 ID = OM.lookup(BA->getBasicBlock()).first; 156 std::sort(List.begin(), List.end(), [&](const Entry &L, const Entry &R) { 157 const Use *LU = L.first; 158 const Use *RU = R.first; 159 if (LU == RU) 160 return false; 161 162 auto LID = OM.lookup(LU->getUser()).first; 163 auto RID = OM.lookup(RU->getUser()).first; 164 165 // If ID is 4, then expect: 7 6 5 1 2 3. 166 if (LID < RID) { 167 if (GetsReversed) 168 if (RID <= ID) 169 return true; 170 return false; 171 } 172 if (RID < LID) { 173 if (GetsReversed) 174 if (LID <= ID) 175 return false; 176 return true; 177 } 178 179 // LID and RID are equal, so we have different operands of the same user. 180 // Assume operands are added in order for all instructions. 181 if (GetsReversed) 182 if (LID <= ID) 183 return LU->getOperandNo() < RU->getOperandNo(); 184 return LU->getOperandNo() > RU->getOperandNo(); 185 }); 186 187 if (std::is_sorted( 188 List.begin(), List.end(), 189 [](const Entry &L, const Entry &R) { return L.second < R.second; })) 190 // Order is already correct. 191 return; 192 193 // Store the shuffle. 194 Stack.emplace_back(V, F, List.size()); 195 assert(List.size() == Stack.back().Shuffle.size() && "Wrong size"); 196 for (size_t I = 0, E = List.size(); I != E; ++I) 197 Stack.back().Shuffle[I] = List[I].second; 198 } 199 200 static void predictValueUseListOrder(const Value *V, const Function *F, 201 OrderMap &OM, UseListOrderStack &Stack) { 202 auto &IDPair = OM[V]; 203 assert(IDPair.first && "Unmapped value"); 204 if (IDPair.second) 205 // Already predicted. 206 return; 207 208 // Do the actual prediction. 209 IDPair.second = true; 210 if (!V->use_empty() && std::next(V->use_begin()) != V->use_end()) 211 predictValueUseListOrderImpl(V, F, IDPair.first, OM, Stack); 212 213 // Recursive descent into constants. 214 if (const Constant *C = dyn_cast<Constant>(V)) 215 if (C->getNumOperands()) // Visit GlobalValues. 216 for (const Value *Op : C->operands()) 217 if (isa<Constant>(Op)) // Visit GlobalValues. 218 predictValueUseListOrder(Op, F, OM, Stack); 219 } 220 221 static UseListOrderStack predictUseListOrder(const Module *M) { 222 OrderMap OM = orderModule(M); 223 224 // Use-list orders need to be serialized after all the users have been added 225 // to a value, or else the shuffles will be incomplete. Store them per 226 // function in a stack. 227 // 228 // Aside from function order, the order of values doesn't matter much here. 229 UseListOrderStack Stack; 230 231 // We want to visit the functions backward now so we can list function-local 232 // constants in the last Function they're used in. Module-level constants 233 // have already been visited above. 234 for (const Function &F : make_range(M->rbegin(), M->rend())) { 235 if (F.isDeclaration()) 236 continue; 237 for (const BasicBlock &BB : F) 238 predictValueUseListOrder(&BB, &F, OM, Stack); 239 for (const Argument &A : F.args()) 240 predictValueUseListOrder(&A, &F, OM, Stack); 241 for (const BasicBlock &BB : F) 242 for (const Instruction &I : BB) 243 for (const Value *Op : I.operands()) 244 if (isa<Constant>(*Op) || isa<InlineAsm>(*Op)) // Visit GlobalValues. 245 predictValueUseListOrder(Op, &F, OM, Stack); 246 for (const BasicBlock &BB : F) 247 for (const Instruction &I : BB) 248 predictValueUseListOrder(&I, &F, OM, Stack); 249 } 250 251 // Visit globals last. 252 for (const GlobalVariable &G : M->globals()) 253 predictValueUseListOrder(&G, nullptr, OM, Stack); 254 for (const Function &F : *M) 255 predictValueUseListOrder(&F, nullptr, OM, Stack); 256 for (const GlobalAlias &A : M->aliases()) 257 predictValueUseListOrder(&A, nullptr, OM, Stack); 258 for (const GlobalIFunc &I : M->ifuncs()) 259 predictValueUseListOrder(&I, nullptr, OM, Stack); 260 for (const GlobalVariable &G : M->globals()) 261 if (G.hasInitializer()) 262 predictValueUseListOrder(G.getInitializer(), nullptr, OM, Stack); 263 for (const GlobalAlias &A : M->aliases()) 264 predictValueUseListOrder(A.getAliasee(), nullptr, OM, Stack); 265 for (const GlobalIFunc &I : M->ifuncs()) 266 predictValueUseListOrder(I.getResolver(), nullptr, OM, Stack); 267 for (const Function &F : *M) 268 for (const Use &U : F.operands()) 269 predictValueUseListOrder(U.get(), nullptr, OM, Stack); 270 271 return Stack; 272 } 273 274 static const Module *getModuleFromVal(const Value *V) { 275 if (const Argument *MA = dyn_cast<Argument>(V)) 276 return MA->getParent() ? MA->getParent()->getParent() : nullptr; 277 278 if (const BasicBlock *BB = dyn_cast<BasicBlock>(V)) 279 return BB->getParent() ? BB->getParent()->getParent() : nullptr; 280 281 if (const Instruction *I = dyn_cast<Instruction>(V)) { 282 const Function *M = I->getParent() ? I->getParent()->getParent() : nullptr; 283 return M ? M->getParent() : nullptr; 284 } 285 286 if (const GlobalValue *GV = dyn_cast<GlobalValue>(V)) 287 return GV->getParent(); 288 289 if (const auto *MAV = dyn_cast<MetadataAsValue>(V)) { 290 for (const User *U : MAV->users()) 291 if (isa<Instruction>(U)) 292 if (const Module *M = getModuleFromVal(U)) 293 return M; 294 return nullptr; 295 } 296 297 return nullptr; 298 } 299 300 static void PrintCallingConv(unsigned cc, raw_ostream &Out) { 301 switch (cc) { 302 default: Out << "cc" << cc; break; 303 case CallingConv::Fast: Out << "fastcc"; break; 304 case CallingConv::Cold: Out << "coldcc"; break; 305 case CallingConv::WebKit_JS: Out << "webkit_jscc"; break; 306 case CallingConv::AnyReg: Out << "anyregcc"; break; 307 case CallingConv::PreserveMost: Out << "preserve_mostcc"; break; 308 case CallingConv::PreserveAll: Out << "preserve_allcc"; break; 309 case CallingConv::CXX_FAST_TLS: Out << "cxx_fast_tlscc"; break; 310 case CallingConv::GHC: Out << "ghccc"; break; 311 case CallingConv::X86_StdCall: Out << "x86_stdcallcc"; break; 312 case CallingConv::X86_FastCall: Out << "x86_fastcallcc"; break; 313 case CallingConv::X86_ThisCall: Out << "x86_thiscallcc"; break; 314 case CallingConv::X86_RegCall: Out << "x86_regcallcc"; break; 315 case CallingConv::X86_VectorCall:Out << "x86_vectorcallcc"; break; 316 case CallingConv::Intel_OCL_BI: Out << "intel_ocl_bicc"; break; 317 case CallingConv::ARM_APCS: Out << "arm_apcscc"; break; 318 case CallingConv::ARM_AAPCS: Out << "arm_aapcscc"; break; 319 case CallingConv::ARM_AAPCS_VFP: Out << "arm_aapcs_vfpcc"; break; 320 case CallingConv::MSP430_INTR: Out << "msp430_intrcc"; break; 321 case CallingConv::AVR_INTR: Out << "avr_intrcc "; break; 322 case CallingConv::AVR_SIGNAL: Out << "avr_signalcc "; break; 323 case CallingConv::PTX_Kernel: Out << "ptx_kernel"; break; 324 case CallingConv::PTX_Device: Out << "ptx_device"; break; 325 case CallingConv::X86_64_SysV: Out << "x86_64_sysvcc"; break; 326 case CallingConv::X86_64_Win64: Out << "x86_64_win64cc"; break; 327 case CallingConv::SPIR_FUNC: Out << "spir_func"; break; 328 case CallingConv::SPIR_KERNEL: Out << "spir_kernel"; break; 329 case CallingConv::Swift: Out << "swiftcc"; break; 330 case CallingConv::X86_INTR: Out << "x86_intrcc"; break; 331 case CallingConv::HHVM: Out << "hhvmcc"; break; 332 case CallingConv::HHVM_C: Out << "hhvm_ccc"; break; 333 case CallingConv::AMDGPU_VS: Out << "amdgpu_vs"; break; 334 case CallingConv::AMDGPU_GS: Out << "amdgpu_gs"; break; 335 case CallingConv::AMDGPU_PS: Out << "amdgpu_ps"; break; 336 case CallingConv::AMDGPU_CS: Out << "amdgpu_cs"; break; 337 case CallingConv::AMDGPU_KERNEL: Out << "amdgpu_kernel"; break; 338 } 339 } 340 341 void llvm::PrintEscapedString(StringRef Name, raw_ostream &Out) { 342 for (unsigned i = 0, e = Name.size(); i != e; ++i) { 343 unsigned char C = Name[i]; 344 if (isprint(C) && C != '\\' && C != '"') 345 Out << C; 346 else 347 Out << '\\' << hexdigit(C >> 4) << hexdigit(C & 0x0F); 348 } 349 } 350 351 enum PrefixType { 352 GlobalPrefix, 353 ComdatPrefix, 354 LabelPrefix, 355 LocalPrefix, 356 NoPrefix 357 }; 358 359 void llvm::printLLVMNameWithoutPrefix(raw_ostream &OS, StringRef Name) { 360 assert(!Name.empty() && "Cannot get empty name!"); 361 362 // Scan the name to see if it needs quotes first. 363 bool NeedsQuotes = isdigit(static_cast<unsigned char>(Name[0])); 364 if (!NeedsQuotes) { 365 for (unsigned i = 0, e = Name.size(); i != e; ++i) { 366 // By making this unsigned, the value passed in to isalnum will always be 367 // in the range 0-255. This is important when building with MSVC because 368 // its implementation will assert. This situation can arise when dealing 369 // with UTF-8 multibyte characters. 370 unsigned char C = Name[i]; 371 if (!isalnum(static_cast<unsigned char>(C)) && C != '-' && C != '.' && 372 C != '_') { 373 NeedsQuotes = true; 374 break; 375 } 376 } 377 } 378 379 // If we didn't need any quotes, just write out the name in one blast. 380 if (!NeedsQuotes) { 381 OS << Name; 382 return; 383 } 384 385 // Okay, we need quotes. Output the quotes and escape any scary characters as 386 // needed. 387 OS << '"'; 388 PrintEscapedString(Name, OS); 389 OS << '"'; 390 } 391 392 /// Turn the specified name into an 'LLVM name', which is either prefixed with % 393 /// (if the string only contains simple characters) or is surrounded with ""'s 394 /// (if it has special chars in it). Print it out. 395 static void PrintLLVMName(raw_ostream &OS, StringRef Name, PrefixType Prefix) { 396 switch (Prefix) { 397 case NoPrefix: 398 break; 399 case GlobalPrefix: 400 OS << '@'; 401 break; 402 case ComdatPrefix: 403 OS << '$'; 404 break; 405 case LabelPrefix: 406 break; 407 case LocalPrefix: 408 OS << '%'; 409 break; 410 } 411 printLLVMNameWithoutPrefix(OS, Name); 412 } 413 414 /// Turn the specified name into an 'LLVM name', which is either prefixed with % 415 /// (if the string only contains simple characters) or is surrounded with ""'s 416 /// (if it has special chars in it). Print it out. 417 static void PrintLLVMName(raw_ostream &OS, const Value *V) { 418 PrintLLVMName(OS, V->getName(), 419 isa<GlobalValue>(V) ? GlobalPrefix : LocalPrefix); 420 } 421 422 423 namespace { 424 class TypePrinting { 425 TypePrinting(const TypePrinting &) = delete; 426 void operator=(const TypePrinting&) = delete; 427 public: 428 429 /// NamedTypes - The named types that are used by the current module. 430 TypeFinder NamedTypes; 431 432 /// NumberedTypes - The numbered types, along with their value. 433 DenseMap<StructType*, unsigned> NumberedTypes; 434 435 TypePrinting() = default; 436 437 void incorporateTypes(const Module &M); 438 439 void print(Type *Ty, raw_ostream &OS); 440 441 void printStructBody(StructType *Ty, raw_ostream &OS); 442 }; 443 } // namespace 444 445 void TypePrinting::incorporateTypes(const Module &M) { 446 NamedTypes.run(M, false); 447 448 // The list of struct types we got back includes all the struct types, split 449 // the unnamed ones out to a numbering and remove the anonymous structs. 450 unsigned NextNumber = 0; 451 452 std::vector<StructType*>::iterator NextToUse = NamedTypes.begin(), I, E; 453 for (I = NamedTypes.begin(), E = NamedTypes.end(); I != E; ++I) { 454 StructType *STy = *I; 455 456 // Ignore anonymous types. 457 if (STy->isLiteral()) 458 continue; 459 460 if (STy->getName().empty()) 461 NumberedTypes[STy] = NextNumber++; 462 else 463 *NextToUse++ = STy; 464 } 465 466 NamedTypes.erase(NextToUse, NamedTypes.end()); 467 } 468 469 470 /// CalcTypeName - Write the specified type to the specified raw_ostream, making 471 /// use of type names or up references to shorten the type name where possible. 472 void TypePrinting::print(Type *Ty, raw_ostream &OS) { 473 switch (Ty->getTypeID()) { 474 case Type::VoidTyID: OS << "void"; return; 475 case Type::HalfTyID: OS << "half"; return; 476 case Type::FloatTyID: OS << "float"; return; 477 case Type::DoubleTyID: OS << "double"; return; 478 case Type::X86_FP80TyID: OS << "x86_fp80"; return; 479 case Type::FP128TyID: OS << "fp128"; return; 480 case Type::PPC_FP128TyID: OS << "ppc_fp128"; return; 481 case Type::LabelTyID: OS << "label"; return; 482 case Type::MetadataTyID: OS << "metadata"; return; 483 case Type::X86_MMXTyID: OS << "x86_mmx"; return; 484 case Type::TokenTyID: OS << "token"; return; 485 case Type::IntegerTyID: 486 OS << 'i' << cast<IntegerType>(Ty)->getBitWidth(); 487 return; 488 489 case Type::FunctionTyID: { 490 FunctionType *FTy = cast<FunctionType>(Ty); 491 print(FTy->getReturnType(), OS); 492 OS << " ("; 493 for (FunctionType::param_iterator I = FTy->param_begin(), 494 E = FTy->param_end(); I != E; ++I) { 495 if (I != FTy->param_begin()) 496 OS << ", "; 497 print(*I, OS); 498 } 499 if (FTy->isVarArg()) { 500 if (FTy->getNumParams()) OS << ", "; 501 OS << "..."; 502 } 503 OS << ')'; 504 return; 505 } 506 case Type::StructTyID: { 507 StructType *STy = cast<StructType>(Ty); 508 509 if (STy->isLiteral()) 510 return printStructBody(STy, OS); 511 512 if (!STy->getName().empty()) 513 return PrintLLVMName(OS, STy->getName(), LocalPrefix); 514 515 DenseMap<StructType*, unsigned>::iterator I = NumberedTypes.find(STy); 516 if (I != NumberedTypes.end()) 517 OS << '%' << I->second; 518 else // Not enumerated, print the hex address. 519 OS << "%\"type " << STy << '\"'; 520 return; 521 } 522 case Type::PointerTyID: { 523 PointerType *PTy = cast<PointerType>(Ty); 524 print(PTy->getElementType(), OS); 525 if (unsigned AddressSpace = PTy->getAddressSpace()) 526 OS << " addrspace(" << AddressSpace << ')'; 527 OS << '*'; 528 return; 529 } 530 case Type::ArrayTyID: { 531 ArrayType *ATy = cast<ArrayType>(Ty); 532 OS << '[' << ATy->getNumElements() << " x "; 533 print(ATy->getElementType(), OS); 534 OS << ']'; 535 return; 536 } 537 case Type::VectorTyID: { 538 VectorType *PTy = cast<VectorType>(Ty); 539 OS << "<" << PTy->getNumElements() << " x "; 540 print(PTy->getElementType(), OS); 541 OS << '>'; 542 return; 543 } 544 } 545 llvm_unreachable("Invalid TypeID"); 546 } 547 548 void TypePrinting::printStructBody(StructType *STy, raw_ostream &OS) { 549 if (STy->isOpaque()) { 550 OS << "opaque"; 551 return; 552 } 553 554 if (STy->isPacked()) 555 OS << '<'; 556 557 if (STy->getNumElements() == 0) { 558 OS << "{}"; 559 } else { 560 StructType::element_iterator I = STy->element_begin(); 561 OS << "{ "; 562 print(*I++, OS); 563 for (StructType::element_iterator E = STy->element_end(); I != E; ++I) { 564 OS << ", "; 565 print(*I, OS); 566 } 567 568 OS << " }"; 569 } 570 if (STy->isPacked()) 571 OS << '>'; 572 } 573 574 namespace llvm { 575 //===----------------------------------------------------------------------===// 576 // SlotTracker Class: Enumerate slot numbers for unnamed values 577 //===----------------------------------------------------------------------===// 578 /// This class provides computation of slot numbers for LLVM Assembly writing. 579 /// 580 class SlotTracker { 581 public: 582 /// ValueMap - A mapping of Values to slot numbers. 583 typedef DenseMap<const Value*, unsigned> ValueMap; 584 585 private: 586 /// TheModule - The module for which we are holding slot numbers. 587 const Module* TheModule; 588 589 /// TheFunction - The function for which we are holding slot numbers. 590 const Function* TheFunction; 591 bool FunctionProcessed; 592 bool ShouldInitializeAllMetadata; 593 594 /// mMap - The slot map for the module level data. 595 ValueMap mMap; 596 unsigned mNext; 597 598 /// fMap - The slot map for the function level data. 599 ValueMap fMap; 600 unsigned fNext; 601 602 /// mdnMap - Map for MDNodes. 603 DenseMap<const MDNode*, unsigned> mdnMap; 604 unsigned mdnNext; 605 606 /// asMap - The slot map for attribute sets. 607 DenseMap<AttributeSet, unsigned> asMap; 608 unsigned asNext; 609 public: 610 /// Construct from a module. 611 /// 612 /// If \c ShouldInitializeAllMetadata, initializes all metadata in all 613 /// functions, giving correct numbering for metadata referenced only from 614 /// within a function (even if no functions have been initialized). 615 explicit SlotTracker(const Module *M, 616 bool ShouldInitializeAllMetadata = false); 617 /// Construct from a function, starting out in incorp state. 618 /// 619 /// If \c ShouldInitializeAllMetadata, initializes all metadata in all 620 /// functions, giving correct numbering for metadata referenced only from 621 /// within a function (even if no functions have been initialized). 622 explicit SlotTracker(const Function *F, 623 bool ShouldInitializeAllMetadata = false); 624 625 /// Return the slot number of the specified value in it's type 626 /// plane. If something is not in the SlotTracker, return -1. 627 int getLocalSlot(const Value *V); 628 int getGlobalSlot(const GlobalValue *V); 629 int getMetadataSlot(const MDNode *N); 630 int getAttributeGroupSlot(AttributeSet AS); 631 632 /// If you'd like to deal with a function instead of just a module, use 633 /// this method to get its data into the SlotTracker. 634 void incorporateFunction(const Function *F) { 635 TheFunction = F; 636 FunctionProcessed = false; 637 } 638 639 const Function *getFunction() const { return TheFunction; } 640 641 /// After calling incorporateFunction, use this method to remove the 642 /// most recently incorporated function from the SlotTracker. This 643 /// will reset the state of the machine back to just the module contents. 644 void purgeFunction(); 645 646 /// MDNode map iterators. 647 typedef DenseMap<const MDNode*, unsigned>::iterator mdn_iterator; 648 mdn_iterator mdn_begin() { return mdnMap.begin(); } 649 mdn_iterator mdn_end() { return mdnMap.end(); } 650 unsigned mdn_size() const { return mdnMap.size(); } 651 bool mdn_empty() const { return mdnMap.empty(); } 652 653 /// AttributeSet map iterators. 654 typedef DenseMap<AttributeSet, unsigned>::iterator as_iterator; 655 as_iterator as_begin() { return asMap.begin(); } 656 as_iterator as_end() { return asMap.end(); } 657 unsigned as_size() const { return asMap.size(); } 658 bool as_empty() const { return asMap.empty(); } 659 660 /// This function does the actual initialization. 661 inline void initialize(); 662 663 // Implementation Details 664 private: 665 /// CreateModuleSlot - Insert the specified GlobalValue* into the slot table. 666 void CreateModuleSlot(const GlobalValue *V); 667 668 /// CreateMetadataSlot - Insert the specified MDNode* into the slot table. 669 void CreateMetadataSlot(const MDNode *N); 670 671 /// CreateFunctionSlot - Insert the specified Value* into the slot table. 672 void CreateFunctionSlot(const Value *V); 673 674 /// \brief Insert the specified AttributeSet into the slot table. 675 void CreateAttributeSetSlot(AttributeSet AS); 676 677 /// Add all of the module level global variables (and their initializers) 678 /// and function declarations, but not the contents of those functions. 679 void processModule(); 680 681 /// Add all of the functions arguments, basic blocks, and instructions. 682 void processFunction(); 683 684 /// Add the metadata directly attached to a GlobalObject. 685 void processGlobalObjectMetadata(const GlobalObject &GO); 686 687 /// Add all of the metadata from a function. 688 void processFunctionMetadata(const Function &F); 689 690 /// Add all of the metadata from an instruction. 691 void processInstructionMetadata(const Instruction &I); 692 693 SlotTracker(const SlotTracker &) = delete; 694 void operator=(const SlotTracker &) = delete; 695 }; 696 } // namespace llvm 697 698 ModuleSlotTracker::ModuleSlotTracker(SlotTracker &Machine, const Module *M, 699 const Function *F) 700 : M(M), F(F), Machine(&Machine) {} 701 702 ModuleSlotTracker::ModuleSlotTracker(const Module *M, 703 bool ShouldInitializeAllMetadata) 704 : ShouldCreateStorage(M), 705 ShouldInitializeAllMetadata(ShouldInitializeAllMetadata), M(M) {} 706 707 ModuleSlotTracker::~ModuleSlotTracker() {} 708 709 SlotTracker *ModuleSlotTracker::getMachine() { 710 if (!ShouldCreateStorage) 711 return Machine; 712 713 ShouldCreateStorage = false; 714 MachineStorage = 715 llvm::make_unique<SlotTracker>(M, ShouldInitializeAllMetadata); 716 Machine = MachineStorage.get(); 717 return Machine; 718 } 719 720 void ModuleSlotTracker::incorporateFunction(const Function &F) { 721 // Using getMachine() may lazily create the slot tracker. 722 if (!getMachine()) 723 return; 724 725 // Nothing to do if this is the right function already. 726 if (this->F == &F) 727 return; 728 if (this->F) 729 Machine->purgeFunction(); 730 Machine->incorporateFunction(&F); 731 this->F = &F; 732 } 733 734 int ModuleSlotTracker::getLocalSlot(const Value *V) { 735 assert(F && "No function incorporated"); 736 return Machine->getLocalSlot(V); 737 } 738 739 static SlotTracker *createSlotTracker(const Value *V) { 740 if (const Argument *FA = dyn_cast<Argument>(V)) 741 return new SlotTracker(FA->getParent()); 742 743 if (const Instruction *I = dyn_cast<Instruction>(V)) 744 if (I->getParent()) 745 return new SlotTracker(I->getParent()->getParent()); 746 747 if (const BasicBlock *BB = dyn_cast<BasicBlock>(V)) 748 return new SlotTracker(BB->getParent()); 749 750 if (const GlobalVariable *GV = dyn_cast<GlobalVariable>(V)) 751 return new SlotTracker(GV->getParent()); 752 753 if (const GlobalAlias *GA = dyn_cast<GlobalAlias>(V)) 754 return new SlotTracker(GA->getParent()); 755 756 if (const GlobalIFunc *GIF = dyn_cast<GlobalIFunc>(V)) 757 return new SlotTracker(GIF->getParent()); 758 759 if (const Function *Func = dyn_cast<Function>(V)) 760 return new SlotTracker(Func); 761 762 return nullptr; 763 } 764 765 #if 0 766 #define ST_DEBUG(X) dbgs() << X 767 #else 768 #define ST_DEBUG(X) 769 #endif 770 771 // Module level constructor. Causes the contents of the Module (sans functions) 772 // to be added to the slot table. 773 SlotTracker::SlotTracker(const Module *M, bool ShouldInitializeAllMetadata) 774 : TheModule(M), TheFunction(nullptr), FunctionProcessed(false), 775 ShouldInitializeAllMetadata(ShouldInitializeAllMetadata), mNext(0), 776 fNext(0), mdnNext(0), asNext(0) {} 777 778 // Function level constructor. Causes the contents of the Module and the one 779 // function provided to be added to the slot table. 780 SlotTracker::SlotTracker(const Function *F, bool ShouldInitializeAllMetadata) 781 : TheModule(F ? F->getParent() : nullptr), TheFunction(F), 782 FunctionProcessed(false), 783 ShouldInitializeAllMetadata(ShouldInitializeAllMetadata), mNext(0), 784 fNext(0), mdnNext(0), asNext(0) {} 785 786 inline void SlotTracker::initialize() { 787 if (TheModule) { 788 processModule(); 789 TheModule = nullptr; ///< Prevent re-processing next time we're called. 790 } 791 792 if (TheFunction && !FunctionProcessed) 793 processFunction(); 794 } 795 796 // Iterate through all the global variables, functions, and global 797 // variable initializers and create slots for them. 798 void SlotTracker::processModule() { 799 ST_DEBUG("begin processModule!\n"); 800 801 // Add all of the unnamed global variables to the value table. 802 for (const GlobalVariable &Var : TheModule->globals()) { 803 if (!Var.hasName()) 804 CreateModuleSlot(&Var); 805 processGlobalObjectMetadata(Var); 806 } 807 808 for (const GlobalAlias &A : TheModule->aliases()) { 809 if (!A.hasName()) 810 CreateModuleSlot(&A); 811 } 812 813 for (const GlobalIFunc &I : TheModule->ifuncs()) { 814 if (!I.hasName()) 815 CreateModuleSlot(&I); 816 } 817 818 // Add metadata used by named metadata. 819 for (const NamedMDNode &NMD : TheModule->named_metadata()) { 820 for (unsigned i = 0, e = NMD.getNumOperands(); i != e; ++i) 821 CreateMetadataSlot(NMD.getOperand(i)); 822 } 823 824 for (const Function &F : *TheModule) { 825 if (!F.hasName()) 826 // Add all the unnamed functions to the table. 827 CreateModuleSlot(&F); 828 829 if (ShouldInitializeAllMetadata) 830 processFunctionMetadata(F); 831 832 // Add all the function attributes to the table. 833 // FIXME: Add attributes of other objects? 834 AttributeSet FnAttrs = F.getAttributes().getFnAttributes(); 835 if (FnAttrs.hasAttributes(AttributeSet::FunctionIndex)) 836 CreateAttributeSetSlot(FnAttrs); 837 } 838 839 ST_DEBUG("end processModule!\n"); 840 } 841 842 // Process the arguments, basic blocks, and instructions of a function. 843 void SlotTracker::processFunction() { 844 ST_DEBUG("begin processFunction!\n"); 845 fNext = 0; 846 847 // Process function metadata if it wasn't hit at the module-level. 848 if (!ShouldInitializeAllMetadata) 849 processFunctionMetadata(*TheFunction); 850 851 // Add all the function arguments with no names. 852 for(Function::const_arg_iterator AI = TheFunction->arg_begin(), 853 AE = TheFunction->arg_end(); AI != AE; ++AI) 854 if (!AI->hasName()) 855 CreateFunctionSlot(&*AI); 856 857 ST_DEBUG("Inserting Instructions:\n"); 858 859 // Add all of the basic blocks and instructions with no names. 860 for (auto &BB : *TheFunction) { 861 if (!BB.hasName()) 862 CreateFunctionSlot(&BB); 863 864 for (auto &I : BB) { 865 if (!I.getType()->isVoidTy() && !I.hasName()) 866 CreateFunctionSlot(&I); 867 868 // We allow direct calls to any llvm.foo function here, because the 869 // target may not be linked into the optimizer. 870 if (const CallInst *CI = dyn_cast<CallInst>(&I)) { 871 // Add all the call attributes to the table. 872 AttributeSet Attrs = CI->getAttributes().getFnAttributes(); 873 if (Attrs.hasAttributes(AttributeSet::FunctionIndex)) 874 CreateAttributeSetSlot(Attrs); 875 } else if (const InvokeInst *II = dyn_cast<InvokeInst>(&I)) { 876 // Add all the call attributes to the table. 877 AttributeSet Attrs = II->getAttributes().getFnAttributes(); 878 if (Attrs.hasAttributes(AttributeSet::FunctionIndex)) 879 CreateAttributeSetSlot(Attrs); 880 } 881 } 882 } 883 884 FunctionProcessed = true; 885 886 ST_DEBUG("end processFunction!\n"); 887 } 888 889 void SlotTracker::processGlobalObjectMetadata(const GlobalObject &GO) { 890 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 891 GO.getAllMetadata(MDs); 892 for (auto &MD : MDs) 893 CreateMetadataSlot(MD.second); 894 } 895 896 void SlotTracker::processFunctionMetadata(const Function &F) { 897 processGlobalObjectMetadata(F); 898 for (auto &BB : F) { 899 for (auto &I : BB) 900 processInstructionMetadata(I); 901 } 902 } 903 904 void SlotTracker::processInstructionMetadata(const Instruction &I) { 905 // Process metadata used directly by intrinsics. 906 if (const CallInst *CI = dyn_cast<CallInst>(&I)) 907 if (Function *F = CI->getCalledFunction()) 908 if (F->isIntrinsic()) 909 for (auto &Op : I.operands()) 910 if (auto *V = dyn_cast_or_null<MetadataAsValue>(Op)) 911 if (MDNode *N = dyn_cast<MDNode>(V->getMetadata())) 912 CreateMetadataSlot(N); 913 914 // Process metadata attached to this instruction. 915 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 916 I.getAllMetadata(MDs); 917 for (auto &MD : MDs) 918 CreateMetadataSlot(MD.second); 919 } 920 921 /// Clean up after incorporating a function. This is the only way to get out of 922 /// the function incorporation state that affects get*Slot/Create*Slot. Function 923 /// incorporation state is indicated by TheFunction != 0. 924 void SlotTracker::purgeFunction() { 925 ST_DEBUG("begin purgeFunction!\n"); 926 fMap.clear(); // Simply discard the function level map 927 TheFunction = nullptr; 928 FunctionProcessed = false; 929 ST_DEBUG("end purgeFunction!\n"); 930 } 931 932 /// getGlobalSlot - Get the slot number of a global value. 933 int SlotTracker::getGlobalSlot(const GlobalValue *V) { 934 // Check for uninitialized state and do lazy initialization. 935 initialize(); 936 937 // Find the value in the module map 938 ValueMap::iterator MI = mMap.find(V); 939 return MI == mMap.end() ? -1 : (int)MI->second; 940 } 941 942 /// getMetadataSlot - Get the slot number of a MDNode. 943 int SlotTracker::getMetadataSlot(const MDNode *N) { 944 // Check for uninitialized state and do lazy initialization. 945 initialize(); 946 947 // Find the MDNode in the module map 948 mdn_iterator MI = mdnMap.find(N); 949 return MI == mdnMap.end() ? -1 : (int)MI->second; 950 } 951 952 953 /// getLocalSlot - Get the slot number for a value that is local to a function. 954 int SlotTracker::getLocalSlot(const Value *V) { 955 assert(!isa<Constant>(V) && "Can't get a constant or global slot with this!"); 956 957 // Check for uninitialized state and do lazy initialization. 958 initialize(); 959 960 ValueMap::iterator FI = fMap.find(V); 961 return FI == fMap.end() ? -1 : (int)FI->second; 962 } 963 964 int SlotTracker::getAttributeGroupSlot(AttributeSet AS) { 965 // Check for uninitialized state and do lazy initialization. 966 initialize(); 967 968 // Find the AttributeSet in the module map. 969 as_iterator AI = asMap.find(AS); 970 return AI == asMap.end() ? -1 : (int)AI->second; 971 } 972 973 /// CreateModuleSlot - Insert the specified GlobalValue* into the slot table. 974 void SlotTracker::CreateModuleSlot(const GlobalValue *V) { 975 assert(V && "Can't insert a null Value into SlotTracker!"); 976 assert(!V->getType()->isVoidTy() && "Doesn't need a slot!"); 977 assert(!V->hasName() && "Doesn't need a slot!"); 978 979 unsigned DestSlot = mNext++; 980 mMap[V] = DestSlot; 981 982 ST_DEBUG(" Inserting value [" << V->getType() << "] = " << V << " slot=" << 983 DestSlot << " ["); 984 // G = Global, F = Function, A = Alias, I = IFunc, o = other 985 ST_DEBUG((isa<GlobalVariable>(V) ? 'G' : 986 (isa<Function>(V) ? 'F' : 987 (isa<GlobalAlias>(V) ? 'A' : 988 (isa<GlobalIFunc>(V) ? 'I' : 'o')))) << "]\n"); 989 } 990 991 /// CreateSlot - Create a new slot for the specified value if it has no name. 992 void SlotTracker::CreateFunctionSlot(const Value *V) { 993 assert(!V->getType()->isVoidTy() && !V->hasName() && "Doesn't need a slot!"); 994 995 unsigned DestSlot = fNext++; 996 fMap[V] = DestSlot; 997 998 // G = Global, F = Function, o = other 999 ST_DEBUG(" Inserting value [" << V->getType() << "] = " << V << " slot=" << 1000 DestSlot << " [o]\n"); 1001 } 1002 1003 /// CreateModuleSlot - Insert the specified MDNode* into the slot table. 1004 void SlotTracker::CreateMetadataSlot(const MDNode *N) { 1005 assert(N && "Can't insert a null Value into SlotTracker!"); 1006 1007 unsigned DestSlot = mdnNext; 1008 if (!mdnMap.insert(std::make_pair(N, DestSlot)).second) 1009 return; 1010 ++mdnNext; 1011 1012 // Recursively add any MDNodes referenced by operands. 1013 for (unsigned i = 0, e = N->getNumOperands(); i != e; ++i) 1014 if (const MDNode *Op = dyn_cast_or_null<MDNode>(N->getOperand(i))) 1015 CreateMetadataSlot(Op); 1016 } 1017 1018 void SlotTracker::CreateAttributeSetSlot(AttributeSet AS) { 1019 assert(AS.hasAttributes(AttributeSet::FunctionIndex) && 1020 "Doesn't need a slot!"); 1021 1022 as_iterator I = asMap.find(AS); 1023 if (I != asMap.end()) 1024 return; 1025 1026 unsigned DestSlot = asNext++; 1027 asMap[AS] = DestSlot; 1028 } 1029 1030 //===----------------------------------------------------------------------===// 1031 // AsmWriter Implementation 1032 //===----------------------------------------------------------------------===// 1033 1034 static void WriteAsOperandInternal(raw_ostream &Out, const Value *V, 1035 TypePrinting *TypePrinter, 1036 SlotTracker *Machine, 1037 const Module *Context); 1038 1039 static void WriteAsOperandInternal(raw_ostream &Out, const Metadata *MD, 1040 TypePrinting *TypePrinter, 1041 SlotTracker *Machine, const Module *Context, 1042 bool FromValue = false); 1043 1044 static void writeAtomicRMWOperation(raw_ostream &Out, 1045 AtomicRMWInst::BinOp Op) { 1046 switch (Op) { 1047 default: Out << " <unknown operation " << Op << ">"; break; 1048 case AtomicRMWInst::Xchg: Out << " xchg"; break; 1049 case AtomicRMWInst::Add: Out << " add"; break; 1050 case AtomicRMWInst::Sub: Out << " sub"; break; 1051 case AtomicRMWInst::And: Out << " and"; break; 1052 case AtomicRMWInst::Nand: Out << " nand"; break; 1053 case AtomicRMWInst::Or: Out << " or"; break; 1054 case AtomicRMWInst::Xor: Out << " xor"; break; 1055 case AtomicRMWInst::Max: Out << " max"; break; 1056 case AtomicRMWInst::Min: Out << " min"; break; 1057 case AtomicRMWInst::UMax: Out << " umax"; break; 1058 case AtomicRMWInst::UMin: Out << " umin"; break; 1059 } 1060 } 1061 1062 static void WriteOptimizationInfo(raw_ostream &Out, const User *U) { 1063 if (const FPMathOperator *FPO = dyn_cast<const FPMathOperator>(U)) { 1064 // Unsafe algebra implies all the others, no need to write them all out 1065 if (FPO->hasUnsafeAlgebra()) 1066 Out << " fast"; 1067 else { 1068 if (FPO->hasNoNaNs()) 1069 Out << " nnan"; 1070 if (FPO->hasNoInfs()) 1071 Out << " ninf"; 1072 if (FPO->hasNoSignedZeros()) 1073 Out << " nsz"; 1074 if (FPO->hasAllowReciprocal()) 1075 Out << " arcp"; 1076 } 1077 } 1078 1079 if (const OverflowingBinaryOperator *OBO = 1080 dyn_cast<OverflowingBinaryOperator>(U)) { 1081 if (OBO->hasNoUnsignedWrap()) 1082 Out << " nuw"; 1083 if (OBO->hasNoSignedWrap()) 1084 Out << " nsw"; 1085 } else if (const PossiblyExactOperator *Div = 1086 dyn_cast<PossiblyExactOperator>(U)) { 1087 if (Div->isExact()) 1088 Out << " exact"; 1089 } else if (const GEPOperator *GEP = dyn_cast<GEPOperator>(U)) { 1090 if (GEP->isInBounds()) 1091 Out << " inbounds"; 1092 } 1093 } 1094 1095 static void WriteConstantInternal(raw_ostream &Out, const Constant *CV, 1096 TypePrinting &TypePrinter, 1097 SlotTracker *Machine, 1098 const Module *Context) { 1099 if (const ConstantInt *CI = dyn_cast<ConstantInt>(CV)) { 1100 if (CI->getType()->isIntegerTy(1)) { 1101 Out << (CI->getZExtValue() ? "true" : "false"); 1102 return; 1103 } 1104 Out << CI->getValue(); 1105 return; 1106 } 1107 1108 if (const ConstantFP *CFP = dyn_cast<ConstantFP>(CV)) { 1109 if (&CFP->getValueAPF().getSemantics() == &APFloat::IEEEsingle || 1110 &CFP->getValueAPF().getSemantics() == &APFloat::IEEEdouble) { 1111 // We would like to output the FP constant value in exponential notation, 1112 // but we cannot do this if doing so will lose precision. Check here to 1113 // make sure that we only output it in exponential format if we can parse 1114 // the value back and get the same value. 1115 // 1116 bool ignored; 1117 bool isDouble = &CFP->getValueAPF().getSemantics()==&APFloat::IEEEdouble; 1118 bool isInf = CFP->getValueAPF().isInfinity(); 1119 bool isNaN = CFP->getValueAPF().isNaN(); 1120 if (!isInf && !isNaN) { 1121 double Val = isDouble ? CFP->getValueAPF().convertToDouble() : 1122 CFP->getValueAPF().convertToFloat(); 1123 SmallString<128> StrVal; 1124 raw_svector_ostream(StrVal) << Val; 1125 1126 // Check to make sure that the stringized number is not some string like 1127 // "Inf" or NaN, that atof will accept, but the lexer will not. Check 1128 // that the string matches the "[-+]?[0-9]" regex. 1129 // 1130 if ((StrVal[0] >= '0' && StrVal[0] <= '9') || 1131 ((StrVal[0] == '-' || StrVal[0] == '+') && 1132 (StrVal[1] >= '0' && StrVal[1] <= '9'))) { 1133 // Reparse stringized version! 1134 if (APFloat(APFloat::IEEEdouble, StrVal).convertToDouble() == Val) { 1135 Out << StrVal; 1136 return; 1137 } 1138 } 1139 } 1140 // Otherwise we could not reparse it to exactly the same value, so we must 1141 // output the string in hexadecimal format! Note that loading and storing 1142 // floating point types changes the bits of NaNs on some hosts, notably 1143 // x86, so we must not use these types. 1144 static_assert(sizeof(double) == sizeof(uint64_t), 1145 "assuming that double is 64 bits!"); 1146 APFloat apf = CFP->getValueAPF(); 1147 // Floats are represented in ASCII IR as double, convert. 1148 if (!isDouble) 1149 apf.convert(APFloat::IEEEdouble, APFloat::rmNearestTiesToEven, 1150 &ignored); 1151 Out << format_hex(apf.bitcastToAPInt().getZExtValue(), 0, /*Upper=*/true); 1152 return; 1153 } 1154 1155 // Either half, or some form of long double. 1156 // These appear as a magic letter identifying the type, then a 1157 // fixed number of hex digits. 1158 Out << "0x"; 1159 APInt API = CFP->getValueAPF().bitcastToAPInt(); 1160 if (&CFP->getValueAPF().getSemantics() == &APFloat::x87DoubleExtended) { 1161 Out << 'K'; 1162 Out << format_hex_no_prefix(API.getHiBits(16).getZExtValue(), 4, 1163 /*Upper=*/true); 1164 Out << format_hex_no_prefix(API.getLoBits(64).getZExtValue(), 16, 1165 /*Upper=*/true); 1166 return; 1167 } else if (&CFP->getValueAPF().getSemantics() == &APFloat::IEEEquad) { 1168 Out << 'L'; 1169 Out << format_hex_no_prefix(API.getLoBits(64).getZExtValue(), 16, 1170 /*Upper=*/true); 1171 Out << format_hex_no_prefix(API.getHiBits(64).getZExtValue(), 16, 1172 /*Upper=*/true); 1173 } else if (&CFP->getValueAPF().getSemantics() == &APFloat::PPCDoubleDouble) { 1174 Out << 'M'; 1175 Out << format_hex_no_prefix(API.getLoBits(64).getZExtValue(), 16, 1176 /*Upper=*/true); 1177 Out << format_hex_no_prefix(API.getHiBits(64).getZExtValue(), 16, 1178 /*Upper=*/true); 1179 } else if (&CFP->getValueAPF().getSemantics() == &APFloat::IEEEhalf) { 1180 Out << 'H'; 1181 Out << format_hex_no_prefix(API.getZExtValue(), 4, 1182 /*Upper=*/true); 1183 } else 1184 llvm_unreachable("Unsupported floating point type"); 1185 return; 1186 } 1187 1188 if (isa<ConstantAggregateZero>(CV)) { 1189 Out << "zeroinitializer"; 1190 return; 1191 } 1192 1193 if (const BlockAddress *BA = dyn_cast<BlockAddress>(CV)) { 1194 Out << "blockaddress("; 1195 WriteAsOperandInternal(Out, BA->getFunction(), &TypePrinter, Machine, 1196 Context); 1197 Out << ", "; 1198 WriteAsOperandInternal(Out, BA->getBasicBlock(), &TypePrinter, Machine, 1199 Context); 1200 Out << ")"; 1201 return; 1202 } 1203 1204 if (const ConstantArray *CA = dyn_cast<ConstantArray>(CV)) { 1205 Type *ETy = CA->getType()->getElementType(); 1206 Out << '['; 1207 TypePrinter.print(ETy, Out); 1208 Out << ' '; 1209 WriteAsOperandInternal(Out, CA->getOperand(0), 1210 &TypePrinter, Machine, 1211 Context); 1212 for (unsigned i = 1, e = CA->getNumOperands(); i != e; ++i) { 1213 Out << ", "; 1214 TypePrinter.print(ETy, Out); 1215 Out << ' '; 1216 WriteAsOperandInternal(Out, CA->getOperand(i), &TypePrinter, Machine, 1217 Context); 1218 } 1219 Out << ']'; 1220 return; 1221 } 1222 1223 if (const ConstantDataArray *CA = dyn_cast<ConstantDataArray>(CV)) { 1224 // As a special case, print the array as a string if it is an array of 1225 // i8 with ConstantInt values. 1226 if (CA->isString()) { 1227 Out << "c\""; 1228 PrintEscapedString(CA->getAsString(), Out); 1229 Out << '"'; 1230 return; 1231 } 1232 1233 Type *ETy = CA->getType()->getElementType(); 1234 Out << '['; 1235 TypePrinter.print(ETy, Out); 1236 Out << ' '; 1237 WriteAsOperandInternal(Out, CA->getElementAsConstant(0), 1238 &TypePrinter, Machine, 1239 Context); 1240 for (unsigned i = 1, e = CA->getNumElements(); i != e; ++i) { 1241 Out << ", "; 1242 TypePrinter.print(ETy, Out); 1243 Out << ' '; 1244 WriteAsOperandInternal(Out, CA->getElementAsConstant(i), &TypePrinter, 1245 Machine, Context); 1246 } 1247 Out << ']'; 1248 return; 1249 } 1250 1251 1252 if (const ConstantStruct *CS = dyn_cast<ConstantStruct>(CV)) { 1253 if (CS->getType()->isPacked()) 1254 Out << '<'; 1255 Out << '{'; 1256 unsigned N = CS->getNumOperands(); 1257 if (N) { 1258 Out << ' '; 1259 TypePrinter.print(CS->getOperand(0)->getType(), Out); 1260 Out << ' '; 1261 1262 WriteAsOperandInternal(Out, CS->getOperand(0), &TypePrinter, Machine, 1263 Context); 1264 1265 for (unsigned i = 1; i < N; i++) { 1266 Out << ", "; 1267 TypePrinter.print(CS->getOperand(i)->getType(), Out); 1268 Out << ' '; 1269 1270 WriteAsOperandInternal(Out, CS->getOperand(i), &TypePrinter, Machine, 1271 Context); 1272 } 1273 Out << ' '; 1274 } 1275 1276 Out << '}'; 1277 if (CS->getType()->isPacked()) 1278 Out << '>'; 1279 return; 1280 } 1281 1282 if (isa<ConstantVector>(CV) || isa<ConstantDataVector>(CV)) { 1283 Type *ETy = CV->getType()->getVectorElementType(); 1284 Out << '<'; 1285 TypePrinter.print(ETy, Out); 1286 Out << ' '; 1287 WriteAsOperandInternal(Out, CV->getAggregateElement(0U), &TypePrinter, 1288 Machine, Context); 1289 for (unsigned i = 1, e = CV->getType()->getVectorNumElements(); i != e;++i){ 1290 Out << ", "; 1291 TypePrinter.print(ETy, Out); 1292 Out << ' '; 1293 WriteAsOperandInternal(Out, CV->getAggregateElement(i), &TypePrinter, 1294 Machine, Context); 1295 } 1296 Out << '>'; 1297 return; 1298 } 1299 1300 if (isa<ConstantPointerNull>(CV)) { 1301 Out << "null"; 1302 return; 1303 } 1304 1305 if (isa<ConstantTokenNone>(CV)) { 1306 Out << "none"; 1307 return; 1308 } 1309 1310 if (isa<UndefValue>(CV)) { 1311 Out << "undef"; 1312 return; 1313 } 1314 1315 if (const ConstantExpr *CE = dyn_cast<ConstantExpr>(CV)) { 1316 Out << CE->getOpcodeName(); 1317 WriteOptimizationInfo(Out, CE); 1318 if (CE->isCompare()) 1319 Out << ' ' << CmpInst::getPredicateName( 1320 static_cast<CmpInst::Predicate>(CE->getPredicate())); 1321 Out << " ("; 1322 1323 Optional<unsigned> InRangeOp; 1324 if (const GEPOperator *GEP = dyn_cast<GEPOperator>(CE)) { 1325 TypePrinter.print(GEP->getSourceElementType(), Out); 1326 Out << ", "; 1327 InRangeOp = GEP->getInRangeIndex(); 1328 if (InRangeOp) 1329 ++*InRangeOp; 1330 } 1331 1332 for (User::const_op_iterator OI=CE->op_begin(); OI != CE->op_end(); ++OI) { 1333 if (InRangeOp && unsigned(OI - CE->op_begin()) == *InRangeOp) 1334 Out << "inrange "; 1335 TypePrinter.print((*OI)->getType(), Out); 1336 Out << ' '; 1337 WriteAsOperandInternal(Out, *OI, &TypePrinter, Machine, Context); 1338 if (OI+1 != CE->op_end()) 1339 Out << ", "; 1340 } 1341 1342 if (CE->hasIndices()) { 1343 ArrayRef<unsigned> Indices = CE->getIndices(); 1344 for (unsigned i = 0, e = Indices.size(); i != e; ++i) 1345 Out << ", " << Indices[i]; 1346 } 1347 1348 if (CE->isCast()) { 1349 Out << " to "; 1350 TypePrinter.print(CE->getType(), Out); 1351 } 1352 1353 Out << ')'; 1354 return; 1355 } 1356 1357 Out << "<placeholder or erroneous Constant>"; 1358 } 1359 1360 static void writeMDTuple(raw_ostream &Out, const MDTuple *Node, 1361 TypePrinting *TypePrinter, SlotTracker *Machine, 1362 const Module *Context) { 1363 Out << "!{"; 1364 for (unsigned mi = 0, me = Node->getNumOperands(); mi != me; ++mi) { 1365 const Metadata *MD = Node->getOperand(mi); 1366 if (!MD) 1367 Out << "null"; 1368 else if (auto *MDV = dyn_cast<ValueAsMetadata>(MD)) { 1369 Value *V = MDV->getValue(); 1370 TypePrinter->print(V->getType(), Out); 1371 Out << ' '; 1372 WriteAsOperandInternal(Out, V, TypePrinter, Machine, Context); 1373 } else { 1374 WriteAsOperandInternal(Out, MD, TypePrinter, Machine, Context); 1375 } 1376 if (mi + 1 != me) 1377 Out << ", "; 1378 } 1379 1380 Out << "}"; 1381 } 1382 1383 namespace { 1384 struct FieldSeparator { 1385 bool Skip; 1386 const char *Sep; 1387 FieldSeparator(const char *Sep = ", ") : Skip(true), Sep(Sep) {} 1388 }; 1389 raw_ostream &operator<<(raw_ostream &OS, FieldSeparator &FS) { 1390 if (FS.Skip) { 1391 FS.Skip = false; 1392 return OS; 1393 } 1394 return OS << FS.Sep; 1395 } 1396 struct MDFieldPrinter { 1397 raw_ostream &Out; 1398 FieldSeparator FS; 1399 TypePrinting *TypePrinter; 1400 SlotTracker *Machine; 1401 const Module *Context; 1402 1403 explicit MDFieldPrinter(raw_ostream &Out) 1404 : Out(Out), TypePrinter(nullptr), Machine(nullptr), Context(nullptr) {} 1405 MDFieldPrinter(raw_ostream &Out, TypePrinting *TypePrinter, 1406 SlotTracker *Machine, const Module *Context) 1407 : Out(Out), TypePrinter(TypePrinter), Machine(Machine), Context(Context) { 1408 } 1409 void printTag(const DINode *N); 1410 void printMacinfoType(const DIMacroNode *N); 1411 void printString(StringRef Name, StringRef Value, 1412 bool ShouldSkipEmpty = true); 1413 void printMetadata(StringRef Name, const Metadata *MD, 1414 bool ShouldSkipNull = true); 1415 template <class IntTy> 1416 void printInt(StringRef Name, IntTy Int, bool ShouldSkipZero = true); 1417 void printBool(StringRef Name, bool Value, Optional<bool> Default = None); 1418 void printDIFlags(StringRef Name, DINode::DIFlags Flags); 1419 template <class IntTy, class Stringifier> 1420 void printDwarfEnum(StringRef Name, IntTy Value, Stringifier toString, 1421 bool ShouldSkipZero = true); 1422 void printEmissionKind(StringRef Name, DICompileUnit::DebugEmissionKind EK); 1423 }; 1424 } // end namespace 1425 1426 void MDFieldPrinter::printTag(const DINode *N) { 1427 Out << FS << "tag: "; 1428 auto Tag = dwarf::TagString(N->getTag()); 1429 if (!Tag.empty()) 1430 Out << Tag; 1431 else 1432 Out << N->getTag(); 1433 } 1434 1435 void MDFieldPrinter::printMacinfoType(const DIMacroNode *N) { 1436 Out << FS << "type: "; 1437 auto Type = dwarf::MacinfoString(N->getMacinfoType()); 1438 if (!Type.empty()) 1439 Out << Type; 1440 else 1441 Out << N->getMacinfoType(); 1442 } 1443 1444 void MDFieldPrinter::printString(StringRef Name, StringRef Value, 1445 bool ShouldSkipEmpty) { 1446 if (ShouldSkipEmpty && Value.empty()) 1447 return; 1448 1449 Out << FS << Name << ": \""; 1450 PrintEscapedString(Value, Out); 1451 Out << "\""; 1452 } 1453 1454 static void writeMetadataAsOperand(raw_ostream &Out, const Metadata *MD, 1455 TypePrinting *TypePrinter, 1456 SlotTracker *Machine, 1457 const Module *Context) { 1458 if (!MD) { 1459 Out << "null"; 1460 return; 1461 } 1462 WriteAsOperandInternal(Out, MD, TypePrinter, Machine, Context); 1463 } 1464 1465 void MDFieldPrinter::printMetadata(StringRef Name, const Metadata *MD, 1466 bool ShouldSkipNull) { 1467 if (ShouldSkipNull && !MD) 1468 return; 1469 1470 Out << FS << Name << ": "; 1471 writeMetadataAsOperand(Out, MD, TypePrinter, Machine, Context); 1472 } 1473 1474 template <class IntTy> 1475 void MDFieldPrinter::printInt(StringRef Name, IntTy Int, bool ShouldSkipZero) { 1476 if (ShouldSkipZero && !Int) 1477 return; 1478 1479 Out << FS << Name << ": " << Int; 1480 } 1481 1482 void MDFieldPrinter::printBool(StringRef Name, bool Value, 1483 Optional<bool> Default) { 1484 if (Default && Value == *Default) 1485 return; 1486 Out << FS << Name << ": " << (Value ? "true" : "false"); 1487 } 1488 1489 void MDFieldPrinter::printDIFlags(StringRef Name, DINode::DIFlags Flags) { 1490 if (!Flags) 1491 return; 1492 1493 Out << FS << Name << ": "; 1494 1495 SmallVector<DINode::DIFlags, 8> SplitFlags; 1496 auto Extra = DINode::splitFlags(Flags, SplitFlags); 1497 1498 FieldSeparator FlagsFS(" | "); 1499 for (auto F : SplitFlags) { 1500 auto StringF = DINode::getFlagString(F); 1501 assert(!StringF.empty() && "Expected valid flag"); 1502 Out << FlagsFS << StringF; 1503 } 1504 if (Extra || SplitFlags.empty()) 1505 Out << FlagsFS << Extra; 1506 } 1507 1508 void MDFieldPrinter::printEmissionKind(StringRef Name, 1509 DICompileUnit::DebugEmissionKind EK) { 1510 Out << FS << Name << ": " << DICompileUnit::EmissionKindString(EK); 1511 } 1512 1513 1514 template <class IntTy, class Stringifier> 1515 void MDFieldPrinter::printDwarfEnum(StringRef Name, IntTy Value, 1516 Stringifier toString, bool ShouldSkipZero) { 1517 if (!Value) 1518 return; 1519 1520 Out << FS << Name << ": "; 1521 auto S = toString(Value); 1522 if (!S.empty()) 1523 Out << S; 1524 else 1525 Out << Value; 1526 } 1527 1528 static void writeGenericDINode(raw_ostream &Out, const GenericDINode *N, 1529 TypePrinting *TypePrinter, SlotTracker *Machine, 1530 const Module *Context) { 1531 Out << "!GenericDINode("; 1532 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1533 Printer.printTag(N); 1534 Printer.printString("header", N->getHeader()); 1535 if (N->getNumDwarfOperands()) { 1536 Out << Printer.FS << "operands: {"; 1537 FieldSeparator IFS; 1538 for (auto &I : N->dwarf_operands()) { 1539 Out << IFS; 1540 writeMetadataAsOperand(Out, I, TypePrinter, Machine, Context); 1541 } 1542 Out << "}"; 1543 } 1544 Out << ")"; 1545 } 1546 1547 static void writeDILocation(raw_ostream &Out, const DILocation *DL, 1548 TypePrinting *TypePrinter, SlotTracker *Machine, 1549 const Module *Context) { 1550 Out << "!DILocation("; 1551 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1552 // Always output the line, since 0 is a relevant and important value for it. 1553 Printer.printInt("line", DL->getLine(), /* ShouldSkipZero */ false); 1554 Printer.printInt("column", DL->getColumn()); 1555 Printer.printMetadata("scope", DL->getRawScope(), /* ShouldSkipNull */ false); 1556 Printer.printMetadata("inlinedAt", DL->getRawInlinedAt()); 1557 Out << ")"; 1558 } 1559 1560 static void writeDISubrange(raw_ostream &Out, const DISubrange *N, 1561 TypePrinting *, SlotTracker *, const Module *) { 1562 Out << "!DISubrange("; 1563 MDFieldPrinter Printer(Out); 1564 Printer.printInt("count", N->getCount(), /* ShouldSkipZero */ false); 1565 Printer.printInt("lowerBound", N->getLowerBound()); 1566 Out << ")"; 1567 } 1568 1569 static void writeDIEnumerator(raw_ostream &Out, const DIEnumerator *N, 1570 TypePrinting *, SlotTracker *, const Module *) { 1571 Out << "!DIEnumerator("; 1572 MDFieldPrinter Printer(Out); 1573 Printer.printString("name", N->getName(), /* ShouldSkipEmpty */ false); 1574 Printer.printInt("value", N->getValue(), /* ShouldSkipZero */ false); 1575 Out << ")"; 1576 } 1577 1578 static void writeDIBasicType(raw_ostream &Out, const DIBasicType *N, 1579 TypePrinting *, SlotTracker *, const Module *) { 1580 Out << "!DIBasicType("; 1581 MDFieldPrinter Printer(Out); 1582 if (N->getTag() != dwarf::DW_TAG_base_type) 1583 Printer.printTag(N); 1584 Printer.printString("name", N->getName()); 1585 Printer.printInt("size", N->getSizeInBits()); 1586 Printer.printInt("align", N->getAlignInBits()); 1587 Printer.printDwarfEnum("encoding", N->getEncoding(), 1588 dwarf::AttributeEncodingString); 1589 Out << ")"; 1590 } 1591 1592 static void writeDIDerivedType(raw_ostream &Out, const DIDerivedType *N, 1593 TypePrinting *TypePrinter, SlotTracker *Machine, 1594 const Module *Context) { 1595 Out << "!DIDerivedType("; 1596 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1597 Printer.printTag(N); 1598 Printer.printString("name", N->getName()); 1599 Printer.printMetadata("scope", N->getRawScope()); 1600 Printer.printMetadata("file", N->getRawFile()); 1601 Printer.printInt("line", N->getLine()); 1602 Printer.printMetadata("baseType", N->getRawBaseType(), 1603 /* ShouldSkipNull */ false); 1604 Printer.printInt("size", N->getSizeInBits()); 1605 Printer.printInt("align", N->getAlignInBits()); 1606 Printer.printInt("offset", N->getOffsetInBits()); 1607 Printer.printDIFlags("flags", N->getFlags()); 1608 Printer.printMetadata("extraData", N->getRawExtraData()); 1609 Out << ")"; 1610 } 1611 1612 static void writeDICompositeType(raw_ostream &Out, const DICompositeType *N, 1613 TypePrinting *TypePrinter, 1614 SlotTracker *Machine, const Module *Context) { 1615 Out << "!DICompositeType("; 1616 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1617 Printer.printTag(N); 1618 Printer.printString("name", N->getName()); 1619 Printer.printMetadata("scope", N->getRawScope()); 1620 Printer.printMetadata("file", N->getRawFile()); 1621 Printer.printInt("line", N->getLine()); 1622 Printer.printMetadata("baseType", N->getRawBaseType()); 1623 Printer.printInt("size", N->getSizeInBits()); 1624 Printer.printInt("align", N->getAlignInBits()); 1625 Printer.printInt("offset", N->getOffsetInBits()); 1626 Printer.printDIFlags("flags", N->getFlags()); 1627 Printer.printMetadata("elements", N->getRawElements()); 1628 Printer.printDwarfEnum("runtimeLang", N->getRuntimeLang(), 1629 dwarf::LanguageString); 1630 Printer.printMetadata("vtableHolder", N->getRawVTableHolder()); 1631 Printer.printMetadata("templateParams", N->getRawTemplateParams()); 1632 Printer.printString("identifier", N->getIdentifier()); 1633 Out << ")"; 1634 } 1635 1636 static void writeDISubroutineType(raw_ostream &Out, const DISubroutineType *N, 1637 TypePrinting *TypePrinter, 1638 SlotTracker *Machine, const Module *Context) { 1639 Out << "!DISubroutineType("; 1640 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1641 Printer.printDIFlags("flags", N->getFlags()); 1642 Printer.printDwarfEnum("cc", N->getCC(), dwarf::ConventionString); 1643 Printer.printMetadata("types", N->getRawTypeArray(), 1644 /* ShouldSkipNull */ false); 1645 Out << ")"; 1646 } 1647 1648 static void writeDIFile(raw_ostream &Out, const DIFile *N, TypePrinting *, 1649 SlotTracker *, const Module *) { 1650 Out << "!DIFile("; 1651 MDFieldPrinter Printer(Out); 1652 Printer.printString("filename", N->getFilename(), 1653 /* ShouldSkipEmpty */ false); 1654 Printer.printString("directory", N->getDirectory(), 1655 /* ShouldSkipEmpty */ false); 1656 Out << ")"; 1657 } 1658 1659 static void writeDICompileUnit(raw_ostream &Out, const DICompileUnit *N, 1660 TypePrinting *TypePrinter, SlotTracker *Machine, 1661 const Module *Context) { 1662 Out << "!DICompileUnit("; 1663 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1664 Printer.printDwarfEnum("language", N->getSourceLanguage(), 1665 dwarf::LanguageString, /* ShouldSkipZero */ false); 1666 Printer.printMetadata("file", N->getRawFile(), /* ShouldSkipNull */ false); 1667 Printer.printString("producer", N->getProducer()); 1668 Printer.printBool("isOptimized", N->isOptimized()); 1669 Printer.printString("flags", N->getFlags()); 1670 Printer.printInt("runtimeVersion", N->getRuntimeVersion(), 1671 /* ShouldSkipZero */ false); 1672 Printer.printString("splitDebugFilename", N->getSplitDebugFilename()); 1673 Printer.printEmissionKind("emissionKind", N->getEmissionKind()); 1674 Printer.printMetadata("enums", N->getRawEnumTypes()); 1675 Printer.printMetadata("retainedTypes", N->getRawRetainedTypes()); 1676 Printer.printMetadata("globals", N->getRawGlobalVariables()); 1677 Printer.printMetadata("imports", N->getRawImportedEntities()); 1678 Printer.printMetadata("macros", N->getRawMacros()); 1679 Printer.printInt("dwoId", N->getDWOId()); 1680 Printer.printBool("splitDebugInlining", N->getSplitDebugInlining(), true); 1681 Out << ")"; 1682 } 1683 1684 static void writeDISubprogram(raw_ostream &Out, const DISubprogram *N, 1685 TypePrinting *TypePrinter, SlotTracker *Machine, 1686 const Module *Context) { 1687 Out << "!DISubprogram("; 1688 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1689 Printer.printString("name", N->getName()); 1690 Printer.printString("linkageName", N->getLinkageName()); 1691 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1692 Printer.printMetadata("file", N->getRawFile()); 1693 Printer.printInt("line", N->getLine()); 1694 Printer.printMetadata("type", N->getRawType()); 1695 Printer.printBool("isLocal", N->isLocalToUnit()); 1696 Printer.printBool("isDefinition", N->isDefinition()); 1697 Printer.printInt("scopeLine", N->getScopeLine()); 1698 Printer.printMetadata("containingType", N->getRawContainingType()); 1699 Printer.printDwarfEnum("virtuality", N->getVirtuality(), 1700 dwarf::VirtualityString); 1701 if (N->getVirtuality() != dwarf::DW_VIRTUALITY_none || 1702 N->getVirtualIndex() != 0) 1703 Printer.printInt("virtualIndex", N->getVirtualIndex(), false); 1704 Printer.printInt("thisAdjustment", N->getThisAdjustment()); 1705 Printer.printDIFlags("flags", N->getFlags()); 1706 Printer.printBool("isOptimized", N->isOptimized()); 1707 Printer.printMetadata("unit", N->getRawUnit()); 1708 Printer.printMetadata("templateParams", N->getRawTemplateParams()); 1709 Printer.printMetadata("declaration", N->getRawDeclaration()); 1710 Printer.printMetadata("variables", N->getRawVariables()); 1711 Out << ")"; 1712 } 1713 1714 static void writeDILexicalBlock(raw_ostream &Out, const DILexicalBlock *N, 1715 TypePrinting *TypePrinter, SlotTracker *Machine, 1716 const Module *Context) { 1717 Out << "!DILexicalBlock("; 1718 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1719 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1720 Printer.printMetadata("file", N->getRawFile()); 1721 Printer.printInt("line", N->getLine()); 1722 Printer.printInt("column", N->getColumn()); 1723 Out << ")"; 1724 } 1725 1726 static void writeDILexicalBlockFile(raw_ostream &Out, 1727 const DILexicalBlockFile *N, 1728 TypePrinting *TypePrinter, 1729 SlotTracker *Machine, 1730 const Module *Context) { 1731 Out << "!DILexicalBlockFile("; 1732 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1733 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1734 Printer.printMetadata("file", N->getRawFile()); 1735 Printer.printInt("discriminator", N->getDiscriminator(), 1736 /* ShouldSkipZero */ false); 1737 Out << ")"; 1738 } 1739 1740 static void writeDINamespace(raw_ostream &Out, const DINamespace *N, 1741 TypePrinting *TypePrinter, SlotTracker *Machine, 1742 const Module *Context) { 1743 Out << "!DINamespace("; 1744 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1745 Printer.printString("name", N->getName()); 1746 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1747 Printer.printMetadata("file", N->getRawFile()); 1748 Printer.printInt("line", N->getLine()); 1749 Printer.printBool("exportSymbols", N->getExportSymbols(), false); 1750 Out << ")"; 1751 } 1752 1753 static void writeDIMacro(raw_ostream &Out, const DIMacro *N, 1754 TypePrinting *TypePrinter, SlotTracker *Machine, 1755 const Module *Context) { 1756 Out << "!DIMacro("; 1757 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1758 Printer.printMacinfoType(N); 1759 Printer.printInt("line", N->getLine()); 1760 Printer.printString("name", N->getName()); 1761 Printer.printString("value", N->getValue()); 1762 Out << ")"; 1763 } 1764 1765 static void writeDIMacroFile(raw_ostream &Out, const DIMacroFile *N, 1766 TypePrinting *TypePrinter, SlotTracker *Machine, 1767 const Module *Context) { 1768 Out << "!DIMacroFile("; 1769 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1770 Printer.printInt("line", N->getLine()); 1771 Printer.printMetadata("file", N->getRawFile(), /* ShouldSkipNull */ false); 1772 Printer.printMetadata("nodes", N->getRawElements()); 1773 Out << ")"; 1774 } 1775 1776 static void writeDIModule(raw_ostream &Out, const DIModule *N, 1777 TypePrinting *TypePrinter, SlotTracker *Machine, 1778 const Module *Context) { 1779 Out << "!DIModule("; 1780 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1781 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1782 Printer.printString("name", N->getName()); 1783 Printer.printString("configMacros", N->getConfigurationMacros()); 1784 Printer.printString("includePath", N->getIncludePath()); 1785 Printer.printString("isysroot", N->getISysRoot()); 1786 Out << ")"; 1787 } 1788 1789 1790 static void writeDITemplateTypeParameter(raw_ostream &Out, 1791 const DITemplateTypeParameter *N, 1792 TypePrinting *TypePrinter, 1793 SlotTracker *Machine, 1794 const Module *Context) { 1795 Out << "!DITemplateTypeParameter("; 1796 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1797 Printer.printString("name", N->getName()); 1798 Printer.printMetadata("type", N->getRawType(), /* ShouldSkipNull */ false); 1799 Out << ")"; 1800 } 1801 1802 static void writeDITemplateValueParameter(raw_ostream &Out, 1803 const DITemplateValueParameter *N, 1804 TypePrinting *TypePrinter, 1805 SlotTracker *Machine, 1806 const Module *Context) { 1807 Out << "!DITemplateValueParameter("; 1808 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1809 if (N->getTag() != dwarf::DW_TAG_template_value_parameter) 1810 Printer.printTag(N); 1811 Printer.printString("name", N->getName()); 1812 Printer.printMetadata("type", N->getRawType()); 1813 Printer.printMetadata("value", N->getValue(), /* ShouldSkipNull */ false); 1814 Out << ")"; 1815 } 1816 1817 static void writeDIGlobalVariable(raw_ostream &Out, const DIGlobalVariable *N, 1818 TypePrinting *TypePrinter, 1819 SlotTracker *Machine, const Module *Context) { 1820 Out << "!DIGlobalVariable("; 1821 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1822 Printer.printString("name", N->getName()); 1823 Printer.printString("linkageName", N->getLinkageName()); 1824 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1825 Printer.printMetadata("file", N->getRawFile()); 1826 Printer.printInt("line", N->getLine()); 1827 Printer.printMetadata("type", N->getRawType()); 1828 Printer.printBool("isLocal", N->isLocalToUnit()); 1829 Printer.printBool("isDefinition", N->isDefinition()); 1830 Printer.printMetadata("expr", N->getExpr()); 1831 Printer.printMetadata("declaration", N->getRawStaticDataMemberDeclaration()); 1832 Printer.printInt("align", N->getAlignInBits()); 1833 Out << ")"; 1834 } 1835 1836 static void writeDILocalVariable(raw_ostream &Out, const DILocalVariable *N, 1837 TypePrinting *TypePrinter, 1838 SlotTracker *Machine, const Module *Context) { 1839 Out << "!DILocalVariable("; 1840 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1841 Printer.printString("name", N->getName()); 1842 Printer.printInt("arg", N->getArg()); 1843 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1844 Printer.printMetadata("file", N->getRawFile()); 1845 Printer.printInt("line", N->getLine()); 1846 Printer.printMetadata("type", N->getRawType()); 1847 Printer.printDIFlags("flags", N->getFlags()); 1848 Printer.printInt("align", N->getAlignInBits()); 1849 Out << ")"; 1850 } 1851 1852 static void writeDIExpression(raw_ostream &Out, const DIExpression *N, 1853 TypePrinting *TypePrinter, SlotTracker *Machine, 1854 const Module *Context) { 1855 Out << "!DIExpression("; 1856 FieldSeparator FS; 1857 if (N->isValid()) { 1858 for (auto I = N->expr_op_begin(), E = N->expr_op_end(); I != E; ++I) { 1859 auto OpStr = dwarf::OperationEncodingString(I->getOp()); 1860 assert(!OpStr.empty() && "Expected valid opcode"); 1861 1862 Out << FS << OpStr; 1863 for (unsigned A = 0, AE = I->getNumArgs(); A != AE; ++A) 1864 Out << FS << I->getArg(A); 1865 } 1866 } else { 1867 for (const auto &I : N->getElements()) 1868 Out << FS << I; 1869 } 1870 Out << ")"; 1871 } 1872 1873 static void writeDIObjCProperty(raw_ostream &Out, const DIObjCProperty *N, 1874 TypePrinting *TypePrinter, SlotTracker *Machine, 1875 const Module *Context) { 1876 Out << "!DIObjCProperty("; 1877 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1878 Printer.printString("name", N->getName()); 1879 Printer.printMetadata("file", N->getRawFile()); 1880 Printer.printInt("line", N->getLine()); 1881 Printer.printString("setter", N->getSetterName()); 1882 Printer.printString("getter", N->getGetterName()); 1883 Printer.printInt("attributes", N->getAttributes()); 1884 Printer.printMetadata("type", N->getRawType()); 1885 Out << ")"; 1886 } 1887 1888 static void writeDIImportedEntity(raw_ostream &Out, const DIImportedEntity *N, 1889 TypePrinting *TypePrinter, 1890 SlotTracker *Machine, const Module *Context) { 1891 Out << "!DIImportedEntity("; 1892 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1893 Printer.printTag(N); 1894 Printer.printString("name", N->getName()); 1895 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1896 Printer.printMetadata("entity", N->getRawEntity()); 1897 Printer.printInt("line", N->getLine()); 1898 Out << ")"; 1899 } 1900 1901 1902 static void WriteMDNodeBodyInternal(raw_ostream &Out, const MDNode *Node, 1903 TypePrinting *TypePrinter, 1904 SlotTracker *Machine, 1905 const Module *Context) { 1906 if (Node->isDistinct()) 1907 Out << "distinct "; 1908 else if (Node->isTemporary()) 1909 Out << "<temporary!> "; // Handle broken code. 1910 1911 switch (Node->getMetadataID()) { 1912 default: 1913 llvm_unreachable("Expected uniquable MDNode"); 1914 #define HANDLE_MDNODE_LEAF(CLASS) \ 1915 case Metadata::CLASS##Kind: \ 1916 write##CLASS(Out, cast<CLASS>(Node), TypePrinter, Machine, Context); \ 1917 break; 1918 #include "llvm/IR/Metadata.def" 1919 } 1920 } 1921 1922 // Full implementation of printing a Value as an operand with support for 1923 // TypePrinting, etc. 1924 static void WriteAsOperandInternal(raw_ostream &Out, const Value *V, 1925 TypePrinting *TypePrinter, 1926 SlotTracker *Machine, 1927 const Module *Context) { 1928 if (V->hasName()) { 1929 PrintLLVMName(Out, V); 1930 return; 1931 } 1932 1933 const Constant *CV = dyn_cast<Constant>(V); 1934 if (CV && !isa<GlobalValue>(CV)) { 1935 assert(TypePrinter && "Constants require TypePrinting!"); 1936 WriteConstantInternal(Out, CV, *TypePrinter, Machine, Context); 1937 return; 1938 } 1939 1940 if (const InlineAsm *IA = dyn_cast<InlineAsm>(V)) { 1941 Out << "asm "; 1942 if (IA->hasSideEffects()) 1943 Out << "sideeffect "; 1944 if (IA->isAlignStack()) 1945 Out << "alignstack "; 1946 // We don't emit the AD_ATT dialect as it's the assumed default. 1947 if (IA->getDialect() == InlineAsm::AD_Intel) 1948 Out << "inteldialect "; 1949 Out << '"'; 1950 PrintEscapedString(IA->getAsmString(), Out); 1951 Out << "\", \""; 1952 PrintEscapedString(IA->getConstraintString(), Out); 1953 Out << '"'; 1954 return; 1955 } 1956 1957 if (auto *MD = dyn_cast<MetadataAsValue>(V)) { 1958 WriteAsOperandInternal(Out, MD->getMetadata(), TypePrinter, Machine, 1959 Context, /* FromValue */ true); 1960 return; 1961 } 1962 1963 char Prefix = '%'; 1964 int Slot; 1965 // If we have a SlotTracker, use it. 1966 if (Machine) { 1967 if (const GlobalValue *GV = dyn_cast<GlobalValue>(V)) { 1968 Slot = Machine->getGlobalSlot(GV); 1969 Prefix = '@'; 1970 } else { 1971 Slot = Machine->getLocalSlot(V); 1972 1973 // If the local value didn't succeed, then we may be referring to a value 1974 // from a different function. Translate it, as this can happen when using 1975 // address of blocks. 1976 if (Slot == -1) 1977 if ((Machine = createSlotTracker(V))) { 1978 Slot = Machine->getLocalSlot(V); 1979 delete Machine; 1980 } 1981 } 1982 } else if ((Machine = createSlotTracker(V))) { 1983 // Otherwise, create one to get the # and then destroy it. 1984 if (const GlobalValue *GV = dyn_cast<GlobalValue>(V)) { 1985 Slot = Machine->getGlobalSlot(GV); 1986 Prefix = '@'; 1987 } else { 1988 Slot = Machine->getLocalSlot(V); 1989 } 1990 delete Machine; 1991 Machine = nullptr; 1992 } else { 1993 Slot = -1; 1994 } 1995 1996 if (Slot != -1) 1997 Out << Prefix << Slot; 1998 else 1999 Out << "<badref>"; 2000 } 2001 2002 static void WriteAsOperandInternal(raw_ostream &Out, const Metadata *MD, 2003 TypePrinting *TypePrinter, 2004 SlotTracker *Machine, const Module *Context, 2005 bool FromValue) { 2006 if (const MDNode *N = dyn_cast<MDNode>(MD)) { 2007 std::unique_ptr<SlotTracker> MachineStorage; 2008 if (!Machine) { 2009 MachineStorage = make_unique<SlotTracker>(Context); 2010 Machine = MachineStorage.get(); 2011 } 2012 int Slot = Machine->getMetadataSlot(N); 2013 if (Slot == -1) 2014 // Give the pointer value instead of "badref", since this comes up all 2015 // the time when debugging. 2016 Out << "<" << N << ">"; 2017 else 2018 Out << '!' << Slot; 2019 return; 2020 } 2021 2022 if (const MDString *MDS = dyn_cast<MDString>(MD)) { 2023 Out << "!\""; 2024 PrintEscapedString(MDS->getString(), Out); 2025 Out << '"'; 2026 return; 2027 } 2028 2029 auto *V = cast<ValueAsMetadata>(MD); 2030 assert(TypePrinter && "TypePrinter required for metadata values"); 2031 assert((FromValue || !isa<LocalAsMetadata>(V)) && 2032 "Unexpected function-local metadata outside of value argument"); 2033 2034 TypePrinter->print(V->getValue()->getType(), Out); 2035 Out << ' '; 2036 WriteAsOperandInternal(Out, V->getValue(), TypePrinter, Machine, Context); 2037 } 2038 2039 namespace { 2040 class AssemblyWriter { 2041 formatted_raw_ostream &Out; 2042 const Module *TheModule; 2043 std::unique_ptr<SlotTracker> SlotTrackerStorage; 2044 SlotTracker &Machine; 2045 TypePrinting TypePrinter; 2046 AssemblyAnnotationWriter *AnnotationWriter; 2047 SetVector<const Comdat *> Comdats; 2048 bool IsForDebug; 2049 bool ShouldPreserveUseListOrder; 2050 UseListOrderStack UseListOrders; 2051 SmallVector<StringRef, 8> MDNames; 2052 2053 public: 2054 /// Construct an AssemblyWriter with an external SlotTracker 2055 AssemblyWriter(formatted_raw_ostream &o, SlotTracker &Mac, const Module *M, 2056 AssemblyAnnotationWriter *AAW, bool IsForDebug, 2057 bool ShouldPreserveUseListOrder = false); 2058 2059 void printMDNodeBody(const MDNode *MD); 2060 void printNamedMDNode(const NamedMDNode *NMD); 2061 2062 void printModule(const Module *M); 2063 2064 void writeOperand(const Value *Op, bool PrintType); 2065 void writeParamOperand(const Value *Operand, AttributeSet Attrs,unsigned Idx); 2066 void writeOperandBundles(ImmutableCallSite CS); 2067 void writeAtomic(AtomicOrdering Ordering, SynchronizationScope SynchScope); 2068 void writeAtomicCmpXchg(AtomicOrdering SuccessOrdering, 2069 AtomicOrdering FailureOrdering, 2070 SynchronizationScope SynchScope); 2071 2072 void writeAllMDNodes(); 2073 void writeMDNode(unsigned Slot, const MDNode *Node); 2074 void writeAllAttributeGroups(); 2075 2076 void printTypeIdentities(); 2077 void printGlobal(const GlobalVariable *GV); 2078 void printIndirectSymbol(const GlobalIndirectSymbol *GIS); 2079 void printComdat(const Comdat *C); 2080 void printFunction(const Function *F); 2081 void printArgument(const Argument *FA, AttributeSet Attrs, unsigned Idx); 2082 void printBasicBlock(const BasicBlock *BB); 2083 void printInstructionLine(const Instruction &I); 2084 void printInstruction(const Instruction &I); 2085 2086 void printUseListOrder(const UseListOrder &Order); 2087 void printUseLists(const Function *F); 2088 2089 private: 2090 /// \brief Print out metadata attachments. 2091 void printMetadataAttachments( 2092 const SmallVectorImpl<std::pair<unsigned, MDNode *>> &MDs, 2093 StringRef Separator); 2094 2095 // printInfoComment - Print a little comment after the instruction indicating 2096 // which slot it occupies. 2097 void printInfoComment(const Value &V); 2098 2099 // printGCRelocateComment - print comment after call to the gc.relocate 2100 // intrinsic indicating base and derived pointer names. 2101 void printGCRelocateComment(const GCRelocateInst &Relocate); 2102 }; 2103 } // namespace 2104 2105 AssemblyWriter::AssemblyWriter(formatted_raw_ostream &o, SlotTracker &Mac, 2106 const Module *M, AssemblyAnnotationWriter *AAW, 2107 bool IsForDebug, bool ShouldPreserveUseListOrder) 2108 : Out(o), TheModule(M), Machine(Mac), AnnotationWriter(AAW), 2109 IsForDebug(IsForDebug), 2110 ShouldPreserveUseListOrder(ShouldPreserveUseListOrder) { 2111 if (!TheModule) 2112 return; 2113 TypePrinter.incorporateTypes(*TheModule); 2114 for (const GlobalObject &GO : TheModule->global_objects()) 2115 if (const Comdat *C = GO.getComdat()) 2116 Comdats.insert(C); 2117 } 2118 2119 void AssemblyWriter::writeOperand(const Value *Operand, bool PrintType) { 2120 if (!Operand) { 2121 Out << "<null operand!>"; 2122 return; 2123 } 2124 if (PrintType) { 2125 TypePrinter.print(Operand->getType(), Out); 2126 Out << ' '; 2127 } 2128 WriteAsOperandInternal(Out, Operand, &TypePrinter, &Machine, TheModule); 2129 } 2130 2131 void AssemblyWriter::writeAtomic(AtomicOrdering Ordering, 2132 SynchronizationScope SynchScope) { 2133 if (Ordering == AtomicOrdering::NotAtomic) 2134 return; 2135 2136 switch (SynchScope) { 2137 case SingleThread: Out << " singlethread"; break; 2138 case CrossThread: break; 2139 } 2140 2141 Out << " " << toIRString(Ordering); 2142 } 2143 2144 void AssemblyWriter::writeAtomicCmpXchg(AtomicOrdering SuccessOrdering, 2145 AtomicOrdering FailureOrdering, 2146 SynchronizationScope SynchScope) { 2147 assert(SuccessOrdering != AtomicOrdering::NotAtomic && 2148 FailureOrdering != AtomicOrdering::NotAtomic); 2149 2150 switch (SynchScope) { 2151 case SingleThread: Out << " singlethread"; break; 2152 case CrossThread: break; 2153 } 2154 2155 Out << " " << toIRString(SuccessOrdering); 2156 Out << " " << toIRString(FailureOrdering); 2157 } 2158 2159 void AssemblyWriter::writeParamOperand(const Value *Operand, 2160 AttributeSet Attrs, unsigned Idx) { 2161 if (!Operand) { 2162 Out << "<null operand!>"; 2163 return; 2164 } 2165 2166 // Print the type 2167 TypePrinter.print(Operand->getType(), Out); 2168 // Print parameter attributes list 2169 if (Attrs.hasAttributes(Idx)) 2170 Out << ' ' << Attrs.getAsString(Idx); 2171 Out << ' '; 2172 // Print the operand 2173 WriteAsOperandInternal(Out, Operand, &TypePrinter, &Machine, TheModule); 2174 } 2175 2176 void AssemblyWriter::writeOperandBundles(ImmutableCallSite CS) { 2177 if (!CS.hasOperandBundles()) 2178 return; 2179 2180 Out << " [ "; 2181 2182 bool FirstBundle = true; 2183 for (unsigned i = 0, e = CS.getNumOperandBundles(); i != e; ++i) { 2184 OperandBundleUse BU = CS.getOperandBundleAt(i); 2185 2186 if (!FirstBundle) 2187 Out << ", "; 2188 FirstBundle = false; 2189 2190 Out << '"'; 2191 PrintEscapedString(BU.getTagName(), Out); 2192 Out << '"'; 2193 2194 Out << '('; 2195 2196 bool FirstInput = true; 2197 for (const auto &Input : BU.Inputs) { 2198 if (!FirstInput) 2199 Out << ", "; 2200 FirstInput = false; 2201 2202 TypePrinter.print(Input->getType(), Out); 2203 Out << " "; 2204 WriteAsOperandInternal(Out, Input, &TypePrinter, &Machine, TheModule); 2205 } 2206 2207 Out << ')'; 2208 } 2209 2210 Out << " ]"; 2211 } 2212 2213 void AssemblyWriter::printModule(const Module *M) { 2214 Machine.initialize(); 2215 2216 if (ShouldPreserveUseListOrder) 2217 UseListOrders = predictUseListOrder(M); 2218 2219 if (!M->getModuleIdentifier().empty() && 2220 // Don't print the ID if it will start a new line (which would 2221 // require a comment char before it). 2222 M->getModuleIdentifier().find('\n') == std::string::npos) 2223 Out << "; ModuleID = '" << M->getModuleIdentifier() << "'\n"; 2224 2225 if (!M->getSourceFileName().empty()) { 2226 Out << "source_filename = \""; 2227 PrintEscapedString(M->getSourceFileName(), Out); 2228 Out << "\"\n"; 2229 } 2230 2231 const std::string &DL = M->getDataLayoutStr(); 2232 if (!DL.empty()) 2233 Out << "target datalayout = \"" << DL << "\"\n"; 2234 if (!M->getTargetTriple().empty()) 2235 Out << "target triple = \"" << M->getTargetTriple() << "\"\n"; 2236 2237 if (!M->getModuleInlineAsm().empty()) { 2238 Out << '\n'; 2239 2240 // Split the string into lines, to make it easier to read the .ll file. 2241 StringRef Asm = M->getModuleInlineAsm(); 2242 do { 2243 StringRef Front; 2244 std::tie(Front, Asm) = Asm.split('\n'); 2245 2246 // We found a newline, print the portion of the asm string from the 2247 // last newline up to this newline. 2248 Out << "module asm \""; 2249 PrintEscapedString(Front, Out); 2250 Out << "\"\n"; 2251 } while (!Asm.empty()); 2252 } 2253 2254 printTypeIdentities(); 2255 2256 // Output all comdats. 2257 if (!Comdats.empty()) 2258 Out << '\n'; 2259 for (const Comdat *C : Comdats) { 2260 printComdat(C); 2261 if (C != Comdats.back()) 2262 Out << '\n'; 2263 } 2264 2265 // Output all globals. 2266 if (!M->global_empty()) Out << '\n'; 2267 for (const GlobalVariable &GV : M->globals()) { 2268 printGlobal(&GV); Out << '\n'; 2269 } 2270 2271 // Output all aliases. 2272 if (!M->alias_empty()) Out << "\n"; 2273 for (const GlobalAlias &GA : M->aliases()) 2274 printIndirectSymbol(&GA); 2275 2276 // Output all ifuncs. 2277 if (!M->ifunc_empty()) Out << "\n"; 2278 for (const GlobalIFunc &GI : M->ifuncs()) 2279 printIndirectSymbol(&GI); 2280 2281 // Output global use-lists. 2282 printUseLists(nullptr); 2283 2284 // Output all of the functions. 2285 for (const Function &F : *M) 2286 printFunction(&F); 2287 assert(UseListOrders.empty() && "All use-lists should have been consumed"); 2288 2289 // Output all attribute groups. 2290 if (!Machine.as_empty()) { 2291 Out << '\n'; 2292 writeAllAttributeGroups(); 2293 } 2294 2295 // Output named metadata. 2296 if (!M->named_metadata_empty()) Out << '\n'; 2297 2298 for (const NamedMDNode &Node : M->named_metadata()) 2299 printNamedMDNode(&Node); 2300 2301 // Output metadata. 2302 if (!Machine.mdn_empty()) { 2303 Out << '\n'; 2304 writeAllMDNodes(); 2305 } 2306 } 2307 2308 static void printMetadataIdentifier(StringRef Name, 2309 formatted_raw_ostream &Out) { 2310 if (Name.empty()) { 2311 Out << "<empty name> "; 2312 } else { 2313 if (isalpha(static_cast<unsigned char>(Name[0])) || Name[0] == '-' || 2314 Name[0] == '$' || Name[0] == '.' || Name[0] == '_') 2315 Out << Name[0]; 2316 else 2317 Out << '\\' << hexdigit(Name[0] >> 4) << hexdigit(Name[0] & 0x0F); 2318 for (unsigned i = 1, e = Name.size(); i != e; ++i) { 2319 unsigned char C = Name[i]; 2320 if (isalnum(static_cast<unsigned char>(C)) || C == '-' || C == '$' || 2321 C == '.' || C == '_') 2322 Out << C; 2323 else 2324 Out << '\\' << hexdigit(C >> 4) << hexdigit(C & 0x0F); 2325 } 2326 } 2327 } 2328 2329 void AssemblyWriter::printNamedMDNode(const NamedMDNode *NMD) { 2330 Out << '!'; 2331 printMetadataIdentifier(NMD->getName(), Out); 2332 Out << " = !{"; 2333 for (unsigned i = 0, e = NMD->getNumOperands(); i != e; ++i) { 2334 if (i) 2335 Out << ", "; 2336 int Slot = Machine.getMetadataSlot(NMD->getOperand(i)); 2337 if (Slot == -1) 2338 Out << "<badref>"; 2339 else 2340 Out << '!' << Slot; 2341 } 2342 Out << "}\n"; 2343 } 2344 2345 static const char *getLinkagePrintName(GlobalValue::LinkageTypes LT) { 2346 switch (LT) { 2347 case GlobalValue::ExternalLinkage: 2348 return ""; 2349 case GlobalValue::PrivateLinkage: 2350 return "private "; 2351 case GlobalValue::InternalLinkage: 2352 return "internal "; 2353 case GlobalValue::LinkOnceAnyLinkage: 2354 return "linkonce "; 2355 case GlobalValue::LinkOnceODRLinkage: 2356 return "linkonce_odr "; 2357 case GlobalValue::WeakAnyLinkage: 2358 return "weak "; 2359 case GlobalValue::WeakODRLinkage: 2360 return "weak_odr "; 2361 case GlobalValue::CommonLinkage: 2362 return "common "; 2363 case GlobalValue::AppendingLinkage: 2364 return "appending "; 2365 case GlobalValue::ExternalWeakLinkage: 2366 return "extern_weak "; 2367 case GlobalValue::AvailableExternallyLinkage: 2368 return "available_externally "; 2369 } 2370 llvm_unreachable("invalid linkage"); 2371 } 2372 2373 static void PrintVisibility(GlobalValue::VisibilityTypes Vis, 2374 formatted_raw_ostream &Out) { 2375 switch (Vis) { 2376 case GlobalValue::DefaultVisibility: break; 2377 case GlobalValue::HiddenVisibility: Out << "hidden "; break; 2378 case GlobalValue::ProtectedVisibility: Out << "protected "; break; 2379 } 2380 } 2381 2382 static void PrintDLLStorageClass(GlobalValue::DLLStorageClassTypes SCT, 2383 formatted_raw_ostream &Out) { 2384 switch (SCT) { 2385 case GlobalValue::DefaultStorageClass: break; 2386 case GlobalValue::DLLImportStorageClass: Out << "dllimport "; break; 2387 case GlobalValue::DLLExportStorageClass: Out << "dllexport "; break; 2388 } 2389 } 2390 2391 static void PrintThreadLocalModel(GlobalVariable::ThreadLocalMode TLM, 2392 formatted_raw_ostream &Out) { 2393 switch (TLM) { 2394 case GlobalVariable::NotThreadLocal: 2395 break; 2396 case GlobalVariable::GeneralDynamicTLSModel: 2397 Out << "thread_local "; 2398 break; 2399 case GlobalVariable::LocalDynamicTLSModel: 2400 Out << "thread_local(localdynamic) "; 2401 break; 2402 case GlobalVariable::InitialExecTLSModel: 2403 Out << "thread_local(initialexec) "; 2404 break; 2405 case GlobalVariable::LocalExecTLSModel: 2406 Out << "thread_local(localexec) "; 2407 break; 2408 } 2409 } 2410 2411 static StringRef getUnnamedAddrEncoding(GlobalVariable::UnnamedAddr UA) { 2412 switch (UA) { 2413 case GlobalVariable::UnnamedAddr::None: 2414 return ""; 2415 case GlobalVariable::UnnamedAddr::Local: 2416 return "local_unnamed_addr"; 2417 case GlobalVariable::UnnamedAddr::Global: 2418 return "unnamed_addr"; 2419 } 2420 llvm_unreachable("Unknown UnnamedAddr"); 2421 } 2422 2423 static void maybePrintComdat(formatted_raw_ostream &Out, 2424 const GlobalObject &GO) { 2425 const Comdat *C = GO.getComdat(); 2426 if (!C) 2427 return; 2428 2429 if (isa<GlobalVariable>(GO)) 2430 Out << ','; 2431 Out << " comdat"; 2432 2433 if (GO.getName() == C->getName()) 2434 return; 2435 2436 Out << '('; 2437 PrintLLVMName(Out, C->getName(), ComdatPrefix); 2438 Out << ')'; 2439 } 2440 2441 void AssemblyWriter::printGlobal(const GlobalVariable *GV) { 2442 if (GV->isMaterializable()) 2443 Out << "; Materializable\n"; 2444 2445 WriteAsOperandInternal(Out, GV, &TypePrinter, &Machine, GV->getParent()); 2446 Out << " = "; 2447 2448 if (!GV->hasInitializer() && GV->hasExternalLinkage()) 2449 Out << "external "; 2450 2451 Out << getLinkagePrintName(GV->getLinkage()); 2452 PrintVisibility(GV->getVisibility(), Out); 2453 PrintDLLStorageClass(GV->getDLLStorageClass(), Out); 2454 PrintThreadLocalModel(GV->getThreadLocalMode(), Out); 2455 StringRef UA = getUnnamedAddrEncoding(GV->getUnnamedAddr()); 2456 if (!UA.empty()) 2457 Out << UA << ' '; 2458 2459 if (unsigned AddressSpace = GV->getType()->getAddressSpace()) 2460 Out << "addrspace(" << AddressSpace << ") "; 2461 if (GV->isExternallyInitialized()) Out << "externally_initialized "; 2462 Out << (GV->isConstant() ? "constant " : "global "); 2463 TypePrinter.print(GV->getValueType(), Out); 2464 2465 if (GV->hasInitializer()) { 2466 Out << ' '; 2467 writeOperand(GV->getInitializer(), false); 2468 } 2469 2470 if (GV->hasSection()) { 2471 Out << ", section \""; 2472 PrintEscapedString(GV->getSection(), Out); 2473 Out << '"'; 2474 } 2475 maybePrintComdat(Out, *GV); 2476 if (GV->getAlignment()) 2477 Out << ", align " << GV->getAlignment(); 2478 2479 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 2480 GV->getAllMetadata(MDs); 2481 printMetadataAttachments(MDs, ", "); 2482 2483 printInfoComment(*GV); 2484 } 2485 2486 void AssemblyWriter::printIndirectSymbol(const GlobalIndirectSymbol *GIS) { 2487 if (GIS->isMaterializable()) 2488 Out << "; Materializable\n"; 2489 2490 WriteAsOperandInternal(Out, GIS, &TypePrinter, &Machine, GIS->getParent()); 2491 Out << " = "; 2492 2493 Out << getLinkagePrintName(GIS->getLinkage()); 2494 PrintVisibility(GIS->getVisibility(), Out); 2495 PrintDLLStorageClass(GIS->getDLLStorageClass(), Out); 2496 PrintThreadLocalModel(GIS->getThreadLocalMode(), Out); 2497 StringRef UA = getUnnamedAddrEncoding(GIS->getUnnamedAddr()); 2498 if (!UA.empty()) 2499 Out << UA << ' '; 2500 2501 if (isa<GlobalAlias>(GIS)) 2502 Out << "alias "; 2503 else if (isa<GlobalIFunc>(GIS)) 2504 Out << "ifunc "; 2505 else 2506 llvm_unreachable("Not an alias or ifunc!"); 2507 2508 TypePrinter.print(GIS->getValueType(), Out); 2509 2510 Out << ", "; 2511 2512 const Constant *IS = GIS->getIndirectSymbol(); 2513 2514 if (!IS) { 2515 TypePrinter.print(GIS->getType(), Out); 2516 Out << " <<NULL ALIASEE>>"; 2517 } else { 2518 writeOperand(IS, !isa<ConstantExpr>(IS)); 2519 } 2520 2521 printInfoComment(*GIS); 2522 Out << '\n'; 2523 } 2524 2525 void AssemblyWriter::printComdat(const Comdat *C) { 2526 C->print(Out); 2527 } 2528 2529 void AssemblyWriter::printTypeIdentities() { 2530 if (TypePrinter.NumberedTypes.empty() && 2531 TypePrinter.NamedTypes.empty()) 2532 return; 2533 2534 Out << '\n'; 2535 2536 // We know all the numbers that each type is used and we know that it is a 2537 // dense assignment. Convert the map to an index table. 2538 std::vector<StructType*> NumberedTypes(TypePrinter.NumberedTypes.size()); 2539 for (DenseMap<StructType*, unsigned>::iterator I = 2540 TypePrinter.NumberedTypes.begin(), E = TypePrinter.NumberedTypes.end(); 2541 I != E; ++I) { 2542 assert(I->second < NumberedTypes.size() && "Didn't get a dense numbering?"); 2543 NumberedTypes[I->second] = I->first; 2544 } 2545 2546 // Emit all numbered types. 2547 for (unsigned i = 0, e = NumberedTypes.size(); i != e; ++i) { 2548 Out << '%' << i << " = type "; 2549 2550 // Make sure we print out at least one level of the type structure, so 2551 // that we do not get %2 = type %2 2552 TypePrinter.printStructBody(NumberedTypes[i], Out); 2553 Out << '\n'; 2554 } 2555 2556 for (unsigned i = 0, e = TypePrinter.NamedTypes.size(); i != e; ++i) { 2557 PrintLLVMName(Out, TypePrinter.NamedTypes[i]->getName(), LocalPrefix); 2558 Out << " = type "; 2559 2560 // Make sure we print out at least one level of the type structure, so 2561 // that we do not get %FILE = type %FILE 2562 TypePrinter.printStructBody(TypePrinter.NamedTypes[i], Out); 2563 Out << '\n'; 2564 } 2565 } 2566 2567 /// printFunction - Print all aspects of a function. 2568 /// 2569 void AssemblyWriter::printFunction(const Function *F) { 2570 // Print out the return type and name. 2571 Out << '\n'; 2572 2573 if (AnnotationWriter) AnnotationWriter->emitFunctionAnnot(F, Out); 2574 2575 if (F->isMaterializable()) 2576 Out << "; Materializable\n"; 2577 2578 const AttributeSet &Attrs = F->getAttributes(); 2579 if (Attrs.hasAttributes(AttributeSet::FunctionIndex)) { 2580 AttributeSet AS = Attrs.getFnAttributes(); 2581 std::string AttrStr; 2582 2583 unsigned Idx = 0; 2584 for (unsigned E = AS.getNumSlots(); Idx != E; ++Idx) 2585 if (AS.getSlotIndex(Idx) == AttributeSet::FunctionIndex) 2586 break; 2587 2588 for (AttributeSet::iterator I = AS.begin(Idx), E = AS.end(Idx); 2589 I != E; ++I) { 2590 Attribute Attr = *I; 2591 if (!Attr.isStringAttribute()) { 2592 if (!AttrStr.empty()) AttrStr += ' '; 2593 AttrStr += Attr.getAsString(); 2594 } 2595 } 2596 2597 if (!AttrStr.empty()) 2598 Out << "; Function Attrs: " << AttrStr << '\n'; 2599 } 2600 2601 Machine.incorporateFunction(F); 2602 2603 if (F->isDeclaration()) { 2604 Out << "declare"; 2605 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 2606 F->getAllMetadata(MDs); 2607 printMetadataAttachments(MDs, " "); 2608 Out << ' '; 2609 } else 2610 Out << "define "; 2611 2612 Out << getLinkagePrintName(F->getLinkage()); 2613 PrintVisibility(F->getVisibility(), Out); 2614 PrintDLLStorageClass(F->getDLLStorageClass(), Out); 2615 2616 // Print the calling convention. 2617 if (F->getCallingConv() != CallingConv::C) { 2618 PrintCallingConv(F->getCallingConv(), Out); 2619 Out << " "; 2620 } 2621 2622 FunctionType *FT = F->getFunctionType(); 2623 if (Attrs.hasAttributes(AttributeSet::ReturnIndex)) 2624 Out << Attrs.getAsString(AttributeSet::ReturnIndex) << ' '; 2625 TypePrinter.print(F->getReturnType(), Out); 2626 Out << ' '; 2627 WriteAsOperandInternal(Out, F, &TypePrinter, &Machine, F->getParent()); 2628 Out << '('; 2629 2630 // Loop over the arguments, printing them... 2631 if (F->isDeclaration() && !IsForDebug) { 2632 // We're only interested in the type here - don't print argument names. 2633 for (unsigned I = 0, E = FT->getNumParams(); I != E; ++I) { 2634 // Insert commas as we go... the first arg doesn't get a comma 2635 if (I) 2636 Out << ", "; 2637 // Output type... 2638 TypePrinter.print(FT->getParamType(I), Out); 2639 2640 if (Attrs.hasAttributes(I + 1)) 2641 Out << ' ' << Attrs.getAsString(I + 1); 2642 } 2643 } else { 2644 // The arguments are meaningful here, print them in detail. 2645 unsigned Idx = 1; 2646 for (const Argument &Arg : F->args()) { 2647 // Insert commas as we go... the first arg doesn't get a comma 2648 if (Idx != 1) 2649 Out << ", "; 2650 printArgument(&Arg, Attrs, Idx++); 2651 } 2652 } 2653 2654 // Finish printing arguments... 2655 if (FT->isVarArg()) { 2656 if (FT->getNumParams()) Out << ", "; 2657 Out << "..."; // Output varargs portion of signature! 2658 } 2659 Out << ')'; 2660 StringRef UA = getUnnamedAddrEncoding(F->getUnnamedAddr()); 2661 if (!UA.empty()) 2662 Out << ' ' << UA; 2663 if (Attrs.hasAttributes(AttributeSet::FunctionIndex)) 2664 Out << " #" << Machine.getAttributeGroupSlot(Attrs.getFnAttributes()); 2665 if (F->hasSection()) { 2666 Out << " section \""; 2667 PrintEscapedString(F->getSection(), Out); 2668 Out << '"'; 2669 } 2670 maybePrintComdat(Out, *F); 2671 if (F->getAlignment()) 2672 Out << " align " << F->getAlignment(); 2673 if (F->hasGC()) 2674 Out << " gc \"" << F->getGC() << '"'; 2675 if (F->hasPrefixData()) { 2676 Out << " prefix "; 2677 writeOperand(F->getPrefixData(), true); 2678 } 2679 if (F->hasPrologueData()) { 2680 Out << " prologue "; 2681 writeOperand(F->getPrologueData(), true); 2682 } 2683 if (F->hasPersonalityFn()) { 2684 Out << " personality "; 2685 writeOperand(F->getPersonalityFn(), /*PrintType=*/true); 2686 } 2687 2688 if (F->isDeclaration()) { 2689 Out << '\n'; 2690 } else { 2691 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 2692 F->getAllMetadata(MDs); 2693 printMetadataAttachments(MDs, " "); 2694 2695 Out << " {"; 2696 // Output all of the function's basic blocks. 2697 for (const BasicBlock &BB : *F) 2698 printBasicBlock(&BB); 2699 2700 // Output the function's use-lists. 2701 printUseLists(F); 2702 2703 Out << "}\n"; 2704 } 2705 2706 Machine.purgeFunction(); 2707 } 2708 2709 /// printArgument - This member is called for every argument that is passed into 2710 /// the function. Simply print it out 2711 /// 2712 void AssemblyWriter::printArgument(const Argument *Arg, 2713 AttributeSet Attrs, unsigned Idx) { 2714 // Output type... 2715 TypePrinter.print(Arg->getType(), Out); 2716 2717 // Output parameter attributes list 2718 if (Attrs.hasAttributes(Idx)) 2719 Out << ' ' << Attrs.getAsString(Idx); 2720 2721 // Output name, if available... 2722 if (Arg->hasName()) { 2723 Out << ' '; 2724 PrintLLVMName(Out, Arg); 2725 } 2726 } 2727 2728 /// printBasicBlock - This member is called for each basic block in a method. 2729 /// 2730 void AssemblyWriter::printBasicBlock(const BasicBlock *BB) { 2731 if (BB->hasName()) { // Print out the label if it exists... 2732 Out << "\n"; 2733 PrintLLVMName(Out, BB->getName(), LabelPrefix); 2734 Out << ':'; 2735 } else if (!BB->use_empty()) { // Don't print block # of no uses... 2736 Out << "\n; <label>:"; 2737 int Slot = Machine.getLocalSlot(BB); 2738 if (Slot != -1) 2739 Out << Slot << ":"; 2740 else 2741 Out << "<badref>"; 2742 } 2743 2744 if (!BB->getParent()) { 2745 Out.PadToColumn(50); 2746 Out << "; Error: Block without parent!"; 2747 } else if (BB != &BB->getParent()->getEntryBlock()) { // Not the entry block? 2748 // Output predecessors for the block. 2749 Out.PadToColumn(50); 2750 Out << ";"; 2751 const_pred_iterator PI = pred_begin(BB), PE = pred_end(BB); 2752 2753 if (PI == PE) { 2754 Out << " No predecessors!"; 2755 } else { 2756 Out << " preds = "; 2757 writeOperand(*PI, false); 2758 for (++PI; PI != PE; ++PI) { 2759 Out << ", "; 2760 writeOperand(*PI, false); 2761 } 2762 } 2763 } 2764 2765 Out << "\n"; 2766 2767 if (AnnotationWriter) AnnotationWriter->emitBasicBlockStartAnnot(BB, Out); 2768 2769 // Output all of the instructions in the basic block... 2770 for (const Instruction &I : *BB) { 2771 printInstructionLine(I); 2772 } 2773 2774 if (AnnotationWriter) AnnotationWriter->emitBasicBlockEndAnnot(BB, Out); 2775 } 2776 2777 /// printInstructionLine - Print an instruction and a newline character. 2778 void AssemblyWriter::printInstructionLine(const Instruction &I) { 2779 printInstruction(I); 2780 Out << '\n'; 2781 } 2782 2783 /// printGCRelocateComment - print comment after call to the gc.relocate 2784 /// intrinsic indicating base and derived pointer names. 2785 void AssemblyWriter::printGCRelocateComment(const GCRelocateInst &Relocate) { 2786 Out << " ; ("; 2787 writeOperand(Relocate.getBasePtr(), false); 2788 Out << ", "; 2789 writeOperand(Relocate.getDerivedPtr(), false); 2790 Out << ")"; 2791 } 2792 2793 /// printInfoComment - Print a little comment after the instruction indicating 2794 /// which slot it occupies. 2795 /// 2796 void AssemblyWriter::printInfoComment(const Value &V) { 2797 if (const auto *Relocate = dyn_cast<GCRelocateInst>(&V)) 2798 printGCRelocateComment(*Relocate); 2799 2800 if (AnnotationWriter) 2801 AnnotationWriter->printInfoComment(V, Out); 2802 } 2803 2804 // This member is called for each Instruction in a function.. 2805 void AssemblyWriter::printInstruction(const Instruction &I) { 2806 if (AnnotationWriter) AnnotationWriter->emitInstructionAnnot(&I, Out); 2807 2808 // Print out indentation for an instruction. 2809 Out << " "; 2810 2811 // Print out name if it exists... 2812 if (I.hasName()) { 2813 PrintLLVMName(Out, &I); 2814 Out << " = "; 2815 } else if (!I.getType()->isVoidTy()) { 2816 // Print out the def slot taken. 2817 int SlotNum = Machine.getLocalSlot(&I); 2818 if (SlotNum == -1) 2819 Out << "<badref> = "; 2820 else 2821 Out << '%' << SlotNum << " = "; 2822 } 2823 2824 if (const CallInst *CI = dyn_cast<CallInst>(&I)) { 2825 if (CI->isMustTailCall()) 2826 Out << "musttail "; 2827 else if (CI->isTailCall()) 2828 Out << "tail "; 2829 else if (CI->isNoTailCall()) 2830 Out << "notail "; 2831 } 2832 2833 // Print out the opcode... 2834 Out << I.getOpcodeName(); 2835 2836 // If this is an atomic load or store, print out the atomic marker. 2837 if ((isa<LoadInst>(I) && cast<LoadInst>(I).isAtomic()) || 2838 (isa<StoreInst>(I) && cast<StoreInst>(I).isAtomic())) 2839 Out << " atomic"; 2840 2841 if (isa<AtomicCmpXchgInst>(I) && cast<AtomicCmpXchgInst>(I).isWeak()) 2842 Out << " weak"; 2843 2844 // If this is a volatile operation, print out the volatile marker. 2845 if ((isa<LoadInst>(I) && cast<LoadInst>(I).isVolatile()) || 2846 (isa<StoreInst>(I) && cast<StoreInst>(I).isVolatile()) || 2847 (isa<AtomicCmpXchgInst>(I) && cast<AtomicCmpXchgInst>(I).isVolatile()) || 2848 (isa<AtomicRMWInst>(I) && cast<AtomicRMWInst>(I).isVolatile())) 2849 Out << " volatile"; 2850 2851 // Print out optimization information. 2852 WriteOptimizationInfo(Out, &I); 2853 2854 // Print out the compare instruction predicates 2855 if (const CmpInst *CI = dyn_cast<CmpInst>(&I)) 2856 Out << ' ' << CmpInst::getPredicateName(CI->getPredicate()); 2857 2858 // Print out the atomicrmw operation 2859 if (const AtomicRMWInst *RMWI = dyn_cast<AtomicRMWInst>(&I)) 2860 writeAtomicRMWOperation(Out, RMWI->getOperation()); 2861 2862 // Print out the type of the operands... 2863 const Value *Operand = I.getNumOperands() ? I.getOperand(0) : nullptr; 2864 2865 // Special case conditional branches to swizzle the condition out to the front 2866 if (isa<BranchInst>(I) && cast<BranchInst>(I).isConditional()) { 2867 const BranchInst &BI(cast<BranchInst>(I)); 2868 Out << ' '; 2869 writeOperand(BI.getCondition(), true); 2870 Out << ", "; 2871 writeOperand(BI.getSuccessor(0), true); 2872 Out << ", "; 2873 writeOperand(BI.getSuccessor(1), true); 2874 2875 } else if (isa<SwitchInst>(I)) { 2876 const SwitchInst& SI(cast<SwitchInst>(I)); 2877 // Special case switch instruction to get formatting nice and correct. 2878 Out << ' '; 2879 writeOperand(SI.getCondition(), true); 2880 Out << ", "; 2881 writeOperand(SI.getDefaultDest(), true); 2882 Out << " ["; 2883 for (SwitchInst::ConstCaseIt i = SI.case_begin(), e = SI.case_end(); 2884 i != e; ++i) { 2885 Out << "\n "; 2886 writeOperand(i.getCaseValue(), true); 2887 Out << ", "; 2888 writeOperand(i.getCaseSuccessor(), true); 2889 } 2890 Out << "\n ]"; 2891 } else if (isa<IndirectBrInst>(I)) { 2892 // Special case indirectbr instruction to get formatting nice and correct. 2893 Out << ' '; 2894 writeOperand(Operand, true); 2895 Out << ", ["; 2896 2897 for (unsigned i = 1, e = I.getNumOperands(); i != e; ++i) { 2898 if (i != 1) 2899 Out << ", "; 2900 writeOperand(I.getOperand(i), true); 2901 } 2902 Out << ']'; 2903 } else if (const PHINode *PN = dyn_cast<PHINode>(&I)) { 2904 Out << ' '; 2905 TypePrinter.print(I.getType(), Out); 2906 Out << ' '; 2907 2908 for (unsigned op = 0, Eop = PN->getNumIncomingValues(); op < Eop; ++op) { 2909 if (op) Out << ", "; 2910 Out << "[ "; 2911 writeOperand(PN->getIncomingValue(op), false); Out << ", "; 2912 writeOperand(PN->getIncomingBlock(op), false); Out << " ]"; 2913 } 2914 } else if (const ExtractValueInst *EVI = dyn_cast<ExtractValueInst>(&I)) { 2915 Out << ' '; 2916 writeOperand(I.getOperand(0), true); 2917 for (const unsigned *i = EVI->idx_begin(), *e = EVI->idx_end(); i != e; ++i) 2918 Out << ", " << *i; 2919 } else if (const InsertValueInst *IVI = dyn_cast<InsertValueInst>(&I)) { 2920 Out << ' '; 2921 writeOperand(I.getOperand(0), true); Out << ", "; 2922 writeOperand(I.getOperand(1), true); 2923 for (const unsigned *i = IVI->idx_begin(), *e = IVI->idx_end(); i != e; ++i) 2924 Out << ", " << *i; 2925 } else if (const LandingPadInst *LPI = dyn_cast<LandingPadInst>(&I)) { 2926 Out << ' '; 2927 TypePrinter.print(I.getType(), Out); 2928 if (LPI->isCleanup() || LPI->getNumClauses() != 0) 2929 Out << '\n'; 2930 2931 if (LPI->isCleanup()) 2932 Out << " cleanup"; 2933 2934 for (unsigned i = 0, e = LPI->getNumClauses(); i != e; ++i) { 2935 if (i != 0 || LPI->isCleanup()) Out << "\n"; 2936 if (LPI->isCatch(i)) 2937 Out << " catch "; 2938 else 2939 Out << " filter "; 2940 2941 writeOperand(LPI->getClause(i), true); 2942 } 2943 } else if (const auto *CatchSwitch = dyn_cast<CatchSwitchInst>(&I)) { 2944 Out << " within "; 2945 writeOperand(CatchSwitch->getParentPad(), /*PrintType=*/false); 2946 Out << " ["; 2947 unsigned Op = 0; 2948 for (const BasicBlock *PadBB : CatchSwitch->handlers()) { 2949 if (Op > 0) 2950 Out << ", "; 2951 writeOperand(PadBB, /*PrintType=*/true); 2952 ++Op; 2953 } 2954 Out << "] unwind "; 2955 if (const BasicBlock *UnwindDest = CatchSwitch->getUnwindDest()) 2956 writeOperand(UnwindDest, /*PrintType=*/true); 2957 else 2958 Out << "to caller"; 2959 } else if (const auto *FPI = dyn_cast<FuncletPadInst>(&I)) { 2960 Out << " within "; 2961 writeOperand(FPI->getParentPad(), /*PrintType=*/false); 2962 Out << " ["; 2963 for (unsigned Op = 0, NumOps = FPI->getNumArgOperands(); Op < NumOps; 2964 ++Op) { 2965 if (Op > 0) 2966 Out << ", "; 2967 writeOperand(FPI->getArgOperand(Op), /*PrintType=*/true); 2968 } 2969 Out << ']'; 2970 } else if (isa<ReturnInst>(I) && !Operand) { 2971 Out << " void"; 2972 } else if (const auto *CRI = dyn_cast<CatchReturnInst>(&I)) { 2973 Out << " from "; 2974 writeOperand(CRI->getOperand(0), /*PrintType=*/false); 2975 2976 Out << " to "; 2977 writeOperand(CRI->getOperand(1), /*PrintType=*/true); 2978 } else if (const auto *CRI = dyn_cast<CleanupReturnInst>(&I)) { 2979 Out << " from "; 2980 writeOperand(CRI->getOperand(0), /*PrintType=*/false); 2981 2982 Out << " unwind "; 2983 if (CRI->hasUnwindDest()) 2984 writeOperand(CRI->getOperand(1), /*PrintType=*/true); 2985 else 2986 Out << "to caller"; 2987 } else if (const CallInst *CI = dyn_cast<CallInst>(&I)) { 2988 // Print the calling convention being used. 2989 if (CI->getCallingConv() != CallingConv::C) { 2990 Out << " "; 2991 PrintCallingConv(CI->getCallingConv(), Out); 2992 } 2993 2994 Operand = CI->getCalledValue(); 2995 FunctionType *FTy = cast<FunctionType>(CI->getFunctionType()); 2996 Type *RetTy = FTy->getReturnType(); 2997 const AttributeSet &PAL = CI->getAttributes(); 2998 2999 if (PAL.hasAttributes(AttributeSet::ReturnIndex)) 3000 Out << ' ' << PAL.getAsString(AttributeSet::ReturnIndex); 3001 3002 // If possible, print out the short form of the call instruction. We can 3003 // only do this if the first argument is a pointer to a nonvararg function, 3004 // and if the return type is not a pointer to a function. 3005 // 3006 Out << ' '; 3007 TypePrinter.print(FTy->isVarArg() ? FTy : RetTy, Out); 3008 Out << ' '; 3009 writeOperand(Operand, false); 3010 Out << '('; 3011 for (unsigned op = 0, Eop = CI->getNumArgOperands(); op < Eop; ++op) { 3012 if (op > 0) 3013 Out << ", "; 3014 writeParamOperand(CI->getArgOperand(op), PAL, op + 1); 3015 } 3016 3017 // Emit an ellipsis if this is a musttail call in a vararg function. This 3018 // is only to aid readability, musttail calls forward varargs by default. 3019 if (CI->isMustTailCall() && CI->getParent() && 3020 CI->getParent()->getParent() && 3021 CI->getParent()->getParent()->isVarArg()) 3022 Out << ", ..."; 3023 3024 Out << ')'; 3025 if (PAL.hasAttributes(AttributeSet::FunctionIndex)) 3026 Out << " #" << Machine.getAttributeGroupSlot(PAL.getFnAttributes()); 3027 3028 writeOperandBundles(CI); 3029 3030 } else if (const InvokeInst *II = dyn_cast<InvokeInst>(&I)) { 3031 Operand = II->getCalledValue(); 3032 FunctionType *FTy = cast<FunctionType>(II->getFunctionType()); 3033 Type *RetTy = FTy->getReturnType(); 3034 const AttributeSet &PAL = II->getAttributes(); 3035 3036 // Print the calling convention being used. 3037 if (II->getCallingConv() != CallingConv::C) { 3038 Out << " "; 3039 PrintCallingConv(II->getCallingConv(), Out); 3040 } 3041 3042 if (PAL.hasAttributes(AttributeSet::ReturnIndex)) 3043 Out << ' ' << PAL.getAsString(AttributeSet::ReturnIndex); 3044 3045 // If possible, print out the short form of the invoke instruction. We can 3046 // only do this if the first argument is a pointer to a nonvararg function, 3047 // and if the return type is not a pointer to a function. 3048 // 3049 Out << ' '; 3050 TypePrinter.print(FTy->isVarArg() ? FTy : RetTy, Out); 3051 Out << ' '; 3052 writeOperand(Operand, false); 3053 Out << '('; 3054 for (unsigned op = 0, Eop = II->getNumArgOperands(); op < Eop; ++op) { 3055 if (op) 3056 Out << ", "; 3057 writeParamOperand(II->getArgOperand(op), PAL, op + 1); 3058 } 3059 3060 Out << ')'; 3061 if (PAL.hasAttributes(AttributeSet::FunctionIndex)) 3062 Out << " #" << Machine.getAttributeGroupSlot(PAL.getFnAttributes()); 3063 3064 writeOperandBundles(II); 3065 3066 Out << "\n to "; 3067 writeOperand(II->getNormalDest(), true); 3068 Out << " unwind "; 3069 writeOperand(II->getUnwindDest(), true); 3070 3071 } else if (const AllocaInst *AI = dyn_cast<AllocaInst>(&I)) { 3072 Out << ' '; 3073 if (AI->isUsedWithInAlloca()) 3074 Out << "inalloca "; 3075 if (AI->isSwiftError()) 3076 Out << "swifterror "; 3077 TypePrinter.print(AI->getAllocatedType(), Out); 3078 3079 // Explicitly write the array size if the code is broken, if it's an array 3080 // allocation, or if the type is not canonical for scalar allocations. The 3081 // latter case prevents the type from mutating when round-tripping through 3082 // assembly. 3083 if (!AI->getArraySize() || AI->isArrayAllocation() || 3084 !AI->getArraySize()->getType()->isIntegerTy(32)) { 3085 Out << ", "; 3086 writeOperand(AI->getArraySize(), true); 3087 } 3088 if (AI->getAlignment()) { 3089 Out << ", align " << AI->getAlignment(); 3090 } 3091 } else if (isa<CastInst>(I)) { 3092 if (Operand) { 3093 Out << ' '; 3094 writeOperand(Operand, true); // Work with broken code 3095 } 3096 Out << " to "; 3097 TypePrinter.print(I.getType(), Out); 3098 } else if (isa<VAArgInst>(I)) { 3099 if (Operand) { 3100 Out << ' '; 3101 writeOperand(Operand, true); // Work with broken code 3102 } 3103 Out << ", "; 3104 TypePrinter.print(I.getType(), Out); 3105 } else if (Operand) { // Print the normal way. 3106 if (const auto *GEP = dyn_cast<GetElementPtrInst>(&I)) { 3107 Out << ' '; 3108 TypePrinter.print(GEP->getSourceElementType(), Out); 3109 Out << ','; 3110 } else if (const auto *LI = dyn_cast<LoadInst>(&I)) { 3111 Out << ' '; 3112 TypePrinter.print(LI->getType(), Out); 3113 Out << ','; 3114 } 3115 3116 // PrintAllTypes - Instructions who have operands of all the same type 3117 // omit the type from all but the first operand. If the instruction has 3118 // different type operands (for example br), then they are all printed. 3119 bool PrintAllTypes = false; 3120 Type *TheType = Operand->getType(); 3121 3122 // Select, Store and ShuffleVector always print all types. 3123 if (isa<SelectInst>(I) || isa<StoreInst>(I) || isa<ShuffleVectorInst>(I) 3124 || isa<ReturnInst>(I)) { 3125 PrintAllTypes = true; 3126 } else { 3127 for (unsigned i = 1, E = I.getNumOperands(); i != E; ++i) { 3128 Operand = I.getOperand(i); 3129 // note that Operand shouldn't be null, but the test helps make dump() 3130 // more tolerant of malformed IR 3131 if (Operand && Operand->getType() != TheType) { 3132 PrintAllTypes = true; // We have differing types! Print them all! 3133 break; 3134 } 3135 } 3136 } 3137 3138 if (!PrintAllTypes) { 3139 Out << ' '; 3140 TypePrinter.print(TheType, Out); 3141 } 3142 3143 Out << ' '; 3144 for (unsigned i = 0, E = I.getNumOperands(); i != E; ++i) { 3145 if (i) Out << ", "; 3146 writeOperand(I.getOperand(i), PrintAllTypes); 3147 } 3148 } 3149 3150 // Print atomic ordering/alignment for memory operations 3151 if (const LoadInst *LI = dyn_cast<LoadInst>(&I)) { 3152 if (LI->isAtomic()) 3153 writeAtomic(LI->getOrdering(), LI->getSynchScope()); 3154 if (LI->getAlignment()) 3155 Out << ", align " << LI->getAlignment(); 3156 } else if (const StoreInst *SI = dyn_cast<StoreInst>(&I)) { 3157 if (SI->isAtomic()) 3158 writeAtomic(SI->getOrdering(), SI->getSynchScope()); 3159 if (SI->getAlignment()) 3160 Out << ", align " << SI->getAlignment(); 3161 } else if (const AtomicCmpXchgInst *CXI = dyn_cast<AtomicCmpXchgInst>(&I)) { 3162 writeAtomicCmpXchg(CXI->getSuccessOrdering(), CXI->getFailureOrdering(), 3163 CXI->getSynchScope()); 3164 } else if (const AtomicRMWInst *RMWI = dyn_cast<AtomicRMWInst>(&I)) { 3165 writeAtomic(RMWI->getOrdering(), RMWI->getSynchScope()); 3166 } else if (const FenceInst *FI = dyn_cast<FenceInst>(&I)) { 3167 writeAtomic(FI->getOrdering(), FI->getSynchScope()); 3168 } 3169 3170 // Print Metadata info. 3171 SmallVector<std::pair<unsigned, MDNode *>, 4> InstMD; 3172 I.getAllMetadata(InstMD); 3173 printMetadataAttachments(InstMD, ", "); 3174 3175 // Print a nice comment. 3176 printInfoComment(I); 3177 } 3178 3179 void AssemblyWriter::printMetadataAttachments( 3180 const SmallVectorImpl<std::pair<unsigned, MDNode *>> &MDs, 3181 StringRef Separator) { 3182 if (MDs.empty()) 3183 return; 3184 3185 if (MDNames.empty()) 3186 MDs[0].second->getContext().getMDKindNames(MDNames); 3187 3188 for (const auto &I : MDs) { 3189 unsigned Kind = I.first; 3190 Out << Separator; 3191 if (Kind < MDNames.size()) { 3192 Out << "!"; 3193 printMetadataIdentifier(MDNames[Kind], Out); 3194 } else 3195 Out << "!<unknown kind #" << Kind << ">"; 3196 Out << ' '; 3197 WriteAsOperandInternal(Out, I.second, &TypePrinter, &Machine, TheModule); 3198 } 3199 } 3200 3201 void AssemblyWriter::writeMDNode(unsigned Slot, const MDNode *Node) { 3202 Out << '!' << Slot << " = "; 3203 printMDNodeBody(Node); 3204 Out << "\n"; 3205 } 3206 3207 void AssemblyWriter::writeAllMDNodes() { 3208 SmallVector<const MDNode *, 16> Nodes; 3209 Nodes.resize(Machine.mdn_size()); 3210 for (SlotTracker::mdn_iterator I = Machine.mdn_begin(), E = Machine.mdn_end(); 3211 I != E; ++I) 3212 Nodes[I->second] = cast<MDNode>(I->first); 3213 3214 for (unsigned i = 0, e = Nodes.size(); i != e; ++i) { 3215 writeMDNode(i, Nodes[i]); 3216 } 3217 } 3218 3219 void AssemblyWriter::printMDNodeBody(const MDNode *Node) { 3220 WriteMDNodeBodyInternal(Out, Node, &TypePrinter, &Machine, TheModule); 3221 } 3222 3223 void AssemblyWriter::writeAllAttributeGroups() { 3224 std::vector<std::pair<AttributeSet, unsigned> > asVec; 3225 asVec.resize(Machine.as_size()); 3226 3227 for (SlotTracker::as_iterator I = Machine.as_begin(), E = Machine.as_end(); 3228 I != E; ++I) 3229 asVec[I->second] = *I; 3230 3231 for (const auto &I : asVec) 3232 Out << "attributes #" << I.second << " = { " 3233 << I.first.getAsString(AttributeSet::FunctionIndex, true) << " }\n"; 3234 } 3235 3236 void AssemblyWriter::printUseListOrder(const UseListOrder &Order) { 3237 bool IsInFunction = Machine.getFunction(); 3238 if (IsInFunction) 3239 Out << " "; 3240 3241 Out << "uselistorder"; 3242 if (const BasicBlock *BB = 3243 IsInFunction ? nullptr : dyn_cast<BasicBlock>(Order.V)) { 3244 Out << "_bb "; 3245 writeOperand(BB->getParent(), false); 3246 Out << ", "; 3247 writeOperand(BB, false); 3248 } else { 3249 Out << " "; 3250 writeOperand(Order.V, true); 3251 } 3252 Out << ", { "; 3253 3254 assert(Order.Shuffle.size() >= 2 && "Shuffle too small"); 3255 Out << Order.Shuffle[0]; 3256 for (unsigned I = 1, E = Order.Shuffle.size(); I != E; ++I) 3257 Out << ", " << Order.Shuffle[I]; 3258 Out << " }\n"; 3259 } 3260 3261 void AssemblyWriter::printUseLists(const Function *F) { 3262 auto hasMore = 3263 [&]() { return !UseListOrders.empty() && UseListOrders.back().F == F; }; 3264 if (!hasMore()) 3265 // Nothing to do. 3266 return; 3267 3268 Out << "\n; uselistorder directives\n"; 3269 while (hasMore()) { 3270 printUseListOrder(UseListOrders.back()); 3271 UseListOrders.pop_back(); 3272 } 3273 } 3274 3275 //===----------------------------------------------------------------------===// 3276 // External Interface declarations 3277 //===----------------------------------------------------------------------===// 3278 3279 void Function::print(raw_ostream &ROS, AssemblyAnnotationWriter *AAW, 3280 bool ShouldPreserveUseListOrder, 3281 bool IsForDebug) const { 3282 SlotTracker SlotTable(this->getParent()); 3283 formatted_raw_ostream OS(ROS); 3284 AssemblyWriter W(OS, SlotTable, this->getParent(), AAW, 3285 IsForDebug, 3286 ShouldPreserveUseListOrder); 3287 W.printFunction(this); 3288 } 3289 3290 void Module::print(raw_ostream &ROS, AssemblyAnnotationWriter *AAW, 3291 bool ShouldPreserveUseListOrder, bool IsForDebug) const { 3292 SlotTracker SlotTable(this); 3293 formatted_raw_ostream OS(ROS); 3294 AssemblyWriter W(OS, SlotTable, this, AAW, IsForDebug, 3295 ShouldPreserveUseListOrder); 3296 W.printModule(this); 3297 } 3298 3299 void NamedMDNode::print(raw_ostream &ROS, bool IsForDebug) const { 3300 SlotTracker SlotTable(getParent()); 3301 formatted_raw_ostream OS(ROS); 3302 AssemblyWriter W(OS, SlotTable, getParent(), nullptr, IsForDebug); 3303 W.printNamedMDNode(this); 3304 } 3305 3306 void NamedMDNode::print(raw_ostream &ROS, ModuleSlotTracker &MST, 3307 bool IsForDebug) const { 3308 Optional<SlotTracker> LocalST; 3309 SlotTracker *SlotTable; 3310 if (auto *ST = MST.getMachine()) 3311 SlotTable = ST; 3312 else { 3313 LocalST.emplace(getParent()); 3314 SlotTable = &*LocalST; 3315 } 3316 3317 formatted_raw_ostream OS(ROS); 3318 AssemblyWriter W(OS, *SlotTable, getParent(), nullptr, IsForDebug); 3319 W.printNamedMDNode(this); 3320 } 3321 3322 void Comdat::print(raw_ostream &ROS, bool /*IsForDebug*/) const { 3323 PrintLLVMName(ROS, getName(), ComdatPrefix); 3324 ROS << " = comdat "; 3325 3326 switch (getSelectionKind()) { 3327 case Comdat::Any: 3328 ROS << "any"; 3329 break; 3330 case Comdat::ExactMatch: 3331 ROS << "exactmatch"; 3332 break; 3333 case Comdat::Largest: 3334 ROS << "largest"; 3335 break; 3336 case Comdat::NoDuplicates: 3337 ROS << "noduplicates"; 3338 break; 3339 case Comdat::SameSize: 3340 ROS << "samesize"; 3341 break; 3342 } 3343 3344 ROS << '\n'; 3345 } 3346 3347 void Type::print(raw_ostream &OS, bool /*IsForDebug*/, bool NoDetails) const { 3348 TypePrinting TP; 3349 TP.print(const_cast<Type*>(this), OS); 3350 3351 if (NoDetails) 3352 return; 3353 3354 // If the type is a named struct type, print the body as well. 3355 if (StructType *STy = dyn_cast<StructType>(const_cast<Type*>(this))) 3356 if (!STy->isLiteral()) { 3357 OS << " = type "; 3358 TP.printStructBody(STy, OS); 3359 } 3360 } 3361 3362 static bool isReferencingMDNode(const Instruction &I) { 3363 if (const auto *CI = dyn_cast<CallInst>(&I)) 3364 if (Function *F = CI->getCalledFunction()) 3365 if (F->isIntrinsic()) 3366 for (auto &Op : I.operands()) 3367 if (auto *V = dyn_cast_or_null<MetadataAsValue>(Op)) 3368 if (isa<MDNode>(V->getMetadata())) 3369 return true; 3370 return false; 3371 } 3372 3373 void Value::print(raw_ostream &ROS, bool IsForDebug) const { 3374 bool ShouldInitializeAllMetadata = false; 3375 if (auto *I = dyn_cast<Instruction>(this)) 3376 ShouldInitializeAllMetadata = isReferencingMDNode(*I); 3377 else if (isa<Function>(this) || isa<MetadataAsValue>(this)) 3378 ShouldInitializeAllMetadata = true; 3379 3380 ModuleSlotTracker MST(getModuleFromVal(this), ShouldInitializeAllMetadata); 3381 print(ROS, MST, IsForDebug); 3382 } 3383 3384 void Value::print(raw_ostream &ROS, ModuleSlotTracker &MST, 3385 bool IsForDebug) const { 3386 formatted_raw_ostream OS(ROS); 3387 SlotTracker EmptySlotTable(static_cast<const Module *>(nullptr)); 3388 SlotTracker &SlotTable = 3389 MST.getMachine() ? *MST.getMachine() : EmptySlotTable; 3390 auto incorporateFunction = [&](const Function *F) { 3391 if (F) 3392 MST.incorporateFunction(*F); 3393 }; 3394 3395 if (const Instruction *I = dyn_cast<Instruction>(this)) { 3396 incorporateFunction(I->getParent() ? I->getParent()->getParent() : nullptr); 3397 AssemblyWriter W(OS, SlotTable, getModuleFromVal(I), nullptr, IsForDebug); 3398 W.printInstruction(*I); 3399 } else if (const BasicBlock *BB = dyn_cast<BasicBlock>(this)) { 3400 incorporateFunction(BB->getParent()); 3401 AssemblyWriter W(OS, SlotTable, getModuleFromVal(BB), nullptr, IsForDebug); 3402 W.printBasicBlock(BB); 3403 } else if (const GlobalValue *GV = dyn_cast<GlobalValue>(this)) { 3404 AssemblyWriter W(OS, SlotTable, GV->getParent(), nullptr, IsForDebug); 3405 if (const GlobalVariable *V = dyn_cast<GlobalVariable>(GV)) 3406 W.printGlobal(V); 3407 else if (const Function *F = dyn_cast<Function>(GV)) 3408 W.printFunction(F); 3409 else 3410 W.printIndirectSymbol(cast<GlobalIndirectSymbol>(GV)); 3411 } else if (const MetadataAsValue *V = dyn_cast<MetadataAsValue>(this)) { 3412 V->getMetadata()->print(ROS, MST, getModuleFromVal(V)); 3413 } else if (const Constant *C = dyn_cast<Constant>(this)) { 3414 TypePrinting TypePrinter; 3415 TypePrinter.print(C->getType(), OS); 3416 OS << ' '; 3417 WriteConstantInternal(OS, C, TypePrinter, MST.getMachine(), nullptr); 3418 } else if (isa<InlineAsm>(this) || isa<Argument>(this)) { 3419 this->printAsOperand(OS, /* PrintType */ true, MST); 3420 } else { 3421 llvm_unreachable("Unknown value to print out!"); 3422 } 3423 } 3424 3425 /// Print without a type, skipping the TypePrinting object. 3426 /// 3427 /// \return \c true iff printing was successful. 3428 static bool printWithoutType(const Value &V, raw_ostream &O, 3429 SlotTracker *Machine, const Module *M) { 3430 if (V.hasName() || isa<GlobalValue>(V) || 3431 (!isa<Constant>(V) && !isa<MetadataAsValue>(V))) { 3432 WriteAsOperandInternal(O, &V, nullptr, Machine, M); 3433 return true; 3434 } 3435 return false; 3436 } 3437 3438 static void printAsOperandImpl(const Value &V, raw_ostream &O, bool PrintType, 3439 ModuleSlotTracker &MST) { 3440 TypePrinting TypePrinter; 3441 if (const Module *M = MST.getModule()) 3442 TypePrinter.incorporateTypes(*M); 3443 if (PrintType) { 3444 TypePrinter.print(V.getType(), O); 3445 O << ' '; 3446 } 3447 3448 WriteAsOperandInternal(O, &V, &TypePrinter, MST.getMachine(), 3449 MST.getModule()); 3450 } 3451 3452 void Value::printAsOperand(raw_ostream &O, bool PrintType, 3453 const Module *M) const { 3454 if (!M) 3455 M = getModuleFromVal(this); 3456 3457 if (!PrintType) 3458 if (printWithoutType(*this, O, nullptr, M)) 3459 return; 3460 3461 SlotTracker Machine( 3462 M, /* ShouldInitializeAllMetadata */ isa<MetadataAsValue>(this)); 3463 ModuleSlotTracker MST(Machine, M); 3464 printAsOperandImpl(*this, O, PrintType, MST); 3465 } 3466 3467 void Value::printAsOperand(raw_ostream &O, bool PrintType, 3468 ModuleSlotTracker &MST) const { 3469 if (!PrintType) 3470 if (printWithoutType(*this, O, MST.getMachine(), MST.getModule())) 3471 return; 3472 3473 printAsOperandImpl(*this, O, PrintType, MST); 3474 } 3475 3476 static void printMetadataImpl(raw_ostream &ROS, const Metadata &MD, 3477 ModuleSlotTracker &MST, const Module *M, 3478 bool OnlyAsOperand) { 3479 formatted_raw_ostream OS(ROS); 3480 3481 TypePrinting TypePrinter; 3482 if (M) 3483 TypePrinter.incorporateTypes(*M); 3484 3485 WriteAsOperandInternal(OS, &MD, &TypePrinter, MST.getMachine(), M, 3486 /* FromValue */ true); 3487 3488 auto *N = dyn_cast<MDNode>(&MD); 3489 if (OnlyAsOperand || !N) 3490 return; 3491 3492 OS << " = "; 3493 WriteMDNodeBodyInternal(OS, N, &TypePrinter, MST.getMachine(), M); 3494 } 3495 3496 void Metadata::printAsOperand(raw_ostream &OS, const Module *M) const { 3497 ModuleSlotTracker MST(M, isa<MDNode>(this)); 3498 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ true); 3499 } 3500 3501 void Metadata::printAsOperand(raw_ostream &OS, ModuleSlotTracker &MST, 3502 const Module *M) const { 3503 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ true); 3504 } 3505 3506 void Metadata::print(raw_ostream &OS, const Module *M, 3507 bool /*IsForDebug*/) const { 3508 ModuleSlotTracker MST(M, isa<MDNode>(this)); 3509 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ false); 3510 } 3511 3512 void Metadata::print(raw_ostream &OS, ModuleSlotTracker &MST, 3513 const Module *M, bool /*IsForDebug*/) const { 3514 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ false); 3515 } 3516 3517 // Value::dump - allow easy printing of Values from the debugger. 3518 LLVM_DUMP_METHOD 3519 void Value::dump() const { print(dbgs(), /*IsForDebug=*/true); dbgs() << '\n'; } 3520 3521 // Type::dump - allow easy printing of Types from the debugger. 3522 LLVM_DUMP_METHOD 3523 void Type::dump() const { print(dbgs(), /*IsForDebug=*/true); dbgs() << '\n'; } 3524 3525 // Module::dump() - Allow printing of Modules from the debugger. 3526 LLVM_DUMP_METHOD 3527 void Module::dump() const { 3528 print(dbgs(), nullptr, 3529 /*ShouldPreserveUseListOrder=*/false, /*IsForDebug=*/true); 3530 } 3531 3532 // \brief Allow printing of Comdats from the debugger. 3533 LLVM_DUMP_METHOD 3534 void Comdat::dump() const { print(dbgs(), /*IsForDebug=*/true); } 3535 3536 // NamedMDNode::dump() - Allow printing of NamedMDNodes from the debugger. 3537 LLVM_DUMP_METHOD 3538 void NamedMDNode::dump() const { print(dbgs(), /*IsForDebug=*/true); } 3539 3540 LLVM_DUMP_METHOD 3541 void Metadata::dump() const { dump(nullptr); } 3542 3543 LLVM_DUMP_METHOD 3544 void Metadata::dump(const Module *M) const { 3545 print(dbgs(), M, /*IsForDebug=*/true); 3546 dbgs() << '\n'; 3547 } 3548