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("declaration", N->getRawStaticDataMemberDeclaration()); 1831 Printer.printInt("align", N->getAlignInBits()); 1832 Out << ")"; 1833 } 1834 1835 static void writeDILocalVariable(raw_ostream &Out, const DILocalVariable *N, 1836 TypePrinting *TypePrinter, 1837 SlotTracker *Machine, const Module *Context) { 1838 Out << "!DILocalVariable("; 1839 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1840 Printer.printString("name", N->getName()); 1841 Printer.printInt("arg", N->getArg()); 1842 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1843 Printer.printMetadata("file", N->getRawFile()); 1844 Printer.printInt("line", N->getLine()); 1845 Printer.printMetadata("type", N->getRawType()); 1846 Printer.printDIFlags("flags", N->getFlags()); 1847 Printer.printInt("align", N->getAlignInBits()); 1848 Out << ")"; 1849 } 1850 1851 static void writeDIExpression(raw_ostream &Out, const DIExpression *N, 1852 TypePrinting *TypePrinter, SlotTracker *Machine, 1853 const Module *Context) { 1854 Out << "!DIExpression("; 1855 FieldSeparator FS; 1856 if (N->isValid()) { 1857 for (auto I = N->expr_op_begin(), E = N->expr_op_end(); I != E; ++I) { 1858 auto OpStr = dwarf::OperationEncodingString(I->getOp()); 1859 assert(!OpStr.empty() && "Expected valid opcode"); 1860 1861 Out << FS << OpStr; 1862 for (unsigned A = 0, AE = I->getNumArgs(); A != AE; ++A) 1863 Out << FS << I->getArg(A); 1864 } 1865 } else { 1866 for (const auto &I : N->getElements()) 1867 Out << FS << I; 1868 } 1869 Out << ")"; 1870 } 1871 1872 static void writeDIGlobalVariableExpression(raw_ostream &Out, 1873 const DIGlobalVariableExpression *N, 1874 TypePrinting *TypePrinter, 1875 SlotTracker *Machine, 1876 const Module *Context) { 1877 Out << "!DIGlobalVariableExpression("; 1878 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1879 Printer.printMetadata("var", N->getVariable()); 1880 Printer.printMetadata("expr", N->getExpression()); 1881 Out << ")"; 1882 } 1883 1884 static void writeDIObjCProperty(raw_ostream &Out, const DIObjCProperty *N, 1885 TypePrinting *TypePrinter, SlotTracker *Machine, 1886 const Module *Context) { 1887 Out << "!DIObjCProperty("; 1888 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1889 Printer.printString("name", N->getName()); 1890 Printer.printMetadata("file", N->getRawFile()); 1891 Printer.printInt("line", N->getLine()); 1892 Printer.printString("setter", N->getSetterName()); 1893 Printer.printString("getter", N->getGetterName()); 1894 Printer.printInt("attributes", N->getAttributes()); 1895 Printer.printMetadata("type", N->getRawType()); 1896 Out << ")"; 1897 } 1898 1899 static void writeDIImportedEntity(raw_ostream &Out, const DIImportedEntity *N, 1900 TypePrinting *TypePrinter, 1901 SlotTracker *Machine, const Module *Context) { 1902 Out << "!DIImportedEntity("; 1903 MDFieldPrinter Printer(Out, TypePrinter, Machine, Context); 1904 Printer.printTag(N); 1905 Printer.printString("name", N->getName()); 1906 Printer.printMetadata("scope", N->getRawScope(), /* ShouldSkipNull */ false); 1907 Printer.printMetadata("entity", N->getRawEntity()); 1908 Printer.printInt("line", N->getLine()); 1909 Out << ")"; 1910 } 1911 1912 1913 static void WriteMDNodeBodyInternal(raw_ostream &Out, const MDNode *Node, 1914 TypePrinting *TypePrinter, 1915 SlotTracker *Machine, 1916 const Module *Context) { 1917 if (Node->isDistinct()) 1918 Out << "distinct "; 1919 else if (Node->isTemporary()) 1920 Out << "<temporary!> "; // Handle broken code. 1921 1922 switch (Node->getMetadataID()) { 1923 default: 1924 llvm_unreachable("Expected uniquable MDNode"); 1925 #define HANDLE_MDNODE_LEAF(CLASS) \ 1926 case Metadata::CLASS##Kind: \ 1927 write##CLASS(Out, cast<CLASS>(Node), TypePrinter, Machine, Context); \ 1928 break; 1929 #include "llvm/IR/Metadata.def" 1930 } 1931 } 1932 1933 // Full implementation of printing a Value as an operand with support for 1934 // TypePrinting, etc. 1935 static void WriteAsOperandInternal(raw_ostream &Out, const Value *V, 1936 TypePrinting *TypePrinter, 1937 SlotTracker *Machine, 1938 const Module *Context) { 1939 if (V->hasName()) { 1940 PrintLLVMName(Out, V); 1941 return; 1942 } 1943 1944 const Constant *CV = dyn_cast<Constant>(V); 1945 if (CV && !isa<GlobalValue>(CV)) { 1946 assert(TypePrinter && "Constants require TypePrinting!"); 1947 WriteConstantInternal(Out, CV, *TypePrinter, Machine, Context); 1948 return; 1949 } 1950 1951 if (const InlineAsm *IA = dyn_cast<InlineAsm>(V)) { 1952 Out << "asm "; 1953 if (IA->hasSideEffects()) 1954 Out << "sideeffect "; 1955 if (IA->isAlignStack()) 1956 Out << "alignstack "; 1957 // We don't emit the AD_ATT dialect as it's the assumed default. 1958 if (IA->getDialect() == InlineAsm::AD_Intel) 1959 Out << "inteldialect "; 1960 Out << '"'; 1961 PrintEscapedString(IA->getAsmString(), Out); 1962 Out << "\", \""; 1963 PrintEscapedString(IA->getConstraintString(), Out); 1964 Out << '"'; 1965 return; 1966 } 1967 1968 if (auto *MD = dyn_cast<MetadataAsValue>(V)) { 1969 WriteAsOperandInternal(Out, MD->getMetadata(), TypePrinter, Machine, 1970 Context, /* FromValue */ true); 1971 return; 1972 } 1973 1974 char Prefix = '%'; 1975 int Slot; 1976 // If we have a SlotTracker, use it. 1977 if (Machine) { 1978 if (const GlobalValue *GV = dyn_cast<GlobalValue>(V)) { 1979 Slot = Machine->getGlobalSlot(GV); 1980 Prefix = '@'; 1981 } else { 1982 Slot = Machine->getLocalSlot(V); 1983 1984 // If the local value didn't succeed, then we may be referring to a value 1985 // from a different function. Translate it, as this can happen when using 1986 // address of blocks. 1987 if (Slot == -1) 1988 if ((Machine = createSlotTracker(V))) { 1989 Slot = Machine->getLocalSlot(V); 1990 delete Machine; 1991 } 1992 } 1993 } else if ((Machine = createSlotTracker(V))) { 1994 // Otherwise, create one to get the # and then destroy it. 1995 if (const GlobalValue *GV = dyn_cast<GlobalValue>(V)) { 1996 Slot = Machine->getGlobalSlot(GV); 1997 Prefix = '@'; 1998 } else { 1999 Slot = Machine->getLocalSlot(V); 2000 } 2001 delete Machine; 2002 Machine = nullptr; 2003 } else { 2004 Slot = -1; 2005 } 2006 2007 if (Slot != -1) 2008 Out << Prefix << Slot; 2009 else 2010 Out << "<badref>"; 2011 } 2012 2013 static void WriteAsOperandInternal(raw_ostream &Out, const Metadata *MD, 2014 TypePrinting *TypePrinter, 2015 SlotTracker *Machine, const Module *Context, 2016 bool FromValue) { 2017 if (const MDNode *N = dyn_cast<MDNode>(MD)) { 2018 std::unique_ptr<SlotTracker> MachineStorage; 2019 if (!Machine) { 2020 MachineStorage = make_unique<SlotTracker>(Context); 2021 Machine = MachineStorage.get(); 2022 } 2023 int Slot = Machine->getMetadataSlot(N); 2024 if (Slot == -1) 2025 // Give the pointer value instead of "badref", since this comes up all 2026 // the time when debugging. 2027 Out << "<" << N << ">"; 2028 else 2029 Out << '!' << Slot; 2030 return; 2031 } 2032 2033 if (const MDString *MDS = dyn_cast<MDString>(MD)) { 2034 Out << "!\""; 2035 PrintEscapedString(MDS->getString(), Out); 2036 Out << '"'; 2037 return; 2038 } 2039 2040 auto *V = cast<ValueAsMetadata>(MD); 2041 assert(TypePrinter && "TypePrinter required for metadata values"); 2042 assert((FromValue || !isa<LocalAsMetadata>(V)) && 2043 "Unexpected function-local metadata outside of value argument"); 2044 2045 TypePrinter->print(V->getValue()->getType(), Out); 2046 Out << ' '; 2047 WriteAsOperandInternal(Out, V->getValue(), TypePrinter, Machine, Context); 2048 } 2049 2050 namespace { 2051 class AssemblyWriter { 2052 formatted_raw_ostream &Out; 2053 const Module *TheModule; 2054 std::unique_ptr<SlotTracker> SlotTrackerStorage; 2055 SlotTracker &Machine; 2056 TypePrinting TypePrinter; 2057 AssemblyAnnotationWriter *AnnotationWriter; 2058 SetVector<const Comdat *> Comdats; 2059 bool IsForDebug; 2060 bool ShouldPreserveUseListOrder; 2061 UseListOrderStack UseListOrders; 2062 SmallVector<StringRef, 8> MDNames; 2063 2064 public: 2065 /// Construct an AssemblyWriter with an external SlotTracker 2066 AssemblyWriter(formatted_raw_ostream &o, SlotTracker &Mac, const Module *M, 2067 AssemblyAnnotationWriter *AAW, bool IsForDebug, 2068 bool ShouldPreserveUseListOrder = false); 2069 2070 void printMDNodeBody(const MDNode *MD); 2071 void printNamedMDNode(const NamedMDNode *NMD); 2072 2073 void printModule(const Module *M); 2074 2075 void writeOperand(const Value *Op, bool PrintType); 2076 void writeParamOperand(const Value *Operand, AttributeSet Attrs,unsigned Idx); 2077 void writeOperandBundles(ImmutableCallSite CS); 2078 void writeAtomic(AtomicOrdering Ordering, SynchronizationScope SynchScope); 2079 void writeAtomicCmpXchg(AtomicOrdering SuccessOrdering, 2080 AtomicOrdering FailureOrdering, 2081 SynchronizationScope SynchScope); 2082 2083 void writeAllMDNodes(); 2084 void writeMDNode(unsigned Slot, const MDNode *Node); 2085 void writeAllAttributeGroups(); 2086 2087 void printTypeIdentities(); 2088 void printGlobal(const GlobalVariable *GV); 2089 void printIndirectSymbol(const GlobalIndirectSymbol *GIS); 2090 void printComdat(const Comdat *C); 2091 void printFunction(const Function *F); 2092 void printArgument(const Argument *FA, AttributeSet Attrs, unsigned Idx); 2093 void printBasicBlock(const BasicBlock *BB); 2094 void printInstructionLine(const Instruction &I); 2095 void printInstruction(const Instruction &I); 2096 2097 void printUseListOrder(const UseListOrder &Order); 2098 void printUseLists(const Function *F); 2099 2100 private: 2101 /// \brief Print out metadata attachments. 2102 void printMetadataAttachments( 2103 const SmallVectorImpl<std::pair<unsigned, MDNode *>> &MDs, 2104 StringRef Separator); 2105 2106 // printInfoComment - Print a little comment after the instruction indicating 2107 // which slot it occupies. 2108 void printInfoComment(const Value &V); 2109 2110 // printGCRelocateComment - print comment after call to the gc.relocate 2111 // intrinsic indicating base and derived pointer names. 2112 void printGCRelocateComment(const GCRelocateInst &Relocate); 2113 }; 2114 } // namespace 2115 2116 AssemblyWriter::AssemblyWriter(formatted_raw_ostream &o, SlotTracker &Mac, 2117 const Module *M, AssemblyAnnotationWriter *AAW, 2118 bool IsForDebug, bool ShouldPreserveUseListOrder) 2119 : Out(o), TheModule(M), Machine(Mac), AnnotationWriter(AAW), 2120 IsForDebug(IsForDebug), 2121 ShouldPreserveUseListOrder(ShouldPreserveUseListOrder) { 2122 if (!TheModule) 2123 return; 2124 TypePrinter.incorporateTypes(*TheModule); 2125 for (const GlobalObject &GO : TheModule->global_objects()) 2126 if (const Comdat *C = GO.getComdat()) 2127 Comdats.insert(C); 2128 } 2129 2130 void AssemblyWriter::writeOperand(const Value *Operand, bool PrintType) { 2131 if (!Operand) { 2132 Out << "<null operand!>"; 2133 return; 2134 } 2135 if (PrintType) { 2136 TypePrinter.print(Operand->getType(), Out); 2137 Out << ' '; 2138 } 2139 WriteAsOperandInternal(Out, Operand, &TypePrinter, &Machine, TheModule); 2140 } 2141 2142 void AssemblyWriter::writeAtomic(AtomicOrdering Ordering, 2143 SynchronizationScope SynchScope) { 2144 if (Ordering == AtomicOrdering::NotAtomic) 2145 return; 2146 2147 switch (SynchScope) { 2148 case SingleThread: Out << " singlethread"; break; 2149 case CrossThread: break; 2150 } 2151 2152 Out << " " << toIRString(Ordering); 2153 } 2154 2155 void AssemblyWriter::writeAtomicCmpXchg(AtomicOrdering SuccessOrdering, 2156 AtomicOrdering FailureOrdering, 2157 SynchronizationScope SynchScope) { 2158 assert(SuccessOrdering != AtomicOrdering::NotAtomic && 2159 FailureOrdering != AtomicOrdering::NotAtomic); 2160 2161 switch (SynchScope) { 2162 case SingleThread: Out << " singlethread"; break; 2163 case CrossThread: break; 2164 } 2165 2166 Out << " " << toIRString(SuccessOrdering); 2167 Out << " " << toIRString(FailureOrdering); 2168 } 2169 2170 void AssemblyWriter::writeParamOperand(const Value *Operand, 2171 AttributeSet Attrs, unsigned Idx) { 2172 if (!Operand) { 2173 Out << "<null operand!>"; 2174 return; 2175 } 2176 2177 // Print the type 2178 TypePrinter.print(Operand->getType(), Out); 2179 // Print parameter attributes list 2180 if (Attrs.hasAttributes(Idx)) 2181 Out << ' ' << Attrs.getAsString(Idx); 2182 Out << ' '; 2183 // Print the operand 2184 WriteAsOperandInternal(Out, Operand, &TypePrinter, &Machine, TheModule); 2185 } 2186 2187 void AssemblyWriter::writeOperandBundles(ImmutableCallSite CS) { 2188 if (!CS.hasOperandBundles()) 2189 return; 2190 2191 Out << " [ "; 2192 2193 bool FirstBundle = true; 2194 for (unsigned i = 0, e = CS.getNumOperandBundles(); i != e; ++i) { 2195 OperandBundleUse BU = CS.getOperandBundleAt(i); 2196 2197 if (!FirstBundle) 2198 Out << ", "; 2199 FirstBundle = false; 2200 2201 Out << '"'; 2202 PrintEscapedString(BU.getTagName(), Out); 2203 Out << '"'; 2204 2205 Out << '('; 2206 2207 bool FirstInput = true; 2208 for (const auto &Input : BU.Inputs) { 2209 if (!FirstInput) 2210 Out << ", "; 2211 FirstInput = false; 2212 2213 TypePrinter.print(Input->getType(), Out); 2214 Out << " "; 2215 WriteAsOperandInternal(Out, Input, &TypePrinter, &Machine, TheModule); 2216 } 2217 2218 Out << ')'; 2219 } 2220 2221 Out << " ]"; 2222 } 2223 2224 void AssemblyWriter::printModule(const Module *M) { 2225 Machine.initialize(); 2226 2227 if (ShouldPreserveUseListOrder) 2228 UseListOrders = predictUseListOrder(M); 2229 2230 if (!M->getModuleIdentifier().empty() && 2231 // Don't print the ID if it will start a new line (which would 2232 // require a comment char before it). 2233 M->getModuleIdentifier().find('\n') == std::string::npos) 2234 Out << "; ModuleID = '" << M->getModuleIdentifier() << "'\n"; 2235 2236 if (!M->getSourceFileName().empty()) { 2237 Out << "source_filename = \""; 2238 PrintEscapedString(M->getSourceFileName(), Out); 2239 Out << "\"\n"; 2240 } 2241 2242 const std::string &DL = M->getDataLayoutStr(); 2243 if (!DL.empty()) 2244 Out << "target datalayout = \"" << DL << "\"\n"; 2245 if (!M->getTargetTriple().empty()) 2246 Out << "target triple = \"" << M->getTargetTriple() << "\"\n"; 2247 2248 if (!M->getModuleInlineAsm().empty()) { 2249 Out << '\n'; 2250 2251 // Split the string into lines, to make it easier to read the .ll file. 2252 StringRef Asm = M->getModuleInlineAsm(); 2253 do { 2254 StringRef Front; 2255 std::tie(Front, Asm) = Asm.split('\n'); 2256 2257 // We found a newline, print the portion of the asm string from the 2258 // last newline up to this newline. 2259 Out << "module asm \""; 2260 PrintEscapedString(Front, Out); 2261 Out << "\"\n"; 2262 } while (!Asm.empty()); 2263 } 2264 2265 printTypeIdentities(); 2266 2267 // Output all comdats. 2268 if (!Comdats.empty()) 2269 Out << '\n'; 2270 for (const Comdat *C : Comdats) { 2271 printComdat(C); 2272 if (C != Comdats.back()) 2273 Out << '\n'; 2274 } 2275 2276 // Output all globals. 2277 if (!M->global_empty()) Out << '\n'; 2278 for (const GlobalVariable &GV : M->globals()) { 2279 printGlobal(&GV); Out << '\n'; 2280 } 2281 2282 // Output all aliases. 2283 if (!M->alias_empty()) Out << "\n"; 2284 for (const GlobalAlias &GA : M->aliases()) 2285 printIndirectSymbol(&GA); 2286 2287 // Output all ifuncs. 2288 if (!M->ifunc_empty()) Out << "\n"; 2289 for (const GlobalIFunc &GI : M->ifuncs()) 2290 printIndirectSymbol(&GI); 2291 2292 // Output global use-lists. 2293 printUseLists(nullptr); 2294 2295 // Output all of the functions. 2296 for (const Function &F : *M) 2297 printFunction(&F); 2298 assert(UseListOrders.empty() && "All use-lists should have been consumed"); 2299 2300 // Output all attribute groups. 2301 if (!Machine.as_empty()) { 2302 Out << '\n'; 2303 writeAllAttributeGroups(); 2304 } 2305 2306 // Output named metadata. 2307 if (!M->named_metadata_empty()) Out << '\n'; 2308 2309 for (const NamedMDNode &Node : M->named_metadata()) 2310 printNamedMDNode(&Node); 2311 2312 // Output metadata. 2313 if (!Machine.mdn_empty()) { 2314 Out << '\n'; 2315 writeAllMDNodes(); 2316 } 2317 } 2318 2319 static void printMetadataIdentifier(StringRef Name, 2320 formatted_raw_ostream &Out) { 2321 if (Name.empty()) { 2322 Out << "<empty name> "; 2323 } else { 2324 if (isalpha(static_cast<unsigned char>(Name[0])) || Name[0] == '-' || 2325 Name[0] == '$' || Name[0] == '.' || Name[0] == '_') 2326 Out << Name[0]; 2327 else 2328 Out << '\\' << hexdigit(Name[0] >> 4) << hexdigit(Name[0] & 0x0F); 2329 for (unsigned i = 1, e = Name.size(); i != e; ++i) { 2330 unsigned char C = Name[i]; 2331 if (isalnum(static_cast<unsigned char>(C)) || C == '-' || C == '$' || 2332 C == '.' || C == '_') 2333 Out << C; 2334 else 2335 Out << '\\' << hexdigit(C >> 4) << hexdigit(C & 0x0F); 2336 } 2337 } 2338 } 2339 2340 void AssemblyWriter::printNamedMDNode(const NamedMDNode *NMD) { 2341 Out << '!'; 2342 printMetadataIdentifier(NMD->getName(), Out); 2343 Out << " = !{"; 2344 for (unsigned i = 0, e = NMD->getNumOperands(); i != e; ++i) { 2345 if (i) 2346 Out << ", "; 2347 int Slot = Machine.getMetadataSlot(NMD->getOperand(i)); 2348 if (Slot == -1) 2349 Out << "<badref>"; 2350 else 2351 Out << '!' << Slot; 2352 } 2353 Out << "}\n"; 2354 } 2355 2356 static const char *getLinkagePrintName(GlobalValue::LinkageTypes LT) { 2357 switch (LT) { 2358 case GlobalValue::ExternalLinkage: 2359 return ""; 2360 case GlobalValue::PrivateLinkage: 2361 return "private "; 2362 case GlobalValue::InternalLinkage: 2363 return "internal "; 2364 case GlobalValue::LinkOnceAnyLinkage: 2365 return "linkonce "; 2366 case GlobalValue::LinkOnceODRLinkage: 2367 return "linkonce_odr "; 2368 case GlobalValue::WeakAnyLinkage: 2369 return "weak "; 2370 case GlobalValue::WeakODRLinkage: 2371 return "weak_odr "; 2372 case GlobalValue::CommonLinkage: 2373 return "common "; 2374 case GlobalValue::AppendingLinkage: 2375 return "appending "; 2376 case GlobalValue::ExternalWeakLinkage: 2377 return "extern_weak "; 2378 case GlobalValue::AvailableExternallyLinkage: 2379 return "available_externally "; 2380 } 2381 llvm_unreachable("invalid linkage"); 2382 } 2383 2384 static void PrintVisibility(GlobalValue::VisibilityTypes Vis, 2385 formatted_raw_ostream &Out) { 2386 switch (Vis) { 2387 case GlobalValue::DefaultVisibility: break; 2388 case GlobalValue::HiddenVisibility: Out << "hidden "; break; 2389 case GlobalValue::ProtectedVisibility: Out << "protected "; break; 2390 } 2391 } 2392 2393 static void PrintDLLStorageClass(GlobalValue::DLLStorageClassTypes SCT, 2394 formatted_raw_ostream &Out) { 2395 switch (SCT) { 2396 case GlobalValue::DefaultStorageClass: break; 2397 case GlobalValue::DLLImportStorageClass: Out << "dllimport "; break; 2398 case GlobalValue::DLLExportStorageClass: Out << "dllexport "; break; 2399 } 2400 } 2401 2402 static void PrintThreadLocalModel(GlobalVariable::ThreadLocalMode TLM, 2403 formatted_raw_ostream &Out) { 2404 switch (TLM) { 2405 case GlobalVariable::NotThreadLocal: 2406 break; 2407 case GlobalVariable::GeneralDynamicTLSModel: 2408 Out << "thread_local "; 2409 break; 2410 case GlobalVariable::LocalDynamicTLSModel: 2411 Out << "thread_local(localdynamic) "; 2412 break; 2413 case GlobalVariable::InitialExecTLSModel: 2414 Out << "thread_local(initialexec) "; 2415 break; 2416 case GlobalVariable::LocalExecTLSModel: 2417 Out << "thread_local(localexec) "; 2418 break; 2419 } 2420 } 2421 2422 static StringRef getUnnamedAddrEncoding(GlobalVariable::UnnamedAddr UA) { 2423 switch (UA) { 2424 case GlobalVariable::UnnamedAddr::None: 2425 return ""; 2426 case GlobalVariable::UnnamedAddr::Local: 2427 return "local_unnamed_addr"; 2428 case GlobalVariable::UnnamedAddr::Global: 2429 return "unnamed_addr"; 2430 } 2431 llvm_unreachable("Unknown UnnamedAddr"); 2432 } 2433 2434 static void maybePrintComdat(formatted_raw_ostream &Out, 2435 const GlobalObject &GO) { 2436 const Comdat *C = GO.getComdat(); 2437 if (!C) 2438 return; 2439 2440 if (isa<GlobalVariable>(GO)) 2441 Out << ','; 2442 Out << " comdat"; 2443 2444 if (GO.getName() == C->getName()) 2445 return; 2446 2447 Out << '('; 2448 PrintLLVMName(Out, C->getName(), ComdatPrefix); 2449 Out << ')'; 2450 } 2451 2452 void AssemblyWriter::printGlobal(const GlobalVariable *GV) { 2453 if (GV->isMaterializable()) 2454 Out << "; Materializable\n"; 2455 2456 WriteAsOperandInternal(Out, GV, &TypePrinter, &Machine, GV->getParent()); 2457 Out << " = "; 2458 2459 if (!GV->hasInitializer() && GV->hasExternalLinkage()) 2460 Out << "external "; 2461 2462 Out << getLinkagePrintName(GV->getLinkage()); 2463 PrintVisibility(GV->getVisibility(), Out); 2464 PrintDLLStorageClass(GV->getDLLStorageClass(), Out); 2465 PrintThreadLocalModel(GV->getThreadLocalMode(), Out); 2466 StringRef UA = getUnnamedAddrEncoding(GV->getUnnamedAddr()); 2467 if (!UA.empty()) 2468 Out << UA << ' '; 2469 2470 if (unsigned AddressSpace = GV->getType()->getAddressSpace()) 2471 Out << "addrspace(" << AddressSpace << ") "; 2472 if (GV->isExternallyInitialized()) Out << "externally_initialized "; 2473 Out << (GV->isConstant() ? "constant " : "global "); 2474 TypePrinter.print(GV->getValueType(), Out); 2475 2476 if (GV->hasInitializer()) { 2477 Out << ' '; 2478 writeOperand(GV->getInitializer(), false); 2479 } 2480 2481 if (GV->hasSection()) { 2482 Out << ", section \""; 2483 PrintEscapedString(GV->getSection(), Out); 2484 Out << '"'; 2485 } 2486 maybePrintComdat(Out, *GV); 2487 if (GV->getAlignment()) 2488 Out << ", align " << GV->getAlignment(); 2489 2490 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 2491 GV->getAllMetadata(MDs); 2492 printMetadataAttachments(MDs, ", "); 2493 2494 printInfoComment(*GV); 2495 } 2496 2497 void AssemblyWriter::printIndirectSymbol(const GlobalIndirectSymbol *GIS) { 2498 if (GIS->isMaterializable()) 2499 Out << "; Materializable\n"; 2500 2501 WriteAsOperandInternal(Out, GIS, &TypePrinter, &Machine, GIS->getParent()); 2502 Out << " = "; 2503 2504 Out << getLinkagePrintName(GIS->getLinkage()); 2505 PrintVisibility(GIS->getVisibility(), Out); 2506 PrintDLLStorageClass(GIS->getDLLStorageClass(), Out); 2507 PrintThreadLocalModel(GIS->getThreadLocalMode(), Out); 2508 StringRef UA = getUnnamedAddrEncoding(GIS->getUnnamedAddr()); 2509 if (!UA.empty()) 2510 Out << UA << ' '; 2511 2512 if (isa<GlobalAlias>(GIS)) 2513 Out << "alias "; 2514 else if (isa<GlobalIFunc>(GIS)) 2515 Out << "ifunc "; 2516 else 2517 llvm_unreachable("Not an alias or ifunc!"); 2518 2519 TypePrinter.print(GIS->getValueType(), Out); 2520 2521 Out << ", "; 2522 2523 const Constant *IS = GIS->getIndirectSymbol(); 2524 2525 if (!IS) { 2526 TypePrinter.print(GIS->getType(), Out); 2527 Out << " <<NULL ALIASEE>>"; 2528 } else { 2529 writeOperand(IS, !isa<ConstantExpr>(IS)); 2530 } 2531 2532 printInfoComment(*GIS); 2533 Out << '\n'; 2534 } 2535 2536 void AssemblyWriter::printComdat(const Comdat *C) { 2537 C->print(Out); 2538 } 2539 2540 void AssemblyWriter::printTypeIdentities() { 2541 if (TypePrinter.NumberedTypes.empty() && 2542 TypePrinter.NamedTypes.empty()) 2543 return; 2544 2545 Out << '\n'; 2546 2547 // We know all the numbers that each type is used and we know that it is a 2548 // dense assignment. Convert the map to an index table. 2549 std::vector<StructType*> NumberedTypes(TypePrinter.NumberedTypes.size()); 2550 for (DenseMap<StructType*, unsigned>::iterator I = 2551 TypePrinter.NumberedTypes.begin(), E = TypePrinter.NumberedTypes.end(); 2552 I != E; ++I) { 2553 assert(I->second < NumberedTypes.size() && "Didn't get a dense numbering?"); 2554 NumberedTypes[I->second] = I->first; 2555 } 2556 2557 // Emit all numbered types. 2558 for (unsigned i = 0, e = NumberedTypes.size(); i != e; ++i) { 2559 Out << '%' << i << " = type "; 2560 2561 // Make sure we print out at least one level of the type structure, so 2562 // that we do not get %2 = type %2 2563 TypePrinter.printStructBody(NumberedTypes[i], Out); 2564 Out << '\n'; 2565 } 2566 2567 for (unsigned i = 0, e = TypePrinter.NamedTypes.size(); i != e; ++i) { 2568 PrintLLVMName(Out, TypePrinter.NamedTypes[i]->getName(), LocalPrefix); 2569 Out << " = type "; 2570 2571 // Make sure we print out at least one level of the type structure, so 2572 // that we do not get %FILE = type %FILE 2573 TypePrinter.printStructBody(TypePrinter.NamedTypes[i], Out); 2574 Out << '\n'; 2575 } 2576 } 2577 2578 /// printFunction - Print all aspects of a function. 2579 /// 2580 void AssemblyWriter::printFunction(const Function *F) { 2581 // Print out the return type and name. 2582 Out << '\n'; 2583 2584 if (AnnotationWriter) AnnotationWriter->emitFunctionAnnot(F, Out); 2585 2586 if (F->isMaterializable()) 2587 Out << "; Materializable\n"; 2588 2589 const AttributeSet &Attrs = F->getAttributes(); 2590 if (Attrs.hasAttributes(AttributeSet::FunctionIndex)) { 2591 AttributeSet AS = Attrs.getFnAttributes(); 2592 std::string AttrStr; 2593 2594 unsigned Idx = 0; 2595 for (unsigned E = AS.getNumSlots(); Idx != E; ++Idx) 2596 if (AS.getSlotIndex(Idx) == AttributeSet::FunctionIndex) 2597 break; 2598 2599 for (AttributeSet::iterator I = AS.begin(Idx), E = AS.end(Idx); 2600 I != E; ++I) { 2601 Attribute Attr = *I; 2602 if (!Attr.isStringAttribute()) { 2603 if (!AttrStr.empty()) AttrStr += ' '; 2604 AttrStr += Attr.getAsString(); 2605 } 2606 } 2607 2608 if (!AttrStr.empty()) 2609 Out << "; Function Attrs: " << AttrStr << '\n'; 2610 } 2611 2612 Machine.incorporateFunction(F); 2613 2614 if (F->isDeclaration()) { 2615 Out << "declare"; 2616 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 2617 F->getAllMetadata(MDs); 2618 printMetadataAttachments(MDs, " "); 2619 Out << ' '; 2620 } else 2621 Out << "define "; 2622 2623 Out << getLinkagePrintName(F->getLinkage()); 2624 PrintVisibility(F->getVisibility(), Out); 2625 PrintDLLStorageClass(F->getDLLStorageClass(), Out); 2626 2627 // Print the calling convention. 2628 if (F->getCallingConv() != CallingConv::C) { 2629 PrintCallingConv(F->getCallingConv(), Out); 2630 Out << " "; 2631 } 2632 2633 FunctionType *FT = F->getFunctionType(); 2634 if (Attrs.hasAttributes(AttributeSet::ReturnIndex)) 2635 Out << Attrs.getAsString(AttributeSet::ReturnIndex) << ' '; 2636 TypePrinter.print(F->getReturnType(), Out); 2637 Out << ' '; 2638 WriteAsOperandInternal(Out, F, &TypePrinter, &Machine, F->getParent()); 2639 Out << '('; 2640 2641 // Loop over the arguments, printing them... 2642 if (F->isDeclaration() && !IsForDebug) { 2643 // We're only interested in the type here - don't print argument names. 2644 for (unsigned I = 0, E = FT->getNumParams(); I != E; ++I) { 2645 // Insert commas as we go... the first arg doesn't get a comma 2646 if (I) 2647 Out << ", "; 2648 // Output type... 2649 TypePrinter.print(FT->getParamType(I), Out); 2650 2651 if (Attrs.hasAttributes(I + 1)) 2652 Out << ' ' << Attrs.getAsString(I + 1); 2653 } 2654 } else { 2655 // The arguments are meaningful here, print them in detail. 2656 unsigned Idx = 1; 2657 for (const Argument &Arg : F->args()) { 2658 // Insert commas as we go... the first arg doesn't get a comma 2659 if (Idx != 1) 2660 Out << ", "; 2661 printArgument(&Arg, Attrs, Idx++); 2662 } 2663 } 2664 2665 // Finish printing arguments... 2666 if (FT->isVarArg()) { 2667 if (FT->getNumParams()) Out << ", "; 2668 Out << "..."; // Output varargs portion of signature! 2669 } 2670 Out << ')'; 2671 StringRef UA = getUnnamedAddrEncoding(F->getUnnamedAddr()); 2672 if (!UA.empty()) 2673 Out << ' ' << UA; 2674 if (Attrs.hasAttributes(AttributeSet::FunctionIndex)) 2675 Out << " #" << Machine.getAttributeGroupSlot(Attrs.getFnAttributes()); 2676 if (F->hasSection()) { 2677 Out << " section \""; 2678 PrintEscapedString(F->getSection(), Out); 2679 Out << '"'; 2680 } 2681 maybePrintComdat(Out, *F); 2682 if (F->getAlignment()) 2683 Out << " align " << F->getAlignment(); 2684 if (F->hasGC()) 2685 Out << " gc \"" << F->getGC() << '"'; 2686 if (F->hasPrefixData()) { 2687 Out << " prefix "; 2688 writeOperand(F->getPrefixData(), true); 2689 } 2690 if (F->hasPrologueData()) { 2691 Out << " prologue "; 2692 writeOperand(F->getPrologueData(), true); 2693 } 2694 if (F->hasPersonalityFn()) { 2695 Out << " personality "; 2696 writeOperand(F->getPersonalityFn(), /*PrintType=*/true); 2697 } 2698 2699 if (F->isDeclaration()) { 2700 Out << '\n'; 2701 } else { 2702 SmallVector<std::pair<unsigned, MDNode *>, 4> MDs; 2703 F->getAllMetadata(MDs); 2704 printMetadataAttachments(MDs, " "); 2705 2706 Out << " {"; 2707 // Output all of the function's basic blocks. 2708 for (const BasicBlock &BB : *F) 2709 printBasicBlock(&BB); 2710 2711 // Output the function's use-lists. 2712 printUseLists(F); 2713 2714 Out << "}\n"; 2715 } 2716 2717 Machine.purgeFunction(); 2718 } 2719 2720 /// printArgument - This member is called for every argument that is passed into 2721 /// the function. Simply print it out 2722 /// 2723 void AssemblyWriter::printArgument(const Argument *Arg, 2724 AttributeSet Attrs, unsigned Idx) { 2725 // Output type... 2726 TypePrinter.print(Arg->getType(), Out); 2727 2728 // Output parameter attributes list 2729 if (Attrs.hasAttributes(Idx)) 2730 Out << ' ' << Attrs.getAsString(Idx); 2731 2732 // Output name, if available... 2733 if (Arg->hasName()) { 2734 Out << ' '; 2735 PrintLLVMName(Out, Arg); 2736 } 2737 } 2738 2739 /// printBasicBlock - This member is called for each basic block in a method. 2740 /// 2741 void AssemblyWriter::printBasicBlock(const BasicBlock *BB) { 2742 if (BB->hasName()) { // Print out the label if it exists... 2743 Out << "\n"; 2744 PrintLLVMName(Out, BB->getName(), LabelPrefix); 2745 Out << ':'; 2746 } else if (!BB->use_empty()) { // Don't print block # of no uses... 2747 Out << "\n; <label>:"; 2748 int Slot = Machine.getLocalSlot(BB); 2749 if (Slot != -1) 2750 Out << Slot << ":"; 2751 else 2752 Out << "<badref>"; 2753 } 2754 2755 if (!BB->getParent()) { 2756 Out.PadToColumn(50); 2757 Out << "; Error: Block without parent!"; 2758 } else if (BB != &BB->getParent()->getEntryBlock()) { // Not the entry block? 2759 // Output predecessors for the block. 2760 Out.PadToColumn(50); 2761 Out << ";"; 2762 const_pred_iterator PI = pred_begin(BB), PE = pred_end(BB); 2763 2764 if (PI == PE) { 2765 Out << " No predecessors!"; 2766 } else { 2767 Out << " preds = "; 2768 writeOperand(*PI, false); 2769 for (++PI; PI != PE; ++PI) { 2770 Out << ", "; 2771 writeOperand(*PI, false); 2772 } 2773 } 2774 } 2775 2776 Out << "\n"; 2777 2778 if (AnnotationWriter) AnnotationWriter->emitBasicBlockStartAnnot(BB, Out); 2779 2780 // Output all of the instructions in the basic block... 2781 for (const Instruction &I : *BB) { 2782 printInstructionLine(I); 2783 } 2784 2785 if (AnnotationWriter) AnnotationWriter->emitBasicBlockEndAnnot(BB, Out); 2786 } 2787 2788 /// printInstructionLine - Print an instruction and a newline character. 2789 void AssemblyWriter::printInstructionLine(const Instruction &I) { 2790 printInstruction(I); 2791 Out << '\n'; 2792 } 2793 2794 /// printGCRelocateComment - print comment after call to the gc.relocate 2795 /// intrinsic indicating base and derived pointer names. 2796 void AssemblyWriter::printGCRelocateComment(const GCRelocateInst &Relocate) { 2797 Out << " ; ("; 2798 writeOperand(Relocate.getBasePtr(), false); 2799 Out << ", "; 2800 writeOperand(Relocate.getDerivedPtr(), false); 2801 Out << ")"; 2802 } 2803 2804 /// printInfoComment - Print a little comment after the instruction indicating 2805 /// which slot it occupies. 2806 /// 2807 void AssemblyWriter::printInfoComment(const Value &V) { 2808 if (const auto *Relocate = dyn_cast<GCRelocateInst>(&V)) 2809 printGCRelocateComment(*Relocate); 2810 2811 if (AnnotationWriter) 2812 AnnotationWriter->printInfoComment(V, Out); 2813 } 2814 2815 // This member is called for each Instruction in a function.. 2816 void AssemblyWriter::printInstruction(const Instruction &I) { 2817 if (AnnotationWriter) AnnotationWriter->emitInstructionAnnot(&I, Out); 2818 2819 // Print out indentation for an instruction. 2820 Out << " "; 2821 2822 // Print out name if it exists... 2823 if (I.hasName()) { 2824 PrintLLVMName(Out, &I); 2825 Out << " = "; 2826 } else if (!I.getType()->isVoidTy()) { 2827 // Print out the def slot taken. 2828 int SlotNum = Machine.getLocalSlot(&I); 2829 if (SlotNum == -1) 2830 Out << "<badref> = "; 2831 else 2832 Out << '%' << SlotNum << " = "; 2833 } 2834 2835 if (const CallInst *CI = dyn_cast<CallInst>(&I)) { 2836 if (CI->isMustTailCall()) 2837 Out << "musttail "; 2838 else if (CI->isTailCall()) 2839 Out << "tail "; 2840 else if (CI->isNoTailCall()) 2841 Out << "notail "; 2842 } 2843 2844 // Print out the opcode... 2845 Out << I.getOpcodeName(); 2846 2847 // If this is an atomic load or store, print out the atomic marker. 2848 if ((isa<LoadInst>(I) && cast<LoadInst>(I).isAtomic()) || 2849 (isa<StoreInst>(I) && cast<StoreInst>(I).isAtomic())) 2850 Out << " atomic"; 2851 2852 if (isa<AtomicCmpXchgInst>(I) && cast<AtomicCmpXchgInst>(I).isWeak()) 2853 Out << " weak"; 2854 2855 // If this is a volatile operation, print out the volatile marker. 2856 if ((isa<LoadInst>(I) && cast<LoadInst>(I).isVolatile()) || 2857 (isa<StoreInst>(I) && cast<StoreInst>(I).isVolatile()) || 2858 (isa<AtomicCmpXchgInst>(I) && cast<AtomicCmpXchgInst>(I).isVolatile()) || 2859 (isa<AtomicRMWInst>(I) && cast<AtomicRMWInst>(I).isVolatile())) 2860 Out << " volatile"; 2861 2862 // Print out optimization information. 2863 WriteOptimizationInfo(Out, &I); 2864 2865 // Print out the compare instruction predicates 2866 if (const CmpInst *CI = dyn_cast<CmpInst>(&I)) 2867 Out << ' ' << CmpInst::getPredicateName(CI->getPredicate()); 2868 2869 // Print out the atomicrmw operation 2870 if (const AtomicRMWInst *RMWI = dyn_cast<AtomicRMWInst>(&I)) 2871 writeAtomicRMWOperation(Out, RMWI->getOperation()); 2872 2873 // Print out the type of the operands... 2874 const Value *Operand = I.getNumOperands() ? I.getOperand(0) : nullptr; 2875 2876 // Special case conditional branches to swizzle the condition out to the front 2877 if (isa<BranchInst>(I) && cast<BranchInst>(I).isConditional()) { 2878 const BranchInst &BI(cast<BranchInst>(I)); 2879 Out << ' '; 2880 writeOperand(BI.getCondition(), true); 2881 Out << ", "; 2882 writeOperand(BI.getSuccessor(0), true); 2883 Out << ", "; 2884 writeOperand(BI.getSuccessor(1), true); 2885 2886 } else if (isa<SwitchInst>(I)) { 2887 const SwitchInst& SI(cast<SwitchInst>(I)); 2888 // Special case switch instruction to get formatting nice and correct. 2889 Out << ' '; 2890 writeOperand(SI.getCondition(), true); 2891 Out << ", "; 2892 writeOperand(SI.getDefaultDest(), true); 2893 Out << " ["; 2894 for (SwitchInst::ConstCaseIt i = SI.case_begin(), e = SI.case_end(); 2895 i != e; ++i) { 2896 Out << "\n "; 2897 writeOperand(i.getCaseValue(), true); 2898 Out << ", "; 2899 writeOperand(i.getCaseSuccessor(), true); 2900 } 2901 Out << "\n ]"; 2902 } else if (isa<IndirectBrInst>(I)) { 2903 // Special case indirectbr instruction to get formatting nice and correct. 2904 Out << ' '; 2905 writeOperand(Operand, true); 2906 Out << ", ["; 2907 2908 for (unsigned i = 1, e = I.getNumOperands(); i != e; ++i) { 2909 if (i != 1) 2910 Out << ", "; 2911 writeOperand(I.getOperand(i), true); 2912 } 2913 Out << ']'; 2914 } else if (const PHINode *PN = dyn_cast<PHINode>(&I)) { 2915 Out << ' '; 2916 TypePrinter.print(I.getType(), Out); 2917 Out << ' '; 2918 2919 for (unsigned op = 0, Eop = PN->getNumIncomingValues(); op < Eop; ++op) { 2920 if (op) Out << ", "; 2921 Out << "[ "; 2922 writeOperand(PN->getIncomingValue(op), false); Out << ", "; 2923 writeOperand(PN->getIncomingBlock(op), false); Out << " ]"; 2924 } 2925 } else if (const ExtractValueInst *EVI = dyn_cast<ExtractValueInst>(&I)) { 2926 Out << ' '; 2927 writeOperand(I.getOperand(0), true); 2928 for (const unsigned *i = EVI->idx_begin(), *e = EVI->idx_end(); i != e; ++i) 2929 Out << ", " << *i; 2930 } else if (const InsertValueInst *IVI = dyn_cast<InsertValueInst>(&I)) { 2931 Out << ' '; 2932 writeOperand(I.getOperand(0), true); Out << ", "; 2933 writeOperand(I.getOperand(1), true); 2934 for (const unsigned *i = IVI->idx_begin(), *e = IVI->idx_end(); i != e; ++i) 2935 Out << ", " << *i; 2936 } else if (const LandingPadInst *LPI = dyn_cast<LandingPadInst>(&I)) { 2937 Out << ' '; 2938 TypePrinter.print(I.getType(), Out); 2939 if (LPI->isCleanup() || LPI->getNumClauses() != 0) 2940 Out << '\n'; 2941 2942 if (LPI->isCleanup()) 2943 Out << " cleanup"; 2944 2945 for (unsigned i = 0, e = LPI->getNumClauses(); i != e; ++i) { 2946 if (i != 0 || LPI->isCleanup()) Out << "\n"; 2947 if (LPI->isCatch(i)) 2948 Out << " catch "; 2949 else 2950 Out << " filter "; 2951 2952 writeOperand(LPI->getClause(i), true); 2953 } 2954 } else if (const auto *CatchSwitch = dyn_cast<CatchSwitchInst>(&I)) { 2955 Out << " within "; 2956 writeOperand(CatchSwitch->getParentPad(), /*PrintType=*/false); 2957 Out << " ["; 2958 unsigned Op = 0; 2959 for (const BasicBlock *PadBB : CatchSwitch->handlers()) { 2960 if (Op > 0) 2961 Out << ", "; 2962 writeOperand(PadBB, /*PrintType=*/true); 2963 ++Op; 2964 } 2965 Out << "] unwind "; 2966 if (const BasicBlock *UnwindDest = CatchSwitch->getUnwindDest()) 2967 writeOperand(UnwindDest, /*PrintType=*/true); 2968 else 2969 Out << "to caller"; 2970 } else if (const auto *FPI = dyn_cast<FuncletPadInst>(&I)) { 2971 Out << " within "; 2972 writeOperand(FPI->getParentPad(), /*PrintType=*/false); 2973 Out << " ["; 2974 for (unsigned Op = 0, NumOps = FPI->getNumArgOperands(); Op < NumOps; 2975 ++Op) { 2976 if (Op > 0) 2977 Out << ", "; 2978 writeOperand(FPI->getArgOperand(Op), /*PrintType=*/true); 2979 } 2980 Out << ']'; 2981 } else if (isa<ReturnInst>(I) && !Operand) { 2982 Out << " void"; 2983 } else if (const auto *CRI = dyn_cast<CatchReturnInst>(&I)) { 2984 Out << " from "; 2985 writeOperand(CRI->getOperand(0), /*PrintType=*/false); 2986 2987 Out << " to "; 2988 writeOperand(CRI->getOperand(1), /*PrintType=*/true); 2989 } else if (const auto *CRI = dyn_cast<CleanupReturnInst>(&I)) { 2990 Out << " from "; 2991 writeOperand(CRI->getOperand(0), /*PrintType=*/false); 2992 2993 Out << " unwind "; 2994 if (CRI->hasUnwindDest()) 2995 writeOperand(CRI->getOperand(1), /*PrintType=*/true); 2996 else 2997 Out << "to caller"; 2998 } else if (const CallInst *CI = dyn_cast<CallInst>(&I)) { 2999 // Print the calling convention being used. 3000 if (CI->getCallingConv() != CallingConv::C) { 3001 Out << " "; 3002 PrintCallingConv(CI->getCallingConv(), Out); 3003 } 3004 3005 Operand = CI->getCalledValue(); 3006 FunctionType *FTy = CI->getFunctionType(); 3007 Type *RetTy = FTy->getReturnType(); 3008 const AttributeSet &PAL = CI->getAttributes(); 3009 3010 if (PAL.hasAttributes(AttributeSet::ReturnIndex)) 3011 Out << ' ' << PAL.getAsString(AttributeSet::ReturnIndex); 3012 3013 // If possible, print out the short form of the call instruction. We can 3014 // only do this if the first argument is a pointer to a nonvararg function, 3015 // and if the return type is not a pointer to a function. 3016 // 3017 Out << ' '; 3018 TypePrinter.print(FTy->isVarArg() ? FTy : RetTy, Out); 3019 Out << ' '; 3020 writeOperand(Operand, false); 3021 Out << '('; 3022 for (unsigned op = 0, Eop = CI->getNumArgOperands(); op < Eop; ++op) { 3023 if (op > 0) 3024 Out << ", "; 3025 writeParamOperand(CI->getArgOperand(op), PAL, op + 1); 3026 } 3027 3028 // Emit an ellipsis if this is a musttail call in a vararg function. This 3029 // is only to aid readability, musttail calls forward varargs by default. 3030 if (CI->isMustTailCall() && CI->getParent() && 3031 CI->getParent()->getParent() && 3032 CI->getParent()->getParent()->isVarArg()) 3033 Out << ", ..."; 3034 3035 Out << ')'; 3036 if (PAL.hasAttributes(AttributeSet::FunctionIndex)) 3037 Out << " #" << Machine.getAttributeGroupSlot(PAL.getFnAttributes()); 3038 3039 writeOperandBundles(CI); 3040 3041 } else if (const InvokeInst *II = dyn_cast<InvokeInst>(&I)) { 3042 Operand = II->getCalledValue(); 3043 FunctionType *FTy = II->getFunctionType(); 3044 Type *RetTy = FTy->getReturnType(); 3045 const AttributeSet &PAL = II->getAttributes(); 3046 3047 // Print the calling convention being used. 3048 if (II->getCallingConv() != CallingConv::C) { 3049 Out << " "; 3050 PrintCallingConv(II->getCallingConv(), Out); 3051 } 3052 3053 if (PAL.hasAttributes(AttributeSet::ReturnIndex)) 3054 Out << ' ' << PAL.getAsString(AttributeSet::ReturnIndex); 3055 3056 // If possible, print out the short form of the invoke instruction. We can 3057 // only do this if the first argument is a pointer to a nonvararg function, 3058 // and if the return type is not a pointer to a function. 3059 // 3060 Out << ' '; 3061 TypePrinter.print(FTy->isVarArg() ? FTy : RetTy, Out); 3062 Out << ' '; 3063 writeOperand(Operand, false); 3064 Out << '('; 3065 for (unsigned op = 0, Eop = II->getNumArgOperands(); op < Eop; ++op) { 3066 if (op) 3067 Out << ", "; 3068 writeParamOperand(II->getArgOperand(op), PAL, op + 1); 3069 } 3070 3071 Out << ')'; 3072 if (PAL.hasAttributes(AttributeSet::FunctionIndex)) 3073 Out << " #" << Machine.getAttributeGroupSlot(PAL.getFnAttributes()); 3074 3075 writeOperandBundles(II); 3076 3077 Out << "\n to "; 3078 writeOperand(II->getNormalDest(), true); 3079 Out << " unwind "; 3080 writeOperand(II->getUnwindDest(), true); 3081 3082 } else if (const AllocaInst *AI = dyn_cast<AllocaInst>(&I)) { 3083 Out << ' '; 3084 if (AI->isUsedWithInAlloca()) 3085 Out << "inalloca "; 3086 if (AI->isSwiftError()) 3087 Out << "swifterror "; 3088 TypePrinter.print(AI->getAllocatedType(), Out); 3089 3090 // Explicitly write the array size if the code is broken, if it's an array 3091 // allocation, or if the type is not canonical for scalar allocations. The 3092 // latter case prevents the type from mutating when round-tripping through 3093 // assembly. 3094 if (!AI->getArraySize() || AI->isArrayAllocation() || 3095 !AI->getArraySize()->getType()->isIntegerTy(32)) { 3096 Out << ", "; 3097 writeOperand(AI->getArraySize(), true); 3098 } 3099 if (AI->getAlignment()) { 3100 Out << ", align " << AI->getAlignment(); 3101 } 3102 } else if (isa<CastInst>(I)) { 3103 if (Operand) { 3104 Out << ' '; 3105 writeOperand(Operand, true); // Work with broken code 3106 } 3107 Out << " to "; 3108 TypePrinter.print(I.getType(), Out); 3109 } else if (isa<VAArgInst>(I)) { 3110 if (Operand) { 3111 Out << ' '; 3112 writeOperand(Operand, true); // Work with broken code 3113 } 3114 Out << ", "; 3115 TypePrinter.print(I.getType(), Out); 3116 } else if (Operand) { // Print the normal way. 3117 if (const auto *GEP = dyn_cast<GetElementPtrInst>(&I)) { 3118 Out << ' '; 3119 TypePrinter.print(GEP->getSourceElementType(), Out); 3120 Out << ','; 3121 } else if (const auto *LI = dyn_cast<LoadInst>(&I)) { 3122 Out << ' '; 3123 TypePrinter.print(LI->getType(), Out); 3124 Out << ','; 3125 } 3126 3127 // PrintAllTypes - Instructions who have operands of all the same type 3128 // omit the type from all but the first operand. If the instruction has 3129 // different type operands (for example br), then they are all printed. 3130 bool PrintAllTypes = false; 3131 Type *TheType = Operand->getType(); 3132 3133 // Select, Store and ShuffleVector always print all types. 3134 if (isa<SelectInst>(I) || isa<StoreInst>(I) || isa<ShuffleVectorInst>(I) 3135 || isa<ReturnInst>(I)) { 3136 PrintAllTypes = true; 3137 } else { 3138 for (unsigned i = 1, E = I.getNumOperands(); i != E; ++i) { 3139 Operand = I.getOperand(i); 3140 // note that Operand shouldn't be null, but the test helps make dump() 3141 // more tolerant of malformed IR 3142 if (Operand && Operand->getType() != TheType) { 3143 PrintAllTypes = true; // We have differing types! Print them all! 3144 break; 3145 } 3146 } 3147 } 3148 3149 if (!PrintAllTypes) { 3150 Out << ' '; 3151 TypePrinter.print(TheType, Out); 3152 } 3153 3154 Out << ' '; 3155 for (unsigned i = 0, E = I.getNumOperands(); i != E; ++i) { 3156 if (i) Out << ", "; 3157 writeOperand(I.getOperand(i), PrintAllTypes); 3158 } 3159 } 3160 3161 // Print atomic ordering/alignment for memory operations 3162 if (const LoadInst *LI = dyn_cast<LoadInst>(&I)) { 3163 if (LI->isAtomic()) 3164 writeAtomic(LI->getOrdering(), LI->getSynchScope()); 3165 if (LI->getAlignment()) 3166 Out << ", align " << LI->getAlignment(); 3167 } else if (const StoreInst *SI = dyn_cast<StoreInst>(&I)) { 3168 if (SI->isAtomic()) 3169 writeAtomic(SI->getOrdering(), SI->getSynchScope()); 3170 if (SI->getAlignment()) 3171 Out << ", align " << SI->getAlignment(); 3172 } else if (const AtomicCmpXchgInst *CXI = dyn_cast<AtomicCmpXchgInst>(&I)) { 3173 writeAtomicCmpXchg(CXI->getSuccessOrdering(), CXI->getFailureOrdering(), 3174 CXI->getSynchScope()); 3175 } else if (const AtomicRMWInst *RMWI = dyn_cast<AtomicRMWInst>(&I)) { 3176 writeAtomic(RMWI->getOrdering(), RMWI->getSynchScope()); 3177 } else if (const FenceInst *FI = dyn_cast<FenceInst>(&I)) { 3178 writeAtomic(FI->getOrdering(), FI->getSynchScope()); 3179 } 3180 3181 // Print Metadata info. 3182 SmallVector<std::pair<unsigned, MDNode *>, 4> InstMD; 3183 I.getAllMetadata(InstMD); 3184 printMetadataAttachments(InstMD, ", "); 3185 3186 // Print a nice comment. 3187 printInfoComment(I); 3188 } 3189 3190 void AssemblyWriter::printMetadataAttachments( 3191 const SmallVectorImpl<std::pair<unsigned, MDNode *>> &MDs, 3192 StringRef Separator) { 3193 if (MDs.empty()) 3194 return; 3195 3196 if (MDNames.empty()) 3197 MDs[0].second->getContext().getMDKindNames(MDNames); 3198 3199 for (const auto &I : MDs) { 3200 unsigned Kind = I.first; 3201 Out << Separator; 3202 if (Kind < MDNames.size()) { 3203 Out << "!"; 3204 printMetadataIdentifier(MDNames[Kind], Out); 3205 } else 3206 Out << "!<unknown kind #" << Kind << ">"; 3207 Out << ' '; 3208 WriteAsOperandInternal(Out, I.second, &TypePrinter, &Machine, TheModule); 3209 } 3210 } 3211 3212 void AssemblyWriter::writeMDNode(unsigned Slot, const MDNode *Node) { 3213 Out << '!' << Slot << " = "; 3214 printMDNodeBody(Node); 3215 Out << "\n"; 3216 } 3217 3218 void AssemblyWriter::writeAllMDNodes() { 3219 SmallVector<const MDNode *, 16> Nodes; 3220 Nodes.resize(Machine.mdn_size()); 3221 for (SlotTracker::mdn_iterator I = Machine.mdn_begin(), E = Machine.mdn_end(); 3222 I != E; ++I) 3223 Nodes[I->second] = cast<MDNode>(I->first); 3224 3225 for (unsigned i = 0, e = Nodes.size(); i != e; ++i) { 3226 writeMDNode(i, Nodes[i]); 3227 } 3228 } 3229 3230 void AssemblyWriter::printMDNodeBody(const MDNode *Node) { 3231 WriteMDNodeBodyInternal(Out, Node, &TypePrinter, &Machine, TheModule); 3232 } 3233 3234 void AssemblyWriter::writeAllAttributeGroups() { 3235 std::vector<std::pair<AttributeSet, unsigned> > asVec; 3236 asVec.resize(Machine.as_size()); 3237 3238 for (SlotTracker::as_iterator I = Machine.as_begin(), E = Machine.as_end(); 3239 I != E; ++I) 3240 asVec[I->second] = *I; 3241 3242 for (const auto &I : asVec) 3243 Out << "attributes #" << I.second << " = { " 3244 << I.first.getAsString(AttributeSet::FunctionIndex, true) << " }\n"; 3245 } 3246 3247 void AssemblyWriter::printUseListOrder(const UseListOrder &Order) { 3248 bool IsInFunction = Machine.getFunction(); 3249 if (IsInFunction) 3250 Out << " "; 3251 3252 Out << "uselistorder"; 3253 if (const BasicBlock *BB = 3254 IsInFunction ? nullptr : dyn_cast<BasicBlock>(Order.V)) { 3255 Out << "_bb "; 3256 writeOperand(BB->getParent(), false); 3257 Out << ", "; 3258 writeOperand(BB, false); 3259 } else { 3260 Out << " "; 3261 writeOperand(Order.V, true); 3262 } 3263 Out << ", { "; 3264 3265 assert(Order.Shuffle.size() >= 2 && "Shuffle too small"); 3266 Out << Order.Shuffle[0]; 3267 for (unsigned I = 1, E = Order.Shuffle.size(); I != E; ++I) 3268 Out << ", " << Order.Shuffle[I]; 3269 Out << " }\n"; 3270 } 3271 3272 void AssemblyWriter::printUseLists(const Function *F) { 3273 auto hasMore = 3274 [&]() { return !UseListOrders.empty() && UseListOrders.back().F == F; }; 3275 if (!hasMore()) 3276 // Nothing to do. 3277 return; 3278 3279 Out << "\n; uselistorder directives\n"; 3280 while (hasMore()) { 3281 printUseListOrder(UseListOrders.back()); 3282 UseListOrders.pop_back(); 3283 } 3284 } 3285 3286 //===----------------------------------------------------------------------===// 3287 // External Interface declarations 3288 //===----------------------------------------------------------------------===// 3289 3290 void Function::print(raw_ostream &ROS, AssemblyAnnotationWriter *AAW, 3291 bool ShouldPreserveUseListOrder, 3292 bool IsForDebug) const { 3293 SlotTracker SlotTable(this->getParent()); 3294 formatted_raw_ostream OS(ROS); 3295 AssemblyWriter W(OS, SlotTable, this->getParent(), AAW, 3296 IsForDebug, 3297 ShouldPreserveUseListOrder); 3298 W.printFunction(this); 3299 } 3300 3301 void Module::print(raw_ostream &ROS, AssemblyAnnotationWriter *AAW, 3302 bool ShouldPreserveUseListOrder, bool IsForDebug) const { 3303 SlotTracker SlotTable(this); 3304 formatted_raw_ostream OS(ROS); 3305 AssemblyWriter W(OS, SlotTable, this, AAW, IsForDebug, 3306 ShouldPreserveUseListOrder); 3307 W.printModule(this); 3308 } 3309 3310 void NamedMDNode::print(raw_ostream &ROS, bool IsForDebug) const { 3311 SlotTracker SlotTable(getParent()); 3312 formatted_raw_ostream OS(ROS); 3313 AssemblyWriter W(OS, SlotTable, getParent(), nullptr, IsForDebug); 3314 W.printNamedMDNode(this); 3315 } 3316 3317 void NamedMDNode::print(raw_ostream &ROS, ModuleSlotTracker &MST, 3318 bool IsForDebug) const { 3319 Optional<SlotTracker> LocalST; 3320 SlotTracker *SlotTable; 3321 if (auto *ST = MST.getMachine()) 3322 SlotTable = ST; 3323 else { 3324 LocalST.emplace(getParent()); 3325 SlotTable = &*LocalST; 3326 } 3327 3328 formatted_raw_ostream OS(ROS); 3329 AssemblyWriter W(OS, *SlotTable, getParent(), nullptr, IsForDebug); 3330 W.printNamedMDNode(this); 3331 } 3332 3333 void Comdat::print(raw_ostream &ROS, bool /*IsForDebug*/) const { 3334 PrintLLVMName(ROS, getName(), ComdatPrefix); 3335 ROS << " = comdat "; 3336 3337 switch (getSelectionKind()) { 3338 case Comdat::Any: 3339 ROS << "any"; 3340 break; 3341 case Comdat::ExactMatch: 3342 ROS << "exactmatch"; 3343 break; 3344 case Comdat::Largest: 3345 ROS << "largest"; 3346 break; 3347 case Comdat::NoDuplicates: 3348 ROS << "noduplicates"; 3349 break; 3350 case Comdat::SameSize: 3351 ROS << "samesize"; 3352 break; 3353 } 3354 3355 ROS << '\n'; 3356 } 3357 3358 void Type::print(raw_ostream &OS, bool /*IsForDebug*/, bool NoDetails) const { 3359 TypePrinting TP; 3360 TP.print(const_cast<Type*>(this), OS); 3361 3362 if (NoDetails) 3363 return; 3364 3365 // If the type is a named struct type, print the body as well. 3366 if (StructType *STy = dyn_cast<StructType>(const_cast<Type*>(this))) 3367 if (!STy->isLiteral()) { 3368 OS << " = type "; 3369 TP.printStructBody(STy, OS); 3370 } 3371 } 3372 3373 static bool isReferencingMDNode(const Instruction &I) { 3374 if (const auto *CI = dyn_cast<CallInst>(&I)) 3375 if (Function *F = CI->getCalledFunction()) 3376 if (F->isIntrinsic()) 3377 for (auto &Op : I.operands()) 3378 if (auto *V = dyn_cast_or_null<MetadataAsValue>(Op)) 3379 if (isa<MDNode>(V->getMetadata())) 3380 return true; 3381 return false; 3382 } 3383 3384 void Value::print(raw_ostream &ROS, bool IsForDebug) const { 3385 bool ShouldInitializeAllMetadata = false; 3386 if (auto *I = dyn_cast<Instruction>(this)) 3387 ShouldInitializeAllMetadata = isReferencingMDNode(*I); 3388 else if (isa<Function>(this) || isa<MetadataAsValue>(this)) 3389 ShouldInitializeAllMetadata = true; 3390 3391 ModuleSlotTracker MST(getModuleFromVal(this), ShouldInitializeAllMetadata); 3392 print(ROS, MST, IsForDebug); 3393 } 3394 3395 void Value::print(raw_ostream &ROS, ModuleSlotTracker &MST, 3396 bool IsForDebug) const { 3397 formatted_raw_ostream OS(ROS); 3398 SlotTracker EmptySlotTable(static_cast<const Module *>(nullptr)); 3399 SlotTracker &SlotTable = 3400 MST.getMachine() ? *MST.getMachine() : EmptySlotTable; 3401 auto incorporateFunction = [&](const Function *F) { 3402 if (F) 3403 MST.incorporateFunction(*F); 3404 }; 3405 3406 if (const Instruction *I = dyn_cast<Instruction>(this)) { 3407 incorporateFunction(I->getParent() ? I->getParent()->getParent() : nullptr); 3408 AssemblyWriter W(OS, SlotTable, getModuleFromVal(I), nullptr, IsForDebug); 3409 W.printInstruction(*I); 3410 } else if (const BasicBlock *BB = dyn_cast<BasicBlock>(this)) { 3411 incorporateFunction(BB->getParent()); 3412 AssemblyWriter W(OS, SlotTable, getModuleFromVal(BB), nullptr, IsForDebug); 3413 W.printBasicBlock(BB); 3414 } else if (const GlobalValue *GV = dyn_cast<GlobalValue>(this)) { 3415 AssemblyWriter W(OS, SlotTable, GV->getParent(), nullptr, IsForDebug); 3416 if (const GlobalVariable *V = dyn_cast<GlobalVariable>(GV)) 3417 W.printGlobal(V); 3418 else if (const Function *F = dyn_cast<Function>(GV)) 3419 W.printFunction(F); 3420 else 3421 W.printIndirectSymbol(cast<GlobalIndirectSymbol>(GV)); 3422 } else if (const MetadataAsValue *V = dyn_cast<MetadataAsValue>(this)) { 3423 V->getMetadata()->print(ROS, MST, getModuleFromVal(V)); 3424 } else if (const Constant *C = dyn_cast<Constant>(this)) { 3425 TypePrinting TypePrinter; 3426 TypePrinter.print(C->getType(), OS); 3427 OS << ' '; 3428 WriteConstantInternal(OS, C, TypePrinter, MST.getMachine(), nullptr); 3429 } else if (isa<InlineAsm>(this) || isa<Argument>(this)) { 3430 this->printAsOperand(OS, /* PrintType */ true, MST); 3431 } else { 3432 llvm_unreachable("Unknown value to print out!"); 3433 } 3434 } 3435 3436 /// Print without a type, skipping the TypePrinting object. 3437 /// 3438 /// \return \c true iff printing was successful. 3439 static bool printWithoutType(const Value &V, raw_ostream &O, 3440 SlotTracker *Machine, const Module *M) { 3441 if (V.hasName() || isa<GlobalValue>(V) || 3442 (!isa<Constant>(V) && !isa<MetadataAsValue>(V))) { 3443 WriteAsOperandInternal(O, &V, nullptr, Machine, M); 3444 return true; 3445 } 3446 return false; 3447 } 3448 3449 static void printAsOperandImpl(const Value &V, raw_ostream &O, bool PrintType, 3450 ModuleSlotTracker &MST) { 3451 TypePrinting TypePrinter; 3452 if (const Module *M = MST.getModule()) 3453 TypePrinter.incorporateTypes(*M); 3454 if (PrintType) { 3455 TypePrinter.print(V.getType(), O); 3456 O << ' '; 3457 } 3458 3459 WriteAsOperandInternal(O, &V, &TypePrinter, MST.getMachine(), 3460 MST.getModule()); 3461 } 3462 3463 void Value::printAsOperand(raw_ostream &O, bool PrintType, 3464 const Module *M) const { 3465 if (!M) 3466 M = getModuleFromVal(this); 3467 3468 if (!PrintType) 3469 if (printWithoutType(*this, O, nullptr, M)) 3470 return; 3471 3472 SlotTracker Machine( 3473 M, /* ShouldInitializeAllMetadata */ isa<MetadataAsValue>(this)); 3474 ModuleSlotTracker MST(Machine, M); 3475 printAsOperandImpl(*this, O, PrintType, MST); 3476 } 3477 3478 void Value::printAsOperand(raw_ostream &O, bool PrintType, 3479 ModuleSlotTracker &MST) const { 3480 if (!PrintType) 3481 if (printWithoutType(*this, O, MST.getMachine(), MST.getModule())) 3482 return; 3483 3484 printAsOperandImpl(*this, O, PrintType, MST); 3485 } 3486 3487 static void printMetadataImpl(raw_ostream &ROS, const Metadata &MD, 3488 ModuleSlotTracker &MST, const Module *M, 3489 bool OnlyAsOperand) { 3490 formatted_raw_ostream OS(ROS); 3491 3492 TypePrinting TypePrinter; 3493 if (M) 3494 TypePrinter.incorporateTypes(*M); 3495 3496 WriteAsOperandInternal(OS, &MD, &TypePrinter, MST.getMachine(), M, 3497 /* FromValue */ true); 3498 3499 auto *N = dyn_cast<MDNode>(&MD); 3500 if (OnlyAsOperand || !N) 3501 return; 3502 3503 OS << " = "; 3504 WriteMDNodeBodyInternal(OS, N, &TypePrinter, MST.getMachine(), M); 3505 } 3506 3507 void Metadata::printAsOperand(raw_ostream &OS, const Module *M) const { 3508 ModuleSlotTracker MST(M, isa<MDNode>(this)); 3509 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ true); 3510 } 3511 3512 void Metadata::printAsOperand(raw_ostream &OS, ModuleSlotTracker &MST, 3513 const Module *M) const { 3514 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ true); 3515 } 3516 3517 void Metadata::print(raw_ostream &OS, const Module *M, 3518 bool /*IsForDebug*/) const { 3519 ModuleSlotTracker MST(M, isa<MDNode>(this)); 3520 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ false); 3521 } 3522 3523 void Metadata::print(raw_ostream &OS, ModuleSlotTracker &MST, 3524 const Module *M, bool /*IsForDebug*/) const { 3525 printMetadataImpl(OS, *this, MST, M, /* OnlyAsOperand */ false); 3526 } 3527 3528 // Value::dump - allow easy printing of Values from the debugger. 3529 LLVM_DUMP_METHOD 3530 void Value::dump() const { print(dbgs(), /*IsForDebug=*/true); dbgs() << '\n'; } 3531 3532 // Type::dump - allow easy printing of Types from the debugger. 3533 LLVM_DUMP_METHOD 3534 void Type::dump() const { print(dbgs(), /*IsForDebug=*/true); dbgs() << '\n'; } 3535 3536 // Module::dump() - Allow printing of Modules from the debugger. 3537 LLVM_DUMP_METHOD 3538 void Module::dump() const { 3539 print(dbgs(), nullptr, 3540 /*ShouldPreserveUseListOrder=*/false, /*IsForDebug=*/true); 3541 } 3542 3543 // \brief Allow printing of Comdats from the debugger. 3544 LLVM_DUMP_METHOD 3545 void Comdat::dump() const { print(dbgs(), /*IsForDebug=*/true); } 3546 3547 // NamedMDNode::dump() - Allow printing of NamedMDNodes from the debugger. 3548 LLVM_DUMP_METHOD 3549 void NamedMDNode::dump() const { print(dbgs(), /*IsForDebug=*/true); } 3550 3551 LLVM_DUMP_METHOD 3552 void Metadata::dump() const { dump(nullptr); } 3553 3554 LLVM_DUMP_METHOD 3555 void Metadata::dump(const Module *M) const { 3556 print(dbgs(), M, /*IsForDebug=*/true); 3557 dbgs() << '\n'; 3558 } 3559