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