src/share/vm/runtime/thread.hpp

Mon, 09 Aug 2010 15:17:05 -0700

author
kvn
date
Mon, 09 Aug 2010 15:17:05 -0700
changeset 2043
2dfd013a7465
parent 1995
bfc89697cccb
child 2044
f4f596978298
permissions
-rw-r--r--

6975078: assert(allocated_on_res_area() || allocated_on_C_heap() || allocated_on_arena()
Summary: Pass the check in ResourceObj() if _allocation value is already set and object is allocated on stack.
Reviewed-by: dholmes, johnc

     1 /*
     2  * Copyright (c) 1997, 2010, 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  */
    25 class ThreadSafepointState;
    26 class ThreadProfiler;
    28 class JvmtiThreadState;
    29 class JvmtiGetLoadedClassesClosure;
    30 class ThreadStatistics;
    31 class ConcurrentLocksDump;
    32 class ParkEvent ;
    34 class ciEnv;
    35 class CompileThread;
    36 class CompileLog;
    37 class CompileTask;
    38 class CompileQueue;
    39 class CompilerCounters;
    40 class vframeArray;
    42 class DeoptResourceMark;
    43 class jvmtiDeferredLocalVariableSet;
    45 class GCTaskQueue;
    46 class ThreadClosure;
    47 class IdealGraphPrinter;
    49 // Class hierarchy
    50 // - Thread
    51 //   - NamedThread
    52 //     - VMThread
    53 //     - ConcurrentGCThread
    54 //     - WorkerThread
    55 //       - GangWorker
    56 //       - GCTaskThread
    57 //   - JavaThread
    58 //   - WatcherThread
    60 class Thread: public ThreadShadow {
    61   friend class VMStructs;
    62  private:
    63   // Exception handling
    64   // (Note: _pending_exception and friends are in ThreadShadow)
    65   //oop       _pending_exception;                // pending exception for current thread
    66   // const char* _exception_file;                   // file information for exception (debugging only)
    67   // int         _exception_line;                   // line information for exception (debugging only)
    69   // Support for forcing alignment of thread objects for biased locking
    70   void*       _real_malloc_address;
    71  public:
    72   void* operator new(size_t size);
    73   void  operator delete(void* p);
    74  private:
    76   // ***************************************************************
    77   // Suspend and resume support
    78   // ***************************************************************
    79   //
    80   // VM suspend/resume no longer exists - it was once used for various
    81   // things including safepoints but was deprecated and finally removed
    82   // in Java 7. Because VM suspension was considered "internal" Java-level
    83   // suspension was considered "external", and this legacy naming scheme
    84   // remains.
    85   //
    86   // External suspend/resume requests come from JVM_SuspendThread,
    87   // JVM_ResumeThread, JVMTI SuspendThread, and finally JVMTI
    88   // ResumeThread. External
    89   // suspend requests cause _external_suspend to be set and external
    90   // resume requests cause _external_suspend to be cleared.
    91   // External suspend requests do not nest on top of other external
    92   // suspend requests. The higher level APIs reject suspend requests
    93   // for already suspended threads.
    94   //
    95   // The external_suspend
    96   // flag is checked by has_special_runtime_exit_condition() and java thread
    97   // will self-suspend when handle_special_runtime_exit_condition() is
    98   // called. Most uses of the _thread_blocked state in JavaThreads are
    99   // considered the same as being externally suspended; if the blocking
   100   // condition lifts, the JavaThread will self-suspend. Other places
   101   // where VM checks for external_suspend include:
   102   //   + mutex granting (do not enter monitors when thread is suspended)
   103   //   + state transitions from _thread_in_native
   104   //
   105   // In general, java_suspend() does not wait for an external suspend
   106   // request to complete. When it returns, the only guarantee is that
   107   // the _external_suspend field is true.
   108   //
   109   // wait_for_ext_suspend_completion() is used to wait for an external
   110   // suspend request to complete. External suspend requests are usually
   111   // followed by some other interface call that requires the thread to
   112   // be quiescent, e.g., GetCallTrace(). By moving the "wait time" into
   113   // the interface that requires quiescence, we give the JavaThread a
   114   // chance to self-suspend before we need it to be quiescent. This
   115   // improves overall suspend/query performance.
   116   //
   117   // _suspend_flags controls the behavior of java_ suspend/resume.
   118   // It must be set under the protection of SR_lock. Read from the flag is
   119   // OK without SR_lock as long as the value is only used as a hint.
   120   // (e.g., check _external_suspend first without lock and then recheck
   121   // inside SR_lock and finish the suspension)
   122   //
   123   // _suspend_flags is also overloaded for other "special conditions" so
   124   // that a single check indicates whether any special action is needed
   125   // eg. for async exceptions.
   126   // -------------------------------------------------------------------
   127   // Notes:
   128   // 1. The suspend/resume logic no longer uses ThreadState in OSThread
   129   // but we still update its value to keep other part of the system (mainly
   130   // JVMTI) happy. ThreadState is legacy code (see notes in
   131   // osThread.hpp).
   132   //
   133   // 2. It would be more natural if set_external_suspend() is private and
   134   // part of java_suspend(), but that probably would affect the suspend/query
   135   // performance. Need more investigation on this.
   136   //
   138   // suspend/resume lock: used for self-suspend
   139   Monitor*    _SR_lock;
   141  protected:
   142   enum SuspendFlags {
   143     // NOTE: avoid using the sign-bit as cc generates different test code
   144     //       when the sign-bit is used, and sometimes incorrectly - see CR 6398077
   146     _external_suspend       = 0x20000000U, // thread is asked to self suspend
   147     _ext_suspended          = 0x40000000U, // thread has self-suspended
   148     _deopt_suspend          = 0x10000000U, // thread needs to self suspend for deopt
   150     _has_async_exception    = 0x00000001U  // there is a pending async exception
   151   };
   153   // various suspension related flags - atomically updated
   154   // overloaded for async exception checking in check_special_condition_for_native_trans.
   155   volatile uint32_t _suspend_flags;
   157  private:
   158   int _num_nested_signal;
   160  public:
   161   void enter_signal_handler() { _num_nested_signal++; }
   162   void leave_signal_handler() { _num_nested_signal--; }
   163   bool is_inside_signal_handler() const  { return _num_nested_signal > 0; }
   165  private:
   166   // Debug tracing
   167   static void trace(const char* msg, const Thread* const thread) PRODUCT_RETURN;
   169   // Active_handles points to a block of handles
   170   JNIHandleBlock* _active_handles;
   172   // One-element thread local free list
   173   JNIHandleBlock* _free_handle_block;
   175   // Point to the last handle mark
   176   HandleMark* _last_handle_mark;
   178   // The parity of the last strong_roots iteration in which this thread was
   179   // claimed as a task.
   180   jint _oops_do_parity;
   182   public:
   183    void set_last_handle_mark(HandleMark* mark)   { _last_handle_mark = mark; }
   184     HandleMark* last_handle_mark() const          { return _last_handle_mark; }
   185   private:
   187   // debug support for checking if code does allow safepoints or not
   188   // GC points in the VM can happen because of allocation, invoking a VM operation, or blocking on
   189   // mutex, or blocking on an object synchronizer (Java locking).
   190   // If !allow_safepoint(), then an assertion failure will happen in any of the above cases
   191   // If !allow_allocation(), then an assertion failure will happen during allocation
   192   // (Hence, !allow_safepoint() => !allow_allocation()).
   193   //
   194   // The two classes No_Safepoint_Verifier and No_Allocation_Verifier are used to set these counters.
   195   //
   196   NOT_PRODUCT(int _allow_safepoint_count;)       // If 0, thread allow a safepoint to happen
   197   debug_only (int _allow_allocation_count;)      // If 0, the thread is allowed to allocate oops.
   199   // Used by SkipGCALot class.
   200   NOT_PRODUCT(bool _skip_gcalot;)                // Should we elide gc-a-lot?
   202   // Record when GC is locked out via the GC_locker mechanism
   203   CHECK_UNHANDLED_OOPS_ONLY(int _gc_locked_out_count;)
   205   friend class No_Alloc_Verifier;
   206   friend class No_Safepoint_Verifier;
   207   friend class Pause_No_Safepoint_Verifier;
   208   friend class ThreadLocalStorage;
   209   friend class GC_locker;
   211   ThreadLocalAllocBuffer _tlab;                  // Thread-local eden
   213   int   _vm_operation_started_count;             // VM_Operation support
   214   int   _vm_operation_completed_count;           // VM_Operation support
   216   ObjectMonitor* _current_pending_monitor;       // ObjectMonitor this thread
   217                                                  // is waiting to lock
   218   bool _current_pending_monitor_is_from_java;    // locking is from Java code
   220   // ObjectMonitor on which this thread called Object.wait()
   221   ObjectMonitor* _current_waiting_monitor;
   223   // Private thread-local objectmonitor list - a simple cache organized as a SLL.
   224  public:
   225   ObjectMonitor * omFreeList ;
   226   int omFreeCount ;                             // length of omFreeList
   227   int omFreeProvision ;                         // reload chunk size
   228   ObjectMonitor * omInUseList;                  // SLL to track monitors in circulation
   229   int omInUseCount;                             // length of omInUseList
   231  public:
   232   enum {
   233     is_definitely_current_thread = true
   234   };
   236   // Constructor
   237   Thread();
   238   virtual ~Thread();
   240   // initializtion
   241   void initialize_thread_local_storage();
   243   // thread entry point
   244   virtual void run();
   246   // Testers
   247   virtual bool is_VM_thread()       const            { return false; }
   248   virtual bool is_Java_thread()     const            { return false; }
   249   // Remove this ifdef when C1 is ported to the compiler interface.
   250   virtual bool is_Compiler_thread() const            { return false; }
   251   virtual bool is_hidden_from_external_view() const  { return false; }
   252   virtual bool is_jvmti_agent_thread() const         { return false; }
   253   // True iff the thread can perform GC operations at a safepoint.
   254   // Generally will be true only of VM thread and parallel GC WorkGang
   255   // threads.
   256   virtual bool is_GC_task_thread() const             { return false; }
   257   virtual bool is_Watcher_thread() const             { return false; }
   258   virtual bool is_ConcurrentGC_thread() const        { return false; }
   259   virtual bool is_Named_thread() const               { return false; }
   261   virtual char* name() const { return (char*)"Unknown thread"; }
   263   // Returns the current thread
   264   static inline Thread* current();
   266   // Common thread operations
   267   static void set_priority(Thread* thread, ThreadPriority priority);
   268   static ThreadPriority get_priority(const Thread* const thread);
   269   static void start(Thread* thread);
   270   static void interrupt(Thread* thr);
   271   static bool is_interrupted(Thread* thr, bool clear_interrupted);
   273   ObjectMonitor** omInUseList_addr()             { return (ObjectMonitor **)&omInUseList; }
   274   Monitor* SR_lock() const                       { return _SR_lock; }
   276   bool has_async_exception() const { return (_suspend_flags & _has_async_exception) != 0; }
   278   void set_suspend_flag(SuspendFlags f) {
   279     assert(sizeof(jint) == sizeof(_suspend_flags), "size mismatch");
   280     uint32_t flags;
   281     do {
   282       flags = _suspend_flags;
   283     }
   284     while (Atomic::cmpxchg((jint)(flags | f),
   285                            (volatile jint*)&_suspend_flags,
   286                            (jint)flags) != (jint)flags);
   287   }
   288   void clear_suspend_flag(SuspendFlags f) {
   289     assert(sizeof(jint) == sizeof(_suspend_flags), "size mismatch");
   290     uint32_t flags;
   291     do {
   292       flags = _suspend_flags;
   293     }
   294     while (Atomic::cmpxchg((jint)(flags & ~f),
   295                            (volatile jint*)&_suspend_flags,
   296                            (jint)flags) != (jint)flags);
   297   }
   299   void set_has_async_exception() {
   300     set_suspend_flag(_has_async_exception);
   301   }
   302   void clear_has_async_exception() {
   303     clear_suspend_flag(_has_async_exception);
   304   }
   306   // Support for Unhandled Oop detection
   307 #ifdef CHECK_UNHANDLED_OOPS
   308  private:
   309   UnhandledOops *_unhandled_oops;
   310  public:
   311   UnhandledOops* unhandled_oops()               { return _unhandled_oops; }
   312   // Mark oop safe for gc.  It may be stack allocated but won't move.
   313   void allow_unhandled_oop(oop *op)              {
   314     if (CheckUnhandledOops) unhandled_oops()->allow_unhandled_oop(op);
   315   }
   316   // Clear oops at safepoint so crashes point to unhandled oop violator
   317   void clear_unhandled_oops()                   {
   318     if (CheckUnhandledOops) unhandled_oops()->clear_unhandled_oops();
   319   }
   320   bool is_gc_locked_out() { return _gc_locked_out_count > 0; }
   321 #endif // CHECK_UNHANDLED_OOPS
   323 #ifndef PRODUCT
   324   bool skip_gcalot()           { return _skip_gcalot; }
   325   void set_skip_gcalot(bool v) { _skip_gcalot = v;    }
   326 #endif
   328  public:
   329   // Installs a pending exception to be inserted later
   330   static void send_async_exception(oop thread_oop, oop java_throwable);
   332   // Resource area
   333   ResourceArea* resource_area() const            { return _resource_area; }
   334   void set_resource_area(ResourceArea* area)     { _resource_area = area; }
   336   OSThread* osthread() const                     { return _osthread;   }
   337   void set_osthread(OSThread* thread)            { _osthread = thread; }
   339   // JNI handle support
   340   JNIHandleBlock* active_handles() const         { return _active_handles; }
   341   void set_active_handles(JNIHandleBlock* block) { _active_handles = block; }
   342   JNIHandleBlock* free_handle_block() const      { return _free_handle_block; }
   343   void set_free_handle_block(JNIHandleBlock* block) { _free_handle_block = block; }
   345   // Internal handle support
   346   HandleArea* handle_area() const                { return _handle_area; }
   347   void set_handle_area(HandleArea* area)         { _handle_area = area; }
   349   // Thread-Local Allocation Buffer (TLAB) support
   350   ThreadLocalAllocBuffer& tlab()                 { return _tlab; }
   351   void initialize_tlab() {
   352     if (UseTLAB) {
   353       tlab().initialize();
   354     }
   355   }
   357   // VM operation support
   358   int vm_operation_ticket()                      { return ++_vm_operation_started_count; }
   359   int vm_operation_completed_count()             { return _vm_operation_completed_count; }
   360   void increment_vm_operation_completed_count()  { _vm_operation_completed_count++; }
   362   // For tracking the heavyweight monitor the thread is pending on.
   363   ObjectMonitor* current_pending_monitor() {
   364     return _current_pending_monitor;
   365   }
   366   void set_current_pending_monitor(ObjectMonitor* monitor) {
   367     _current_pending_monitor = monitor;
   368   }
   369   void set_current_pending_monitor_is_from_java(bool from_java) {
   370     _current_pending_monitor_is_from_java = from_java;
   371   }
   372   bool current_pending_monitor_is_from_java() {
   373     return _current_pending_monitor_is_from_java;
   374   }
   376   // For tracking the ObjectMonitor on which this thread called Object.wait()
   377   ObjectMonitor* current_waiting_monitor() {
   378     return _current_waiting_monitor;
   379   }
   380   void set_current_waiting_monitor(ObjectMonitor* monitor) {
   381     _current_waiting_monitor = monitor;
   382   }
   384   // GC support
   385   // Apply "f->do_oop" to all root oops in "this".
   386   // Apply "cf->do_code_blob" (if !NULL) to all code blobs active in frames
   387   void oops_do(OopClosure* f, CodeBlobClosure* cf);
   389   // Handles the parallel case for the method below.
   390 private:
   391   bool claim_oops_do_par_case(int collection_parity);
   392 public:
   393   // Requires that "collection_parity" is that of the current strong roots
   394   // iteration.  If "is_par" is false, sets the parity of "this" to
   395   // "collection_parity", and returns "true".  If "is_par" is true,
   396   // uses an atomic instruction to set the current threads parity to
   397   // "collection_parity", if it is not already.  Returns "true" iff the
   398   // calling thread does the update, this indicates that the calling thread
   399   // has claimed the thread's stack as a root groop in the current
   400   // collection.
   401   bool claim_oops_do(bool is_par, int collection_parity) {
   402     if (!is_par) {
   403       _oops_do_parity = collection_parity;
   404       return true;
   405     } else {
   406       return claim_oops_do_par_case(collection_parity);
   407     }
   408   }
   410   // Sweeper support
   411   void nmethods_do(CodeBlobClosure* cf);
   413   // Tells if adr belong to this thread. This is used
   414   // for checking if a lock is owned by the running thread.
   416   // Used by fast lock support
   417   virtual bool is_lock_owned(address adr) const;
   419   // Check if address is in the stack of the thread (not just for locks).
   420   // Warning: the method can only be used on the running thread
   421   bool is_in_stack(address adr) const;
   423   // Sets this thread as starting thread. Returns failure if thread
   424   // creation fails due to lack of memory, too many threads etc.
   425   bool set_as_starting_thread();
   427  protected:
   428   // OS data associated with the thread
   429   OSThread* _osthread;  // Platform-specific thread information
   431   // Thread local resource area for temporary allocation within the VM
   432   ResourceArea* _resource_area;
   434   // Thread local handle area for allocation of handles within the VM
   435   HandleArea* _handle_area;
   437   // Support for stack overflow handling, get_thread, etc.
   438   address          _stack_base;
   439   size_t           _stack_size;
   440   uintptr_t        _self_raw_id;      // used by get_thread (mutable)
   441   int              _lgrp_id;
   443  public:
   444   // Stack overflow support
   445   address stack_base() const           { assert(_stack_base != NULL,"Sanity check"); return _stack_base; }
   447   void    set_stack_base(address base) { _stack_base = base; }
   448   size_t  stack_size() const           { return _stack_size; }
   449   void    set_stack_size(size_t size)  { _stack_size = size; }
   450   void    record_stack_base_and_size();
   452   bool    on_local_stack(address adr) const {
   453     /* QQQ this has knowledge of direction, ought to be a stack method */
   454     return (_stack_base >= adr && adr >= (_stack_base - _stack_size));
   455   }
   457   int     lgrp_id() const                 { return _lgrp_id; }
   458   void    set_lgrp_id(int value)          { _lgrp_id = value; }
   460   // Printing
   461   void print_on(outputStream* st) const;
   462   void print() const { print_on(tty); }
   463   virtual void print_on_error(outputStream* st, char* buf, int buflen) const;
   465   // Debug-only code
   467 #ifdef ASSERT
   468  private:
   469   // Deadlock detection support for Mutex locks. List of locks own by thread.
   470   Monitor *_owned_locks;
   471   // Mutex::set_owner_implementation is the only place where _owned_locks is modified,
   472   // thus the friendship
   473   friend class Mutex;
   474   friend class Monitor;
   476  public:
   477   void print_owned_locks_on(outputStream* st) const;
   478   void print_owned_locks() const                 { print_owned_locks_on(tty);    }
   479   Monitor * owned_locks() const                  { return _owned_locks;          }
   480   bool owns_locks() const                        { return owned_locks() != NULL; }
   481   bool owns_locks_but_compiled_lock() const;
   483   // Deadlock detection
   484   bool allow_allocation()                        { return _allow_allocation_count == 0; }
   485 #endif
   487   void check_for_valid_safepoint_state(bool potential_vm_operation) PRODUCT_RETURN;
   489  private:
   490   volatile int _jvmti_env_iteration_count;
   492  public:
   493   void entering_jvmti_env_iteration()            { ++_jvmti_env_iteration_count; }
   494   void leaving_jvmti_env_iteration()             { --_jvmti_env_iteration_count; }
   495   bool is_inside_jvmti_env_iteration()           { return _jvmti_env_iteration_count > 0; }
   497   // Code generation
   498   static ByteSize exception_file_offset()        { return byte_offset_of(Thread, _exception_file   ); }
   499   static ByteSize exception_line_offset()        { return byte_offset_of(Thread, _exception_line   ); }
   500   static ByteSize active_handles_offset()        { return byte_offset_of(Thread, _active_handles   ); }
   502   static ByteSize stack_base_offset()            { return byte_offset_of(Thread, _stack_base ); }
   503   static ByteSize stack_size_offset()            { return byte_offset_of(Thread, _stack_size ); }
   505 #define TLAB_FIELD_OFFSET(name) \
   506   static ByteSize tlab_##name##_offset()            { return byte_offset_of(Thread, _tlab) + ThreadLocalAllocBuffer::name##_offset(); }
   508   TLAB_FIELD_OFFSET(start)
   509   TLAB_FIELD_OFFSET(end)
   510   TLAB_FIELD_OFFSET(top)
   511   TLAB_FIELD_OFFSET(pf_top)
   512   TLAB_FIELD_OFFSET(size)                   // desired_size
   513   TLAB_FIELD_OFFSET(refill_waste_limit)
   514   TLAB_FIELD_OFFSET(number_of_refills)
   515   TLAB_FIELD_OFFSET(fast_refill_waste)
   516   TLAB_FIELD_OFFSET(slow_allocations)
   518 #undef TLAB_FIELD_OFFSET
   520  public:
   521   volatile intptr_t _Stalled ;
   522   volatile int _TypeTag ;
   523   ParkEvent * _ParkEvent ;                     // for synchronized()
   524   ParkEvent * _SleepEvent ;                    // for Thread.sleep
   525   ParkEvent * _MutexEvent ;                    // for native internal Mutex/Monitor
   526   ParkEvent * _MuxEvent ;                      // for low-level muxAcquire-muxRelease
   527   int NativeSyncRecursion ;                    // diagnostic
   529   volatile int _OnTrap ;                       // Resume-at IP delta
   530   jint _hashStateW ;                           // Marsaglia Shift-XOR thread-local RNG
   531   jint _hashStateX ;                           // thread-specific hashCode generator state
   532   jint _hashStateY ;
   533   jint _hashStateZ ;
   534   void * _schedctl ;
   536   intptr_t _ScratchA, _ScratchB ;              // Scratch locations for fast-path sync code
   537   static ByteSize ScratchA_offset()            { return byte_offset_of(Thread, _ScratchA ); }
   538   static ByteSize ScratchB_offset()            { return byte_offset_of(Thread, _ScratchB ); }
   540   volatile jint rng [4] ;                      // RNG for spin loop
   542   // Low-level leaf-lock primitives used to implement synchronization
   543   // and native monitor-mutex infrastructure.
   544   // Not for general synchronization use.
   545   static void SpinAcquire (volatile int * Lock, const char * Name) ;
   546   static void SpinRelease (volatile int * Lock) ;
   547   static void muxAcquire  (volatile intptr_t * Lock, const char * Name) ;
   548   static void muxAcquireW (volatile intptr_t * Lock, ParkEvent * ev) ;
   549   static void muxRelease  (volatile intptr_t * Lock) ;
   551 };
   553 // Inline implementation of Thread::current()
   554 // Thread::current is "hot" it's called > 128K times in the 1st 500 msecs of
   555 // startup.
   556 // ThreadLocalStorage::thread is warm -- it's called > 16K times in the same
   557 // period.   This is inlined in thread_<os_family>.inline.hpp.
   559 inline Thread* Thread::current() {
   560 #ifdef ASSERT
   561 // This function is very high traffic. Define PARANOID to enable expensive
   562 // asserts.
   563 #ifdef PARANOID
   564   // Signal handler should call ThreadLocalStorage::get_thread_slow()
   565   Thread* t = ThreadLocalStorage::get_thread_slow();
   566   assert(t != NULL && !t->is_inside_signal_handler(),
   567          "Don't use Thread::current() inside signal handler");
   568 #endif
   569 #endif
   570   Thread* thread = ThreadLocalStorage::thread();
   571   assert(thread != NULL, "just checking");
   572   return thread;
   573 }
   575 // Name support for threads.  non-JavaThread subclasses with multiple
   576 // uniquely named instances should derive from this.
   577 class NamedThread: public Thread {
   578   friend class VMStructs;
   579   enum {
   580     max_name_len = 64
   581   };
   582  private:
   583   char* _name;
   584   // log JavaThread being processed by oops_do
   585   JavaThread* _processed_thread;
   587  public:
   588   NamedThread();
   589   ~NamedThread();
   590   // May only be called once per thread.
   591   void set_name(const char* format, ...);
   592   virtual bool is_Named_thread() const { return true; }
   593   virtual char* name() const { return _name == NULL ? (char*)"Unknown Thread" : _name; }
   594   JavaThread *processed_thread() { return _processed_thread; }
   595   void set_processed_thread(JavaThread *thread) { _processed_thread = thread; }
   596 };
   598 // Worker threads are named and have an id of an assigned work.
   599 class WorkerThread: public NamedThread {
   600 private:
   601   uint _id;
   602 public:
   603   WorkerThread() : _id(0) { }
   604   void set_id(uint work_id) { _id = work_id; }
   605   uint id() const { return _id; }
   606 };
   608 // A single WatcherThread is used for simulating timer interrupts.
   609 class WatcherThread: public Thread {
   610   friend class VMStructs;
   611  public:
   612   virtual void run();
   614  private:
   615   static WatcherThread* _watcher_thread;
   617   static bool _should_terminate;
   618  public:
   619   enum SomeConstants {
   620     delay_interval = 10                          // interrupt delay in milliseconds
   621   };
   623   // Constructor
   624   WatcherThread();
   626   // Tester
   627   bool is_Watcher_thread() const                 { return true; }
   629   // Printing
   630   char* name() const { return (char*)"VM Periodic Task Thread"; }
   631   void print_on(outputStream* st) const;
   632   void print() const { print_on(tty); }
   634   // Returns the single instance of WatcherThread
   635   static WatcherThread* watcher_thread()         { return _watcher_thread; }
   637   // Create and start the single instance of WatcherThread, or stop it on shutdown
   638   static void start();
   639   static void stop();
   640 };
   643 class CompilerThread;
   645 typedef void (*ThreadFunction)(JavaThread*, TRAPS);
   647 class JavaThread: public Thread {
   648   friend class VMStructs;
   649  private:
   650   JavaThread*    _next;                          // The next thread in the Threads list
   651   oop            _threadObj;                     // The Java level thread object
   653 #ifdef ASSERT
   654  private:
   655   int _java_call_counter;
   657  public:
   658   int  java_call_counter()                       { return _java_call_counter; }
   659   void inc_java_call_counter()                   { _java_call_counter++; }
   660   void dec_java_call_counter() {
   661     assert(_java_call_counter > 0, "Invalid nesting of JavaCallWrapper");
   662     _java_call_counter--;
   663   }
   664  private:  // restore original namespace restriction
   665 #endif  // ifdef ASSERT
   667 #ifndef PRODUCT
   668  public:
   669   enum {
   670     jump_ring_buffer_size = 16
   671   };
   672  private:  // restore original namespace restriction
   673 #endif
   675   JavaFrameAnchor _anchor;                       // Encapsulation of current java frame and it state
   677   ThreadFunction _entry_point;
   679   JNIEnv        _jni_environment;
   681   // Deopt support
   682   DeoptResourceMark*  _deopt_mark;               // Holds special ResourceMark for deoptimization
   684   intptr_t*      _must_deopt_id;                 // id of frame that needs to be deopted once we
   685                                                  // transition out of native
   687   vframeArray*  _vframe_array_head;              // Holds the heap of the active vframeArrays
   688   vframeArray*  _vframe_array_last;              // Holds last vFrameArray we popped
   689   // Because deoptimization is lazy we must save jvmti requests to set locals
   690   // in compiled frames until we deoptimize and we have an interpreter frame.
   691   // This holds the pointer to array (yeah like there might be more than one) of
   692   // description of compiled vframes that have locals that need to be updated.
   693   GrowableArray<jvmtiDeferredLocalVariableSet*>* _deferred_locals_updates;
   695   // Handshake value for fixing 6243940. We need a place for the i2c
   696   // adapter to store the callee methodOop. This value is NEVER live
   697   // across a gc point so it does NOT have to be gc'd
   698   // The handshake is open ended since we can't be certain that it will
   699   // be NULLed. This is because we rarely ever see the race and end up
   700   // in handle_wrong_method which is the backend of the handshake. See
   701   // code in i2c adapters and handle_wrong_method.
   703   methodOop     _callee_target;
   705   // Oop results of VM runtime calls
   706   oop           _vm_result;    // Used to pass back an oop result into Java code, GC-preserved
   707   oop           _vm_result_2;  // Used to pass back an oop result into Java code, GC-preserved
   709   // See ReduceInitialCardMarks: this holds the precise space interval of
   710   // the most recent slow path allocation for which compiled code has
   711   // elided card-marks for performance along the fast-path.
   712   MemRegion     _deferred_card_mark;
   714   MonitorChunk* _monitor_chunks;                 // Contains the off stack monitors
   715                                                  // allocated during deoptimization
   716                                                  // and by JNI_MonitorEnter/Exit
   718   // Async. requests support
   719   enum AsyncRequests {
   720     _no_async_condition = 0,
   721     _async_exception,
   722     _async_unsafe_access_error
   723   };
   724   AsyncRequests _special_runtime_exit_condition; // Enum indicating pending async. request
   725   oop           _pending_async_exception;
   727   // Safepoint support
   728  public:                                         // Expose _thread_state for SafeFetchInt()
   729   volatile JavaThreadState _thread_state;
   730  private:
   731   ThreadSafepointState *_safepoint_state;        // Holds information about a thread during a safepoint
   732   address               _saved_exception_pc;     // Saved pc of instruction where last implicit exception happened
   734   // JavaThread termination support
   735   enum TerminatedTypes {
   736     _not_terminated = 0xDEAD - 2,
   737     _thread_exiting,                             // JavaThread::exit() has been called for this thread
   738     _thread_terminated,                          // JavaThread is removed from thread list
   739     _vm_exited                                   // JavaThread is still executing native code, but VM is terminated
   740                                                  // only VM_Exit can set _vm_exited
   741   };
   743   // In general a JavaThread's _terminated field transitions as follows:
   744   //
   745   //   _not_terminated => _thread_exiting => _thread_terminated
   746   //
   747   // _vm_exited is a special value to cover the case of a JavaThread
   748   // executing native code after the VM itself is terminated.
   749   TerminatedTypes       _terminated;
   750   // suspend/resume support
   751   volatile bool         _suspend_equivalent;     // Suspend equivalent condition
   752   jint                  _in_deopt_handler;       // count of deoptimization
   753                                                  // handlers thread is in
   754   volatile bool         _doing_unsafe_access;    // Thread may fault due to unsafe access
   755   bool                  _do_not_unlock_if_synchronized; // Do not unlock the receiver of a synchronized method (since it was
   756                                                  // never locked) when throwing an exception. Used by interpreter only.
   758   //  Flag to mark a JNI thread in the process of attaching - See CR 6404306
   759   //  This flag is never set true other than at construction, and in that case
   760   //  is shortly thereafter set false
   761   volatile bool _is_attaching;
   763  public:
   764   // State of the stack guard pages for this thread.
   765   enum StackGuardState {
   766     stack_guard_unused,         // not needed
   767     stack_guard_yellow_disabled,// disabled (temporarily) after stack overflow
   768     stack_guard_enabled         // enabled
   769   };
   771  private:
   773   StackGuardState        _stack_guard_state;
   775   // Compiler exception handling (NOTE: The _exception_oop is *NOT* the same as _pending_exception. It is
   776   // used to temp. parsing values into and out of the runtime system during exception handling for compiled
   777   // code)
   778   volatile oop     _exception_oop;               // Exception thrown in compiled code
   779   volatile address _exception_pc;                // PC where exception happened
   780   volatile address _exception_handler_pc;        // PC for handler of exception
   781   volatile int     _exception_stack_size;        // Size of frame where exception happened
   782   volatile int     _is_method_handle_return;     // true (== 1) if the current exception PC is a MethodHandle call site.
   784   // support for compilation
   785   bool    _is_compiling;                         // is true if a compilation is active inthis thread (one compilation per thread possible)
   787   // support for JNI critical regions
   788   jint    _jni_active_critical;                  // count of entries into JNI critical region
   790   // For deadlock detection.
   791   int _depth_first_number;
   793   // JVMTI PopFrame support
   794   // This is set to popframe_pending to signal that top Java frame should be popped immediately
   795   int _popframe_condition;
   797 #ifndef PRODUCT
   798   int _jmp_ring_index;
   799   struct {
   800       // We use intptr_t instead of address so debugger doesn't try and display strings
   801       intptr_t _target;
   802       intptr_t _instruction;
   803       const char*  _file;
   804       int _line;
   805   }   _jmp_ring[ jump_ring_buffer_size ];
   806 #endif /* PRODUCT */
   808 #ifndef SERIALGC
   809   // Support for G1 barriers
   811   ObjPtrQueue _satb_mark_queue;          // Thread-local log for SATB barrier.
   812   // Set of all such queues.
   813   static SATBMarkQueueSet _satb_mark_queue_set;
   815   DirtyCardQueue _dirty_card_queue;      // Thread-local log for dirty cards.
   816   // Set of all such queues.
   817   static DirtyCardQueueSet _dirty_card_queue_set;
   819   void flush_barrier_queues();
   820 #endif // !SERIALGC
   822   friend class VMThread;
   823   friend class ThreadWaitTransition;
   824   friend class VM_Exit;
   826   void initialize();                             // Initialized the instance variables
   828  public:
   829   // Constructor
   830   JavaThread(bool is_attaching = false); // for main thread and JNI attached threads
   831   JavaThread(ThreadFunction entry_point, size_t stack_size = 0);
   832   ~JavaThread();
   834 #ifdef ASSERT
   835   // verify this JavaThread hasn't be published in the Threads::list yet
   836   void verify_not_published();
   837 #endif
   839   //JNI functiontable getter/setter for JVMTI jni function table interception API.
   840   void set_jni_functions(struct JNINativeInterface_* functionTable) {
   841     _jni_environment.functions = functionTable;
   842   }
   843   struct JNINativeInterface_* get_jni_functions() {
   844     return (struct JNINativeInterface_ *)_jni_environment.functions;
   845   }
   847   // Executes Shutdown.shutdown()
   848   void invoke_shutdown_hooks();
   850   // Cleanup on thread exit
   851   enum ExitType {
   852     normal_exit,
   853     jni_detach
   854   };
   855   void exit(bool destroy_vm, ExitType exit_type = normal_exit);
   857   void cleanup_failed_attach_current_thread();
   859   // Testers
   860   virtual bool is_Java_thread() const            { return true;  }
   862   // compilation
   863   void set_is_compiling(bool f)                  { _is_compiling = f; }
   864   bool is_compiling() const                      { return _is_compiling; }
   866   // Thread chain operations
   867   JavaThread* next() const                       { return _next; }
   868   void set_next(JavaThread* p)                   { _next = p; }
   870   // Thread oop. threadObj() can be NULL for initial JavaThread
   871   // (or for threads attached via JNI)
   872   oop threadObj() const                          { return _threadObj; }
   873   void set_threadObj(oop p)                      { _threadObj = p; }
   875   ThreadPriority java_priority() const;          // Read from threadObj()
   877   // Prepare thread and add to priority queue.  If a priority is
   878   // not specified, use the priority of the thread object. Threads_lock
   879   // must be held while this function is called.
   880   void prepare(jobject jni_thread, ThreadPriority prio=NoPriority);
   882   void set_saved_exception_pc(address pc)        { _saved_exception_pc = pc; }
   883   address saved_exception_pc()                   { return _saved_exception_pc; }
   886   ThreadFunction entry_point() const             { return _entry_point; }
   888   // Allocates a new Java level thread object for this thread. thread_name may be NULL.
   889   void allocate_threadObj(Handle thread_group, char* thread_name, bool daemon, TRAPS);
   891   // Last frame anchor routines
   893   JavaFrameAnchor* frame_anchor(void)                { return &_anchor; }
   895   // last_Java_sp
   896   bool has_last_Java_frame() const                   { return _anchor.has_last_Java_frame(); }
   897   intptr_t* last_Java_sp() const                     { return _anchor.last_Java_sp(); }
   899   // last_Java_pc
   901   address last_Java_pc(void)                         { return _anchor.last_Java_pc(); }
   903   // Safepoint support
   904   JavaThreadState thread_state() const           { return _thread_state; }
   905   void set_thread_state(JavaThreadState s)       { _thread_state=s;      }
   906   ThreadSafepointState *safepoint_state() const  { return _safepoint_state;  }
   907   void set_safepoint_state(ThreadSafepointState *state) { _safepoint_state = state; }
   908   bool is_at_poll_safepoint()                    { return _safepoint_state->is_at_poll_safepoint(); }
   910   // thread has called JavaThread::exit() or is terminated
   911   bool is_exiting()                              { return _terminated == _thread_exiting || is_terminated(); }
   912   // thread is terminated (no longer on the threads list); we compare
   913   // against the two non-terminated values so that a freed JavaThread
   914   // will also be considered terminated.
   915   bool is_terminated()                           { return _terminated != _not_terminated && _terminated != _thread_exiting; }
   916   void set_terminated(TerminatedTypes t)         { _terminated = t; }
   917   // special for Threads::remove() which is static:
   918   void set_terminated_value()                    { _terminated = _thread_terminated; }
   919   void block_if_vm_exited();
   921   bool doing_unsafe_access()                     { return _doing_unsafe_access; }
   922   void set_doing_unsafe_access(bool val)         { _doing_unsafe_access = val; }
   924   bool do_not_unlock_if_synchronized()             { return _do_not_unlock_if_synchronized; }
   925   void set_do_not_unlock_if_synchronized(bool val) { _do_not_unlock_if_synchronized = val; }
   928   // Suspend/resume support for JavaThread
   930  private:
   931   void set_ext_suspended()       { set_suspend_flag (_ext_suspended);  }
   932   void clear_ext_suspended()     { clear_suspend_flag(_ext_suspended); }
   934  public:
   935   void java_suspend();
   936   void java_resume();
   937   int  java_suspend_self();
   939   void check_and_wait_while_suspended() {
   940     assert(JavaThread::current() == this, "sanity check");
   942     bool do_self_suspend;
   943     do {
   944       // were we externally suspended while we were waiting?
   945       do_self_suspend = handle_special_suspend_equivalent_condition();
   946       if (do_self_suspend) {
   947         // don't surprise the thread that suspended us by returning
   948         java_suspend_self();
   949         set_suspend_equivalent();
   950       }
   951     } while (do_self_suspend);
   952   }
   953   static void check_safepoint_and_suspend_for_native_trans(JavaThread *thread);
   954   // Check for async exception in addition to safepoint and suspend request.
   955   static void check_special_condition_for_native_trans(JavaThread *thread);
   957   bool is_ext_suspend_completed(bool called_by_wait, int delay, uint32_t *bits);
   958   bool is_ext_suspend_completed_with_lock(uint32_t *bits) {
   959     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
   960     // Warning: is_ext_suspend_completed() may temporarily drop the
   961     // SR_lock to allow the thread to reach a stable thread state if
   962     // it is currently in a transient thread state.
   963     return is_ext_suspend_completed(false /*!called_by_wait */,
   964                                     SuspendRetryDelay, bits);
   965   }
   967   // We cannot allow wait_for_ext_suspend_completion() to run forever or
   968   // we could hang. SuspendRetryCount and SuspendRetryDelay are normally
   969   // passed as the count and delay parameters. Experiments with specific
   970   // calls to wait_for_ext_suspend_completion() can be done by passing
   971   // other values in the code. Experiments with all calls can be done
   972   // via the appropriate -XX options.
   973   bool wait_for_ext_suspend_completion(int count, int delay, uint32_t *bits);
   975   void set_external_suspend()     { set_suspend_flag  (_external_suspend); }
   976   void clear_external_suspend()   { clear_suspend_flag(_external_suspend); }
   978   void set_deopt_suspend()        { set_suspend_flag  (_deopt_suspend); }
   979   void clear_deopt_suspend()      { clear_suspend_flag(_deopt_suspend); }
   980   bool is_deopt_suspend()         { return (_suspend_flags & _deopt_suspend) != 0; }
   982   bool is_external_suspend() const {
   983     return (_suspend_flags & _external_suspend) != 0;
   984   }
   985   // Whenever a thread transitions from native to vm/java it must suspend
   986   // if external|deopt suspend is present.
   987   bool is_suspend_after_native() const {
   988     return (_suspend_flags & (_external_suspend | _deopt_suspend) ) != 0;
   989   }
   991   // external suspend request is completed
   992   bool is_ext_suspended() const {
   993     return (_suspend_flags & _ext_suspended) != 0;
   994   }
   996   bool is_external_suspend_with_lock() const {
   997     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
   998     return is_external_suspend();
   999   }
  1001   // Special method to handle a pending external suspend request
  1002   // when a suspend equivalent condition lifts.
  1003   bool handle_special_suspend_equivalent_condition() {
  1004     assert(is_suspend_equivalent(),
  1005       "should only be called in a suspend equivalence condition");
  1006     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
  1007     bool ret = is_external_suspend();
  1008     if (!ret) {
  1009       // not about to self-suspend so clear suspend equivalence
  1010       clear_suspend_equivalent();
  1012     // implied else:
  1013     // We have a pending external suspend request so we leave the
  1014     // suspend_equivalent flag set until java_suspend_self() sets
  1015     // the ext_suspended flag and clears the suspend_equivalent
  1016     // flag. This insures that wait_for_ext_suspend_completion()
  1017     // will return consistent values.
  1018     return ret;
  1021   // utility methods to see if we are doing some kind of suspension
  1022   bool is_being_ext_suspended() const            {
  1023     MutexLockerEx ml(SR_lock(), Mutex::_no_safepoint_check_flag);
  1024     return is_ext_suspended() || is_external_suspend();
  1027   bool is_suspend_equivalent() const             { return _suspend_equivalent; }
  1029   void set_suspend_equivalent()                  { _suspend_equivalent = true; };
  1030   void clear_suspend_equivalent()                { _suspend_equivalent = false; };
  1032   // Thread.stop support
  1033   void send_thread_stop(oop throwable);
  1034   AsyncRequests clear_special_runtime_exit_condition() {
  1035     AsyncRequests x = _special_runtime_exit_condition;
  1036     _special_runtime_exit_condition = _no_async_condition;
  1037     return x;
  1040   // Are any async conditions present?
  1041   bool has_async_condition() { return (_special_runtime_exit_condition != _no_async_condition); }
  1043   void check_and_handle_async_exceptions(bool check_unsafe_error = true);
  1045   // these next two are also used for self-suspension and async exception support
  1046   void handle_special_runtime_exit_condition(bool check_asyncs = true);
  1048   // Return true if JavaThread has an asynchronous condition or
  1049   // if external suspension is requested.
  1050   bool has_special_runtime_exit_condition() {
  1051     // We call is_external_suspend() last since external suspend should
  1052     // be less common. Because we don't use is_external_suspend_with_lock
  1053     // it is possible that we won't see an asynchronous external suspend
  1054     // request that has just gotten started, i.e., SR_lock grabbed but
  1055     // _external_suspend field change either not made yet or not visible
  1056     // yet. However, this is okay because the request is asynchronous and
  1057     // we will see the new flag value the next time through. It's also
  1058     // possible that the external suspend request is dropped after
  1059     // we have checked is_external_suspend(), we will recheck its value
  1060     // under SR_lock in java_suspend_self().
  1061     return (_special_runtime_exit_condition != _no_async_condition) ||
  1062             is_external_suspend() || is_deopt_suspend();
  1065   void set_pending_unsafe_access_error()          { _special_runtime_exit_condition = _async_unsafe_access_error; }
  1067   void set_pending_async_exception(oop e) {
  1068     _pending_async_exception = e;
  1069     _special_runtime_exit_condition = _async_exception;
  1070     set_has_async_exception();
  1073   // Fast-locking support
  1074   bool is_lock_owned(address adr) const;
  1076   // Accessors for vframe array top
  1077   // The linked list of vframe arrays are sorted on sp. This means when we
  1078   // unpack the head must contain the vframe array to unpack.
  1079   void set_vframe_array_head(vframeArray* value) { _vframe_array_head = value; }
  1080   vframeArray* vframe_array_head() const         { return _vframe_array_head;  }
  1082   // Side structure for defering update of java frame locals until deopt occurs
  1083   GrowableArray<jvmtiDeferredLocalVariableSet*>* deferred_locals() const { return _deferred_locals_updates; }
  1084   void set_deferred_locals(GrowableArray<jvmtiDeferredLocalVariableSet *>* vf) { _deferred_locals_updates = vf; }
  1086   // These only really exist to make debugging deopt problems simpler
  1088   void set_vframe_array_last(vframeArray* value) { _vframe_array_last = value; }
  1089   vframeArray* vframe_array_last() const         { return _vframe_array_last;  }
  1091   // The special resourceMark used during deoptimization
  1093   void set_deopt_mark(DeoptResourceMark* value)  { _deopt_mark = value; }
  1094   DeoptResourceMark* deopt_mark(void)            { return _deopt_mark; }
  1096   intptr_t* must_deopt_id()                      { return _must_deopt_id; }
  1097   void     set_must_deopt_id(intptr_t* id)       { _must_deopt_id = id; }
  1098   void     clear_must_deopt_id()                 { _must_deopt_id = NULL; }
  1100   methodOop  callee_target() const               { return _callee_target; }
  1101   void set_callee_target  (methodOop x)          { _callee_target   = x; }
  1103   // Oop results of vm runtime calls
  1104   oop  vm_result() const                         { return _vm_result; }
  1105   void set_vm_result  (oop x)                    { _vm_result   = x; }
  1107   oop  vm_result_2() const                       { return _vm_result_2; }
  1108   void set_vm_result_2  (oop x)                  { _vm_result_2   = x; }
  1110   MemRegion deferred_card_mark() const           { return _deferred_card_mark; }
  1111   void set_deferred_card_mark(MemRegion mr)      { _deferred_card_mark = mr;   }
  1113   // Exception handling for compiled methods
  1114   oop      exception_oop() const                 { return _exception_oop; }
  1115   int      exception_stack_size() const          { return _exception_stack_size; }
  1116   address  exception_pc() const                  { return _exception_pc; }
  1117   address  exception_handler_pc() const          { return _exception_handler_pc; }
  1118   bool     is_method_handle_return() const       { return _is_method_handle_return == 1; }
  1120   void set_exception_oop(oop o)                  { _exception_oop = o; }
  1121   void set_exception_pc(address a)               { _exception_pc = a; }
  1122   void set_exception_handler_pc(address a)       { _exception_handler_pc = a; }
  1123   void set_exception_stack_size(int size)        { _exception_stack_size = size; }
  1124   void set_is_method_handle_return(bool value)   { _is_method_handle_return = value ? 1 : 0; }
  1126   // Stack overflow support
  1127   inline size_t stack_available(address cur_sp);
  1128   address stack_yellow_zone_base()
  1129     { return (address)(stack_base() - (stack_size() - (stack_red_zone_size() + stack_yellow_zone_size()))); }
  1130   size_t  stack_yellow_zone_size()
  1131     { return StackYellowPages * os::vm_page_size(); }
  1132   address stack_red_zone_base()
  1133     { return (address)(stack_base() - (stack_size() - stack_red_zone_size())); }
  1134   size_t stack_red_zone_size()
  1135     { return StackRedPages * os::vm_page_size(); }
  1136   bool in_stack_yellow_zone(address a)
  1137     { return (a <= stack_yellow_zone_base()) && (a >= stack_red_zone_base()); }
  1138   bool in_stack_red_zone(address a)
  1139     { return (a <= stack_red_zone_base()) && (a >= (address)((intptr_t)stack_base() - stack_size())); }
  1141   void create_stack_guard_pages();
  1142   void remove_stack_guard_pages();
  1144   void enable_stack_yellow_zone();
  1145   void disable_stack_yellow_zone();
  1146   void enable_stack_red_zone();
  1147   void disable_stack_red_zone();
  1149   inline bool stack_yellow_zone_disabled();
  1150   inline bool stack_yellow_zone_enabled();
  1152   // Attempt to reguard the stack after a stack overflow may have occurred.
  1153   // Returns true if (a) guard pages are not needed on this thread, (b) the
  1154   // pages are already guarded, or (c) the pages were successfully reguarded.
  1155   // Returns false if there is not enough stack space to reguard the pages, in
  1156   // which case the caller should unwind a frame and try again.  The argument
  1157   // should be the caller's (approximate) sp.
  1158   bool reguard_stack(address cur_sp);
  1159   // Similar to above but see if current stackpoint is out of the guard area
  1160   // and reguard if possible.
  1161   bool reguard_stack(void);
  1163   // Misc. accessors/mutators
  1164   void set_do_not_unlock(void)                   { _do_not_unlock_if_synchronized = true; }
  1165   void clr_do_not_unlock(void)                   { _do_not_unlock_if_synchronized = false; }
  1166   bool do_not_unlock(void)                       { return _do_not_unlock_if_synchronized; }
  1168 #ifndef PRODUCT
  1169   void record_jump(address target, address instr, const char* file, int line);
  1170 #endif /* PRODUCT */
  1172   // For assembly stub generation
  1173   static ByteSize threadObj_offset()             { return byte_offset_of(JavaThread, _threadObj           ); }
  1174 #ifndef PRODUCT
  1175   static ByteSize jmp_ring_index_offset()        { return byte_offset_of(JavaThread, _jmp_ring_index      ); }
  1176   static ByteSize jmp_ring_offset()              { return byte_offset_of(JavaThread, _jmp_ring            ); }
  1177 #endif /* PRODUCT */
  1178   static ByteSize jni_environment_offset()       { return byte_offset_of(JavaThread, _jni_environment     ); }
  1179   static ByteSize last_Java_sp_offset()          {
  1180     return byte_offset_of(JavaThread, _anchor) + JavaFrameAnchor::last_Java_sp_offset();
  1182   static ByteSize last_Java_pc_offset()          {
  1183     return byte_offset_of(JavaThread, _anchor) + JavaFrameAnchor::last_Java_pc_offset();
  1185   static ByteSize frame_anchor_offset()          {
  1186     return byte_offset_of(JavaThread, _anchor);
  1188   static ByteSize callee_target_offset()         { return byte_offset_of(JavaThread, _callee_target       ); }
  1189   static ByteSize vm_result_offset()             { return byte_offset_of(JavaThread, _vm_result           ); }
  1190   static ByteSize vm_result_2_offset()           { return byte_offset_of(JavaThread, _vm_result_2         ); }
  1191   static ByteSize thread_state_offset()          { return byte_offset_of(JavaThread, _thread_state        ); }
  1192   static ByteSize saved_exception_pc_offset()    { return byte_offset_of(JavaThread, _saved_exception_pc  ); }
  1193   static ByteSize osthread_offset()              { return byte_offset_of(JavaThread, _osthread            ); }
  1194   static ByteSize exception_oop_offset()         { return byte_offset_of(JavaThread, _exception_oop       ); }
  1195   static ByteSize exception_pc_offset()          { return byte_offset_of(JavaThread, _exception_pc        ); }
  1196   static ByteSize exception_handler_pc_offset()  { return byte_offset_of(JavaThread, _exception_handler_pc); }
  1197   static ByteSize exception_stack_size_offset()  { return byte_offset_of(JavaThread, _exception_stack_size); }
  1198   static ByteSize is_method_handle_return_offset() { return byte_offset_of(JavaThread, _is_method_handle_return); }
  1199   static ByteSize stack_guard_state_offset()     { return byte_offset_of(JavaThread, _stack_guard_state   ); }
  1200   static ByteSize suspend_flags_offset()         { return byte_offset_of(JavaThread, _suspend_flags       ); }
  1202   static ByteSize do_not_unlock_if_synchronized_offset() { return byte_offset_of(JavaThread, _do_not_unlock_if_synchronized); }
  1203   static ByteSize should_post_on_exceptions_flag_offset() {
  1204     return byte_offset_of(JavaThread, _should_post_on_exceptions_flag);
  1207 #ifndef SERIALGC
  1208   static ByteSize satb_mark_queue_offset()       { return byte_offset_of(JavaThread, _satb_mark_queue); }
  1209   static ByteSize dirty_card_queue_offset()      { return byte_offset_of(JavaThread, _dirty_card_queue); }
  1210 #endif // !SERIALGC
  1212   // Returns the jni environment for this thread
  1213   JNIEnv* jni_environment()                      { return &_jni_environment; }
  1215   static JavaThread* thread_from_jni_environment(JNIEnv* env) {
  1216     JavaThread *thread_from_jni_env = (JavaThread*)((intptr_t)env - in_bytes(jni_environment_offset()));
  1217     // Only return NULL if thread is off the thread list; starting to
  1218     // exit should not return NULL.
  1219     if (thread_from_jni_env->is_terminated()) {
  1220        thread_from_jni_env->block_if_vm_exited();
  1221        return NULL;
  1222     } else {
  1223        return thread_from_jni_env;
  1227   // JNI critical regions. These can nest.
  1228   bool in_critical()    { return _jni_active_critical > 0; }
  1229   void enter_critical() { assert(Thread::current() == this,
  1230                                  "this must be current thread");
  1231                           _jni_active_critical++; }
  1232   void exit_critical()  { assert(Thread::current() == this,
  1233                                  "this must be current thread");
  1234                           _jni_active_critical--;
  1235                           assert(_jni_active_critical >= 0,
  1236                                  "JNI critical nesting problem?"); }
  1238   // For deadlock detection
  1239   int depth_first_number() { return _depth_first_number; }
  1240   void set_depth_first_number(int dfn) { _depth_first_number = dfn; }
  1242  private:
  1243   void set_monitor_chunks(MonitorChunk* monitor_chunks) { _monitor_chunks = monitor_chunks; }
  1245  public:
  1246   MonitorChunk* monitor_chunks() const           { return _monitor_chunks; }
  1247   void add_monitor_chunk(MonitorChunk* chunk);
  1248   void remove_monitor_chunk(MonitorChunk* chunk);
  1249   bool in_deopt_handler() const                  { return _in_deopt_handler > 0; }
  1250   void inc_in_deopt_handler()                    { _in_deopt_handler++; }
  1251   void dec_in_deopt_handler()                    {
  1252     assert(_in_deopt_handler > 0, "mismatched deopt nesting");
  1253     if (_in_deopt_handler > 0) { // robustness
  1254       _in_deopt_handler--;
  1258  private:
  1259   void set_entry_point(ThreadFunction entry_point) { _entry_point = entry_point; }
  1261  public:
  1263   // Frame iteration; calls the function f for all frames on the stack
  1264   void frames_do(void f(frame*, const RegisterMap*));
  1266   // Memory operations
  1267   void oops_do(OopClosure* f, CodeBlobClosure* cf);
  1269   // Sweeper operations
  1270   void nmethods_do(CodeBlobClosure* cf);
  1272   // Memory management operations
  1273   void gc_epilogue();
  1274   void gc_prologue();
  1276   // Misc. operations
  1277   char* name() const { return (char*)get_thread_name(); }
  1278   void print_on(outputStream* st) const;
  1279   void print() const { print_on(tty); }
  1280   void print_value();
  1281   void print_thread_state_on(outputStream* ) const      PRODUCT_RETURN;
  1282   void print_thread_state() const                       PRODUCT_RETURN;
  1283   void print_on_error(outputStream* st, char* buf, int buflen) const;
  1284   void verify();
  1285   const char* get_thread_name() const;
  1286 private:
  1287   // factor out low-level mechanics for use in both normal and error cases
  1288   const char* get_thread_name_string(char* buf = NULL, int buflen = 0) const;
  1289 public:
  1290   const char* get_threadgroup_name() const;
  1291   const char* get_parent_name() const;
  1293   // Accessing frames
  1294   frame last_frame() {
  1295     _anchor.make_walkable(this);
  1296     return pd_last_frame();
  1298   javaVFrame* last_java_vframe(RegisterMap* reg_map);
  1300   // Returns method at 'depth' java or native frames down the stack
  1301   // Used for security checks
  1302   klassOop security_get_caller_class(int depth);
  1304   // Print stack trace in external format
  1305   void print_stack_on(outputStream* st);
  1306   void print_stack() { print_stack_on(tty); }
  1308   // Print stack traces in various internal formats
  1309   void trace_stack()                             PRODUCT_RETURN;
  1310   void trace_stack_from(vframe* start_vf)        PRODUCT_RETURN;
  1311   void trace_frames()                            PRODUCT_RETURN;
  1313   // Returns the number of stack frames on the stack
  1314   int depth() const;
  1316   // Function for testing deoptimization
  1317   void deoptimize();
  1318   void make_zombies();
  1320   void deoptimized_wrt_marked_nmethods();
  1322   // Profiling operation (see fprofile.cpp)
  1323  public:
  1324    bool profile_last_Java_frame(frame* fr);
  1326  private:
  1327    ThreadProfiler* _thread_profiler;
  1328  private:
  1329    friend class FlatProfiler;                    // uses both [gs]et_thread_profiler.
  1330    friend class FlatProfilerTask;                // uses get_thread_profiler.
  1331    friend class ThreadProfilerMark;              // uses get_thread_profiler.
  1332    ThreadProfiler* get_thread_profiler()         { return _thread_profiler; }
  1333    ThreadProfiler* set_thread_profiler(ThreadProfiler* tp) {
  1334      ThreadProfiler* result = _thread_profiler;
  1335      _thread_profiler = tp;
  1336      return result;
  1339   // Static operations
  1340  public:
  1341   // Returns the running thread as a JavaThread
  1342   static inline JavaThread* current();
  1344   // Returns the active Java thread.  Do not use this if you know you are calling
  1345   // from a JavaThread, as it's slower than JavaThread::current.  If called from
  1346   // the VMThread, it also returns the JavaThread that instigated the VMThread's
  1347   // operation.  You may not want that either.
  1348   static JavaThread* active();
  1350   inline CompilerThread* as_CompilerThread();
  1352  public:
  1353   virtual void run();
  1354   void thread_main_inner();
  1356  private:
  1357   // PRIVILEGED STACK
  1358   PrivilegedElement*  _privileged_stack_top;
  1359   GrowableArray<oop>* _array_for_gc;
  1360  public:
  1362   // Returns the privileged_stack information.
  1363   PrivilegedElement* privileged_stack_top() const       { return _privileged_stack_top; }
  1364   void set_privileged_stack_top(PrivilegedElement *e)   { _privileged_stack_top = e; }
  1365   void register_array_for_gc(GrowableArray<oop>* array) { _array_for_gc = array; }
  1367  public:
  1368   // Thread local information maintained by JVMTI.
  1369   void set_jvmti_thread_state(JvmtiThreadState *value)                           { _jvmti_thread_state = value; }
  1370   // A JvmtiThreadState is lazily allocated. This jvmti_thread_state()
  1371   // getter is used to get this JavaThread's JvmtiThreadState if it has
  1372   // one which means NULL can be returned. JvmtiThreadState::state_for()
  1373   // is used to get the specified JavaThread's JvmtiThreadState if it has
  1374   // one or it allocates a new JvmtiThreadState for the JavaThread and
  1375   // returns it. JvmtiThreadState::state_for() will return NULL only if
  1376   // the specified JavaThread is exiting.
  1377   JvmtiThreadState *jvmti_thread_state() const                                   { return _jvmti_thread_state; }
  1378   static ByteSize jvmti_thread_state_offset()                                    { return byte_offset_of(JavaThread, _jvmti_thread_state); }
  1379   void set_jvmti_get_loaded_classes_closure(JvmtiGetLoadedClassesClosure* value) { _jvmti_get_loaded_classes_closure = value; }
  1380   JvmtiGetLoadedClassesClosure* get_jvmti_get_loaded_classes_closure() const     { return _jvmti_get_loaded_classes_closure; }
  1382   // JVMTI PopFrame support
  1383   // Setting and clearing popframe_condition
  1384   // All of these enumerated values are bits. popframe_pending
  1385   // indicates that a PopFrame() has been requested and not yet been
  1386   // completed. popframe_processing indicates that that PopFrame() is in
  1387   // the process of being completed. popframe_force_deopt_reexecution_bit
  1388   // indicates that special handling is required when returning to a
  1389   // deoptimized caller.
  1390   enum PopCondition {
  1391     popframe_inactive                      = 0x00,
  1392     popframe_pending_bit                   = 0x01,
  1393     popframe_processing_bit                = 0x02,
  1394     popframe_force_deopt_reexecution_bit   = 0x04
  1395   };
  1396   PopCondition popframe_condition()                   { return (PopCondition) _popframe_condition; }
  1397   void set_popframe_condition(PopCondition c)         { _popframe_condition = c; }
  1398   void set_popframe_condition_bit(PopCondition c)     { _popframe_condition |= c; }
  1399   void clear_popframe_condition()                     { _popframe_condition = popframe_inactive; }
  1400   static ByteSize popframe_condition_offset()         { return byte_offset_of(JavaThread, _popframe_condition); }
  1401   bool has_pending_popframe()                         { return (popframe_condition() & popframe_pending_bit) != 0; }
  1402   bool popframe_forcing_deopt_reexecution()           { return (popframe_condition() & popframe_force_deopt_reexecution_bit) != 0; }
  1403   void clear_popframe_forcing_deopt_reexecution()     { _popframe_condition &= ~popframe_force_deopt_reexecution_bit; }
  1404 #ifdef CC_INTERP
  1405   bool pop_frame_pending(void)                        { return ((_popframe_condition & popframe_pending_bit) != 0); }
  1406   void clr_pop_frame_pending(void)                    { _popframe_condition = popframe_inactive; }
  1407   bool pop_frame_in_process(void)                     { return ((_popframe_condition & popframe_processing_bit) != 0); }
  1408   void set_pop_frame_in_process(void)                 { _popframe_condition |= popframe_processing_bit; }
  1409   void clr_pop_frame_in_process(void)                 { _popframe_condition &= ~popframe_processing_bit; }
  1410 #endif
  1412  private:
  1413   // Saved incoming arguments to popped frame.
  1414   // Used only when popped interpreted frame returns to deoptimized frame.
  1415   void*    _popframe_preserved_args;
  1416   int      _popframe_preserved_args_size;
  1418  public:
  1419   void  popframe_preserve_args(ByteSize size_in_bytes, void* start);
  1420   void* popframe_preserved_args();
  1421   ByteSize popframe_preserved_args_size();
  1422   WordSize popframe_preserved_args_size_in_words();
  1423   void  popframe_free_preserved_args();
  1426  private:
  1427   JvmtiThreadState *_jvmti_thread_state;
  1428   JvmtiGetLoadedClassesClosure* _jvmti_get_loaded_classes_closure;
  1430   // Used by the interpreter in fullspeed mode for frame pop, method
  1431   // entry, method exit and single stepping support. This field is
  1432   // only set to non-zero by the VM_EnterInterpOnlyMode VM operation.
  1433   // It can be set to zero asynchronously (i.e., without a VM operation
  1434   // or a lock) so we have to be very careful.
  1435   int               _interp_only_mode;
  1437  public:
  1438   // used by the interpreter for fullspeed debugging support (see above)
  1439   static ByteSize interp_only_mode_offset() { return byte_offset_of(JavaThread, _interp_only_mode); }
  1440   bool is_interp_only_mode()                { return (_interp_only_mode != 0); }
  1441   int get_interp_only_mode()                { return _interp_only_mode; }
  1442   void increment_interp_only_mode()         { ++_interp_only_mode; }
  1443   void decrement_interp_only_mode()         { --_interp_only_mode; }
  1445   // support for cached flag that indicates whether exceptions need to be posted for this thread
  1446   // if this is false, we can avoid deoptimizing when events are thrown
  1447   // this gets set to reflect whether jvmtiExport::post_exception_throw would actually do anything
  1448  private:
  1449   int    _should_post_on_exceptions_flag;
  1451  public:
  1452   int   should_post_on_exceptions_flag()  { return _should_post_on_exceptions_flag; }
  1453   void  set_should_post_on_exceptions_flag(int val)  { _should_post_on_exceptions_flag = val; }
  1455  private:
  1456   ThreadStatistics *_thread_stat;
  1458  public:
  1459   ThreadStatistics* get_thread_stat() const    { return _thread_stat; }
  1461   // Return a blocker object for which this thread is blocked parking.
  1462   oop current_park_blocker();
  1464  private:
  1465   static size_t _stack_size_at_create;
  1467  public:
  1468   static inline size_t stack_size_at_create(void) {
  1469     return _stack_size_at_create;
  1471   static inline void set_stack_size_at_create(size_t value) {
  1472     _stack_size_at_create = value;
  1475 #ifndef SERIALGC
  1476   // SATB marking queue support
  1477   ObjPtrQueue& satb_mark_queue() { return _satb_mark_queue; }
  1478   static SATBMarkQueueSet& satb_mark_queue_set() {
  1479     return _satb_mark_queue_set;
  1482   // Dirty card queue support
  1483   DirtyCardQueue& dirty_card_queue() { return _dirty_card_queue; }
  1484   static DirtyCardQueueSet& dirty_card_queue_set() {
  1485     return _dirty_card_queue_set;
  1487 #endif // !SERIALGC
  1489   // Machine dependent stuff
  1490   #include "incls/_thread_pd.hpp.incl"
  1492  public:
  1493   void set_blocked_on_compilation(bool value) {
  1494     _blocked_on_compilation = value;
  1497   bool blocked_on_compilation() {
  1498     return _blocked_on_compilation;
  1500  protected:
  1501   bool         _blocked_on_compilation;
  1504   // JSR166 per-thread parker
  1505 private:
  1506   Parker*    _parker;
  1507 public:
  1508   Parker*     parker() { return _parker; }
  1510   // Biased locking support
  1511 private:
  1512   GrowableArray<MonitorInfo*>* _cached_monitor_info;
  1513 public:
  1514   GrowableArray<MonitorInfo*>* cached_monitor_info() { return _cached_monitor_info; }
  1515   void set_cached_monitor_info(GrowableArray<MonitorInfo*>* info) { _cached_monitor_info = info; }
  1517   // clearing/querying jni attach status
  1518   bool is_attaching() const { return _is_attaching; }
  1519   void set_attached() { _is_attaching = false; OrderAccess::fence(); }
  1520 private:
  1521   // This field is used to determine if a thread has claimed
  1522   // a par_id: it is -1 if the thread has not claimed a par_id;
  1523   // otherwise its value is the par_id that has been claimed.
  1524   int _claimed_par_id;
  1525 public:
  1526   int get_claimed_par_id() { return _claimed_par_id; }
  1527   void set_claimed_par_id(int id) { _claimed_par_id = id;}
  1528 };
  1530 // Inline implementation of JavaThread::current
  1531 inline JavaThread* JavaThread::current() {
  1532   Thread* thread = ThreadLocalStorage::thread();
  1533   assert(thread != NULL && thread->is_Java_thread(), "just checking");
  1534   return (JavaThread*)thread;
  1537 inline CompilerThread* JavaThread::as_CompilerThread() {
  1538   assert(is_Compiler_thread(), "just checking");
  1539   return (CompilerThread*)this;
  1542 inline bool JavaThread::stack_yellow_zone_disabled() {
  1543   return _stack_guard_state == stack_guard_yellow_disabled;
  1546 inline bool JavaThread::stack_yellow_zone_enabled() {
  1547 #ifdef ASSERT
  1548   if (os::uses_stack_guard_pages()) {
  1549     assert(_stack_guard_state != stack_guard_unused, "guard pages must be in use");
  1551 #endif
  1552     return _stack_guard_state == stack_guard_enabled;
  1555 inline size_t JavaThread::stack_available(address cur_sp) {
  1556   // This code assumes java stacks grow down
  1557   address low_addr; // Limit on the address for deepest stack depth
  1558   if ( _stack_guard_state == stack_guard_unused) {
  1559     low_addr =  stack_base() - stack_size();
  1560   } else {
  1561     low_addr = stack_yellow_zone_base();
  1563   return cur_sp > low_addr ? cur_sp - low_addr : 0;
  1566 // A JavaThread for low memory detection support
  1567 class LowMemoryDetectorThread : public JavaThread {
  1568   friend class VMStructs;
  1569 public:
  1570   LowMemoryDetectorThread(ThreadFunction entry_point) : JavaThread(entry_point) {};
  1572   // Hide this thread from external view.
  1573   bool is_hidden_from_external_view() const      { return true; }
  1574 };
  1576 // A thread used for Compilation.
  1577 class CompilerThread : public JavaThread {
  1578   friend class VMStructs;
  1579  private:
  1580   CompilerCounters* _counters;
  1582   ciEnv*        _env;
  1583   CompileLog*   _log;
  1584   CompileTask*  _task;
  1585   CompileQueue* _queue;
  1586   BufferBlob*   _buffer_blob;
  1588  public:
  1590   static CompilerThread* current();
  1592   CompilerThread(CompileQueue* queue, CompilerCounters* counters);
  1594   bool is_Compiler_thread() const                { return true; }
  1595   // Hide this compiler thread from external view.
  1596   bool is_hidden_from_external_view() const      { return true; }
  1598   CompileQueue* queue()                          { return _queue; }
  1599   CompilerCounters* counters()                   { return _counters; }
  1601   // Get/set the thread's compilation environment.
  1602   ciEnv*        env()                            { return _env; }
  1603   void          set_env(ciEnv* env)              { _env = env; }
  1605   BufferBlob*   get_buffer_blob()                { return _buffer_blob; }
  1606   void          set_buffer_blob(BufferBlob* b)   { _buffer_blob = b; };
  1608   // Get/set the thread's logging information
  1609   CompileLog*   log()                            { return _log; }
  1610   void          init_log(CompileLog* log) {
  1611     // Set once, for good.
  1612     assert(_log == NULL, "set only once");
  1613     _log = log;
  1616 #ifndef PRODUCT
  1617 private:
  1618   IdealGraphPrinter *_ideal_graph_printer;
  1619 public:
  1620   IdealGraphPrinter *ideal_graph_printer()                       { return _ideal_graph_printer; }
  1621   void set_ideal_graph_printer(IdealGraphPrinter *n)             { _ideal_graph_printer = n; }
  1622 #endif
  1624   // Get/set the thread's current task
  1625   CompileTask*  task()                           { return _task; }
  1626   void          set_task(CompileTask* task)      { _task = task; }
  1627 };
  1629 inline CompilerThread* CompilerThread::current() {
  1630   return JavaThread::current()->as_CompilerThread();
  1634 // The active thread queue. It also keeps track of the current used
  1635 // thread priorities.
  1636 class Threads: AllStatic {
  1637   friend class VMStructs;
  1638  private:
  1639   static JavaThread* _thread_list;
  1640   static int         _number_of_threads;
  1641   static int         _number_of_non_daemon_threads;
  1642   static int         _return_code;
  1644  public:
  1645   // Thread management
  1646   // force_daemon is a concession to JNI, where we may need to add a
  1647   // thread to the thread list before allocating its thread object
  1648   static void add(JavaThread* p, bool force_daemon = false);
  1649   static void remove(JavaThread* p);
  1650   static bool includes(JavaThread* p);
  1651   static JavaThread* first()                     { return _thread_list; }
  1652   static void threads_do(ThreadClosure* tc);
  1654   // Initializes the vm and creates the vm thread
  1655   static jint create_vm(JavaVMInitArgs* args, bool* canTryAgain);
  1656   static void convert_vm_init_libraries_to_agents();
  1657   static void create_vm_init_libraries();
  1658   static void create_vm_init_agents();
  1659   static void shutdown_vm_agents();
  1660   static bool destroy_vm();
  1661   // Supported VM versions via JNI
  1662   // Includes JNI_VERSION_1_1
  1663   static jboolean is_supported_jni_version_including_1_1(jint version);
  1664   // Does not include JNI_VERSION_1_1
  1665   static jboolean is_supported_jni_version(jint version);
  1667   // Garbage collection
  1668   static void follow_other_roots(void f(oop*));
  1670   // Apply "f->do_oop" to all root oops in all threads.
  1671   // This version may only be called by sequential code.
  1672   static void oops_do(OopClosure* f, CodeBlobClosure* cf);
  1673   // This version may be called by sequential or parallel code.
  1674   static void possibly_parallel_oops_do(OopClosure* f, CodeBlobClosure* cf);
  1675   // This creates a list of GCTasks, one per thread.
  1676   static void create_thread_roots_tasks(GCTaskQueue* q);
  1677   // This creates a list of GCTasks, one per thread, for marking objects.
  1678   static void create_thread_roots_marking_tasks(GCTaskQueue* q);
  1680   // Apply "f->do_oop" to roots in all threads that
  1681   // are part of compiled frames
  1682   static void compiled_frame_oops_do(OopClosure* f, CodeBlobClosure* cf);
  1684   static void convert_hcode_pointers();
  1685   static void restore_hcode_pointers();
  1687   // Sweeper
  1688   static void nmethods_do(CodeBlobClosure* cf);
  1690   static void gc_epilogue();
  1691   static void gc_prologue();
  1693   // Verification
  1694   static void verify();
  1695   static void print_on(outputStream* st, bool print_stacks, bool internal_format, bool print_concurrent_locks);
  1696   static void print(bool print_stacks, bool internal_format) {
  1697     // this function is only used by debug.cpp
  1698     print_on(tty, print_stacks, internal_format, false /* no concurrent lock printed */);
  1700   static void print_on_error(outputStream* st, Thread* current, char* buf, int buflen);
  1702   // Get Java threads that are waiting to enter a monitor. If doLock
  1703   // is true, then Threads_lock is grabbed as needed. Otherwise, the
  1704   // VM needs to be at a safepoint.
  1705   static GrowableArray<JavaThread*>* get_pending_threads(int count,
  1706     address monitor, bool doLock);
  1708   // Get owning Java thread from the monitor's owner field. If doLock
  1709   // is true, then Threads_lock is grabbed as needed. Otherwise, the
  1710   // VM needs to be at a safepoint.
  1711   static JavaThread *owning_thread_from_monitor_owner(address owner,
  1712     bool doLock);
  1714   // Number of threads on the active threads list
  1715   static int number_of_threads()                 { return _number_of_threads; }
  1716   // Number of non-daemon threads on the active threads list
  1717   static int number_of_non_daemon_threads()      { return _number_of_non_daemon_threads; }
  1719   // Deoptimizes all frames tied to marked nmethods
  1720   static void deoptimized_wrt_marked_nmethods();
  1722 };
  1725 // Thread iterator
  1726 class ThreadClosure: public StackObj {
  1727  public:
  1728   virtual void do_thread(Thread* thread) = 0;
  1729 };
  1731 class SignalHandlerMark: public StackObj {
  1732 private:
  1733   Thread* _thread;
  1734 public:
  1735   SignalHandlerMark(Thread* t) {
  1736     _thread = t;
  1737     if (_thread) _thread->enter_signal_handler();
  1739   ~SignalHandlerMark() {
  1740     if (_thread) _thread->leave_signal_handler();
  1741     _thread = NULL;
  1743 };
  1745 // ParkEvents are type-stable and immortal.
  1746 //
  1747 // Lifecycle: Once a ParkEvent is associated with a thread that ParkEvent remains
  1748 // associated with the thread for the thread's entire lifetime - the relationship is
  1749 // stable. A thread will be associated at most one ParkEvent.  When the thread
  1750 // expires, the ParkEvent moves to the EventFreeList.  New threads attempt to allocate from
  1751 // the EventFreeList before creating a new Event.  Type-stability frees us from
  1752 // worrying about stale Event or Thread references in the objectMonitor subsystem.
  1753 // (A reference to ParkEvent is always valid, even though the event may no longer be associated
  1754 // with the desired or expected thread.  A key aspect of this design is that the callers of
  1755 // park, unpark, etc must tolerate stale references and spurious wakeups).
  1756 //
  1757 // Only the "associated" thread can block (park) on the ParkEvent, although
  1758 // any other thread can unpark a reachable parkevent.  Park() is allowed to
  1759 // return spuriously.  In fact park-unpark a really just an optimization to
  1760 // avoid unbounded spinning and surrender the CPU to be a polite system citizen.
  1761 // A degenerate albeit "impolite" park-unpark implementation could simply return.
  1762 // See http://blogs.sun.com/dave for more details.
  1763 //
  1764 // Eventually I'd like to eliminate Events and ObjectWaiters, both of which serve as
  1765 // thread proxies, and simply make the THREAD structure type-stable and persistent.
  1766 // Currently, we unpark events associated with threads, but ideally we'd just
  1767 // unpark threads.
  1768 //
  1769 // The base-class, PlatformEvent, is platform-specific while the ParkEvent is
  1770 // platform-independent.  PlatformEvent provides park(), unpark(), etc., and
  1771 // is abstract -- that is, a PlatformEvent should never be instantiated except
  1772 // as part of a ParkEvent.
  1773 // Equivalently we could have defined a platform-independent base-class that
  1774 // exported Allocate(), Release(), etc.  The platform-specific class would extend
  1775 // that base-class, adding park(), unpark(), etc.
  1776 //
  1777 // A word of caution: The JVM uses 2 very similar constructs:
  1778 // 1. ParkEvent are used for Java-level "monitor" synchronization.
  1779 // 2. Parkers are used by JSR166-JUC park-unpark.
  1780 //
  1781 // We'll want to eventually merge these redundant facilities and use ParkEvent.
  1784 class ParkEvent : public os::PlatformEvent {
  1785   private:
  1786     ParkEvent * FreeNext ;
  1788     // Current association
  1789     Thread * AssociatedWith ;
  1790     intptr_t RawThreadIdentity ;        // LWPID etc
  1791     volatile int Incarnation ;
  1793     // diagnostic : keep track of last thread to wake this thread.
  1794     // this is useful for construction of dependency graphs.
  1795     void * LastWaker ;
  1797   public:
  1798     // MCS-CLH list linkage and Native Mutex/Monitor
  1799     ParkEvent * volatile ListNext ;
  1800     ParkEvent * volatile ListPrev ;
  1801     volatile intptr_t OnList ;
  1802     volatile int TState ;
  1803     volatile int Notified ;             // for native monitor construct
  1804     volatile int IsWaiting ;            // Enqueued on WaitSet
  1807   private:
  1808     static ParkEvent * volatile FreeList ;
  1809     static volatile int ListLock ;
  1811     // It's prudent to mark the dtor as "private"
  1812     // ensuring that it's not visible outside the package.
  1813     // Unfortunately gcc warns about such usage, so
  1814     // we revert to the less desirable "protected" visibility.
  1815     // The other compilers accept private dtors.
  1817   protected:        // Ensure dtor is never invoked
  1818     ~ParkEvent() { guarantee (0, "invariant") ; }
  1820     ParkEvent() : PlatformEvent() {
  1821        AssociatedWith = NULL ;
  1822        FreeNext       = NULL ;
  1823        ListNext       = NULL ;
  1824        ListPrev       = NULL ;
  1825        OnList         = 0 ;
  1826        TState         = 0 ;
  1827        Notified       = 0 ;
  1828        IsWaiting      = 0 ;
  1831     // We use placement-new to force ParkEvent instances to be
  1832     // aligned on 256-byte address boundaries.  This ensures that the least
  1833     // significant byte of a ParkEvent address is always 0.
  1835     void * operator new (size_t sz) ;
  1836     void operator delete (void * a) ;
  1838   public:
  1839     static ParkEvent * Allocate (Thread * t) ;
  1840     static void Release (ParkEvent * e) ;
  1841 } ;

mercurial