1 /*
   2  * Copyright 1997-2010 Sun Microsystems, Inc.  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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  20  * CA 95054 USA or visit www.sun.com if you need additional information or
  21  * have any questions.
  22  *
  23  */
  24 
  25 // StubRoutines provides entry points to assembly routines used by
  26 // compiled code and the run-time system. Platform-specific entry
  27 // points are defined in the platform-specific inner class.
  28 //
  29 // Class scheme:
  30 //
  31 //    platform-independent               platform-dependent
  32 //
  33 //    stubRoutines.hpp  <-- included --  stubRoutines_<arch>.hpp
  34 //           ^                                  ^
  35 //           |                                  |
  36 //       implements                         implements
  37 //           |                                  |
  38 //           |                                  |
  39 //    stubRoutines.cpp                   stubRoutines_<arch>.cpp
  40 //    stubRoutines_<os_family>.cpp       stubGenerator_<arch>.cpp
  41 //    stubRoutines_<os_arch>.cpp
  42 //
  43 // Note 1: The important thing is a clean decoupling between stub
  44 //         entry points (interfacing to the whole vm; i.e., 1-to-n
  45 //         relationship) and stub generators (interfacing only to
  46 //         the entry points implementation; i.e., 1-to-1 relationship).
  47 //         This significantly simplifies changes in the generator
  48 //         structure since the rest of the vm is not affected.
  49 //
  50 // Note 2: stubGenerator_<arch>.cpp contains a minimal portion of
  51 //         machine-independent code; namely the generator calls of
  52 //         the generator functions that are used platform-independently.
  53 //         However, it comes with the advantage of having a 1-file
  54 //         implementation of the generator. It should be fairly easy
  55 //         to change, should it become a problem later.
  56 //
  57 // Scheme for adding a new entry point:
  58 //
  59 // 1. determine if it's a platform-dependent or independent entry point
  60 //    a) if platform independent: make subsequent changes in the independent files
  61 //    b) if platform   dependent: make subsequent changes in the   dependent files
  62 // 2. add a private instance variable holding the entry point address
  63 // 3. add a public accessor function to the instance variable
  64 // 4. implement the corresponding generator function in the platform-dependent
  65 //    stubGenerator_<arch>.cpp file and call the function in generate_all() of that file
  66 
  67 
  68 class StubRoutines: AllStatic {
  69 
  70  public:
  71   enum platform_independent_constants {
  72     max_size_of_parameters = 256                           // max. parameter size supported by megamorphic lookups
  73   };
  74 
  75   // Dependencies
  76   friend class StubGenerator;
  77   #include "incls/_stubRoutines_pd.hpp.incl"               // machine-specific parts
  78 
  79   static jint    _verify_oop_count;
  80   static address _verify_oop_subroutine_entry;
  81 
  82   static address _call_stub_return_address;                // the return PC, when returning to a call stub
  83   static address _call_stub_entry;
  84   static address _forward_exception_entry;
  85   static address _catch_exception_entry;
  86   static address _throw_AbstractMethodError_entry;
  87   static address _throw_IncompatibleClassChangeError_entry;
  88   static address _throw_ArithmeticException_entry;
  89   static address _throw_NullPointerException_entry;
  90   static address _throw_NullPointerException_at_call_entry;
  91   static address _throw_StackOverflowError_entry;
  92   static address _handler_for_unsafe_access_entry;
  93 
  94   static address _atomic_xchg_entry;
  95   static address _atomic_xchg_ptr_entry;
  96   static address _atomic_store_entry;
  97   static address _atomic_store_ptr_entry;
  98   static address _atomic_cmpxchg_entry;
  99   static address _atomic_cmpxchg_ptr_entry;
 100   static address _atomic_cmpxchg_long_entry;
 101   static address _atomic_add_entry;
 102   static address _atomic_add_ptr_entry;
 103   static address _fence_entry;
 104   static address _d2i_wrapper;
 105   static address _d2l_wrapper;
 106 
 107   static jint    _fpu_cntrl_wrd_std;
 108   static jint    _fpu_cntrl_wrd_24;
 109   static jint    _fpu_cntrl_wrd_64;
 110   static jint    _fpu_cntrl_wrd_trunc;
 111   static jint    _mxcsr_std;
 112   static jint    _fpu_subnormal_bias1[3];
 113   static jint    _fpu_subnormal_bias2[3];
 114 
 115   static BufferBlob* _code1;                               // code buffer for initial routines
 116   static BufferBlob* _code2;                               // code buffer for all other routines
 117 
 118   // Leaf routines which implement arraycopy and their addresses
 119   // arraycopy operands aligned on element type boundary
 120   static address _jbyte_arraycopy;
 121   static address _jshort_arraycopy;
 122   static address _jint_arraycopy;
 123   static address _jlong_arraycopy;
 124   static address _oop_arraycopy;
 125   static address _jbyte_disjoint_arraycopy;
 126   static address _jshort_disjoint_arraycopy;
 127   static address _jint_disjoint_arraycopy;
 128   static address _jlong_disjoint_arraycopy;
 129   static address _oop_disjoint_arraycopy;
 130 
 131   // arraycopy operands aligned on zero'th element boundary
 132   // These are identical to the ones aligned aligned on an
 133   // element type boundary, except that they assume that both
 134   // source and destination are HeapWord aligned.
 135   static address _arrayof_jbyte_arraycopy;
 136   static address _arrayof_jshort_arraycopy;
 137   static address _arrayof_jint_arraycopy;
 138   static address _arrayof_jlong_arraycopy;
 139   static address _arrayof_oop_arraycopy;
 140   static address _arrayof_jbyte_disjoint_arraycopy;
 141   static address _arrayof_jshort_disjoint_arraycopy;
 142   static address _arrayof_jint_disjoint_arraycopy;
 143   static address _arrayof_jlong_disjoint_arraycopy;
 144   static address _arrayof_oop_disjoint_arraycopy;
 145 
 146   // these are recommended but optional:
 147   static address _checkcast_arraycopy;
 148   static address _unsafe_arraycopy;
 149   static address _generic_arraycopy;
 150 
 151   // These are versions of the java.lang.Math methods which perform
 152   // the same operations as the intrinsic version.  They are used for
 153   // constant folding in the compiler to ensure equivalence.  If the
 154   // intrinsic version returns the same result as the strict version
 155   // then they can be set to the appropriate function from
 156   // SharedRuntime.
 157   static double (*_intrinsic_log)(double);
 158   static double (*_intrinsic_log10)(double);
 159   static double (*_intrinsic_exp)(double);
 160   static double (*_intrinsic_pow)(double, double);
 161   static double (*_intrinsic_sin)(double);
 162   static double (*_intrinsic_cos)(double);
 163   static double (*_intrinsic_tan)(double);
 164 
 165  public:
 166   // Initialization/Testing
 167   static void    initialize1();                            // must happen before universe::genesis
 168   static void    initialize2();                            // must happen after  universe::genesis
 169 
 170   static bool contains(address addr) {
 171     return
 172       (_code1 != NULL && _code1->blob_contains(addr)) ||
 173       (_code2 != NULL && _code2->blob_contains(addr)) ;
 174   }
 175 
 176   // Debugging
 177   static jint    verify_oop_count()                        { return _verify_oop_count; }
 178   static jint*   verify_oop_count_addr()                   { return &_verify_oop_count; }
 179   // a subroutine for debugging the GC
 180   static address verify_oop_subroutine_entry_address()    { return (address)&_verify_oop_subroutine_entry; }
 181 
 182   static address catch_exception_entry()                   { return _catch_exception_entry; }
 183 
 184   // Calls to Java
 185   typedef void (*CallStub)(
 186     address   link,
 187     intptr_t* result,
 188     BasicType result_type,
 189     methodOopDesc* method,
 190     address   entry_point,
 191     intptr_t* parameters,
 192     int       size_of_parameters,
 193     TRAPS
 194   );
 195 
 196   static CallStub call_stub()                              { return CAST_TO_FN_PTR(CallStub, _call_stub_entry); }
 197 
 198   // Exceptions
 199   static address forward_exception_entry()                 { return _forward_exception_entry; }
 200   // Implicit exceptions
 201   static address throw_AbstractMethodError_entry()         { return _throw_AbstractMethodError_entry; }
 202   static address throw_IncompatibleClassChangeError_entry(){ return _throw_IncompatibleClassChangeError_entry; }
 203   static address throw_ArithmeticException_entry()         { return _throw_ArithmeticException_entry; }
 204   static address throw_NullPointerException_entry()        { return _throw_NullPointerException_entry; }
 205   static address throw_NullPointerException_at_call_entry(){ return _throw_NullPointerException_at_call_entry; }
 206   static address throw_StackOverflowError_entry()          { return _throw_StackOverflowError_entry; }
 207 
 208   // Exceptions during unsafe access - should throw Java exception rather
 209   // than crash.
 210   static address handler_for_unsafe_access()               { return _handler_for_unsafe_access_entry; }
 211 
 212   static address atomic_xchg_entry()                       { return _atomic_xchg_entry; }
 213   static address atomic_xchg_ptr_entry()                   { return _atomic_xchg_ptr_entry; }
 214   static address atomic_store_entry()                      { return _atomic_store_entry; }
 215   static address atomic_store_ptr_entry()                  { return _atomic_store_ptr_entry; }
 216   static address atomic_cmpxchg_entry()                    { return _atomic_cmpxchg_entry; }
 217   static address atomic_cmpxchg_ptr_entry()                { return _atomic_cmpxchg_ptr_entry; }
 218   static address atomic_cmpxchg_long_entry()               { return _atomic_cmpxchg_long_entry; }
 219   static address atomic_add_entry()                        { return _atomic_add_entry; }
 220   static address atomic_add_ptr_entry()                    { return _atomic_add_ptr_entry; }
 221   static address fence_entry()                             { return _fence_entry; }
 222 
 223   static address d2i_wrapper()                             { return _d2i_wrapper; }
 224   static address d2l_wrapper()                             { return _d2l_wrapper; }
 225   static jint    fpu_cntrl_wrd_std()                       { return _fpu_cntrl_wrd_std;   }
 226   static address addr_fpu_cntrl_wrd_std()                  { return (address)&_fpu_cntrl_wrd_std;   }
 227   static address addr_fpu_cntrl_wrd_24()                   { return (address)&_fpu_cntrl_wrd_24;   }
 228   static address addr_fpu_cntrl_wrd_64()                   { return (address)&_fpu_cntrl_wrd_64;   }
 229   static address addr_fpu_cntrl_wrd_trunc()                { return (address)&_fpu_cntrl_wrd_trunc; }
 230   static address addr_mxcsr_std()                          { return (address)&_mxcsr_std; }
 231   static address addr_fpu_subnormal_bias1()                { return (address)&_fpu_subnormal_bias1; }
 232   static address addr_fpu_subnormal_bias2()                { return (address)&_fpu_subnormal_bias2; }
 233 
 234 
 235   static address jbyte_arraycopy()  { return _jbyte_arraycopy; }
 236   static address jshort_arraycopy() { return _jshort_arraycopy; }
 237   static address jint_arraycopy()   { return _jint_arraycopy; }
 238   static address jlong_arraycopy()  { return _jlong_arraycopy; }
 239   static address oop_arraycopy()    { return _oop_arraycopy; }
 240   static address jbyte_disjoint_arraycopy()  { return _jbyte_disjoint_arraycopy; }
 241   static address jshort_disjoint_arraycopy() { return _jshort_disjoint_arraycopy; }
 242   static address jint_disjoint_arraycopy()   { return _jint_disjoint_arraycopy; }
 243   static address jlong_disjoint_arraycopy()  { return _jlong_disjoint_arraycopy; }
 244   static address oop_disjoint_arraycopy()    { return _oop_disjoint_arraycopy; }
 245 
 246   static address arrayof_jbyte_arraycopy()  { return _arrayof_jbyte_arraycopy; }
 247   static address arrayof_jshort_arraycopy() { return _arrayof_jshort_arraycopy; }
 248   static address arrayof_jint_arraycopy()   { return _arrayof_jint_arraycopy; }
 249   static address arrayof_jlong_arraycopy()  { return _arrayof_jlong_arraycopy; }
 250   static address arrayof_oop_arraycopy()    { return _arrayof_oop_arraycopy; }
 251 
 252   static address arrayof_jbyte_disjoint_arraycopy()  { return _arrayof_jbyte_disjoint_arraycopy; }
 253   static address arrayof_jshort_disjoint_arraycopy() { return _arrayof_jshort_disjoint_arraycopy; }
 254   static address arrayof_jint_disjoint_arraycopy()   { return _arrayof_jint_disjoint_arraycopy; }
 255   static address arrayof_jlong_disjoint_arraycopy()  { return _arrayof_jlong_disjoint_arraycopy; }
 256   static address arrayof_oop_disjoint_arraycopy()    { return _arrayof_oop_disjoint_arraycopy; }
 257 
 258   static address checkcast_arraycopy()     { return _checkcast_arraycopy; }
 259   static address unsafe_arraycopy()        { return _unsafe_arraycopy; }
 260   static address generic_arraycopy()       { return _generic_arraycopy; }
 261 
 262   static double  intrinsic_log(double d) {
 263     assert(_intrinsic_log != NULL, "must be defined");
 264     return _intrinsic_log(d);
 265   }
 266   static double  intrinsic_log10(double d) {
 267     assert(_intrinsic_log != NULL, "must be defined");
 268     return _intrinsic_log10(d);
 269   }
 270   static double  intrinsic_exp(double d) {
 271     assert(_intrinsic_exp != NULL, "must be defined");
 272     return _intrinsic_exp(d);
 273   }
 274   static double  intrinsic_pow(double d, double d2) {
 275     assert(_intrinsic_pow != NULL, "must be defined");
 276     return _intrinsic_pow(d, d2);
 277   }
 278   static double  intrinsic_sin(double d) {
 279     assert(_intrinsic_sin != NULL, "must be defined");
 280     return _intrinsic_sin(d);
 281   }
 282   static double  intrinsic_cos(double d) {
 283     assert(_intrinsic_cos != NULL, "must be defined");
 284     return _intrinsic_cos(d);
 285   }
 286   static double  intrinsic_tan(double d) {
 287     assert(_intrinsic_tan != NULL, "must be defined");
 288     return _intrinsic_tan(d);
 289   }
 290 
 291   //
 292   // Default versions of the above arraycopy functions for platforms which do
 293   // not have specialized versions
 294   //
 295   static void jbyte_copy (jbyte*  src, jbyte*  dest, size_t count);
 296   static void jshort_copy(jshort* src, jshort* dest, size_t count);
 297   static void jint_copy  (jint*   src, jint*   dest, size_t count);
 298   static void jlong_copy (jlong*  src, jlong*  dest, size_t count);
 299   static void oop_copy   (oop*    src, oop*    dest, size_t count);
 300 
 301   static void arrayof_jbyte_copy (HeapWord* src, HeapWord* dest, size_t count);
 302   static void arrayof_jshort_copy(HeapWord* src, HeapWord* dest, size_t count);
 303   static void arrayof_jint_copy  (HeapWord* src, HeapWord* dest, size_t count);
 304   static void arrayof_jlong_copy (HeapWord* src, HeapWord* dest, size_t count);
 305   static void arrayof_oop_copy   (HeapWord* src, HeapWord* dest, size_t count);
 306 };