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 CPU_X86_INTERP_MASM_X86_HPP
26 #define CPU_X86_INTERP_MASM_X86_HPP
27
28 #include "asm/macroAssembler.hpp"
29 #include "oops/method.hpp"
30 #include "runtime/frame.hpp"
31
32 // This file specializes the assembler with interpreter-specific macros
33
34 typedef ByteSize (*OffsetFunction)(uint);
35
36 class InterpreterMacroAssembler: public MacroAssembler {
37 public:
38 // Interpreter specific version of call_VM_base
39 virtual void call_VM_leaf_base(address entry_point,
40 int number_of_arguments);
41
42 protected:
43
44 virtual void call_VM_base(Register oop_result,
45 Register java_thread,
46 Register last_java_sp,
47 address entry_point,
48 int number_of_arguments,
49 bool check_exceptions);
50
51 // base routine for all dispatches
52 void dispatch_base(TosState state, address* table, bool verifyoop = true, bool generate_poll = false);
53
54 public:
55 InterpreterMacroAssembler(CodeBuffer* code) : MacroAssembler(code),
56 _locals_register(r14),
57 _bcp_register(r13) {}
58
59 void jump_to_entry(address entry);
60
61 virtual void check_and_handle_popframe(Register java_thread);
62 virtual void check_and_handle_earlyret(Register java_thread);
63
64 void load_earlyret_value(TosState state);
65
66 void call_VM_preemptable(Register oop_result,
67 address entry_point,
68 Register arg_1);
69 void restore_after_resume(bool is_native);
70
71 // Interpreter-specific registers
72 void save_bcp() {
73 movptr(Address(rbp, frame::interpreter_frame_bcp_offset * wordSize), _bcp_register);
74 }
75
76 void restore_bcp() {
77 movptr(_bcp_register, Address(rbp, frame::interpreter_frame_bcp_offset * wordSize));
78 }
79
80 void restore_locals() {
81 movptr(_locals_register, Address(rbp, frame::interpreter_frame_locals_offset * wordSize));
82 lea(_locals_register, Address(rbp, _locals_register, Address::times_ptr));
83 }
84
85 // Helpers for runtime call arguments/results
86 void get_method(Register reg) {
87 movptr(reg, Address(rbp, frame::interpreter_frame_method_offset * wordSize));
88 }
89
90 void get_const(Register reg) {
91 get_method(reg);
92 movptr(reg, Address(reg, Method::const_offset()));
93 }
94
95 void get_constant_pool(Register reg) {
96 get_const(reg);
97 movptr(reg, Address(reg, ConstMethod::constants_offset()));
98 }
99
100 void get_constant_pool_cache(Register reg) {
101 get_constant_pool(reg);
102 movptr(reg, Address(reg, ConstantPool::cache_offset()));
103 }
104
105 void get_cpool_and_tags(Register cpool, Register tags) {
106 get_constant_pool(cpool);
107 movptr(tags, Address(cpool, ConstantPool::tags_offset()));
108 }
109
110 void get_unsigned_2_byte_index_at_bcp(Register reg, int bcp_offset);
111
112 void get_cache_index_at_bcp(Register index,
113 int bcp_offset,
114 size_t index_size = sizeof(u2));
115
116 // load cpool->resolved_references(index);
117 void load_resolved_reference_at_index(Register result, Register index, Register tmp = rscratch2);
118
119 // load cpool->resolved_klass_at(index)
120 void load_resolved_klass_at_index(Register klass, // contains the Klass on return
121 Register cpool, // the constant pool (corrupted on return)
122 Register index); // the constant pool index (corrupted on return)
123
124 // Expression stack
125 void pop_ptr(Register r = rax);
126 void pop_i(Register r = rax);
127
128 // On x86, pushing a ptr or an int is semantically identical, but we
129 // maintain a distinction for clarity and for making it easier to change
130 // semantics in the future
131 void push_ptr(Register r = rax);
132 void push_i(Register r = rax);
133
134 // push_i_or_ptr is provided for when explicitly allowing either a ptr or
135 // an int might have some advantage, while still documenting the fact that a
136 // ptr might be pushed to the stack.
137 void push_i_or_ptr(Register r = rax);
138
139 void push_f(XMMRegister r);
140 void pop_f(XMMRegister r);
141 void pop_d(XMMRegister r);
142 void push_d(XMMRegister r);
143 void pop_l(Register r = rax);
144 void push_l(Register r = rax);
145
146 void pop(Register r) { ((MacroAssembler*)this)->pop(r); }
147 void push(Register r) { ((MacroAssembler*)this)->push(r); }
148 void push(int32_t imm ) { ((MacroAssembler*)this)->push(imm); }
149
150 void pop(TosState state); // transition vtos -> state
151 void push(TosState state); // transition state -> vtos
152
153 void empty_expression_stack() {
154 movptr(rcx, Address(rbp, frame::interpreter_frame_monitor_block_top_offset * wordSize));
155 lea(rsp, Address(rbp, rcx, Address::times_ptr));
156 // null last_sp until next java call
157 movptr(Address(rbp, frame::interpreter_frame_last_sp_offset * wordSize), NULL_WORD);
158 }
159
160 // Helpers for swap and dup
161 void load_ptr(int n, Register val);
162 void store_ptr(int n, Register val);
163
164 // Generate a subtype check: branch to ok_is_subtype if sub_klass is
165 // a subtype of super_klass.
166 void gen_subtype_check(Register sub_klass, Label &ok_is_subtype, bool profile = true);
167
168 // Dispatching
169 void dispatch_prolog(TosState state, int step = 0);
170 void dispatch_epilog(TosState state, int step = 0);
171 // dispatch via rbx (assume rbx is loaded already)
172 void dispatch_only(TosState state, bool generate_poll = false);
173 // dispatch normal table via rbx (assume rbx is loaded already)
174 void dispatch_only_normal(TosState state);
175 void dispatch_only_noverify(TosState state);
176 // load rbx from [_bcp_register + step] and dispatch via rbx
177 void dispatch_next(TosState state, int step = 0, bool generate_poll = false);
178 // load rbx from [_bcp_register] and dispatch via rbx and table
179 void dispatch_via (TosState state, address* table);
180
181 // jump to an invoked target
182 void prepare_to_jump_from_interpreted();
183 void jump_from_interpreted(Register method, Register temp);
184
185 // narrow int return value
186 void narrow(Register result);
187
188 // Returning from interpreted functions
189 //
190 // Removes the current activation (incl. unlocking of monitors)
191 // and sets up the return address. This code is also used for
192 // exception unwindwing. In that case, we do not want to throw
193 // IllegalMonitorStateExceptions, since that might get us into an
194 // infinite rethrow exception loop.
195 // Additionally this code is used for popFrame and earlyReturn.
196 // In popFrame case we want to skip throwing an exception,
197 // installing an exception, and notifying jvmdi.
198 // In earlyReturn case we only want to skip throwing an exception
199 // and installing an exception.
200 void remove_activation(TosState state, Register ret_addr,
201 bool throw_monitor_exception = true,
202 bool install_monitor_exception = true,
203 bool notify_jvmdi = true);
204 void get_method_counters(Register method, Register mcs, Label& skip);
205
206 // Kills t1 and t2, preserves klass, return allocation in new_obj
207 void allocate_instance(Register klass, Register new_obj,
208 Register t1, Register t2,
209 bool clear_fields, Label& alloc_failed);
210
211 // Allocate instance in "obj" and read in the content of the inline field
212 // NOTES:
213 // - input holder object via "obj", which must be rax,
214 // will return new instance via the same reg
215 // - assumes holder_klass and valueKlass field klass have both been resolved
216 void read_flat_field(Register entry,
217 Register tmp1, Register tmp2,
218 Register obj = rax);
219
220 // Object locking
221 void lock_object (Register lock_reg);
222 void unlock_object(Register lock_reg);
223
224 // Interpreter profiling operations
225 void set_method_data_pointer_for_bcp();
226 void test_method_data_pointer(Register mdp, Label& zero_continue);
227 void verify_method_data_pointer();
228
229 void set_mdp_data_at(Register mdp_in, int constant, Register value);
230 void increment_mdp_data_at(Address data, bool decrement = false);
231 void increment_mdp_data_at(Register mdp_in, int constant,
232 bool decrement = false);
233 void increment_mdp_data_at(Register mdp_in, Register reg, int constant,
234 bool decrement = false);
235 void increment_mask_and_jump(Address counter_addr, Address mask,
236 Register scratch, Label* where);
237 void set_mdp_flag_at(Register mdp_in, int flag_constant);
238 void test_mdp_data_at(Register mdp_in, int offset, Register value,
239 Register test_value_out,
240 Label& not_equal_continue);
241
242 void record_klass_in_profile(Register receiver, Register mdp, Register reg2);
243 void record_klass_in_profile_helper(Register receiver, Register mdp, Register reg2, int start_row, Label &done);
244 void record_item_in_profile_helper(Register item, Register mdp, Register reg2, int start_row,
245 Label& done, int total_rows,
246 OffsetFunction item_offset_fn,
247 OffsetFunction item_count_offset_fn);
248
249 void update_mdp_by_offset(Register mdp_in, int offset_of_offset);
250 void update_mdp_by_offset(Register mdp_in, Register reg, int offset_of_disp);
251 void update_mdp_by_constant(Register mdp_in, int constant);
252 void update_mdp_for_ret(Register return_bci);
253
254 void profile_taken_branch(Register mdp, Register bumped_count);
255 void profile_not_taken_branch(Register mdp, bool acmp = false);
256 void profile_call(Register mdp);
257 void profile_final_call(Register mdp);
258 void profile_virtual_call(Register receiver, Register mdp,
259 Register scratch2,
260 bool receiver_can_be_null = false);
261 void profile_ret(Register return_bci, Register mdp);
262 void profile_null_seen(Register mdp);
263 void profile_typecheck(Register mdp, Register klass, Register scratch);
264
265 void profile_switch_default(Register mdp);
266 void profile_switch_case(Register index_in_scratch, Register mdp,
267 Register scratch2);
268 template <class ArrayData> void profile_array_type(Register mdp, Register array, Register tmp);
269
270 void profile_multiple_element_types(Register mdp, Register element, Register tmp, const Register tmp2);
271 void profile_element_type(Register mdp, Register element, Register tmp);
272 void profile_acmp(Register mdp, Register left, Register right, Register tmp);
273
274 // Debugging
275 // only if +VerifyOops && state == atos
276 #define interp_verify_oop(reg, state) _interp_verify_oop(reg, state, __FILE__, __LINE__);
277 void _interp_verify_oop(Register reg, TosState state, const char* file, int line);
278
279 typedef enum { NotifyJVMTI, SkipNotifyJVMTI } NotifyMethodExitMode;
280
281 // support for jvmti/dtrace
282 void notify_method_entry();
283 void notify_method_exit(TosState state, NotifyMethodExitMode mode);
284
285 private:
286
287 Register _locals_register; // register that contains the pointer to the locals
288 Register _bcp_register; // register that contains the bcp
289
290 public:
291 void profile_obj_type(Register obj, const Address& mdo_addr);
292 void profile_arguments_type(Register mdp, Register callee, Register tmp, bool is_virtual);
293 void profile_return_type(Register mdp, Register ret, Register tmp);
294 void profile_parameters_type(Register mdp, Register tmp1, Register tmp2);
295
296 void load_resolved_indy_entry(Register cache, Register index);
297 void load_field_entry(Register cache, Register index, int bcp_offset = 1);
298 void load_method_entry(Register cache, Register index, int bcp_offset = 1);
299 };
300
301 #endif // CPU_X86_INTERP_MASM_X86_HPP