1 /*
2 * Copyright (c) 1997, 2025, 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_INTERPRETER_ABSTRACTINTERPRETER_HPP
26 #define SHARE_INTERPRETER_ABSTRACTINTERPRETER_HPP
27
28 #include "asm/macroAssembler.hpp"
29 #include "classfile/vmIntrinsics.hpp"
30 #include "code/stubs.hpp"
31 #include "interpreter/bytecodes.hpp"
32 #include "oops/method.hpp"
33 #include "runtime/frame.hpp"
34 #include "runtime/javaThread.hpp"
35 #include "runtime/vmThread.hpp"
36
37 // This file contains the platform-independent parts
38 // of the abstract interpreter and the abstract interpreter generator.
39
40 // Organization of the interpreter(s). There exists two different interpreters in hotpot
41 // an assembly language version (aka template interpreter) and a high level language version
42 // (aka c++ interpreter). The division of labor is as follows:
43
44 // Template Interpreter Zero Interpreter Functionality
45 //
46 // templateTable* bytecodeInterpreter* actual interpretation of bytecodes
47 //
48 // templateInterpreter* zeroInterpreter* generation of assembly code that creates
49 // and manages interpreter runtime frames.
50 //
51
52 class InterpreterMacroAssembler;
53
54 class AbstractInterpreter: AllStatic {
55 friend class VMStructs;
56 friend class ZeroInterpreterGenerator;
57 friend class TemplateInterpreterGenerator;
58 public:
59 enum MethodKind {
60 zerolocals, // method needs locals initialization
61 zerolocals_synchronized, // method needs locals initialization & is synchronized
62 zerolocals_upcalls, // method needs locals initialization & has runtime upcalls
63 zerolocals_synchronized_upcalls, // method needs locals initialization & is synchronized & has runtime upcalls
64 native, // native method
65 native_synchronized, // native method & is synchronized
66 native_upcalls, // native method & has runtime upcalls
67 native_synchronized_upcalls, // native method & is synchronized & has runtime upcalls
68 empty, // empty method (code: _return)
69 empty_upcalls, // empty method & has runtime upcalls (code: _return)
70 getter, // getter method
71 setter, // setter method
72 abstract, // abstract method (throws an AbstractMethodException)
73 method_handle_invoke_FIRST, // java.lang.invoke.MethodHandles::invokeExact, etc.
74 method_handle_invoke_LAST = (method_handle_invoke_FIRST
75 + (static_cast<int>(vmIntrinsics::LAST_MH_SIG_POLY)
76 - static_cast<int>(vmIntrinsics::FIRST_MH_SIG_POLY))),
77 java_lang_math_sin, // implementation of java.lang.Math.sin (x)
78 java_lang_math_cos, // implementation of java.lang.Math.cos (x)
79 java_lang_math_tan, // implementation of java.lang.Math.tan (x)
80 java_lang_math_sinh, // implementation of java.lang.Math.sinh (x)
81 java_lang_math_tanh, // implementation of java.lang.Math.tanh (x)
82 java_lang_math_cbrt, // implementation of java.lang.Math.cbrt (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_sqrt_strict, // implementation of java.lang.StrictMath.sqrt(x)
86 java_lang_math_log, // implementation of java.lang.Math.log (x)
87 java_lang_math_log10, // implementation of java.lang.Math.log10 (x)
88 java_lang_math_pow, // implementation of java.lang.Math.pow (x,y)
89 java_lang_math_exp, // implementation of java.lang.Math.exp (x)
90 java_lang_math_fmaF, // implementation of java.lang.Math.fma (x, y, z)
91 java_lang_math_fmaD, // implementation of java.lang.Math.fma (x, y, z)
92 java_lang_ref_reference_get0, // implementation of java.lang.ref.Reference.get()
93 java_util_zip_CRC32_update, // implementation of java.util.zip.CRC32.update()
94 java_util_zip_CRC32_updateBytes, // implementation of java.util.zip.CRC32.updateBytes()
95 java_util_zip_CRC32_updateByteBuffer, // implementation of java.util.zip.CRC32.updateByteBuffer()
96 java_util_zip_CRC32C_updateBytes, // implementation of java.util.zip.CRC32C.updateBytes(crc, b[], off, end)
97 java_util_zip_CRC32C_updateDirectByteBuffer, // implementation of java.util.zip.CRC32C.updateDirectByteBuffer(crc, address, off, end)
98 java_lang_Float_float16ToFloat, // implementation of java.lang.Float.float16ToFloat()
99 java_lang_Float_floatToFloat16, // implementation of java.lang.Float.floatToFloat16()
100 java_lang_Thread_currentThread, // implementation of java.lang.Thread.currentThread()
101 number_of_method_entries,
102 invalid = -1
103 };
104
105 // Conversion from the part of the above enum to vmIntrinsics::_invokeExact, etc.
106 static vmIntrinsics::ID method_handle_intrinsic(MethodKind kind) {
107 if (kind >= method_handle_invoke_FIRST && kind <= method_handle_invoke_LAST)
108 return vmIntrinsics::ID_from(static_cast<int>(vmIntrinsics::FIRST_MH_SIG_POLY) + (kind - method_handle_invoke_FIRST));
109 else
110 return vmIntrinsics::_none;
111 }
112
113 // Conversion from the above enum to vmIntrinsics::ID
114 static vmIntrinsics::ID method_intrinsic(MethodKind kind);
115
116 enum SomeConstants {
117 number_of_result_handlers = 10 // number of result handlers for native calls
118 };
119
120 protected:
121 static StubQueue* _code; // the interpreter code (codelets)
122
123 static bool _notice_safepoints; // true if safepoints are activated
124
125 // method entry points
126 static address _entry_table[number_of_method_entries]; // entry points for a given method
127 static address _native_abi_to_tosca[number_of_result_handlers]; // for native method result handlers
128 static address _slow_signature_handler; // the native method generic (slow) signature handler
129
130 static address _rethrow_exception_entry; // rethrows an activation in previous frame
131
132 static bool _should_print_instructions; // only with PrintInterpreter and when printing all InterpreterCodelet
133
134 friend class AbstractInterpreterGenerator;
135 friend class InterpreterMacroAssembler;
136
137 public:
138 // Initialization/debugging
139 static void initialize();
140 static StubQueue* code() { return _code; }
141 static bool should_print_instructions() { return _should_print_instructions; }
142
143
144 // Method activation
145 static MethodKind method_kind(const methodHandle& m);
146 static address entry_for_kind(MethodKind k) { assert(0 <= k && k < number_of_method_entries, "illegal kind"); return _entry_table[k]; }
147 static address entry_for_method(const methodHandle& m) { return entry_for_kind(method_kind(m)); }
148
149 // used for bootstrapping method handles:
150 static void set_entry_for_kind(MethodKind k, address e);
151
152 static void print_method_kind(MethodKind kind) PRODUCT_RETURN;
153
154 // These should never be compiled since the interpreter will prefer
155 // the compiled version to the intrinsic version.
156 static bool can_be_compiled(const methodHandle& m) {
157 switch (m->intrinsic_id()) {
158 case vmIntrinsics::_dsin : // fall thru
159 case vmIntrinsics::_dcos : // fall thru
160 case vmIntrinsics::_dtan : // fall thru
161 case vmIntrinsics::_dsinh : // fall thru
162 case vmIntrinsics::_dtanh : // fall thru
163 case vmIntrinsics::_dcbrt : // fall thru
164 case vmIntrinsics::_dabs : // fall thru
165 case vmIntrinsics::_dsqrt : // fall thru
166 case vmIntrinsics::_dsqrt_strict : // fall thru
167 case vmIntrinsics::_dlog : // fall thru
168 case vmIntrinsics::_dlog10: // fall thru
169 case vmIntrinsics::_dpow : // fall thru
170 case vmIntrinsics::_dexp : // fall thru
171 case vmIntrinsics::_fmaD : // fall thru
172 case vmIntrinsics::_fmaF : // fall thru
173 case vmIntrinsics::_floatToFloat16 : // fall thru
174 case vmIntrinsics::_float16ToFloat : // fall thru
175 case vmIntrinsics::_Continuation_doYield : // fall thru
176 return false;
177
178 default:
179 return true;
180 }
181 }
182
183 // Runtime support
184
185 // length = invoke bytecode length (to advance to next bytecode)
186 static address deopt_entry(TosState state, int length) { ShouldNotReachHere(); return nullptr; }
187 static address return_entry(TosState state, int length, Bytecodes::Code code) { ShouldNotReachHere(); return nullptr; }
188
189 static address rethrow_exception_entry() { return _rethrow_exception_entry; }
190
191 // Activation size in words for a method that is just being called.
192 // Parameters haven't been pushed so count them too.
193 static int size_top_interpreter_activation(Method* method);
194
195 // Deoptimization support
196 // Compute the entry address for continuation after
197 static address deopt_continue_after_entry(Method* method,
198 address bcp,
199 int callee_parameters,
200 bool is_top_frame);
201 // Compute the entry address for reexecution
202 static address deopt_reexecute_entry(Method* method, address bcp);
203 // Deoptimization should reexecute this bytecode
204 static bool bytecode_should_reexecute(Bytecodes::Code code);
205
206 // deoptimization support
207 static int size_activation(int max_stack,
208 int temps,
209 int extra_args,
210 int monitors,
211 int callee_params,
212 int callee_locals,
213 bool is_top_frame);
214
215 static void layout_activation(Method* method,
216 int temps,
217 int popframe_args,
218 int monitors,
219 int caller_actual_parameters,
220 int callee_params,
221 int callee_locals,
222 frame* caller,
223 frame* interpreter_frame,
224 bool is_top_frame,
225 bool is_bottom_frame);
226
227 // Runtime support
228 static bool is_not_reached(const methodHandle& method, int bci);
229 // Safepoint support
230 static void notice_safepoints() { ShouldNotReachHere(); } // stops the thread when reaching a safepoint
231 static void ignore_safepoints() { ShouldNotReachHere(); } // ignores safepoints
232
233 // Support for native calls
234 static address slow_signature_handler() { return _slow_signature_handler; }
235 static address result_handler(BasicType type) { return _native_abi_to_tosca[BasicType_as_index(type)]; }
236 static int BasicType_as_index(BasicType type); // computes index into result_handler_by_index table
237 // Debugging/printing
238 static void print(); // prints the interpreter code
239
240 public:
241 // Interpreter helpers
242 const static int stackElementWords = 1;
243 const static int stackElementSize = stackElementWords * wordSize;
244 const static int logStackElementSize = LogBytesPerWord;
245
246 static int expr_index_at(int i) {
247 return stackElementWords * i;
248 }
249
250 static int expr_offset_in_bytes(int i) {
251 #if !defined(ZERO) && (defined(PPC) || defined(S390))
252 return stackElementSize * i + wordSize; // both point to one word past TOS
253 #else
254 return stackElementSize * i;
255 #endif
256 }
257
258 static int local_index_at(int i) {
259 assert(i <= 0, "local direction already negated");
260 return stackElementWords * i;
261 }
262
263 #if !defined(ZERO) && defined(AMD64)
264 static Address::ScaleFactor stackElementScale() {
265 return NOT_LP64(Address::times_4) LP64_ONLY(Address::times_8);
266 }
267 #endif
268
269 // Local values relative to locals[n]
270 static int local_offset_in_bytes(int n) {
271 return ((frame::interpreter_frame_expression_stack_direction() * n) * stackElementSize);
272 }
273
274 // access to stacked values according to type:
275 static oop* oop_addr_in_slot(intptr_t* slot_addr) {
276 return (oop*) slot_addr;
277 }
278 static jint* int_addr_in_slot(intptr_t* slot_addr) {
279 if ((int) sizeof(jint) < wordSize && !Endian::is_Java_byte_ordering_different())
280 // big-endian LP64
281 return (jint*)(slot_addr + 1) - 1;
282 else
283 return (jint*) slot_addr;
284 }
285 static jlong long_in_slot(intptr_t* slot_addr) {
286 if (sizeof(intptr_t) >= sizeof(jlong)) {
287 return *(jlong*) slot_addr;
288 } else {
289 return Bytes::get_native_u8((address)slot_addr);
290 }
291 }
292 static void set_long_in_slot(intptr_t* slot_addr, jlong value) {
293 if (sizeof(intptr_t) >= sizeof(jlong)) {
294 *(jlong*) slot_addr = value;
295 } else {
296 Bytes::put_native_u8((address)slot_addr, value);
297 }
298 }
299
300 static void initialize_method_handle_entries();
301 };
302
303 //------------------------------------------------------------------------------------------------------------------------
304 // The interpreter generator.
305
306 class Template;
307 class AbstractInterpreterGenerator: public StackObj {
308 protected:
309 InterpreterMacroAssembler* _masm;
310
311 public:
312 AbstractInterpreterGenerator();
313 };
314
315 #endif // SHARE_INTERPRETER_ABSTRACTINTERPRETER_HPP