annotate src/share/vm/interpreter/abstractInterpreter.hpp @ 0:a61af66fc99e

Initial load
author duke
date Sat, 01 Dec 2007 00:00:00 +0000
parents
children 98cb887364d3
rev   line source
duke@0 1 /*
duke@0 2 * Copyright 1997-2007 Sun Microsystems, Inc. All Rights Reserved.
duke@0 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@0 4 *
duke@0 5 * This code is free software; you can redistribute it and/or modify it
duke@0 6 * under the terms of the GNU General Public License version 2 only, as
duke@0 7 * published by the Free Software Foundation.
duke@0 8 *
duke@0 9 * This code is distributed in the hope that it will be useful, but WITHOUT
duke@0 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@0 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
duke@0 12 * version 2 for more details (a copy is included in the LICENSE file that
duke@0 13 * accompanied this code).
duke@0 14 *
duke@0 15 * You should have received a copy of the GNU General Public License version
duke@0 16 * 2 along with this work; if not, write to the Free Software Foundation,
duke@0 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@0 18 *
duke@0 19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
duke@0 20 * CA 95054 USA or visit www.sun.com if you need additional information or
duke@0 21 * have any questions.
duke@0 22 *
duke@0 23 */
duke@0 24
duke@0 25 // This file contains the platform-independant parts
duke@0 26 // of the abstract interpreter and the abstract interpreter generator.
duke@0 27
duke@0 28 // Organization of the interpreter(s). There exists two different interpreters in hotpot
duke@0 29 // an assembly language version (aka template interpreter) and a high level language version
duke@0 30 // (aka c++ interpreter). Th division of labor is as follows:
duke@0 31
duke@0 32 // Template Interpreter C++ Interpreter Functionality
duke@0 33 //
duke@0 34 // templateTable* bytecodeInterpreter* actual interpretation of bytecodes
duke@0 35 //
duke@0 36 // templateInterpreter* cppInterpreter* generation of assembly code that creates
duke@0 37 // and manages interpreter runtime frames.
duke@0 38 // Also code for populating interpreter
duke@0 39 // frames created during deoptimization.
duke@0 40 //
duke@0 41 // For both template and c++ interpreter. There are common files for aspects of the interpreter
duke@0 42 // that are generic to both interpreters. This is the layout:
duke@0 43 //
duke@0 44 // abstractInterpreter.hpp: generic description of the interpreter.
duke@0 45 // interpreter*: generic frame creation and handling.
duke@0 46 //
duke@0 47
duke@0 48 //------------------------------------------------------------------------------------------------------------------------
duke@0 49 // The C++ interface to the bytecode interpreter(s).
duke@0 50
duke@0 51 class AbstractInterpreter: AllStatic {
duke@0 52 friend class VMStructs;
duke@0 53 friend class Interpreter;
duke@0 54 friend class CppInterpreterGenerator;
duke@0 55 public:
duke@0 56 enum MethodKind {
duke@0 57 zerolocals, // method needs locals initialization
duke@0 58 zerolocals_synchronized, // method needs locals initialization & is synchronized
duke@0 59 native, // native method
duke@0 60 native_synchronized, // native method & is synchronized
duke@0 61 empty, // empty method (code: _return)
duke@0 62 accessor, // accessor method (code: _aload_0, _getfield, _(a|i)return)
duke@0 63 abstract, // abstract method (throws an AbstractMethodException)
duke@0 64 java_lang_math_sin, // implementation of java.lang.Math.sin (x)
duke@0 65 java_lang_math_cos, // implementation of java.lang.Math.cos (x)
duke@0 66 java_lang_math_tan, // implementation of java.lang.Math.tan (x)
duke@0 67 java_lang_math_abs, // implementation of java.lang.Math.abs (x)
duke@0 68 java_lang_math_sqrt, // implementation of java.lang.Math.sqrt (x)
duke@0 69 java_lang_math_log, // implementation of java.lang.Math.log (x)
duke@0 70 java_lang_math_log10, // implementation of java.lang.Math.log10 (x)
duke@0 71 number_of_method_entries,
duke@0 72 invalid = -1
duke@0 73 };
duke@0 74
duke@0 75 enum SomeConstants {
duke@0 76 number_of_result_handlers = 10 // number of result handlers for native calls
duke@0 77 };
duke@0 78
duke@0 79 protected:
duke@0 80 static StubQueue* _code; // the interpreter code (codelets)
duke@0 81
duke@0 82 static bool _notice_safepoints; // true if safepoints are activated
duke@0 83
duke@0 84 static address _native_entry_begin; // Region for native entry code
duke@0 85 static address _native_entry_end;
duke@0 86
duke@0 87 // method entry points
duke@0 88 static address _entry_table[number_of_method_entries]; // entry points for a given method
duke@0 89 static address _native_abi_to_tosca[number_of_result_handlers]; // for native method result handlers
duke@0 90 static address _slow_signature_handler; // the native method generic (slow) signature handler
duke@0 91
duke@0 92 static address _rethrow_exception_entry; // rethrows an activation in previous frame
duke@0 93
duke@0 94
duke@0 95
duke@0 96 friend class AbstractInterpreterGenerator;
duke@0 97 friend class InterpreterGenerator;
duke@0 98 friend class InterpreterMacroAssembler;
duke@0 99
duke@0 100 public:
duke@0 101 // Initialization/debugging
duke@0 102 static void initialize();
duke@0 103 static StubQueue* code() { return _code; }
duke@0 104
duke@0 105
duke@0 106 // Method activation
duke@0 107 static MethodKind method_kind(methodHandle m);
duke@0 108 static address entry_for_kind(MethodKind k) { assert(0 <= k && k < number_of_method_entries, "illegal kind"); return _entry_table[k]; }
duke@0 109 static address entry_for_method(methodHandle m) { return _entry_table[method_kind(m)]; }
duke@0 110
duke@0 111 static void print_method_kind(MethodKind kind) PRODUCT_RETURN;
duke@0 112
duke@0 113 // Runtime support
duke@0 114
duke@0 115 // length = invoke bytecode length (to advance to next bytecode)
duke@0 116 static address deopt_entry (TosState state, int length) { ShouldNotReachHere(); return NULL; }
duke@0 117 static address return_entry (TosState state, int length) { ShouldNotReachHere(); return NULL; }
duke@0 118
duke@0 119 static address rethrow_exception_entry() { return _rethrow_exception_entry; }
duke@0 120
duke@0 121 // Activation size in words for a method that is just being called.
duke@0 122 // Parameters haven't been pushed so count them too.
duke@0 123 static int size_top_interpreter_activation(methodOop method);
duke@0 124
duke@0 125 // Deoptimization support
duke@0 126 static address continuation_for(methodOop method,
duke@0 127 address bcp,
duke@0 128 int callee_parameters,
duke@0 129 bool is_top_frame,
duke@0 130 bool& use_next_mdp);
duke@0 131
duke@0 132 // share implementation of size_activation and layout_activation:
duke@0 133 static int size_activation(methodOop method,
duke@0 134 int temps,
duke@0 135 int popframe_args,
duke@0 136 int monitors,
duke@0 137 int callee_params,
duke@0 138 int callee_locals,
duke@0 139 bool is_top_frame);
duke@0 140
duke@0 141 static int layout_activation(methodOop method,
duke@0 142 int temps,
duke@0 143 int popframe_args,
duke@0 144 int monitors,
duke@0 145 int callee_params,
duke@0 146 int callee_locals,
duke@0 147 frame* caller,
duke@0 148 frame* interpreter_frame,
duke@0 149 bool is_top_frame);
duke@0 150
duke@0 151 // Runtime support
duke@0 152 static bool is_not_reached( methodHandle method, int bci);
duke@0 153 // Safepoint support
duke@0 154 static void notice_safepoints() { ShouldNotReachHere(); } // stops the thread when reaching a safepoint
duke@0 155 static void ignore_safepoints() { ShouldNotReachHere(); } // ignores safepoints
duke@0 156
duke@0 157 // Support for native calls
duke@0 158 static address slow_signature_handler() { return _slow_signature_handler; }
duke@0 159 static address result_handler(BasicType type) { return _native_abi_to_tosca[BasicType_as_index(type)]; }
duke@0 160 static int BasicType_as_index(BasicType type); // computes index into result_handler_by_index table
duke@0 161 static bool in_native_entry(address pc) { return _native_entry_begin <= pc && pc < _native_entry_end; }
duke@0 162 // Debugging/printing
duke@0 163 static void print(); // prints the interpreter code
duke@0 164
duke@0 165 // Support for Tagged Stacks
duke@0 166 //
duke@0 167 // Tags are stored on the Java Expression stack above the value:
duke@0 168 //
duke@0 169 // tag
duke@0 170 // value
duke@0 171 //
duke@0 172 // For double values:
duke@0 173 //
duke@0 174 // tag2
duke@0 175 // high word
duke@0 176 // tag1
duke@0 177 // low word
duke@0 178
duke@0 179 public:
duke@0 180 static int stackElementWords() { return TaggedStackInterpreter ? 2 : 1; }
duke@0 181 static int stackElementSize() { return stackElementWords()*wordSize; }
duke@0 182 static int logStackElementSize() { return
duke@0 183 TaggedStackInterpreter? LogBytesPerWord+1 : LogBytesPerWord; }
duke@0 184
duke@0 185 // Tag is at pointer, value is one below for a stack growing down
duke@0 186 // (or above for stack growing up)
duke@0 187 static int value_offset_in_bytes() {
duke@0 188 return TaggedStackInterpreter ?
duke@0 189 frame::interpreter_frame_expression_stack_direction() * wordSize : 0;
duke@0 190 }
duke@0 191 static int tag_offset_in_bytes() {
duke@0 192 assert(TaggedStackInterpreter, "should not call this");
duke@0 193 return 0;
duke@0 194 }
duke@0 195
duke@0 196 // Tagged Locals
duke@0 197 // Locals are stored relative to Llocals:
duke@0 198 //
duke@0 199 // tag <- Llocals[n]
duke@0 200 // value
duke@0 201 //
duke@0 202 // Category 2 types are indexed as:
duke@0 203 //
duke@0 204 // tag <- Llocals[-n]
duke@0 205 // high word
duke@0 206 // tag <- Llocals[-n+1]
duke@0 207 // low word
duke@0 208 //
duke@0 209
duke@0 210 // Local values relative to locals[n]
duke@0 211 static int local_offset_in_bytes(int n) {
duke@0 212 return ((frame::interpreter_frame_expression_stack_direction() * n) *
duke@0 213 stackElementSize()) + value_offset_in_bytes();
duke@0 214 }
duke@0 215 static int local_tag_offset_in_bytes(int n) {
duke@0 216 assert(TaggedStackInterpreter, "should not call this");
duke@0 217 return ((frame::interpreter_frame_expression_stack_direction() * n) *
duke@0 218 stackElementSize()) + tag_offset_in_bytes();
duke@0 219 }
duke@0 220
duke@0 221 };
duke@0 222
duke@0 223 //------------------------------------------------------------------------------------------------------------------------
duke@0 224 // The interpreter generator.
duke@0 225
duke@0 226 class Template;
duke@0 227 class AbstractInterpreterGenerator: public StackObj {
duke@0 228 protected:
duke@0 229 InterpreterMacroAssembler* _masm;
duke@0 230
duke@0 231 // shared code sequences
duke@0 232 // Converter for native abi result to tosca result
duke@0 233 address generate_result_handler_for(BasicType type);
duke@0 234 address generate_slow_signature_handler();
duke@0 235
duke@0 236 // entry point generator
duke@0 237 address generate_method_entry(AbstractInterpreter::MethodKind kind);
duke@0 238
duke@0 239 void bang_stack_shadow_pages(bool native_call);
duke@0 240
duke@0 241 void generate_all();
duke@0 242
duke@0 243 public:
duke@0 244 AbstractInterpreterGenerator(StubQueue* _code);
duke@0 245 };