1 /*
   2  * Copyright (c) 1998, 2017, 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 "classfile/vmSymbols.hpp"
  27 #include "logging/log.hpp"
  28 #include "memory/metaspaceShared.hpp"
  29 #include "memory/padded.hpp"
  30 #include "memory/resourceArea.hpp"
  31 #include "oops/markOop.hpp"
  32 #include "oops/oop.inline.hpp"
  33 #include "runtime/atomic.hpp"
  34 #include "runtime/biasedLocking.hpp"
  35 #include "runtime/handles.inline.hpp"
  36 #include "runtime/interfaceSupport.hpp"
  37 #include "runtime/mutexLocker.hpp"
  38 #include "runtime/objectMonitor.hpp"
  39 #include "runtime/objectMonitor.inline.hpp"
  40 #include "runtime/osThread.hpp"
  41 #include "runtime/stubRoutines.hpp"
  42 #include "runtime/synchronizer.hpp"
  43 #include "runtime/thread.inline.hpp"
  44 #include "runtime/vframe.hpp"
  45 #include "trace/traceMacros.hpp"
  46 #include "trace/tracing.hpp"
  47 #include "utilities/dtrace.hpp"
  48 #include "utilities/events.hpp"
  49 #include "utilities/preserveException.hpp"
  50 
  51 // The "core" versions of monitor enter and exit reside in this file.
  52 // The interpreter and compilers contain specialized transliterated
  53 // variants of the enter-exit fast-path operations.  See i486.ad fast_lock(),
  54 // for instance.  If you make changes here, make sure to modify the
  55 // interpreter, and both C1 and C2 fast-path inline locking code emission.
  56 //
  57 // -----------------------------------------------------------------------------
  58 
  59 #ifdef DTRACE_ENABLED
  60 
  61 // Only bother with this argument setup if dtrace is available
  62 // TODO-FIXME: probes should not fire when caller is _blocked.  assert() accordingly.
  63 
  64 #define DTRACE_MONITOR_PROBE_COMMON(obj, thread)                           \
  65   char* bytes = NULL;                                                      \
  66   int len = 0;                                                             \
  67   jlong jtid = SharedRuntime::get_java_tid(thread);                        \
  68   Symbol* klassname = ((oop)(obj))->klass()->name();                       \
  69   if (klassname != NULL) {                                                 \
  70     bytes = (char*)klassname->bytes();                                     \
  71     len = klassname->utf8_length();                                        \
  72   }
  73 
  74 #define DTRACE_MONITOR_WAIT_PROBE(monitor, obj, thread, millis)            \
  75   {                                                                        \
  76     if (DTraceMonitorProbes) {                                             \
  77       DTRACE_MONITOR_PROBE_COMMON(obj, thread);                            \
  78       HOTSPOT_MONITOR_WAIT(jtid,                                           \
  79                            (uintptr_t)(monitor), bytes, len, (millis));    \
  80     }                                                                      \
  81   }
  82 
  83 #define HOTSPOT_MONITOR_PROBE_notify HOTSPOT_MONITOR_NOTIFY
  84 #define HOTSPOT_MONITOR_PROBE_notifyAll HOTSPOT_MONITOR_NOTIFYALL
  85 #define HOTSPOT_MONITOR_PROBE_waited HOTSPOT_MONITOR_WAITED
  86 
  87 #define DTRACE_MONITOR_PROBE(probe, monitor, obj, thread)                  \
  88   {                                                                        \
  89     if (DTraceMonitorProbes) {                                             \
  90       DTRACE_MONITOR_PROBE_COMMON(obj, thread);                            \
  91       HOTSPOT_MONITOR_PROBE_##probe(jtid, /* probe = waited */             \
  92                                     (uintptr_t)(monitor), bytes, len);     \
  93     }                                                                      \
  94   }
  95 
  96 #else //  ndef DTRACE_ENABLED
  97 
  98 #define DTRACE_MONITOR_WAIT_PROBE(obj, thread, millis, mon)    {;}
  99 #define DTRACE_MONITOR_PROBE(probe, obj, thread, mon)          {;}
 100 
 101 #endif // ndef DTRACE_ENABLED
 102 
 103 // This exists only as a workaround of dtrace bug 6254741
 104 int dtrace_waited_probe(ObjectMonitor* monitor, Handle obj, Thread* thr) {
 105   DTRACE_MONITOR_PROBE(waited, monitor, obj(), thr);
 106   return 0;
 107 }
 108 
 109 #define NINFLATIONLOCKS 256
 110 static volatile intptr_t gInflationLocks[NINFLATIONLOCKS];
 111 
 112 // global list of blocks of monitors
 113 // gBlockList is really PaddedEnd<ObjectMonitor> *, but we don't
 114 // want to expose the PaddedEnd template more than necessary.
 115 ObjectMonitor * volatile ObjectSynchronizer::gBlockList = NULL;
 116 // global monitor free list
 117 ObjectMonitor * volatile ObjectSynchronizer::gFreeList  = NULL;
 118 // global monitor in-use list, for moribund threads,
 119 // monitors they inflated need to be scanned for deflation
 120 ObjectMonitor * volatile ObjectSynchronizer::gOmInUseList  = NULL;
 121 // count of entries in gOmInUseList
 122 int ObjectSynchronizer::gOmInUseCount = 0;
 123 
 124 static volatile intptr_t gListLock = 0;      // protects global monitor lists
 125 static volatile int gMonitorFreeCount  = 0;  // # on gFreeList
 126 static volatile int gMonitorPopulation = 0;  // # Extant -- in circulation
 127 
 128 static void post_monitor_inflate_event(EventJavaMonitorInflate&,
 129                                        const oop,
 130                                        const ObjectSynchronizer::InflateCause);
 131 
 132 #define CHAINMARKER (cast_to_oop<intptr_t>(-1))
 133 
 134 
 135 // =====================> Quick functions
 136 
 137 // The quick_* forms are special fast-path variants used to improve
 138 // performance.  In the simplest case, a "quick_*" implementation could
 139 // simply return false, in which case the caller will perform the necessary
 140 // state transitions and call the slow-path form.
 141 // The fast-path is designed to handle frequently arising cases in an efficient
 142 // manner and is just a degenerate "optimistic" variant of the slow-path.
 143 // returns true  -- to indicate the call was satisfied.
 144 // returns false -- to indicate the call needs the services of the slow-path.
 145 // A no-loitering ordinance is in effect for code in the quick_* family
 146 // operators: safepoints or indefinite blocking (blocking that might span a
 147 // safepoint) are forbidden. Generally the thread_state() is _in_Java upon
 148 // entry.
 149 //
 150 // Consider: An interesting optimization is to have the JIT recognize the
 151 // following common idiom:
 152 //   synchronized (someobj) { .... ; notify(); }
 153 // That is, we find a notify() or notifyAll() call that immediately precedes
 154 // the monitorexit operation.  In that case the JIT could fuse the operations
 155 // into a single notifyAndExit() runtime primitive.
 156 
 157 bool ObjectSynchronizer::quick_notify(oopDesc * obj, Thread * self, bool all) {
 158   assert(!SafepointSynchronize::is_at_safepoint(), "invariant");
 159   assert(self->is_Java_thread(), "invariant");
 160   assert(((JavaThread *) self)->thread_state() == _thread_in_Java, "invariant");
 161   NoSafepointVerifier nsv;
 162   if (obj == NULL) return false;  // slow-path for invalid obj
 163   const markOop mark = obj->mark();
 164 
 165   if (mark->has_locker() && self->is_lock_owned((address)mark->locker())) {
 166     // Degenerate notify
 167     // stack-locked by caller so by definition the implied waitset is empty.
 168     return true;
 169   }
 170 
 171   if (mark->has_monitor()) {
 172     ObjectMonitor * const mon = mark->monitor();
 173     assert(mon->object() == obj, "invariant");
 174     if (mon->owner() != self) return false;  // slow-path for IMS exception
 175 
 176     if (mon->first_waiter() != NULL) {
 177       // We have one or more waiters. Since this is an inflated monitor
 178       // that we own, we can transfer one or more threads from the waitset
 179       // to the entrylist here and now, avoiding the slow-path.
 180       if (all) {
 181         DTRACE_MONITOR_PROBE(notifyAll, mon, obj, self);
 182       } else {
 183         DTRACE_MONITOR_PROBE(notify, mon, obj, self);
 184       }
 185       int tally = 0;
 186       do {
 187         mon->INotify(self);
 188         ++tally;
 189       } while (mon->first_waiter() != NULL && all);
 190       OM_PERFDATA_OP(Notifications, inc(tally));
 191     }
 192     return true;
 193   }
 194 
 195   // biased locking and any other IMS exception states take the slow-path
 196   return false;
 197 }
 198 
 199 
 200 // The LockNode emitted directly at the synchronization site would have
 201 // been too big if it were to have included support for the cases of inflated
 202 // recursive enter and exit, so they go here instead.
 203 // Note that we can't safely call AsyncPrintJavaStack() from within
 204 // quick_enter() as our thread state remains _in_Java.
 205 
 206 bool ObjectSynchronizer::quick_enter(oop obj, Thread * Self,
 207                                      BasicLock * lock) {
 208   assert(!SafepointSynchronize::is_at_safepoint(), "invariant");
 209   assert(Self->is_Java_thread(), "invariant");
 210   assert(((JavaThread *) Self)->thread_state() == _thread_in_Java, "invariant");
 211   NoSafepointVerifier nsv;
 212   if (obj == NULL) return false;       // Need to throw NPE
 213   const markOop mark = obj->mark();
 214 
 215   if (mark->has_monitor()) {
 216     ObjectMonitor * const m = mark->monitor();
 217     assert(m->object() == obj, "invariant");
 218     Thread * const owner = (Thread *) m->_owner;
 219 
 220     // Lock contention and Transactional Lock Elision (TLE) diagnostics
 221     // and observability
 222     // Case: light contention possibly amenable to TLE
 223     // Case: TLE inimical operations such as nested/recursive synchronization
 224 
 225     if (owner == Self) {
 226       m->_recursions++;
 227       return true;
 228     }
 229 
 230     // This Java Monitor is inflated so obj's header will never be
 231     // displaced to this thread's BasicLock. Make the displaced header
 232     // non-NULL so this BasicLock is not seen as recursive nor as
 233     // being locked. We do this unconditionally so that this thread's
 234     // BasicLock cannot be mis-interpreted by any stack walkers. For
 235     // performance reasons, stack walkers generally first check for
 236     // Biased Locking in the object's header, the second check is for
 237     // stack-locking in the object's header, the third check is for
 238     // recursive stack-locking in the displaced header in the BasicLock,
 239     // and last are the inflated Java Monitor (ObjectMonitor) checks.
 240     lock->set_displaced_header(markOopDesc::unused_mark());
 241 
 242     if (owner == NULL &&
 243         Atomic::cmpxchg_ptr(Self, &(m->_owner), NULL) == NULL) {
 244       assert(m->_recursions == 0, "invariant");
 245       assert(m->_owner == Self, "invariant");
 246       return true;
 247     }
 248   }
 249 
 250   // Note that we could inflate in quick_enter.
 251   // This is likely a useful optimization
 252   // Critically, in quick_enter() we must not:
 253   // -- perform bias revocation, or
 254   // -- block indefinitely, or
 255   // -- reach a safepoint
 256 
 257   return false;        // revert to slow-path
 258 }
 259 
 260 // -----------------------------------------------------------------------------
 261 //  Fast Monitor Enter/Exit
 262 // This the fast monitor enter. The interpreter and compiler use
 263 // some assembly copies of this code. Make sure update those code
 264 // if the following function is changed. The implementation is
 265 // extremely sensitive to race condition. Be careful.
 266 
 267 void ObjectSynchronizer::fast_enter(Handle obj, BasicLock* lock,
 268                                     bool attempt_rebias, TRAPS) {
 269   if (UseBiasedLocking) {
 270     if (!SafepointSynchronize::is_at_safepoint()) {
 271       BiasedLocking::Condition cond = BiasedLocking::revoke_and_rebias(obj, attempt_rebias, THREAD);
 272       if (cond == BiasedLocking::BIAS_REVOKED_AND_REBIASED) {
 273         return;
 274       }
 275     } else {
 276       assert(!attempt_rebias, "can not rebias toward VM thread");
 277       BiasedLocking::revoke_at_safepoint(obj);
 278     }
 279     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 280   }
 281 
 282   slow_enter(obj, lock, THREAD);
 283 }
 284 
 285 void ObjectSynchronizer::fast_exit(oop object, BasicLock* lock, TRAPS) {
 286   markOop mark = object->mark();
 287   // We cannot check for Biased Locking if we are racing an inflation.
 288   assert(mark == markOopDesc::INFLATING() ||
 289          !mark->has_bias_pattern(), "should not see bias pattern here");
 290 
 291   markOop dhw = lock->displaced_header();
 292   if (dhw == NULL) {
 293     // If the displaced header is NULL, then this exit matches up with
 294     // a recursive enter. No real work to do here except for diagnostics.
 295 #ifndef PRODUCT
 296     if (mark != markOopDesc::INFLATING()) {
 297       // Only do diagnostics if we are not racing an inflation. Simply
 298       // exiting a recursive enter of a Java Monitor that is being
 299       // inflated is safe; see the has_monitor() comment below.
 300       assert(!mark->is_neutral(), "invariant");
 301       assert(!mark->has_locker() ||
 302              THREAD->is_lock_owned((address)mark->locker()), "invariant");
 303       if (mark->has_monitor()) {
 304         // The BasicLock's displaced_header is marked as a recursive
 305         // enter and we have an inflated Java Monitor (ObjectMonitor).
 306         // This is a special case where the Java Monitor was inflated
 307         // after this thread entered the stack-lock recursively. When a
 308         // Java Monitor is inflated, we cannot safely walk the Java
 309         // Monitor owner's stack and update the BasicLocks because a
 310         // Java Monitor can be asynchronously inflated by a thread that
 311         // does not own the Java Monitor.
 312         ObjectMonitor * m = mark->monitor();
 313         assert(((oop)(m->object()))->mark() == mark, "invariant");
 314         assert(m->is_entered(THREAD), "invariant");
 315       }
 316     }
 317 #endif
 318     return;
 319   }
 320 
 321   if (mark == (markOop) lock) {
 322     // If the object is stack-locked by the current thread, try to
 323     // swing the displaced header from the BasicLock back to the mark.
 324     assert(dhw->is_neutral(), "invariant");
 325     if ((markOop) Atomic::cmpxchg_ptr(dhw, object->mark_addr(), mark) == mark) {
 326       TEVENT(fast_exit: release stack-lock);
 327       return;
 328     }
 329   }
 330 
 331   // We have to take the slow-path of possible inflation and then exit.
 332   ObjectSynchronizer::inflate(THREAD,
 333                               object,
 334                               inflate_cause_vm_internal)->exit(true, THREAD);
 335 }
 336 
 337 // -----------------------------------------------------------------------------
 338 // Interpreter/Compiler Slow Case
 339 // This routine is used to handle interpreter/compiler slow case
 340 // We don't need to use fast path here, because it must have been
 341 // failed in the interpreter/compiler code.
 342 void ObjectSynchronizer::slow_enter(Handle obj, BasicLock* lock, TRAPS) {
 343   markOop mark = obj->mark();
 344   assert(!mark->has_bias_pattern(), "should not see bias pattern here");
 345 
 346   if (mark->is_neutral()) {
 347     // Anticipate successful CAS -- the ST of the displaced mark must
 348     // be visible <= the ST performed by the CAS.
 349     lock->set_displaced_header(mark);
 350     if (mark == (markOop) Atomic::cmpxchg_ptr(lock, obj()->mark_addr(), mark)) {
 351       TEVENT(slow_enter: release stacklock);
 352       return;
 353     }
 354     // Fall through to inflate() ...
 355   } else if (mark->has_locker() &&
 356              THREAD->is_lock_owned((address)mark->locker())) {
 357     assert(lock != mark->locker(), "must not re-lock the same lock");
 358     assert(lock != (BasicLock*)obj->mark(), "don't relock with same BasicLock");
 359     lock->set_displaced_header(NULL);
 360     return;
 361   }
 362 
 363   // The object header will never be displaced to this lock,
 364   // so it does not matter what the value is, except that it
 365   // must be non-zero to avoid looking like a re-entrant lock,
 366   // and must not look locked either.
 367   lock->set_displaced_header(markOopDesc::unused_mark());
 368   ObjectSynchronizer::inflate(THREAD,
 369                               obj(),
 370                               inflate_cause_monitor_enter)->enter(THREAD);
 371 }
 372 
 373 // This routine is used to handle interpreter/compiler slow case
 374 // We don't need to use fast path here, because it must have
 375 // failed in the interpreter/compiler code. Simply use the heavy
 376 // weight monitor should be ok, unless someone find otherwise.
 377 void ObjectSynchronizer::slow_exit(oop object, BasicLock* lock, TRAPS) {
 378   fast_exit(object, lock, THREAD);
 379 }
 380 
 381 // -----------------------------------------------------------------------------
 382 // Class Loader  support to workaround deadlocks on the class loader lock objects
 383 // Also used by GC
 384 // complete_exit()/reenter() are used to wait on a nested lock
 385 // i.e. to give up an outer lock completely and then re-enter
 386 // Used when holding nested locks - lock acquisition order: lock1 then lock2
 387 //  1) complete_exit lock1 - saving recursion count
 388 //  2) wait on lock2
 389 //  3) when notified on lock2, unlock lock2
 390 //  4) reenter lock1 with original recursion count
 391 //  5) lock lock2
 392 // NOTE: must use heavy weight monitor to handle complete_exit/reenter()
 393 intptr_t ObjectSynchronizer::complete_exit(Handle obj, TRAPS) {
 394   TEVENT(complete_exit);
 395   if (UseBiasedLocking) {
 396     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 397     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 398   }
 399 
 400   ObjectMonitor* monitor = ObjectSynchronizer::inflate(THREAD,
 401                                                        obj(),
 402                                                        inflate_cause_vm_internal);
 403 
 404   return monitor->complete_exit(THREAD);
 405 }
 406 
 407 // NOTE: must use heavy weight monitor to handle complete_exit/reenter()
 408 void ObjectSynchronizer::reenter(Handle obj, intptr_t recursion, TRAPS) {
 409   TEVENT(reenter);
 410   if (UseBiasedLocking) {
 411     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 412     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 413   }
 414 
 415   ObjectMonitor* monitor = ObjectSynchronizer::inflate(THREAD,
 416                                                        obj(),
 417                                                        inflate_cause_vm_internal);
 418 
 419   monitor->reenter(recursion, THREAD);
 420 }
 421 // -----------------------------------------------------------------------------
 422 // JNI locks on java objects
 423 // NOTE: must use heavy weight monitor to handle jni monitor enter
 424 void ObjectSynchronizer::jni_enter(Handle obj, TRAPS) {
 425   // the current locking is from JNI instead of Java code
 426   TEVENT(jni_enter);
 427   if (UseBiasedLocking) {
 428     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 429     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 430   }
 431   THREAD->set_current_pending_monitor_is_from_java(false);
 432   ObjectSynchronizer::inflate(THREAD, obj(), inflate_cause_jni_enter)->enter(THREAD);
 433   THREAD->set_current_pending_monitor_is_from_java(true);
 434 }
 435 
 436 // NOTE: must use heavy weight monitor to handle jni monitor exit
 437 void ObjectSynchronizer::jni_exit(oop obj, Thread* THREAD) {
 438   TEVENT(jni_exit);
 439   if (UseBiasedLocking) {
 440     Handle h_obj(THREAD, obj);
 441     BiasedLocking::revoke_and_rebias(h_obj, false, THREAD);
 442     obj = h_obj();
 443   }
 444   assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 445 
 446   ObjectMonitor* monitor = ObjectSynchronizer::inflate(THREAD,
 447                                                        obj,
 448                                                        inflate_cause_jni_exit);
 449   // If this thread has locked the object, exit the monitor.  Note:  can't use
 450   // monitor->check(CHECK); must exit even if an exception is pending.
 451   if (monitor->check(THREAD)) {
 452     monitor->exit(true, THREAD);
 453   }
 454 }
 455 
 456 // -----------------------------------------------------------------------------
 457 // Internal VM locks on java objects
 458 // standard constructor, allows locking failures
 459 ObjectLocker::ObjectLocker(Handle obj, Thread* thread, bool doLock) {
 460   _dolock = doLock;
 461   _thread = thread;
 462   debug_only(if (StrictSafepointChecks) _thread->check_for_valid_safepoint_state(false);)
 463   _obj = obj;
 464 
 465   if (_dolock) {
 466     TEVENT(ObjectLocker);
 467 
 468     ObjectSynchronizer::fast_enter(_obj, &_lock, false, _thread);
 469   }
 470 }
 471 
 472 ObjectLocker::~ObjectLocker() {
 473   if (_dolock) {
 474     ObjectSynchronizer::fast_exit(_obj(), &_lock, _thread);
 475   }
 476 }
 477 
 478 
 479 // -----------------------------------------------------------------------------
 480 //  Wait/Notify/NotifyAll
 481 // NOTE: must use heavy weight monitor to handle wait()
 482 int ObjectSynchronizer::wait(Handle obj, jlong millis, TRAPS) {
 483   if (UseBiasedLocking) {
 484     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 485     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 486   }
 487   if (millis < 0) {
 488     TEVENT(wait - throw IAX);
 489     THROW_MSG_0(vmSymbols::java_lang_IllegalArgumentException(), "timeout value is negative");
 490   }
 491   ObjectMonitor* monitor = ObjectSynchronizer::inflate(THREAD,
 492                                                        obj(),
 493                                                        inflate_cause_wait);
 494 
 495   DTRACE_MONITOR_WAIT_PROBE(monitor, obj(), THREAD, millis);
 496   monitor->wait(millis, true, THREAD);
 497 
 498   // This dummy call is in place to get around dtrace bug 6254741.  Once
 499   // that's fixed we can uncomment the following line, remove the call
 500   // and change this function back into a "void" func.
 501   // DTRACE_MONITOR_PROBE(waited, monitor, obj(), THREAD);
 502   return dtrace_waited_probe(monitor, obj, THREAD);
 503 }
 504 
 505 void ObjectSynchronizer::waitUninterruptibly(Handle obj, jlong millis, TRAPS) {
 506   if (UseBiasedLocking) {
 507     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 508     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 509   }
 510   if (millis < 0) {
 511     TEVENT(wait - throw IAX);
 512     THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(), "timeout value is negative");
 513   }
 514   ObjectSynchronizer::inflate(THREAD,
 515                               obj(),
 516                               inflate_cause_wait)->wait(millis, false, THREAD);
 517 }
 518 
 519 void ObjectSynchronizer::notify(Handle obj, TRAPS) {
 520   if (UseBiasedLocking) {
 521     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 522     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 523   }
 524 
 525   markOop mark = obj->mark();
 526   if (mark->has_locker() && THREAD->is_lock_owned((address)mark->locker())) {
 527     return;
 528   }
 529   ObjectSynchronizer::inflate(THREAD,
 530                               obj(),
 531                               inflate_cause_notify)->notify(THREAD);
 532 }
 533 
 534 // NOTE: see comment of notify()
 535 void ObjectSynchronizer::notifyall(Handle obj, TRAPS) {
 536   if (UseBiasedLocking) {
 537     BiasedLocking::revoke_and_rebias(obj, false, THREAD);
 538     assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 539   }
 540 
 541   markOop mark = obj->mark();
 542   if (mark->has_locker() && THREAD->is_lock_owned((address)mark->locker())) {
 543     return;
 544   }
 545   ObjectSynchronizer::inflate(THREAD,
 546                               obj(),
 547                               inflate_cause_notify)->notifyAll(THREAD);
 548 }
 549 
 550 // -----------------------------------------------------------------------------
 551 // Hash Code handling
 552 //
 553 // Performance concern:
 554 // OrderAccess::storestore() calls release() which at one time stored 0
 555 // into the global volatile OrderAccess::dummy variable. This store was
 556 // unnecessary for correctness. Many threads storing into a common location
 557 // causes considerable cache migration or "sloshing" on large SMP systems.
 558 // As such, I avoided using OrderAccess::storestore(). In some cases
 559 // OrderAccess::fence() -- which incurs local latency on the executing
 560 // processor -- is a better choice as it scales on SMP systems.
 561 //
 562 // See http://blogs.oracle.com/dave/entry/biased_locking_in_hotspot for
 563 // a discussion of coherency costs. Note that all our current reference
 564 // platforms provide strong ST-ST order, so the issue is moot on IA32,
 565 // x64, and SPARC.
 566 //
 567 // As a general policy we use "volatile" to control compiler-based reordering
 568 // and explicit fences (barriers) to control for architectural reordering
 569 // performed by the CPU(s) or platform.
 570 
 571 struct SharedGlobals {
 572   char         _pad_prefix[DEFAULT_CACHE_LINE_SIZE];
 573   // These are highly shared mostly-read variables.
 574   // To avoid false-sharing they need to be the sole occupants of a cache line.
 575   volatile int stwRandom;
 576   volatile int stwCycle;
 577   DEFINE_PAD_MINUS_SIZE(1, DEFAULT_CACHE_LINE_SIZE, sizeof(volatile int) * 2);
 578   // Hot RW variable -- Sequester to avoid false-sharing
 579   volatile int hcSequence;
 580   DEFINE_PAD_MINUS_SIZE(2, DEFAULT_CACHE_LINE_SIZE, sizeof(volatile int));
 581 };
 582 
 583 static SharedGlobals GVars;
 584 static int MonitorScavengeThreshold = 1000000;
 585 static volatile int ForceMonitorScavenge = 0; // Scavenge required and pending
 586 
 587 static markOop ReadStableMark(oop obj) {
 588   markOop mark = obj->mark();
 589   if (!mark->is_being_inflated()) {
 590     return mark;       // normal fast-path return
 591   }
 592 
 593   int its = 0;
 594   for (;;) {
 595     markOop mark = obj->mark();
 596     if (!mark->is_being_inflated()) {
 597       return mark;    // normal fast-path return
 598     }
 599 
 600     // The object is being inflated by some other thread.
 601     // The caller of ReadStableMark() must wait for inflation to complete.
 602     // Avoid live-lock
 603     // TODO: consider calling SafepointSynchronize::do_call_back() while
 604     // spinning to see if there's a safepoint pending.  If so, immediately
 605     // yielding or blocking would be appropriate.  Avoid spinning while
 606     // there is a safepoint pending.
 607     // TODO: add inflation contention performance counters.
 608     // TODO: restrict the aggregate number of spinners.
 609 
 610     ++its;
 611     if (its > 10000 || !os::is_MP()) {
 612       if (its & 1) {
 613         os::naked_yield();
 614         TEVENT(Inflate: INFLATING - yield);
 615       } else {
 616         // Note that the following code attenuates the livelock problem but is not
 617         // a complete remedy.  A more complete solution would require that the inflating
 618         // thread hold the associated inflation lock.  The following code simply restricts
 619         // the number of spinners to at most one.  We'll have N-2 threads blocked
 620         // on the inflationlock, 1 thread holding the inflation lock and using
 621         // a yield/park strategy, and 1 thread in the midst of inflation.
 622         // A more refined approach would be to change the encoding of INFLATING
 623         // to allow encapsulation of a native thread pointer.  Threads waiting for
 624         // inflation to complete would use CAS to push themselves onto a singly linked
 625         // list rooted at the markword.  Once enqueued, they'd loop, checking a per-thread flag
 626         // and calling park().  When inflation was complete the thread that accomplished inflation
 627         // would detach the list and set the markword to inflated with a single CAS and
 628         // then for each thread on the list, set the flag and unpark() the thread.
 629         // This is conceptually similar to muxAcquire-muxRelease, except that muxRelease
 630         // wakes at most one thread whereas we need to wake the entire list.
 631         int ix = (cast_from_oop<intptr_t>(obj) >> 5) & (NINFLATIONLOCKS-1);
 632         int YieldThenBlock = 0;
 633         assert(ix >= 0 && ix < NINFLATIONLOCKS, "invariant");
 634         assert((NINFLATIONLOCKS & (NINFLATIONLOCKS-1)) == 0, "invariant");
 635         Thread::muxAcquire(gInflationLocks + ix, "gInflationLock");
 636         while (obj->mark() == markOopDesc::INFLATING()) {
 637           // Beware: NakedYield() is advisory and has almost no effect on some platforms
 638           // so we periodically call Self->_ParkEvent->park(1).
 639           // We use a mixed spin/yield/block mechanism.
 640           if ((YieldThenBlock++) >= 16) {
 641             Thread::current()->_ParkEvent->park(1);
 642           } else {
 643             os::naked_yield();
 644           }
 645         }
 646         Thread::muxRelease(gInflationLocks + ix);
 647         TEVENT(Inflate: INFLATING - yield/park);
 648       }
 649     } else {
 650       SpinPause();       // SMP-polite spinning
 651     }
 652   }
 653 }
 654 
 655 // hashCode() generation :
 656 //
 657 // Possibilities:
 658 // * MD5Digest of {obj,stwRandom}
 659 // * CRC32 of {obj,stwRandom} or any linear-feedback shift register function.
 660 // * A DES- or AES-style SBox[] mechanism
 661 // * One of the Phi-based schemes, such as:
 662 //   2654435761 = 2^32 * Phi (golden ratio)
 663 //   HashCodeValue = ((uintptr_t(obj) >> 3) * 2654435761) ^ GVars.stwRandom ;
 664 // * A variation of Marsaglia's shift-xor RNG scheme.
 665 // * (obj ^ stwRandom) is appealing, but can result
 666 //   in undesirable regularity in the hashCode values of adjacent objects
 667 //   (objects allocated back-to-back, in particular).  This could potentially
 668 //   result in hashtable collisions and reduced hashtable efficiency.
 669 //   There are simple ways to "diffuse" the middle address bits over the
 670 //   generated hashCode values:
 671 
 672 static inline intptr_t get_next_hash(Thread * Self, oop obj) {
 673   intptr_t value = 0;
 674   if (hashCode == 0) {
 675     // This form uses global Park-Miller RNG.
 676     // On MP system we'll have lots of RW access to a global, so the
 677     // mechanism induces lots of coherency traffic.
 678     value = os::random();
 679   } else if (hashCode == 1) {
 680     // This variation has the property of being stable (idempotent)
 681     // between STW operations.  This can be useful in some of the 1-0
 682     // synchronization schemes.
 683     intptr_t addrBits = cast_from_oop<intptr_t>(obj) >> 3;
 684     value = addrBits ^ (addrBits >> 5) ^ GVars.stwRandom;
 685   } else if (hashCode == 2) {
 686     value = 1;            // for sensitivity testing
 687   } else if (hashCode == 3) {
 688     value = ++GVars.hcSequence;
 689   } else if (hashCode == 4) {
 690     value = cast_from_oop<intptr_t>(obj);
 691   } else {
 692     // Marsaglia's xor-shift scheme with thread-specific state
 693     // This is probably the best overall implementation -- we'll
 694     // likely make this the default in future releases.
 695     unsigned t = Self->_hashStateX;
 696     t ^= (t << 11);
 697     Self->_hashStateX = Self->_hashStateY;
 698     Self->_hashStateY = Self->_hashStateZ;
 699     Self->_hashStateZ = Self->_hashStateW;
 700     unsigned v = Self->_hashStateW;
 701     v = (v ^ (v >> 19)) ^ (t ^ (t >> 8));
 702     Self->_hashStateW = v;
 703     value = v;
 704   }
 705 
 706   value &= markOopDesc::hash_mask;
 707   if (value == 0) value = 0xBAD;
 708   assert(value != markOopDesc::no_hash, "invariant");
 709   TEVENT(hashCode: GENERATE);
 710   return value;
 711 }
 712 
 713 intptr_t ObjectSynchronizer::FastHashCode(Thread * Self, oop obj) {
 714   if (UseBiasedLocking) {
 715     // NOTE: many places throughout the JVM do not expect a safepoint
 716     // to be taken here, in particular most operations on perm gen
 717     // objects. However, we only ever bias Java instances and all of
 718     // the call sites of identity_hash that might revoke biases have
 719     // been checked to make sure they can handle a safepoint. The
 720     // added check of the bias pattern is to avoid useless calls to
 721     // thread-local storage.
 722     if (obj->mark()->has_bias_pattern()) {
 723       // Handle for oop obj in case of STW safepoint
 724       Handle hobj(Self, obj);
 725       // Relaxing assertion for bug 6320749.
 726       assert(Universe::verify_in_progress() ||
 727              !SafepointSynchronize::is_at_safepoint(),
 728              "biases should not be seen by VM thread here");
 729       BiasedLocking::revoke_and_rebias(hobj, false, JavaThread::current());
 730       obj = hobj();
 731       assert(!obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 732     }
 733   }
 734 
 735   // hashCode() is a heap mutator ...
 736   // Relaxing assertion for bug 6320749.
 737   assert(Universe::verify_in_progress() || DumpSharedSpaces ||
 738          !SafepointSynchronize::is_at_safepoint(), "invariant");
 739   assert(Universe::verify_in_progress() || DumpSharedSpaces ||
 740          Self->is_Java_thread() , "invariant");
 741   assert(Universe::verify_in_progress() || DumpSharedSpaces ||
 742          ((JavaThread *)Self)->thread_state() != _thread_blocked, "invariant");
 743 
 744   ObjectMonitor* monitor = NULL;
 745   markOop temp, test;
 746   intptr_t hash;
 747   markOop mark = ReadStableMark(obj);
 748 
 749   // object should remain ineligible for biased locking
 750   assert(!mark->has_bias_pattern(), "invariant");
 751 
 752   if (mark->is_neutral()) {
 753     hash = mark->hash();              // this is a normal header
 754     if (hash) {                       // if it has hash, just return it
 755       return hash;
 756     }
 757     hash = get_next_hash(Self, obj);  // allocate a new hash code
 758     temp = mark->copy_set_hash(hash); // merge the hash code into header
 759     // use (machine word version) atomic operation to install the hash
 760     test = (markOop) Atomic::cmpxchg_ptr(temp, obj->mark_addr(), mark);
 761     if (test == mark) {
 762       return hash;
 763     }
 764     // If atomic operation failed, we must inflate the header
 765     // into heavy weight monitor. We could add more code here
 766     // for fast path, but it does not worth the complexity.
 767   } else if (mark->has_monitor()) {
 768     monitor = mark->monitor();
 769     temp = monitor->header();
 770     assert(temp->is_neutral(), "invariant");
 771     hash = temp->hash();
 772     if (hash) {
 773       return hash;
 774     }
 775     // Skip to the following code to reduce code size
 776   } else if (Self->is_lock_owned((address)mark->locker())) {
 777     temp = mark->displaced_mark_helper(); // this is a lightweight monitor owned
 778     assert(temp->is_neutral(), "invariant");
 779     hash = temp->hash();              // by current thread, check if the displaced
 780     if (hash) {                       // header contains hash code
 781       return hash;
 782     }
 783     // WARNING:
 784     //   The displaced header is strictly immutable.
 785     // It can NOT be changed in ANY cases. So we have
 786     // to inflate the header into heavyweight monitor
 787     // even the current thread owns the lock. The reason
 788     // is the BasicLock (stack slot) will be asynchronously
 789     // read by other threads during the inflate() function.
 790     // Any change to stack may not propagate to other threads
 791     // correctly.
 792   }
 793 
 794   // Inflate the monitor to set hash code
 795   monitor = ObjectSynchronizer::inflate(Self, obj, inflate_cause_hash_code);
 796   // Load displaced header and check it has hash code
 797   mark = monitor->header();
 798   assert(mark->is_neutral(), "invariant");
 799   hash = mark->hash();
 800   if (hash == 0) {
 801     hash = get_next_hash(Self, obj);
 802     temp = mark->copy_set_hash(hash); // merge hash code into header
 803     assert(temp->is_neutral(), "invariant");
 804     test = (markOop) Atomic::cmpxchg_ptr(temp, monitor, mark);
 805     if (test != mark) {
 806       // The only update to the header in the monitor (outside GC)
 807       // is install the hash code. If someone add new usage of
 808       // displaced header, please update this code
 809       hash = test->hash();
 810       assert(test->is_neutral(), "invariant");
 811       assert(hash != 0, "Trivial unexpected object/monitor header usage.");
 812     }
 813   }
 814   // We finally get the hash
 815   return hash;
 816 }
 817 
 818 // Deprecated -- use FastHashCode() instead.
 819 
 820 intptr_t ObjectSynchronizer::identity_hash_value_for(Handle obj) {
 821   return FastHashCode(Thread::current(), obj());
 822 }
 823 
 824 
 825 bool ObjectSynchronizer::current_thread_holds_lock(JavaThread* thread,
 826                                                    Handle h_obj) {
 827   if (UseBiasedLocking) {
 828     BiasedLocking::revoke_and_rebias(h_obj, false, thread);
 829     assert(!h_obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 830   }
 831 
 832   assert(thread == JavaThread::current(), "Can only be called on current thread");
 833   oop obj = h_obj();
 834 
 835   markOop mark = ReadStableMark(obj);
 836 
 837   // Uncontended case, header points to stack
 838   if (mark->has_locker()) {
 839     return thread->is_lock_owned((address)mark->locker());
 840   }
 841   // Contended case, header points to ObjectMonitor (tagged pointer)
 842   if (mark->has_monitor()) {
 843     ObjectMonitor* monitor = mark->monitor();
 844     return monitor->is_entered(thread) != 0;
 845   }
 846   // Unlocked case, header in place
 847   assert(mark->is_neutral(), "sanity check");
 848   return false;
 849 }
 850 
 851 // Be aware of this method could revoke bias of the lock object.
 852 // This method queries the ownership of the lock handle specified by 'h_obj'.
 853 // If the current thread owns the lock, it returns owner_self. If no
 854 // thread owns the lock, it returns owner_none. Otherwise, it will return
 855 // owner_other.
 856 ObjectSynchronizer::LockOwnership ObjectSynchronizer::query_lock_ownership
 857 (JavaThread *self, Handle h_obj) {
 858   // The caller must beware this method can revoke bias, and
 859   // revocation can result in a safepoint.
 860   assert(!SafepointSynchronize::is_at_safepoint(), "invariant");
 861   assert(self->thread_state() != _thread_blocked, "invariant");
 862 
 863   // Possible mark states: neutral, biased, stack-locked, inflated
 864 
 865   if (UseBiasedLocking && h_obj()->mark()->has_bias_pattern()) {
 866     // CASE: biased
 867     BiasedLocking::revoke_and_rebias(h_obj, false, self);
 868     assert(!h_obj->mark()->has_bias_pattern(),
 869            "biases should be revoked by now");
 870   }
 871 
 872   assert(self == JavaThread::current(), "Can only be called on current thread");
 873   oop obj = h_obj();
 874   markOop mark = ReadStableMark(obj);
 875 
 876   // CASE: stack-locked.  Mark points to a BasicLock on the owner's stack.
 877   if (mark->has_locker()) {
 878     return self->is_lock_owned((address)mark->locker()) ?
 879       owner_self : owner_other;
 880   }
 881 
 882   // CASE: inflated. Mark (tagged pointer) points to an objectMonitor.
 883   // The Object:ObjectMonitor relationship is stable as long as we're
 884   // not at a safepoint.
 885   if (mark->has_monitor()) {
 886     void * owner = mark->monitor()->_owner;
 887     if (owner == NULL) return owner_none;
 888     return (owner == self ||
 889             self->is_lock_owned((address)owner)) ? owner_self : owner_other;
 890   }
 891 
 892   // CASE: neutral
 893   assert(mark->is_neutral(), "sanity check");
 894   return owner_none;           // it's unlocked
 895 }
 896 
 897 // FIXME: jvmti should call this
 898 JavaThread* ObjectSynchronizer::get_lock_owner(Handle h_obj, bool doLock) {
 899   if (UseBiasedLocking) {
 900     if (SafepointSynchronize::is_at_safepoint()) {
 901       BiasedLocking::revoke_at_safepoint(h_obj);
 902     } else {
 903       BiasedLocking::revoke_and_rebias(h_obj, false, JavaThread::current());
 904     }
 905     assert(!h_obj->mark()->has_bias_pattern(), "biases should be revoked by now");
 906   }
 907 
 908   oop obj = h_obj();
 909   address owner = NULL;
 910 
 911   markOop mark = ReadStableMark(obj);
 912 
 913   // Uncontended case, header points to stack
 914   if (mark->has_locker()) {
 915     owner = (address) mark->locker();
 916   }
 917 
 918   // Contended case, header points to ObjectMonitor (tagged pointer)
 919   if (mark->has_monitor()) {
 920     ObjectMonitor* monitor = mark->monitor();
 921     assert(monitor != NULL, "monitor should be non-null");
 922     owner = (address) monitor->owner();
 923   }
 924 
 925   if (owner != NULL) {
 926     // owning_thread_from_monitor_owner() may also return NULL here
 927     return Threads::owning_thread_from_monitor_owner(owner, doLock);
 928   }
 929 
 930   // Unlocked case, header in place
 931   // Cannot have assertion since this object may have been
 932   // locked by another thread when reaching here.
 933   // assert(mark->is_neutral(), "sanity check");
 934 
 935   return NULL;
 936 }
 937 
 938 // Visitors ...
 939 
 940 void ObjectSynchronizer::monitors_iterate(MonitorClosure* closure) {
 941   PaddedEnd<ObjectMonitor> * block =
 942     (PaddedEnd<ObjectMonitor> *)OrderAccess::load_ptr_acquire(&gBlockList);
 943   while (block != NULL) {
 944     assert(block->object() == CHAINMARKER, "must be a block header");
 945     for (int i = _BLOCKSIZE - 1; i > 0; i--) {
 946       ObjectMonitor* mid = (ObjectMonitor *)(block + i);
 947       oop object = (oop)mid->object();
 948       if (object != NULL) {
 949         closure->do_monitor(mid);
 950       }
 951     }
 952     block = (PaddedEnd<ObjectMonitor> *)block->FreeNext;
 953   }
 954 }
 955 
 956 // Get the next block in the block list.
 957 static inline ObjectMonitor* next(ObjectMonitor* block) {
 958   assert(block->object() == CHAINMARKER, "must be a block header");
 959   block = block->FreeNext;
 960   assert(block == NULL || block->object() == CHAINMARKER, "must be a block header");
 961   return block;
 962 }
 963 
 964 static bool monitors_used_above_threshold() {
 965   if (gMonitorPopulation == 0) {
 966     return false;
 967   }
 968   int monitors_used = gMonitorPopulation - gMonitorFreeCount;
 969   int monitor_usage = (monitors_used * 100LL) / gMonitorPopulation;
 970   return monitor_usage > MonitorUsedDeflationThreshold;
 971 }
 972 
 973 bool ObjectSynchronizer::is_cleanup_needed() {
 974   if (MonitorUsedDeflationThreshold > 0) {
 975     return monitors_used_above_threshold();
 976   }
 977   return false;
 978 }
 979 
 980 void ObjectSynchronizer::oops_do(OopClosure* f) {
 981   if (MonitorInUseLists) {
 982     // When using thread local monitor lists, we only scan the
 983     // global used list here (for moribund threads), and
 984     // the thread-local monitors in Thread::oops_do().
 985     global_used_oops_do(f);
 986   } else {
 987     global_oops_do(f);
 988   }
 989 }
 990 
 991 void ObjectSynchronizer::global_oops_do(OopClosure* f) {
 992   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
 993   PaddedEnd<ObjectMonitor> * block =
 994     (PaddedEnd<ObjectMonitor> *)OrderAccess::load_ptr_acquire(&gBlockList);
 995   for (; block != NULL; block = (PaddedEnd<ObjectMonitor> *)next(block)) {
 996     assert(block->object() == CHAINMARKER, "must be a block header");
 997     for (int i = 1; i < _BLOCKSIZE; i++) {
 998       ObjectMonitor* mid = (ObjectMonitor *)&block[i];
 999       if (mid->object() != NULL) {
1000         f->do_oop((oop*)mid->object_addr());
1001       }
1002     }
1003   }
1004 }
1005 
1006 void ObjectSynchronizer::global_used_oops_do(OopClosure* f) {
1007   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
1008   list_oops_do(gOmInUseList, f);
1009 }
1010 
1011 void ObjectSynchronizer::thread_local_used_oops_do(Thread* thread, OopClosure* f) {
1012   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
1013   list_oops_do(thread->omInUseList, f);
1014 }
1015 
1016 void ObjectSynchronizer::list_oops_do(ObjectMonitor* list, OopClosure* f) {
1017   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
1018   ObjectMonitor* mid;
1019   for (mid = list; mid != NULL; mid = mid->FreeNext) {
1020     if (mid->object() != NULL) {
1021       f->do_oop((oop*)mid->object_addr());
1022     }
1023   }
1024 }
1025 
1026 
1027 // -----------------------------------------------------------------------------
1028 // ObjectMonitor Lifecycle
1029 // -----------------------
1030 // Inflation unlinks monitors from the global gFreeList and
1031 // associates them with objects.  Deflation -- which occurs at
1032 // STW-time -- disassociates idle monitors from objects.  Such
1033 // scavenged monitors are returned to the gFreeList.
1034 //
1035 // The global list is protected by gListLock.  All the critical sections
1036 // are short and operate in constant-time.
1037 //
1038 // ObjectMonitors reside in type-stable memory (TSM) and are immortal.
1039 //
1040 // Lifecycle:
1041 // --   unassigned and on the global free list
1042 // --   unassigned and on a thread's private omFreeList
1043 // --   assigned to an object.  The object is inflated and the mark refers
1044 //      to the objectmonitor.
1045 
1046 
1047 // Constraining monitor pool growth via MonitorBound ...
1048 //
1049 // The monitor pool is grow-only.  We scavenge at STW safepoint-time, but the
1050 // the rate of scavenging is driven primarily by GC.  As such,  we can find
1051 // an inordinate number of monitors in circulation.
1052 // To avoid that scenario we can artificially induce a STW safepoint
1053 // if the pool appears to be growing past some reasonable bound.
1054 // Generally we favor time in space-time tradeoffs, but as there's no
1055 // natural back-pressure on the # of extant monitors we need to impose some
1056 // type of limit.  Beware that if MonitorBound is set to too low a value
1057 // we could just loop. In addition, if MonitorBound is set to a low value
1058 // we'll incur more safepoints, which are harmful to performance.
1059 // See also: GuaranteedSafepointInterval
1060 //
1061 // The current implementation uses asynchronous VM operations.
1062 
1063 static void InduceScavenge(Thread * Self, const char * Whence) {
1064   // Induce STW safepoint to trim monitors
1065   // Ultimately, this results in a call to deflate_idle_monitors() in the near future.
1066   // More precisely, trigger an asynchronous STW safepoint as the number
1067   // of active monitors passes the specified threshold.
1068   // TODO: assert thread state is reasonable
1069 
1070   if (ForceMonitorScavenge == 0 && Atomic::xchg (1, &ForceMonitorScavenge) == 0) {
1071     if (ObjectMonitor::Knob_Verbose) {
1072       tty->print_cr("INFO: Monitor scavenge - Induced STW @%s (%d)",
1073                     Whence, ForceMonitorScavenge) ;
1074       tty->flush();
1075     }
1076     // Induce a 'null' safepoint to scavenge monitors
1077     // Must VM_Operation instance be heap allocated as the op will be enqueue and posted
1078     // to the VMthread and have a lifespan longer than that of this activation record.
1079     // The VMThread will delete the op when completed.
1080     VMThread::execute(new VM_ScavengeMonitors());
1081 
1082     if (ObjectMonitor::Knob_Verbose) {
1083       tty->print_cr("INFO: Monitor scavenge - STW posted @%s (%d)",
1084                     Whence, ForceMonitorScavenge) ;
1085       tty->flush();
1086     }
1087   }
1088 }
1089 
1090 void ObjectSynchronizer::verifyInUse(Thread *Self) {
1091   ObjectMonitor* mid;
1092   int in_use_tally = 0;
1093   for (mid = Self->omInUseList; mid != NULL; mid = mid->FreeNext) {
1094     in_use_tally++;
1095   }
1096   assert(in_use_tally == Self->omInUseCount, "in-use count off");
1097 
1098   int free_tally = 0;
1099   for (mid = Self->omFreeList; mid != NULL; mid = mid->FreeNext) {
1100     free_tally++;
1101   }
1102   assert(free_tally == Self->omFreeCount, "free count off");
1103 }
1104 
1105 ObjectMonitor* ObjectSynchronizer::omAlloc(Thread * Self) {
1106   // A large MAXPRIVATE value reduces both list lock contention
1107   // and list coherency traffic, but also tends to increase the
1108   // number of objectMonitors in circulation as well as the STW
1109   // scavenge costs.  As usual, we lean toward time in space-time
1110   // tradeoffs.
1111   const int MAXPRIVATE = 1024;
1112   for (;;) {
1113     ObjectMonitor * m;
1114 
1115     // 1: try to allocate from the thread's local omFreeList.
1116     // Threads will attempt to allocate first from their local list, then
1117     // from the global list, and only after those attempts fail will the thread
1118     // attempt to instantiate new monitors.   Thread-local free lists take
1119     // heat off the gListLock and improve allocation latency, as well as reducing
1120     // coherency traffic on the shared global list.
1121     m = Self->omFreeList;
1122     if (m != NULL) {
1123       Self->omFreeList = m->FreeNext;
1124       Self->omFreeCount--;
1125       // CONSIDER: set m->FreeNext = BAD -- diagnostic hygiene
1126       guarantee(m->object() == NULL, "invariant");
1127       if (MonitorInUseLists) {
1128         m->FreeNext = Self->omInUseList;
1129         Self->omInUseList = m;
1130         Self->omInUseCount++;
1131         if (ObjectMonitor::Knob_VerifyInUse) {
1132           verifyInUse(Self);
1133         }
1134       } else {
1135         m->FreeNext = NULL;
1136       }
1137       return m;
1138     }
1139 
1140     // 2: try to allocate from the global gFreeList
1141     // CONSIDER: use muxTry() instead of muxAcquire().
1142     // If the muxTry() fails then drop immediately into case 3.
1143     // If we're using thread-local free lists then try
1144     // to reprovision the caller's free list.
1145     if (gFreeList != NULL) {
1146       // Reprovision the thread's omFreeList.
1147       // Use bulk transfers to reduce the allocation rate and heat
1148       // on various locks.
1149       Thread::muxAcquire(&gListLock, "omAlloc");
1150       for (int i = Self->omFreeProvision; --i >= 0 && gFreeList != NULL;) {
1151         gMonitorFreeCount--;
1152         ObjectMonitor * take = gFreeList;
1153         gFreeList = take->FreeNext;
1154         guarantee(take->object() == NULL, "invariant");
1155         guarantee(!take->is_busy(), "invariant");
1156         take->Recycle();
1157         omRelease(Self, take, false);
1158       }
1159       Thread::muxRelease(&gListLock);
1160       Self->omFreeProvision += 1 + (Self->omFreeProvision/2);
1161       if (Self->omFreeProvision > MAXPRIVATE) Self->omFreeProvision = MAXPRIVATE;
1162       TEVENT(omFirst - reprovision);
1163 
1164       const int mx = MonitorBound;
1165       if (mx > 0 && (gMonitorPopulation-gMonitorFreeCount) > mx) {
1166         // We can't safely induce a STW safepoint from omAlloc() as our thread
1167         // state may not be appropriate for such activities and callers may hold
1168         // naked oops, so instead we defer the action.
1169         InduceScavenge(Self, "omAlloc");
1170       }
1171       continue;
1172     }
1173 
1174     // 3: allocate a block of new ObjectMonitors
1175     // Both the local and global free lists are empty -- resort to malloc().
1176     // In the current implementation objectMonitors are TSM - immortal.
1177     // Ideally, we'd write "new ObjectMonitor[_BLOCKSIZE], but we want
1178     // each ObjectMonitor to start at the beginning of a cache line,
1179     // so we use align_up().
1180     // A better solution would be to use C++ placement-new.
1181     // BEWARE: As it stands currently, we don't run the ctors!
1182     assert(_BLOCKSIZE > 1, "invariant");
1183     size_t neededsize = sizeof(PaddedEnd<ObjectMonitor>) * _BLOCKSIZE;
1184     PaddedEnd<ObjectMonitor> * temp;
1185     size_t aligned_size = neededsize + (DEFAULT_CACHE_LINE_SIZE - 1);
1186     void* real_malloc_addr = (void *)NEW_C_HEAP_ARRAY(char, aligned_size,
1187                                                       mtInternal);
1188     temp = (PaddedEnd<ObjectMonitor> *)
1189              align_up(real_malloc_addr, DEFAULT_CACHE_LINE_SIZE);
1190 
1191     // NOTE: (almost) no way to recover if allocation failed.
1192     // We might be able to induce a STW safepoint and scavenge enough
1193     // objectMonitors to permit progress.
1194     if (temp == NULL) {
1195       vm_exit_out_of_memory(neededsize, OOM_MALLOC_ERROR,
1196                             "Allocate ObjectMonitors");
1197     }
1198     (void)memset((void *) temp, 0, neededsize);
1199 
1200     // Format the block.
1201     // initialize the linked list, each monitor points to its next
1202     // forming the single linked free list, the very first monitor
1203     // will points to next block, which forms the block list.
1204     // The trick of using the 1st element in the block as gBlockList
1205     // linkage should be reconsidered.  A better implementation would
1206     // look like: class Block { Block * next; int N; ObjectMonitor Body [N] ; }
1207 
1208     for (int i = 1; i < _BLOCKSIZE; i++) {
1209       temp[i].FreeNext = (ObjectMonitor *)&temp[i+1];
1210     }
1211 
1212     // terminate the last monitor as the end of list
1213     temp[_BLOCKSIZE - 1].FreeNext = NULL;
1214 
1215     // Element [0] is reserved for global list linkage
1216     temp[0].set_object(CHAINMARKER);
1217 
1218     // Consider carving out this thread's current request from the
1219     // block in hand.  This avoids some lock traffic and redundant
1220     // list activity.
1221 
1222     // Acquire the gListLock to manipulate gBlockList and gFreeList.
1223     // An Oyama-Taura-Yonezawa scheme might be more efficient.
1224     Thread::muxAcquire(&gListLock, "omAlloc [2]");
1225     gMonitorPopulation += _BLOCKSIZE-1;
1226     gMonitorFreeCount += _BLOCKSIZE-1;
1227 
1228     // Add the new block to the list of extant blocks (gBlockList).
1229     // The very first objectMonitor in a block is reserved and dedicated.
1230     // It serves as blocklist "next" linkage.
1231     temp[0].FreeNext = gBlockList;
1232     // There are lock-free uses of gBlockList so make sure that
1233     // the previous stores happen before we update gBlockList.
1234     OrderAccess::release_store_ptr(&gBlockList, temp);
1235 
1236     // Add the new string of objectMonitors to the global free list
1237     temp[_BLOCKSIZE - 1].FreeNext = gFreeList;
1238     gFreeList = temp + 1;
1239     Thread::muxRelease(&gListLock);
1240     TEVENT(Allocate block of monitors);
1241   }
1242 }
1243 
1244 // Place "m" on the caller's private per-thread omFreeList.
1245 // In practice there's no need to clamp or limit the number of
1246 // monitors on a thread's omFreeList as the only time we'll call
1247 // omRelease is to return a monitor to the free list after a CAS
1248 // attempt failed.  This doesn't allow unbounded #s of monitors to
1249 // accumulate on a thread's free list.
1250 //
1251 // Key constraint: all ObjectMonitors on a thread's free list and the global
1252 // free list must have their object field set to null. This prevents the
1253 // scavenger -- deflate_idle_monitors -- from reclaiming them.
1254 
1255 void ObjectSynchronizer::omRelease(Thread * Self, ObjectMonitor * m,
1256                                    bool fromPerThreadAlloc) {
1257   guarantee(m->object() == NULL, "invariant");
1258   guarantee(((m->is_busy()|m->_recursions) == 0), "freeing in-use monitor");
1259   // Remove from omInUseList
1260   if (MonitorInUseLists && fromPerThreadAlloc) {
1261     ObjectMonitor* cur_mid_in_use = NULL;
1262     bool extracted = false;
1263     for (ObjectMonitor* mid = Self->omInUseList; mid != NULL; cur_mid_in_use = mid, mid = mid->FreeNext) {
1264       if (m == mid) {
1265         // extract from per-thread in-use list
1266         if (mid == Self->omInUseList) {
1267           Self->omInUseList = mid->FreeNext;
1268         } else if (cur_mid_in_use != NULL) {
1269           cur_mid_in_use->FreeNext = mid->FreeNext; // maintain the current thread in-use list
1270         }
1271         extracted = true;
1272         Self->omInUseCount--;
1273         if (ObjectMonitor::Knob_VerifyInUse) {
1274           verifyInUse(Self);
1275         }
1276         break;
1277       }
1278     }
1279     assert(extracted, "Should have extracted from in-use list");
1280   }
1281 
1282   // FreeNext is used for both omInUseList and omFreeList, so clear old before setting new
1283   m->FreeNext = Self->omFreeList;
1284   Self->omFreeList = m;
1285   Self->omFreeCount++;
1286 }
1287 
1288 // Return the monitors of a moribund thread's local free list to
1289 // the global free list.  Typically a thread calls omFlush() when
1290 // it's dying.  We could also consider having the VM thread steal
1291 // monitors from threads that have not run java code over a few
1292 // consecutive STW safepoints.  Relatedly, we might decay
1293 // omFreeProvision at STW safepoints.
1294 //
1295 // Also return the monitors of a moribund thread's omInUseList to
1296 // a global gOmInUseList under the global list lock so these
1297 // will continue to be scanned.
1298 //
1299 // We currently call omFlush() from Threads::remove() _before the thread
1300 // has been excised from the thread list and is no longer a mutator.
1301 // This means that omFlush() can not run concurrently with a safepoint and
1302 // interleave with the scavenge operator. In particular, this ensures that
1303 // the thread's monitors are scanned by a GC safepoint, either via
1304 // Thread::oops_do() (if safepoint happens before omFlush()) or via
1305 // ObjectSynchronizer::oops_do() (if it happens after omFlush() and the thread's
1306 // monitors have been transferred to the global in-use list).
1307 
1308 void ObjectSynchronizer::omFlush(Thread * Self) {
1309   ObjectMonitor * list = Self->omFreeList;  // Null-terminated SLL
1310   Self->omFreeList = NULL;
1311   ObjectMonitor * tail = NULL;
1312   int tally = 0;
1313   if (list != NULL) {
1314     ObjectMonitor * s;
1315     // The thread is going away, the per-thread free monitors
1316     // are freed via set_owner(NULL)
1317     // Link them to tail, which will be linked into the global free list
1318     // gFreeList below, under the gListLock
1319     for (s = list; s != NULL; s = s->FreeNext) {
1320       tally++;
1321       tail = s;
1322       guarantee(s->object() == NULL, "invariant");
1323       guarantee(!s->is_busy(), "invariant");
1324       s->set_owner(NULL);   // redundant but good hygiene
1325       TEVENT(omFlush - Move one);
1326     }
1327     guarantee(tail != NULL && list != NULL, "invariant");
1328   }
1329 
1330   ObjectMonitor * inUseList = Self->omInUseList;
1331   ObjectMonitor * inUseTail = NULL;
1332   int inUseTally = 0;
1333   if (inUseList != NULL) {
1334     Self->omInUseList = NULL;
1335     ObjectMonitor *cur_om;
1336     // The thread is going away, however the omInUseList inflated
1337     // monitors may still be in-use by other threads.
1338     // Link them to inUseTail, which will be linked into the global in-use list
1339     // gOmInUseList below, under the gListLock
1340     for (cur_om = inUseList; cur_om != NULL; cur_om = cur_om->FreeNext) {
1341       inUseTail = cur_om;
1342       inUseTally++;
1343     }
1344     assert(Self->omInUseCount == inUseTally, "in-use count off");
1345     Self->omInUseCount = 0;
1346     guarantee(inUseTail != NULL && inUseList != NULL, "invariant");
1347   }
1348 
1349   Thread::muxAcquire(&gListLock, "omFlush");
1350   if (tail != NULL) {
1351     tail->FreeNext = gFreeList;
1352     gFreeList = list;
1353     gMonitorFreeCount += tally;
1354     assert(Self->omFreeCount == tally, "free-count off");
1355     Self->omFreeCount = 0;
1356   }
1357 
1358   if (inUseTail != NULL) {
1359     inUseTail->FreeNext = gOmInUseList;
1360     gOmInUseList = inUseList;
1361     gOmInUseCount += inUseTally;
1362   }
1363 
1364   Thread::muxRelease(&gListLock);
1365   TEVENT(omFlush);
1366 }
1367 
1368 // Fast path code shared by multiple functions
1369 ObjectMonitor* ObjectSynchronizer::inflate_helper(oop obj) {
1370   markOop mark = obj->mark();
1371   if (mark->has_monitor()) {
1372     assert(ObjectSynchronizer::verify_objmon_isinpool(mark->monitor()), "monitor is invalid");
1373     assert(mark->monitor()->header()->is_neutral(), "monitor must record a good object header");
1374     return mark->monitor();
1375   }
1376   return ObjectSynchronizer::inflate(Thread::current(),
1377                                      obj,
1378                                      inflate_cause_vm_internal);
1379 }
1380 
1381 ObjectMonitor* ObjectSynchronizer::inflate(Thread * Self,
1382                                                      oop object,
1383                                                      const InflateCause cause) {
1384 
1385   // Inflate mutates the heap ...
1386   // Relaxing assertion for bug 6320749.
1387   assert(Universe::verify_in_progress() ||
1388          !SafepointSynchronize::is_at_safepoint(), "invariant");
1389 
1390   EventJavaMonitorInflate event;
1391 
1392   for (;;) {
1393     const markOop mark = object->mark();
1394     assert(!mark->has_bias_pattern(), "invariant");
1395 
1396     // The mark can be in one of the following states:
1397     // *  Inflated     - just return
1398     // *  Stack-locked - coerce it to inflated
1399     // *  INFLATING    - busy wait for conversion to complete
1400     // *  Neutral      - aggressively inflate the object.
1401     // *  BIASED       - Illegal.  We should never see this
1402 
1403     // CASE: inflated
1404     if (mark->has_monitor()) {
1405       ObjectMonitor * inf = mark->monitor();
1406       assert(inf->header()->is_neutral(), "invariant");
1407       assert(inf->object() == object, "invariant");
1408       assert(ObjectSynchronizer::verify_objmon_isinpool(inf), "monitor is invalid");
1409       event.cancel(); // let's not post an inflation event, unless we did the deed ourselves
1410       return inf;
1411     }
1412 
1413     // CASE: inflation in progress - inflating over a stack-lock.
1414     // Some other thread is converting from stack-locked to inflated.
1415     // Only that thread can complete inflation -- other threads must wait.
1416     // The INFLATING value is transient.
1417     // Currently, we spin/yield/park and poll the markword, waiting for inflation to finish.
1418     // We could always eliminate polling by parking the thread on some auxiliary list.
1419     if (mark == markOopDesc::INFLATING()) {
1420       TEVENT(Inflate: spin while INFLATING);
1421       ReadStableMark(object);
1422       continue;
1423     }
1424 
1425     // CASE: stack-locked
1426     // Could be stack-locked either by this thread or by some other thread.
1427     //
1428     // Note that we allocate the objectmonitor speculatively, _before_ attempting
1429     // to install INFLATING into the mark word.  We originally installed INFLATING,
1430     // allocated the objectmonitor, and then finally STed the address of the
1431     // objectmonitor into the mark.  This was correct, but artificially lengthened
1432     // the interval in which INFLATED appeared in the mark, thus increasing
1433     // the odds of inflation contention.
1434     //
1435     // We now use per-thread private objectmonitor free lists.
1436     // These list are reprovisioned from the global free list outside the
1437     // critical INFLATING...ST interval.  A thread can transfer
1438     // multiple objectmonitors en-mass from the global free list to its local free list.
1439     // This reduces coherency traffic and lock contention on the global free list.
1440     // Using such local free lists, it doesn't matter if the omAlloc() call appears
1441     // before or after the CAS(INFLATING) operation.
1442     // See the comments in omAlloc().
1443 
1444     if (mark->has_locker()) {
1445       ObjectMonitor * m = omAlloc(Self);
1446       // Optimistically prepare the objectmonitor - anticipate successful CAS
1447       // We do this before the CAS in order to minimize the length of time
1448       // in which INFLATING appears in the mark.
1449       m->Recycle();
1450       m->_Responsible  = NULL;
1451       m->_recursions   = 0;
1452       m->_SpinDuration = ObjectMonitor::Knob_SpinLimit;   // Consider: maintain by type/class
1453 
1454       markOop cmp = (markOop) Atomic::cmpxchg_ptr(markOopDesc::INFLATING(), object->mark_addr(), mark);
1455       if (cmp != mark) {
1456         omRelease(Self, m, true);
1457         continue;       // Interference -- just retry
1458       }
1459 
1460       // We've successfully installed INFLATING (0) into the mark-word.
1461       // This is the only case where 0 will appear in a mark-word.
1462       // Only the singular thread that successfully swings the mark-word
1463       // to 0 can perform (or more precisely, complete) inflation.
1464       //
1465       // Why do we CAS a 0 into the mark-word instead of just CASing the
1466       // mark-word from the stack-locked value directly to the new inflated state?
1467       // Consider what happens when a thread unlocks a stack-locked object.
1468       // It attempts to use CAS to swing the displaced header value from the
1469       // on-stack basiclock back into the object header.  Recall also that the
1470       // header value (hashcode, etc) can reside in (a) the object header, or
1471       // (b) a displaced header associated with the stack-lock, or (c) a displaced
1472       // header in an objectMonitor.  The inflate() routine must copy the header
1473       // value from the basiclock on the owner's stack to the objectMonitor, all
1474       // the while preserving the hashCode stability invariants.  If the owner
1475       // decides to release the lock while the value is 0, the unlock will fail
1476       // and control will eventually pass from slow_exit() to inflate.  The owner
1477       // will then spin, waiting for the 0 value to disappear.   Put another way,
1478       // the 0 causes the owner to stall if the owner happens to try to
1479       // drop the lock (restoring the header from the basiclock to the object)
1480       // while inflation is in-progress.  This protocol avoids races that might
1481       // would otherwise permit hashCode values to change or "flicker" for an object.
1482       // Critically, while object->mark is 0 mark->displaced_mark_helper() is stable.
1483       // 0 serves as a "BUSY" inflate-in-progress indicator.
1484 
1485 
1486       // fetch the displaced mark from the owner's stack.
1487       // The owner can't die or unwind past the lock while our INFLATING
1488       // object is in the mark.  Furthermore the owner can't complete
1489       // an unlock on the object, either.
1490       markOop dmw = mark->displaced_mark_helper();
1491       assert(dmw->is_neutral(), "invariant");
1492 
1493       // Setup monitor fields to proper values -- prepare the monitor
1494       m->set_header(dmw);
1495 
1496       // Optimization: if the mark->locker stack address is associated
1497       // with this thread we could simply set m->_owner = Self.
1498       // Note that a thread can inflate an object
1499       // that it has stack-locked -- as might happen in wait() -- directly
1500       // with CAS.  That is, we can avoid the xchg-NULL .... ST idiom.
1501       m->set_owner(mark->locker());
1502       m->set_object(object);
1503       // TODO-FIXME: assert BasicLock->dhw != 0.
1504 
1505       // Must preserve store ordering. The monitor state must
1506       // be stable at the time of publishing the monitor address.
1507       guarantee(object->mark() == markOopDesc::INFLATING(), "invariant");
1508       object->release_set_mark(markOopDesc::encode(m));
1509 
1510       // Hopefully the performance counters are allocated on distinct cache lines
1511       // to avoid false sharing on MP systems ...
1512       OM_PERFDATA_OP(Inflations, inc());
1513       TEVENT(Inflate: overwrite stacklock);
1514       if (log_is_enabled(Debug, monitorinflation)) {
1515         if (object->is_instance()) {
1516           ResourceMark rm;
1517           log_debug(monitorinflation)("Inflating object " INTPTR_FORMAT " , mark " INTPTR_FORMAT " , type %s",
1518                                       p2i(object), p2i(object->mark()),
1519                                       object->klass()->external_name());
1520         }
1521       }
1522       if (event.should_commit()) {
1523         post_monitor_inflate_event(event, object, cause);
1524       }
1525       return m;
1526     }
1527 
1528     // CASE: neutral
1529     // TODO-FIXME: for entry we currently inflate and then try to CAS _owner.
1530     // If we know we're inflating for entry it's better to inflate by swinging a
1531     // pre-locked objectMonitor pointer into the object header.   A successful
1532     // CAS inflates the object *and* confers ownership to the inflating thread.
1533     // In the current implementation we use a 2-step mechanism where we CAS()
1534     // to inflate and then CAS() again to try to swing _owner from NULL to Self.
1535     // An inflateTry() method that we could call from fast_enter() and slow_enter()
1536     // would be useful.
1537 
1538     assert(mark->is_neutral(), "invariant");
1539     ObjectMonitor * m = omAlloc(Self);
1540     // prepare m for installation - set monitor to initial state
1541     m->Recycle();
1542     m->set_header(mark);
1543     m->set_owner(NULL);
1544     m->set_object(object);
1545     m->_recursions   = 0;
1546     m->_Responsible  = NULL;
1547     m->_SpinDuration = ObjectMonitor::Knob_SpinLimit;       // consider: keep metastats by type/class
1548 
1549     if (Atomic::cmpxchg_ptr (markOopDesc::encode(m), object->mark_addr(), mark) != mark) {
1550       m->set_object(NULL);
1551       m->set_owner(NULL);
1552       m->Recycle();
1553       omRelease(Self, m, true);
1554       m = NULL;
1555       continue;
1556       // interference - the markword changed - just retry.
1557       // The state-transitions are one-way, so there's no chance of
1558       // live-lock -- "Inflated" is an absorbing state.
1559     }
1560 
1561     // Hopefully the performance counters are allocated on distinct
1562     // cache lines to avoid false sharing on MP systems ...
1563     OM_PERFDATA_OP(Inflations, inc());
1564     TEVENT(Inflate: overwrite neutral);
1565     if (log_is_enabled(Debug, monitorinflation)) {
1566       if (object->is_instance()) {
1567         ResourceMark rm;
1568         log_debug(monitorinflation)("Inflating object " INTPTR_FORMAT " , mark " INTPTR_FORMAT " , type %s",
1569                                     p2i(object), p2i(object->mark()),
1570                                     object->klass()->external_name());
1571       }
1572     }
1573     if (event.should_commit()) {
1574       post_monitor_inflate_event(event, object, cause);
1575     }
1576     return m;
1577   }
1578 }
1579 
1580 
1581 // Deflate_idle_monitors() is called at all safepoints, immediately
1582 // after all mutators are stopped, but before any objects have moved.
1583 // It traverses the list of known monitors, deflating where possible.
1584 // The scavenged monitor are returned to the monitor free list.
1585 //
1586 // Beware that we scavenge at *every* stop-the-world point.
1587 // Having a large number of monitors in-circulation negatively
1588 // impacts the performance of some applications (e.g., PointBase).
1589 // Broadly, we want to minimize the # of monitors in circulation.
1590 //
1591 // We have added a flag, MonitorInUseLists, which creates a list
1592 // of active monitors for each thread. deflate_idle_monitors()
1593 // only scans the per-thread in-use lists. omAlloc() puts all
1594 // assigned monitors on the per-thread list. deflate_idle_monitors()
1595 // returns the non-busy monitors to the global free list.
1596 // When a thread dies, omFlush() adds the list of active monitors for
1597 // that thread to a global gOmInUseList acquiring the
1598 // global list lock. deflate_idle_monitors() acquires the global
1599 // list lock to scan for non-busy monitors to the global free list.
1600 // An alternative could have used a single global in-use list. The
1601 // downside would have been the additional cost of acquiring the global list lock
1602 // for every omAlloc().
1603 //
1604 // Perversely, the heap size -- and thus the STW safepoint rate --
1605 // typically drives the scavenge rate.  Large heaps can mean infrequent GC,
1606 // which in turn can mean large(r) numbers of objectmonitors in circulation.
1607 // This is an unfortunate aspect of this design.
1608 
1609 enum ManifestConstants {
1610   ClearResponsibleAtSTW = 0
1611 };
1612 
1613 // Deflate a single monitor if not in-use
1614 // Return true if deflated, false if in-use
1615 bool ObjectSynchronizer::deflate_monitor(ObjectMonitor* mid, oop obj,
1616                                          ObjectMonitor** freeHeadp,
1617                                          ObjectMonitor** freeTailp) {
1618   bool deflated;
1619   // Normal case ... The monitor is associated with obj.
1620   guarantee(obj->mark() == markOopDesc::encode(mid), "invariant");
1621   guarantee(mid == obj->mark()->monitor(), "invariant");
1622   guarantee(mid->header()->is_neutral(), "invariant");
1623 
1624   if (mid->is_busy()) {
1625     if (ClearResponsibleAtSTW) mid->_Responsible = NULL;
1626     deflated = false;
1627   } else {
1628     // Deflate the monitor if it is no longer being used
1629     // It's idle - scavenge and return to the global free list
1630     // plain old deflation ...
1631     TEVENT(deflate_idle_monitors - scavenge1);
1632     if (log_is_enabled(Debug, monitorinflation)) {
1633       if (obj->is_instance()) {
1634         ResourceMark rm;
1635         log_debug(monitorinflation)("Deflating object " INTPTR_FORMAT " , "
1636                                     "mark " INTPTR_FORMAT " , type %s",
1637                                     p2i(obj), p2i(obj->mark()),
1638                                     obj->klass()->external_name());
1639       }
1640     }
1641 
1642     // Restore the header back to obj
1643     obj->release_set_mark(mid->header());
1644     mid->clear();
1645 
1646     assert(mid->object() == NULL, "invariant");
1647 
1648     // Move the object to the working free list defined by freeHeadp, freeTailp
1649     if (*freeHeadp == NULL) *freeHeadp = mid;
1650     if (*freeTailp != NULL) {
1651       ObjectMonitor * prevtail = *freeTailp;
1652       assert(prevtail->FreeNext == NULL, "cleaned up deflated?");
1653       prevtail->FreeNext = mid;
1654     }
1655     *freeTailp = mid;
1656     deflated = true;
1657   }
1658   return deflated;
1659 }
1660 
1661 // Walk a given monitor list, and deflate idle monitors
1662 // The given list could be a per-thread list or a global list
1663 // Caller acquires gListLock
1664 int ObjectSynchronizer::deflate_monitor_list(ObjectMonitor** listHeadp,
1665                                              ObjectMonitor** freeHeadp,
1666                                              ObjectMonitor** freeTailp) {
1667   ObjectMonitor* mid;
1668   ObjectMonitor* next;
1669   ObjectMonitor* cur_mid_in_use = NULL;
1670   int deflated_count = 0;
1671 
1672   for (mid = *listHeadp; mid != NULL;) {
1673     oop obj = (oop) mid->object();
1674     if (obj != NULL && deflate_monitor(mid, obj, freeHeadp, freeTailp)) {
1675       // if deflate_monitor succeeded,
1676       // extract from per-thread in-use list
1677       if (mid == *listHeadp) {
1678         *listHeadp = mid->FreeNext;
1679       } else if (cur_mid_in_use != NULL) {
1680         cur_mid_in_use->FreeNext = mid->FreeNext; // maintain the current thread in-use list
1681       }
1682       next = mid->FreeNext;
1683       mid->FreeNext = NULL;  // This mid is current tail in the freeHeadp list
1684       mid = next;
1685       deflated_count++;
1686     } else {
1687       cur_mid_in_use = mid;
1688       mid = mid->FreeNext;
1689     }
1690   }
1691   return deflated_count;
1692 }
1693 
1694 void ObjectSynchronizer::deflate_idle_monitors() {
1695   assert(SafepointSynchronize::is_at_safepoint(), "must be at safepoint");
1696   int nInuse = 0;              // currently associated with objects
1697   int nInCirculation = 0;      // extant
1698   int nScavenged = 0;          // reclaimed
1699   bool deflated = false;
1700 
1701   ObjectMonitor * freeHeadp = NULL;  // Local SLL of scavenged monitors
1702   ObjectMonitor * freeTailp = NULL;
1703 
1704   TEVENT(deflate_idle_monitors);
1705   // Prevent omFlush from changing mids in Thread dtor's during deflation
1706   // And in case the vm thread is acquiring a lock during a safepoint
1707   // See e.g. 6320749
1708   Thread::muxAcquire(&gListLock, "scavenge - return");
1709 
1710   if (MonitorInUseLists) {
1711     int inUse = 0;
1712     for (JavaThread* cur = Threads::first(); cur != NULL; cur = cur->next()) {
1713       nInCirculation+= cur->omInUseCount;
1714       int deflated_count = deflate_monitor_list(cur->omInUseList_addr(), &freeHeadp, &freeTailp);
1715       cur->omInUseCount-= deflated_count;
1716       if (ObjectMonitor::Knob_VerifyInUse) {
1717         verifyInUse(cur);
1718       }
1719       nScavenged += deflated_count;
1720       nInuse += cur->omInUseCount;
1721     }
1722 
1723     // For moribund threads, scan gOmInUseList
1724     if (gOmInUseList) {
1725       nInCirculation += gOmInUseCount;
1726       int deflated_count = deflate_monitor_list((ObjectMonitor **)&gOmInUseList, &freeHeadp, &freeTailp);
1727       gOmInUseCount-= deflated_count;
1728       nScavenged += deflated_count;
1729       nInuse += gOmInUseCount;
1730     }
1731 
1732   } else {
1733     PaddedEnd<ObjectMonitor> * block =
1734       (PaddedEnd<ObjectMonitor> *)OrderAccess::load_ptr_acquire(&gBlockList);
1735     for (; block != NULL; block = (PaddedEnd<ObjectMonitor> *)next(block)) {
1736       // Iterate over all extant monitors - Scavenge all idle monitors.
1737       assert(block->object() == CHAINMARKER, "must be a block header");
1738       nInCirculation += _BLOCKSIZE;
1739       for (int i = 1; i < _BLOCKSIZE; i++) {
1740         ObjectMonitor* mid = (ObjectMonitor*)&block[i];
1741         oop obj = (oop)mid->object();
1742 
1743         if (obj == NULL) {
1744           // The monitor is not associated with an object.
1745           // The monitor should either be a thread-specific private
1746           // free list or the global free list.
1747           // obj == NULL IMPLIES mid->is_busy() == 0
1748           guarantee(!mid->is_busy(), "invariant");
1749           continue;
1750         }
1751         deflated = deflate_monitor(mid, obj, &freeHeadp, &freeTailp);
1752 
1753         if (deflated) {
1754           mid->FreeNext = NULL;
1755           nScavenged++;
1756         } else {
1757           nInuse++;
1758         }
1759       }
1760     }
1761   }
1762 
1763   gMonitorFreeCount += nScavenged;
1764 
1765   // Consider: audit gFreeList to ensure that gMonitorFreeCount and list agree.
1766 
1767   if (ObjectMonitor::Knob_Verbose) {
1768     tty->print_cr("INFO: Deflate: InCirc=%d InUse=%d Scavenged=%d "
1769                   "ForceMonitorScavenge=%d : pop=%d free=%d",
1770                   nInCirculation, nInuse, nScavenged, ForceMonitorScavenge,
1771                   gMonitorPopulation, gMonitorFreeCount);
1772     tty->flush();
1773   }
1774 
1775   ForceMonitorScavenge = 0;    // Reset
1776 
1777   // Move the scavenged monitors back to the global free list.
1778   if (freeHeadp != NULL) {
1779     guarantee(freeTailp != NULL && nScavenged > 0, "invariant");
1780     assert(freeTailp->FreeNext == NULL, "invariant");
1781     // constant-time list splice - prepend scavenged segment to gFreeList
1782     freeTailp->FreeNext = gFreeList;
1783     gFreeList = freeHeadp;
1784   }
1785   Thread::muxRelease(&gListLock);
1786 
1787   OM_PERFDATA_OP(Deflations, inc(nScavenged));
1788   OM_PERFDATA_OP(MonExtant, set_value(nInCirculation));
1789 
1790   // TODO: Add objectMonitor leak detection.
1791   // Audit/inventory the objectMonitors -- make sure they're all accounted for.
1792   GVars.stwRandom = os::random();
1793   GVars.stwCycle++;
1794 }
1795 
1796 // Monitor cleanup on JavaThread::exit
1797 
1798 // Iterate through monitor cache and attempt to release thread's monitors
1799 // Gives up on a particular monitor if an exception occurs, but continues
1800 // the overall iteration, swallowing the exception.
1801 class ReleaseJavaMonitorsClosure: public MonitorClosure {
1802  private:
1803   TRAPS;
1804 
1805  public:
1806   ReleaseJavaMonitorsClosure(Thread* thread) : THREAD(thread) {}
1807   void do_monitor(ObjectMonitor* mid) {
1808     if (mid->owner() == THREAD) {
1809       if (ObjectMonitor::Knob_VerifyMatch != 0) {
1810         ResourceMark rm;
1811         Handle obj(THREAD, (oop) mid->object());
1812         tty->print("INFO: unexpected locked object:");
1813         javaVFrame::print_locked_object_class_name(tty, obj, "locked");
1814         fatal("exiting JavaThread=" INTPTR_FORMAT
1815               " unexpectedly owns ObjectMonitor=" INTPTR_FORMAT,
1816               p2i(THREAD), p2i(mid));
1817       }
1818       (void)mid->complete_exit(CHECK);
1819     }
1820   }
1821 };
1822 
1823 // Release all inflated monitors owned by THREAD.  Lightweight monitors are
1824 // ignored.  This is meant to be called during JNI thread detach which assumes
1825 // all remaining monitors are heavyweight.  All exceptions are swallowed.
1826 // Scanning the extant monitor list can be time consuming.
1827 // A simple optimization is to add a per-thread flag that indicates a thread
1828 // called jni_monitorenter() during its lifetime.
1829 //
1830 // Instead of No_Savepoint_Verifier it might be cheaper to
1831 // use an idiom of the form:
1832 //   auto int tmp = SafepointSynchronize::_safepoint_counter ;
1833 //   <code that must not run at safepoint>
1834 //   guarantee (((tmp ^ _safepoint_counter) | (tmp & 1)) == 0) ;
1835 // Since the tests are extremely cheap we could leave them enabled
1836 // for normal product builds.
1837 
1838 void ObjectSynchronizer::release_monitors_owned_by_thread(TRAPS) {
1839   assert(THREAD == JavaThread::current(), "must be current Java thread");
1840   NoSafepointVerifier nsv;
1841   ReleaseJavaMonitorsClosure rjmc(THREAD);
1842   Thread::muxAcquire(&gListLock, "release_monitors_owned_by_thread");
1843   ObjectSynchronizer::monitors_iterate(&rjmc);
1844   Thread::muxRelease(&gListLock);
1845   THREAD->clear_pending_exception();
1846 }
1847 
1848 const char* ObjectSynchronizer::inflate_cause_name(const InflateCause cause) {
1849   switch (cause) {
1850     case inflate_cause_vm_internal:    return "VM Internal";
1851     case inflate_cause_monitor_enter:  return "Monitor Enter";
1852     case inflate_cause_wait:           return "Monitor Wait";
1853     case inflate_cause_notify:         return "Monitor Notify";
1854     case inflate_cause_hash_code:      return "Monitor Hash Code";
1855     case inflate_cause_jni_enter:      return "JNI Monitor Enter";
1856     case inflate_cause_jni_exit:       return "JNI Monitor Exit";
1857     default:
1858       ShouldNotReachHere();
1859   }
1860   return "Unknown";
1861 }
1862 
1863 static void post_monitor_inflate_event(EventJavaMonitorInflate& event,
1864                                        const oop obj,
1865                                        const ObjectSynchronizer::InflateCause cause) {
1866 #if INCLUDE_TRACE
1867   assert(event.should_commit(), "check outside");
1868   event.set_monitorClass(obj->klass());
1869   event.set_address((TYPE_ADDRESS)(uintptr_t)(void*)obj);
1870   event.set_cause((u1)cause);
1871   event.commit();
1872 #endif
1873 }
1874 
1875 //------------------------------------------------------------------------------
1876 // Debugging code
1877 
1878 void ObjectSynchronizer::sanity_checks(const bool verbose,
1879                                        const uint cache_line_size,
1880                                        int *error_cnt_ptr,
1881                                        int *warning_cnt_ptr) {
1882   u_char *addr_begin      = (u_char*)&GVars;
1883   u_char *addr_stwRandom  = (u_char*)&GVars.stwRandom;
1884   u_char *addr_hcSequence = (u_char*)&GVars.hcSequence;
1885 
1886   if (verbose) {
1887     tty->print_cr("INFO: sizeof(SharedGlobals)=" SIZE_FORMAT,
1888                   sizeof(SharedGlobals));
1889   }
1890 
1891   uint offset_stwRandom = (uint)(addr_stwRandom - addr_begin);
1892   if (verbose) tty->print_cr("INFO: offset(stwRandom)=%u", offset_stwRandom);
1893 
1894   uint offset_hcSequence = (uint)(addr_hcSequence - addr_begin);
1895   if (verbose) {
1896     tty->print_cr("INFO: offset(_hcSequence)=%u", offset_hcSequence);
1897   }
1898 
1899   if (cache_line_size != 0) {
1900     // We were able to determine the L1 data cache line size so
1901     // do some cache line specific sanity checks
1902 
1903     if (offset_stwRandom < cache_line_size) {
1904       tty->print_cr("WARNING: the SharedGlobals.stwRandom field is closer "
1905                     "to the struct beginning than a cache line which permits "
1906                     "false sharing.");
1907       (*warning_cnt_ptr)++;
1908     }
1909 
1910     if ((offset_hcSequence - offset_stwRandom) < cache_line_size) {
1911       tty->print_cr("WARNING: the SharedGlobals.stwRandom and "
1912                     "SharedGlobals.hcSequence fields are closer than a cache "
1913                     "line which permits false sharing.");
1914       (*warning_cnt_ptr)++;
1915     }
1916 
1917     if ((sizeof(SharedGlobals) - offset_hcSequence) < cache_line_size) {
1918       tty->print_cr("WARNING: the SharedGlobals.hcSequence field is closer "
1919                     "to the struct end than a cache line which permits false "
1920                     "sharing.");
1921       (*warning_cnt_ptr)++;
1922     }
1923   }
1924 }
1925 
1926 #ifndef PRODUCT
1927 
1928 // Check if monitor belongs to the monitor cache
1929 // The list is grow-only so it's *relatively* safe to traverse
1930 // the list of extant blocks without taking a lock.
1931 
1932 int ObjectSynchronizer::verify_objmon_isinpool(ObjectMonitor *monitor) {
1933   PaddedEnd<ObjectMonitor> * block =
1934     (PaddedEnd<ObjectMonitor> *)OrderAccess::load_ptr_acquire(&gBlockList);
1935   while (block != NULL) {
1936     assert(block->object() == CHAINMARKER, "must be a block header");
1937     if (monitor > (ObjectMonitor *)&block[0] &&
1938         monitor < (ObjectMonitor *)&block[_BLOCKSIZE]) {
1939       address mon = (address)monitor;
1940       address blk = (address)block;
1941       size_t diff = mon - blk;
1942       assert((diff % sizeof(PaddedEnd<ObjectMonitor>)) == 0, "must be aligned");
1943       return 1;
1944     }
1945     block = (PaddedEnd<ObjectMonitor> *)block->FreeNext;
1946   }
1947   return 0;
1948 }
1949 
1950 #endif