1 /*
  2  * Copyright (c) 2003, 2025, Oracle and/or its affiliates. All rights reserved.
  3  * Copyright (c) 2014, 2015, Red Hat Inc. All rights reserved.
  4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  5  *
  6  * This code is free software; you can redistribute it and/or modify it
  7  * under the terms of the GNU General Public License version 2 only, as
  8  * published by the Free Software Foundation.
  9  *
 10  * This code is distributed in the hope that it will be useful, but WITHOUT
 11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 13  * version 2 for more details (a copy is included in the LICENSE file that
 14  * accompanied this code).
 15  *
 16  * You should have received a copy of the GNU General Public License version
 17  * 2 along with this work; if not, write to the Free Software Foundation,
 18  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 19  *
 20  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 21  * or visit www.oracle.com if you need additional information or have any
 22  * questions.
 23  *
 24  */
 25 
 26 #ifndef CPU_AARCH64_INTERP_MASM_AARCH64_HPP
 27 #define CPU_AARCH64_INTERP_MASM_AARCH64_HPP
 28 
 29 #include "asm/macroAssembler.hpp"
 30 #include "interpreter/invocationCounter.hpp"
 31 #include "runtime/frame.hpp"
 32 
 33 // This file specializes the assembler with interpreter-specific macros
 34 
 35 typedef ByteSize (*OffsetFunction)(uint);
 36 
 37 class InterpreterMacroAssembler: public MacroAssembler {
 38  protected:
 39   // Interpreter specific version of call_VM_base
 40   using MacroAssembler::call_VM_leaf_base;
 41 
 42   virtual void call_VM_leaf_base(address entry_point,
 43                                  int number_of_arguments);
 44 
 45   virtual void call_VM_base(Register oop_result,
 46                             Register java_thread,
 47                             Register last_java_sp,
 48                             Label*   return_pc,
 49                             address  entry_point,
 50                             int number_of_arguments,
 51                             bool check_exceptions);
 52 
 53   // base routine for all dispatches
 54   void dispatch_base(TosState state, address* table,
 55                      bool verifyoop = true, bool generate_poll = false);
 56 
 57  public:
 58   InterpreterMacroAssembler(CodeBuffer* code) : MacroAssembler(code) {}
 59 
 60   void load_earlyret_value(TosState state);
 61 
 62   // Use for vthread preemption
 63   void call_VM_preemptable(Register oop_result,
 64                            address entry_point,
 65                            Register arg_1,
 66                            bool check_exceptions = true);
 67   void call_VM_preemptable(Register oop_result,
 68                            address entry_point,
 69                            Register arg_1,
 70                            Register arg_2,
 71                            bool check_exceptions = true);
 72   void restore_after_resume(bool is_native);
 73  private:
 74   void call_VM_preemptable_helper(Register oop_result,
 75                                   address entry_point,
 76                                   int number_of_arguments,
 77                                   bool check_exceptions);
 78 
 79  public:
 80   void jump_to_entry(address entry);
 81 
 82   virtual void check_and_handle_popframe(Register java_thread);
 83   virtual void check_and_handle_earlyret(Register java_thread);
 84 
 85   // Interpreter-specific registers
 86   void save_bcp() {
 87     str(rbcp, Address(rfp, frame::interpreter_frame_bcp_offset * wordSize));
 88   }
 89 
 90   void restore_bcp() {
 91     ldr(rbcp, Address(rfp, frame::interpreter_frame_bcp_offset * wordSize));
 92   }
 93 
 94   void restore_locals() {
 95     ldr(rlocals, Address(rfp, frame::interpreter_frame_locals_offset * wordSize));
 96     lea(rlocals, Address(rfp, rlocals, Address::lsl(3)));
 97   }
 98 
 99   void restore_constant_pool_cache() {
100     ldr(rcpool, Address(rfp, frame::interpreter_frame_cache_offset * wordSize));
101   }
102 
103   void restore_sp_after_call() {
104     Label L;
105     ldr(rscratch1, Address(rfp, frame::interpreter_frame_extended_sp_offset * wordSize));
106     lea(rscratch1, Address(rfp, rscratch1, Address::lsl(LogBytesPerWord)));
107 #ifdef ASSERT
108     cbnz(rscratch1, L);
109     stop("SP is null");
110 #endif
111     bind(L);
112     mov(sp, rscratch1);
113   }
114 
115   void check_extended_sp(const char* msg = "check extended SP") {
116 #ifdef ASSERT
117     Label L;
118     ldr(rscratch1, Address(rfp, frame::interpreter_frame_extended_sp_offset * wordSize));
119     lea(rscratch1, Address(rfp, rscratch1, Address::lsl(LogBytesPerWord)));
120     cmp(sp, rscratch1);
121     br(EQ, L);
122     stop(msg);
123     bind(L);
124 #endif
125   }
126 
127 #define check_extended_sp()                                             \
128   check_extended_sp("SP does not match extended SP in frame at " __FILE__ ":" XSTR(__LINE__))
129 
130   void get_dispatch();
131 
132   // Helpers for runtime call arguments/results
133   void get_method(Register reg) {
134     ldr(reg, Address(rfp, frame::interpreter_frame_method_offset * wordSize));
135   }
136 
137   void get_const(Register reg) {
138     get_method(reg);
139     ldr(reg, Address(reg, in_bytes(Method::const_offset())));
140   }
141 
142   void get_constant_pool(Register reg) {
143     get_const(reg);
144     ldr(reg, Address(reg, in_bytes(ConstMethod::constants_offset())));
145   }
146 
147   void get_constant_pool_cache(Register reg) {
148     get_constant_pool(reg);
149     ldr(reg, Address(reg, ConstantPool::cache_offset()));
150   }
151 
152   void get_cpool_and_tags(Register cpool, Register tags) {
153     get_constant_pool(cpool);
154     ldr(tags, Address(cpool, ConstantPool::tags_offset()));
155   }
156 
157   void get_unsigned_2_byte_index_at_bcp(Register reg, int bcp_offset);
158   void get_cache_index_at_bcp(Register index, int bcp_offset, size_t index_size = sizeof(u2));
159   void get_method_counters(Register method, Register mcs, Label& skip);
160 
161   // Kills t1 and t2, perserves klass, return allocation in new_obj
162   void allocate_instance(Register klass, Register new_obj,
163                          Register t1, Register t2,
164                          bool clear_fields, Label& alloc_failed);
165 
166   // Allocate instance in "obj" and read in the content of the inline field
167   // NOTES:
168   //   - input holder object via "obj", which must be r0,
169   //     will return new instance via the same reg
170   void read_flat_field(Register entry, Register obj);
171 
172   void write_flat_field(Register entry, Register field_offset,
173                         Register tmp1, Register tmp2,
174                         Register obj);
175 
176   // Allocate value buffer in "obj" and read in flat element at the given index
177   // NOTES:
178   //   - Return via "obj" must be r0
179   //   - kills all given regs
180   void read_flat_element(Register array, Register index,
181                          Register t1, Register t2,
182                          Register obj = r0);
183 
184   // load cpool->resolved_references(index);
185   void load_resolved_reference_at_index(Register result, Register index, Register tmp = r5);
186 
187   // load cpool->resolved_klass_at(index);
188   void load_resolved_klass_at_offset(Register cpool, Register index, Register klass, Register temp);
189 
190   void pop_ptr(Register r = r0);
191   void pop_i(Register r = r0);
192   void pop_l(Register r = r0);
193   void pop_f(FloatRegister r = v0);
194   void pop_d(FloatRegister r = v0);
195   void push_ptr(Register r = r0);
196   void push_i(Register r = r0);
197   void push_l(Register r = r0);
198   void push_f(FloatRegister r = v0);
199   void push_d(FloatRegister r = v0);
200 
201   void pop(Register r ) { ((MacroAssembler*)this)->pop(r); }
202 
203   void push(Register r ) { ((MacroAssembler*)this)->push(r); }
204 
205   void pop(TosState state); // transition vtos -> state
206   void push(TosState state); // transition state -> vtos
207 
208   void pop(RegSet regs, Register stack) { ((MacroAssembler*)this)->pop(regs, stack); }
209   void push(RegSet regs, Register stack) { ((MacroAssembler*)this)->push(regs, stack); }
210 
211   void empty_expression_stack() {
212     ldr(rscratch1, Address(rfp, frame::interpreter_frame_monitor_block_top_offset * wordSize));
213     lea(esp, Address(rfp, rscratch1, Address::lsl(LogBytesPerWord)));
214     // null last_sp until next java call
215     str(zr, Address(rfp, frame::interpreter_frame_last_sp_offset * wordSize));
216   }
217 
218   // Helpers for swap and dup
219   void load_ptr(int n, Register val);
220   void store_ptr(int n, Register val);
221 
222   // Load float value from 'address'. The value is loaded onto the FPU register v0.
223   void load_float(Address src);
224   void load_double(Address src);
225 
226   // Generate a subtype check: branch to ok_is_subtype if sub_klass is
227   // a subtype of super_klass.
228   void gen_subtype_check( Register sub_klass, Label &ok_is_subtype, bool profile = true);
229 
230   // Dispatching
231   void dispatch_prolog(TosState state, int step = 0);
232   void dispatch_epilog(TosState state, int step = 0);
233   // dispatch via rscratch1
234   void dispatch_only(TosState state, bool generate_poll = false);
235   // dispatch normal table via rscratch1 (assume rscratch1 is loaded already)
236   void dispatch_only_normal(TosState state);
237   void dispatch_only_noverify(TosState state);
238   // load rscratch1 from [rbcp + step] and dispatch via rscratch1
239   void dispatch_next(TosState state, int step = 0, bool generate_poll = false);
240   // load rscratch1 from [esi] and dispatch via rscratch1 and table
241   void dispatch_via (TosState state, address* table);
242 
243   // jump to an invoked target
244   void prepare_to_jump_from_interpreted();
245   void jump_from_interpreted(Register method, Register temp);
246 
247 
248   // Returning from interpreted functions
249   //
250   // Removes the current activation (incl. unlocking of monitors)
251   // and sets up the return address.  This code is also used for
252   // exception unwindwing. In that case, we do not want to throw
253   // IllegalMonitorStateExceptions, since that might get us into an
254   // infinite rethrow exception loop.
255   // Additionally this code is used for popFrame and earlyReturn.
256   // In popFrame case we want to skip throwing an exception,
257   // installing an exception, and notifying jvmdi.
258   // In earlyReturn case we only want to skip throwing an exception
259   // and installing an exception.
260   void remove_activation(TosState state,
261                          bool throw_monitor_exception = true,
262                          bool install_monitor_exception = true,
263                          bool notify_jvmdi = true);
264 
265   // FIXME: Give us a valid frame at a null check.
266   virtual void null_check(Register reg, int offset = -1) {
267 // #ifdef ASSERT
268 //     save_bcp();
269 //     set_last_Java_frame(esp, rfp, (address) pc());
270 // #endif
271     MacroAssembler::null_check(reg, offset);
272 // #ifdef ASSERT
273 //     reset_last_Java_frame(true);
274 // #endif
275   }
276 
277   // Object locking
278   void lock_object  (Register lock_reg);
279   void unlock_object(Register lock_reg);
280 
281   // Interpreter profiling operations
282   void set_method_data_pointer_for_bcp();
283   void test_method_data_pointer(Register mdp, Label& zero_continue);
284   void verify_method_data_pointer();
285 
286   void set_mdp_data_at(Register mdp_in, int constant, Register value);
287   void increment_mdp_data_at(Register mdp_in, int constant);
288   void increment_mdp_data_at(Register mdp_in, Register index, int constant);
289   void increment_mask_and_jump(Address counter_addr,
290                                int increment, Address mask,
291                                Register scratch, Register scratch2,
292                                bool preloaded, Condition cond,
293                                Label* where);
294   void set_mdp_flag_at(Register mdp_in, int flag_constant);
295   void test_mdp_data_at(Register mdp_in, int offset, Register value,
296                         Register test_value_out,
297                         Label& not_equal_continue);
298 
299   void record_klass_in_profile(Register receiver, Register mdp,
300                                Register reg2);
301   void record_klass_in_profile_helper(Register receiver, Register mdp,
302                                       Register reg2, int start_row,
303                                       Label& done);
304   void record_item_in_profile_helper(Register item, Register mdp,
305                                      Register reg2, int start_row, Label& done, int total_rows,
306                                      OffsetFunction item_offset_fn, OffsetFunction item_count_offset_fn);
307 
308   void update_mdp_by_offset(Register mdp_in, int offset_of_offset);
309   void update_mdp_by_offset(Register mdp_in, Register reg, int offset_of_disp);
310   void update_mdp_by_constant(Register mdp_in, int constant);
311   void update_mdp_for_ret(Register return_bci);
312 
313   // narrow int return value
314   void narrow(Register result);
315 
316   void profile_taken_branch(Register mdp);
317   void profile_not_taken_branch(Register mdp, bool acmp = false);
318   void profile_call(Register mdp);
319   void profile_final_call(Register mdp);
320   void profile_virtual_call(Register receiver, Register mdp,
321                             Register scratch2,
322                             bool receiver_can_be_null = false);
323   void profile_ret(Register return_bci, Register mdp);
324   void profile_null_seen(Register mdp);
325   void profile_typecheck(Register mdp, Register klass, Register scratch);
326   void profile_typecheck_failed(Register mdp);
327   void profile_switch_default(Register mdp);
328   void profile_switch_case(Register index_in_scratch, Register mdp,
329                            Register scratch2);
330   template <class ArrayData> void profile_array_type(Register mdp, Register array, Register tmp);
331   void profile_multiple_element_types(Register mdp, Register element, Register tmp, Register tmp2);
332   void profile_element_type(Register mdp, Register element, Register tmp);
333   void profile_acmp(Register mdp, Register left, Register right, Register tmp);
334 
335   void profile_obj_type(Register obj, const Address& mdo_addr);
336   void profile_arguments_type(Register mdp, Register callee, Register tmp, bool is_virtual);
337   void profile_return_type(Register mdp, Register ret, Register tmp);
338   void profile_parameters_type(Register mdp, Register tmp1, Register tmp2);
339 
340   // Debugging
341   // only if +VerifyOops && state == atos
342 #define interp_verify_oop(reg, state) _interp_verify_oop(reg, state, __FILE__, __LINE__);
343   void _interp_verify_oop(Register reg, TosState state, const char* file, int line);
344 
345   typedef enum { NotifyJVMTI, SkipNotifyJVMTI } NotifyMethodExitMode;
346 
347   // support for jvmti/dtrace
348   void notify_method_entry();
349   void notify_method_exit(TosState state, NotifyMethodExitMode mode);
350 
351   JFR_ONLY(void enter_jfr_critical_section();)
352   JFR_ONLY(void leave_jfr_critical_section();)
353 
354   virtual void _call_Unimplemented(address call_site) {
355     save_bcp();
356     set_last_Java_frame(esp, rfp, (address) pc(), rscratch1);
357     MacroAssembler::_call_Unimplemented(call_site);
358   }
359 
360   void load_resolved_indy_entry(Register cache, Register index);
361   void load_field_entry(Register cache, Register index, int bcp_offset = 1);
362   void load_method_entry(Register cache, Register index, int bcp_offset = 1);
363 
364   void verify_field_offset(Register reg) NOT_DEBUG_RETURN;
365 };
366 
367 #endif // CPU_AARCH64_INTERP_MASM_AARCH64_HPP