1 /* vim: set ts=4 sw=4 tw=99 et:
3 * Copyright (C) 2012 David Anderson
5 * This file is part of JITCraft.
7 * JITCraft is free software: you can redistribute it and/or modify it under
8 * the terms of the GNU General Public License as published by the Free
9 * Software Foundation, either version 3 of the License, or (at your option)
12 * Foobar is distributed in the hope that it will be useful, but WITHOUT ANY
13 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along with
17 * JITCraft. If not, see http://www.gnu.org/licenses/.
20 // NAME TEXT LENGTH USES DEFS
24 // F = 32-bit IEEE-754 float
25 // O = object reference
28 OPDEF(OP_NOP, "nop", 1, 0, 0)
30 // Pushes a signed integer immediate onto the stack.
31 OPDEF(OP_INT, "int", 5, 0, 1)
33 // Returns from the current routine, propagating the value at the top of the
34 // stack to the caller.
35 OPDEF(OP_RETURN, "return", 1, 1, 0)
38 // if (value == [true, false])
40 OPDEF(OP_JT, "jt", 5, 1, 0)
41 OPDEF(OP_JF, "jf", 5, 1, 0)
43 // Unconditional jump.
44 OPDEF(OP_JUMP, "jump", 5, 0, 0)
46 // Aliases for JUMP, that automatically leave LR regions.
47 OPDEF(OP_BREAK, "break", 5, 0, 0)
48 OPDEF(OP_CONTINUE, "continue", 5, 0, 0)
50 // Gets or sets the value of a local variable onto the stack. The local
51 // variable is given by an immediate index.
52 OPDEF(OP_GETLOCAL, "getlocal", 5, 0, 1)
53 OPDEF(OP_SETLOCAL, "setlocal", 5, 1, 1)
55 // Stack transitions for these binary operators:
59 OPDEF(OP_ADD, "add", 1, 2, 1)
60 OPDEF(OP_SUB, "sub", 1, 2, 1)
61 OPDEF(OP_MUL, "mul", 1, 2, 1)
62 OPDEF(OP_DIV, "div", 1, 2, 1)
63 OPDEF(OP_MOD, "mod", 1, 2, 1)
65 OPDEF(OP_LT, "lt", 1, 2, 1)
66 OPDEF(OP_LE, "le", 1, 2, 1)
67 OPDEF(OP_GE, "ge", 1, 2, 1)
68 OPDEF(OP_GT, "gt", 1, 2, 1)
69 OPDEF(OP_EQ, "eq", 1, 2, 1)
70 OPDEF(OP_NE, "ne", 1, 2, 1)
72 OPDEF(OP_NOT, "not", 1, 1, 1)
73 OPDEF(OP_NEG, "neg", 1, 1, 1)
75 OPDEF(OP_POP, "pop", 1, 1, 0)
77 // Unconditional terminator placed at the end of code. If a function returns
78 // void, this acts as a RETURNVOID. Otherwise, it must be unreachable.
79 OPDEF(OP_STOP, "stop", 1, 0, 0)
81 // Call a function with N arguments. The target function must be the last item
83 OPDEF(OP_CALL, "call", 1, -1, 1)
85 // Similar to GET/LOCAL, except for arguments.
86 OPDEF(OP_GETARG, "getarg", 5, 0, 1)
87 OPDEF(OP_SETARG, "setarg", 5, 1, 1)
91 // A 0-length dynamic array, or
92 // A dynamic array whose size is specified on the stack.
94 // The HeapTenure is stored as a byte following the pc. The ArrayMap to use
95 // is specified as an index into the script's object table.
98 // [u8 op] [u8 tenure] [u32 index]
99 OPDEF(OP_NEWFIXED, "newfixed", 6, 0, 1)
100 OPDEF(OP_NEWEMPTY, "newempty", 6, 0, 1)
101 OPDEF(OP_NEWSIZED, "newsized", 6, -1, 1)
103 // Creates a duplicate copy of an array. This is a deep clone, rather than
104 // COPYARRAY, which is shallow.
105 OPDEF(OP_DUPARRAY, "duparray", 1, 1, 1)
107 // Performs an array-to-array assignment.
112 OPDEF(OP_COPYARRAY, "copyarray", 1, 2, 1)
114 // Reads or writes an integer element to an unsafe array.
119 OPDEF(OP_GETELEM, "getelem", 1, 2, 1)
120 OPDEF(OP_SETELEM, "setelem", 1, 3, 1)
122 // Pushes a 32-bit IEEE-754 floating point immediate onto the stack.
123 OPDEF(OP_FLOAT, "float", 5, 0, 1)
125 // Converts an integer to a 32-bit IEEE-754 floating point immediate.
126 OPDEF(OP_CVT_I2F, "cvt.i2f", 1, 1, 1)
127 OPDEF(OP_CVT_I2B, "cvt.i2b", 1, 1, 1)
129 // Stack transitions for these binary operators:
133 OPDEF(OP_ADD_F, "add.f", 1, 2, 1)
134 OPDEF(OP_SUB_F, "sub.f", 1, 2, 1)
135 OPDEF(OP_MUL_F, "mul.f", 1, 2, 1)
136 OPDEF(OP_DIV_F, "div.f", 1, 2, 1)
138 OPDEF(OP_LT_F, "lt.f", 1, 2, 1)
139 OPDEF(OP_LE_F, "le.f", 1, 2, 1)
140 OPDEF(OP_GE_F, "ge.f", 1, 2, 1)
141 OPDEF(OP_GT_F, "gt.f", 1, 2, 1)
142 OPDEF(OP_EQ_F, "eq.f", 1, 2, 1)
143 OPDEF(OP_NE_F, "ne.f", 1, 2, 1)
145 OPDEF(OP_NOT_F, "not.f", 1, 1, 1)
146 OPDEF(OP_NEG_F, "neg.f", 1, 1, 1)
148 // Bitwise operators.
149 OPDEF(OP_SHL, "shl", 1, 2, 1)
150 OPDEF(OP_SHR, "shr", 1, 2, 1)
151 OPDEF(OP_USHR, "ushr", 1, 2, 1)
152 OPDEF(OP_BITAND, "bitand", 1, 2, 1)
153 OPDEF(OP_BITOR, "bitor", 1, 2, 1)
154 OPDEF(OP_BITXOR, "bitxor", 1, 2, 1)
155 OPDEF(OP_BITNOT, "bitnot", 1, 1, 1)
157 // Saves or restores the position of the LIFO heap to/from a local slot.
158 OPDEF(OP_SAVELIFO, "savelifo", 5, 0, 0)
159 OPDEF(OP_UNWINDLIFO, "unwindlifo", 5, 0, 0)
161 // Composes a variable reference to a stack slot or argument.
162 OPDEF(OP_VARREF_LIFO, "varref.lifo", 5, 0, 1)
163 OPDEF(OP_ARGREF_LIFO, "argref.lifo", 5, 0, 1)
164 OPDEF(OP_SLOTREF_LIFO, "slotref.lifo", 1, 1, 1)
165 OPDEF(OP_GETREF_I, "getref.i", 1, 1, 1)
166 OPDEF(OP_SETREF_I, "setref.i", 1, 2, 1)
167 OPDEF(OP_GETREF_F, "getref.f", 1, 1, 1)
168 OPDEF(OP_SETREF_F, "setref.f", 1, 2, 1)
170 // Pushes an object reference onto the stack.
171 OPDEF(OP_OBJECT, "object", 5, 0, 1)
173 // Duplicates the top item on the stack.
174 OPDEF(OP_DUP, "dup", 1, 1, 2)
176 // Duplicates the top two items on the stack.
177 OPDEF(OP_DUP2, "dup2", 1, 2, 4)
179 // Swaps the two items at the top of the stack.
180 OPDEF(OP_SWAP, "swap", 1, 2, 2)
182 // Roll operation is the same as Forth. It steals a value on the stack,
183 // shifting all stack values down, and then places the stolen value back at
184 // the top of the stack.
190 OPDEF(OP_ROLL3, "roll3", 1, 3, 3)
192 // Pick operation is the same as Forth. It pushes a copy of a slot at a
196 OPDEF(OP_PICK2, "pick2", 1, 2, 3)
197 OPDEF(OP_PICK3, "pick3", 1, 3, 4)
199 // Calls a native function. During the course of calling a native, arguments
200 // on the stack are re-pushed to match the cell-based native calling
201 // convention expected by ISourcePawnEngine.
203 // Unlike the normal CALL instruction, natives take truly variadic arguments
204 // and so we must specify the number of arguments.
206 // [u8 Opcode] [u32 ArgCount]
208 OPDEF(OP_CALLNATIVE, "callnative", 5, -1, 1)
210 // Returns from a function that does return a value.
211 OPDEF(OP_RETURNVOID, "returnvoid", 1, 0, 0)
213 // Opcodes for accessing an environment slot in the global scope. The index
214 // maps into the code object's string table, and represents the name of the
216 OPDEF(OP_SETGLOBAL, "setglobal", 5, 1, 1)
217 OPDEF(OP_GETGLOBAL, "getglobal", 5, 0, 1)
219 // Reinterpret casts from one 32-bit POD type to another. The new type pointer
220 // is encoded into the object table, for the JITs' type flow.
221 OPDEF(OP_BITCAST, "BITCAST", 5, 1, 1)
223 // Pushes a boolean value.
224 OPDEF(OP_TRUE, "true", 1, 0, 1)
225 OPDEF(OP_FALSE, "false", 1, 0, 1)
227 // Allocate a struct. The HeapTenure is stored as a byte following pc. The
228 // StructMap to use is specified as an index into the script's Map table.
231 // [u8 op] [u8 tenure] [u32 index]
232 OPDEF(OP_NEWSTRUCT, "newstruct", 6, 0, 1)
234 // Performs a struct-to-struct assignment.
239 OPDEF(OP_COPYSTRUCT, "structcopy", 1, 2, 1)
241 // Sets or gets a property in a struct. The index of the field is specified as
242 // a 32-bit integer. Note that these opcodes follow a new style of deriving
243 // their types at runtime.
244 OPDEF(OP_GETFIELD, "getfield", 5, 1, 1)
245 OPDEF(OP_SETFIELD, "setfield", 5, 2, 1)
248 // [u8 op] [i32 low] [i32 high] [u32 jump] [u32 jumps...]
249 OPDEF(OP_TABLESWITCH, "tableswitch", 9, 1, 0)
251 OPDEF(OP_SIZEOF, "sizeof", 1, 1, 1)
253 // Registers a function as a publicly exported name.
254 OPDEF(OP_PUBLIC, "public", 1, 1, 0)
256 // Enter and leave loop bodies. This is to track positions in the LIFO stack.
257 // This is only used for the outermost scope inside loop bodies. BREAK and
258 // CONTINUE implicitly perform a LEAVELOOP.
260 // If the second byte to ENTERLOOP is 0, then no LIFO region is needed.
261 OPDEF(OP_ENTERLOOP, "enterloop", 2, 0, 0)
262 OPDEF(OP_LEAVELOOP, "leaveloop", 1, 0, 0)
264 // Create a new dependent array. The type to use is encoded as an index.
268 OPDEF(OP_DEPARRAY, "deparray", 5, 2, 1)
270 // Grabs an import object from the import table.
271 OPDEF(OP_IMPORT, "import", 5, 0, 1)
