1 /*
   2  * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.
   8  *
   9  * This code is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  12  * version 2 for more details (a copy is included in the LICENSE file that
  13  * accompanied this code).
  14  *
  15  * You should have received a copy of the GNU General Public License version
  16  * 2 along with this work; if not, write to the Free Software Foundation,
  17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  18  *
  19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  20  * or visit www.oracle.com if you need additional information or have any
  21  * questions.
  22  *
  23  */
  24 
  25 #ifndef SHARE_VM_RUNTIME_THREAD_HPP
  26 #define SHARE_VM_RUNTIME_THREAD_HPP
  27 
  28 #include "memory/allocation.hpp"
  29 #include "memory/threadLocalAllocBuffer.hpp"
  30 #include "oops/oop.hpp"
  31 #include "prims/jni.h"
  32 #include "prims/jvmtiExport.hpp"
  33 #include "runtime/frame.hpp"
  34 #include "runtime/javaFrameAnchor.hpp"
  35 #include "runtime/jniHandles.hpp"
  36 #include "runtime/mutexLocker.hpp"
  37 #include "runtime/os.hpp"
  38 #include "runtime/osThread.hpp"
  39 #include "runtime/park.hpp"
  40 #include "runtime/safepoint.hpp"
  41 #include "runtime/stubRoutines.hpp"
  42 #include "runtime/threadLocalStorage.hpp"
  43 #include "runtime/unhandledOops.hpp"
  44 #include "utilities/macros.hpp"
  45 
  46 #if INCLUDE_NMT
  47 #include "services/memRecorder.hpp"
  48 #endif // INCLUDE_NMT
  49 
  50 #include "trace/traceBackend.hpp"
  51 #include "trace/traceMacros.hpp"
  52 #include "utilities/exceptions.hpp"
  53 #include "utilities/top.hpp"
  54 #if INCLUDE_ALL_GCS
  55 #include "gc_implementation/g1/dirtyCardQueue.hpp"
  56 #include "gc_implementation/g1/satbQueue.hpp"
  57 #endif // INCLUDE_ALL_GCS
  58 #ifdef ZERO
  59 #ifdef TARGET_ARCH_zero
  60 # include "stack_zero.hpp"
  61 #endif
  62 #endif
  63 
  64 class ThreadSafepointState;
  65 class ThreadProfiler;
  66 
  67 class JvmtiThreadState;
  68 class JvmtiGetLoadedClassesClosure;
  69 class ThreadStatistics;
  70 class ConcurrentLocksDump;
  71 class ParkEvent;
  72 class Parker;
  73 
  74 class ciEnv;
  75 class CompileThread;
  76 class CompileLog;
  77 class CompileTask;
  78 class CompileQueue;
  79 class CompilerCounters;
  80 class vframeArray;
  81 
  82 class DeoptResourceMark;
  83 class jvmtiDeferredLocalVariableSet;
  84 
  85 class GCTaskQueue;
  86 class ThreadClosure;
  87 class IdealGraphPrinter;
  88 
  89 DEBUG_ONLY(class ResourceMark;)
  90 
  91 class WorkerThread;
  92 
  93 // Class hierarchy
  94 // - Thread
  95 //   - NamedThread
  96 //     - VMThread
  97 //     - ConcurrentGCThread
  98 //     - WorkerThread
  99 //       - GangWorker
 100 //       - GCTaskThread
 101 //   - JavaThread
 102 //   - WatcherThread
 103 
 104 class Thread: public ThreadShadow {
 105   friend class VMStructs;
 106  private:
 107   // Exception handling
 108   // (Note: _pending_exception and friends are in ThreadShadow)
 109   //oop       _pending_exception;                // pending exception for current thread
 110   // const char* _exception_file;                   // file information for exception (debugging only)
 111   // int         _exception_line;                   // line information for exception (debugging only)
 112  protected:
 113   // Support for forcing alignment of thread objects for biased locking
 114   void*       _real_malloc_address;
 115  public:
 116   void* operator new(size_t size) throw() { return allocate(size, true); }
 117   void* operator new(size_t size, const std::nothrow_t& nothrow_constant) throw() {
 118     return allocate(size, false); }
 119   void  operator delete(void* p);
 120 
 121  protected:
 122    static void* allocate(size_t size, bool throw_excpt, MEMFLAGS flags = mtThread);
 123  private:
 124 
 125   // ***************************************************************
 126   // Suspend and resume support
 127   // ***************************************************************
 128   //
 129   // VM suspend/resume no longer exists - it was once used for various
 130   // things including safepoints but was deprecated and finally removed
 131   // in Java 7. Because VM suspension was considered "internal" Java-level
 132   // suspension was considered "external", and this legacy naming scheme
 133   // remains.
 134   //
 135   // External suspend/resume requests come from JVM_SuspendThread,
 136   // JVM_ResumeThread, JVMTI SuspendThread, and finally JVMTI
 137   // ResumeThread. External
 138   // suspend requests cause _external_suspend to be set and external
 139   // resume requests cause _external_suspend to be cleared.
 140   // External suspend requests do not nest on top of other external
 141   // suspend requests. The higher level APIs reject suspend requests
 142   // for already suspended threads.
 143   //
 144   // The external_suspend
 145   // flag is checked by has_special_runtime_exit_condition() and java thread
 146   // will self-suspend when handle_special_runtime_exit_condition() is
 147   // called. Most uses of the _thread_blocked state in JavaThreads are
 148   // considered the same as being externally suspended; if the blocking
 149   // condition lifts, the JavaThread will self-suspend. Other places
 150   // where VM checks for external_suspend include:
 151   //   + mutex granting (do not enter monitors when thread is suspended)
 152   //   + state transitions from _thread_in_native
 153   //
 154   // In general, java_suspend() does not wait for an external suspend
 155   // request to complete. When it returns, the only guarantee is that
 156   // the _external_suspend field is true.
 157   //
 158   // wait_for_ext_suspend_completion() is used to wait for an external
 159   // suspend request to complete. External suspend requests are usually
 160   // followed by some other interface call that requires the thread to
 161   // be quiescent, e.g., GetCallTrace(). By moving the "wait time" into
 162   // the interface that requires quiescence, we give the JavaThread a
 163   // chance to self-suspend before we need it to be quiescent. This
 164   // improves overall suspend/query performance.
 165   //
 166   // _suspend_flags controls the behavior of java_ suspend/resume.
 167   // It must be set under the protection of SR_lock. Read from the flag is
 168   // OK without SR_lock as long as the value is only used as a hint.
 169   // (e.g., check _external_suspend first without lock and then recheck
 170   // inside SR_lock and finish the suspension)
 171   //
 172   // _suspend_flags is also overloaded for other "special conditions" so
 173   // that a single check indicates whether any special action is needed
 174   // eg. for async exceptions.
 175   // -------------------------------------------------------------------
 176   // Notes:
 177   // 1. The suspend/resume logic no longer uses ThreadState in OSThread
 178   // but we still update its value to keep other part of the system (mainly
 179   // JVMTI) happy. ThreadState is legacy code (see notes in
 180   // osThread.hpp).
 181   //
 182   // 2. It would be more natural if set_external_suspend() is private and
 183   // part of java_suspend(), but that probably would affect the suspend/query
 184   // performance. Need more investigation on this.
 185   //
 186 
 187   // suspend/resume lock: used for self-suspend
 188   Monitor* _SR_lock;
 189 
 190  protected:
 191   enum SuspendFlags {
 192     // NOTE: avoid using the sign-bit as cc generates different test code
 193     //       when the sign-bit is used, and sometimes incorrectly - see CR 6398077
 194 
 195     _external_suspend       = 0x20000000U, // thread is asked to self suspend
 196     _ext_suspended          = 0x40000000U, // thread has self-suspended
 197     _deopt_suspend          = 0x10000000U, // thread needs to self suspend for deopt
 198 
 199     _has_async_exception    = 0x00000001U, // there is a pending async exception
 200     _critical_native_unlock = 0x00000002U  // Must call back to unlock JNI critical lock
 201   };
 202 
 203   // various suspension related flags - atomically updated
 204   // overloaded for async exception checking in check_special_condition_for_native_trans.
 205   volatile uint32_t _suspend_flags;
 206 
 207  private:
 208   int _num_nested_signal;
 209 
 210  public:
 211   void enter_signal_handler() { _num_nested_signal++; }
 212   void leave_signal_handler() { _num_nested_signal--; }
 213   bool is_inside_signal_handler() const { return _num_nested_signal > 0; }
 214 
 215  private:
 216   // Debug tracing
 217   static void trace(const char* msg, const Thread* const thread) PRODUCT_RETURN;
 218 
 219   // Active_handles points to a block of handles
 220   JNIHandleBlock* _active_handles;
 221 
 222   // One-element thread local free list
 223   JNIHandleBlock* _free_handle_block;
 224 
 225   // Point to the last handle mark
 226   HandleMark* _last_handle_mark;
 227 
 228   // The parity of the last strong_roots iteration in which this thread was
 229   // claimed as a task.
 230   jint _oops_do_parity;
 231 
 232   public:
 233    void set_last_handle_mark(HandleMark* mark)   { _last_handle_mark = mark; }
 234    HandleMark* last_handle_mark() const          { return _last_handle_mark; }
 235   private:
 236 
 237   // debug support for checking if code does allow safepoints or not
 238   // GC points in the VM can happen because of allocation, invoking a VM operation, or blocking on
 239   // mutex, or blocking on an object synchronizer (Java locking).
 240   // If !allow_safepoint(), then an assertion failure will happen in any of the above cases
 241   // If !allow_allocation(), then an assertion failure will happen during allocation
 242   // (Hence, !allow_safepoint() => !allow_allocation()).
 243   //
 244   // The two classes No_Safepoint_Verifier and No_Allocation_Verifier are used to set these counters.
 245   //
 246   NOT_PRODUCT(int _allow_safepoint_count;)      // If 0, thread allow a safepoint to happen
 247   debug_only (int _allow_allocation_count;)     // If 0, the thread is allowed to allocate oops.
 248 
 249   // Used by SkipGCALot class.
 250   NOT_PRODUCT(bool _skip_gcalot;)               // Should we elide gc-a-lot?
 251 
 252   // Record when GC is locked out via the GC_locker mechanism
 253   CHECK_UNHANDLED_OOPS_ONLY(int _gc_locked_out_count;)
 254 
 255   friend class No_Alloc_Verifier;
 256   friend class No_Safepoint_Verifier;
 257   friend class Pause_No_Safepoint_Verifier;
 258   friend class ThreadLocalStorage;
 259   friend class GC_locker;
 260 
 261   ThreadLocalAllocBuffer _tlab;                 // Thread-local eden
 262   jlong _allocated_bytes;                       // Cumulative number of bytes allocated on
 263                                                 // the Java heap
 264 
 265   TRACE_DATA _trace_data;                       // Thread-local data for tracing
 266 
 267   int   _vm_operation_started_count;            // VM_Operation support
 268   int   _vm_operation_completed_count;          // VM_Operation support
 269 
 270   ObjectMonitor* _current_pending_monitor;      // ObjectMonitor this thread
 271                                                 // is waiting to lock
 272   bool _current_pending_monitor_is_from_java;   // locking is from Java code
 273 
 274   // ObjectMonitor on which this thread called Object.wait()
 275   ObjectMonitor* _current_waiting_monitor;
 276 
 277   // Private thread-local objectmonitor list - a simple cache organized as a SLL.
 278  public:
 279   ObjectMonitor* omFreeList;
 280   int omFreeCount;                              // length of omFreeList
 281   int omFreeProvision;                          // reload chunk size
 282   ObjectMonitor* omInUseList;                   // SLL to track monitors in circulation
 283   int omInUseCount;                             // length of omInUseList
 284 
 285 #ifdef ASSERT
 286  private:
 287   bool _visited_for_critical_count;
 288 
 289  public:
 290   void set_visited_for_critical_count(bool z) { _visited_for_critical_count = z; }
 291   bool was_visited_for_critical_count() const   { return _visited_for_critical_count; }
 292 #endif
 293 
 294  public:
 295   enum {
 296     is_definitely_current_thread = true
 297   };
 298 
 299   // Constructor
 300   Thread();
 301   virtual ~Thread();
 302 
 303   // initializtion
 304   void initialize_thread_local_storage();
 305 
 306   // thread entry point
 307   virtual void run();
 308 
 309   // Testers
 310   virtual bool is_VM_thread()       const            { return false; }
 311   virtual bool is_Java_thread()     const            { return false; }
 312   virtual bool is_Compiler_thread() const            { return false; }
 313   virtual bool is_hidden_from_external_view() const  { return false; }
 314   virtual bool is_jvmti_agent_thread() const         { return false; }
 315   // True iff the thread can perform GC operations at a safepoint.
 316   // Generally will be true only of VM thread and parallel GC WorkGang
 317   // threads.
 318   virtual bool is_GC_task_thread() const             { return false; }
 319   virtual bool is_Watcher_thread() const             { return false; }
 320   virtual bool is_ConcurrentGC_thread() const        { return false; }
 321   virtual bool is_Named_thread() const               { return false; }
 322   virtual bool is_Worker_thread() const              { return false; }
 323 
 324   // Casts
 325   virtual WorkerThread* as_Worker_thread() const     { return NULL; }
 326 
 327   virtual char* name() const { return (char*)"Unknown thread"; }
 328 
 329   // Returns the current thread
 330   static inline Thread* current();
 331 
 332   // Common thread operations
 333   static void set_priority(Thread* thread, ThreadPriority priority);
 334   static ThreadPriority get_priority(const Thread* const thread);
 335   static void start(Thread* thread);
 336   static void interrupt(Thread* thr);
 337   static bool is_interrupted(Thread* thr, bool clear_interrupted);
 338 
 339   void set_native_thread_name(const char *name) {
 340     assert(Thread::current() == this, "set_native_thread_name can only be called on the current thread");
 341     os::set_native_thread_name(name);
 342   }
 343 
 344   ObjectMonitor** omInUseList_addr()             { return (ObjectMonitor **)&omInUseList; }
 345   Monitor* SR_lock() const                       { return _SR_lock; }
 346 
 347   bool has_async_exception() const { return (_suspend_flags & _has_async_exception) != 0; }
 348 
 349   void set_suspend_flag(SuspendFlags f) {
 350     assert(sizeof(jint) == sizeof(_suspend_flags), "size mismatch");
 351     uint32_t flags;
 352     do {
 353       flags = _suspend_flags;
 354     }
 355     while (Atomic::cmpxchg((jint)(flags | f),
 356                            (volatile jint*)&_suspend_flags,
 357                            (jint)flags) != (jint)flags);
 358   }
 359   void clear_suspend_flag(SuspendFlags f) {
 360     assert(sizeof(jint) == sizeof(_suspend_flags), "size mismatch");
 361     uint32_t flags;
 362     do {
 363       flags = _suspend_flags;
 364     }
 365     while (Atomic::cmpxchg((jint)(flags & ~f),
 366                            (volatile jint*)&_suspend_flags,
 367                            (jint)flags) != (jint)flags);
 368   }
 369 
 370   void set_has_async_exception() {
 371     set_suspend_flag(_has_async_exception);
 372   }
 373   void clear_has_async_exception() {
 374     clear_suspend_flag(_has_async_exception);
 375   }
 376 
 377   bool do_critical_native_unlock() const { return (_suspend_flags & _critical_native_unlock) != 0; }
 378 
 379   void set_critical_native_unlock() {
 380     set_suspend_flag(_critical_native_unlock);
 381   }
 382   void clear_critical_native_unlock() {
 383     clear_suspend_flag(_critical_native_unlock);
 384   }
 385 
 386   // Support for Unhandled Oop detection
 387 #ifdef CHECK_UNHANDLED_OOPS
 388  private:
 389   UnhandledOops* _unhandled_oops;
 390  public:
 391   UnhandledOops* unhandled_oops() { return _unhandled_oops; }
 392   // Mark oop safe for gc.  It may be stack allocated but won't move.
 393   void allow_unhandled_oop(oop *op) {
 394     if (CheckUnhandledOops) unhandled_oops()->allow_unhandled_oop(op);
 395   }
 396   // Clear oops at safepoint so crashes point to unhandled oop violator
 397   void clear_unhandled_oops() {
 398     if (CheckUnhandledOops) unhandled_oops()->clear_unhandled_oops();
 399   }
 400   bool is_gc_locked_out() { return _gc_locked_out_count > 0; }
 401 #endif // CHECK_UNHANDLED_OOPS
 402 
 403 #ifndef PRODUCT
 404   bool skip_gcalot()           { return _skip_gcalot; }
 405   void set_skip_gcalot(bool v) { _skip_gcalot = v;    }
 406 #endif
 407 
 408  public:
 409   // Installs a pending exception to be inserted later
 410   static void send_async_exception(oop thread_oop, oop java_throwable);
 411 
 412   // Resource area
 413   ResourceArea* resource_area() const            { return _resource_area; }
 414   void set_resource_area(ResourceArea* area)     { _resource_area = area; }
 415 
 416   OSThread* osthread() const                     { return _osthread;   }
 417   void set_osthread(OSThread* thread)            { _osthread = thread; }
 418 
 419   // JNI handle support
 420   JNIHandleBlock* active_handles() const         { return _active_handles; }
 421   void set_active_handles(JNIHandleBlock* block) { _active_handles = block; }
 422   JNIHandleBlock* free_handle_block() const      { return _free_handle_block; }
 423   void set_free_handle_block(JNIHandleBlock* block) { _free_handle_block = block; }
 424 
 425   // Internal handle support
 426   HandleArea* handle_area() const                { return _handle_area; }
 427   void set_handle_area(HandleArea* area)         { _handle_area = area; }
 428 
 429   GrowableArray<Metadata*>* metadata_handles() const          { return _metadata_handles; }
 430   void set_metadata_handles(GrowableArray<Metadata*>* handles){ _metadata_handles = handles; }
 431 
 432   // Thread-Local Allocation Buffer (TLAB) support
 433   ThreadLocalAllocBuffer& tlab()                 { return _tlab; }
 434   void initialize_tlab() {
 435     if (UseTLAB) {
 436       tlab().initialize();
 437     }
 438   }
 439 
 440   jlong allocated_bytes()               { return _allocated_bytes; }
 441   void set_allocated_bytes(jlong value) { _allocated_bytes = value; }
 442   void incr_allocated_bytes(jlong size) { _allocated_bytes += size; }
 443   jlong cooked_allocated_bytes() {
 444     jlong allocated_bytes = OrderAccess::load_acquire(&_allocated_bytes);
 445     if (UseTLAB) {
 446       size_t used_bytes = tlab().used_bytes();
 447       if ((ssize_t)used_bytes > 0) {
 448         // More-or-less valid tlab.  The load_acquire above should ensure
 449         // that the result of the add is <= the instantaneous value
 450         return allocated_bytes + used_bytes;
 451       }
 452     }
 453     return allocated_bytes;
 454   }
 455 
 456   TRACE_DATA* trace_data()              { return &_trace_data; }
 457 
 458   // VM operation support
 459   int vm_operation_ticket()                      { return ++_vm_operation_started_count; }
 460   int vm_operation_completed_count()             { return _vm_operation_completed_count; }
 461   void increment_vm_operation_completed_count()  { _vm_operation_completed_count++; }
 462 
 463   // For tracking the heavyweight monitor the thread is pending on.
 464   ObjectMonitor* current_pending_monitor() {
 465     return _current_pending_monitor;
 466   }
 467   void set_current_pending_monitor(ObjectMonitor* monitor) {
 468     _current_pending_monitor = monitor;
 469   }
 470   void set_current_pending_monitor_is_from_java(bool from_java) {
 471     _current_pending_monitor_is_from_java = from_java;
 472   }
 473   bool current_pending_monitor_is_from_java() {
 474     return _current_pending_monitor_is_from_java;
 475   }
 476 
 477   // For tracking the ObjectMonitor on which this thread called Object.wait()
 478   ObjectMonitor* current_waiting_monitor() {
 479     return _current_waiting_monitor;
 480   }
 481   void set_current_waiting_monitor(ObjectMonitor* monitor) {
 482     _current_waiting_monitor = monitor;
 483   }
 484 
 485   // GC support
 486   // Apply "f->do_oop" to all root oops in "this".
 487   // Apply "cld_f->do_cld" to CLDs that are otherwise not kept alive.
 488   //   Used by JavaThread::oops_do.
 489   // Apply "cf->do_code_blob" (if !NULL) to all code blobs active in frames
 490   virtual void oops_do(OopClosure* f, CLDToOopClosure* cld_f, CodeBlobClosure* cf);
 491 
 492   // Handles the parallel case for the method below.
 493 private:
 494   bool claim_oops_do_par_case(int collection_parity);
 495 public:
 496   // Requires that "collection_parity" is that of the current strong roots
 497   // iteration.  If "is_par" is false, sets the parity of "this" to
 498   // "collection_parity", and returns "true".  If "is_par" is true,
 499   // uses an atomic instruction to set the current threads parity to
 500   // "collection_parity", if it is not already.  Returns "true" iff the
 501   // calling thread does the update, this indicates that the calling thread
 502   // has claimed the thread's stack as a root groop in the current
 503   // collection.
 504   bool claim_oops_do(bool is_par, int collection_parity) {
 505     if (!is_par) {
 506       _oops_do_parity = collection_parity;
 507       return true;
 508     } else {
 509       return claim_oops_do_par_case(collection_parity);
 510     }
 511   }
 512 
 513   // Sweeper support
 514   void nmethods_do(CodeBlobClosure* cf);
 515 
 516   // jvmtiRedefineClasses support
 517   void metadata_do(void f(Metadata*));
 518 
 519   // Used by fast lock support
 520   virtual bool is_lock_owned(address adr) const;
 521 
 522   // Check if address is in the stack of the thread (not just for locks).
 523   // Warning: the method can only be used on the running thread
 524   bool is_in_stack(address adr) const;
 525   // Check if address is in the usable part of the stack (excludes protected
 526   // guard pages)
 527   bool is_in_usable_stack(address adr) const;
 528 
 529   // Sets this thread as starting thread. Returns failure if thread
 530   // creation fails due to lack of memory, too many threads etc.
 531   bool set_as_starting_thread();
 532 
 533  protected:
 534   // OS data associated with the thread
 535   OSThread* _osthread;  // Platform-specific thread information
 536 
 537   // Thread local resource area for temporary allocation within the VM
 538   ResourceArea* _resource_area;
 539 
 540   DEBUG_ONLY(ResourceMark* _current_resource_mark;)
 541 
 542   // Thread local handle area for allocation of handles within the VM
 543   HandleArea* _handle_area;
 544   GrowableArray<Metadata*>* _metadata_handles;
 545 
 546   // Support for stack overflow handling, get_thread, etc.
 547   address          _stack_base;
 548   size_t           _stack_size;
 549   uintptr_t        _self_raw_id;      // used by get_thread (mutable)
 550   int              _lgrp_id;
 551 
 552  public:
 553   // Stack overflow support
 554   address stack_base() const           { assert(_stack_base != NULL,"Sanity check"); return _stack_base; }
 555 
 556   void    set_stack_base(address base) { _stack_base = base; }
 557   size_t  stack_size() const           { return _stack_size; }
 558   void    set_stack_size(size_t size)  { _stack_size = size; }
 559   void    record_stack_base_and_size();
 560 
 561   bool    on_local_stack(address adr) const {
 562     /* QQQ this has knowledge of direction, ought to be a stack method */
 563     return (_stack_base >= adr && adr >= (_stack_base - _stack_size));
 564   }
 565 
 566   uintptr_t self_raw_id()                    { return _self_raw_id; }
 567   void      set_self_raw_id(uintptr_t value) { _self_raw_id = value; }
 568 
 569   int     lgrp_id() const        { return _lgrp_id; }
 570   void    set_lgrp_id(int value) { _lgrp_id = value; }
 571 
 572   // Printing
 573   void print_on(outputStream* st) const;
 574   void print() const { print_on(tty); }
 575   virtual void print_on_error(outputStream* st, char* buf, int buflen) const;
 576 
 577   // Debug-only code
 578 #ifdef ASSERT
 579  private:
 580   // Deadlock detection support for Mutex locks. List of locks own by thread.
 581   Monitor* _owned_locks;
 582   // Mutex::set_owner_implementation is the only place where _owned_locks is modified,
 583   // thus the friendship
 584   friend class Mutex;
 585   friend class Monitor;
 586 
 587  public:
 588   void print_owned_locks_on(outputStream* st) const;
 589   void print_owned_locks() const                 { print_owned_locks_on(tty);    }
 590   Monitor* owned_locks() const                   { return _owned_locks;          }
 591   bool owns_locks() const                        { return owned_locks() != NULL; }
 592   bool owns_locks_but_compiled_lock() const;
 593 
 594   // Deadlock detection
 595   bool allow_allocation()                        { return _allow_allocation_count == 0; }
 596   ResourceMark* current_resource_mark()          { return _current_resource_mark; }
 597   void set_current_resource_mark(ResourceMark* rm) { _current_resource_mark = rm; }
 598 #endif
 599 
 600   void check_for_valid_safepoint_state(bool potential_vm_operation) PRODUCT_RETURN;
 601 
 602  private:
 603   volatile int _jvmti_env_iteration_count;
 604 
 605  public:
 606   void entering_jvmti_env_iteration()            { ++_jvmti_env_iteration_count; }
 607   void leaving_jvmti_env_iteration()             { --_jvmti_env_iteration_count; }
 608   bool is_inside_jvmti_env_iteration()           { return _jvmti_env_iteration_count > 0; }
 609 
 610   // Code generation
 611   static ByteSize exception_file_offset()        { return byte_offset_of(Thread, _exception_file   ); }
 612   static ByteSize exception_line_offset()        { return byte_offset_of(Thread, _exception_line   ); }
 613   static ByteSize active_handles_offset()        { return byte_offset_of(Thread, _active_handles   ); }
 614 
 615   static ByteSize stack_base_offset()            { return byte_offset_of(Thread, _stack_base ); }
 616   static ByteSize stack_size_offset()            { return byte_offset_of(Thread, _stack_size ); }
 617 
 618 #define TLAB_FIELD_OFFSET(name) \
 619   static ByteSize tlab_##name##_offset()         { return byte_offset_of(Thread, _tlab) + ThreadLocalAllocBuffer::name##_offset(); }
 620 
 621   TLAB_FIELD_OFFSET(start)
 622   TLAB_FIELD_OFFSET(end)
 623   TLAB_FIELD_OFFSET(top)
 624   TLAB_FIELD_OFFSET(pf_top)
 625   TLAB_FIELD_OFFSET(size)                   // desired_size
 626   TLAB_FIELD_OFFSET(refill_waste_limit)
 627   TLAB_FIELD_OFFSET(number_of_refills)
 628   TLAB_FIELD_OFFSET(fast_refill_waste)
 629   TLAB_FIELD_OFFSET(slow_allocations)
 630 
 631 #undef TLAB_FIELD_OFFSET
 632 
 633   static ByteSize allocated_bytes_offset()       { return byte_offset_of(Thread, _allocated_bytes ); }
 634 
 635  public:
 636   volatile intptr_t _Stalled ;
 637   volatile int _TypeTag ;
 638   ParkEvent * _ParkEvent ;                     // for synchronized()
 639   ParkEvent * _SleepEvent ;                    // for Thread.sleep
 640   ParkEvent * _MutexEvent ;                    // for native internal Mutex/Monitor
 641   ParkEvent * _MuxEvent ;                      // for low-level muxAcquire-muxRelease
 642   int NativeSyncRecursion ;                    // diagnostic
 643 
 644   volatile int _OnTrap ;                       // Resume-at IP delta
 645   jint _hashStateW ;                           // Marsaglia Shift-XOR thread-local RNG
 646   jint _hashStateX ;                           // thread-specific hashCode generator state
 647   jint _hashStateY ;
 648   jint _hashStateZ ;
 649   void * _schedctl ;
 650 
 651 
 652   volatile jint rng [4] ;                      // RNG for spin loop
 653 
 654   // Low-level leaf-lock primitives used to implement synchronization
 655   // and native monitor-mutex infrastructure.
 656   // Not for general synchronization use.
 657   static void SpinAcquire (volatile int * Lock, const char * Name) ;
 658   static void SpinRelease (volatile int * Lock) ;
 659   static void muxAcquire  (volatile intptr_t * Lock, const char * Name) ;
 660   static void muxAcquireW (volatile intptr_t * Lock, ParkEvent * ev) ;
 661   static void muxRelease  (volatile intptr_t * Lock) ;
 662 };
 663 
 664 // Inline implementation of Thread::current()
 665 // Thread::current is "hot" it's called > 128K times in the 1st 500 msecs of
 666 // startup.
 667 // ThreadLocalStorage::thread is warm -- it's called > 16K times in the same
 668 // period.   This is inlined in thread_<os_family>.inline.hpp.
 669 
 670 inline Thread* Thread::current() {
 671 #ifdef ASSERT
 672 // This function is very high traffic. Define PARANOID to enable expensive
 673 // asserts.
 674 #ifdef PARANOID
 675   // Signal handler should call ThreadLocalStorage::get_thread_slow()
 676   Thread* t = ThreadLocalStorage::get_thread_slow();
 677   assert(t != NULL && !t->is_inside_signal_handler(),
 678          "Don't use Thread::current() inside signal handler");
 679 #endif
 680 #endif
 681   Thread* thread = ThreadLocalStorage::thread();
 682   assert(thread != NULL, "just checking");
 683   return thread;
 684 }
 685 
 686 // Name support for threads.  non-JavaThread subclasses with multiple
 687 // uniquely named instances should derive from this.
 688 class NamedThread: public Thread {
 689   friend class VMStructs;
 690   enum {
 691     max_name_len = 64
 692   };
 693  private:
 694   char* _name;
 695   // log JavaThread being processed by oops_do
 696   JavaThread* _processed_thread;
 697 
 698  public:
 699   NamedThread();
 700   ~NamedThread();
 701   // May only be called once per thread.
 702   void set_name(const char* format, ...);
 703   virtual bool is_Named_thread() const { return true; }
 704   virtual char* name() const { return _name == NULL ? (char*)"Unknown Thread" : _name; }
 705   JavaThread *processed_thread() { return _processed_thread; }
 706   void set_processed_thread(JavaThread *thread) { _processed_thread = thread; }
 707 };
 708 
 709 // Worker threads are named and have an id of an assigned work.
 710 class WorkerThread: public NamedThread {
 711 private:
 712   uint _id;
 713 public:
 714   WorkerThread() : _id(0)               { }
 715   virtual bool is_Worker_thread() const { return true; }
 716 
 717   virtual WorkerThread* as_Worker_thread() const {
 718     assert(is_Worker_thread(), "Dubious cast to WorkerThread*?");
 719     return (WorkerThread*) this;
 720   }
 721 
 722   void set_id(uint work_id)             { _id = work_id; }
 723   uint id() const                       { return _id; }
 724 };
 725 
 726 // A single WatcherThread is used for simulating timer interrupts.
 727 class WatcherThread: public Thread {
 728   friend class VMStructs;
 729  public:
 730   virtual void run();
 731 
 732  private:
 733   static WatcherThread* _watcher_thread;
 734 
 735   static bool _startable;
 736   volatile static bool _should_terminate; // updated without holding lock
 737 
 738   os::WatcherThreadCrashProtection* _crash_protection;
 739  public:
 740   enum SomeConstants {
 741     delay_interval = 10                          // interrupt delay in milliseconds
 742   };
 743 
 744   // Constructor
 745   WatcherThread();
 746 
 747   // Tester
 748   bool is_Watcher_thread() const                 { return true; }
 749 
 750   // Printing
 751   char* name() const { return (char*)"VM Periodic Task Thread"; }
 752   void print_on(outputStream* st) const;
 753   void print() const { print_on(tty); }
 754   void unpark();
 755 
 756   // Returns the single instance of WatcherThread
 757   static WatcherThread* watcher_thread()         { return _watcher_thread; }
 758 
 759   // Create and start the single instance of WatcherThread, or stop it on shutdown
 760   static void start();
 761   static void stop();
 762   // Only allow start once the VM is sufficiently initialized
 763   // Otherwise the first task to enroll will trigger the start
 764   static void make_startable();
 765 
 766   void set_crash_protection(os::WatcherThreadCrashProtection* crash_protection) {
 767     assert(Thread::current()->is_Watcher_thread(), "Can only be set by WatcherThread");
 768     _crash_protection = crash_protection;
 769   }
 770 
 771   bool has_crash_protection() const { return _crash_protection != NULL; }
 772   os::WatcherThreadCrashProtection* crash_protection() const { return _crash_protection; }
 773 
 774  private:
 775   int sleep() const;
 776 };
 777 
 778 
 779 class CompilerThread;
 780 
 781 typedef void (*ThreadFunction)(JavaThread*, TRAPS);
 782 
 783 class JavaThread: public Thread {
 784   friend class VMStructs;
 785  private:
 786   JavaThread*    _next;                          // The next thread in the Threads list
 787   oop            _threadObj;                     // The Java level thread object
 788 
 789 #ifdef ASSERT
 790  private:
 791   int _java_call_counter;
 792 
 793  public:
 794   int  java_call_counter()                       { return _java_call_counter; }
 795   void inc_java_call_counter()                   { _java_call_counter++; }
 796   void dec_java_call_counter() {
 797     assert(_java_call_counter > 0, "Invalid nesting of JavaCallWrapper");
 798     _java_call_counter--;
 799   }
 800  private:  // restore original namespace restriction
 801 #endif  // ifdef ASSERT
 802 
 803 #ifndef PRODUCT
 804  public:
 805   enum {
 806     jump_ring_buffer_size = 16
 807   };
 808  private:  // restore original namespace restriction
 809 #endif
 810 
 811   JavaFrameAnchor _anchor;                       // Encapsulation of current java frame and it state
 812 
 813   ThreadFunction _entry_point;
 814 
 815   JNIEnv        _jni_environment;
 816 
 817   // Deopt support
 818   DeoptResourceMark*  _deopt_mark;               // Holds special ResourceMark for deoptimization
 819 
 820   intptr_t*      _must_deopt_id;                 // id of frame that needs to be deopted once we
 821                                                  // transition out of native
 822   nmethod*       _deopt_nmethod;                 // nmethod that is currently being deoptimized
 823   vframeArray*  _vframe_array_head;              // Holds the heap of the active vframeArrays
 824   vframeArray*  _vframe_array_last;              // Holds last vFrameArray we popped
 825   // Because deoptimization is lazy we must save jvmti requests to set locals
 826   // in compiled frames until we deoptimize and we have an interpreter frame.
 827   // This holds the pointer to array (yeah like there might be more than one) of
 828   // description of compiled vframes that have locals that need to be updated.
 829   GrowableArray<jvmtiDeferredLocalVariableSet*>* _deferred_locals_updates;
 830 
 831   // Handshake value for fixing 6243940. We need a place for the i2c
 832   // adapter to store the callee Method*. This value is NEVER live
 833   // across a gc point so it does NOT have to be gc'd
 834   // The handshake is open ended since we can't be certain that it will
 835   // be NULLed. This is because we rarely ever see the race and end up
 836   // in handle_wrong_method which is the backend of the handshake. See
 837   // code in i2c adapters and handle_wrong_method.
 838 
 839   Method*       _callee_target;
 840 
 841   // Used to pass back results to the interpreter or generated code running Java code.
 842   oop           _vm_result;    // oop result is GC-preserved
 843   Metadata*     _vm_result_2;  // non-oop result
 844 
 845   // See ReduceInitialCardMarks: this holds the precise space interval of
 846   // the most recent slow path allocation for which compiled code has
 847   // elided card-marks for performance along the fast-path.
 848   MemRegion     _deferred_card_mark;
 849 
 850   MonitorChunk* _monitor_chunks;                 // Contains the off stack monitors
 851                                                  // allocated during deoptimization
 852                                                  // and by JNI_MonitorEnter/Exit
 853 
 854   // Async. requests support
 855   enum AsyncRequests {
 856     _no_async_condition = 0,
 857     _async_exception,
 858     _async_unsafe_access_error
 859   };
 860   AsyncRequests _special_runtime_exit_condition; // Enum indicating pending async. request
 861   oop           _pending_async_exception;
 862 
 863   // Safepoint support
 864  public:                                         // Expose _thread_state for SafeFetchInt()
 865   volatile JavaThreadState _thread_state;
 866  private:
 867   ThreadSafepointState *_safepoint_state;        // Holds information about a thread during a safepoint
 868   address               _saved_exception_pc;     // Saved pc of instruction where last implicit exception happened
 869 
 870   // JavaThread termination support
 871   enum TerminatedTypes {
 872     _not_terminated = 0xDEAD - 2,
 873     _thread_exiting,                             // JavaThread::exit() has been called for this thread
 874     _thread_terminated,                          // JavaThread is removed from thread list
 875     _vm_exited                                   // JavaThread is still executing native code, but VM is terminated
 876                                                  // only VM_Exit can set _vm_exited
 877   };
 878 
 879   // In general a JavaThread's _terminated field transitions as follows:
 880   //
 881   //   _not_terminated => _thread_exiting => _thread_terminated
 882   //
 883   // _vm_exited is a special value to cover the case of a JavaThread
 884   // executing native code after the VM itself is terminated.
 885   volatile TerminatedTypes _terminated;
 886   // suspend/resume support
 887   volatile bool         _suspend_equivalent;     // Suspend equivalent condition
 888   jint                  _in_deopt_handler;       // count of deoptimization
 889                                                  // handlers thread is in
 890   volatile bool         _doing_unsafe_access;    // Thread may fault due to unsafe access
 891   bool                  _do_not_unlock_if_synchronized; // Do not unlock the receiver of a synchronized method (since it was
 892                                                  // never locked) when throwing an exception. Used by interpreter only.
 893 
 894   // JNI attach states:
 895   enum JNIAttachStates {
 896     _not_attaching_via_jni = 1,  // thread is not attaching via JNI
 897     _attaching_via_jni,          // thread is attaching via JNI
 898     _attached_via_jni            // thread has attached via JNI
 899   };
 900 
 901   // A regular JavaThread's _jni_attach_state is _not_attaching_via_jni.
 902   // A native thread that is attaching via JNI starts with a value
 903   // of _attaching_via_jni and transitions to _attached_via_jni.
 904   volatile JNIAttachStates _jni_attach_state;
 905 
 906  public:
 907   // State of the stack guard pages for this thread.
 908   enum StackGuardState {
 909     stack_guard_unused,         // not needed
 910     stack_guard_yellow_disabled,// disabled (temporarily) after stack overflow
 911     stack_guard_enabled         // enabled
 912   };
 913 
 914  private:
 915 
 916   StackGuardState        _stack_guard_state;
 917 
 918   // Compiler exception handling (NOTE: The _exception_oop is *NOT* the same as _pending_exception. It is
 919   // used to temp. parsing values into and out of the runtime system during exception handling for compiled
 920   // code)
 921   volatile oop     _exception_oop;               // Exception thrown in compiled code
 922   volatile address _exception_pc;                // PC where exception happened
 923   volatile address _exception_handler_pc;        // PC for handler of exception
 924   volatile int     _is_method_handle_return;     // true (== 1) if the current exception PC is a MethodHandle call site.
 925 
 926   // support for compilation
 927   bool    _is_compiling;                         // is true if a compilation is active inthis thread (one compilation per thread possible)
 928 
 929   // support for JNI critical regions
 930   jint    _jni_active_critical;                  // count of entries into JNI critical region
 931 
 932   // For deadlock detection.
 933   int _depth_first_number;
 934 
 935   // JVMTI PopFrame support
 936   // This is set to popframe_pending to signal that top Java frame should be popped immediately
 937   int _popframe_condition;
 938 
 939 #ifndef PRODUCT
 940   int _jmp_ring_index;
 941   struct {
 942       // We use intptr_t instead of address so debugger doesn't try and display strings
 943       intptr_t _target;
 944       intptr_t _instruction;
 945       const char*  _file;
 946       int _line;
 947   }   _jmp_ring[ jump_ring_buffer_size ];
 948 #endif /* PRODUCT */
 949 
 950 #if INCLUDE_ALL_GCS
 951   // Support for G1 barriers
 952 
 953   ObjPtrQueue _satb_mark_queue;          // Thread-local log for SATB barrier.
 954   // Set of all such queues.
 955   static SATBMarkQueueSet _satb_mark_queue_set;
 956 
 957   DirtyCardQueue _dirty_card_queue;      // Thread-local log for dirty cards.
 958   // Set of all such queues.
 959   static DirtyCardQueueSet _dirty_card_queue_set;
 960 
 961   void flush_barrier_queues();
 962 #endif // INCLUDE_ALL_GCS
 963 
 964   friend class VMThread;
 965   friend class ThreadWaitTransition;
 966   friend class VM_Exit;
 967 
 968   void initialize();                             // Initialized the instance variables
 969 
 970  public:
 971   // Constructor
 972   JavaThread(bool is_attaching_via_jni = false); // for main thread and JNI attached threads
 973   JavaThread(ThreadFunction entry_point, size_t stack_size = 0);
 974   ~JavaThread();
 975 
 976 #ifdef ASSERT
 977   // verify this JavaThread hasn't be published in the Threads::list yet
 978   void verify_not_published();
 979 #endif
 980 
 981   //JNI functiontable getter/setter for JVMTI jni function table interception API.
 982   void set_jni_functions(struct JNINativeInterface_* functionTable) {
 983     _jni_environment.functions = functionTable;
 984   }
 985   struct JNINativeInterface_* get_jni_functions() {
 986     return (struct JNINativeInterface_ *)_jni_environment.functions;
 987   }
 988 
 989   // This function is called at thread creation to allow
 990   // platform specific thread variables to be initialized.
 991   void cache_global_variables();
 992 
 993   // Executes Shutdown.shutdown()
 994   void invoke_shutdown_hooks();
 995 
 996   // Cleanup on thread exit
 997   enum ExitType {
 998     normal_exit,
 999     jni_detach
1000   };
1001   void exit(bool destroy_vm, ExitType exit_type = normal_exit);
1002 
1003   void cleanup_failed_attach_current_thread();
1004 
1005   // Testers
1006   virtual bool is_Java_thread() const            { return true;  }
1007 
1008   // compilation
1009   void set_is_compiling(bool f)                  { _is_compiling = f; }
1010   bool is_compiling() const                      { return _is_compiling; }
1011 
1012   // Thread chain operations
1013   JavaThread* next() const                       { return _next; }
1014   void set_next(JavaThread* p)                   { _next = p; }
1015 
1016   // Thread oop. threadObj() can be NULL for initial JavaThread
1017   // (or for threads attached via JNI)
1018   oop threadObj() const                          { return _threadObj; }
1019   void set_threadObj(oop p)                      { _threadObj = p; }
1020 
1021   ThreadPriority java_priority() const;          // Read from threadObj()
1022 
1023   // Prepare thread and add to priority queue.  If a priority is
1024   // not specified, use the priority of the thread object. Threads_lock
1025   // must be held while this function is called.
1026   void prepare(jobject jni_thread, ThreadPriority prio=NoPriority);
1027 
1028   void set_saved_exception_pc(address pc)        { _saved_exception_pc = pc; }
1029   address saved_exception_pc()                   { return _saved_exception_pc; }
1030 
1031 
1032   ThreadFunction entry_point() const             { return _entry_point; }
1033 
1034   // Allocates a new Java level thread object for this thread. thread_name may be NULL.
1035   void allocate_threadObj(Handle thread_group, char* thread_name, bool daemon, TRAPS);
1036 
1037   // Last frame anchor routines
1038 
1039   JavaFrameAnchor* frame_anchor(void)                { return &_anchor; }
1040 
1041   // last_Java_sp
1042   bool has_last_Java_frame() const                   { return _anchor.has_last_Java_frame(); }
1043   intptr_t* last_Java_sp() const                     { return _anchor.last_Java_sp(); }
1044 
1045   // last_Java_pc
1046 
1047   address last_Java_pc(void)                         { return _anchor.last_Java_pc(); }
1048 
1049   // Safepoint support
1050   JavaThreadState thread_state() const           { return _thread_state; }
1051   void set_thread_state(JavaThreadState s)       { _thread_state=s;      }
1052   ThreadSafepointState *safepoint_state() const  { return _safepoint_state;  }
1053   void set_safepoint_state(ThreadSafepointState *state) { _safepoint_state = state; }
1054   bool is_at_poll_safepoint()                    { return _safepoint_state->is_at_poll_safepoint(); }
1055 
1056   // thread has called JavaThread::exit() or is terminated
1057   bool is_exiting()                              { return _terminated == _thread_exiting || is_terminated(); }
1058   // thread is terminated (no longer on the threads list); we compare
1059   // against the two non-terminated values so that a freed JavaThread
1060   // will also be considered terminated.
1061   bool is_terminated()                           { return _terminated != _not_terminated && _terminated != _thread_exiting; }
1062   void set_terminated(TerminatedTypes t)         { _terminated = t; }
1063   // special for Threads::remove() which is static:
1064   void set_terminated_value()                    { _terminated = _thread_terminated; }
1065   void block_if_vm_exited();
1066 
1067   bool doing_unsafe_access()                     { return _doing_unsafe_access; }
1068   void set_doing_unsafe_access(bool val)         { _doing_unsafe_access = val; }
1069 
1070   bool do_not_unlock_if_synchronized()             { return _do_not_unlock_if_synchronized; }
1071   void set_do_not_unlock_if_synchronized(bool val) { _do_not_unlock_if_synchronized = val; }
1072 
1073 #if INCLUDE_NMT
1074   // native memory tracking
1075   inline MemRecorder* get_recorder() const          { return (MemRecorder*)_recorder; }
1076   inline void         set_recorder(MemRecorder* rc) { _recorder = rc; }
1077 
1078  private:
1079   // per-thread memory recorder
1080   MemRecorder* volatile _recorder;
1081 #endif // INCLUDE_NMT
1082 
1083   // Suspend/resume support for JavaThread
1084  private:
1085   void set_ext_suspended()       { set_suspend_flag (_ext_suspended);  }
1086   void clear_ext_suspended()     { clear_suspend_flag(_ext_suspended); }
1087 
1088  public:
1089   void java_suspend();
1090   void java_resume();
1091   int  java_suspend_self();
1092 
1093   void check_and_wait_while_suspended() {
1094     assert(JavaThread::current() == this, "sanity check");
1095 
1096     bool do_self_suspend;
1097     do {
1098       // were we externally suspended while we were waiting?
1099       do_self_suspend = handle_special_suspend_equivalent_condition();
1100       if (do_self_suspend) {
1101         // don't surprise the thread that suspended us by returning
1102         java_suspend_self();
1103         set_suspend_equivalent();
1104       }
1105     } while (do_self_suspend);
1106   }
1107   static void check_safepoint_and_suspend_for_native_trans(JavaThread *thread);
1108   // Check for async exception in addition to safepoint and suspend request.
1109   static void check_special_condition_for_native_trans(JavaThread *thread);
1110 
1111   // Same as check_special_condition_for_native_trans but finishes the
1112   // transition into thread_in_Java mode so that it can potentially
1113   // block.
1114   static void check_special_condition_for_native_trans_and_transition(JavaThread *thread);
1115 
1116   bool is_ext_suspend_completed(bool called_by_wait, int delay, uint32_t *bits);
1117   bool is_ext_suspend_completed_with_lock(uint32_t *bits) {
1118     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1119     // Warning: is_ext_suspend_completed() may temporarily drop the
1120     // SR_lock to allow the thread to reach a stable thread state if
1121     // it is currently in a transient thread state.
1122     return is_ext_suspend_completed(false /*!called_by_wait */,
1123                                     SuspendRetryDelay, bits);
1124   }
1125 
1126   // We cannot allow wait_for_ext_suspend_completion() to run forever or
1127   // we could hang. SuspendRetryCount and SuspendRetryDelay are normally
1128   // passed as the count and delay parameters. Experiments with specific
1129   // calls to wait_for_ext_suspend_completion() can be done by passing
1130   // other values in the code. Experiments with all calls can be done
1131   // via the appropriate -XX options.
1132   bool wait_for_ext_suspend_completion(int count, int delay, uint32_t *bits);
1133 
1134   void set_external_suspend()     { set_suspend_flag  (_external_suspend); }
1135   void clear_external_suspend()   { clear_suspend_flag(_external_suspend); }
1136 
1137   void set_deopt_suspend()        { set_suspend_flag  (_deopt_suspend); }
1138   void clear_deopt_suspend()      { clear_suspend_flag(_deopt_suspend); }
1139   bool is_deopt_suspend()         { return (_suspend_flags & _deopt_suspend) != 0; }
1140 
1141   bool is_external_suspend() const {
1142     return (_suspend_flags & _external_suspend) != 0;
1143   }
1144   // Whenever a thread transitions from native to vm/java it must suspend
1145   // if external|deopt suspend is present.
1146   bool is_suspend_after_native() const {
1147     return (_suspend_flags & (_external_suspend | _deopt_suspend) ) != 0;
1148   }
1149 
1150   // external suspend request is completed
1151   bool is_ext_suspended() const {
1152     return (_suspend_flags & _ext_suspended) != 0;
1153   }
1154 
1155   bool is_external_suspend_with_lock() const {
1156     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1157     return is_external_suspend();
1158   }
1159 
1160   // Special method to handle a pending external suspend request
1161   // when a suspend equivalent condition lifts.
1162   bool handle_special_suspend_equivalent_condition() {
1163     assert(is_suspend_equivalent(),
1164       "should only be called in a suspend equivalence condition");
1165     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1166     bool ret = is_external_suspend();
1167     if (!ret) {
1168       // not about to self-suspend so clear suspend equivalence
1169       clear_suspend_equivalent();
1170     }
1171     // implied else:
1172     // We have a pending external suspend request so we leave the
1173     // suspend_equivalent flag set until java_suspend_self() sets
1174     // the ext_suspended flag and clears the suspend_equivalent
1175     // flag. This insures that wait_for_ext_suspend_completion()
1176     // will return consistent values.
1177     return ret;
1178   }
1179 
1180   // utility methods to see if we are doing some kind of suspension
1181   bool is_being_ext_suspended() const            {
1182     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1183     return is_ext_suspended() || is_external_suspend();
1184   }
1185 
1186   bool is_suspend_equivalent() const             { return _suspend_equivalent; }
1187 
1188   void set_suspend_equivalent()                  { _suspend_equivalent = true; };
1189   void clear_suspend_equivalent()                { _suspend_equivalent = false; };
1190 
1191   // Thread.stop support
1192   void send_thread_stop(oop throwable);
1193   AsyncRequests clear_special_runtime_exit_condition() {
1194     AsyncRequests x = _special_runtime_exit_condition;
1195     _special_runtime_exit_condition = _no_async_condition;
1196     return x;
1197   }
1198 
1199   // Are any async conditions present?
1200   bool has_async_condition() { return (_special_runtime_exit_condition != _no_async_condition); }
1201 
1202   void check_and_handle_async_exceptions(bool check_unsafe_error = true);
1203 
1204   // these next two are also used for self-suspension and async exception support
1205   void handle_special_runtime_exit_condition(bool check_asyncs = true);
1206 
1207   // Return true if JavaThread has an asynchronous condition or
1208   // if external suspension is requested.
1209   bool has_special_runtime_exit_condition() {
1210     // We call is_external_suspend() last since external suspend should
1211     // be less common. Because we don't use is_external_suspend_with_lock
1212     // it is possible that we won't see an asynchronous external suspend
1213     // request that has just gotten started, i.e., SR_lock grabbed but
1214     // _external_suspend field change either not made yet or not visible
1215     // yet. However, this is okay because the request is asynchronous and
1216     // we will see the new flag value the next time through. It's also
1217     // possible that the external suspend request is dropped after
1218     // we have checked is_external_suspend(), we will recheck its value
1219     // under SR_lock in java_suspend_self().
1220     return (_special_runtime_exit_condition != _no_async_condition) ||
1221             is_external_suspend() || is_deopt_suspend();
1222   }
1223 
1224   void set_pending_unsafe_access_error()          { _special_runtime_exit_condition = _async_unsafe_access_error; }
1225 
1226   void set_pending_async_exception(oop e) {
1227     _pending_async_exception = e;
1228     _special_runtime_exit_condition = _async_exception;
1229     set_has_async_exception();
1230   }
1231 
1232   // Fast-locking support
1233   bool is_lock_owned(address adr) const;
1234 
1235   // Accessors for vframe array top
1236   // The linked list of vframe arrays are sorted on sp. This means when we
1237   // unpack the head must contain the vframe array to unpack.
1238   void set_vframe_array_head(vframeArray* value) { _vframe_array_head = value; }
1239   vframeArray* vframe_array_head() const         { return _vframe_array_head;  }
1240 
1241   // Side structure for defering update of java frame locals until deopt occurs
1242   GrowableArray<jvmtiDeferredLocalVariableSet*>* deferred_locals() const { return _deferred_locals_updates; }
1243   void set_deferred_locals(GrowableArray<jvmtiDeferredLocalVariableSet *>* vf) { _deferred_locals_updates = vf; }
1244 
1245   // These only really exist to make debugging deopt problems simpler
1246 
1247   void set_vframe_array_last(vframeArray* value) { _vframe_array_last = value; }
1248   vframeArray* vframe_array_last() const         { return _vframe_array_last;  }
1249 
1250   // The special resourceMark used during deoptimization
1251 
1252   void set_deopt_mark(DeoptResourceMark* value)  { _deopt_mark = value; }
1253   DeoptResourceMark* deopt_mark(void)            { return _deopt_mark; }
1254 
1255   intptr_t* must_deopt_id()                      { return _must_deopt_id; }
1256   void     set_must_deopt_id(intptr_t* id)       { _must_deopt_id = id; }
1257   void     clear_must_deopt_id()                 { _must_deopt_id = NULL; }
1258 
1259   void set_deopt_nmethod(nmethod* nm)            { _deopt_nmethod = nm;   }
1260   nmethod* deopt_nmethod()                       { return _deopt_nmethod; }
1261 
1262   Method*    callee_target() const               { return _callee_target; }
1263   void set_callee_target  (Method* x)          { _callee_target   = x; }
1264 
1265   // Oop results of vm runtime calls
1266   oop  vm_result() const                         { return _vm_result; }
1267   void set_vm_result  (oop x)                    { _vm_result   = x; }
1268 
1269   Metadata*    vm_result_2() const               { return _vm_result_2; }
1270   void set_vm_result_2  (Metadata* x)          { _vm_result_2   = x; }
1271 
1272   MemRegion deferred_card_mark() const           { return _deferred_card_mark; }
1273   void set_deferred_card_mark(MemRegion mr)      { _deferred_card_mark = mr;   }
1274 
1275   // Exception handling for compiled methods
1276   oop      exception_oop() const                 { return _exception_oop; }
1277   address  exception_pc() const                  { return _exception_pc; }
1278   address  exception_handler_pc() const          { return _exception_handler_pc; }
1279   bool     is_method_handle_return() const       { return _is_method_handle_return == 1; }
1280 
1281   void set_exception_oop(oop o)                  { _exception_oop = o; }
1282   void set_exception_pc(address a)               { _exception_pc = a; }
1283   void set_exception_handler_pc(address a)       { _exception_handler_pc = a; }
1284   void set_is_method_handle_return(bool value)   { _is_method_handle_return = value ? 1 : 0; }
1285 
1286   // Stack overflow support
1287   inline size_t stack_available(address cur_sp);
1288   address stack_yellow_zone_base()
1289     { return (address)(stack_base() - (stack_size() - (stack_red_zone_size() + stack_yellow_zone_size()))); }
1290   size_t  stack_yellow_zone_size()
1291     { return StackYellowPages * os::vm_page_size(); }
1292   address stack_red_zone_base()
1293     { return (address)(stack_base() - (stack_size() - stack_red_zone_size())); }
1294   size_t stack_red_zone_size()
1295     { return StackRedPages * os::vm_page_size(); }
1296   bool in_stack_yellow_zone(address a)
1297     { return (a <= stack_yellow_zone_base()) && (a >= stack_red_zone_base()); }
1298   bool in_stack_red_zone(address a)
1299     { return (a <= stack_red_zone_base()) && (a >= (address)((intptr_t)stack_base() - stack_size())); }
1300 
1301   void create_stack_guard_pages();
1302   void remove_stack_guard_pages();
1303 
1304   void enable_stack_yellow_zone();
1305   void disable_stack_yellow_zone();
1306   void enable_stack_red_zone();
1307   void disable_stack_red_zone();
1308 
1309   inline bool stack_guard_zone_unused();
1310   inline bool stack_yellow_zone_disabled();
1311   inline bool stack_yellow_zone_enabled();
1312 
1313   // Attempt to reguard the stack after a stack overflow may have occurred.
1314   // Returns true if (a) guard pages are not needed on this thread, (b) the
1315   // pages are already guarded, or (c) the pages were successfully reguarded.
1316   // Returns false if there is not enough stack space to reguard the pages, in
1317   // which case the caller should unwind a frame and try again.  The argument
1318   // should be the caller's (approximate) sp.
1319   bool reguard_stack(address cur_sp);
1320   // Similar to above but see if current stackpoint is out of the guard area
1321   // and reguard if possible.
1322   bool reguard_stack(void);
1323 
1324   // Misc. accessors/mutators
1325   void set_do_not_unlock(void)                   { _do_not_unlock_if_synchronized = true; }
1326   void clr_do_not_unlock(void)                   { _do_not_unlock_if_synchronized = false; }
1327   bool do_not_unlock(void)                       { return _do_not_unlock_if_synchronized; }
1328 
1329 #ifndef PRODUCT
1330   void record_jump(address target, address instr, const char* file, int line);
1331 #endif /* PRODUCT */
1332 
1333   // For assembly stub generation
1334   static ByteSize threadObj_offset()             { return byte_offset_of(JavaThread, _threadObj           ); }
1335 #ifndef PRODUCT
1336   static ByteSize jmp_ring_index_offset()        { return byte_offset_of(JavaThread, _jmp_ring_index      ); }
1337   static ByteSize jmp_ring_offset()              { return byte_offset_of(JavaThread, _jmp_ring            ); }
1338 #endif /* PRODUCT */
1339   static ByteSize jni_environment_offset()       { return byte_offset_of(JavaThread, _jni_environment     ); }
1340   static ByteSize last_Java_sp_offset()          {
1341     return byte_offset_of(JavaThread, _anchor) + JavaFrameAnchor::last_Java_sp_offset();
1342   }
1343   static ByteSize last_Java_pc_offset()          {
1344     return byte_offset_of(JavaThread, _anchor) + JavaFrameAnchor::last_Java_pc_offset();
1345   }
1346   static ByteSize frame_anchor_offset()          {
1347     return byte_offset_of(JavaThread, _anchor);
1348   }
1349   static ByteSize callee_target_offset()         { return byte_offset_of(JavaThread, _callee_target       ); }
1350   static ByteSize vm_result_offset()             { return byte_offset_of(JavaThread, _vm_result           ); }
1351   static ByteSize vm_result_2_offset()           { return byte_offset_of(JavaThread, _vm_result_2         ); }
1352   static ByteSize thread_state_offset()          { return byte_offset_of(JavaThread, _thread_state        ); }
1353   static ByteSize saved_exception_pc_offset()    { return byte_offset_of(JavaThread, _saved_exception_pc  ); }
1354   static ByteSize osthread_offset()              { return byte_offset_of(JavaThread, _osthread            ); }
1355   static ByteSize exception_oop_offset()         { return byte_offset_of(JavaThread, _exception_oop       ); }
1356   static ByteSize exception_pc_offset()          { return byte_offset_of(JavaThread, _exception_pc        ); }
1357   static ByteSize exception_handler_pc_offset()  { return byte_offset_of(JavaThread, _exception_handler_pc); }
1358   static ByteSize is_method_handle_return_offset() { return byte_offset_of(JavaThread, _is_method_handle_return); }
1359   static ByteSize stack_guard_state_offset()     { return byte_offset_of(JavaThread, _stack_guard_state   ); }
1360   static ByteSize suspend_flags_offset()         { return byte_offset_of(JavaThread, _suspend_flags       ); }
1361 
1362   static ByteSize do_not_unlock_if_synchronized_offset() { return byte_offset_of(JavaThread, _do_not_unlock_if_synchronized); }
1363   static ByteSize should_post_on_exceptions_flag_offset() {
1364     return byte_offset_of(JavaThread, _should_post_on_exceptions_flag);
1365   }
1366 
1367 #if INCLUDE_ALL_GCS
1368   static ByteSize satb_mark_queue_offset()       { return byte_offset_of(JavaThread, _satb_mark_queue); }
1369   static ByteSize dirty_card_queue_offset()      { return byte_offset_of(JavaThread, _dirty_card_queue); }
1370 #endif // INCLUDE_ALL_GCS
1371 
1372   // Returns the jni environment for this thread
1373   JNIEnv* jni_environment()                      { return &_jni_environment; }
1374 
1375   static JavaThread* thread_from_jni_environment(JNIEnv* env) {
1376     JavaThread *thread_from_jni_env = (JavaThread*)((intptr_t)env - in_bytes(jni_environment_offset()));
1377     // Only return NULL if thread is off the thread list; starting to
1378     // exit should not return NULL.
1379     if (thread_from_jni_env->is_terminated()) {
1380        thread_from_jni_env->block_if_vm_exited();
1381        return NULL;
1382     } else {
1383        return thread_from_jni_env;
1384     }
1385   }
1386 
1387   // JNI critical regions. These can nest.
1388   bool in_critical()    { return _jni_active_critical > 0; }
1389   bool in_last_critical()  { return _jni_active_critical == 1; }
1390   void enter_critical() { assert(Thread::current() == this ||
1391                                  Thread::current()->is_VM_thread() && SafepointSynchronize::is_synchronizing(),
1392                                  "this must be current thread or synchronizing");
1393                           _jni_active_critical++; }
1394   void exit_critical()  { assert(Thread::current() == this,
1395                                  "this must be current thread");
1396                           _jni_active_critical--;
1397                           assert(_jni_active_critical >= 0,
1398                                  "JNI critical nesting problem?"); }
1399 
1400   // For deadlock detection
1401   int depth_first_number() { return _depth_first_number; }
1402   void set_depth_first_number(int dfn) { _depth_first_number = dfn; }
1403 
1404  private:
1405   void set_monitor_chunks(MonitorChunk* monitor_chunks) { _monitor_chunks = monitor_chunks; }
1406 
1407  public:
1408   MonitorChunk* monitor_chunks() const           { return _monitor_chunks; }
1409   void add_monitor_chunk(MonitorChunk* chunk);
1410   void remove_monitor_chunk(MonitorChunk* chunk);
1411   bool in_deopt_handler() const                  { return _in_deopt_handler > 0; }
1412   void inc_in_deopt_handler()                    { _in_deopt_handler++; }
1413   void dec_in_deopt_handler()                    {
1414     assert(_in_deopt_handler > 0, "mismatched deopt nesting");
1415     if (_in_deopt_handler > 0) { // robustness
1416       _in_deopt_handler--;
1417     }
1418   }
1419 
1420  private:
1421   void set_entry_point(ThreadFunction entry_point) { _entry_point = entry_point; }
1422 
1423  public:
1424 
1425   // Frame iteration; calls the function f for all frames on the stack
1426   void frames_do(void f(frame*, const RegisterMap*));
1427 
1428   // Memory operations
1429   void oops_do(OopClosure* f, CLDToOopClosure* cld_f, CodeBlobClosure* cf);
1430 
1431   // Sweeper operations
1432   void nmethods_do(CodeBlobClosure* cf);
1433 
1434   // RedefineClasses Support
1435   void metadata_do(void f(Metadata*));
1436 
1437   // Memory management operations
1438   void gc_epilogue();
1439   void gc_prologue();
1440 
1441   // Misc. operations
1442   char* name() const { return (char*)get_thread_name(); }
1443   void print_on(outputStream* st) const;
1444   void print() const { print_on(tty); }
1445   void print_value();
1446   void print_thread_state_on(outputStream* ) const      PRODUCT_RETURN;
1447   void print_thread_state() const                       PRODUCT_RETURN;
1448   void print_on_error(outputStream* st, char* buf, int buflen) const;
1449   void verify();
1450   const char* get_thread_name() const;
1451 private:
1452   // factor out low-level mechanics for use in both normal and error cases
1453   const char* get_thread_name_string(char* buf = NULL, int buflen = 0) const;
1454 public:
1455   const char* get_threadgroup_name() const;
1456   const char* get_parent_name() const;
1457 
1458   // Accessing frames
1459   frame last_frame() {
1460     _anchor.make_walkable(this);
1461     return pd_last_frame();
1462   }
1463   javaVFrame* last_java_vframe(RegisterMap* reg_map);
1464 
1465   // Returns method at 'depth' java or native frames down the stack
1466   // Used for security checks
1467   Klass* security_get_caller_class(int depth);
1468 
1469   // Print stack trace in external format
1470   void print_stack_on(outputStream* st);
1471   void print_stack() { print_stack_on(tty); }
1472 
1473   // Print stack traces in various internal formats
1474   void trace_stack()                             PRODUCT_RETURN;
1475   void trace_stack_from(vframe* start_vf)        PRODUCT_RETURN;
1476   void trace_frames()                            PRODUCT_RETURN;
1477   void trace_oops()                              PRODUCT_RETURN;
1478 
1479   // Print an annotated view of the stack frames
1480   void print_frame_layout(int depth = 0, bool validate_only = false) NOT_DEBUG_RETURN;
1481   void validate_frame_layout() {
1482     print_frame_layout(0, true);
1483   }
1484 
1485   // Returns the number of stack frames on the stack
1486   int depth() const;
1487 
1488   // Function for testing deoptimization
1489   void deoptimize();
1490   void make_zombies();
1491 
1492   void deoptimized_wrt_marked_nmethods();
1493 
1494   // Profiling operation (see fprofile.cpp)
1495  public:
1496    bool profile_last_Java_frame(frame* fr);
1497 
1498  private:
1499    ThreadProfiler* _thread_profiler;
1500  private:
1501    friend class FlatProfiler;                    // uses both [gs]et_thread_profiler.
1502    friend class FlatProfilerTask;                // uses get_thread_profiler.
1503    friend class ThreadProfilerMark;              // uses get_thread_profiler.
1504    ThreadProfiler* get_thread_profiler()         { return _thread_profiler; }
1505    ThreadProfiler* set_thread_profiler(ThreadProfiler* tp) {
1506      ThreadProfiler* result = _thread_profiler;
1507      _thread_profiler = tp;
1508      return result;
1509    }
1510 
1511  // NMT (Native memory tracking) support.
1512  // This flag helps NMT to determine if this JavaThread will be blocked
1513  // at safepoint. If not, ThreadCritical is needed for writing memory records.
1514  // JavaThread is only safepoint visible when it is in Threads' thread list,
1515  // it is not visible until it is added to the list and becomes invisible
1516  // once it is removed from the list.
1517  public:
1518   bool is_safepoint_visible() const { return _safepoint_visible; }
1519   void set_safepoint_visible(bool visible) { _safepoint_visible = visible; }
1520  private:
1521   bool _safepoint_visible;
1522 
1523   // Static operations
1524  public:
1525   // Returns the running thread as a JavaThread
1526   static inline JavaThread* current();
1527 
1528   // Returns the active Java thread.  Do not use this if you know you are calling
1529   // from a JavaThread, as it's slower than JavaThread::current.  If called from
1530   // the VMThread, it also returns the JavaThread that instigated the VMThread's
1531   // operation.  You may not want that either.
1532   static JavaThread* active();
1533 
1534   inline CompilerThread* as_CompilerThread();
1535 
1536  public:
1537   virtual void run();
1538   void thread_main_inner();
1539 
1540  private:
1541   // PRIVILEGED STACK
1542   PrivilegedElement*  _privileged_stack_top;
1543   GrowableArray<oop>* _array_for_gc;
1544  public:
1545 
1546   // Returns the privileged_stack information.
1547   PrivilegedElement* privileged_stack_top() const       { return _privileged_stack_top; }
1548   void set_privileged_stack_top(PrivilegedElement *e)   { _privileged_stack_top = e; }
1549   void register_array_for_gc(GrowableArray<oop>* array) { _array_for_gc = array; }
1550 
1551  public:
1552   // Thread local information maintained by JVMTI.
1553   void set_jvmti_thread_state(JvmtiThreadState *value)                           { _jvmti_thread_state = value; }
1554   // A JvmtiThreadState is lazily allocated. This jvmti_thread_state()
1555   // getter is used to get this JavaThread's JvmtiThreadState if it has
1556   // one which means NULL can be returned. JvmtiThreadState::state_for()
1557   // is used to get the specified JavaThread's JvmtiThreadState if it has
1558   // one or it allocates a new JvmtiThreadState for the JavaThread and
1559   // returns it. JvmtiThreadState::state_for() will return NULL only if
1560   // the specified JavaThread is exiting.
1561   JvmtiThreadState *jvmti_thread_state() const                                   { return _jvmti_thread_state; }
1562   static ByteSize jvmti_thread_state_offset()                                    { return byte_offset_of(JavaThread, _jvmti_thread_state); }
1563   void set_jvmti_get_loaded_classes_closure(JvmtiGetLoadedClassesClosure* value) { _jvmti_get_loaded_classes_closure = value; }
1564   JvmtiGetLoadedClassesClosure* get_jvmti_get_loaded_classes_closure() const     { return _jvmti_get_loaded_classes_closure; }
1565 
1566   // JVMTI PopFrame support
1567   // Setting and clearing popframe_condition
1568   // All of these enumerated values are bits. popframe_pending
1569   // indicates that a PopFrame() has been requested and not yet been
1570   // completed. popframe_processing indicates that that PopFrame() is in
1571   // the process of being completed. popframe_force_deopt_reexecution_bit
1572   // indicates that special handling is required when returning to a
1573   // deoptimized caller.
1574   enum PopCondition {
1575     popframe_inactive                      = 0x00,
1576     popframe_pending_bit                   = 0x01,
1577     popframe_processing_bit                = 0x02,
1578     popframe_force_deopt_reexecution_bit   = 0x04
1579   };
1580   PopCondition popframe_condition()                   { return (PopCondition) _popframe_condition; }
1581   void set_popframe_condition(PopCondition c)         { _popframe_condition = c; }
1582   void set_popframe_condition_bit(PopCondition c)     { _popframe_condition |= c; }
1583   void clear_popframe_condition()                     { _popframe_condition = popframe_inactive; }
1584   static ByteSize popframe_condition_offset()         { return byte_offset_of(JavaThread, _popframe_condition); }
1585   bool has_pending_popframe()                         { return (popframe_condition() & popframe_pending_bit) != 0; }
1586   bool popframe_forcing_deopt_reexecution()           { return (popframe_condition() & popframe_force_deopt_reexecution_bit) != 0; }
1587   void clear_popframe_forcing_deopt_reexecution()     { _popframe_condition &= ~popframe_force_deopt_reexecution_bit; }
1588 #ifdef CC_INTERP
1589   bool pop_frame_pending(void)                        { return ((_popframe_condition & popframe_pending_bit) != 0); }
1590   void clr_pop_frame_pending(void)                    { _popframe_condition = popframe_inactive; }
1591   bool pop_frame_in_process(void)                     { return ((_popframe_condition & popframe_processing_bit) != 0); }
1592   void set_pop_frame_in_process(void)                 { _popframe_condition |= popframe_processing_bit; }
1593   void clr_pop_frame_in_process(void)                 { _popframe_condition &= ~popframe_processing_bit; }
1594 #endif
1595 
1596  private:
1597   // Saved incoming arguments to popped frame.
1598   // Used only when popped interpreted frame returns to deoptimized frame.
1599   void*    _popframe_preserved_args;
1600   int      _popframe_preserved_args_size;
1601 
1602  public:
1603   void  popframe_preserve_args(ByteSize size_in_bytes, void* start);
1604   void* popframe_preserved_args();
1605   ByteSize popframe_preserved_args_size();
1606   WordSize popframe_preserved_args_size_in_words();
1607   void  popframe_free_preserved_args();
1608 
1609 
1610  private:
1611   JvmtiThreadState *_jvmti_thread_state;
1612   JvmtiGetLoadedClassesClosure* _jvmti_get_loaded_classes_closure;
1613 
1614   // Used by the interpreter in fullspeed mode for frame pop, method
1615   // entry, method exit and single stepping support. This field is
1616   // only set to non-zero by the VM_EnterInterpOnlyMode VM operation.
1617   // It can be set to zero asynchronously (i.e., without a VM operation
1618   // or a lock) so we have to be very careful.
1619   int               _interp_only_mode;
1620 
1621  public:
1622   // used by the interpreter for fullspeed debugging support (see above)
1623   static ByteSize interp_only_mode_offset() { return byte_offset_of(JavaThread, _interp_only_mode); }
1624   bool is_interp_only_mode()                { return (_interp_only_mode != 0); }
1625   int get_interp_only_mode()                { return _interp_only_mode; }
1626   void increment_interp_only_mode()         { ++_interp_only_mode; }
1627   void decrement_interp_only_mode()         { --_interp_only_mode; }
1628 
1629   // support for cached flag that indicates whether exceptions need to be posted for this thread
1630   // if this is false, we can avoid deoptimizing when events are thrown
1631   // this gets set to reflect whether jvmtiExport::post_exception_throw would actually do anything
1632  private:
1633   int    _should_post_on_exceptions_flag;
1634 
1635  public:
1636   int   should_post_on_exceptions_flag()  { return _should_post_on_exceptions_flag; }
1637   void  set_should_post_on_exceptions_flag(int val)  { _should_post_on_exceptions_flag = val; }
1638 
1639  private:
1640   ThreadStatistics *_thread_stat;
1641 
1642  public:
1643   ThreadStatistics* get_thread_stat() const    { return _thread_stat; }
1644 
1645   // Return a blocker object for which this thread is blocked parking.
1646   oop current_park_blocker();
1647 
1648  private:
1649   static size_t _stack_size_at_create;
1650 
1651  public:
1652   static inline size_t stack_size_at_create(void) {
1653     return _stack_size_at_create;
1654   }
1655   static inline void set_stack_size_at_create(size_t value) {
1656     _stack_size_at_create = value;
1657   }
1658 
1659 #if INCLUDE_ALL_GCS
1660   // SATB marking queue support
1661   ObjPtrQueue& satb_mark_queue() { return _satb_mark_queue; }
1662   static SATBMarkQueueSet& satb_mark_queue_set() {
1663     return _satb_mark_queue_set;
1664   }
1665 
1666   // Dirty card queue support
1667   DirtyCardQueue& dirty_card_queue() { return _dirty_card_queue; }
1668   static DirtyCardQueueSet& dirty_card_queue_set() {
1669     return _dirty_card_queue_set;
1670   }
1671 #endif // INCLUDE_ALL_GCS
1672 
1673   // This method initializes the SATB and dirty card queues before a
1674   // JavaThread is added to the Java thread list. Right now, we don't
1675   // have to do anything to the dirty card queue (it should have been
1676   // activated when the thread was created), but we have to activate
1677   // the SATB queue if the thread is created while a marking cycle is
1678   // in progress. The activation / de-activation of the SATB queues at
1679   // the beginning / end of a marking cycle is done during safepoints
1680   // so we have to make sure this method is called outside one to be
1681   // able to safely read the active field of the SATB queue set. Right
1682   // now, it is called just before the thread is added to the Java
1683   // thread list in the Threads::add() method. That method is holding
1684   // the Threads_lock which ensures we are outside a safepoint. We
1685   // cannot do the obvious and set the active field of the SATB queue
1686   // when the thread is created given that, in some cases, safepoints
1687   // might happen between the JavaThread constructor being called and the
1688   // thread being added to the Java thread list (an example of this is
1689   // when the structure for the DestroyJavaVM thread is created).
1690 #if INCLUDE_ALL_GCS
1691   void initialize_queues();
1692 #else  // INCLUDE_ALL_GCS
1693   void initialize_queues() { }
1694 #endif // INCLUDE_ALL_GCS
1695 
1696   // Machine dependent stuff
1697 #ifdef TARGET_OS_ARCH_linux_x86
1698 # include "thread_linux_x86.hpp"
1699 #endif
1700 #ifdef TARGET_OS_ARCH_linux_sparc
1701 # include "thread_linux_sparc.hpp"
1702 #endif
1703 #ifdef TARGET_OS_ARCH_linux_zero
1704 # include "thread_linux_zero.hpp"
1705 #endif
1706 #ifdef TARGET_OS_ARCH_solaris_x86
1707 # include "thread_solaris_x86.hpp"
1708 #endif
1709 #ifdef TARGET_OS_ARCH_solaris_sparc
1710 # include "thread_solaris_sparc.hpp"
1711 #endif
1712 #ifdef TARGET_OS_ARCH_windows_x86
1713 # include "thread_windows_x86.hpp"
1714 #endif
1715 #ifdef TARGET_OS_ARCH_linux_arm
1716 # include "thread_linux_arm.hpp"
1717 #endif
1718 #ifdef TARGET_OS_ARCH_linux_ppc
1719 # include "thread_linux_ppc.hpp"
1720 #endif
1721 #ifdef TARGET_OS_ARCH_bsd_x86
1722 # include "thread_bsd_x86.hpp"
1723 #endif
1724 #ifdef TARGET_OS_ARCH_bsd_zero
1725 # include "thread_bsd_zero.hpp"
1726 #endif
1727 
1728 
1729  public:
1730   void set_blocked_on_compilation(bool value) {
1731     _blocked_on_compilation = value;
1732   }
1733 
1734   bool blocked_on_compilation() {
1735     return _blocked_on_compilation;
1736   }
1737  protected:
1738   bool         _blocked_on_compilation;
1739 
1740 
1741   // JSR166 per-thread parker
1742 private:
1743   Parker*    _parker;
1744 public:
1745   Parker*     parker() { return _parker; }
1746 
1747   // Biased locking support
1748 private:
1749   GrowableArray<MonitorInfo*>* _cached_monitor_info;
1750 public:
1751   GrowableArray<MonitorInfo*>* cached_monitor_info() { return _cached_monitor_info; }
1752   void set_cached_monitor_info(GrowableArray<MonitorInfo*>* info) { _cached_monitor_info = info; }
1753 
1754   // clearing/querying jni attach status
1755   bool is_attaching_via_jni() const { return _jni_attach_state == _attaching_via_jni; }
1756   bool has_attached_via_jni() const { return is_attaching_via_jni() || _jni_attach_state == _attached_via_jni; }
1757   void set_done_attaching_via_jni() { _jni_attach_state = _attached_via_jni; OrderAccess::fence(); }
1758 private:
1759   // This field is used to determine if a thread has claimed
1760   // a par_id: it is -1 if the thread has not claimed a par_id;
1761   // otherwise its value is the par_id that has been claimed.
1762   int _claimed_par_id;
1763 public:
1764   int get_claimed_par_id() { return _claimed_par_id; }
1765   void set_claimed_par_id(int id) { _claimed_par_id = id;}
1766 };
1767 
1768 // Inline implementation of JavaThread::current
1769 inline JavaThread* JavaThread::current() {
1770   Thread* thread = ThreadLocalStorage::thread();
1771   assert(thread != NULL && thread->is_Java_thread(), "just checking");
1772   return (JavaThread*)thread;
1773 }
1774 
1775 inline CompilerThread* JavaThread::as_CompilerThread() {
1776   assert(is_Compiler_thread(), "just checking");
1777   return (CompilerThread*)this;
1778 }
1779 
1780 inline bool JavaThread::stack_guard_zone_unused() {
1781   return _stack_guard_state == stack_guard_unused;
1782 }
1783 
1784 inline bool JavaThread::stack_yellow_zone_disabled() {
1785   return _stack_guard_state == stack_guard_yellow_disabled;
1786 }
1787 
1788 inline bool JavaThread::stack_yellow_zone_enabled() {
1789 #ifdef ASSERT
1790   if (os::uses_stack_guard_pages()) {
1791     assert(_stack_guard_state != stack_guard_unused, "guard pages must be in use");
1792   }
1793 #endif
1794     return _stack_guard_state == stack_guard_enabled;
1795 }
1796 
1797 inline size_t JavaThread::stack_available(address cur_sp) {
1798   // This code assumes java stacks grow down
1799   address low_addr; // Limit on the address for deepest stack depth
1800   if ( _stack_guard_state == stack_guard_unused) {
1801     low_addr =  stack_base() - stack_size();
1802   } else {
1803     low_addr = stack_yellow_zone_base();
1804   }
1805   return cur_sp > low_addr ? cur_sp - low_addr : 0;
1806 }
1807 
1808 // A thread used for Compilation.
1809 class CompilerThread : public JavaThread {
1810   friend class VMStructs;
1811  private:
1812   CompilerCounters* _counters;
1813 
1814   ciEnv*        _env;
1815   CompileLog*   _log;
1816   CompileTask*  _task;
1817   CompileQueue* _queue;
1818   BufferBlob*   _buffer_blob;
1819 
1820   nmethod*      _scanned_nmethod;  // nmethod being scanned by the sweeper
1821 
1822  public:
1823 
1824   static CompilerThread* current();
1825 
1826   CompilerThread(CompileQueue* queue, CompilerCounters* counters);
1827 
1828   bool is_Compiler_thread() const                { return true; }
1829   // Hide this compiler thread from external view.
1830   bool is_hidden_from_external_view() const      { return true; }
1831 
1832   CompileQueue* queue()                          { return _queue; }
1833   CompilerCounters* counters()                   { return _counters; }
1834 
1835   // Get/set the thread's compilation environment.
1836   ciEnv*        env()                            { return _env; }
1837   void          set_env(ciEnv* env)              { _env = env; }
1838 
1839   BufferBlob*   get_buffer_blob()                { return _buffer_blob; }
1840   void          set_buffer_blob(BufferBlob* b)   { _buffer_blob = b; };
1841 
1842   // Get/set the thread's logging information
1843   CompileLog*   log()                            { return _log; }
1844   void          init_log(CompileLog* log) {
1845     // Set once, for good.
1846     assert(_log == NULL, "set only once");
1847     _log = log;
1848   }
1849 
1850   // GC support
1851   // Apply "f->do_oop" to all root oops in "this".
1852   // Apply "cf->do_code_blob" (if !NULL) to all code blobs active in frames
1853   void oops_do(OopClosure* f, CLDToOopClosure* cld_f, CodeBlobClosure* cf);
1854 
1855 #ifndef PRODUCT
1856 private:
1857   IdealGraphPrinter *_ideal_graph_printer;
1858 public:
1859   IdealGraphPrinter *ideal_graph_printer()                       { return _ideal_graph_printer; }
1860   void set_ideal_graph_printer(IdealGraphPrinter *n)             { _ideal_graph_printer = n; }
1861 #endif
1862 
1863   // Get/set the thread's current task
1864   CompileTask*  task()                           { return _task; }
1865   void          set_task(CompileTask* task)      { _task = task; }
1866 
1867   // Track the nmethod currently being scanned by the sweeper
1868   void          set_scanned_nmethod(nmethod* nm) {
1869     assert(_scanned_nmethod == NULL || nm == NULL, "should reset to NULL before writing a new value");
1870     _scanned_nmethod = nm;
1871   }
1872 };
1873 
1874 inline CompilerThread* CompilerThread::current() {
1875   return JavaThread::current()->as_CompilerThread();
1876 }
1877 
1878 
1879 // The active thread queue. It also keeps track of the current used
1880 // thread priorities.
1881 class Threads: AllStatic {
1882   friend class VMStructs;
1883  private:
1884   static JavaThread* _thread_list;
1885   static int         _number_of_threads;
1886   static int         _number_of_non_daemon_threads;
1887   static int         _return_code;
1888 #ifdef ASSERT
1889   static bool        _vm_complete;
1890 #endif
1891 
1892  public:
1893   // Thread management
1894   // force_daemon is a concession to JNI, where we may need to add a
1895   // thread to the thread list before allocating its thread object
1896   static void add(JavaThread* p, bool force_daemon = false);
1897   static void remove(JavaThread* p);
1898   static bool includes(JavaThread* p);
1899   static JavaThread* first()                     { return _thread_list; }
1900   static void threads_do(ThreadClosure* tc);
1901 
1902   // Initializes the vm and creates the vm thread
1903   static jint create_vm(JavaVMInitArgs* args, bool* canTryAgain);
1904   static void convert_vm_init_libraries_to_agents();
1905   static void create_vm_init_libraries();
1906   static void create_vm_init_agents();
1907   static void shutdown_vm_agents();
1908   static bool destroy_vm();
1909   // Supported VM versions via JNI
1910   // Includes JNI_VERSION_1_1
1911   static jboolean is_supported_jni_version_including_1_1(jint version);
1912   // Does not include JNI_VERSION_1_1
1913   static jboolean is_supported_jni_version(jint version);
1914 
1915   // Garbage collection
1916   static void follow_other_roots(void f(oop*));
1917 
1918   // Apply "f->do_oop" to all root oops in all threads.
1919   // This version may only be called by sequential code.
1920   static void oops_do(OopClosure* f, CLDToOopClosure* cld_f, CodeBlobClosure* cf);
1921   // This version may be called by sequential or parallel code.
1922   static void possibly_parallel_oops_do(OopClosure* f, CLDToOopClosure* cld_f, CodeBlobClosure* cf);
1923   // This creates a list of GCTasks, one per thread.
1924   static void create_thread_roots_tasks(GCTaskQueue* q);
1925   // This creates a list of GCTasks, one per thread, for marking objects.
1926   static void create_thread_roots_marking_tasks(GCTaskQueue* q);
1927 
1928   // Apply "f->do_oop" to roots in all threads that
1929   // are part of compiled frames
1930   static void compiled_frame_oops_do(OopClosure* f, CodeBlobClosure* cf);
1931 
1932   static void convert_hcode_pointers();
1933   static void restore_hcode_pointers();
1934 
1935   // Sweeper
1936   static void nmethods_do(CodeBlobClosure* cf);
1937 
1938   // RedefineClasses support
1939   static void metadata_do(void f(Metadata*));
1940 
1941   static void gc_epilogue();
1942   static void gc_prologue();
1943 #ifdef ASSERT
1944   static bool is_vm_complete() { return _vm_complete; }
1945 #endif
1946 
1947   // Verification
1948   static void verify();
1949   static void print_on(outputStream* st, bool print_stacks, bool internal_format, bool print_concurrent_locks);
1950   static void print(bool print_stacks, bool internal_format) {
1951     // this function is only used by debug.cpp
1952     print_on(tty, print_stacks, internal_format, false /* no concurrent lock printed */);
1953   }
1954   static void print_on_error(outputStream* st, Thread* current, char* buf, int buflen);
1955 
1956   // Get Java threads that are waiting to enter a monitor. If doLock
1957   // is true, then Threads_lock is grabbed as needed. Otherwise, the
1958   // VM needs to be at a safepoint.
1959   static GrowableArray<JavaThread*>* get_pending_threads(int count,
1960     address monitor, bool doLock);
1961 
1962   // Get owning Java thread from the monitor's owner field. If doLock
1963   // is true, then Threads_lock is grabbed as needed. Otherwise, the
1964   // VM needs to be at a safepoint.
1965   static JavaThread *owning_thread_from_monitor_owner(address owner,
1966     bool doLock);
1967 
1968   // Number of threads on the active threads list
1969   static int number_of_threads()                 { return _number_of_threads; }
1970   // Number of non-daemon threads on the active threads list
1971   static int number_of_non_daemon_threads()      { return _number_of_non_daemon_threads; }
1972 
1973   // Deoptimizes all frames tied to marked nmethods
1974   static void deoptimized_wrt_marked_nmethods();
1975 
1976 };
1977 
1978 
1979 // Thread iterator
1980 class ThreadClosure: public StackObj {
1981  public:
1982   virtual void do_thread(Thread* thread) = 0;
1983 };
1984 
1985 class SignalHandlerMark: public StackObj {
1986 private:
1987   Thread* _thread;
1988 public:
1989   SignalHandlerMark(Thread* t) {
1990     _thread = t;
1991     if (_thread) _thread->enter_signal_handler();
1992   }
1993   ~SignalHandlerMark() {
1994     if (_thread) _thread->leave_signal_handler();
1995     _thread = NULL;
1996   }
1997 };
1998 
1999 
2000 #endif // SHARE_VM_RUNTIME_THREAD_HPP