1 /*
   2  * Copyright (c) 2008, 2015, 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 #include "precompiled.hpp"
  26 #include "asm/macroAssembler.hpp"
  27 #include "classfile/javaClasses.inline.hpp"
  28 #include "interpreter/interpreter.hpp"
  29 #include "interpreter/interp_masm.hpp"
  30 #include "memory/allocation.inline.hpp"
  31 #include "prims/methodHandles.hpp"
  32 
  33 #define __ _masm->
  34 
  35 #ifdef PRODUCT
  36 #define BLOCK_COMMENT(str) /* nothing */
  37 #define STOP(error) stop(error)
  38 #else
  39 #define BLOCK_COMMENT(str) __ block_comment(str)
  40 #define STOP(error) block_comment(error); __ stop(error)
  41 #endif
  42 
  43 #define BIND(label) bind(label); BLOCK_COMMENT(#label ":")
  44 
  45 // Workaround for C++ overloading nastiness on '0' for RegisterOrConstant.
  46 static RegisterOrConstant constant(int value) {
  47   return RegisterOrConstant(value);
  48 }
  49 
  50 void MethodHandles::load_klass_from_Class(MacroAssembler* _masm, Register klass_reg, Register temp_reg, Register temp2_reg) {
  51   if (VerifyMethodHandles)
  52     verify_klass(_masm, klass_reg, SystemDictionary::WK_KLASS_ENUM_NAME(java_lang_Class), temp_reg, temp2_reg,
  53                  "MH argument is a Class");
  54   __ ld_ptr(Address(klass_reg, java_lang_Class::klass_offset_in_bytes()), klass_reg);
  55 }
  56 
  57 #ifdef ASSERT
  58 static int check_nonzero(const char* xname, int x) {
  59   assert(x != 0, "%s should be nonzero", xname);
  60   return x;
  61 }
  62 #define NONZERO(x) check_nonzero(#x, x)
  63 #else //ASSERT
  64 #define NONZERO(x) (x)
  65 #endif //ASSERT
  66 
  67 #ifdef ASSERT
  68 void MethodHandles::verify_klass(MacroAssembler* _masm,
  69                                  Register obj_reg, SystemDictionary::WKID klass_id,
  70                                  Register temp_reg, Register temp2_reg,
  71                                  const char* error_message) {
  72   Klass** klass_addr = SystemDictionary::well_known_klass_addr(klass_id);
  73   KlassHandle klass = SystemDictionary::well_known_klass(klass_id);
  74   bool did_save = false;
  75   if (temp_reg == noreg || temp2_reg == noreg) {
  76     temp_reg = L1;
  77     temp2_reg = L2;
  78     __ save_frame_and_mov(0, obj_reg, L0);
  79     obj_reg = L0;
  80     did_save = true;
  81   }
  82   Label L_ok, L_bad;
  83   BLOCK_COMMENT("verify_klass {");
  84   __ verify_oop(obj_reg);
  85   __ br_null_short(obj_reg, Assembler::pn, L_bad);
  86   __ load_klass(obj_reg, temp_reg);
  87   __ set(ExternalAddress((Metadata**)klass_addr), temp2_reg);
  88   __ ld_ptr(Address(temp2_reg, 0), temp2_reg);
  89   __ cmp_and_brx_short(temp_reg, temp2_reg, Assembler::equal, Assembler::pt, L_ok);
  90   intptr_t super_check_offset = klass->super_check_offset();
  91   __ ld_ptr(Address(temp_reg, super_check_offset), temp_reg);
  92   __ set(ExternalAddress((Metadata**)klass_addr), temp2_reg);
  93   __ ld_ptr(Address(temp2_reg, 0), temp2_reg);
  94   __ cmp_and_brx_short(temp_reg, temp2_reg, Assembler::equal, Assembler::pt, L_ok);
  95   __ BIND(L_bad);
  96   if (did_save)  __ restore();
  97   __ STOP(error_message);
  98   __ BIND(L_ok);
  99   if (did_save)  __ restore();
 100   BLOCK_COMMENT("} verify_klass");
 101 }
 102 
 103 void MethodHandles::verify_ref_kind(MacroAssembler* _masm, int ref_kind, Register member_reg, Register temp) {
 104   Label L;
 105   BLOCK_COMMENT("verify_ref_kind {");
 106   __ lduw(Address(member_reg, NONZERO(java_lang_invoke_MemberName::flags_offset_in_bytes())), temp);
 107   __ srl( temp, java_lang_invoke_MemberName::MN_REFERENCE_KIND_SHIFT, temp);
 108   __ and3(temp, java_lang_invoke_MemberName::MN_REFERENCE_KIND_MASK,  temp);
 109   __ cmp_and_br_short(temp, ref_kind, Assembler::equal, Assembler::pt, L);
 110   { char* buf = NEW_C_HEAP_ARRAY(char, 100, mtInternal);
 111     jio_snprintf(buf, 100, "verify_ref_kind expected %x", ref_kind);
 112     if (ref_kind == JVM_REF_invokeVirtual ||
 113         ref_kind == JVM_REF_invokeSpecial)
 114       // could do this for all ref_kinds, but would explode assembly code size
 115       trace_method_handle(_masm, buf);
 116     __ STOP(buf);
 117   }
 118   BLOCK_COMMENT("} verify_ref_kind");
 119   __ bind(L);
 120 }
 121 
 122 #endif // ASSERT
 123 
 124 void MethodHandles::jump_from_method_handle(MacroAssembler* _masm, Register method, Register target, Register temp,
 125                                             bool for_compiler_entry) {
 126   Label L_no_such_method;
 127   assert(method == G5_method, "interpreter calling convention");
 128   assert_different_registers(method, target, temp);
 129 
 130   if (!for_compiler_entry && JvmtiExport::can_post_interpreter_events()) {
 131     Label run_compiled_code;
 132     // JVMTI events, such as single-stepping, are implemented partly by avoiding running
 133     // compiled code in threads for which the event is enabled.  Check here for
 134     // interp_only_mode if these events CAN be enabled.
 135     __ verify_thread();
 136     const Address interp_only(G2_thread, JavaThread::interp_only_mode_offset());
 137     __ ld(interp_only, temp);
 138     __ cmp_and_br_short(temp, 0, Assembler::zero, Assembler::pt, run_compiled_code);
 139     // Null method test is replicated below in compiled case,
 140     // it might be able to address across the verify_thread()
 141     __ br_null_short(G5_method, Assembler::pn, L_no_such_method);
 142     __ ld_ptr(G5_method, in_bytes(Method::interpreter_entry_offset()), target);
 143     __ jmp(target, 0);
 144     __ delayed()->nop();
 145     __ BIND(run_compiled_code);
 146     // Note: we could fill some delay slots here, but
 147     // it doesn't matter, since this is interpreter code.
 148   }
 149 
 150   // Compiled case, either static or fall-through from runtime conditional
 151   __ br_null_short(G5_method, Assembler::pn, L_no_such_method);
 152 
 153   const ByteSize entry_offset = for_compiler_entry ? Method::from_compiled_offset() :
 154                                                      Method::from_interpreted_offset();
 155   __ ld_ptr(G5_method, in_bytes(entry_offset), target);
 156   __ jmp(target, 0);
 157   __ delayed()->nop();
 158 
 159   __ bind(L_no_such_method);
 160   AddressLiteral ame(StubRoutines::throw_AbstractMethodError_entry());
 161   __ jump_to(ame, temp);
 162   __ delayed()->nop();
 163 }
 164 
 165 void MethodHandles::jump_to_lambda_form(MacroAssembler* _masm,
 166                                         Register recv, Register method_temp,
 167                                         Register temp2, Register temp3,
 168                                         bool for_compiler_entry) {
 169   BLOCK_COMMENT("jump_to_lambda_form {");
 170   // This is the initial entry point of a lazy method handle.
 171   // After type checking, it picks up the invoker from the LambdaForm.
 172   assert_different_registers(recv, method_temp, temp2);  // temp3 is only passed on
 173   assert(method_temp == G5_method, "required register for loading method");
 174 
 175   //NOT_PRODUCT({ FlagSetting fs(TraceMethodHandles, true); trace_method_handle(_masm, "LZMH"); });
 176 
 177   // Load the invoker, as MH -> MH.form -> LF.vmentry
 178   __ verify_oop(recv);
 179   __ load_heap_oop(Address(recv,        NONZERO(java_lang_invoke_MethodHandle::form_offset_in_bytes())),   method_temp);
 180   __ verify_oop(method_temp);
 181   __ load_heap_oop(Address(method_temp, NONZERO(java_lang_invoke_LambdaForm::vmentry_offset_in_bytes())),  method_temp);
 182   __ verify_oop(method_temp);
 183   // the following assumes that a Method* is normally compressed in the vmtarget field:
 184   __ ld_ptr(       Address(method_temp, NONZERO(java_lang_invoke_MemberName::vmtarget_offset_in_bytes())), method_temp);
 185 
 186   if (VerifyMethodHandles && !for_compiler_entry) {
 187     // make sure recv is already on stack
 188     __ ld_ptr(method_temp, in_bytes(Method::const_offset()), temp2);
 189     __ load_sized_value(Address(temp2, ConstMethod::size_of_parameters_offset()),
 190                         temp2,
 191                         sizeof(u2), /*is_signed*/ false);
 192     // assert(sizeof(u2) == sizeof(Method::_size_of_parameters), "");
 193     Label L;
 194     __ ld_ptr(__ argument_address(temp2, temp2, -1), temp2);
 195     __ cmp_and_br_short(temp2, recv, Assembler::equal, Assembler::pt, L);
 196     __ STOP("receiver not on stack");
 197     __ BIND(L);
 198   }
 199 
 200   jump_from_method_handle(_masm, method_temp, temp2, temp3, for_compiler_entry);
 201   BLOCK_COMMENT("} jump_to_lambda_form");
 202 }
 203 
 204 
 205 // Code generation
 206 address MethodHandles::generate_method_handle_interpreter_entry(MacroAssembler* _masm,
 207                                                                 vmIntrinsics::ID iid) {
 208   const bool not_for_compiler_entry = false;  // this is the interpreter entry
 209   assert(is_signature_polymorphic(iid), "expected invoke iid");
 210   if (iid == vmIntrinsics::_invokeGeneric ||
 211       iid == vmIntrinsics::_compiledLambdaForm) {
 212     // Perhaps surprisingly, the symbolic references visible to Java are not directly used.
 213     // They are linked to Java-generated adapters via MethodHandleNatives.linkMethod.
 214     // They all allow an appendix argument.
 215     __ should_not_reach_here();           // empty stubs make SG sick
 216     return NULL;
 217   }
 218 
 219   // I5_savedSP/O5_savedSP: sender SP (must preserve; see prepare_to_jump_from_interpreted)
 220   // G5_method:  Method*
 221   // G4 (Gargs): incoming argument list (must preserve)
 222   // O0: used as temp to hold mh or receiver
 223   // O1, O4: garbage temps, blown away
 224   Register O1_scratch    = O1;
 225   Register O4_param_size = O4;   // size of parameters
 226 
 227   // here's where control starts out:
 228   __ align(CodeEntryAlignment);
 229   address entry_point = __ pc();
 230 
 231   if (VerifyMethodHandles) {
 232     assert(Method::intrinsic_id_size_in_bytes() == 2, "assuming Method::_intrinsic_id is u2");
 233 
 234     Label L;
 235     BLOCK_COMMENT("verify_intrinsic_id {");
 236     __ lduh(Address(G5_method, Method::intrinsic_id_offset_in_bytes()), O1_scratch);
 237     __ cmp_and_br_short(O1_scratch, (int) iid, Assembler::equal, Assembler::pt, L);
 238     if (iid == vmIntrinsics::_linkToVirtual ||
 239         iid == vmIntrinsics::_linkToSpecial) {
 240       // could do this for all kinds, but would explode assembly code size
 241       trace_method_handle(_masm, "bad Method*::intrinsic_id");
 242     }
 243     __ STOP("bad Method*::intrinsic_id");
 244     __ bind(L);
 245     BLOCK_COMMENT("} verify_intrinsic_id");
 246   }
 247 
 248   // First task:  Find out how big the argument list is.
 249   Address O4_first_arg_addr;
 250   int ref_kind = signature_polymorphic_intrinsic_ref_kind(iid);
 251   assert(ref_kind != 0 || iid == vmIntrinsics::_invokeBasic, "must be _invokeBasic or a linkTo intrinsic");
 252   if (ref_kind == 0 || MethodHandles::ref_kind_has_receiver(ref_kind)) {
 253     __ ld_ptr(G5_method, in_bytes(Method::const_offset()), O4_param_size);
 254     __ load_sized_value(Address(O4_param_size, ConstMethod::size_of_parameters_offset()),
 255                         O4_param_size,
 256                         sizeof(u2), /*is_signed*/ false);
 257     // assert(sizeof(u2) == sizeof(Method::_size_of_parameters), "");
 258     O4_first_arg_addr = __ argument_address(O4_param_size, O4_param_size, -1);
 259   } else {
 260     DEBUG_ONLY(O4_param_size = noreg);
 261   }
 262 
 263   Register O0_mh = noreg;
 264   if (!is_signature_polymorphic_static(iid)) {
 265     __ ld_ptr(O4_first_arg_addr, O0_mh = O0);
 266     DEBUG_ONLY(O4_param_size = noreg);
 267   }
 268 
 269   // O4_first_arg_addr is live!
 270 
 271   if (TraceMethodHandles) {
 272     if (O0_mh != noreg)
 273       __ mov(O0_mh, G3_method_handle);  // make stub happy
 274     trace_method_handle_interpreter_entry(_masm, iid);
 275   }
 276 
 277   if (iid == vmIntrinsics::_invokeBasic) {
 278     generate_method_handle_dispatch(_masm, iid, O0_mh, noreg, not_for_compiler_entry);
 279 
 280   } else {
 281     // Adjust argument list by popping the trailing MemberName argument.
 282     Register O0_recv = noreg;
 283     if (MethodHandles::ref_kind_has_receiver(ref_kind)) {
 284       // Load the receiver (not the MH; the actual MemberName's receiver) up from the interpreter stack.
 285       __ ld_ptr(O4_first_arg_addr, O0_recv = O0);
 286       DEBUG_ONLY(O4_param_size = noreg);
 287     }
 288     Register G5_member = G5_method;  // MemberName ptr; incoming method ptr is dead now
 289     __ ld_ptr(__ argument_address(constant(0)), G5_member);
 290     __ add(Gargs, Interpreter::stackElementSize, Gargs);
 291     generate_method_handle_dispatch(_masm, iid, O0_recv, G5_member, not_for_compiler_entry);
 292   }
 293 
 294   return entry_point;
 295 }
 296 
 297 void MethodHandles::generate_method_handle_dispatch(MacroAssembler* _masm,
 298                                                     vmIntrinsics::ID iid,
 299                                                     Register receiver_reg,
 300                                                     Register member_reg,
 301                                                     bool for_compiler_entry) {
 302   assert(is_signature_polymorphic(iid), "expected invoke iid");
 303   Register temp1 = (for_compiler_entry ? G1_scratch : O1);
 304   Register temp2 = (for_compiler_entry ? G3_scratch : O2);
 305   Register temp3 = (for_compiler_entry ? G4_scratch : O3);
 306   Register temp4 = (for_compiler_entry ? noreg      : O4);
 307   if (for_compiler_entry) {
 308     assert(receiver_reg == (iid == vmIntrinsics::_linkToStatic ? noreg : O0), "only valid assignment");
 309     assert_different_registers(temp1, O0, O1, O2, O3, O4, O5);
 310     assert_different_registers(temp2, O0, O1, O2, O3, O4, O5);
 311     assert_different_registers(temp3, O0, O1, O2, O3, O4, O5);
 312     assert_different_registers(temp4, O0, O1, O2, O3, O4, O5);
 313   } else {
 314     assert_different_registers(temp1, temp2, temp3, temp4, O5_savedSP);  // don't trash lastSP
 315   }
 316   if (receiver_reg != noreg)  assert_different_registers(temp1, temp2, temp3, temp4, receiver_reg);
 317   if (member_reg   != noreg)  assert_different_registers(temp1, temp2, temp3, temp4, member_reg);
 318 
 319   if (iid == vmIntrinsics::_invokeBasic) {
 320     // indirect through MH.form.vmentry.vmtarget
 321     jump_to_lambda_form(_masm, receiver_reg, G5_method, temp1, temp2, for_compiler_entry);
 322 
 323   } else {
 324     // The method is a member invoker used by direct method handles.
 325     if (VerifyMethodHandles) {
 326       // make sure the trailing argument really is a MemberName (caller responsibility)
 327       verify_klass(_masm, member_reg, SystemDictionary::WK_KLASS_ENUM_NAME(MemberName_klass),
 328                    temp1, temp2,
 329                    "MemberName required for invokeVirtual etc.");
 330     }
 331 
 332     Address member_clazz(    member_reg, NONZERO(java_lang_invoke_MemberName::clazz_offset_in_bytes()));
 333     Address member_vmindex(  member_reg, NONZERO(java_lang_invoke_MemberName::vmindex_offset_in_bytes()));
 334     Address member_vmtarget( member_reg, NONZERO(java_lang_invoke_MemberName::vmtarget_offset_in_bytes()));
 335 
 336     Register temp1_recv_klass = temp1;
 337     if (iid != vmIntrinsics::_linkToStatic) {
 338       __ verify_oop(receiver_reg);
 339       if (iid == vmIntrinsics::_linkToSpecial) {
 340         // Don't actually load the klass; just null-check the receiver.
 341         __ null_check(receiver_reg);
 342       } else {
 343         // load receiver klass itself
 344         __ null_check(receiver_reg, oopDesc::klass_offset_in_bytes());
 345         __ load_klass(receiver_reg, temp1_recv_klass);
 346         __ verify_klass_ptr(temp1_recv_klass);
 347       }
 348       BLOCK_COMMENT("check_receiver {");
 349       // The receiver for the MemberName must be in receiver_reg.
 350       // Check the receiver against the MemberName.clazz
 351       if (VerifyMethodHandles && iid == vmIntrinsics::_linkToSpecial) {
 352         // Did not load it above...
 353         __ load_klass(receiver_reg, temp1_recv_klass);
 354         __ verify_klass_ptr(temp1_recv_klass);
 355       }
 356       if (VerifyMethodHandles && iid != vmIntrinsics::_linkToInterface) {
 357         Label L_ok;
 358         Register temp2_defc = temp2;
 359         __ load_heap_oop(member_clazz, temp2_defc);
 360         load_klass_from_Class(_masm, temp2_defc, temp3, temp4);
 361         __ verify_klass_ptr(temp2_defc);
 362         __ check_klass_subtype(temp1_recv_klass, temp2_defc, temp3, temp4, L_ok);
 363         // If we get here, the type check failed!
 364         __ STOP("receiver class disagrees with MemberName.clazz");
 365         __ bind(L_ok);
 366       }
 367       BLOCK_COMMENT("} check_receiver");
 368     }
 369     if (iid == vmIntrinsics::_linkToSpecial ||
 370         iid == vmIntrinsics::_linkToStatic) {
 371       DEBUG_ONLY(temp1_recv_klass = noreg);  // these guys didn't load the recv_klass
 372     }
 373 
 374     // Live registers at this point:
 375     //  member_reg - MemberName that was the trailing argument
 376     //  temp1_recv_klass - klass of stacked receiver, if needed
 377     //  O5_savedSP - interpreter linkage (if interpreted)
 378     //  O0..O5 - compiler arguments (if compiled)
 379 
 380     Label L_incompatible_class_change_error;
 381     switch (iid) {
 382     case vmIntrinsics::_linkToSpecial:
 383       if (VerifyMethodHandles) {
 384         verify_ref_kind(_masm, JVM_REF_invokeSpecial, member_reg, temp2);
 385       }
 386       __ ld_ptr(member_vmtarget, G5_method);
 387       break;
 388 
 389     case vmIntrinsics::_linkToStatic:
 390       if (VerifyMethodHandles) {
 391         verify_ref_kind(_masm, JVM_REF_invokeStatic, member_reg, temp2);
 392       }
 393       __ ld_ptr(member_vmtarget, G5_method);
 394       break;
 395 
 396     case vmIntrinsics::_linkToVirtual:
 397     {
 398       // same as TemplateTable::invokevirtual,
 399       // minus the CP setup and profiling:
 400 
 401       if (VerifyMethodHandles) {
 402         verify_ref_kind(_masm, JVM_REF_invokeVirtual, member_reg, temp2);
 403       }
 404 
 405       // pick out the vtable index from the MemberName, and then we can discard it:
 406       Register temp2_index = temp2;
 407       __ ld_ptr(member_vmindex, temp2_index);
 408 
 409       if (VerifyMethodHandles) {
 410         Label L_index_ok;
 411         __ cmp_and_br_short(temp2_index, (int) 0, Assembler::greaterEqual, Assembler::pn, L_index_ok);
 412         __ STOP("no virtual index");
 413         __ BIND(L_index_ok);
 414       }
 415 
 416       // Note:  The verifier invariants allow us to ignore MemberName.clazz and vmtarget
 417       // at this point.  And VerifyMethodHandles has already checked clazz, if needed.
 418 
 419       // get target Method* & entry point
 420       __ lookup_virtual_method(temp1_recv_klass, temp2_index, G5_method);
 421       break;
 422     }
 423 
 424     case vmIntrinsics::_linkToInterface:
 425     {
 426       // same as TemplateTable::invokeinterface
 427       // (minus the CP setup and profiling, with different argument motion)
 428       if (VerifyMethodHandles) {
 429         verify_ref_kind(_masm, JVM_REF_invokeInterface, member_reg, temp2);
 430       }
 431 
 432       Register temp2_intf = temp2;
 433       __ load_heap_oop(member_clazz, temp2_intf);
 434       load_klass_from_Class(_masm, temp2_intf, temp3, temp4);
 435       __ verify_klass_ptr(temp2_intf);
 436 
 437       Register G5_index = G5_method;
 438       __ ld_ptr(member_vmindex, G5_index);
 439       if (VerifyMethodHandles) {
 440         Label L;
 441         __ cmp_and_br_short(G5_index, 0, Assembler::greaterEqual, Assembler::pt, L);
 442         __ STOP("invalid vtable index for MH.invokeInterface");
 443         __ bind(L);
 444       }
 445 
 446       // given intf, index, and recv klass, dispatch to the implementation method
 447       __ lookup_interface_method(temp1_recv_klass, temp2_intf,
 448                                  // note: next two args must be the same:
 449                                  G5_index, G5_method,
 450                                  temp3, temp4,
 451                                  L_incompatible_class_change_error);
 452       break;
 453     }
 454 
 455     default:
 456       fatal("unexpected intrinsic %d: %s", iid, vmIntrinsics::name_at(iid));
 457       break;
 458     }
 459 
 460     // Live at this point:
 461     //   G5_method
 462     //   O5_savedSP (if interpreted)
 463 
 464     // After figuring out which concrete method to call, jump into it.
 465     // Note that this works in the interpreter with no data motion.
 466     // But the compiled version will require that rcx_recv be shifted out.
 467     __ verify_method_ptr(G5_method);
 468     jump_from_method_handle(_masm, G5_method, temp1, temp2, for_compiler_entry);
 469 
 470     if (iid == vmIntrinsics::_linkToInterface) {
 471       __ BIND(L_incompatible_class_change_error);
 472       AddressLiteral icce(StubRoutines::throw_IncompatibleClassChangeError_entry());
 473       __ jump_to(icce, temp1);
 474       __ delayed()->nop();
 475     }
 476   }
 477 }
 478 
 479 #ifndef PRODUCT
 480 void trace_method_handle_stub(const char* adaptername,
 481                               oopDesc* mh,
 482                               intptr_t* saved_sp,
 483                               intptr_t* args,
 484                               intptr_t* tracing_fp) {
 485   bool has_mh = (strstr(adaptername, "/static") == NULL &&
 486                  strstr(adaptername, "linkTo") == NULL);    // static linkers don't have MH
 487   const char* mh_reg_name = has_mh ? "G3_mh" : "G3";
 488   tty->print_cr("MH %s %s=" INTPTR_FORMAT " saved_sp=" INTPTR_FORMAT " args=" INTPTR_FORMAT,
 489                 adaptername, mh_reg_name,
 490                 p2i(mh), p2i(saved_sp), p2i(args));
 491 
 492   if (Verbose) {
 493     // dumping last frame with frame::describe
 494 
 495     JavaThread* p = JavaThread::active();
 496 
 497     ResourceMark rm;
 498     PRESERVE_EXCEPTION_MARK; // may not be needed by safer and unexpensive here
 499     FrameValues values;
 500 
 501     // Note: We want to allow trace_method_handle from any call site.
 502     // While trace_method_handle creates a frame, it may be entered
 503     // without a valid return PC in O7 (e.g. not just after a call).
 504     // Walking that frame could lead to failures due to that invalid PC.
 505     // => carefully detect that frame when doing the stack walking
 506 
 507     // walk up to the right frame using the "tracing_fp" argument
 508     intptr_t* cur_sp = StubRoutines::Sparc::flush_callers_register_windows_func()();
 509     frame cur_frame(cur_sp, frame::unpatchable, NULL);
 510 
 511     while (cur_frame.fp() != (intptr_t *)(STACK_BIAS+(uintptr_t)tracing_fp)) {
 512       cur_frame = os::get_sender_for_C_frame(&cur_frame);
 513     }
 514 
 515     // safely create a frame and call frame::describe
 516     intptr_t *dump_sp = cur_frame.sender_sp();
 517     intptr_t *dump_fp = cur_frame.link();
 518 
 519     bool walkable = has_mh; // whether the traced frame shoud be walkable
 520 
 521     // the sender for cur_frame is the caller of trace_method_handle
 522     if (walkable) {
 523       // The previous definition of walkable may have to be refined
 524       // if new call sites cause the next frame constructor to start
 525       // failing. Alternatively, frame constructors could be
 526       // modified to support the current or future non walkable
 527       // frames (but this is more intrusive and is not considered as
 528       // part of this RFE, which will instead use a simpler output).
 529       frame dump_frame = frame(dump_sp,
 530                                cur_frame.sp(), // younger_sp
 531                                false); // no adaptation
 532       dump_frame.describe(values, 1);
 533     } else {
 534       // Robust dump for frames which cannot be constructed from sp/younger_sp
 535       // Add descriptions without building a Java frame to avoid issues
 536       values.describe(-1, dump_fp, "fp for #1 <not parsed, cannot trust pc>");
 537       values.describe(-1, dump_sp, "sp");
 538     }
 539 
 540     bool has_args = has_mh; // whether Gargs is meaningful
 541 
 542     // mark args, if seems valid (may not be valid for some adapters)
 543     if (has_args) {
 544       if ((args >= dump_sp) && (args < dump_fp)) {
 545         values.describe(-1, args, "*G4_args");
 546       }
 547     }
 548 
 549     // mark saved_sp, if seems valid (may not be valid for some adapters)
 550     intptr_t *unbiased_sp = (intptr_t *)(STACK_BIAS+(uintptr_t)saved_sp);
 551     const int ARG_LIMIT = 255, SLOP = 45, UNREASONABLE_STACK_MOVE = (ARG_LIMIT + SLOP);
 552     if ((unbiased_sp >= dump_sp - UNREASONABLE_STACK_MOVE) && (unbiased_sp < dump_fp)) {
 553       values.describe(-1, unbiased_sp, "*saved_sp+STACK_BIAS");
 554     }
 555 
 556     // Note: the unextended_sp may not be correct
 557     tty->print_cr("  stack layout:");
 558     values.print(p);
 559     if (has_mh && mh->is_oop()) {
 560       mh->print();
 561       if (java_lang_invoke_MethodHandle::is_instance(mh)) {
 562         if (java_lang_invoke_MethodHandle::form_offset_in_bytes() != 0)
 563           java_lang_invoke_MethodHandle::form(mh)->print();
 564       }
 565     }
 566   }
 567 }
 568 
 569 void MethodHandles::trace_method_handle(MacroAssembler* _masm, const char* adaptername) {
 570   if (!TraceMethodHandles)  return;
 571   BLOCK_COMMENT("trace_method_handle {");
 572   // save: Gargs, O5_savedSP
 573   __ save_frame(16); // need space for saving required FPU state
 574 
 575   __ set((intptr_t) adaptername, O0);
 576   __ mov(G3_method_handle, O1);
 577   __ mov(I5_savedSP, O2);
 578   __ mov(Gargs, O3);
 579   __ mov(I6, O4); // frame identifier for safe stack walking
 580 
 581   // Save scratched registers that might be needed. Robustness is more
 582   // important than optimizing the saves for this debug only code.
 583 
 584   // save FP result, valid at some call sites (adapter_opt_return_float, ...)
 585   Address d_save(FP, -sizeof(jdouble) + STACK_BIAS);
 586   __ stf(FloatRegisterImpl::D, Ftos_d, d_save);
 587   // Safely save all globals but G2 (handled by call_VM_leaf) and G7
 588   // (OS reserved).
 589   __ mov(G3_method_handle, L3);
 590   __ mov(Gargs, L4);
 591   __ mov(G5_method_type, L5);
 592   __ mov(G6, L6);
 593   __ mov(G1, L1);
 594 
 595   __ call_VM_leaf(L2 /* for G2 */, CAST_FROM_FN_PTR(address, trace_method_handle_stub));
 596 
 597   __ mov(L3, G3_method_handle);
 598   __ mov(L4, Gargs);
 599   __ mov(L5, G5_method_type);
 600   __ mov(L6, G6);
 601   __ mov(L1, G1);
 602   __ ldf(FloatRegisterImpl::D, d_save, Ftos_d);
 603 
 604   __ restore();
 605   BLOCK_COMMENT("} trace_method_handle");
 606 }
 607 #endif // PRODUCT