1 /*
2 * Copyright (c) 1997, 2026, 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_INTERPRETERRUNTIME_HPP
26 #define SHARE_INTERPRETER_INTERPRETERRUNTIME_HPP
27
28 #include "interpreter/bytecode.hpp"
29 #include "interpreter/linkResolver.hpp"
30 #include "oops/method.hpp"
31 #include "runtime/frame.hpp"
32 #include "runtime/javaThread.hpp"
33 #include "runtime/signature.hpp"
34 #include "utilities/macros.hpp"
35
36 class BufferBlob;
37 class CodeBuffer;
38
39 // The InterpreterRuntime is called by the interpreter for everything
40 // that cannot/should not be dealt with in assembly and needs C support.
41
42 class InterpreterRuntime: AllStatic {
43 private:
44
45 static void set_bcp_and_mdp(address bcp, JavaThread* current);
46 static void note_trap_inner(JavaThread* current, int reason,
47 const methodHandle& trap_method, int trap_bci);
48 static void note_trap(JavaThread* current, int reason);
49
50 // Inner work method for Interpreter's frequency counter overflow.
51 static nmethod* frequency_counter_overflow_inner(JavaThread* current, address branch_bcp);
52
53 public:
54 // Constants
55 static void ldc (JavaThread* current, bool wide);
56 static void resolve_ldc (JavaThread* current, Bytecodes::Code bytecode);
57
58 // Allocation
59 static void _new (JavaThread* current, ConstantPool* pool, int index);
60 static void newarray (JavaThread* current, BasicType type, jint size);
61 static void anewarray (JavaThread* current, ConstantPool* pool, int index, jint size);
62 static void multianewarray(JavaThread* current, jint* first_size_address);
63 static void register_finalizer(JavaThread* current, oopDesc* obj);
64 static void read_flat_field(JavaThread* current, oopDesc* object, ResolvedFieldEntry* entry);
65 static void write_flat_field(JavaThread* current, oopDesc* object, oopDesc* value, ResolvedFieldEntry* entry);
66
67 static void flat_array_load(JavaThread* current, arrayOopDesc* array, int index);
68 static void flat_array_store(JavaThread* current, oopDesc* val, arrayOopDesc* array, int index);
69
70 static jboolean is_substitutable(JavaThread* current, oopDesc* aobj, oopDesc* bobj);
71
72 // Quicken instance-of and check-cast bytecodes
73 static void quicken_io_cc(JavaThread* current);
74
75 // Exceptions thrown by the interpreter
76 static void throw_AbstractMethodError(JavaThread* current);
77 static void throw_AbstractMethodErrorWithMethod(JavaThread* current, Method* oop);
78 static void throw_AbstractMethodErrorVerbose(JavaThread* current,
79 Klass* recvKlass,
80 Method* missingMethod);
81
82 static void throw_IncompatibleClassChangeError(JavaThread* current);
83 static void throw_IncompatibleClassChangeErrorVerbose(JavaThread* current,
84 Klass* resc,
85 Klass* interfaceKlass);
86 static void throw_StackOverflowError(JavaThread* current);
87 static void throw_delayed_StackOverflowError(JavaThread* current);
88 static void throw_ArrayIndexOutOfBoundsException(JavaThread* current, arrayOopDesc* a, jint index);
89 static void throw_ClassCastException(JavaThread* current, oopDesc* obj);
90 static void throw_NullPointerException(JavaThread* current);
91
92 static void create_exception(JavaThread* current, char* name, char* message);
93 static void create_klass_exception(JavaThread* current, char* name, oopDesc* obj);
94 static address exception_handler_for_exception(JavaThread* current, oopDesc* exception);
95 #if INCLUDE_JVMTI
96 static void member_name_arg_or_null(JavaThread* current, address dmh, Method* m, address bcp);
97 #endif
98 static void throw_pending_exception(JavaThread* current);
99
100 static void resolve_from_cache(JavaThread* current, Bytecodes::Code bytecode);
101
102 // Used by AOTConstantPoolResolver
103 static void resolve_get_put(Bytecodes::Code bytecode, int field_index,
104 methodHandle& m, constantPoolHandle& pool, ClassInitMode init_mode, TRAPS);
105 static void cds_resolve_invoke(Bytecodes::Code bytecode, int method_index,
106 constantPoolHandle& pool, TRAPS);
107 static void cds_resolve_invokehandle(int raw_index,
108 constantPoolHandle& pool, TRAPS);
109 static void cds_resolve_invokedynamic(int raw_index,
110 constantPoolHandle& pool, TRAPS);
111 private:
112 // Statics & fields
113 static void resolve_get_put(Bytecodes::Code bytecode, TRAPS);
114
115 // Calls
116 static void resolve_invoke(Bytecodes::Code bytecode, TRAPS);
117 static void resolve_invokehandle (TRAPS);
118 static void resolve_invokedynamic(TRAPS);
119
120 static void update_invoke_cp_cache_entry(CallInfo& info, Bytecodes::Code bytecode,
121 methodHandle& resolved_method,
122 constantPoolHandle& pool, int method_index);
123 public:
124 // Synchronization
125 static void monitorenter(JavaThread* current, BasicObjectLock* elem);
126 static void monitorenter_obj(JavaThread* current, oopDesc* obj);
127 static void monitorexit (BasicObjectLock* elem);
128
129 static void throw_illegal_monitor_state_exception(JavaThread* current);
130 static void new_illegal_monitor_state_exception(JavaThread* current);
131 static void throw_identity_exception(JavaThread* current, oopDesc* obj);
132
133 // Breakpoints
134 static void _breakpoint(JavaThread* current, Method* method, address bcp);
135 static Bytecodes::Code get_original_bytecode_at(JavaThread* current, Method* method, address bcp);
136 static void set_original_bytecode_at(JavaThread* current, Method* method, address bcp, Bytecodes::Code new_code);
137
138 // Safepoints
139 static void at_safepoint(JavaThread* current);
140 static void at_unwind(JavaThread* current);
141
142 // Debugger support
143 static void post_field_access(JavaThread* current, oopDesc* obj,
144 ResolvedFieldEntry* entry);
145 static void post_field_modification(JavaThread* current, oopDesc* obj,
146 ResolvedFieldEntry* entry, jvalue *value);
147 static void post_method_entry(JavaThread* current);
148 static void post_method_exit (JavaThread* current);
149 static int interpreter_contains(address pc);
150
151 // Native signature handlers
152 static void prepare_native_call(JavaThread* current, Method* method);
153 static address slow_signature_handler(JavaThread* current,
154 Method* method,
155 intptr_t* from, intptr_t* to);
156
157 #if defined(AMD64) || defined(ARM)
158 // Popframe support (only needed on AMD64 and ARM)
159 static void popframe_move_outgoing_args(JavaThread* current, void* src_address, void* dest_address);
160 #endif
161
162 // bytecode tracing is only used by the TraceBytecodes
163 static intptr_t trace_bytecode(JavaThread* current, intptr_t preserve_this_value, intptr_t tos, intptr_t tos2) PRODUCT_RETURN0;
164
165 // Platform dependent stuff
166 #include CPU_HEADER(interpreterRT)
167
168 // optional normalization of fingerprints to reduce the number of adapters
169 static uint64_t normalize_fast_native_fingerprint(uint64_t fingerprint);
170
171 // Interpreter's frequency counter overflow
172 static nmethod* frequency_counter_overflow(JavaThread* current, address branch_bcp);
173
174 // Interpreter profiling support
175 static jint bcp_to_di(Method* method, address cur_bcp);
176 static void update_mdp_for_ret(JavaThread* current, int bci);
177 #ifdef ASSERT
178 static void verify_mdp(Method* method, address bcp, address mdp);
179 #endif // ASSERT
180 static MethodCounters* build_method_counters(JavaThread* current, Method* m);
181
182 // Virtual Thread Preemption
183 DEBUG_ONLY(static bool is_preemptable_call(address entry_point);)
184
185 DEBUG_ONLY(static void generate_oop_map_alot();)
186 };
187
188
189 class SignatureHandlerLibrary: public AllStatic {
190 public:
191 enum { buffer_size = 1*K }; // the size of the temporary code buffer
192 enum { blob_size = 32*K }; // the size of a handler code blob.
193
194 private:
195 static BufferBlob* _handler_blob; // the current buffer blob containing the generated handlers
196 static address _handler; // next available address within _handler_blob;
197 static GrowableArray<uint64_t>* _fingerprints; // the fingerprint collection
198 static GrowableArray<address>* _handlers; // the corresponding handlers
199 static address _buffer; // the temporary code buffer
200
201 static address set_handler_blob();
202 static void initialize();
203 static address set_handler(CodeBuffer* buffer);
204 static void pd_set_handler(address handler);
205
206 public:
207 static void add(const methodHandle& method);
208 };
209
210 #endif // SHARE_INTERPRETER_INTERPRETERRUNTIME_HPP