Andrew Scull | 5e1ddfa | 2018-08-14 10:06:54 +0100 | [diff] [blame] | 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 |