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_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* threcurrentad, 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 write_heap_copy (JavaThread* current, oopDesc* value, int offset, oopDesc* rcv);
65 static void read_flat_field(JavaThread* current, oopDesc* object, ResolvedFieldEntry* entry);
66 static void write_flat_field(JavaThread* current, oopDesc* object, oopDesc* value, ResolvedFieldEntry* entry);
67
68 static void flat_array_load(JavaThread* current, arrayOopDesc* array, int index);
69 static void flat_array_store(JavaThread* current, oopDesc* val, arrayOopDesc* array, int index);
70
71 static jboolean is_substitutable(JavaThread* current, oopDesc* aobj, oopDesc* bobj);
72
73 // Quicken instance-of and check-cast bytecodes
74 static void quicken_io_cc(JavaThread* current);
75
76 // Exceptions thrown by the interpreter
77 static void throw_AbstractMethodError(JavaThread* current);
78 static void throw_AbstractMethodErrorWithMethod(JavaThread* current, Method* oop);
79 static void throw_AbstractMethodErrorVerbose(JavaThread* current,
80 Klass* recvKlass,
81 Method* missingMethod);
82
83 static void throw_InstantiationError(JavaThread* current);
84 static void throw_IncompatibleClassChangeError(JavaThread* current);
85 static void throw_IncompatibleClassChangeErrorVerbose(JavaThread* current,
86 Klass* resc,
87 Klass* interfaceKlass);
88 static void throw_StackOverflowError(JavaThread* current);
89 static void throw_delayed_StackOverflowError(JavaThread* current);
90 static void throw_ArrayIndexOutOfBoundsException(JavaThread* current, arrayOopDesc* a, jint index);
91 static void throw_ClassCastException(JavaThread* current, oopDesc* obj);
92 static void throw_NullPointerException(JavaThread* current);
93
94 static void create_exception(JavaThread* current, char* name, char* message);
95 static void create_klass_exception(JavaThread* current, char* name, oopDesc* obj);
96 static address exception_handler_for_exception(JavaThread* current, oopDesc* exception);
97 #if INCLUDE_JVMTI
98 static void member_name_arg_or_null(JavaThread* current, address dmh, Method* m, address bcp);
99 #endif
100 static void throw_pending_exception(JavaThread* current);
101
102 static void resolve_from_cache(JavaThread* current, Bytecodes::Code bytecode);
103
104 // Used by AOTConstantPoolResolver
105 static void resolve_get_put(Bytecodes::Code bytecode, int field_index,
106 methodHandle& m, constantPoolHandle& pool, bool initialize_holder, TRAPS);
107 static void cds_resolve_invoke(Bytecodes::Code bytecode, int method_index,
108 constantPoolHandle& pool, TRAPS);
109 static void cds_resolve_invokehandle(int raw_index,
110 constantPoolHandle& pool, TRAPS);
111 static void cds_resolve_invokedynamic(int raw_index,
112 constantPoolHandle& pool, TRAPS);
113 private:
114 // Statics & fields
115 static void resolve_get_put(JavaThread* current, Bytecodes::Code bytecode);
116
117 // Calls
118 static void resolve_invoke(JavaThread* current, Bytecodes::Code bytecode);
119 static void resolve_invokehandle (JavaThread* current);
120 static void resolve_invokedynamic(JavaThread* current);
121
122 static void update_invoke_cp_cache_entry(CallInfo& info, Bytecodes::Code bytecode,
123 methodHandle& resolved_method,
124 constantPoolHandle& pool, int method_index);
125 public:
126 // Synchronization
127 static void monitorenter(JavaThread* current, BasicObjectLock* elem);
128 static void monitorenter_obj(JavaThread* current, oopDesc* obj);
129 static void monitorexit (BasicObjectLock* elem);
130
131 static void throw_illegal_monitor_state_exception(JavaThread* current);
132 static void new_illegal_monitor_state_exception(JavaThread* current);
133 static void throw_identity_exception(JavaThread* current, oopDesc* obj);
134
135 // Breakpoints
136 static void _breakpoint(JavaThread* current, Method* method, address bcp);
137 static Bytecodes::Code get_original_bytecode_at(JavaThread* current, Method* method, address bcp);
138 static void set_original_bytecode_at(JavaThread* current, Method* method, address bcp, Bytecodes::Code new_code);
139
140 // Safepoints
141 static void at_safepoint(JavaThread* current);
142 static void at_unwind(JavaThread* current);
143
144 // Debugger support
145 static void post_field_access(JavaThread* current, oopDesc* obj,
146 ResolvedFieldEntry* entry);
147 static void post_field_modification(JavaThread* current, oopDesc* obj,
148 ResolvedFieldEntry* entry, jvalue *value);
149 static void post_method_entry(JavaThread* current);
150 static void post_method_exit (JavaThread* current);
151 static int interpreter_contains(address pc);
152
153 // Native signature handlers
154 static void prepare_native_call(JavaThread* current, Method* method);
155 static address slow_signature_handler(JavaThread* current,
156 Method* method,
157 intptr_t* from, intptr_t* to);
158
159 #if defined(IA32) || defined(AMD64) || defined(ARM)
160 // Popframe support (only needed on x86, AMD64 and ARM)
161 static void popframe_move_outgoing_args(JavaThread* current, void* src_address, void* dest_address);
162 #endif
163
164 // bytecode tracing is only used by the TraceBytecodes
165 static intptr_t trace_bytecode(JavaThread* current, intptr_t preserve_this_value, intptr_t tos, intptr_t tos2) PRODUCT_RETURN0;
166
167 // Platform dependent stuff
168 #include CPU_HEADER(interpreterRT)
169
170 // optional normalization of fingerprints to reduce the number of adapters
171 static uint64_t normalize_fast_native_fingerprint(uint64_t fingerprint);
172
173 // Interpreter's frequency counter overflow
174 static nmethod* frequency_counter_overflow(JavaThread* current, address branch_bcp);
175
176 // Interpreter profiling support
177 static jint bcp_to_di(Method* method, address cur_bcp);
178 static void update_mdp_for_ret(JavaThread* current, int bci);
179 #ifdef ASSERT
180 static void verify_mdp(Method* method, address bcp, address mdp);
181 #endif // ASSERT
182 static MethodCounters* build_method_counters(JavaThread* current, Method* m);
183 };
184
185
186 class SignatureHandlerLibrary: public AllStatic {
187 public:
188 enum { buffer_size = 1*K }; // the size of the temporary code buffer
189 enum { blob_size = 32*K }; // the size of a handler code blob.
190
191 private:
192 static BufferBlob* _handler_blob; // the current buffer blob containing the generated handlers
193 static address _handler; // next available address within _handler_blob;
194 static GrowableArray<uint64_t>* _fingerprints; // the fingerprint collection
195 static GrowableArray<address>* _handlers; // the corresponding handlers
196 static address _buffer; // the temporary code buffer
197
198 static address set_handler_blob();
199 static void initialize();
200 static address set_handler(CodeBuffer* buffer);
201 static void pd_set_handler(address handler);
202
203 public:
204 static void add(const methodHandle& method);
205 };
206
207 #endif // SHARE_INTERPRETER_INTERPRETERRUNTIME_HPP