1 //===-- llvm/Instruction.def - File that describes Instructions -*- 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 contains descriptions of the various LLVM instructions. This is 11 // used as a central place for enumerating the different instructions and 12 // should eventually be the place to put comments about the instructions. 13 // 14 //===----------------------------------------------------------------------===// 15 16 // NOTE: NO INCLUDE GUARD DESIRED! 17 18 // Provide definitions of macros so that users of this file do not have to 19 // define everything to use it... 20 // 21 #ifndef FIRST_TERM_INST 22 #define FIRST_TERM_INST(num) 23 #endif 24 #ifndef HANDLE_TERM_INST 25 #ifndef HANDLE_INST 26 #define HANDLE_TERM_INST(num, opcode, Class) 27 #else 28 #define HANDLE_TERM_INST(num, opcode, Class) HANDLE_INST(num, opcode, Class) 29 #endif 30 #endif 31 #ifndef LAST_TERM_INST 32 #define LAST_TERM_INST(num) 33 #endif 34 35 #ifndef FIRST_BINARY_INST 36 #define FIRST_BINARY_INST(num) 37 #endif 38 #ifndef HANDLE_BINARY_INST 39 #ifndef HANDLE_INST 40 #define HANDLE_BINARY_INST(num, opcode, instclass) 41 #else 42 #define HANDLE_BINARY_INST(num, opcode, Class) HANDLE_INST(num, opcode, Class) 43 #endif 44 #endif 45 #ifndef LAST_BINARY_INST 46 #define LAST_BINARY_INST(num) 47 #endif 48 49 #ifndef FIRST_MEMORY_INST 50 #define FIRST_MEMORY_INST(num) 51 #endif 52 #ifndef HANDLE_MEMORY_INST 53 #ifndef HANDLE_INST 54 #define HANDLE_MEMORY_INST(num, opcode, Class) 55 #else 56 #define HANDLE_MEMORY_INST(num, opcode, Class) HANDLE_INST(num, opcode, Class) 57 #endif 58 #endif 59 #ifndef LAST_MEMORY_INST 60 #define LAST_MEMORY_INST(num) 61 #endif 62 63 #ifndef FIRST_CAST_INST 64 #define FIRST_CAST_INST(num) 65 #endif 66 #ifndef HANDLE_CAST_INST 67 #ifndef HANDLE_INST 68 #define HANDLE_CAST_INST(num, opcode, Class) 69 #else 70 #define HANDLE_CAST_INST(num, opcode, Class) HANDLE_INST(num, opcode, Class) 71 #endif 72 #endif 73 #ifndef LAST_CAST_INST 74 #define LAST_CAST_INST(num) 75 #endif 76 77 #ifndef FIRST_FUNCLETPAD_INST 78 #define FIRST_FUNCLETPAD_INST(num) 79 #endif 80 #ifndef HANDLE_FUNCLETPAD_INST 81 #ifndef HANDLE_INST 82 #define HANDLE_FUNCLETPAD_INST(num, opcode, Class) 83 #else 84 #define HANDLE_FUNCLETPAD_INST(num, opcode, Class) HANDLE_INST(num, opcode, Class) 85 #endif 86 #endif 87 #ifndef LAST_FUNCLETPAD_INST 88 #define LAST_FUNCLETPAD_INST(num) 89 #endif 90 91 #ifndef FIRST_OTHER_INST 92 #define FIRST_OTHER_INST(num) 93 #endif 94 #ifndef HANDLE_OTHER_INST 95 #ifndef HANDLE_INST 96 #define HANDLE_OTHER_INST(num, opcode, Class) 97 #else 98 #define HANDLE_OTHER_INST(num, opcode, Class) HANDLE_INST(num, opcode, Class) 99 #endif 100 #endif 101 #ifndef LAST_OTHER_INST 102 #define LAST_OTHER_INST(num) 103 #endif 104 105 #ifndef HANDLE_USER_INST 106 #define HANDLE_USER_INST(num, opc, Class) HANDLE_OTHER_INST(num, opc, Class) 107 #endif 108 109 // Terminator Instructions - These instructions are used to terminate a basic 110 // block of the program. Every basic block must end with one of these 111 // instructions for it to be a well formed basic block. 112 // 113 FIRST_TERM_INST ( 1) 114 HANDLE_TERM_INST ( 1, Ret , ReturnInst) 115 HANDLE_TERM_INST ( 2, Br , BranchInst) 116 HANDLE_TERM_INST ( 3, Switch , SwitchInst) 117 HANDLE_TERM_INST ( 4, IndirectBr , IndirectBrInst) 118 HANDLE_TERM_INST ( 5, Invoke , InvokeInst) 119 HANDLE_TERM_INST ( 6, Resume , ResumeInst) 120 HANDLE_TERM_INST ( 7, Unreachable , UnreachableInst) 121 HANDLE_TERM_INST ( 8, CleanupRet , CleanupReturnInst) 122 HANDLE_TERM_INST ( 9, CatchRet , CatchReturnInst) 123 HANDLE_TERM_INST (10, CatchSwitch , CatchSwitchInst) 124 LAST_TERM_INST (10) 125 126 // Standard binary operators... 127 FIRST_BINARY_INST(11) 128 HANDLE_BINARY_INST(11, Add , BinaryOperator) 129 HANDLE_BINARY_INST(12, FAdd , BinaryOperator) 130 HANDLE_BINARY_INST(13, Sub , BinaryOperator) 131 HANDLE_BINARY_INST(14, FSub , BinaryOperator) 132 HANDLE_BINARY_INST(15, Mul , BinaryOperator) 133 HANDLE_BINARY_INST(16, FMul , BinaryOperator) 134 HANDLE_BINARY_INST(17, UDiv , BinaryOperator) 135 HANDLE_BINARY_INST(18, SDiv , BinaryOperator) 136 HANDLE_BINARY_INST(19, FDiv , BinaryOperator) 137 HANDLE_BINARY_INST(20, URem , BinaryOperator) 138 HANDLE_BINARY_INST(21, SRem , BinaryOperator) 139 HANDLE_BINARY_INST(22, FRem , BinaryOperator) 140 141 // Logical operators (integer operands) 142 HANDLE_BINARY_INST(23, Shl , BinaryOperator) // Shift left (logical) 143 HANDLE_BINARY_INST(24, LShr , BinaryOperator) // Shift right (logical) 144 HANDLE_BINARY_INST(25, AShr , BinaryOperator) // Shift right (arithmetic) 145 HANDLE_BINARY_INST(26, And , BinaryOperator) 146 HANDLE_BINARY_INST(27, Or , BinaryOperator) 147 HANDLE_BINARY_INST(28, Xor , BinaryOperator) 148 LAST_BINARY_INST(28) 149 150 // Memory operators... 151 FIRST_MEMORY_INST(29) 152 HANDLE_MEMORY_INST(29, Alloca, AllocaInst) // Stack management 153 HANDLE_MEMORY_INST(30, Load , LoadInst ) // Memory manipulation instrs 154 HANDLE_MEMORY_INST(31, Store , StoreInst ) 155 HANDLE_MEMORY_INST(32, GetElementPtr, GetElementPtrInst) 156 HANDLE_MEMORY_INST(33, Fence , FenceInst ) 157 HANDLE_MEMORY_INST(34, AtomicCmpXchg , AtomicCmpXchgInst ) 158 HANDLE_MEMORY_INST(35, AtomicRMW , AtomicRMWInst ) 159 LAST_MEMORY_INST(35) 160 161 // Cast operators ... 162 // NOTE: The order matters here because CastInst::isEliminableCastPair 163 // NOTE: (see Instructions.cpp) encodes a table based on this ordering. 164 FIRST_CAST_INST(36) 165 HANDLE_CAST_INST(36, Trunc , TruncInst ) // Truncate integers 166 HANDLE_CAST_INST(37, ZExt , ZExtInst ) // Zero extend integers 167 HANDLE_CAST_INST(38, SExt , SExtInst ) // Sign extend integers 168 HANDLE_CAST_INST(39, FPToUI , FPToUIInst ) // floating point -> UInt 169 HANDLE_CAST_INST(40, FPToSI , FPToSIInst ) // floating point -> SInt 170 HANDLE_CAST_INST(41, UIToFP , UIToFPInst ) // UInt -> floating point 171 HANDLE_CAST_INST(42, SIToFP , SIToFPInst ) // SInt -> floating point 172 HANDLE_CAST_INST(43, FPTrunc , FPTruncInst ) // Truncate floating point 173 HANDLE_CAST_INST(44, FPExt , FPExtInst ) // Extend floating point 174 HANDLE_CAST_INST(45, PtrToInt, PtrToIntInst) // Pointer -> Integer 175 HANDLE_CAST_INST(46, IntToPtr, IntToPtrInst) // Integer -> Pointer 176 HANDLE_CAST_INST(47, BitCast , BitCastInst ) // Type cast 177 HANDLE_CAST_INST(48, AddrSpaceCast, AddrSpaceCastInst) // addrspace cast 178 LAST_CAST_INST(48) 179 180 FIRST_FUNCLETPAD_INST(49) 181 HANDLE_FUNCLETPAD_INST(49, CleanupPad, CleanupPadInst) 182 HANDLE_FUNCLETPAD_INST(50, CatchPad , CatchPadInst) 183 LAST_FUNCLETPAD_INST(50) 184 185 // Other operators... 186 FIRST_OTHER_INST(51) 187 HANDLE_OTHER_INST(51, ICmp , ICmpInst ) // Integer comparison instruction 188 HANDLE_OTHER_INST(52, FCmp , FCmpInst ) // Floating point comparison instr. 189 HANDLE_OTHER_INST(53, PHI , PHINode ) // PHI node instruction 190 HANDLE_OTHER_INST(54, Call , CallInst ) // Call a function 191 HANDLE_OTHER_INST(55, Select , SelectInst ) // select instruction 192 HANDLE_USER_INST (56, UserOp1, Instruction) // May be used internally in a pass 193 HANDLE_USER_INST (57, UserOp2, Instruction) // Internal to passes only 194 HANDLE_OTHER_INST(58, VAArg , VAArgInst ) // vaarg instruction 195 HANDLE_OTHER_INST(59, ExtractElement, ExtractElementInst)// extract from vector 196 HANDLE_OTHER_INST(60, InsertElement, InsertElementInst) // insert into vector 197 HANDLE_OTHER_INST(61, ShuffleVector, ShuffleVectorInst) // shuffle two vectors. 198 HANDLE_OTHER_INST(62, ExtractValue, ExtractValueInst)// extract from aggregate 199 HANDLE_OTHER_INST(63, InsertValue, InsertValueInst) // insert into aggregate 200 HANDLE_OTHER_INST(64, LandingPad, LandingPadInst) // Landing pad instruction. 201 LAST_OTHER_INST(64) 202 203 #undef FIRST_TERM_INST 204 #undef HANDLE_TERM_INST 205 #undef LAST_TERM_INST 206 207 #undef FIRST_BINARY_INST 208 #undef HANDLE_BINARY_INST 209 #undef LAST_BINARY_INST 210 211 #undef FIRST_MEMORY_INST 212 #undef HANDLE_MEMORY_INST 213 #undef LAST_MEMORY_INST 214 215 #undef FIRST_CAST_INST 216 #undef HANDLE_CAST_INST 217 #undef LAST_CAST_INST 218 219 #undef FIRST_FUNCLETPAD_INST 220 #undef HANDLE_FUNCLETPAD_INST 221 #undef LAST_FUNCLETPAD_INST 222 223 #undef FIRST_OTHER_INST 224 #undef HANDLE_OTHER_INST 225 #undef LAST_OTHER_INST 226 227 #undef HANDLE_USER_INST 228 229 #ifdef HANDLE_INST 230 #undef HANDLE_INST 231 #endif 232