src/Opcodes.tbl
author David Anderson <dvander@alliedmods.net>
Sun Aug 12 20:48:49 2012 -0700 (2012-08-12)
changeset 172 48cffae8c9e0
parent 164 3bf7c007883d
child 182 c52ca323063f
permissions -rw-r--r--
Implement switch.
dvander@47
     1
/* vim: set ts=4 sw=4 tw=99 et:
dvander@47
     2
 *
dvander@0
     3
 * Copyright (C) 2012 David Anderson
dvander@0
     4
 *
dvander@0
     5
 * This file is part of JITCraft.
dvander@0
     6
 *
dvander@0
     7
 * JITCraft is free software: you can redistribute it and/or modify it under
dvander@0
     8
 * the terms of the GNU General Public License as published by the Free
dvander@0
     9
 * Software Foundation, either version 3 of the License, or (at your option)
dvander@0
    10
 * any later version.
dvander@0
    11
 * 
dvander@0
    12
 * Foobar is distributed in the hope that it will be useful, but WITHOUT ANY
dvander@0
    13
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
dvander@0
    14
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
dvander@0
    15
 *
dvander@0
    16
 * You should have received a copy of the GNU General Public License along with
dvander@0
    17
 * JITCraft. If not, see http://www.gnu.org/licenses/.
dvander@0
    18
 */
dvander@0
    19
// Opcode macros:
dvander@0
    20
//  NAME            NUMBER      TEXT                LENGTH  USES  DEFS   
dvander@0
    21
//
dvander@0
    22
// Type suffixes:
dvander@0
    23
//  I = 32-bit integer
dvander@19
    24
//  F = 32-bit IEEE-754 float
dvander@19
    25
//  O = object reference
dvander@0
    26
dvander@0
    27
// No operation.
dvander@0
    28
OPDEF(OP_NOP,           0,          "nop",          1,      0,  0)
dvander@0
    29
dvander@0
    30
// Pushes a signed integer immediate onto the stack.
dvander@0
    31
OPDEF(OP_INT,           1,          "int",          5,      0,  1)    
dvander@0
    32
dvander@0
    33
// Returns from the current routine, propagating the value at the top of the
dvander@0
    34
// stack to the caller.
dvander@0
    35
OPDEF(OP_RETURN,        2,          "return",       1,      1,  0)
dvander@0
    36
dvander@0
    37
// Stack transitions for these comparison ops:
dvander@0
    38
// rhs = pop()
dvander@0
    39
// lhs = pop()
dvander@0
    40
// if (lhs COMPARE rhs)
dvander@0
    41
//    goto target (immediate, relative to the beginning of the jump instruction)
dvander@0
    42
OPDEF(OP_JL,            3,          "jl",           5,      2,  0)
dvander@0
    43
OPDEF(OP_JLE,           4,          "jle",          5,      2,  0)
dvander@0
    44
OPDEF(OP_JG,            5,          "jg",           5,      2,  0)
dvander@0
    45
OPDEF(OP_JGE,           6,          "jge",          5,      2,  0)
dvander@0
    46
OPDEF(OP_JEQ,           7,          "jeq",          5,      2,  0)
dvander@0
    47
OPDEF(OP_JNE,           8,          "jne",          5,      2,  0)
dvander@0
    48
dvander@0
    49
// value = pop()
dvander@0
    50
// if (value == [true, false])
dvander@0
    51
//    goto target
dvander@0
    52
OPDEF(OP_JT,            9,          "jt",           5,      1,  0)
dvander@0
    53
OPDEF(OP_JF,            10,         "jf",           5,      1,  0)
dvander@0
    54
dvander@74
    55
OPDEF(OP_JL_F,          11,         "jl.f",         5,      2,  0)
dvander@74
    56
OPDEF(OP_JLE_F,         12,         "jle.f",        5,      2,  0)
dvander@74
    57
OPDEF(OP_JG_F,          13,         "jg.f",         5,      2,  0)
dvander@74
    58
