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