1 /*
2 * Copyright (c) 1997, 2014, Oracle and/or its affiliates. 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_VM_INTERPRETER_ABSTRACTINTERPRETER_HPP
26 #define SHARE_VM_INTERPRETER_ABSTRACTINTERPRETER_HPP
27
28 #include "asm/macroAssembler.hpp"
29 #include "code/stubs.hpp"
30 #include "interpreter/bytecodes.hpp"
31 #include "runtime/thread.inline.hpp"
32 #include "runtime/vmThread.hpp"
33 #include "utilities/top.hpp"
34
35 // This file contains the platform-independent parts
36 // of the abstract interpreter and the abstract interpreter generator.
37
38 // Organization of the interpreter(s). There exists two different interpreters in hotpot
39 // an assembly language version (aka template interpreter) and a high level language version
40 // (aka c++ interpreter). Th division of labor is as follows:
41
42 // Template Interpreter C++ Interpreter Functionality
43 //
44 // templateTable* bytecodeInterpreter* actual interpretation of bytecodes
45 //
46 // templateInterpreter* cppInterpreter* generation of assembly code that creates
47 // and manages interpreter runtime frames.
48 // Also code for populating interpreter
49 // frames created during deoptimization.
50 //
51 // For both template and c++ interpreter. There are common files for aspects of the interpreter
52 // that are generic to both interpreters. This is the layout:
53 //
54 // abstractInterpreter.hpp: generic description of the interpreter.
55 // interpreter*: generic frame creation and handling.
56 //
57
58 //------------------------------------------------------------------------------------------------------------------------
59 // The C++ interface to the bytecode interpreter(s).
60
61 class InterpreterMacroAssembler;
62
63 class AbstractInterpreter: AllStatic {
64 friend class VMStructs;
65 friend class Interpreter;
66 friend class CppInterpreterGenerator;
67 public:
68 enum MethodKind {
69 zerolocals, // method needs locals initialization
70 zerolocals_synchronized, // method needs locals initialization & is synchronized
71 native, // native method
72 native_synchronized, // native method & is synchronized
73 empty, // empty method (code: _return)
74 accessor, // accessor method (code: _aload_0, _getfield, _(a|i)return)
75 abstract, // abstract method (throws an AbstractMethodException)
76 method_handle_invoke_FIRST, // java.lang.invoke.MethodHandles::invokeExact, etc.
77 method_handle_invoke_LAST = (method_handle_invoke_FIRST
78 + (vmIntrinsics::LAST_MH_SIG_POLY
79 - vmIntrinsics::FIRST_MH_SIG_POLY)),
80 java_lang_math_sin, // implementation of java.lang.Math.sin (x)
81 java_lang_math_cos, // implementation of java.lang.Math.cos (x)
82 java_lang_math_tan, // implementation of java.lang.Math.tan (x)
83 java_lang_math_abs, // implementation of java.lang.Math.abs (x)
84 java_lang_math_sqrt, // implementation of java.lang.Math.sqrt (x)
85 java_lang_math_log, // implementation of java.lang.Math.log (x)
86 java_lang_math_log10, // implementation of java.lang.Math.log10 (x)
87 java_lang_math_pow, // implementation of java.lang.Math.pow (x,y)
88 java_lang_math_exp, // implementation of java.lang.Math.exp (x)
89 java_lang_ref_reference_get, // implementation of java.lang.ref.Reference.get()
90 java_util_zip_CRC32_update, // implementation of java.util.zip.CRC32.update()
91 java_util_zip_CRC32_updateBytes, // implementation of java.util.zip.CRC32.updateBytes()
92 java_util_zip_CRC32_updateByteBuffer, // implementation of java.util.zip.CRC32.updateByteBuffer()
93 java_util_zip_CRC32C_updateBytes, // implementation of java.util.zip.CRC32C.updateBytes(crc, b[], off, end)
94 java_util_zip_CRC32C_updateDirectByteBuffer, // implementation of java.util.zip.CRC32C.updateDirectByteBuffer(crc, address, off, end)
95 number_of_method_entries,
96 invalid = -1
97 };
98
99 // Conversion from the part of the above enum to vmIntrinsics::_invokeExact, etc.
100 static vmIntrinsics::ID method_handle_intrinsic(MethodKind kind) {
101 if (kind >= method_handle_invoke_FIRST && kind <= method_handle_invoke_LAST)
102 return (vmIntrinsics::ID)( vmIntrinsics::FIRST_MH_SIG_POLY + (kind - method_handle_invoke_FIRST) );
103 else
104 return vmIntrinsics::_none;
105 }
106
107 enum SomeConstants {
108 number_of_result_handlers = 10 // number of result handlers for native calls
109 };
110
111 protected:
112 static StubQueue* _code; // the interpreter code (codelets)
113
114 static bool _notice_safepoints; // true if safepoints are activated
115
116 static address _native_entry_begin; // Region for native entry code
117 static address _native_entry_end;
118
119 // method entry points
120 static address _entry_table[number_of_method_entries]; // entry points for a given method
121 static address _native_abi_to_tosca[number_of_result_handlers]; // for native method result handlers
122 static address _slow_signature_handler; // the native method generic (slow) signature handler
123
124 static address _rethrow_exception_entry; // rethrows an activation in previous frame
125
126 friend class AbstractInterpreterGenerator;
127 friend class InterpreterGenerator;
128 friend class InterpreterMacroAssembler;
129
130 public:
131 // Initialization/debugging
132 static void initialize();
133 static StubQueue* code() { return _code; }
134
135
136 // Method activation
137 static MethodKind method_kind(methodHandle m);
138 static address entry_for_kind(MethodKind k) { assert(0 <= k && k < number_of_method_entries, "illegal kind"); return _entry_table[k]; }
139 static address entry_for_method(methodHandle m) { return entry_for_kind(method_kind(m)); }
140
141 // used for bootstrapping method handles:
142 static void set_entry_for_kind(MethodKind k, address e);
143
144 static void print_method_kind(MethodKind kind) PRODUCT_RETURN;
145
146 static bool can_be_compiled(methodHandle m);
147
148 // Runtime support
149
150 // length = invoke bytecode length (to advance to next bytecode)
151 static address deopt_entry(TosState state, int length) { ShouldNotReachHere(); return NULL; }
152 static address return_entry(TosState state, int length, Bytecodes::Code code) { ShouldNotReachHere(); return NULL; }
153
154 static address rethrow_exception_entry() { return _rethrow_exception_entry; }
155
156 // Activation size in words for a method that is just being called.
157 // Parameters haven't been pushed so count them too.
158 static int size_top_interpreter_activation(Method* method);
159
160 // Deoptimization support
161 // Compute the entry address for continuation after
162 static address deopt_continue_after_entry(Method* method,
163 address bcp,
164 int callee_parameters,
165 bool is_top_frame);
166 // Compute the entry address for reexecution
167 static address deopt_reexecute_entry(Method* method, address bcp);
168 // Deoptimization should reexecute this bytecode
169 static bool bytecode_should_reexecute(Bytecodes::Code code);
170
171 // deoptimization support
172 static int size_activation(int max_stack,
173 int temps,
174 int extra_args,
175 int monitors,
176 int callee_params,
177 int callee_locals,
178 bool is_top_frame);
179
180 static void layout_activation(Method* method,
181 int temps,
182 int popframe_args,
183 int monitors,
184 int caller_actual_parameters,
185 int callee_params,
186 int callee_locals,
187 frame* caller,
188 frame* interpreter_frame,
189 bool is_top_frame,
190 bool is_bottom_frame);
191
192 // Runtime support
193 static bool is_not_reached( methodHandle method, int bci);
194 // Safepoint support
195 static void notice_safepoints() { ShouldNotReachHere(); } // stops the thread when reaching a safepoint
196 static void ignore_safepoints() { ShouldNotReachHere(); } // ignores safepoints
197
198 // Support for native calls
199 static address slow_signature_handler() { return _slow_signature_handler; }
200 static address result_handler(BasicType type) { return _native_abi_to_tosca[BasicType_as_index(type)]; }
201 static int BasicType_as_index(BasicType type); // computes index into result_handler_by_index table
202 static bool in_native_entry(address pc) { return _native_entry_begin <= pc && pc < _native_entry_end; }
203 // Debugging/printing
204 static void print(); // prints the interpreter code
205
206 public:
207 // Interpreter helpers
208 const static int stackElementWords = 1;
209 const static int stackElementSize = stackElementWords * wordSize;
210 const static int logStackElementSize = LogBytesPerWord;
211
212 // Local values relative to locals[n]
213 static int local_offset_in_bytes(int n) {
214 return ((frame::interpreter_frame_expression_stack_direction() * n) * stackElementSize);
215 }
216
217 // access to stacked values according to type:
218 static oop* oop_addr_in_slot(intptr_t* slot_addr) {
219 return (oop*) slot_addr;
220 }
221 static jint* int_addr_in_slot(intptr_t* slot_addr) {
222 if ((int) sizeof(jint) < wordSize && !Bytes::is_Java_byte_ordering_different())
223 // big-endian LP64
224 return (jint*)(slot_addr + 1) - 1;
225 else
226 return (jint*) slot_addr;
227 }
228 static jlong long_in_slot(intptr_t* slot_addr) {
229 if (sizeof(intptr_t) >= sizeof(jlong)) {
230 return *(jlong*) slot_addr;
231 } else {
232 return Bytes::get_native_u8((address)slot_addr);
233 }
234 }
235 static void set_long_in_slot(intptr_t* slot_addr, jlong value) {
236 if (sizeof(intptr_t) >= sizeof(jlong)) {
237 *(jlong*) slot_addr = value;
238 } else {
239 Bytes::put_native_u8((address)slot_addr, value);
240 }
241 }
242 static void get_jvalue_in_slot(intptr_t* slot_addr, BasicType type, jvalue* value) {
243 switch (type) {
244 case T_BOOLEAN: value->z = *int_addr_in_slot(slot_addr); break;
245 case T_CHAR: value->c = *int_addr_in_slot(slot_addr); break;
246 case T_BYTE: value->b = *int_addr_in_slot(slot_addr); break;
247 case T_SHORT: value->s = *int_addr_in_slot(slot_addr); break;
248 case T_INT: value->i = *int_addr_in_slot(slot_addr); break;
249 case T_LONG: value->j = long_in_slot(slot_addr); break;
250 case T_FLOAT: value->f = *(jfloat*)int_addr_in_slot(slot_addr); break;
251 case T_DOUBLE: value->d = jdouble_cast(long_in_slot(slot_addr)); break;
252 case T_OBJECT: value->l = (jobject)*oop_addr_in_slot(slot_addr); break;
253 default: ShouldNotReachHere();
254 }
255 }
256 static void set_jvalue_in_slot(intptr_t* slot_addr, BasicType type, jvalue* value) {
257 switch (type) {
258 case T_BOOLEAN: *int_addr_in_slot(slot_addr) = (value->z != 0); break;
259 case T_CHAR: *int_addr_in_slot(slot_addr) = value->c; break;
260 case T_BYTE: *int_addr_in_slot(slot_addr) = value->b; break;
261 case T_SHORT: *int_addr_in_slot(slot_addr) = value->s; break;
262 case T_INT: *int_addr_in_slot(slot_addr) = value->i; break;
263 case T_LONG: set_long_in_slot(slot_addr, value->j); break;
264 case T_FLOAT: *(jfloat*)int_addr_in_slot(slot_addr) = value->f; break;
265 case T_DOUBLE: set_long_in_slot(slot_addr, jlong_cast(value->d)); break;
266 case T_OBJECT: *oop_addr_in_slot(slot_addr) = (oop) value->l; break;
267 default: ShouldNotReachHere();
268 }
269 }
270 };
271
272 //------------------------------------------------------------------------------------------------------------------------
273 // The interpreter generator.
274
275 class Template;
276 class AbstractInterpreterGenerator: public StackObj {
277 protected:
278 InterpreterMacroAssembler* _masm;
279
280 // shared code sequences
281 // Converter for native abi result to tosca result
282 address generate_result_handler_for(BasicType type);
283 address generate_slow_signature_handler();
284
285 void bang_stack_shadow_pages(bool native_call);
286
287 void generate_all();
288 void initialize_method_handle_entries();
289
290 public:
291 AbstractInterpreterGenerator(StubQueue* _code);
292 };
293
294 #endif // SHARE_VM_INTERPRETER_ABSTRACTINTERPRETER_HPP