OPDEF(OP_JGE_F,         14,         "jge.f",        5,      2,  0)
dvander@74
    59
OPDEF(OP_JEQ_F,         15,         "jeq.f",        5,      2,  0)
dvander@74
    60
OPDEF(OP_JNE_F,         16,         "jne.f",        5,      2,  0)
dvander@74
    61
OPDEF(OP_JT_F,          17,         "jt.f",         5,      1,  0)
dvander@74
    62
OPDEF(OP_JF_F,          18,         "jf.f",         5,      1,  0)
dvander@74
    63
dvander@0
    64
// Unconditional jump.
dvander@74
    65
OPDEF(OP_JUMP,          19,         "jump",         5,      0,  0)
dvander@0
    66
dvander@0
    67
// Gets or sets the value of a local variable onto the stack. The local
dvander@0
    68
// variable is given by an immediate index.
dvander@74
    69
OPDEF(OP_GETLOCAL,      20,         "getlocal",     5,      0,  1)
dvander@74
    70
OPDEF(OP_SETLOCAL,      21,         "setlocal",     5,      1,  1)
dvander@0
    71
dvander@0
    72
// Stack transitions for these binary operators:
dvander@0
    73
// rhs = pop()
dvander@0
    74
// lhs = pop()
dvander@0
    75
// push(lhs OP rhs)
dvander@74
    76
OPDEF(OP_ADD,           22,         "add",          1,      2,  1)
dvander@74
    77
OPDEF(OP_SUB,           23,         "sub",          1,      2,  1)
dvander@74
    78
OPDEF(OP_MUL,           24,         "mul",          1,      2,  1)
dvander@74
    79
OPDEF(OP_DIV,           25,         "div",          1,      2,  1)
dvander@82
    80
OPDEF(OP_MOD,           26,         "mod",          1,      2,  1)
dvander@0
    81
dvander@82
    82
OPDEF(OP_LT,            27,         "lt",           1,      2,  1)
dvander@82
    83
OPDEF(OP_LE,            28,         "le",           1,      2,  1)
dvander@82
    84
OPDEF(OP_GE,            29,         "ge",           1,      2,  1)
dvander@82
    85
OPDEF(OP_GT,            30,         "gt",           1,      2,  1)
dvander@82
    86
OPDEF(OP_EQ,            31,         "eq",           1,      2,  1)
dvander@82
    87
OPDEF(OP_NE,            32,         "ne",           1,      2,  1)
dvander@74
    88
dvander@82
    89
OPDEF(OP_NOT,           33,         "not",          1,      1,  1)
dvander@82
    90
OPDEF(OP_NEG,           34,         "neg",          1,      1,  1)
dvander@79
    91
dvander@82
    92
OPDEF(OP_POP,           35,         "pop",          1,      1,  0)
dvander@0
    93
dvander@72
    94
// Unconditional terminator placed at the end of code. If a function returns
dvander@72
    95
// void, this acts as a RETURNVOID. Otherwise, it must be unreachable.
dvander@82
    96
OPDEF(OP_STOP,          36,         "stop",         1,      0,  0)
dvander@0
    97
dvander@73
    98
// Call a function with N arguments. The target function must be the last item
dvander@73
    99
// on the stack.
dvander@82
   100
OPDEF(OP_CALL,          37,         "call",         1,      -1, 1)
dvander@0
   101
dvander@0
   102
// Similar to GET/LOCAL, except for arguments.
dvander@82
   103
OPDEF(OP_GETARG,        38,         "getarg",       5,      0,  1)
dvander@82
   104
OPDEF(OP_SETARG,        39,         "setarg",       5,      1,  1)
dvander@0
   105
dvander@157
   106
// Allocate an array. The HeapTenure is stored as a byte following pc. The
dvander@157
   107
// ArrayMap to use is specified as an index into the script's Map table.
dvander@157
   108
//
dvander@157
   109
