Home | History | Annotate | Download | only in TableGen
      1 //===- CodeGenTarget.h - Target Class Wrapper -------------------*- C++ -*-===//
      2 //
      3 //                     The LLVM Compiler Infrastructure
      4 //
      5 // This file is distributed under the University of Illinois Open Source
      6 // License. See LICENSE.TXT for details.
      7 //
      8 //===----------------------------------------------------------------------===//
      9 //
     10 // This file defines wrappers for the Target class and related global
     11 // functionality.  This makes it easier to access the data and provides a single
     12 // place that needs to check it for validity.  All of these classes abort
     13 // on error conditions.
     14 //
     15 //===----------------------------------------------------------------------===//
     16 
     17 #ifndef CODEGEN_TARGET_H
     18 #define CODEGEN_TARGET_H
     19 
     20 #include "CodeGenInstruction.h"
     21 #include "CodeGenRegisters.h"
     22 #include "llvm/Support/raw_ostream.h"
     23 #include "llvm/TableGen/Record.h"
     24 #include <algorithm>
     25 
     26 namespace llvm {
     27 
     28 struct CodeGenRegister;
     29 class CodeGenSchedModels;
     30 class CodeGenTarget;
     31 
     32 // SelectionDAG node properties.
     33 //  SDNPMemOperand: indicates that a node touches memory and therefore must
     34 //                  have an associated memory operand that describes the access.
     35 enum SDNP {
     36   SDNPCommutative,
     37   SDNPAssociative,
     38   SDNPHasChain,
     39   SDNPOutGlue,
     40   SDNPInGlue,
     41   SDNPOptInGlue,
     42   SDNPMayLoad,
     43   SDNPMayStore,
     44   SDNPSideEffect,
     45   SDNPMemOperand,
     46   SDNPVariadic,
     47   SDNPWantRoot,
     48   SDNPWantParent
     49 };
     50 
     51 /// getValueType - Return the MVT::SimpleValueType that the specified TableGen
     52 /// record corresponds to.
     53 MVT::SimpleValueType getValueType(Record *Rec);
     54 
     55 std::string getName(MVT::SimpleValueType T);
     56 std::string getEnumName(MVT::SimpleValueType T);
     57 
     58 /// getQualifiedName - Return the name of the specified record, with a
     59 /// namespace qualifier if the record contains one.
     60 std::string getQualifiedName(const Record *R);
     61 
     62 /// CodeGenTarget - This class corresponds to the Target class in the .td files.
     63 ///
     64 class CodeGenTarget {
     65   RecordKeeper &Records;
     66   Record *TargetRec;
     67 
     68   mutable DenseMap<const Record*, CodeGenInstruction*> Instructions;
     69   mutable CodeGenRegBank *RegBank;
     70   mutable std::vector<Record*> RegAltNameIndices;
     71   mutable SmallVector<MVT::SimpleValueType, 8> LegalValueTypes;
     72   void ReadRegAltNameIndices() const;
     73   void ReadInstructions() const;
     74   void ReadLegalValueTypes() const;
     75 
     76   mutable CodeGenSchedModels *SchedModels;
     77 
     78   mutable std::vector<const CodeGenInstruction*> InstrsByEnum;
     79 public:
     80   CodeGenTarget(RecordKeeper &Records);
     81   ~CodeGenTarget();
     82 
     83   Record *getTargetRecord() const { return TargetRec; }
     84   const std::string &getName() const;
     85 
     86   /// getInstNamespace - Return the target-specific instruction namespace.
     87   ///
     88   std::string getInstNamespace() const;
     89 
     90   /// getInstructionSet - Return the InstructionSet object.
     91   ///
     92   Record *getInstructionSet() const;
     93 
     94   /// getAsmParser - Return the AssemblyParser definition for this target.
     95   ///
     96   Record *getAsmParser() const;
     97 
     98   /// getAsmParserVariant - Return the AssmblyParserVariant definition for
     99   /// this target.
    100   ///
    101   Record *getAsmParserVariant(unsigned i) const;
    102 
    103   /// getAsmParserVariantCount - Return the AssmblyParserVariant definition
    104   /// available for this target.
    105   ///
    106   unsigned getAsmParserVariantCount() const;
    107 
    108   /// getAsmWriter - Return the AssemblyWriter definition for this target.
    109   ///
    110   Record *getAsmWriter() const;
    111 
    112   /// getRegBank - Return the register bank description.
    113   CodeGenRegBank &getRegBank() const;
    114 
    115   /// getRegisterByName - If there is a register with the specific AsmName,
    116   /// return it.
    117   const CodeGenRegister *getRegisterByName(StringRef Name) const;
    118 
    119   const std::vector<Record*> &getRegAltNameIndices() const {
    120     if (RegAltNameIndices.empty()) ReadRegAltNameIndices();
    121     return RegAltNameIndices;
    122   }
    123 
    124   const CodeGenRegisterClass &getRegisterClass(Record *R) const {
    125     return *getRegBank().getRegClass(R);
    126   }
    127 
    128   /// getRegisterVTs - Find the union of all possible SimpleValueTypes for the
    129   /// specified physical register.
    130   std::vector<MVT::SimpleValueType> getRegisterVTs(Record *R) const;
    131 
    132   ArrayRef<MVT::SimpleValueType> getLegalValueTypes() const {
    133     if (LegalValueTypes.empty()) ReadLegalValueTypes();
    134     return LegalValueTypes;
    135   }
    136 
    137   /// isLegalValueType - Return true if the specified value type is natively
    138   /// supported by the target (i.e. there are registers that directly hold it).
    139   bool isLegalValueType(MVT::SimpleValueType VT) const {
    140     ArrayRef<MVT::SimpleValueType> LegalVTs = getLegalValueTypes();
    141     for (unsigned i = 0, e = LegalVTs.size(); i != e; ++i)
    142       if (LegalVTs[i] == VT) return true;
    143     return false;
    144   }
    145 
    146   CodeGenSchedModels &getSchedModels() const;
    147 
    148 private:
    149   DenseMap<const Record*, CodeGenInstruction*> &getInstructions() const {
    150     if (Instructions.empty()) ReadInstructions();
    151     return Instructions;
    152   }
    153 public:
    154 
    155   CodeGenInstruction &getInstruction(const Record *InstRec) const {
    156     if (Instructions.empty()) ReadInstructions();
    157     DenseMap<const Record*, CodeGenInstruction*>::iterator I =
    158       Instructions.find(InstRec);
    159     assert(I != Instructions.end() && "Not an instruction");
    160     return *I->second;
    161   }
    162 
    163   /// getInstructionsByEnumValue - Return all of the instructions defined by the
    164   /// target, ordered by their enum value.
    165   const std::vector<const CodeGenInstruction*> &
    166   getInstructionsByEnumValue() const {
    167     if (InstrsByEnum.empty()) ComputeInstrsByEnum();
    168     return InstrsByEnum;
    169   }
    170 
    171   typedef std::vector<const CodeGenInstruction*>::const_iterator inst_iterator;
    172   inst_iterator inst_begin() const{return getInstructionsByEnumValue().begin();}
    173   inst_iterator inst_end() const { return getInstructionsByEnumValue().end(); }
    174   iterator_range<inst_iterator> instructions() const {
    175     return iterator_range<inst_iterator>(inst_begin(), inst_end());
    176   }
    177 
    178 
    179   /// isLittleEndianEncoding - are instruction bit patterns defined as  [0..n]?
    180   ///
    181   bool isLittleEndianEncoding() const;
    182 
    183   /// reverseBitsForLittleEndianEncoding - For little-endian instruction bit
    184   /// encodings, reverse the bit order of all instructions.
    185   void reverseBitsForLittleEndianEncoding();
    186 
    187   /// guessInstructionProperties - should we just guess unset instruction
    188   /// properties?
    189   bool guessInstructionProperties() const;
    190 
    191 private:
    192   void ComputeInstrsByEnum() const;
    193 };
    194 
    195 /// ComplexPattern - ComplexPattern info, corresponding to the ComplexPattern
    196 /// tablegen class in TargetSelectionDAG.td
    197 class ComplexPattern {
    198   MVT::SimpleValueType Ty;
    199   unsigned NumOperands;
    200   std::string SelectFunc;
    201   std::vector<Record*> RootNodes;
    202   unsigned Properties; // Node properties
    203 public:
    204   ComplexPattern() : NumOperands(0) {}
    205   ComplexPattern(Record *R);
    206 
    207   MVT::SimpleValueType getValueType() const { return Ty; }
    208   unsigned getNumOperands() const { return NumOperands; }
    209   const std::string &getSelectFunc() const { return SelectFunc; }
    210   const std::vector<Record*> &getRootNodes() const {
    211     return RootNodes;
    212   }
    213   bool hasProperty(enum SDNP Prop) const { return Properties & (1 << Prop); }
    214 };
    215 
    216 } // End llvm namespace
    217 
    218 #endif
    219