contrib/llvm-project/llvm/lib/Target/AMDGPU/AMDGPUAsmPrinter.h

   1 //===-- AMDGPUAsmPrinter.h - Print AMDGPU assembly code ---------*- 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 /// \file
  10 /// AMDGPU Assembly printer class.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 #ifndef LLVM_LIB_TARGET_AMDGPU_AMDGPUASMPRINTER_H
  15 #define LLVM_LIB_TARGET_AMDGPU_AMDGPUASMPRINTER_H
  16
  17 #include "AMDGPU.h"
  18 #include "AMDKernelCodeT.h"
  19 #include "AMDGPUHSAMetadataStreamer.h"
  20 #include "SIProgramInfo.h"
  21 #include "llvm/ADT/StringRef.h"
  22 #include "llvm/CodeGen/AsmPrinter.h"
  23 #include "llvm/Support/AMDHSAKernelDescriptor.h"
  24 #include <cstddef>
  25 #include <cstdint>
  26 #include <limits>
  27 #include <memory>
  28 #include <string>
  29 #include <vector>
  30
  31 namespace llvm {
  32
  33 class AMDGPUMachineFunction;
  34 class AMDGPUTargetStreamer;
  35 class MCCodeEmitter;
  36 class MCOperand;
  37 class GCNSubtarget;
  38
  39 class AMDGPUAsmPrinter final : public AsmPrinter {
  40 private:
  41   // Track resource usage for callee functions.
  42   struct SIFunctionResourceInfo {
  43     // Track the number of explicitly used VGPRs. Special registers reserved at
  44     // the end are tracked separately.
  45     int32_t NumVGPR = 0;
  46     int32_t NumAGPR = 0;
  47     int32_t NumExplicitSGPR = 0;
  48     uint64_t PrivateSegmentSize = 0;
  49     bool UsesVCC = false;
  50     bool UsesFlatScratch = false;
  51     bool HasDynamicallySizedStack = false;
  52     bool HasRecursion = false;
  53
  54     int32_t getTotalNumSGPRs(const GCNSubtarget &ST) const;
  55     int32_t getTotalNumVGPRs(const GCNSubtarget &ST) const;
  56   };
  57
  58   SIProgramInfo CurrentProgramInfo;
  59   DenseMap<const Function *, SIFunctionResourceInfo> CallGraphResourceInfo;
  60
  61   std::unique_ptr<AMDGPU::HSAMD::MetadataStreamer> HSAMetadataStream;
  62
  63   MCCodeEmitter *DumpCodeInstEmitter = nullptr;
  64
  65   uint64_t getFunctionCodeSize(const MachineFunction &MF) const;
  66   SIFunctionResourceInfo analyzeResourceUsage(const MachineFunction &MF) const;
  67
  68   void getSIProgramInfo(SIProgramInfo &Out, const MachineFunction &MF);
  69   void getAmdKernelCode(amd_kernel_code_t &Out, const SIProgramInfo &KernelInfo,
  70                         const MachineFunction &MF) const;
  71   void findNumUsedRegistersSI(const MachineFunction &MF,
  72                               unsigned &NumSGPR,
  73                               unsigned &NumVGPR) const;
  74
  75   /// Emit register usage information so that the GPU driver
  76   /// can correctly setup the GPU state.
  77   void EmitProgramInfoSI(const MachineFunction &MF,
  78                          const SIProgramInfo &KernelInfo);
  79   void EmitPALMetadata(const MachineFunction &MF,
  80                        const SIProgramInfo &KernelInfo);
  81   void emitCommonFunctionComments(uint32_t NumVGPR,
  82                                   Optional<uint32_t> NumAGPR,
  83                                   uint32_t TotalNumVGPR,
  84                                   uint32_t NumSGPR,
  85                                   uint64_t ScratchSize,
  86                                   uint64_t CodeSize,
  87                                   const AMDGPUMachineFunction* MFI);
  88
  89   uint16_t getAmdhsaKernelCodeProperties(
  90       const MachineFunction &MF) const;
  91
  92   amdhsa::kernel_descriptor_t getAmdhsaKernelDescriptor(
  93       const MachineFunction &MF,
  94       const SIProgramInfo &PI) const;
  95
  96 public:
  97   explicit AMDGPUAsmPrinter(TargetMachine &TM,
  98                             std::unique_ptr<MCStreamer> Streamer);
  99
 100   StringRef getPassName() const override;
 101
 102   const MCSubtargetInfo* getGlobalSTI() const;
 103
 104   AMDGPUTargetStreamer* getTargetStreamer() const;
 105
 106   bool doFinalization(Module &M) override;
 107   bool runOnMachineFunction(MachineFunction &MF) override;
 108
 109   /// Wrapper for MCInstLowering.lowerOperand() for the tblgen'erated
 110   /// pseudo lowering.
 111   bool lowerOperand(const MachineOperand &MO, MCOperand &MCOp) const;
 112
 113   /// Lower the specified LLVM Constant to an MCExpr.
 114   /// The AsmPrinter::lowerConstantof does not know how to lower
 115   /// addrspacecast, therefore they should be lowered by this function.
 116   const MCExpr *lowerConstant(const Constant *CV) override;
 117
 118   /// tblgen'erated driver function for lowering simple MI->MC pseudo
 119   /// instructions.
 120   bool emitPseudoExpansionLowering(MCStreamer &OutStreamer,
 121                                    const MachineInstr *MI);
 122
 123   /// Implemented in AMDGPUMCInstLower.cpp
 124   void EmitInstruction(const MachineInstr *MI) override;
 125
 126   void EmitFunctionBodyStart() override;
 127
 128   void EmitFunctionBodyEnd() override;
 129
 130   void EmitFunctionEntryLabel() override;
 131
 132   void EmitBasicBlockStart(const MachineBasicBlock &MBB) override;
 133
 134   void EmitGlobalVariable(const GlobalVariable *GV) override;
 135
 136   void EmitStartOfAsmFile(Module &M) override;
 137
 138   void EmitEndOfAsmFile(Module &M) override;
 139
 140   bool isBlockOnlyReachableByFallthrough(
 141     const MachineBasicBlock *MBB) const override;
 142
 143   bool PrintAsmOperand(const MachineInstr *MI, unsigned OpNo,
 144                        const char *ExtraCode, raw_ostream &O) override;
 145
 146 protected:
 147   std::vector<std::string> DisasmLines, HexLines;
 148   size_t DisasmLineMaxLen;
 149 };
 150
 151 } // end namespace llvm
 152
 153 #endif // LLVM_LIB_TARGET_AMDGPU_AMDGPUASMPRINTER_H