// Format:
dvander@157
   110
//  [u8 op] [u32 index]
dvander@157
   111
OPDEF(OP_NEWARRAY,      40,         "newarray",     6,      0,  1)
dvander@157
   112
dvander@157
   113
// Performs an array-to-array assignment.
dvander@157
   114
//   Left = pop()
dvander@157
   115
//   Right = pop()
dvander@157
   116
//   copy(Left, Right)
dvander@157
   117
//   push(Left)
dvander@157
   118
OPDEF(OP_COPYARRAY,     41,         "arraycopy",    1,      2,  1)
dvander@157
   119
dvander@0
   120
// Reads or writes an integer element to an unsafe array.
dvander@0
   121
//  index = pop()
dvander@0
   122
//  ref = pop()
dvander@0
   123
//  ref[index]
dvander@0
   124
//
dvander@157
   125
OPDEF(OP_GETELEM,       42,         "getelem",      1,      2,  1)
dvander@157
   126
OPDEF(OP_SETELEM,       43,         "setelem",      1,      3,  1)
dvander@0
   127
dvander@4
   128
// Pushes a 32-bit IEEE-754 floating point immediate onto the stack.
dvander@158
   129
OPDEF(OP_FLOAT,         44,         "float",        5,      0,  1)
dvander@4
   130
dvander@4
   131
// Converts an integer to a 32-bit IEEE-754 floating point immediate.
dvander@158
   132
OPDEF(OP_CVT_I2F,       45,         "cvt.i2f",      1,      1,  1)
dvander@4
   133
dvander@4
   134
// Stack transitions for these binary operators:
dvander@4
   135
// rhs = pop()
dvander@4
   136
// lhs = pop()
dvander@4
   137
// push(lhs OP rhs)
dvander@158
   138
OPDEF(OP_ADD_F,         46,         "add.f",        1,      2,  1)
dvander@158
   139
OPDEF(OP_SUB_F,         47,         "sub.f",        1,      2,  1)
dvander@158
   140
OPDEF(OP_MUL_F,         48,         "mul.f",        1,      2,  1)
dvander@158
   141
OPDEF(OP_DIV_F,         49,         "div.f",        1,      2,  1)
dvander@74
   142
dvander@158
   143
OPDEF(OP_LT_F,          50,         "lt.f",         1,      2,  1)
dvander@158
   144
OPDEF(OP_LE_F,          51,         "le.f",         1,      2,  1)
dvander@158
   145
OPDEF(OP_GE_F,          52,         "ge.f",         1,      2,  1)
dvander@158
   146
OPDEF(OP_GT_F,          53,         "gt.f",         1,      2,  1)
dvander@158
   147
OPDEF(OP_EQ_F,          54,         "eq.f",         1,      2,  1)
dvander@158
   148
OPDEF(OP_NE_F,          55,         "ne.f",         1,      2,  1)
dvander@79
   149
dvander@158
   150
OPDEF(OP_NOT_F,         56,         "not.f",        1,      1,  1)
dvander@158
   151
OPDEF(OP_NEG_F,         57,         "neg.f",        1,      1,  1)
dvander@4
   152
dvander@8
   153
// Bitwise operators.
dvander@158
   154
OPDEF(OP_SHL,           58,         "shl",          1,      2,  1)
dvander@158
   155
OPDEF(OP_SHR,           59,         "shr",          1,      2,  1)
dvander@158
   156
OPDEF(OP_USHR,          60,         "ushr",         1,      2,  1)
dvander@158
   157
OPDEF(OP_BITAND,        61,         "bitand",       1,      2,  1)
dvander@158
   158
OPDEF(OP_BITOR,         62,         "bitor",        1,      2,  1)
dvander@158
   159
OPDEF(OP_BITXOR,        63,         "bitxor",       1,      2,  1)
dvander@158
   160
OPDEF(OP_BITNOT,        64,         "bitnot",       1,      1,  1)
dvander@12
   161
