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