AsmPrinter.h revision 290c2f56ce551ebcf4480ac2944986fe4bb339e9
1a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner//===-- llvm/CodeGen/AsmPrinter.h - AsmPrinter Framework --------*- C++ -*-===// 2ea61c358720aa6c7a159d51658b34276316aa841Misha Brukman// 3a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner// The LLVM Compiler Infrastructure 4a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner// 57ed47a13356daed2a34cd2209a31f92552e3bdd8Chris Lattner// This file is distributed under the University of Illinois Open Source 67ed47a13356daed2a34cd2209a31f92552e3bdd8Chris Lattner// License. See LICENSE.TXT for details. 7ea61c358720aa6c7a159d51658b34276316aa841Misha Brukman// 8a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner//===----------------------------------------------------------------------===// 9a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner// 10563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey// This file contains a class to be used as the base class for target specific 11563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey// asm writers. This class primarily handles common functionality used by 12563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey// all asm writers. 13a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner// 14a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner//===----------------------------------------------------------------------===// 15a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 16a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner#ifndef LLVM_CODEGEN_ASMPRINTER_H 17a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner#define LLVM_CODEGEN_ASMPRINTER_H 18a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 19a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner#include "llvm/CodeGen/MachineFunctionPass.h" 2098a366d547772010e94609e4584489b3e5ce0043Bill Wendling#include "llvm/Target/TargetMachine.h" 21dd061f6085e7492089befa7ed88dd0669ccb049aChris Lattner#include "llvm/ADT/DenseMap.h" 22a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 23a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattnernamespace llvm { 245eca075b74d62c621b160aa216b4cd50829a2cc7Gordon Henriksen class GCStrategy; 25a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner class Constant; 26c884db47f1a1d5449b749e6528292451e49025e4Jeff Cohen class ConstantArray; 2700d448a341175556ebd86af68219f5b90b7145a3Dan Gohman class ConstantInt; 2800d448a341175556ebd86af68219f5b90b7145a3Dan Gohman class ConstantStruct; 2900d448a341175556ebd86af68219f5b90b7145a3Dan Gohman class ConstantVector; 30c317a60c2714a5b90700a11ba646285cb754a5d3Gordon Henriksen class GCMetadataPrinter; 31ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner class GlobalVariable; 322d2cec1e9e93a388bd8448f4bad661ac89a49de3Evan Cheng class MachineConstantPoolEntry; 33d6594ae54cfde4db4d30272192645c0a45fb9902Evan Cheng class MachineConstantPoolValue; 340de1fc4f416b3e94749ca84cdaede55b040a8b60Chris Lattner class MachineModuleInfo; 35014700c1a8cba203fd21ff129426ba8a426ab244David Greene class MCInst; 362b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner class MCContext; 37a87dea4f8c546ca748f1777a8d1cabcc06515d91Chris Lattner class MCSection; 382b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner class MCStreamer; 39c48c550e1322aebfbe35c7570891619db43bdb9bDevang Patel class DwarfWriter; 40563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey class Mangler; 41563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey class TargetAsmInfo; 42f0144127b98425d214e59e4a1a4b342b78e3642bChris Lattner class TargetLoweringObjectFile; 4384bc5427d6883f73cfeae3da640acd011d35c006Chris Lattner class Type; 4471847813bc419f7a0667468136a07429c6d9f164David Greene class formatted_raw_ostream; 45a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 46563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey /// AsmPrinter - This class is intended to be used as a driving class for all 47563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey /// asm writers. 48a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner class AsmPrinter : public MachineFunctionPass { 491997473cf72957d0e70322e2fe6fe2ab141c58a6Devang Patel static char ID; 50794fd75c67a2cdc128d67342c6d88a504d186896Devang Patel 51347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// FunctionNumber - This provides a unique ID for each function emitted in 52347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// this translation unit. It is autoincremented by SetupMachineFunction, 53347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// and can be accessed with getFunctionNumber() and 54347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// IncrementFunctionNumber(). 55347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// 56347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng unsigned FunctionNumber; 57347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng 58c317a60c2714a5b90700a11ba646285cb754a5d3Gordon Henriksen // GCMetadataPrinters - The garbage collection metadata printer table. 595eca075b74d62c621b160aa216b4cd50829a2cc7Gordon Henriksen typedef DenseMap<GCStrategy*,GCMetadataPrinter*> gcp_map_type; 60c317a60c2714a5b90700a11ba646285cb754a5d3Gordon Henriksen typedef gcp_map_type::iterator gcp_iterator; 61c317a60c2714a5b90700a11ba646285cb754a5d3Gordon Henriksen gcp_map_type GCMetadataPrinters; 6267e59834fc1dca7e357c40af2e5144f3d62f5133David Greene 63290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner /// CurrentSection - The current section we are emitting to. This is 64290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner /// controlled and used by the SwitchToSection method. 65290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner const MCSection *CurrentSection; 66290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner 6715404d060ba8b604c03b9223a0f2e2abcd0fddedRafael Espindola protected: 680de1fc4f416b3e94749ca84cdaede55b040a8b60Chris Lattner /// MMI - If available, this is a pointer to the current MachineModuleInfo. 690de1fc4f416b3e94749ca84cdaede55b040a8b60Chris Lattner MachineModuleInfo *MMI; 700de1fc4f416b3e94749ca84cdaede55b040a8b60Chris Lattner 710de1fc4f416b3e94749ca84cdaede55b040a8b60Chris Lattner /// DW - If available, this is a pointer to the current dwarf writer. 72cb819f13d785ff6efcacfbd7d0fa9f3f67e5494dBill Wendling DwarfWriter *DW; 73014700c1a8cba203fd21ff129426ba8a426ab244David Greene 74b2efb853f00d45b1c8d57f92acd0028fbdeffda6Jim Laskey public: 75a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// Output stream on which we're printing assembly code. 76a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// 7771847813bc419f7a0667468136a07429c6d9f164David Greene formatted_raw_ostream &O; 78a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 79a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// Target machine description. 80a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// 81a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner TargetMachine &TM; 82563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey 83f0144127b98425d214e59e4a1a4b342b78e3642bChris Lattner /// getObjFileLowering - Return information about object file lowering. 8438c398808cff7defdf013fa750dfac8e66302975Chris Lattner TargetLoweringObjectFile &getObjFileLowering() const; 85f0144127b98425d214e59e4a1a4b342b78e3642bChris Lattner 86563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey /// Target Asm Printer information. 87563321a2582851c653d0863e8e0bba3d483734f9Jim Laskey /// 88a0f3d17daac73c9c71aad497b298cbe82848f726Jim Laskey const TargetAsmInfo *TAI; 89a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 90da47e6e0d003c873da960361549e57ee4617c301Evan Cheng /// Target Register Information. 91da47e6e0d003c873da960361549e57ee4617c301Evan Cheng /// 92da47e6e0d003c873da960361549e57ee4617c301Evan Cheng const TargetRegisterInfo *TRI; 93da47e6e0d003c873da960361549e57ee4617c301Evan Cheng 942b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// OutContext - This is the context for the output file that we are 952b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// streaming. This owns all of the global MC-related objects for the 962b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// generated translation unit. 972b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner MCContext &OutContext; 982b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner 992b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// OutStreamer - This is the MCStreamer object for the file we are 1002b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// generating. This contains the transient state for the current 1012b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// translation unit that we are generating (such as the current section 1022b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner /// etc). 1032b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner MCStreamer &OutStreamer; 1042b2954f00ba02ca1a902f47080cd9f06aebc0378Chris Lattner 10557f0db833dc30404f1f5d28b23df326e520698ecBill Wendling /// The current machine function. 10657f0db833dc30404f1f5d28b23df326e520698ecBill Wendling const MachineFunction *MF; 10757f0db833dc30404f1f5d28b23df326e520698ecBill Wendling 108a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// Name-mangler for global names. 109a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// 110a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner Mangler *Mang; 111a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 112a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// Cache of mangled name for current function. This is recalculated at the 113a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// beginning of each call to runOnMachineFunction(). 114a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// 115a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner std::string CurrentFnName; 11697e32e3239c0f065698f8c004b2b3009162f5ed6Chris Lattner 117290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner /// getCurrentSection() - Return the current section we are emitting to. 118290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner const MCSection *getCurrentSection() const { return CurrentSection; } 119290c2f56ce551ebcf4480ac2944986fe4bb339e9Chris Lattner 12042bf74be1402df7409efbea089310d4c276fde37Evan Cheng 12142bf74be1402df7409efbea089310d4c276fde37Evan Cheng /// VerboseAsm - Emit comments in assembly output if this is true. 12242bf74be1402df7409efbea089310d4c276fde37Evan Cheng /// 12342bf74be1402df7409efbea089310d4c276fde37Evan Cheng bool VerboseAsm; 12442bf74be1402df7409efbea089310d4c276fde37Evan Cheng 125bd58edf59128d2acb5ae48c76ef8a108fd587db2Owen Anderson /// Private state for PrintSpecial() 126bd58edf59128d2acb5ae48c76ef8a108fd587db2Owen Anderson // Assign a unique ID to this machine instruction. 127bd58edf59128d2acb5ae48c76ef8a108fd587db2Owen Anderson mutable const MachineInstr *LastMI; 128bd58edf59128d2acb5ae48c76ef8a108fd587db2Owen Anderson mutable const Function *LastFn; 129bd58edf59128d2acb5ae48c76ef8a108fd587db2Owen Anderson mutable unsigned Counter; 130a8dbf36f3f88917b101d7ab9d253ba2fe6e396b4Owen Anderson 131a8dbf36f3f88917b101d7ab9d253ba2fe6e396b4Owen Anderson // Private state for processDebugLock() 132a8dbf36f3f88917b101d7ab9d253ba2fe6e396b4Owen Anderson mutable DebugLocTuple PrevDLT; 133bd58edf59128d2acb5ae48c76ef8a108fd587db2Owen Anderson 134b2efb853f00d45b1c8d57f92acd0028fbdeffda6Jim Laskey protected: 13571847813bc419f7a0667468136a07429c6d9f164David Greene explicit AsmPrinter(formatted_raw_ostream &o, TargetMachine &TM, 1365bcc8bd0c60cfe583ee47852950aad9e532c932eDaniel Dunbar const TargetAsmInfo *T, bool V); 137ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner 138a7cea6f599418a579ab5ce66413fba7efa8bf581Jim Laskey public: 139c317a60c2714a5b90700a11ba646285cb754a5d3Gordon Henriksen virtual ~AsmPrinter(); 14042bf74be1402df7409efbea089310d4c276fde37Evan Cheng 14142bf74be1402df7409efbea089310d4c276fde37Evan Cheng /// isVerbose - Return true if assembly output should contain comments. 14242bf74be1402df7409efbea089310d4c276fde37Evan Cheng /// 14342bf74be1402df7409efbea089310d4c276fde37Evan Cheng bool isVerbose() const { return VerboseAsm; } 14442bf74be1402df7409efbea089310d4c276fde37Evan Cheng 145b5a32e2e8ce2f3de3a340c5a2dfcd3a159968466Anton Korobeynikov /// SwitchToSection - Switch to the specified section of the executable if 146b5a32e2e8ce2f3de3a340c5a2dfcd3a159968466Anton Korobeynikov /// we are not already in it! 147a87dea4f8c546ca748f1777a8d1cabcc06515d91Chris Lattner void SwitchToSection(const MCSection *NS); 148b5a32e2e8ce2f3de3a340c5a2dfcd3a159968466Anton Korobeynikov 149a1a19f803c8fef05db627a8b73c909a50306e9d6Jim Laskey /// getGlobalLinkName - Returns the asm/link name of of the specified 150a1a19f803c8fef05db627a8b73c909a50306e9d6Jim Laskey /// global variable. Should be overridden by each target asm printer to 151a1a19f803c8fef05db627a8b73c909a50306e9d6Jim Laskey /// generate the appropriate value. 1527d16e85bfc2c6423c81ce87a177bf3b1b1012a04Bill Wendling virtual const std::string &getGlobalLinkName(const GlobalVariable *GV, 1537d16e85bfc2c6423c81ce87a177bf3b1b1012a04Bill Wendling std::string &LinkName) const; 154a1a19f803c8fef05db627a8b73c909a50306e9d6Jim Laskey 155bda9b0ec7bd6974cebf751ecd23c5434b34054e9Jim Laskey /// EmitExternalGlobal - Emit the external reference to a global variable. 156bda9b0ec7bd6974cebf751ecd23c5434b34054e9Jim Laskey /// Should be overridden if an indirect reference should be used. 157bda9b0ec7bd6974cebf751ecd23c5434b34054e9Jim Laskey virtual void EmitExternalGlobal(const GlobalVariable *GV); 158bda9b0ec7bd6974cebf751ecd23c5434b34054e9Jim Laskey 159e2cf37b88c089a71727b3ecd466856f0cd638813Chris Lattner /// getCurrentFunctionEHName - Called to return the CurrentFnEHName. 1606e19896999f9297db38e1a1a66d9bef0e2f09776Bill Wendling /// 161e2cf37b88c089a71727b3ecd466856f0cd638813Chris Lattner std::string getCurrentFunctionEHName(const MachineFunction *MF) const; 1626e19896999f9297db38e1a1a66d9bef0e2f09776Bill Wendling 163a7cea6f599418a579ab5ce66413fba7efa8bf581Jim Laskey protected: 164ce2247755e56f99a2377b64a1a9d393726582b85Gordon Henriksen /// getAnalysisUsage - Record analysis usage. 165ce2247755e56f99a2377b64a1a9d393726582b85Gordon Henriksen /// 166ce2247755e56f99a2377b64a1a9d393726582b85Gordon Henriksen void getAnalysisUsage(AnalysisUsage &AU) const; 167ce2247755e56f99a2377b64a1a9d393726582b85Gordon Henriksen 168a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// doInitialization - Set up the AsmPrinter when we are working on a new 169a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// module. If your pass overrides this, it must make sure to explicitly 170a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// call this implementation. 171a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner bool doInitialization(Module &M); 172a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 173a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// doFinalization - Shut down the asmprinter. If you override this in your 174a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// pass, you must make sure to call it explicitly. 175a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner bool doFinalization(Module &M); 1763ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner 1773ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner /// PrintSpecial - Print information related to the specified machine instr 1783ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner /// that is independent of the operand, and may be independent of the instr 1793ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner /// itself. This can be useful for portably encoding the comment character 1803ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner /// or other bits of target-specific knowledge into the asmstrings. The 1813ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner /// syntax used is ${:comment}. Targets can override this to add support 1823ce9b67e0c0f171c6d09c19407930ce6989f1b9dChris Lattner /// for their own strange codes. 1833e0cc2634e861b789850b5103efcc8898bf14c4cChris Lattner virtual void PrintSpecial(const MachineInstr *MI, const char *Code) const; 18447cf4eda9faa3c0b063337d0eb4ea83aba8cb329Chris Lattner 18547cf4eda9faa3c0b063337d0eb4ea83aba8cb329Chris Lattner /// PrintAsmOperand - Print the specified operand of MI, an INLINEASM 18647cf4eda9faa3c0b063337d0eb4ea83aba8cb329Chris Lattner /// instruction, using the specified assembler variant. Targets should 187b44b5094110508e2381615b15077b388364f7e8aChris Lattner /// override this to format as appropriate. This method can return true if 18847cf4eda9faa3c0b063337d0eb4ea83aba8cb329Chris Lattner /// the operand is erroneous. 18947cf4eda9faa3c0b063337d0eb4ea83aba8cb329Chris Lattner virtual bool PrintAsmOperand(const MachineInstr *MI, unsigned OpNo, 190f483e58212d018f8b2ec760f59089e72defab5cfChris Lattner unsigned AsmVariant, const char *ExtraCode); 191b2efb853f00d45b1c8d57f92acd0028fbdeffda6Jim Laskey 192b44b5094110508e2381615b15077b388364f7e8aChris Lattner /// PrintAsmMemoryOperand - Print the specified operand of MI, an INLINEASM 193b44b5094110508e2381615b15077b388364f7e8aChris Lattner /// instruction, using the specified assembler variant as an address. 194b44b5094110508e2381615b15077b388364f7e8aChris Lattner /// Targets should override this to format as appropriate. This method can 195b44b5094110508e2381615b15077b388364f7e8aChris Lattner /// return true if the operand is erroneous. 196b44b5094110508e2381615b15077b388364f7e8aChris Lattner virtual bool PrintAsmMemoryOperand(const MachineInstr *MI, unsigned OpNo, 197b44b5094110508e2381615b15077b388364f7e8aChris Lattner unsigned AsmVariant, 198b44b5094110508e2381615b15077b388364f7e8aChris Lattner const char *ExtraCode); 199b44b5094110508e2381615b15077b388364f7e8aChris Lattner 20040bbebde9d250b875a47a688d0c6552834ada48fChris Lattner /// PrintGlobalVariable - Emit the specified global variable and its 20140bbebde9d250b875a47a688d0c6552834ada48fChris Lattner /// initializer to the output stream. 20240bbebde9d250b875a47a688d0c6552834ada48fChris Lattner virtual void PrintGlobalVariable(const GlobalVariable *GV) = 0; 203bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene 2046fe3acce749ee2b3714009064626f6c53b06dfb4Chris Lattner /// SetupMachineFunction - This should be called when a new MachineFunction 205a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// is being processed from runOnMachineFunction. 2066fe3acce749ee2b3714009064626f6c53b06dfb4Chris Lattner void SetupMachineFunction(MachineFunction &MF); 20797e32e3239c0f065698f8c004b2b3009162f5ed6Chris Lattner 208347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// getFunctionNumber - Return a unique ID for the current function. 209347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// 210347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng unsigned getFunctionNumber() const { return FunctionNumber; } 211347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng 212347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// IncrementFunctionNumber - Increase Function Number. AsmPrinters should 213347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// not normally call this, as the counter is automatically bumped by 214347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng /// SetupMachineFunction. 215347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng void IncrementFunctionNumber() { FunctionNumber++; } 216347d39f1fd8ad825a7ec5b8a3dce816723a56d42Evan Cheng 217ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// EmitConstantPool - Print to the current output stream assembly 218ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// representations of the constants in the constant pool MCP. This is 219ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// used to print out constants which have been "spilled to memory" by 220ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// the code generator. 221ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// 2222d2cec1e9e93a388bd8448f4bad661ac89a49de3Evan Cheng void EmitConstantPool(MachineConstantPool *MCP); 223a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 22437efe6764568a3829fee26aba532283131d1a104Nate Begeman /// EmitJumpTableInfo - Print assembly representations of the jump tables 22537efe6764568a3829fee26aba532283131d1a104Nate Begeman /// used by the current function to the current output stream. 22637efe6764568a3829fee26aba532283131d1a104Nate Begeman /// 2271da31ee472b9615d7329c656e2cc17c419ed7c95Chris Lattner void EmitJumpTableInfo(MachineJumpTableInfo *MJTI, MachineFunction &MF); 22837efe6764568a3829fee26aba532283131d1a104Nate Begeman 229ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// EmitSpecialLLVMGlobal - Check to see if the specified global is a 230ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// special global used by LLVM. If so, emit it and return true, otherwise 231ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner /// do nothing and return false. 232ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner bool EmitSpecialLLVMGlobal(const GlobalVariable *GV); 23387370b8301fa39ee54bdcaae0618fd565e808466Devang Patel 234f9e56198a39a08272c072211722b3c97ef88853cJim Laskey public: 235f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey //===------------------------------------------------------------------===// 236f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// LEB 128 number encoding. 237f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 238f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// PrintULEB128 - Print a series of hexidecimal values(separated by commas) 239f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// representing an unsigned leb128 value. 240f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void PrintULEB128(unsigned Value) const; 241f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 242f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// PrintSLEB128 - Print a series of hexidecimal values(separated by commas) 243f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// representing a signed leb128 value. 244f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void PrintSLEB128(int Value) const; 245f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 246f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey //===------------------------------------------------------------------===// 247f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey // Emission and print routines 248f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey // 249f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 250f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// PrintHex - Print a value as a hexidecimal value. 251f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// 252f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void PrintHex(int Value) const; 253f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 254f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EOL - Print a newline character to asm stream. If a comment is present 255f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// then it will be printed first. Comments should not contain '\n'. 256bda9b0ec7bd6974cebf751ecd23c5434b34054e9Jim Laskey void EOL() const; 257f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EOL(const std::string &Comment) const; 25825995093e785f4794b3590f3df70fbfe834a00a1Owen Anderson void EOL(const char* Comment) const; 259f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 260f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitULEB128Bytes - Emit an assembler byte data directive to compose an 261f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// unsigned leb128 value. 262f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitULEB128Bytes(unsigned Value) const; 263f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 264f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitSLEB128Bytes - print an assembler byte data directive to compose a 265f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// signed leb128 value. 266f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitSLEB128Bytes(int Value) const; 267f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 268f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitInt8 - Emit a byte directive and value. 269f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// 270f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitInt8(int Value) const; 271f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 272f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitInt16 - Emit a short directive and value. 273f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// 274f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitInt16(int Value) const; 275f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 276f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitInt32 - Emit a long directive and value. 277f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// 278f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitInt32(int Value) const; 279f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 280f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitInt64 - Emit a long long directive and value. 281f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// 282f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitInt64(uint64_t Value) const; 283f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 284f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// EmitString - Emit a string with quotes and a null terminator. 285f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey /// Special characters are emitted properly. 286181b6c9cb5def44658d15848e34c5c45d973f065Reid Spencer /// @verbatim (Eg. '\t') @endverbatim 287f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey void EmitString(const std::string &String) const; 288f34be827ac3bb257939e31575fcfc9ef27b94306Bill Wendling void EmitString(const char *String, unsigned Size) const; 289f34be827ac3bb257939e31575fcfc9ef27b94306Bill Wendling 290189f80dc253664627253b2d2cb07d0714feb12baDan Gohman /// EmitFile - Emit a .file directive. 291189f80dc253664627253b2d2cb07d0714feb12baDan Gohman void EmitFile(unsigned Number, const std::string &Name) const; 292189f80dc253664627253b2d2cb07d0714feb12baDan Gohman 293f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey //===------------------------------------------------------------------===// 294f1cdea1d021068f5c9e118d68321ce28fcea63faJim Laskey 2956fe3acce749ee2b3714009064626f6c53b06dfb4Chris Lattner /// EmitAlignment - Emit an alignment directive to the specified power of 296bfddc2030a7e67b9e0c42276525d6932375ff261Chris Lattner /// two boundary. For example, if you pass in 3 here, you will get an 8 297a1ab72daadbdc5b499ce7e7e97c4b80efad46736Chris Lattner /// byte alignment. If a global value is specified, and if that global has 2983a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// an explicit alignment requested, it will unconditionally override the 2993a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// alignment request. However, if ForcedAlignBits is specified, this value 3003a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// has final say: the ultimate alignment will be the max of ForcedAlignBits 30105548eb174dd694b651de334b73197a62e5071f1Evan Cheng /// and the alignment computed with NumBits and the global. If UseFillExpr 30205548eb174dd694b651de334b73197a62e5071f1Evan Cheng /// is true, it also emits an optional second value FillValue which the 30305548eb174dd694b651de334b73197a62e5071f1Evan Cheng /// assembler uses to fill gaps to match alignment for text sections if the 30405548eb174dd694b651de334b73197a62e5071f1Evan Cheng /// has specified a non-zero fill value. 3053a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// 3063a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// The algorithm is: 3073a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// Align = NumBits; 3083a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// if (GV && GV->hasalignment) Align = GV->getalignment(); 3093a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// Align = std::max(Align, ForcedAlignBits); 3103a4205367dc845d4cd804b47e061f8281777c9daChris Lattner /// 3113a4205367dc845d4cd804b47e061f8281777c9daChris Lattner void EmitAlignment(unsigned NumBits, const GlobalValue *GV = 0, 31205548eb174dd694b651de334b73197a62e5071f1Evan Cheng unsigned ForcedAlignBits = 0, 31305548eb174dd694b651de334b73197a62e5071f1Evan Cheng bool UseFillExpr = true) const; 314bfddc2030a7e67b9e0c42276525d6932375ff261Chris Lattner 3151b08bbca5592351a940bcd164bdec724ee954326Evan Cheng /// printLabel - This method prints a local label used by debug and 3161b08bbca5592351a940bcd164bdec724ee954326Evan Cheng /// exception handling tables. 3171b08bbca5592351a940bcd164bdec724ee954326Evan Cheng void printLabel(const MachineInstr *MI) const; 3181b08bbca5592351a940bcd164bdec724ee954326Evan Cheng void printLabel(unsigned Id) const; 3191b08bbca5592351a940bcd164bdec724ee954326Evan Cheng 320a844bdeab31ef04221e7ef59a8467893584cc14dEvan Cheng /// printDeclare - This method prints a local variable declaration used by 321a844bdeab31ef04221e7ef59a8467893584cc14dEvan Cheng /// debug tables. 322a844bdeab31ef04221e7ef59a8467893584cc14dEvan Cheng void printDeclare(const MachineInstr *MI) const; 323a844bdeab31ef04221e7ef59a8467893584cc14dEvan Cheng 324fe7b16fe6529a6890adf94ce3ccc463ea939992aDavid Greene /// EmitComments - Pretty-print comments for instructions 325fe7b16fe6529a6890adf94ce3ccc463ea939992aDavid Greene void EmitComments(const MachineInstr &MI) const; 326fe7b16fe6529a6890adf94ce3ccc463ea939992aDavid Greene /// EmitComments - Pretty-print comments for instructions 327fe7b16fe6529a6890adf94ce3ccc463ea939992aDavid Greene void EmitComments(const MCInst &MI) const; 328fe7b16fe6529a6890adf94ce3ccc463ea939992aDavid Greene 329f9e56198a39a08272c072211722b3c97ef88853cJim Laskey protected: 330bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene /// PadToColumn - This gets called every time a tab is emitted. If 331bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene /// column padding is turned on, we replace the tab with the 332bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene /// appropriate amount of padding. If not, we replace the tab with a 333bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene /// space, except for the first operand so that initial operands are 334bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene /// always lined up by tabs. 335bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene void PadToColumn(unsigned Operand) const; 336bef8768bd0576eec0470a80e3039cd5d1fd50c6bDavid Greene 3376fe3acce749ee2b3714009064626f6c53b06dfb4Chris Lattner /// EmitZeros - Emit a block of zeros. 33830bad4af40d0126f888f601fb46d01e2b39dbc43Chris Lattner /// 339c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta void EmitZeros(uint64_t NumZeros, unsigned AddrSpace = 0) const; 340c884db47f1a1d5449b749e6528292451e49025e4Jeff Cohen 341c884db47f1a1d5449b749e6528292451e49025e4Jeff Cohen /// EmitString - Emit a zero-byte-terminated string constant. 342c884db47f1a1d5449b749e6528292451e49025e4Jeff Cohen /// 343c884db47f1a1d5449b749e6528292451e49025e4Jeff Cohen virtual void EmitString(const ConstantArray *CVA) const; 34430bad4af40d0126f888f601fb46d01e2b39dbc43Chris Lattner 3456fe3acce749ee2b3714009064626f6c53b06dfb4Chris Lattner /// EmitConstantValueOnly - Print out the specified constant, without a 346a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner /// storage class. Only constants of first-class type are allowed here. 347a10f15949d6ca25eb67514cce69d42626efa6380Sanjiv Gupta void EmitConstantValueOnly(const Constant *CV); 34846d6126e669ab83383d47fb465d2a7d0c60169e5Chris Lattner 3496fe3acce749ee2b3714009064626f6c53b06dfb4Chris Lattner /// EmitGlobalConstant - Print a general LLVM constant to the .s file. 350c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta void EmitGlobalConstant(const Constant* CV, unsigned AddrSpace = 0); 351d6594ae54cfde4db4d30272192645c0a45fb9902Evan Cheng 352d6594ae54cfde4db4d30272192645c0a45fb9902Evan Cheng virtual void EmitMachineConstantPoolValue(MachineConstantPoolValue *MCPV); 353cd76240f3d0f6c5f8c80e4762a8fe3a4de22e059Argyrios Kyrtzidis 354cd76240f3d0f6c5f8c80e4762a8fe3a4de22e059Argyrios Kyrtzidis /// processDebugLoc - Processes the debug information of each machine 355cd76240f3d0f6c5f8c80e4762a8fe3a4de22e059Argyrios Kyrtzidis /// instruction's DebugLoc. 356cd76240f3d0f6c5f8c80e4762a8fe3a4de22e059Argyrios Kyrtzidis void processDebugLoc(DebugLoc DL); 357ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner 358e736ed19478f05811f08a56706e07fa4ab865401Chris Lattner /// printInlineAsm - This method formats and prints the specified machine 359e736ed19478f05811f08a56706e07fa4ab865401Chris Lattner /// instruction that is an inline asm. 360e736ed19478f05811f08a56706e07fa4ab865401Chris Lattner void printInlineAsm(const MachineInstr *MI) const; 361da47e6e0d003c873da960361549e57ee4617c301Evan Cheng 362da47e6e0d003c873da960361549e57ee4617c301Evan Cheng /// printImplicitDef - This method prints the specified machine instruction 363da47e6e0d003c873da960361549e57ee4617c301Evan Cheng /// that is an implicit def. 364da47e6e0d003c873da960361549e57ee4617c301Evan Cheng virtual void printImplicitDef(const MachineInstr *MI) const; 36537efe6764568a3829fee26aba532283131d1a104Nate Begeman 36637efe6764568a3829fee26aba532283131d1a104Nate Begeman /// printBasicBlockLabel - This method prints the label for the specified 36737efe6764568a3829fee26aba532283131d1a104Nate Begeman /// MachineBasicBlock 368cdf38c4edb892c356cfaa3c09c57728bc8d6bfd0Nate Begeman virtual void printBasicBlockLabel(const MachineBasicBlock *MBB, 369fb8075d03f5c87bd57dcc9c5f2304f6b13c55aadEvan Cheng bool printAlign = false, 370cdf38c4edb892c356cfaa3c09c57728bc8d6bfd0Nate Begeman bool printColon = false, 371cdf38c4edb892c356cfaa3c09c57728bc8d6bfd0Nate Begeman bool printComment = true) const; 37252a51e38dc312aa262b0d771419afe1785f3cb22Nate Begeman 373cc41586b9d79532172b37e1f44a9077da4b73fc9Evan Cheng /// printPICJumpTableSetLabel - This method prints a set label for the 374cc41586b9d79532172b37e1f44a9077da4b73fc9Evan Cheng /// specified MachineBasicBlock for a jumptable entry. 375cc41586b9d79532172b37e1f44a9077da4b73fc9Evan Cheng virtual void printPICJumpTableSetLabel(unsigned uid, 376cc41586b9d79532172b37e1f44a9077da4b73fc9Evan Cheng const MachineBasicBlock *MBB) const; 377cc41586b9d79532172b37e1f44a9077da4b73fc9Evan Cheng virtual void printPICJumpTableSetLabel(unsigned uid, unsigned uid2, 378cc41586b9d79532172b37e1f44a9077da4b73fc9Evan Cheng const MachineBasicBlock *MBB) const; 3799de1934099f4eedaeb2f3a023411b2cd3e0e1eaeAnton Korobeynikov virtual void printPICJumpTableEntry(const MachineJumpTableInfo *MJTI, 3809de1934099f4eedaeb2f3a023411b2cd3e0e1eaeAnton Korobeynikov const MachineBasicBlock *MBB, 3819de1934099f4eedaeb2f3a023411b2cd3e0e1eaeAnton Korobeynikov unsigned uid) const; 3829de1934099f4eedaeb2f3a023411b2cd3e0e1eaeAnton Korobeynikov 383d6594ae54cfde4db4d30272192645c0a45fb9902Evan Cheng /// printDataDirective - This method prints the asm directive for the 384d6594ae54cfde4db4d30272192645c0a45fb9902Evan Cheng /// specified type. 385c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta void printDataDirective(const Type *type, unsigned AddrSpace = 0); 386d6594ae54cfde4db4d30272192645c0a45fb9902Evan Cheng 387f5b6a47bb57fb5ffc734416d4d5d993e1a06273bAnton Korobeynikov /// printVisibility - This prints visibility information about symbol, if 388f5b6a47bb57fb5ffc734416d4d5d993e1a06273bAnton Korobeynikov /// this is suported by the target. 389f5b6a47bb57fb5ffc734416d4d5d993e1a06273bAnton Korobeynikov void printVisibility(const std::string& Name, unsigned Visibility) const; 390f5b6a47bb57fb5ffc734416d4d5d993e1a06273bAnton Korobeynikov 3917751ad92daeea5a3502fbc266ae814baec5c03e6Anton Korobeynikov /// printOffset - This is just convenient handler for printing offsets. 3927751ad92daeea5a3502fbc266ae814baec5c03e6Anton Korobeynikov void printOffset(int64_t Offset) const; 393014700c1a8cba203fd21ff129426ba8a426ab244David Greene 394ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner private: 395cb05af852f1d346ac07b84c74a930a5cdbd6d427Chris Lattner void EmitLLVMUsedList(Constant *List); 396ed13893ff729bc3b91697f6d80a3ba303782efccChris Lattner void EmitXXStructorList(Constant *List); 397c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta void EmitGlobalConstantStruct(const ConstantStruct* CVS, 398c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta unsigned AddrSpace); 399d3d965714b89c5d5aeb65fb5ce06e081f0b3c049Sanjiv Gupta void EmitGlobalConstantArray(const ConstantArray* CVA, unsigned AddrSpace); 40000d448a341175556ebd86af68219f5b90b7145a3Dan Gohman void EmitGlobalConstantVector(const ConstantVector* CP); 401c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta void EmitGlobalConstantFP(const ConstantFP* CFP, unsigned AddrSpace); 402c8d7bc850ddf5a5df503a173b0bc0f8c03ffec96Sanjiv Gupta void EmitGlobalConstantLargeInt(const ConstantInt* CI, unsigned AddrSpace); 4035eca075b74d62c621b160aa216b4cd50829a2cc7Gordon Henriksen GCMetadataPrinter *GetOrCreateGCPrinter(GCStrategy *C); 404a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner }; 405a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner} 406a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner 407a80ba71efe5be5012128e2db0dd29b024e00105aChris Lattner#endif 408