dvander@12
   162
// Saves or restores the position of the LIFO heap to/from a local slot.
dvander@158
   163
OPDEF(OP_SAVELIFO,      65,         "savelifo",     5,      0,  0)
dvander@158
   164
OPDEF(OP_UNWINDLIFO,    66,         "unwindlifo",   5,      0,  0)
dvander@14
   165
dvander@14
   166
// Composes a variable reference to a stack slot or argument.
dvander@158
   167
OPDEF(OP_VARREF_LIFO,   67,         "varref.lifo",  5,      0,  1)
dvander@158
   168
OPDEF(OP_ARGREF_LIFO,   68,         "argref.lifo",  5,      0,  1)
dvander@158
   169
OPDEF(OP_SLOTREF_LIFO,  69,         "slotref.lifo", 1,      1,  1)
dvander@158
   170
OPDEF(OP_ARRAYREF_LIFO, 70,         "arrayref.lifo",1,      2,  1)
dvander@158
   171
OPDEF(OP_GETREF_I,      71,         "getref.i",     1,      1,  1)
dvander@158
   172
OPDEF(OP_SETREF_I,      72,         "setref.i",     1,      2,  1)
dvander@158
   173
OPDEF(OP_GETREF_F,      73,         "getref.f",     1,      1,  1)
dvander@158
   174
OPDEF(OP_SETREF_F,      74,         "setref.f",     1,      2,  1)
dvander@21
   175
dvander@21
   176
// Pushes an object reference onto the stack.
dvander@158
   177
OPDEF(OP_OBJECT,        75,         "object",       5,      0,  1)
dvander@22
   178
dvander@22
   179
// Duplicates the top item on the stack.
dvander@158
   180
OPDEF(OP_DUP,           76,         "dup",          1,      1,  2)
dvander@22
   181
dvander@22
   182
// Duplicates the top two items on the stack.
dvander@158
   183
OPDEF(OP_DUP2,          77,         "dup2",         1,      2,  4)
dvander@23
   184
dvander@23
   185
// Swaps the two items at the top of the stack.
dvander@158
   186
OPDEF(OP_SWAP,          78,         "swap",         1,      2,  2)
dvander@23
   187
dvander@23
   188
// Roll operation is the same as Forth. It steals a value on the stack,
dvander@23
   189
// shifting all stack values down, and then places the stolen value back at
dvander@23
   190
// the top of the stack.
dvander@23
   191
//
dvander@23
   192
//  p = sp[-3]
dvander@23
   193
//  sp[-3] = sp[-2]
dvander@23
   194
//  sp[-2] = sp[-1]
dvander@23
   195
//  sp[-1] = p
dvander@158
   196
OPDEF(OP_ROLL3,         79,         "roll3",        1,      3, 3)
dvander@23
   197
dvander@23
   198
// Pick operation is the same as Forth. It pushes a copy of a slot at a
dvander@23
   199
// specific depth.
dvander@23
   200
//
dvander@23
   201
// push(sp[-n])
dvander@158
   202
OPDEF(OP_PICK2,         80,         "pick2",        1,      2, 3)
dvander@158
   203
OPDEF(OP_PICK3,         81,         "pick3",        1,      3, 4)
dvander@68
   204
dvander@68
   205
// Calls a native function. During the course of calling a native, arguments
dvander@68
   206
// on the stack are re-pushed to match the cell-based native calling
dvander@68
   207
// convention expected by ISourcePawnEngine.
dvander@68
   208
//
dvander@68
   209
// Unlike the normal CALL instruction, natives take truly variadic arguments
dvander@68
   210
// and so we must specify the number of arguments. The format is:
dvander@68
   211
//
dvander@68
   212
// [u8 Opcode] [u32 Index] [u32 ArgCount]
dvander@68
   213
//
dvander@158
   214
OPDEF(OP_CALLNATIVE,    82,         "callnative",   9,      -1, 1)
dvander@72
   215
