LLVM 18.0.0git
AsmPrinter.h
Go to the documentation of this file.
1//===- llvm/CodeGen/AsmPrinter.h - AsmPrinter Framework ---------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file contains a class to be used as the base class for target specific
10// asm writers. This class primarily handles common functionality used by
11// all asm writers.
12//
13//===----------------------------------------------------------------------===//
14
15#ifndef LLVM_CODEGEN_ASMPRINTER_H
16#define LLVM_CODEGEN_ASMPRINTER_H
17
18#include "llvm/ADT/DenseMap.h"
19#include "llvm/ADT/MapVector.h"
27#include "llvm/IR/InlineAsm.h"
29#include <cstdint>
30#include <memory>
31#include <utility>
32#include <vector>
33
34namespace llvm {
35
36class AddrLabelMap;
37class BasicBlock;
38class BlockAddress;
39class Constant;
40class ConstantArray;
41class DataLayout;
42class DIE;
43class DIEAbbrev;
44class DwarfDebug;
45class GCMetadataPrinter;
46class GCStrategy;
47class GlobalAlias;
48class GlobalObject;
49class GlobalValue;
50class GlobalVariable;
51class MachineBasicBlock;
52class MachineConstantPoolValue;
53class MachineDominatorTree;
54class MachineFunction;
55class MachineInstr;
56class MachineJumpTableInfo;
57class MachineLoopInfo;
58class MachineModuleInfo;
59class MachineOptimizationRemarkEmitter;
60class MCAsmInfo;
61class MCCFIInstruction;
62class MCContext;
63class MCExpr;
64class MCInst;
65class MCSection;
66class MCStreamer;
67class MCSubtargetInfo;
68class MCSymbol;
69class MCTargetOptions;
70class MDNode;
71class Module;
72class PseudoProbeHandler;
73class raw_ostream;
74class StringRef;
75class TargetLoweringObjectFile;
76class TargetMachine;
77class Twine;
78
79namespace remarks {
80class RemarkStreamer;
81}
82
83/// This class is intended to be used as a driving class for all asm writers.
85public:
86 /// Target machine description.
88
89 /// Target Asm Printer information.
90 const MCAsmInfo *MAI = nullptr;
91
92 /// This is the context for the output file that we are streaming. This owns
93 /// all of the global MC-related objects for the generated translation unit.
95
96 /// This is the MCStreamer object for the file we are generating. This
97 /// contains the transient state for the current translation unit that we are
98 /// generating (such as the current section etc).
99 std::unique_ptr<MCStreamer> OutStreamer;
100
101 /// The current machine function.
102 MachineFunction *MF = nullptr;
103
104 /// This is a pointer to the current MachineModuleInfo.
106
107 /// This is a pointer to the current MachineDominatorTree.
109
110 /// This is a pointer to the current MachineLoopInfo.
112
113 /// Optimization remark emitter.
115
116 /// The symbol for the entry in __patchable_function_entires.
118
119 /// The symbol for the current function. This is recalculated at the beginning
120 /// of each call to runOnMachineFunction().
122
123 /// The symbol for the current function descriptor on AIX. This is created
124 /// at the beginning of each call to SetupMachineFunction().
126
127 /// The symbol used to represent the start of the current function for the
128 /// purpose of calculating its size (e.g. using the .size directive). By
129 /// default, this is equal to CurrentFnSym.
131
132 /// Map a basic block section ID to the begin and end symbols of that section
133 /// which determine the section's range.
136 };
137
139
140 /// Map global GOT equivalent MCSymbols to GlobalVariables and keep track of
141 /// its number of uses by other globals.
142 using GOTEquivUsePair = std::pair<const GlobalVariable *, unsigned>;
144
145 /// struct HandlerInfo and Handlers permit users or target extended
146 /// AsmPrinter to add their own handlers.
147 struct HandlerInfo {
148 std::unique_ptr<AsmPrinterHandler> Handler;
153
154 HandlerInfo(std::unique_ptr<AsmPrinterHandler> Handler, StringRef TimerName,
160 };
161
162 // Flags representing which CFI section is required for a function/module.
163 enum class CFISection : unsigned {
164 None = 0, ///< Do not emit either .eh_frame or .debug_frame
165 EH = 1, ///< Emit .eh_frame
166 Debug = 2 ///< Emit .debug_frame
167 };
168
169private:
170 MCSymbol *CurrentFnEnd = nullptr;
171
172 /// Map a basic block section ID to the exception symbol associated with that
173 /// section. Map entries are assigned and looked up via
174 /// AsmPrinter::getMBBExceptionSym.
175 DenseMap<unsigned, MCSymbol *> MBBSectionExceptionSyms;
176
177 // The symbol used to represent the start of the current BB section of the
178 // function. This is used to calculate the size of the BB section.
179 MCSymbol *CurrentSectionBeginSym = nullptr;
180
181 /// This map keeps track of which symbol is being used for the specified basic
182 /// block's address of label.
183 std::unique_ptr<AddrLabelMap> AddrLabelSymbols;
184
185 /// The garbage collection metadata printer table.
187
188 /// Emit comments in assembly output if this is true.
189 bool VerboseAsm;
190
191 /// Output stream for the stack usage file (i.e., .su file).
192 std::unique_ptr<raw_fd_ostream> StackUsageStream;
193
194 /// List of symbols to be inserted into PC sections.
196
197 static char ID;
198
199protected:
201
202 /// For dso_local functions, the current $local alias for the function.
204
205 /// A vector of all debug/EH info emitters we should use. This vector
206 /// maintains ownership of the emitters.
207 std::vector<HandlerInfo> Handlers;
208 size_t NumUserHandlers = 0;
209
211
212private:
213 /// If generated on the fly this own the instance.
214 std::unique_ptr<MachineDominatorTree> OwnedMDT;
215
216 /// If generated on the fly this own the instance.
217 std::unique_ptr<MachineLoopInfo> OwnedMLI;
218
219 /// If the target supports dwarf debug info, this pointer is non-null.
220 DwarfDebug *DD = nullptr;
221
222 /// A handler that supports pseudo probe emission with embedded inline
223 /// context.
224 PseudoProbeHandler *PP = nullptr;
225
226 /// CFISection type the module needs i.e. either .eh_frame or .debug_frame.
227 CFISection ModuleCFISection = CFISection::None;
228
229 /// True if the module contains split-stack functions. This is used to
230 /// emit .note.GNU-split-stack section as required by the linker for
231 /// special handling split-stack function calling no-split-stack function.
232 bool HasSplitStack = false;
233
234 /// True if the module contains no-split-stack functions. This is used to emit
235 /// .note.GNU-no-split-stack section when it also contains functions without a
236 /// split stack prologue.
237 bool HasNoSplitStack = false;
238
239 /// Raw FDOstream for outputting machine basic block frequncies if the
240 /// --mbb-profile-dump flag is set for downstream cost modelling applications
241 std::unique_ptr<raw_fd_ostream> MBBProfileDumpFileOutput;
242
243protected:
244 explicit AsmPrinter(TargetMachine &TM, std::unique_ptr<MCStreamer> Streamer);
245
246public:
247 ~AsmPrinter() override;
248
249 DwarfDebug *getDwarfDebug() { return DD; }
250 DwarfDebug *getDwarfDebug() const { return DD; }
251
253 void setDwarfVersion(uint16_t Version);
254
255 bool isDwarf64() const;
256
257 /// Returns 4 for DWARF32 and 8 for DWARF64.
258 unsigned int getDwarfOffsetByteSize() const;
259
260 /// Returns 4 for DWARF32 and 12 for DWARF64.
261 unsigned int getUnitLengthFieldByteSize() const;
262
263 /// Returns information about the byte size of DW_FORM values.
265
266 bool isPositionIndependent() const;
267
268 /// Return true if assembly output should contain comments.
269 bool isVerbose() const { return VerboseAsm; }
270
271 /// Return a unique ID for the current function.
272 unsigned getFunctionNumber() const;
273
274 /// Return symbol for the function pseudo stack if the stack frame is not a
275 /// register based.
276 virtual const MCSymbol *getFunctionFrameSymbol() const { return nullptr; }
277
279 MCSymbol *getFunctionEnd() const { return CurrentFnEnd; }
280
281 // Return the exception symbol associated with the MBB section containing a
282 // given basic block.
284
285 /// Return the symbol to be used for the specified basic block when its
286 /// address is taken. This cannot be its normal LBB label because the block
287 /// may be accessed outside its containing function.
289 return getAddrLabelSymbolToEmit(BB).front();
290 }
291
292 /// Return the symbol to be used for the specified basic block when its
293 /// address is taken. If other blocks were RAUW'd to this one, we may have
294 /// to emit them as well, return the whole set.
296
297 /// If the specified function has had any references to address-taken blocks
298 /// generated, but the block got deleted, return the symbol now so we can
299 /// emit it. This prevents emitting a reference to a symbol that has no
300 /// definition.
302 std::vector<MCSymbol *> &Result);
303
304 /// Return information about object file lowering.
306
307 /// Return information about data layout.
308 const DataLayout &getDataLayout() const;
309
310 /// Return the pointer size from the TargetMachine
311 unsigned getPointerSize() const;
312
313 /// Return information about subtarget.
314 const MCSubtargetInfo &getSubtargetInfo() const;
315
316 void EmitToStreamer(MCStreamer &S, const MCInst &Inst);
317
318 /// Emits inital debug location directive.
320
321 /// Return the current section we are emitting to.
322 const MCSection *getCurrentSection() const;
323
325 const GlobalValue *GV) const;
326
327 MCSymbol *getSymbol(const GlobalValue *GV) const;
328
329 /// Similar to getSymbol() but preferred for references. On ELF, this uses a
330 /// local symbol if a reference to GV is guaranteed to be resolved to the
331 /// definition in the same module.
332 MCSymbol *getSymbolPreferLocal(const GlobalValue &GV) const;
333
335 return DwarfUsesRelocationsAcrossSections;
336 }
337
339 DwarfUsesRelocationsAcrossSections = Enable;
340 }
341
342 //===------------------------------------------------------------------===//
343 // XRay instrumentation implementation.
344 //===------------------------------------------------------------------===//
345public:
346 // This describes the kind of sled we're storing in the XRay table.
347 enum class SledKind : uint8_t {
348 FUNCTION_ENTER = 0,
349 FUNCTION_EXIT = 1,
350 TAIL_CALL = 2,
351 LOG_ARGS_ENTER = 3,
352 CUSTOM_EVENT = 4,
353 TYPED_EVENT = 5,
354 };
355
356 // The table will contain these structs that point to the sled, the function
357 // containing the sled, and what kind of sled (and whether they should always
358 // be instrumented). We also use a version identifier that the runtime can use
359 // to decide what to do with the sled, depending on the version of the sled.
365 const class Function *Fn;
366 uint8_t Version;
367
368 void emit(int, MCStreamer *) const;
369 };
370
371 // All the sleds to be emitted.
373
374 // Helper function to record a given XRay sled.
375 void recordSled(MCSymbol *Sled, const MachineInstr &MI, SledKind Kind,
376 uint8_t Version = 0);
377
378 /// Emit a table with all XRay instrumentation points.
379 void emitXRayTable();
380
382
383 //===------------------------------------------------------------------===//
384 // MachineFunctionPass Implementation.
385 //===------------------------------------------------------------------===//
386
387 /// Record analysis usage.
388 void getAnalysisUsage(AnalysisUsage &AU) const override;
389
390 /// Set up the AsmPrinter when we are working on a new module. If your pass
391 /// overrides this, it must make sure to explicitly call this implementation.
392 bool doInitialization(Module &M) override;
393
394 /// Shut down the asmprinter. If you override this in your pass, you must make
395 /// sure to call it explicitly.
396 bool doFinalization(Module &M) override;
397
398 /// Emit the specified function out to the OutStreamer.
402 return false;
403 }
404
405 //===------------------------------------------------------------------===//
406 // Coarse grained IR lowering routines.
407 //===------------------------------------------------------------------===//
408
409 /// This should be called when a new MachineFunction is being processed from
410 /// runOnMachineFunction.
412
413 /// This method emits the body and trailer for a function.
414 void emitFunctionBody();
415
417
418 void emitFrameAlloc(const MachineInstr &MI);
419
421
422 void emitStackUsage(const MachineFunction &MF);
423
425
426 void emitKCFITrapEntry(const MachineFunction &MF, const MCSymbol *Symbol);
427 virtual void emitKCFITypeId(const MachineFunction &MF);
428
429 void emitPseudoProbe(const MachineInstr &MI);
430
432
433 /// Emits a label as reference for PC sections.
434 void emitPCSectionsLabel(const MachineFunction &MF, const MDNode &MD);
435
436 /// Emits the PC sections collected from instructions.
437 void emitPCSections(const MachineFunction &MF);
438
439 /// Get the CFISection type for a function.
441
442 /// Get the CFISection type for a function.
444
445 /// Get the CFISection type for the module.
446 CFISection getModuleCFISectionType() const { return ModuleCFISection; }
447
448 bool needsSEHMoves();
449
450 /// Since emitting CFI unwind information is entangled with supporting the
451 /// exceptions, this returns true for platforms which use CFI unwind
452 /// information for other purposes (debugging, sanitizers, ...) when
453 /// `MCAsmInfo::ExceptionsType == ExceptionHandling::None`.
454 bool usesCFIWithoutEH() const;
455
456 /// Print to the current output stream assembly representations of the
457 /// constants in the constant pool MCP. This is used to print out constants
458 /// which have been "spilled to memory" by the code generator.
459 virtual void emitConstantPool();
460
461 /// Print assembly representations of the jump tables used by the current
462 /// function to the current output stream.
463 virtual void emitJumpTableInfo();
464
465 /// Emit the specified global variable to the .s file.
466 virtual void emitGlobalVariable(const GlobalVariable *GV);
467
468 /// Check to see if the specified global is a special global used by LLVM. If
469 /// so, emit it and return true, otherwise do nothing and return false.
471
472 /// `llvm.global_ctors` and `llvm.global_dtors` are arrays of Structor
473 /// structs.
474 ///
475 /// Priority - init priority
476 /// Func - global initialization or global clean-up function
477 /// ComdatKey - associated data
478 struct Structor {
479 int Priority = 0;
480 Constant *Func = nullptr;
482
483 Structor() = default;
484 };
485
486 /// This method gathers an array of Structors and then sorts them out by
487 /// Priority.
488 /// @param List The initializer of `llvm.global_ctors` or `llvm.global_dtors`
489 /// array.
490 /// @param[out] Structors Sorted Structor structs by Priority.
492 SmallVector<Structor, 8> &Structors);
493
494 /// This method emits `llvm.global_ctors` or `llvm.global_dtors` list.
495 virtual void emitXXStructorList(const DataLayout &DL, const Constant *List,
496 bool IsCtor);
497
498 /// Emit an alignment directive to the specified power of two boundary. If a
499 /// global value is specified, and if that global has an explicit alignment
500 /// requested, it will override the alignment request if required for
501 /// correctness.
502 void emitAlignment(Align Alignment, const GlobalObject *GV = nullptr,
503 unsigned MaxBytesToEmit = 0) const;
504
505 /// Lower the specified LLVM Constant to an MCExpr.
506 virtual const MCExpr *lowerConstant(const Constant *CV);
507
508 /// Print a general LLVM constant to the .s file.
509 /// On AIX, when an alias refers to a sub-element of a global variable, the
510 /// label of that alias needs to be emitted before the corresponding element.
512 void emitGlobalConstant(const DataLayout &DL, const Constant *CV,
513 AliasMapTy *AliasList = nullptr);
514
515 /// Unnamed constant global variables solely contaning a pointer to
516 /// another globals variable act like a global variable "proxy", or GOT
517 /// equivalents, i.e., it's only used to hold the address of the latter. One
518 /// optimization is to replace accesses to these proxies by using the GOT
519 /// entry for the final global instead. Hence, we select GOT equivalent
520 /// candidates among all the module global variables, avoid emitting them
521 /// unnecessarily and finally replace references to them by pc relative
522 /// accesses to GOT entries.
524
525 /// Constant expressions using GOT equivalent globals may not be
526 /// eligible for PC relative GOT entry conversion, in such cases we need to
527 /// emit the proxies we previously omitted in EmitGlobalVariable.
528 void emitGlobalGOTEquivs();
529
530 /// Emit the stack maps.
531 void emitStackMaps();
532
533 //===------------------------------------------------------------------===//
534 // Overridable Hooks
535 //===------------------------------------------------------------------===//
536
538 Handlers.insert(Handlers.begin(), std::move(Handler));
540 }
541
542 // Targets can, or in the case of EmitInstruction, must implement these to
543 // customize output.
544
545 /// This virtual method can be overridden by targets that want to emit
546 /// something at the start of their file.
547 virtual void emitStartOfAsmFile(Module &) {}
548
549 /// This virtual method can be overridden by targets that want to emit
550 /// something at the end of their file.
551 virtual void emitEndOfAsmFile(Module &) {}
552
553 /// Targets can override this to emit stuff before the first basic block in
554 /// the function.
555 virtual void emitFunctionBodyStart() {}
556
557 /// Targets can override this to emit stuff after the last basic block in the
558 /// function.
559 virtual void emitFunctionBodyEnd() {}
560
561 /// Targets can override this to emit stuff at the start of a basic block.
562 /// By default, this method prints the label for the specified
563 /// MachineBasicBlock, an alignment (if present) and a comment describing it
564 /// if appropriate.
565 virtual void emitBasicBlockStart(const MachineBasicBlock &MBB);
566
567 /// Targets can override this to emit stuff at the end of a basic block.
568 virtual void emitBasicBlockEnd(const MachineBasicBlock &MBB);
569
570 /// Targets should implement this to emit instructions.
571 virtual void emitInstruction(const MachineInstr *) {
572 llvm_unreachable("EmitInstruction not implemented");
573 }
574
575 /// Return the symbol for the specified constant pool entry.
576 virtual MCSymbol *GetCPISymbol(unsigned CPID) const;
577
578 virtual void emitFunctionEntryLabel();
579
580 virtual void emitFunctionDescriptor() {
581 llvm_unreachable("Function descriptor is target-specific.");
582 }
583
585
586 /// Targets can override this to change how global constants that are part of
587 /// a C++ static/global constructor list are emitted.
588 virtual void emitXXStructor(const DataLayout &DL, const Constant *CV) {
590 }
591
592 /// Return true if the basic block has exactly one predecessor and the control
593 /// transfer mechanism between the predecessor and this block is a
594 /// fall-through.
595 virtual bool
597
598 /// Targets can override this to customize the output of IMPLICIT_DEF
599 /// instructions in verbose mode.
600 virtual void emitImplicitDef(const MachineInstr *MI) const;
601
602 /// Emit N NOP instructions.
603 void emitNops(unsigned N);
604
605 //===------------------------------------------------------------------===//
606 // Symbol Lowering Routines.
607 //===------------------------------------------------------------------===//
608
609 MCSymbol *createTempSymbol(const Twine &Name) const;
610
611 /// Return the MCSymbol for a private symbol with global value name as its
612 /// base, with the specified suffix.
614 StringRef Suffix) const;
615
616 /// Return the MCSymbol for the specified ExternalSymbol.
618
619 /// Return the symbol for the specified jump table entry.
620 MCSymbol *GetJTISymbol(unsigned JTID, bool isLinkerPrivate = false) const;
621
622 /// Return the symbol for the specified jump table .set
623 /// FIXME: privatize to AsmPrinter.
624 MCSymbol *GetJTSetSymbol(unsigned UID, unsigned MBBID) const;
625
626 /// Return the MCSymbol used to satisfy BlockAddress uses of the specified
627 /// basic block.
629 MCSymbol *GetBlockAddressSymbol(const BasicBlock *BB) const;
630
631 //===------------------------------------------------------------------===//
632 // Emission Helper Routines.
633 //===------------------------------------------------------------------===//
634
635 /// This is just convenient handler for printing offsets.
636 void printOffset(int64_t Offset, raw_ostream &OS) const;
637
638 /// Emit a byte directive and value.
639 void emitInt8(int Value) const;
640
641 /// Emit a short directive and value.
642 void emitInt16(int Value) const;
643
644 /// Emit a long directive and value.
645 void emitInt32(int Value) const;
646
647 /// Emit a long long directive and value.
648 void emitInt64(uint64_t Value) const;
649
650 /// Emit the specified signed leb128 value.
651 void emitSLEB128(int64_t Value, const char *Desc = nullptr) const;
652
653 /// Emit the specified unsigned leb128 value.
654 void emitULEB128(uint64_t Value, const char *Desc = nullptr,
655 unsigned PadTo = 0) const;
656
657 /// Emit something like ".long Hi-Lo" where the size in bytes of the directive
658 /// is specified by Size and Hi/Lo specify the labels. This implicitly uses
659 /// .set if it is available.
660 void emitLabelDifference(const MCSymbol *Hi, const MCSymbol *Lo,
661 unsigned Size) const;
662
663 /// Emit something like ".uleb128 Hi-Lo".
665 const MCSymbol *Lo) const;
666
667 /// Emit something like ".long Label+Offset" where the size in bytes of the
668 /// directive is specified by Size and Label specifies the label. This
669 /// implicitly uses .set if it is available.
670 void emitLabelPlusOffset(const MCSymbol *Label, uint64_t Offset,
671 unsigned Size, bool IsSectionRelative = false) const;
672
673 /// Emit something like ".long Label" where the size in bytes of the directive
674 /// is specified by Size and Label specifies the label.
675 void emitLabelReference(const MCSymbol *Label, unsigned Size,
676 bool IsSectionRelative = false) const {
677 emitLabelPlusOffset(Label, 0, Size, IsSectionRelative);
678 }
679
680 //===------------------------------------------------------------------===//
681 // Dwarf Emission Helper Routines
682 //===------------------------------------------------------------------===//
683
684 /// Emit a .byte 42 directive that corresponds to an encoding. If verbose
685 /// assembly output is enabled, we output comments describing the encoding.
686 /// Desc is a string saying what the encoding is specifying (e.g. "LSDA").
687 void emitEncodingByte(unsigned Val, const char *Desc = nullptr) const;
688
689 /// Return the size of the encoding in bytes.
690 unsigned GetSizeOfEncodedValue(unsigned Encoding) const;
691
692 /// Emit reference to a ttype global with a specified encoding.
693 virtual void emitTTypeReference(const GlobalValue *GV, unsigned Encoding);
694
695 /// Emit a reference to a symbol for use in dwarf. Different object formats
696 /// represent this in different ways. Some use a relocation others encode
697 /// the label offset in its section.
698 void emitDwarfSymbolReference(const MCSymbol *Label,
699 bool ForceOffset = false) const;
700
701 /// Emit the 4- or 8-byte offset of a string from the start of its section.
702 ///
703 /// When possible, emit a DwarfStringPool section offset without any
704 /// relocations, and without using the symbol. Otherwise, defers to \a
705 /// emitDwarfSymbolReference().
706 ///
707 /// The length of the emitted value depends on the DWARF format.
709
710 /// Emit the 4-or 8-byte offset of a string from the start of its section.
713 }
714
715 /// Emit something like ".long Label + Offset" or ".quad Label + Offset"
716 /// depending on the DWARF format.
717 void emitDwarfOffset(const MCSymbol *Label, uint64_t Offset) const;
718
719 /// Emit 32- or 64-bit value depending on the DWARF format.
721
722 /// Emit a unit length field. The actual format, DWARF32 or DWARF64, is chosen
723 /// according to the settings.
724 void emitDwarfUnitLength(uint64_t Length, const Twine &Comment) const;
725
726 /// Emit a unit length field. The actual format, DWARF32 or DWARF64, is chosen
727 /// according to the settings.
728 /// Return the end symbol generated inside, the caller needs to emit it.
729 MCSymbol *emitDwarfUnitLength(const Twine &Prefix,
730 const Twine &Comment) const;
731
732 /// Emit reference to a call site with a specified encoding
733 void emitCallSiteOffset(const MCSymbol *Hi, const MCSymbol *Lo,
734 unsigned Encoding) const;
735 /// Emit an integer value corresponding to the call site encoding
736 void emitCallSiteValue(uint64_t Value, unsigned Encoding) const;
737
738 /// Get the value for DW_AT_APPLE_isa. Zero if no isa encoding specified.
739 virtual unsigned getISAEncoding() { return 0; }
740
741 /// Emit the directive and value for debug thread local expression
742 ///
743 /// \p Value - The value to emit.
744 /// \p Size - The size of the integer (in bytes) to emit.
745 virtual void emitDebugValue(const MCExpr *Value, unsigned Size) const;
746
747 //===------------------------------------------------------------------===//
748 // Dwarf Lowering Routines
749 //===------------------------------------------------------------------===//
750
751 /// Emit frame instruction to describe the layout of the frame.
752 void emitCFIInstruction(const MCCFIInstruction &Inst) const;
753
754 /// Emit Dwarf abbreviation table.
755 template <typename T> void emitDwarfAbbrevs(const T &Abbrevs) const {
756 // For each abbreviation.
757 for (const auto &Abbrev : Abbrevs)
758 emitDwarfAbbrev(*Abbrev);
759
760 // Mark end of abbreviations.
761 emitULEB128(0, "EOM(3)");
762 }
763
764 void emitDwarfAbbrev(const DIEAbbrev &Abbrev) const;
765
766 /// Recursively emit Dwarf DIE tree.
767 void emitDwarfDIE(const DIE &Die) const;
768
769 //===------------------------------------------------------------------===//
770 // CodeView Helper Routines
771 //===------------------------------------------------------------------===//
772
773 /// Gets information required to create a CodeView debug symbol for a jump
774 /// table.
775 /// Return value is <Base Address, Base Offset, Branch Address, Entry Size>
776 virtual std::tuple<const MCSymbol *, uint64_t, const MCSymbol *,
778 getCodeViewJumpTableInfo(int JTI, const MachineInstr *BranchInstr,
779 const MCSymbol *BranchLabel) const;
780
781 //===------------------------------------------------------------------===//
782 // Inline Asm Support
783 //===------------------------------------------------------------------===//
784
785 // These are hooks that targets can override to implement inline asm
786 // support. These should probably be moved out of AsmPrinter someday.
787
788 /// Print information related to the specified machine instr that is
789 /// independent of the operand, and may be independent of the instr itself.
790 /// This can be useful for portably encoding the comment character or other
791 /// bits of target-specific knowledge into the asmstrings. The syntax used is
792 /// ${:comment}. Targets can override this to add support for their own
793 /// strange codes.
794 virtual void PrintSpecial(const MachineInstr *MI, raw_ostream &OS,
795 StringRef Code) const;
796
797 /// Print the MachineOperand as a symbol. Targets with complex handling of
798 /// symbol references should override the base implementation.
799 virtual void PrintSymbolOperand(const MachineOperand &MO, raw_ostream &OS);
800
801 /// Print the specified operand of MI, an INLINEASM instruction, using the
802 /// specified assembler variant. Targets should override this to format as
803 /// appropriate. This method can return true if the operand is erroneous.
804 virtual bool PrintAsmOperand(const MachineInstr *MI, unsigned OpNo,
805 const char *ExtraCode, raw_ostream &OS);
806
807 /// Print the specified operand of MI, an INLINEASM instruction, using the
808 /// specified assembler variant as an address. Targets should override this to
809 /// format as appropriate. This method can return true if the operand is
810 /// erroneous.
811 virtual bool PrintAsmMemoryOperand(const MachineInstr *MI, unsigned OpNo,
812 const char *ExtraCode, raw_ostream &OS);
813
814 /// Let the target do anything it needs to do before emitting inlineasm.
815 /// \p StartInfo - the subtarget info before parsing inline asm
816 virtual void emitInlineAsmStart() const;
817
818 /// Let the target do anything it needs to do after emitting inlineasm.
819 /// This callback can be used restore the original mode in case the
820 /// inlineasm contains directives to switch modes.
821 /// \p StartInfo - the original subtarget info before inline asm
822 /// \p EndInfo - the final subtarget info after parsing the inline asm,
823 /// or NULL if the value is unknown.
824 virtual void emitInlineAsmEnd(const MCSubtargetInfo &StartInfo,
825 const MCSubtargetInfo *EndInfo) const;
826
827 /// This emits visibility information about symbol, if this is supported by
828 /// the target.
829 void emitVisibility(MCSymbol *Sym, unsigned Visibility,
830 bool IsDefinition = true) const;
831
832 /// This emits linkage information about \p GVSym based on \p GV, if this is
833 /// supported by the target.
834 virtual void emitLinkage(const GlobalValue *GV, MCSymbol *GVSym) const;
835
836 /// Return the alignment for the specified \p GV.
837 static Align getGVAlignment(const GlobalObject *GV, const DataLayout &DL,
838 Align InAlign = Align(1));
839
840private:
841 /// Private state for PrintSpecial()
842 // Assign a unique ID to this machine instruction.
843 mutable const MachineInstr *LastMI = nullptr;
844 mutable unsigned LastFn = 0;
845 mutable unsigned Counter = ~0U;
846
847 bool DwarfUsesRelocationsAcrossSections = false;
848
849 /// This method emits the header for the current function.
850 virtual void emitFunctionHeader();
851
852 /// This method emits a comment next to header for the current function.
853 virtual void emitFunctionHeaderComment();
854
855 /// Emit a blob of inline asm to the output streamer.
856 void
857 emitInlineAsm(StringRef Str, const MCSubtargetInfo &STI,
858 const MCTargetOptions &MCOptions,
859 const MDNode *LocMDNode = nullptr,
860 InlineAsm::AsmDialect AsmDialect = InlineAsm::AD_ATT) const;
861
862 /// This method formats and emits the specified machine instruction that is an
863 /// inline asm.
864 void emitInlineAsm(const MachineInstr *MI) const;
865
866 /// Add inline assembly info to the diagnostics machinery, so we can
867 /// emit file and position info. Returns SrcMgr memory buffer position.
868 unsigned addInlineAsmDiagBuffer(StringRef AsmStr,
869 const MDNode *LocMDNode) const;
870
871 //===------------------------------------------------------------------===//
872 // Internal Implementation Details
873 //===------------------------------------------------------------------===//
874
875 void emitJumpTableEntry(const MachineJumpTableInfo *MJTI,
876 const MachineBasicBlock *MBB, unsigned uid) const;
877 void emitLLVMUsedList(const ConstantArray *InitList);
878 /// Emit llvm.ident metadata in an '.ident' directive.
879 void emitModuleIdents(Module &M);
880 /// Emit bytes for llvm.commandline metadata.
881 virtual void emitModuleCommandLines(Module &M);
882
883 GCMetadataPrinter *getOrCreateGCPrinter(GCStrategy &S);
884 void emitGlobalAlias(Module &M, const GlobalAlias &GA);
885 void emitGlobalIFunc(Module &M, const GlobalIFunc &GI);
886
887 /// This method decides whether the specified basic block requires a label.
888 bool shouldEmitLabelForBasicBlock(const MachineBasicBlock &MBB) const;
889
890protected:
892 return false;
893 }
894};
895
896} // end namespace llvm
897
898#endif // LLVM_CODEGEN_ASMPRINTER_H
MachineBasicBlock & MBB
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
dxil metadata emit
This file defines the DenseMap class.
This file contains constants used for implementing Dwarf debug support.
std::string Name
uint64_t Size
Symbol * Sym
Definition: ELF_riscv.cpp:477
IRTranslator LLVM IR MI
#define F(x, y, z)
Definition: MD5.cpp:55
Machine Check Debug Module
This file implements a map that provides insertion order iteration.
raw_pwrite_stream & OS
This file defines the SmallVector class.
Represent the analysis usage information of a pass.
ArrayRef - Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition: ArrayRef.h:41
This class is intended to be used as a driving class for all asm writers.
Definition: AsmPrinter.h:84
virtual void emitInlineAsmEnd(const MCSubtargetInfo &StartInfo, const MCSubtargetInfo *EndInfo) const
Let the target do anything it needs to do after emitting inlineasm.
virtual void emitInstruction(const MachineInstr *)
Targets should implement this to emit instructions.
Definition: AsmPrinter.h:571
const TargetLoweringObjectFile & getObjFileLowering() const
Return information about object file lowering.
Definition: AsmPrinter.cpp:381
MCSymbol * getSymbolWithGlobalValueBase(const GlobalValue *GV, StringRef Suffix) const
Return the MCSymbol for a private symbol with global value name as its base, with the specified suffi...
MCSymbol * getSymbol(const GlobalValue *GV) const
Definition: AsmPrinter.cpp:679
void emitULEB128(uint64_t Value, const char *Desc=nullptr, unsigned PadTo=0) const
Emit the specified unsigned leb128 value.
SmallVector< XRayFunctionEntry, 4 > Sleds
Definition: AsmPrinter.h:372
void emitDwarfSymbolReference(const MCSymbol *Label, bool ForceOffset=false) const
Emit a reference to a symbol for use in dwarf.
void addAsmPrinterHandler(HandlerInfo Handler)
Definition: AsmPrinter.h:537
bool isDwarf64() const
CFISection getModuleCFISectionType() const
Get the CFISection type for the module.
Definition: AsmPrinter.h:446
void emitNops(unsigned N)
Emit N NOP instructions.
MCSymbol * CurrentFnBegin
Definition: AsmPrinter.h:200
unsigned GetSizeOfEncodedValue(unsigned Encoding) const
Return the size of the encoding in bytes.
MachineLoopInfo * MLI
This is a pointer to the current MachineLoopInfo.
Definition: AsmPrinter.h:111
virtual void emitDebugValue(const MCExpr *Value, unsigned Size) const
Emit the directive and value for debug thread local expression.
Definition: AsmPrinter.cpp:903
void EmitToStreamer(MCStreamer &S, const MCInst &Inst)
Definition: AsmPrinter.cpp:401
virtual void emitConstantPool()
Print to the current output stream assembly representations of the constants in the constant pool MCP...
void emitDwarfDIE(const DIE &Die) const
Recursively emit Dwarf DIE tree.
DwarfDebug * getDwarfDebug()
Definition: AsmPrinter.h:249
virtual void emitGlobalVariable(const GlobalVariable *GV)
Emit the specified global variable to the .s file.
Definition: AsmPrinter.cpp:701
void emitDwarfLengthOrOffset(uint64_t Value) const
Emit 32- or 64-bit value depending on the DWARF format.
unsigned int getUnitLengthFieldByteSize() const
Returns 4 for DWARF32 and 12 for DWARF64.
void emitLabelPlusOffset(const MCSymbol *Label, uint64_t Offset, unsigned Size, bool IsSectionRelative=false) const
Emit something like ".long Label+Offset" where the size in bytes of the directive is specified by Siz...
~AsmPrinter() override
Definition: AsmPrinter.cpp:367
TargetMachine & TM
Target machine description.
Definition: AsmPrinter.h:87
void emitXRayTable()
Emit a table with all XRay instrumentation points.
virtual void emitBasicBlockEnd(const MachineBasicBlock &MBB)
Targets can override this to emit stuff at the end of a basic block.
DwarfDebug * getDwarfDebug() const
Definition: AsmPrinter.h:250
MCSymbol * CurrentFnDescSym
The symbol for the current function descriptor on AIX.
Definition: AsmPrinter.h:125
MCSymbol * CurrentFnBeginLocal
For dso_local functions, the current $local alias for the function.
Definition: AsmPrinter.h:203
MapVector< const MCSymbol *, GOTEquivUsePair > GlobalGOTEquivs
Definition: AsmPrinter.h:143
void emitDwarfStringOffset(DwarfStringPoolEntry S) const
Emit the 4- or 8-byte offset of a string from the start of its section.
virtual MCSymbol * GetCPISymbol(unsigned CPID) const
Return the symbol for the specified constant pool entry.
void emitGlobalGOTEquivs()
Constant expressions using GOT equivalent globals may not be eligible for PC relative GOT entry conve...
virtual void PrintSymbolOperand(const MachineOperand &MO, raw_ostream &OS)
Print the MachineOperand as a symbol.
MCSymbol * getFunctionBegin() const
Definition: AsmPrinter.h:278
void emitLabelDifference(const MCSymbol *Hi, const MCSymbol *Lo, unsigned Size) const
Emit something like ".long Hi-Lo" where the size in bytes of the directive is specified by Size and H...
void emitKCFITrapEntry(const MachineFunction &MF, const MCSymbol *Symbol)
MCSymbol * getMBBExceptionSym(const MachineBasicBlock &MBB)
MCSymbol * getAddrLabelSymbol(const BasicBlock *BB)
Return the symbol to be used for the specified basic block when its address is taken.
Definition: AsmPrinter.h:288
virtual void emitTTypeReference(const GlobalValue *GV, unsigned Encoding)
Emit reference to a ttype global with a specified encoding.
const MCAsmInfo * MAI
Target Asm Printer information.
Definition: AsmPrinter.h:90
bool emitSpecialLLVMGlobal(const GlobalVariable *GV)
Check to see if the specified global is a special global used by LLVM.
MachineFunction * MF
The current machine function.
Definition: AsmPrinter.h:102
void emitDwarfOffset(const MCSymbol *Label, uint64_t Offset) const
Emit something like ".long Label + Offset" or ".quad Label + Offset" depending on the DWARF format.
virtual void PrintSpecial(const MachineInstr *MI, raw_ostream &OS, StringRef Code) const
Print information related to the specified machine instr that is independent of the operand,...
virtual void emitJumpTableInfo()
Print assembly representations of the jump tables used by the current function to the current output ...
void computeGlobalGOTEquivs(Module &M)
Unnamed constant global variables solely contaning a pointer to another globals variable act like a g...
static Align getGVAlignment(const GlobalObject *GV, const DataLayout &DL, Align InAlign=Align(1))
Return the alignment for the specified GV.
Definition: AsmPrinter.cpp:334
void emitInt8(int Value) const
Emit a byte directive and value.
CFISection getFunctionCFISectionType(const Function &F) const
Get the CFISection type for a function.
virtual void SetupMachineFunction(MachineFunction &MF)
This should be called when a new MachineFunction is being processed from runOnMachineFunction.
void emitFunctionBody()
This method emits the body and trailer for a function.
virtual bool isBlockOnlyReachableByFallthrough(const MachineBasicBlock *MBB) const
Return true if the basic block has exactly one predecessor and the control transfer mechanism between...
void emitBBAddrMapSection(const MachineFunction &MF)
void emitPCSections(const MachineFunction &MF)
Emits the PC sections collected from instructions.
MapVector< unsigned, MBBSectionRange > MBBSectionRanges
Definition: AsmPrinter.h:138
MachineDominatorTree * MDT
This is a pointer to the current MachineDominatorTree.
Definition: AsmPrinter.h:108
virtual void emitStartOfAsmFile(Module &)
This virtual method can be overridden by targets that want to emit something at the start of their fi...
Definition: AsmPrinter.h:547
MCSymbol * GetJTISymbol(unsigned JTID, bool isLinkerPrivate=false) const
Return the symbol for the specified jump table entry.
virtual void emitMachineConstantPoolValue(MachineConstantPoolValue *MCPV)
void emitStackMaps()
Emit the stack maps.
void emitDwarfUnitLength(uint64_t Length, const Twine &Comment) const
Emit a unit length field.
virtual void emitFunctionBodyStart()
Targets can override this to emit stuff before the first basic block in the function.
Definition: AsmPrinter.h:555
std::pair< const GlobalVariable *, unsigned > GOTEquivUsePair
Map global GOT equivalent MCSymbols to GlobalVariables and keep track of its number of uses by other ...
Definition: AsmPrinter.h:142
void emitPatchableFunctionEntries()
void recordSled(MCSymbol *Sled, const MachineInstr &MI, SledKind Kind, uint8_t Version=0)
virtual void emitEndOfAsmFile(Module &)
This virtual method can be overridden by targets that want to emit something at the end of their file...
Definition: AsmPrinter.h:551
bool doInitialization(Module &M) override
Set up the AsmPrinter when we are working on a new module.
Definition: AsmPrinter.cpp:431
MCSymbol * GetJTSetSymbol(unsigned UID, unsigned MBBID) const
Return the symbol for the specified jump table .set FIXME: privatize to AsmPrinter.
void emitEncodingByte(unsigned Val, const char *Desc=nullptr) const
Emit a .byte 42 directive that corresponds to an encoding.
virtual void emitImplicitDef(const MachineInstr *MI) const
Targets can override this to customize the output of IMPLICIT_DEF instructions in verbose mode.
virtual void emitLinkage(const GlobalValue *GV, MCSymbol *GVSym) const
This emits linkage information about GVSym based on GV, if this is supported by the target.
Definition: AsmPrinter.cpp:634
void getAnalysisUsage(AnalysisUsage &AU) const override
Record analysis usage.
Definition: AsmPrinter.cpp:423
unsigned getFunctionNumber() const
Return a unique ID for the current function.
Definition: AsmPrinter.cpp:377
MachineOptimizationRemarkEmitter * ORE
Optimization remark emitter.
Definition: AsmPrinter.h:114
virtual bool shouldEmitWeakSwiftAsyncExtendedFramePointerFlags() const
Definition: AsmPrinter.h:891
void printOffset(int64_t Offset, raw_ostream &OS) const
This is just convenient handler for printing offsets.
void emitGlobalConstant(const DataLayout &DL, const Constant *CV, AliasMapTy *AliasList=nullptr)
EmitGlobalConstant - Print a general LLVM constant to the .s file.
virtual const MCSymbol * getFunctionFrameSymbol() const
Return symbol for the function pseudo stack if the stack frame is not a register based.
Definition: AsmPrinter.h:276
void emitFrameAlloc(const MachineInstr &MI)
void emitDwarfStringOffset(DwarfStringPoolEntryRef S) const
Emit the 4-or 8-byte offset of a string from the start of its section.
Definition: AsmPrinter.h:711
void emitStackSizeSection(const MachineFunction &MF)
MCSymbol * getSymbolPreferLocal(const GlobalValue &GV) const
Similar to getSymbol() but preferred for references.
Definition: AsmPrinter.cpp:683
MCSymbol * CurrentFnSym
The symbol for the current function.
Definition: AsmPrinter.h:121
MachineModuleInfo * MMI
This is a pointer to the current MachineModuleInfo.
Definition: AsmPrinter.h:105
void emitDwarfAbbrevs(const T &Abbrevs) const
Emit Dwarf abbreviation table.
Definition: AsmPrinter.h:755
void emitSLEB128(int64_t Value, const char *Desc=nullptr) const
Emit the specified signed leb128 value.
void emitAlignment(Align Alignment, const GlobalObject *GV=nullptr, unsigned MaxBytesToEmit=0) const
Emit an alignment directive to the specified power of two boundary.
MCContext & OutContext
This is the context for the output file that we are streaming.
Definition: AsmPrinter.h:94
void emitCFIInstruction(const MachineInstr &MI)
MCSymbol * createTempSymbol(const Twine &Name) const
bool doFinalization(Module &M) override
Shut down the asmprinter.
void emitStackUsage(const MachineFunction &MF)
MCSymbol * GetExternalSymbolSymbol(StringRef Sym) const
Return the MCSymbol for the specified ExternalSymbol.
virtual void emitKCFITypeId(const MachineFunction &MF)
bool isPositionIndependent() const
Definition: AsmPrinter.cpp:372
virtual void emitXXStructorList(const DataLayout &DL, const Constant *List, bool IsCtor)
This method emits llvm.global_ctors or llvm.global_dtors list.
void emitPCSectionsLabel(const MachineFunction &MF, const MDNode &MD)
Emits a label as reference for PC sections.
void emitCallSiteOffset(const MCSymbol *Hi, const MCSymbol *Lo, unsigned Encoding) const
Emit reference to a call site with a specified encoding.
MCSymbol * CurrentPatchableFunctionEntrySym
The symbol for the entry in __patchable_function_entires.
Definition: AsmPrinter.h:117
virtual void emitBasicBlockStart(const MachineBasicBlock &MBB)
Targets can override this to emit stuff at the start of a basic block.
void takeDeletedSymbolsForFunction(const Function *F, std::vector< MCSymbol * > &Result)
If the specified function has had any references to address-taken blocks generated,...
Definition: AsmPrinter.cpp:267
void emitVisibility(MCSymbol *Sym, unsigned Visibility, bool IsDefinition=true) const
This emits visibility information about symbol, if this is supported by the target.
bool runOnMachineFunction(MachineFunction &MF) override
Emit the specified function out to the OutStreamer.
Definition: AsmPrinter.h:399
void emitDwarfAbbrev(const DIEAbbrev &Abbrev) const
void setDwarfUsesRelocationsAcrossSections(bool Enable)
Definition: AsmPrinter.h:338
void emitInt32(int Value) const
Emit a long directive and value.
std::unique_ptr< MCStreamer > OutStreamer
This is the MCStreamer object for the file we are generating.
Definition: AsmPrinter.h:99
virtual const MCExpr * lowerConstant(const Constant *CV)
Lower the specified LLVM Constant to an MCExpr.
void emitLabelReference(const MCSymbol *Label, unsigned Size, bool IsSectionRelative=false) const
Emit something like ".long Label" where the size in bytes of the directive is specified by Size and L...
Definition: AsmPrinter.h:675
virtual void emitFunctionDescriptor()
Definition: AsmPrinter.h:580
const MCSection * getCurrentSection() const
Return the current section we are emitting to.
Definition: AsmPrinter.cpp:419
unsigned int getDwarfOffsetByteSize() const
Returns 4 for DWARF32 and 8 for DWARF64.
virtual bool PrintAsmMemoryOperand(const MachineInstr *MI, unsigned OpNo, const char *ExtraCode, raw_ostream &OS)
Print the specified operand of MI, an INLINEASM instruction, using the specified assembler variant as...
size_t NumUserHandlers
Definition: AsmPrinter.h:208
MCSymbol * CurrentFnSymForSize
The symbol used to represent the start of the current function for the purpose of calculating its siz...
Definition: AsmPrinter.h:130
virtual unsigned getISAEncoding()
Get the value for DW_AT_APPLE_isa. Zero if no isa encoding specified.
Definition: AsmPrinter.h:739
bool isVerbose() const
Return true if assembly output should contain comments.
Definition: AsmPrinter.h:269
MCSymbol * getFunctionEnd() const
Definition: AsmPrinter.h:279
virtual void emitXXStructor(const DataLayout &DL, const Constant *CV)
Targets can override this to change how global constants that are part of a C++ static/global constru...
Definition: AsmPrinter.h:588
void preprocessXXStructorList(const DataLayout &DL, const Constant *List, SmallVector< Structor, 8 > &Structors)
This method gathers an array of Structors and then sorts them out by Priority.
void emitInt16(int Value) const
Emit a short directive and value.
void setDwarfVersion(uint16_t Version)
void getNameWithPrefix(SmallVectorImpl< char > &Name, const GlobalValue *GV) const
Definition: AsmPrinter.cpp:674
void emitPseudoProbe(const MachineInstr &MI)
unsigned getPointerSize() const
Return the pointer size from the TargetMachine.
Definition: AsmPrinter.cpp:392
void emitRemarksSection(remarks::RemarkStreamer &RS)
StackMaps SM
Definition: AsmPrinter.h:210
MCSymbol * GetBlockAddressSymbol(const BlockAddress *BA) const
Return the MCSymbol used to satisfy BlockAddress uses of the specified basic block.
ArrayRef< MCSymbol * > getAddrLabelSymbolToEmit(const BasicBlock *BB)
Return the symbol to be used for the specified basic block when its address is taken.
Definition: AsmPrinter.cpp:259
virtual void emitFunctionBodyEnd()
Targets can override this to emit stuff after the last basic block in the function.
Definition: AsmPrinter.h:559
const DataLayout & getDataLayout() const
Return information about data layout.
Definition: AsmPrinter.cpp:385
virtual void emitFunctionEntryLabel()
EmitFunctionEntryLabel - Emit the label that is the entrypoint for the function.
void emitInitialRawDwarfLocDirective(const MachineFunction &MF)
Emits inital debug location directive.
Definition: AsmPrinter.cpp:405
void emitInt64(uint64_t Value) const
Emit a long long directive and value.
uint16_t getDwarfVersion() const
dwarf::FormParams getDwarfFormParams() const
Returns information about the byte size of DW_FORM values.
const MCSubtargetInfo & getSubtargetInfo() const
Return information about subtarget.
Definition: AsmPrinter.cpp:396
bool usesCFIWithoutEH() const
Since emitting CFI unwind information is entangled with supporting the exceptions,...
bool doesDwarfUseRelocationsAcrossSections() const
Definition: AsmPrinter.h:334
virtual void emitInlineAsmStart() const
Let the target do anything it needs to do before emitting inlineasm.
@ None
Do not emit either .eh_frame or .debug_frame.
@ Debug
Emit .debug_frame.
virtual std::tuple< const MCSymbol *, uint64_t, const MCSymbol *, codeview::JumpTableEntrySize > getCodeViewJumpTableInfo(int JTI, const MachineInstr *BranchInstr, const MCSymbol *BranchLabel) const
Gets information required to create a CodeView debug symbol for a jump table.
virtual bool PrintAsmOperand(const MachineInstr *MI, unsigned OpNo, const char *ExtraCode, raw_ostream &OS)
Print the specified operand of MI, an INLINEASM instruction, using the specified assembler variant.
void emitCallSiteValue(uint64_t Value, unsigned Encoding) const
Emit an integer value corresponding to the call site encoding.
void emitLabelDifferenceAsULEB128(const MCSymbol *Hi, const MCSymbol *Lo) const
Emit something like ".uleb128 Hi-Lo".
std::vector< HandlerInfo > Handlers
A vector of all debug/EH info emitters we should use.
Definition: AsmPrinter.h:207
LLVM Basic Block Representation.
Definition: BasicBlock.h:60
The address of a basic block.
Definition: Constants.h:874
ConstantArray - Constant Array Declarations.
Definition: Constants.h:408
This is an important base class in LLVM.
Definition: Constant.h:41
Dwarf abbreviation, describes the organization of a debug information object.
Definition: DIE.h:79
A structured debug information entry.
Definition: DIE.h:819
A parsed version of the target data layout string in and methods for querying it.
Definition: DataLayout.h:110
Collects and handles dwarf debug information.
Definition: DwarfDebug.h:351
DwarfStringPoolEntryRef: Dwarf string pool entry reference.
const DwarfStringPoolEntry & getEntry() const
GCMetadataPrinter - Emits GC metadata as assembly code.
GCStrategy describes a garbage collector algorithm's code generation requirements,...
Definition: GCStrategy.h:63
This class is intended to be used as a base class for asm properties and features specific to the tar...
Definition: MCAsmInfo.h:56
Context object for machine code objects.
Definition: MCContext.h:76
Base class for the full range of assembler expressions which are needed for parsing.
Definition: MCExpr.h:35
Instances of this class represent a single low-level machine instruction.
Definition: MCInst.h:184
Instances of this class represent a uniqued identifier for a section in the current translation unit.
Definition: MCSection.h:39
Streaming machine code generation interface.
Definition: MCStreamer.h:212
Generic base class for all target subtargets.
MCSymbol - Instances of this class represent a symbol name in the MC file, and MCSymbols are created ...
Definition: MCSymbol.h:40
Metadata node.
Definition: Metadata.h:1037
Abstract base class for all machine specific constantpool value subclasses.
DominatorTree Class - Concrete subclass of DominatorTreeBase that is used to compute a normal dominat...
MachineFunctionPass - This class adapts the FunctionPass interface to allow convenient creation of pa...
Representation of each machine instruction.
Definition: MachineInstr.h:68
This class contains meta information specific to a module.
MachineOperand class - Representation of each machine instruction operand.
This class implements a map that also provides access to all stored values in a deterministic order.
Definition: MapVector.h:36
A Module instance is used to store all the information related to an LLVM module.
Definition: Module.h:65
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:577
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
Definition: SmallVector.h:1200
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
Primary interface to the complete machine description for the target machine.
Definition: TargetMachine.h:78
Twine - A lightweight data structure for efficiently representing the concatenation of temporary valu...
Definition: Twine.h:81
LLVM Value Representation.
Definition: Value.h:74
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition: raw_ostream.h:52
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
@ BasicBlock
Various leaf nodes.
Definition: ISDOpcodes.h:71
@ BlockAddress
Definition: ISDOpcodes.h:84
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
@ Offset
Definition: DWP.cpp:440
@ Length
Definition: DWP.cpp:440
OutputIt move(R &&Range, OutputIt Out)
Provide wrappers to std::move which take ranges instead of having to pass begin/end explicitly.
Definition: STLExtras.h:1853
@ Enable
Enable colors.
Implement std::hash so that hash_code can be used in STL containers.
Definition: BitVector.h:858
#define N
This struct is a compact representation of a valid (non-zero power of two) alignment.
Definition: Alignment.h:39
struct HandlerInfo and Handlers permit users or target extended AsmPrinter to add their own handlers.
Definition: AsmPrinter.h:147
HandlerInfo(std::unique_ptr< AsmPrinterHandler > Handler, StringRef TimerName, StringRef TimerDescription, StringRef TimerGroupName, StringRef TimerGroupDescription)
Definition: AsmPrinter.h:154
std::unique_ptr< AsmPrinterHandler > Handler
Definition: AsmPrinter.h:148
Map a basic block section ID to the begin and end symbols of that section which determine the section...
Definition: AsmPrinter.h:134
llvm.global_ctors and llvm.global_dtors are arrays of Structor structs.
Definition: AsmPrinter.h:478
const class Function * Fn
Definition: AsmPrinter.h:365
Description of the encoding of one expression Op.
Data for a string pool entry.
A helper struct providing information about the byte size of DW_FORM values that vary in size dependi...
Definition: Dwarf.h:743