dvander@72
   216
// Returns from a function that does return a value.
dvander@158
   217
OPDEF(OP_RETURNVOID,    83,         "returnvoid",   1,      0, 0)
dvander@73
   218
dvander@73
   219
// Loads the module of the running function.
dvander@158
   220
OPDEF(OP_MODULE,        84,         "module",       1,      0, 1)
dvander@73
   221
dvander@73
   222
// Loads a function from a module object. The operand is the slot number
dvander@73
   223
// in the module.
dvander@158
   224
OPDEF(OP_GETMODULE_FN,  85,         "getmodule.fn", 5,      1, 1)
dvander@85
   225
dvander@85
   226
// Opcodes for accessing an environment slot in the global scope.
dvander@158
   227
OPDEF(OP_SETGLOBAL_I,   86,         "setglobal.i",  5,      1, 1)
dvander@158
   228
OPDEF(OP_SETGLOBAL_F,   87,         "setglobal.f",  5,      1, 1)
dvander@158
   229
OPDEF(OP_SETGLOBAL_O,   88,         "setglobal.o",  5,      1, 1)
dvander@158
   230
OPDEF(OP_GETGLOBAL_I,   89,         "getglobal.i",  5,      0, 1)
dvander@158
   231
OPDEF(OP_GETGLOBAL_F,   90,         "getglobal.f",  5,      0, 1)
dvander@158
   232
OPDEF(OP_GETGLOBAL_O,   91,         "getglobal.o",  5,      0, 1)
dvander@142
   233
dvander@142
   234
// Reinterprets a 32-bit integer as a float, or vice-versa.
dvander@158
   235
OPDEF(OP_BITS_I2F,      92,         "bits.i2f",     1,      1, 1)
dvander@158
   236
OPDEF(OP_BITS_F2I,      93,         "bits.f2i",     1,      1, 1)
dvander@142
   237
dvander@143
   238
// Pushes a boolean value.
dvander@158
   239
OPDEF(OP_TRUE,          94,         "true",         1,      0, 1)
dvander@158
   240
OPDEF(OP_FALSE,         95,         "false",        1,      0, 1)
dvander@143
   241
dvander@147
   242
// Allocate a struct. The HeapTenure is stored as a byte following pc. The
dvander@147
   243
// StructMap to use is specified as an index into the script's Map table.
dvander@147
   244
//
dvander@147
   245
// Format:
dvander@147
   246
//  [u8 op] [u32 index]
dvander@158
   247
OPDEF(OP_NEWSTRUCT,     96,         "newstruct",    6,      0, 1)
dvander@147
   248
dvander@152
   249
// Performs a struct-to-struct assignment.
dvander@152
   250
//   Left = pop()
dvander@152
   251
//   Right = pop()
dvander@152
   252
//   copy(Left, Right)
dvander@152
   253
//   push(Left)
dvander@158
   254
OPDEF(OP_COPYSTRUCT,    97,         "structcopy",   1,      2, 1)
dvander@152
   255
dvander@157
   256
// Sets or gets a property in a struct. The index of the field is specified as
dvander@157
   257
// a 32-bit integer. Note that these opcodes follow a new style of deriving
dvander@157
   258
// their types at runtime.
dvander@158
   259
OPDEF(OP_GETFIELD,      98,         "getfield",     5,      1, 1)
dvander@158
   260
OPDEF(OP_SETFIELD,      99,         "setfield",     5,      2, 1)
dvander@157
   261
dvander@164
   262
OPDEF(OP_FIELDREF_LIFO, 100,        "fieldref.lifo", 5,     1, 1)
dvander@164
   263
dvander@172
   264
// Table-based jump.
dvander@172
   265
// [u8 op] [i32 low] [i32 high] [u32 jump] [u32 jumps...]
dvander@172
   266
OPDEF(OP_TABLESWITCH,   101,        "tableswitch",  9,      1, 0)
dvander@172
   267