1 /*
2 * Copyright (c) 1997, 2019, 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_RUNTIME_THREAD_HPP
26 #define SHARE_RUNTIME_THREAD_HPP
27
28 #include "jni.h"
29 #include "code/compiledMethod.hpp"
30 #include "gc/shared/gcThreadLocalData.hpp"
31 #include "gc/shared/threadLocalAllocBuffer.hpp"
32 #include "memory/allocation.hpp"
33 #include "oops/oop.hpp"
34 #include "prims/jvmtiExport.hpp"
35 #include "runtime/frame.hpp"
36 #include "runtime/globals.hpp"
37 #include "runtime/handshake.hpp"
38 #include "runtime/javaFrameAnchor.hpp"
39 #include "runtime/jniHandles.hpp"
40 #include "runtime/mutexLocker.hpp"
41 #include "runtime/os.hpp"
42 #include "runtime/osThread.hpp"
43 #include "runtime/park.hpp"
44 #include "runtime/stubRoutines.hpp"
45 #include "runtime/threadHeapSampler.hpp"
46 #include "runtime/threadLocalStorage.hpp"
47 #include "runtime/threadStatisticalInfo.hpp"
48 #include "runtime/unhandledOops.hpp"
49 #include "utilities/align.hpp"
50 #include "utilities/exceptions.hpp"
51 #include "utilities/macros.hpp"
52 #ifdef ZERO
53 # include "stack_zero.hpp"
54 #endif
55 #if INCLUDE_JFR
56 #include "jfr/support/jfrThreadExtension.hpp"
57 #endif
58
59
60 class SafeThreadsListPtr;
61 class ThreadSafepointState;
62 class ThreadsList;
63 class ThreadsSMRSupport;
64
65 class JvmtiThreadState;
66 class ThreadStatistics;
67 class ConcurrentLocksDump;
68 class ParkEvent;
69 class Parker;
70 class MonitorInfo;
71
72 class ciEnv;
73 class CompileThread;
74 class CompileLog;
75 class CompileTask;
76 class CompileQueue;
77 class CompilerCounters;
78
79 class vframeArray;
80 class vframe;
81 class javaVFrame;
82
83 class DeoptResourceMark;
84 class jvmtiDeferredLocalVariableSet;
85
86 class GCTaskQueue;
87 class ThreadClosure;
88 class ICRefillVerifier;
89 class IdealGraphPrinter;
90
91 class JVMCIEnv;
92 class JVMCIPrimitiveArray;
93
94 class Metadata;
95 class ResourceArea;
96
97 DEBUG_ONLY(class ResourceMark;)
98
99 class WorkerThread;
100
101 // Class hierarchy
102 // - Thread
103 // - JavaThread
104 // - various subclasses eg CompilerThread, ServiceThread
105 // - NonJavaThread
106 // - NamedThread
107 // - VMThread
108 // - ConcurrentGCThread
109 // - WorkerThread
110 // - GangWorker
111 // - GCTaskThread
112 // - WatcherThread
113 // - JfrThreadSampler
114 //
115 // All Thread subclasses must be either JavaThread or NonJavaThread.
116 // This means !t->is_Java_thread() iff t is a NonJavaThread, or t is
117 // a partially constructed/destroyed Thread.
118
119 // Thread execution sequence and actions:
120 // All threads:
121 // - thread_native_entry // per-OS native entry point
122 // - stack initialization
123 // - other OS-level initialization (signal masks etc)
124 // - handshake with creating thread (if not started suspended)
125 // - this->call_run() // common shared entry point
126 // - shared common initialization
127 // - this->pre_run() // virtual per-thread-type initialization
128 // - this->run() // virtual per-thread-type "main" logic
129 // - shared common tear-down
130 // - this->post_run() // virtual per-thread-type tear-down
131 // - // 'this' no longer referenceable
132 // - OS-level tear-down (minimal)
133 // - final logging
134 //
135 // For JavaThread:
136 // - this->run() // virtual but not normally overridden
137 // - this->thread_main_inner() // extra call level to ensure correct stack calculations
138 // - this->entry_point() // set differently for each kind of JavaThread
139
140 class Thread: public ThreadShadow {
141 friend class VMStructs;
142 friend class JVMCIVMStructs;
143 private:
144
145 #ifndef USE_LIBRARY_BASED_TLS_ONLY
146 // Current thread is maintained as a thread-local variable
147 static THREAD_LOCAL_DECL Thread* _thr_current;
148 #endif
149
150 // Thread local data area available to the GC. The internal
151 // structure and contents of this data area is GC-specific.
152 // Only GC and GC barrier code should access this data area.
153 GCThreadLocalData _gc_data;
154
155 public:
156 static ByteSize gc_data_offset() {
157 return byte_offset_of(Thread, _gc_data);
158 }
159
160 template <typename T> T* gc_data() {
161 STATIC_ASSERT(sizeof(T) <= sizeof(_gc_data));
162 return reinterpret_cast<T*>(&_gc_data);
163 }
164
165 // Exception handling
166 // (Note: _pending_exception and friends are in ThreadShadow)
167 //oop _pending_exception; // pending exception for current thread
168 // const char* _exception_file; // file information for exception (debugging only)
169 // int _exception_line; // line information for exception (debugging only)
170 protected:
171
172 DEBUG_ONLY(static Thread* _starting_thread;)
173
174 // Support for forcing alignment of thread objects for biased locking
175 void* _real_malloc_address;
176
177 // JavaThread lifecycle support:
178 friend class SafeThreadsListPtr; // for _threads_list_ptr, cmpxchg_threads_hazard_ptr(), {dec_,inc_,}nested_threads_hazard_ptr_cnt(), {g,s}et_threads_hazard_ptr(), inc_nested_handle_cnt(), tag_hazard_ptr() access
179 friend class ScanHazardPtrGatherProtectedThreadsClosure; // for cmpxchg_threads_hazard_ptr(), get_threads_hazard_ptr(), is_hazard_ptr_tagged() access
180 friend class ScanHazardPtrGatherThreadsListClosure; // for get_threads_hazard_ptr(), untag_hazard_ptr() access
181 friend class ScanHazardPtrPrintMatchingThreadsClosure; // for get_threads_hazard_ptr(), is_hazard_ptr_tagged() access
182 friend class ThreadsSMRSupport; // for _nested_threads_hazard_ptr_cnt, _threads_hazard_ptr, _threads_list_ptr access
183
184 ThreadsList* volatile _threads_hazard_ptr;
185 SafeThreadsListPtr* _threads_list_ptr;
186 ThreadsList* cmpxchg_threads_hazard_ptr(ThreadsList* exchange_value, ThreadsList* compare_value);
187 ThreadsList* get_threads_hazard_ptr();
188 void set_threads_hazard_ptr(ThreadsList* new_list);
189 static bool is_hazard_ptr_tagged(ThreadsList* list) {
190 return (intptr_t(list) & intptr_t(1)) == intptr_t(1);
191 }
192 static ThreadsList* tag_hazard_ptr(ThreadsList* list) {
193 return (ThreadsList*)(intptr_t(list) | intptr_t(1));
194 }
195 static ThreadsList* untag_hazard_ptr(ThreadsList* list) {
196 return (ThreadsList*)(intptr_t(list) & ~intptr_t(1));
197 }
198 // This field is enabled via -XX:+EnableThreadSMRStatistics:
199 uint _nested_threads_hazard_ptr_cnt;
200 void dec_nested_threads_hazard_ptr_cnt() {
201 assert(_nested_threads_hazard_ptr_cnt != 0, "mismatched {dec,inc}_nested_threads_hazard_ptr_cnt()");
202 _nested_threads_hazard_ptr_cnt--;
203 }
204 void inc_nested_threads_hazard_ptr_cnt() {
205 _nested_threads_hazard_ptr_cnt++;
206 }
207 uint nested_threads_hazard_ptr_cnt() {
208 return _nested_threads_hazard_ptr_cnt;
209 }
210
211 public:
212 void* operator new(size_t size) throw() { return allocate(size, true); }
213 void* operator new(size_t size, const std::nothrow_t& nothrow_constant) throw() {
214 return allocate(size, false); }
215 void operator delete(void* p);
216
217 protected:
218 static void* allocate(size_t size, bool throw_excpt, MEMFLAGS flags = mtThread);
219 private:
220
221 // ***************************************************************
222 // Suspend and resume support
223 // ***************************************************************
224 //
225 // VM suspend/resume no longer exists - it was once used for various
226 // things including safepoints but was deprecated and finally removed
227 // in Java 7. Because VM suspension was considered "internal" Java-level
228 // suspension was considered "external", and this legacy naming scheme
229 // remains.
230 //
231 // External suspend/resume requests come from JVM_SuspendThread,
232 // JVM_ResumeThread, JVMTI SuspendThread, and finally JVMTI
233 // ResumeThread. External
234 // suspend requests cause _external_suspend to be set and external
235 // resume requests cause _external_suspend to be cleared.
236 // External suspend requests do not nest on top of other external
237 // suspend requests. The higher level APIs reject suspend requests
238 // for already suspended threads.
239 //
240 // The external_suspend
241 // flag is checked by has_special_runtime_exit_condition() and java thread
242 // will self-suspend when handle_special_runtime_exit_condition() is
243 // called. Most uses of the _thread_blocked state in JavaThreads are
244 // considered the same as being externally suspended; if the blocking
245 // condition lifts, the JavaThread will self-suspend. Other places
246 // where VM checks for external_suspend include:
247 // + mutex granting (do not enter monitors when thread is suspended)
248 // + state transitions from _thread_in_native
249 //
250 // In general, java_suspend() does not wait for an external suspend
251 // request to complete. When it returns, the only guarantee is that
252 // the _external_suspend field is true.
253 //
254 // wait_for_ext_suspend_completion() is used to wait for an external
255 // suspend request to complete. External suspend requests are usually
256 // followed by some other interface call that requires the thread to
257 // be quiescent, e.g., GetCallTrace(). By moving the "wait time" into
258 // the interface that requires quiescence, we give the JavaThread a
259 // chance to self-suspend before we need it to be quiescent. This
260 // improves overall suspend/query performance.
261 //
262 // _suspend_flags controls the behavior of java_ suspend/resume.
263 // It must be set under the protection of SR_lock. Read from the flag is
264 // OK without SR_lock as long as the value is only used as a hint.
265 // (e.g., check _external_suspend first without lock and then recheck
266 // inside SR_lock and finish the suspension)
267 //
268 // _suspend_flags is also overloaded for other "special conditions" so
269 // that a single check indicates whether any special action is needed
270 // eg. for async exceptions.
271 // -------------------------------------------------------------------
272 // Notes:
273 // 1. The suspend/resume logic no longer uses ThreadState in OSThread
274 // but we still update its value to keep other part of the system (mainly
275 // JVMTI) happy. ThreadState is legacy code (see notes in
276 // osThread.hpp).
277 //
278 // 2. It would be more natural if set_external_suspend() is private and
279 // part of java_suspend(), but that probably would affect the suspend/query
280 // performance. Need more investigation on this.
281
282 // suspend/resume lock: used for self-suspend
283 Monitor* _SR_lock;
284
285 protected:
286 enum SuspendFlags {
287 // NOTE: avoid using the sign-bit as cc generates different test code
288 // when the sign-bit is used, and sometimes incorrectly - see CR 6398077
289
290 _external_suspend = 0x20000000U, // thread is asked to self suspend
291 _ext_suspended = 0x40000000U, // thread has self-suspended
292
293 _has_async_exception = 0x00000001U, // there is a pending async exception
294 _critical_native_unlock = 0x00000002U, // Must call back to unlock JNI critical lock
295
296 _trace_flag = 0x00000004U // call tracing backend
297 };
298
299 // various suspension related flags - atomically updated
300 // overloaded for async exception checking in check_special_condition_for_native_trans.
301 volatile uint32_t _suspend_flags;
302
303 private:
304 int _num_nested_signal;
305
306 DEBUG_ONLY(bool _suspendible_thread;)
307
308 public:
309 void enter_signal_handler() { _num_nested_signal++; }
310 void leave_signal_handler() { _num_nested_signal--; }
311 bool is_inside_signal_handler() const { return _num_nested_signal > 0; }
312
313 // Determines if a heap allocation failure will be retried
314 // (e.g., by deoptimizing and re-executing in the interpreter).
315 // In this case, the failed allocation must raise
316 // Universe::out_of_memory_error_retry() and omit side effects
317 // such as JVMTI events and handling -XX:+HeapDumpOnOutOfMemoryError
318 // and -XX:OnOutOfMemoryError.
319 virtual bool in_retryable_allocation() const { return false; }
320
321 #ifdef ASSERT
322 void set_suspendible_thread() {
323 _suspendible_thread = true;
324 }
325
326 void clear_suspendible_thread() {
327 _suspendible_thread = false;
328 }
329
330 bool is_suspendible_thread() { return _suspendible_thread; }
331 #endif
332
333 private:
334 // Active_handles points to a block of handles
335 JNIHandleBlock* _active_handles;
336
337 // One-element thread local free list
338 JNIHandleBlock* _free_handle_block;
339
340 // Point to the last handle mark
341 HandleMark* _last_handle_mark;
342
343 // Claim value for parallel iteration over threads.
344 uintx _threads_do_token;
345
346 // Support for GlobalCounter
347 private:
348 volatile uintx _rcu_counter;
349 public:
350 volatile uintx* get_rcu_counter() {
351 return &_rcu_counter;
352 }
353
354 public:
355 void set_last_handle_mark(HandleMark* mark) { _last_handle_mark = mark; }
356 HandleMark* last_handle_mark() const { return _last_handle_mark; }
357 private:
358
359 #ifdef ASSERT
360 ICRefillVerifier* _missed_ic_stub_refill_verifier;
361
362 public:
363 ICRefillVerifier* missed_ic_stub_refill_verifier() {
364 return _missed_ic_stub_refill_verifier;
365 }
366
367 void set_missed_ic_stub_refill_verifier(ICRefillVerifier* verifier) {
368 _missed_ic_stub_refill_verifier = verifier;
369 }
370 #endif
371
372 private:
373
374 // Debug support for checking if code allows safepoints or not.
375 // Safepoints in the VM can happen because of allocation, invoking a VM operation, or blocking on
376 // mutex, or blocking on an object synchronizer (Java locking).
377 // If _no_safepoint_count is non-zero, then an assertion failure will happen in any of
378 // the above cases.
379 //
380 // The class NoSafepointVerifier is used to set this counter.
381 //
382 NOT_PRODUCT(int _no_safepoint_count;) // If 0, thread allow a safepoint to happen
383
384 // Used by SkipGCALot class.
385 NOT_PRODUCT(bool _skip_gcalot;) // Should we elide gc-a-lot?
386
387 friend class NoSafepointVerifier;
388 friend class PauseNoSafepointVerifier;
389 friend class GCLocker;
390
391 volatile void* _polling_page; // Thread local polling page
392
393 ThreadLocalAllocBuffer _tlab; // Thread-local eden
394 jlong _allocated_bytes; // Cumulative number of bytes allocated on
395 // the Java heap
396 ThreadHeapSampler _heap_sampler; // For use when sampling the memory.
397
398 ThreadStatisticalInfo _statistical_info; // Statistics about the thread
399
400 JFR_ONLY(DEFINE_THREAD_LOCAL_FIELD_JFR;) // Thread-local data for jfr
401
402 int _vm_operation_started_count; // VM_Operation support
403 int _vm_operation_completed_count; // VM_Operation support
404
405 ObjectMonitor* _current_pending_monitor; // ObjectMonitor this thread
406 // is waiting to lock
407 bool _current_pending_monitor_is_from_java; // locking is from Java code
408
409 // ObjectMonitor on which this thread called Object.wait()
410 ObjectMonitor* _current_waiting_monitor;
411
412 // Private thread-local objectmonitor list - a simple cache organized as a SLL.
413 public:
414 ObjectMonitor* omFreeList;
415 int omFreeCount; // length of omFreeList
416 int omFreeProvision; // reload chunk size
417 ObjectMonitor* omInUseList; // SLL to track monitors in circulation
418 int omInUseCount; // length of omInUseList
419
420 #ifdef ASSERT
421 private:
422 volatile uint64_t _visited_for_critical_count;
423
424 public:
425 void set_visited_for_critical_count(uint64_t safepoint_id) {
426 assert(_visited_for_critical_count == 0, "Must be reset before set");
427 assert((safepoint_id & 0x1) == 1, "Must be odd");
428 _visited_for_critical_count = safepoint_id;
429 }
430 void reset_visited_for_critical_count(uint64_t safepoint_id) {
431 assert(_visited_for_critical_count == safepoint_id, "Was not visited");
432 _visited_for_critical_count = 0;
433 }
434 bool was_visited_for_critical_count(uint64_t safepoint_id) const {
435 return _visited_for_critical_count == safepoint_id;
436 }
437 #endif
438
439 public:
440 enum {
441 is_definitely_current_thread = true
442 };
443
444 // Constructor
445 Thread();
446 virtual ~Thread() = 0; // Thread is abstract.
447
448 // Manage Thread::current()
449 void initialize_thread_current();
450 static void clear_thread_current(); // TLS cleanup needed before threads terminate
451
452 protected:
453 // To be implemented by children.
454 virtual void run() = 0;
455 virtual void pre_run() = 0;
456 virtual void post_run() = 0; // Note: Thread must not be deleted prior to calling this!
457
458 #ifdef ASSERT
459 enum RunState {
460 PRE_CALL_RUN,
461 CALL_RUN,
462 PRE_RUN,
463 RUN,
464 POST_RUN
465 // POST_CALL_RUN - can't define this one as 'this' may be deleted when we want to set it
466 };
467 RunState _run_state; // for lifecycle checks
468 #endif
469
470
471 public:
472 // invokes <ChildThreadClass>::run(), with common preparations and cleanups.
473 void call_run();
474
475 // Testers
476 virtual bool is_VM_thread() const { return false; }
477 virtual bool is_Java_thread() const { return false; }
478 virtual bool is_Compiler_thread() const { return false; }
479 virtual bool is_Code_cache_sweeper_thread() const { return false; }
480 virtual bool is_hidden_from_external_view() const { return false; }
481 virtual bool is_jvmti_agent_thread() const { return false; }
482 // True iff the thread can perform GC operations at a safepoint.
483 // Generally will be true only of VM thread and parallel GC WorkGang
484 // threads.
485 virtual bool is_GC_task_thread() const { return false; }
486 virtual bool is_Watcher_thread() const { return false; }
487 virtual bool is_ConcurrentGC_thread() const { return false; }
488 virtual bool is_Named_thread() const { return false; }
489 virtual bool is_Worker_thread() const { return false; }
490
491 // Can this thread make Java upcalls
492 virtual bool can_call_java() const { return false; }
493
494 // Casts
495 virtual WorkerThread* as_Worker_thread() const { return NULL; }
496
497 virtual char* name() const { return (char*)"Unknown thread"; }
498
499 // Returns the current thread (ASSERTS if NULL)
500 static inline Thread* current();
501 // Returns the current thread, or NULL if not attached
502 static inline Thread* current_or_null();
503 // Returns the current thread, or NULL if not attached, and is
504 // safe for use from signal-handlers
505 static inline Thread* current_or_null_safe();
506
507 // Common thread operations
508 #ifdef ASSERT
509 static void check_for_dangling_thread_pointer(Thread *thread);
510 #endif
511 static void set_priority(Thread* thread, ThreadPriority priority);
512 static ThreadPriority get_priority(const Thread* const thread);
513 static void start(Thread* thread);
514 static void interrupt(Thread* thr);
515 static bool is_interrupted(Thread* thr, bool clear_interrupted);
516
517 void set_native_thread_name(const char *name) {
518 assert(Thread::current() == this, "set_native_thread_name can only be called on the current thread");
519 os::set_native_thread_name(name);
520 }
521
522 ObjectMonitor** omInUseList_addr() { return (ObjectMonitor **)&omInUseList; }
523 Monitor* SR_lock() const { return _SR_lock; }
524
525 bool has_async_exception() const { return (_suspend_flags & _has_async_exception) != 0; }
526
527 inline void set_suspend_flag(SuspendFlags f);
528 inline void clear_suspend_flag(SuspendFlags f);
529
530 inline void set_has_async_exception();
531 inline void clear_has_async_exception();
532
533 bool do_critical_native_unlock() const { return (_suspend_flags & _critical_native_unlock) != 0; }
534
535 inline void set_critical_native_unlock();
536 inline void clear_critical_native_unlock();
537
538 inline void set_trace_flag();
539 inline void clear_trace_flag();
540
541 // Support for Unhandled Oop detection
542 // Add the field for both, fastdebug and debug, builds to keep
543 // Thread's fields layout the same.
544 // Note: CHECK_UNHANDLED_OOPS is defined only for fastdebug build.
545 #ifdef CHECK_UNHANDLED_OOPS
546 private:
547 UnhandledOops* _unhandled_oops;
548 #elif defined(ASSERT)
549 private:
550 void* _unhandled_oops;
551 #endif
552 #ifdef CHECK_UNHANDLED_OOPS
553 public:
554 UnhandledOops* unhandled_oops() { return _unhandled_oops; }
555 // Mark oop safe for gc. It may be stack allocated but won't move.
556 void allow_unhandled_oop(oop *op) {
557 if (CheckUnhandledOops) unhandled_oops()->allow_unhandled_oop(op);
558 }
559 // Clear oops at safepoint so crashes point to unhandled oop violator
560 void clear_unhandled_oops() {
561 if (CheckUnhandledOops) unhandled_oops()->clear_unhandled_oops();
562 }
563 #endif // CHECK_UNHANDLED_OOPS
564
565 public:
566 #ifndef PRODUCT
567 bool skip_gcalot() { return _skip_gcalot; }
568 void set_skip_gcalot(bool v) { _skip_gcalot = v; }
569 #endif
570
571 // Installs a pending exception to be inserted later
572 static void send_async_exception(oop thread_oop, oop java_throwable);
573
574 // Resource area
575 ResourceArea* resource_area() const { return _resource_area; }
576 void set_resource_area(ResourceArea* area) { _resource_area = area; }
577
578 OSThread* osthread() const { return _osthread; }
579 void set_osthread(OSThread* thread) { _osthread = thread; }
580
581 // JNI handle support
582 JNIHandleBlock* active_handles() const { return _active_handles; }
583 void set_active_handles(JNIHandleBlock* block) { _active_handles = block; }
584 JNIHandleBlock* free_handle_block() const { return _free_handle_block; }
585 void set_free_handle_block(JNIHandleBlock* block) { _free_handle_block = block; }
586
587 // Internal handle support
588 HandleArea* handle_area() const { return _handle_area; }
589 void set_handle_area(HandleArea* area) { _handle_area = area; }
590
591 GrowableArray<Metadata*>* metadata_handles() const { return _metadata_handles; }
592 void set_metadata_handles(GrowableArray<Metadata*>* handles){ _metadata_handles = handles; }
593
594 // Thread-Local Allocation Buffer (TLAB) support
595 ThreadLocalAllocBuffer& tlab() { return _tlab; }
596 void initialize_tlab() {
597 if (UseTLAB) {
598 tlab().initialize();
599 }
600 }
601
602 jlong allocated_bytes() { return _allocated_bytes; }
603 void set_allocated_bytes(jlong value) { _allocated_bytes = value; }
604 void incr_allocated_bytes(jlong size) { _allocated_bytes += size; }
605 inline jlong cooked_allocated_bytes();
606
607 ThreadHeapSampler& heap_sampler() { return _heap_sampler; }
608
609 ThreadStatisticalInfo& statistical_info() { return _statistical_info; }
610
611 JFR_ONLY(DEFINE_THREAD_LOCAL_ACCESSOR_JFR;)
612
613 bool is_trace_suspend() { return (_suspend_flags & _trace_flag) != 0; }
614
615 // VM operation support
616 int vm_operation_ticket() { return ++_vm_operation_started_count; }
617 int vm_operation_completed_count() { return _vm_operation_completed_count; }
618 void increment_vm_operation_completed_count() { _vm_operation_completed_count++; }
619
620 // For tracking the heavyweight monitor the thread is pending on.
621 ObjectMonitor* current_pending_monitor() {
622 return _current_pending_monitor;
623 }
624 void set_current_pending_monitor(ObjectMonitor* monitor) {
625 _current_pending_monitor = monitor;
626 }
627 void set_current_pending_monitor_is_from_java(bool from_java) {
628 _current_pending_monitor_is_from_java = from_java;
629 }
630 bool current_pending_monitor_is_from_java() {
631 return _current_pending_monitor_is_from_java;
632 }
633
634 // For tracking the ObjectMonitor on which this thread called Object.wait()
635 ObjectMonitor* current_waiting_monitor() {
636 return _current_waiting_monitor;
637 }
638 void set_current_waiting_monitor(ObjectMonitor* monitor) {
639 _current_waiting_monitor = monitor;
640 }
641
642 // GC support
643 // Apply "f->do_oop" to all root oops in "this".
644 // Used by JavaThread::oops_do.
645 // Apply "cf->do_code_blob" (if !NULL) to all code blobs active in frames
646 virtual void oops_do(OopClosure* f, CodeBlobClosure* cf);
647
648 // Handles the parallel case for claim_threads_do.
649 private:
650 bool claim_par_threads_do(uintx claim_token);
651 public:
652 // Requires that "claim_token" is that of the current iteration.
653 // If "is_par" is false, sets the token of "this" to
654 // "claim_token", and returns "true". If "is_par" is true,
655 // uses an atomic instruction to set the current thread's token to
656 // "claim_token", if it is not already. Returns "true" iff the
657 // calling thread does the update, this indicates that the calling thread
658 // has claimed the thread in the current iteration.
659 bool claim_threads_do(bool is_par, uintx claim_token) {
660 if (!is_par) {
661 _threads_do_token = claim_token;
662 return true;
663 } else {
664 return claim_par_threads_do(claim_token);
665 }
666 }
667
668 uintx threads_do_token() const { return _threads_do_token; }
669
670 // jvmtiRedefineClasses support
671 void metadata_handles_do(void f(Metadata*));
672
673 // Used by fast lock support
674 virtual bool is_lock_owned(address adr) const;
675
676 // Check if address is in the stack of the thread (not just for locks).
677 // Warning: the method can only be used on the running thread
678 bool is_in_stack(address adr) const;
679 // Check if address is in the usable part of the stack (excludes protected
680 // guard pages)
681 bool is_in_usable_stack(address adr) const;
682
683 // Sets this thread as starting thread. Returns failure if thread
684 // creation fails due to lack of memory, too many threads etc.
685 bool set_as_starting_thread();
686
687 protected:
688 // OS data associated with the thread
689 OSThread* _osthread; // Platform-specific thread information
690
691 // Thread local resource area for temporary allocation within the VM
692 ResourceArea* _resource_area;
693
694 DEBUG_ONLY(ResourceMark* _current_resource_mark;)
695
696 // Thread local handle area for allocation of handles within the VM
697 HandleArea* _handle_area;
698 GrowableArray<Metadata*>* _metadata_handles;
699
700 // Support for stack overflow handling, get_thread, etc.
701 address _stack_base;
702 size_t _stack_size;
703 uintptr_t _self_raw_id; // used by get_thread (mutable)
704 int _lgrp_id;
705
706 volatile void** polling_page_addr() { return &_polling_page; }
707
708 public:
709 // Stack overflow support
710 address stack_base() const { assert(_stack_base != NULL,"Sanity check"); return _stack_base; }
711 void set_stack_base(address base) { _stack_base = base; }
712 size_t stack_size() const { return _stack_size; }
713 void set_stack_size(size_t size) { _stack_size = size; }
714 address stack_end() const { return stack_base() - stack_size(); }
715 void record_stack_base_and_size();
716 void register_thread_stack_with_NMT() NOT_NMT_RETURN;
717
718 bool on_local_stack(address adr) const {
719 // QQQ this has knowledge of direction, ought to be a stack method
720 return (_stack_base >= adr && adr >= stack_end());
721 }
722
723 uintptr_t self_raw_id() { return _self_raw_id; }
724 void set_self_raw_id(uintptr_t value) { _self_raw_id = value; }
725
726 int lgrp_id() const { return _lgrp_id; }
727 void set_lgrp_id(int value) { _lgrp_id = value; }
728
729 // Printing
730 void print_on(outputStream* st, bool print_extended_info) const;
731 virtual void print_on(outputStream* st) const { print_on(st, false); }
732 void print() const;
733 virtual void print_on_error(outputStream* st, char* buf, int buflen) const;
734 void print_value_on(outputStream* st) const;
735
736 // Debug-only code
737 #ifdef ASSERT
738 private:
739 // Deadlock detection support for Mutex locks. List of locks own by thread.
740 Monitor* _owned_locks;
741 // Mutex::set_owner_implementation is the only place where _owned_locks is modified,
742 // thus the friendship
743 friend class Mutex;
744 friend class Monitor;
745
746 public:
747 void print_owned_locks_on(outputStream* st) const;
748 void print_owned_locks() const { print_owned_locks_on(tty); }
749 Monitor* owned_locks() const { return _owned_locks; }
750 bool owns_locks() const { return owned_locks() != NULL; }
751 bool owns_locks_but_compiled_lock() const;
752
753 // Deadlock detection
754 ResourceMark* current_resource_mark() { return _current_resource_mark; }
755 void set_current_resource_mark(ResourceMark* rm) { _current_resource_mark = rm; }
756 #endif
757
758 void check_for_valid_safepoint_state(bool potential_vm_operation) PRODUCT_RETURN;
759
760 private:
761 volatile int _jvmti_env_iteration_count;
762
763 public:
764 void entering_jvmti_env_iteration() { ++_jvmti_env_iteration_count; }
765 void leaving_jvmti_env_iteration() { --_jvmti_env_iteration_count; }
766 bool is_inside_jvmti_env_iteration() { return _jvmti_env_iteration_count > 0; }
767
768 // Code generation
769 static ByteSize exception_file_offset() { return byte_offset_of(Thread, _exception_file); }
770 static ByteSize exception_line_offset() { return byte_offset_of(Thread, _exception_line); }
771 static ByteSize active_handles_offset() { return byte_offset_of(Thread, _active_handles); }
772
773 static ByteSize stack_base_offset() { return byte_offset_of(Thread, _stack_base); }
774 static ByteSize stack_size_offset() { return byte_offset_of(Thread, _stack_size); }
775
776 static ByteSize polling_page_offset() { return byte_offset_of(Thread, _polling_page); }
777
778 static ByteSize tlab_start_offset() { return byte_offset_of(Thread, _tlab) + ThreadLocalAllocBuffer::start_offset(); }
779 static ByteSize tlab_end_offset() { return byte_offset_of(Thread, _tlab) + ThreadLocalAllocBuffer::end_offset(); }
780 static ByteSize tlab_top_offset() { return byte_offset_of(Thread, _tlab) + ThreadLocalAllocBuffer::top_offset(); }
781 static ByteSize tlab_pf_top_offset() { return byte_offset_of(Thread, _tlab) + ThreadLocalAllocBuffer::pf_top_offset(); }
782
783 static ByteSize allocated_bytes_offset() { return byte_offset_of(Thread, _allocated_bytes); }
784
785 JFR_ONLY(DEFINE_THREAD_LOCAL_OFFSET_JFR;)
786
787 public:
788 volatile intptr_t _Stalled;
789 volatile int _TypeTag;
790 ParkEvent * _ParkEvent; // for synchronized()
791 ParkEvent * _SleepEvent; // for Thread.sleep
792 ParkEvent * _MuxEvent; // for low-level muxAcquire-muxRelease
793 int NativeSyncRecursion; // diagnostic
794
795 volatile int _OnTrap; // Resume-at IP delta
796 jint _hashStateW; // Marsaglia Shift-XOR thread-local RNG
797 jint _hashStateX; // thread-specific hashCode generator state
798 jint _hashStateY;
799 jint _hashStateZ;
800
801 // Low-level leaf-lock primitives used to implement synchronization
802 // and native monitor-mutex infrastructure.
803 // Not for general synchronization use.
804 static void SpinAcquire(volatile int * Lock, const char * Name);
805 static void SpinRelease(volatile int * Lock);
806 static void muxAcquire(volatile intptr_t * Lock, const char * Name);
807 static void muxAcquireW(volatile intptr_t * Lock, ParkEvent * ev);
808 static void muxRelease(volatile intptr_t * Lock);
809 };
810
811 // Inline implementation of Thread::current()
812 inline Thread* Thread::current() {
813 Thread* current = current_or_null();
814 assert(current != NULL, "Thread::current() called on detached thread");
815 return current;
816 }
817
818 inline Thread* Thread::current_or_null() {
819 #ifndef USE_LIBRARY_BASED_TLS_ONLY
820 return _thr_current;
821 #else
822 if (ThreadLocalStorage::is_initialized()) {
823 return ThreadLocalStorage::thread();
824 }
825 return NULL;
826 #endif
827 }
828
829 inline Thread* Thread::current_or_null_safe() {
830 if (ThreadLocalStorage::is_initialized()) {
831 return ThreadLocalStorage::thread();
832 }
833 return NULL;
834 }
835
836 class NonJavaThread: public Thread {
837 friend class VMStructs;
838
839 NonJavaThread* volatile _next;
840
841 class List;
842 static List _the_list;
843
844 void add_to_the_list();
845 void remove_from_the_list();
846
847 protected:
848 virtual void pre_run();
849 virtual void post_run();
850
851 public:
852 NonJavaThread();
853 ~NonJavaThread();
854
855 class Iterator;
856 };
857
858 // Provides iteration over the list of NonJavaThreads.
859 // List addition occurs in pre_run(), and removal occurs in post_run(),
860 // so that only live fully-initialized threads can be found in the list.
861 // Threads created after an iterator is constructed will not be visited
862 // by the iterator. The scope of an iterator is a critical section; there
863 // must be no safepoint checks in that scope.
864 class NonJavaThread::Iterator : public StackObj {
865 uint _protect_enter;
866 NonJavaThread* _current;
867
868 // Noncopyable.
869 Iterator(const Iterator&);
870 Iterator& operator=(const Iterator&);
871
872 public:
873 Iterator();
874 ~Iterator();
875
876 bool end() const { return _current == NULL; }
877 NonJavaThread* current() const { return _current; }
878 void step();
879 };
880
881 // Name support for threads. non-JavaThread subclasses with multiple
882 // uniquely named instances should derive from this.
883 class NamedThread: public NonJavaThread {
884 friend class VMStructs;
885 enum {
886 max_name_len = 64
887 };
888 private:
889 char* _name;
890 // log JavaThread being processed by oops_do
891 JavaThread* _processed_thread;
892 uint _gc_id; // The current GC id when a thread takes part in GC
893
894 public:
895 NamedThread();
896 ~NamedThread();
897 // May only be called once per thread.
898 void set_name(const char* format, ...) ATTRIBUTE_PRINTF(2, 3);
899 virtual bool is_Named_thread() const { return true; }
900 virtual char* name() const { return _name == NULL ? (char*)"Unknown Thread" : _name; }
901 JavaThread *processed_thread() { return _processed_thread; }
902 void set_processed_thread(JavaThread *thread) { _processed_thread = thread; }
903 virtual void print_on(outputStream* st) const;
904
905 void set_gc_id(uint gc_id) { _gc_id = gc_id; }
906 uint gc_id() { return _gc_id; }
907 };
908
909 // Worker threads are named and have an id of an assigned work.
910 class WorkerThread: public NamedThread {
911 private:
912 uint _id;
913 public:
914 WorkerThread() : _id(0) { }
915 virtual bool is_Worker_thread() const { return true; }
916
917 virtual WorkerThread* as_Worker_thread() const {
918 assert(is_Worker_thread(), "Dubious cast to WorkerThread*?");
919 return (WorkerThread*) this;
920 }
921
922 void set_id(uint work_id) { _id = work_id; }
923 uint id() const { return _id; }
924 };
925
926 // A single WatcherThread is used for simulating timer interrupts.
927 class WatcherThread: public NonJavaThread {
928 friend class VMStructs;
929 protected:
930 virtual void run();
931
932 private:
933 static WatcherThread* _watcher_thread;
934
935 static bool _startable;
936 // volatile due to at least one lock-free read
937 volatile static bool _should_terminate;
938 public:
939 enum SomeConstants {
940 delay_interval = 10 // interrupt delay in milliseconds
941 };
942
943 // Constructor
944 WatcherThread();
945
946 // No destruction allowed
947 ~WatcherThread() {
948 guarantee(false, "WatcherThread deletion must fix the race with VM termination");
949 }
950
951 // Tester
952 bool is_Watcher_thread() const { return true; }
953
954 // Printing
955 char* name() const { return (char*)"VM Periodic Task Thread"; }
956 void print_on(outputStream* st) const;
957 void unpark();
958
959 // Returns the single instance of WatcherThread
960 static WatcherThread* watcher_thread() { return _watcher_thread; }
961
962 // Create and start the single instance of WatcherThread, or stop it on shutdown
963 static void start();
964 static void stop();
965 // Only allow start once the VM is sufficiently initialized
966 // Otherwise the first task to enroll will trigger the start
967 static void make_startable();
968 private:
969 int sleep() const;
970 };
971
972
973 class CompilerThread;
974
975 typedef void (*ThreadFunction)(JavaThread*, TRAPS);
976
977 class JavaThread: public Thread {
978 friend class VMStructs;
979 friend class JVMCIVMStructs;
980 friend class WhiteBox;
981 private:
982 bool _on_thread_list; // Is set when this JavaThread is added to the Threads list
983 oop _threadObj; // The Java level thread object
984
985 #ifdef ASSERT
986 private:
987 int _java_call_counter;
988
989 public:
990 int java_call_counter() { return _java_call_counter; }
991 void inc_java_call_counter() { _java_call_counter++; }
992 void dec_java_call_counter() {
993 assert(_java_call_counter > 0, "Invalid nesting of JavaCallWrapper");
994 _java_call_counter--;
995 }
996 private: // restore original namespace restriction
997 #endif // ifdef ASSERT
998
999 #ifndef PRODUCT
1000 public:
1001 enum {
1002 jump_ring_buffer_size = 16
1003 };
1004 private: // restore original namespace restriction
1005 #endif
1006
1007 JavaFrameAnchor _anchor; // Encapsulation of current java frame and it state
1008
1009 ThreadFunction _entry_point;
1010
1011 JNIEnv _jni_environment;
1012
1013 // Deopt support
1014 DeoptResourceMark* _deopt_mark; // Holds special ResourceMark for deoptimization
1015
1016 intptr_t* _must_deopt_id; // id of frame that needs to be deopted once we
1017 // transition out of native
1018 CompiledMethod* _deopt_nmethod; // CompiledMethod that is currently being deoptimized
1019 vframeArray* _vframe_array_head; // Holds the heap of the active vframeArrays
1020 vframeArray* _vframe_array_last; // Holds last vFrameArray we popped
1021 // Because deoptimization is lazy we must save jvmti requests to set locals
1022 // in compiled frames until we deoptimize and we have an interpreter frame.
1023 // This holds the pointer to array (yeah like there might be more than one) of
1024 // description of compiled vframes that have locals that need to be updated.
1025 GrowableArray<jvmtiDeferredLocalVariableSet*>* _deferred_locals_updates;
1026
1027 // Handshake value for fixing 6243940. We need a place for the i2c
1028 // adapter to store the callee Method*. This value is NEVER live
1029 // across a gc point so it does NOT have to be gc'd
1030 // The handshake is open ended since we can't be certain that it will
1031 // be NULLed. This is because we rarely ever see the race and end up
1032 // in handle_wrong_method which is the backend of the handshake. See
1033 // code in i2c adapters and handle_wrong_method.
1034
1035 Method* _callee_target;
1036
1037 // Used to pass back results to the interpreter or generated code running Java code.
1038 oop _vm_result; // oop result is GC-preserved
1039 Metadata* _vm_result_2; // non-oop result
1040
1041 // See ReduceInitialCardMarks: this holds the precise space interval of
1042 // the most recent slow path allocation for which compiled code has
1043 // elided card-marks for performance along the fast-path.
1044 MemRegion _deferred_card_mark;
1045
1046 MonitorChunk* _monitor_chunks; // Contains the off stack monitors
1047 // allocated during deoptimization
1048 // and by JNI_MonitorEnter/Exit
1049
1050 // Async. requests support
1051 enum AsyncRequests {
1052 _no_async_condition = 0,
1053 _async_exception,
1054 _async_unsafe_access_error
1055 };
1056 AsyncRequests _special_runtime_exit_condition; // Enum indicating pending async. request
1057 oop _pending_async_exception;
1058
1059 // Safepoint support
1060 public: // Expose _thread_state for SafeFetchInt()
1061 volatile JavaThreadState _thread_state;
1062 private:
1063 ThreadSafepointState* _safepoint_state; // Holds information about a thread during a safepoint
1064 address _saved_exception_pc; // Saved pc of instruction where last implicit exception happened
1065
1066 // JavaThread termination support
1067 enum TerminatedTypes {
1068 _not_terminated = 0xDEAD - 2,
1069 _thread_exiting, // JavaThread::exit() has been called for this thread
1070 _thread_terminated, // JavaThread is removed from thread list
1071 _vm_exited // JavaThread is still executing native code, but VM is terminated
1072 // only VM_Exit can set _vm_exited
1073 };
1074
1075 // In general a JavaThread's _terminated field transitions as follows:
1076 //
1077 // _not_terminated => _thread_exiting => _thread_terminated
1078 //
1079 // _vm_exited is a special value to cover the case of a JavaThread
1080 // executing native code after the VM itself is terminated.
1081 volatile TerminatedTypes _terminated;
1082 // suspend/resume support
1083 volatile bool _suspend_equivalent; // Suspend equivalent condition
1084 jint _in_deopt_handler; // count of deoptimization
1085 // handlers thread is in
1086 volatile bool _doing_unsafe_access; // Thread may fault due to unsafe access
1087 bool _do_not_unlock_if_synchronized; // Do not unlock the receiver of a synchronized method (since it was
1088 // never locked) when throwing an exception. Used by interpreter only.
1089
1090 // JNI attach states:
1091 enum JNIAttachStates {
1092 _not_attaching_via_jni = 1, // thread is not attaching via JNI
1093 _attaching_via_jni, // thread is attaching via JNI
1094 _attached_via_jni // thread has attached via JNI
1095 };
1096
1097 // A regular JavaThread's _jni_attach_state is _not_attaching_via_jni.
1098 // A native thread that is attaching via JNI starts with a value
1099 // of _attaching_via_jni and transitions to _attached_via_jni.
1100 volatile JNIAttachStates _jni_attach_state;
1101
1102 public:
1103 // State of the stack guard pages for this thread.
1104 enum StackGuardState {
1105 stack_guard_unused, // not needed
1106 stack_guard_reserved_disabled,
1107 stack_guard_yellow_reserved_disabled,// disabled (temporarily) after stack overflow
1108 stack_guard_enabled // enabled
1109 };
1110
1111 private:
1112
1113 #if INCLUDE_JVMCI
1114 // The _pending_* fields below are used to communicate extra information
1115 // from an uncommon trap in JVMCI compiled code to the uncommon trap handler.
1116
1117 // Communicates the DeoptReason and DeoptAction of the uncommon trap
1118 int _pending_deoptimization;
1119
1120 // Specifies whether the uncommon trap is to bci 0 of a synchronized method
1121 // before the monitor has been acquired.
1122 bool _pending_monitorenter;
1123
1124 // Specifies if the DeoptReason for the last uncommon trap was Reason_transfer_to_interpreter
1125 bool _pending_transfer_to_interpreter;
1126
1127 // True if in a runtime call from compiled code that will deoptimize
1128 // and re-execute a failed heap allocation in the interpreter.
1129 bool _in_retryable_allocation;
1130
1131 // An id of a speculation that JVMCI compiled code can use to further describe and
1132 // uniquely identify the speculative optimization guarded by the uncommon trap
1133 jlong _pending_failed_speculation;
1134
1135 // These fields are mutually exclusive in terms of live ranges.
1136 union {
1137 // Communicates the pc at which the most recent implicit exception occurred
1138 // from the signal handler to a deoptimization stub.
1139 address _implicit_exception_pc;
1140
1141 // Communicates an alternative call target to an i2c stub from a JavaCall .
1142 address _alternate_call_target;
1143 } _jvmci;
1144
1145 // Support for high precision, thread sensitive counters in JVMCI compiled code.
1146 jlong* _jvmci_counters;
1147
1148 public:
1149 static jlong* _jvmci_old_thread_counters;
1150 static void collect_counters(jlong* array, int length);
1151
1152 bool resize_counters(int current_size, int new_size);
1153
1154 static bool resize_all_jvmci_counters(int new_size);
1155
1156 private:
1157 #endif // INCLUDE_JVMCI
1158
1159 StackGuardState _stack_guard_state;
1160
1161 // Precompute the limit of the stack as used in stack overflow checks.
1162 // We load it from here to simplify the stack overflow check in assembly.
1163 address _stack_overflow_limit;
1164 address _reserved_stack_activation;
1165
1166 // Compiler exception handling (NOTE: The _exception_oop is *NOT* the same as _pending_exception. It is
1167 // used to temp. parsing values into and out of the runtime system during exception handling for compiled
1168 // code)
1169 volatile oop _exception_oop; // Exception thrown in compiled code
1170 volatile address _exception_pc; // PC where exception happened
1171 volatile address _exception_handler_pc; // PC for handler of exception
1172 volatile int _is_method_handle_return; // true (== 1) if the current exception PC is a MethodHandle call site.
1173
1174 private:
1175 // support for JNI critical regions
1176 jint _jni_active_critical; // count of entries into JNI critical region
1177
1178 // Checked JNI: function name requires exception check
1179 char* _pending_jni_exception_check_fn;
1180
1181 // For deadlock detection.
1182 int _depth_first_number;
1183
1184 // JVMTI PopFrame support
1185 // This is set to popframe_pending to signal that top Java frame should be popped immediately
1186 int _popframe_condition;
1187
1188 // If reallocation of scalar replaced objects fails, we throw OOM
1189 // and during exception propagation, pop the top
1190 // _frames_to_pop_failed_realloc frames, the ones that reference
1191 // failed reallocations.
1192 int _frames_to_pop_failed_realloc;
1193
1194 #ifndef PRODUCT
1195 int _jmp_ring_index;
1196 struct {
1197 // We use intptr_t instead of address so debugger doesn't try and display strings
1198 intptr_t _target;
1199 intptr_t _instruction;
1200 const char* _file;
1201 int _line;
1202 } _jmp_ring[jump_ring_buffer_size];
1203 #endif // PRODUCT
1204
1205 friend class VMThread;
1206 friend class ThreadWaitTransition;
1207 friend class VM_Exit;
1208
1209 void initialize(); // Initialized the instance variables
1210
1211 public:
1212 // Constructor
1213 JavaThread(bool is_attaching_via_jni = false); // for main thread and JNI attached threads
1214 JavaThread(ThreadFunction entry_point, size_t stack_size = 0);
1215 ~JavaThread();
1216
1217 #ifdef ASSERT
1218 // verify this JavaThread hasn't be published in the Threads::list yet
1219 void verify_not_published();
1220 #endif
1221
1222 //JNI functiontable getter/setter for JVMTI jni function table interception API.
1223 void set_jni_functions(struct JNINativeInterface_* functionTable) {
1224 _jni_environment.functions = functionTable;
1225 }
1226 struct JNINativeInterface_* get_jni_functions() {
1227 return (struct JNINativeInterface_ *)_jni_environment.functions;
1228 }
1229
1230 // This function is called at thread creation to allow
1231 // platform specific thread variables to be initialized.
1232 void cache_global_variables();
1233
1234 // Executes Shutdown.shutdown()
1235 void invoke_shutdown_hooks();
1236
1237 // Cleanup on thread exit
1238 enum ExitType {
1239 normal_exit,
1240 jni_detach
1241 };
1242 void exit(bool destroy_vm, ExitType exit_type = normal_exit);
1243
1244 void cleanup_failed_attach_current_thread(bool is_daemon);
1245
1246 // Testers
1247 virtual bool is_Java_thread() const { return true; }
1248 virtual bool can_call_java() const { return true; }
1249
1250 // Thread oop. threadObj() can be NULL for initial JavaThread
1251 // (or for threads attached via JNI)
1252 oop threadObj() const { return _threadObj; }
1253 void set_threadObj(oop p) { _threadObj = p; }
1254
1255 ThreadPriority java_priority() const; // Read from threadObj()
1256
1257 // Prepare thread and add to priority queue. If a priority is
1258 // not specified, use the priority of the thread object. Threads_lock
1259 // must be held while this function is called.
1260 void prepare(jobject jni_thread, ThreadPriority prio=NoPriority);
1261
1262 void set_saved_exception_pc(address pc) { _saved_exception_pc = pc; }
1263 address saved_exception_pc() { return _saved_exception_pc; }
1264
1265
1266 ThreadFunction entry_point() const { return _entry_point; }
1267
1268 // Allocates a new Java level thread object for this thread. thread_name may be NULL.
1269 void allocate_threadObj(Handle thread_group, const char* thread_name, bool daemon, TRAPS);
1270
1271 // Last frame anchor routines
1272
1273 JavaFrameAnchor* frame_anchor(void) { return &_anchor; }
1274
1275 // last_Java_sp
1276 bool has_last_Java_frame() const { return _anchor.has_last_Java_frame(); }
1277 intptr_t* last_Java_sp() const { return _anchor.last_Java_sp(); }
1278
1279 // last_Java_pc
1280
1281 address last_Java_pc(void) { return _anchor.last_Java_pc(); }
1282
1283 // Safepoint support
1284 inline JavaThreadState thread_state() const;
1285 inline void set_thread_state(JavaThreadState s);
1286 inline void set_thread_state_fence(JavaThreadState s); // fence after setting thread state
1287 inline ThreadSafepointState* safepoint_state() const;
1288 inline void set_safepoint_state(ThreadSafepointState* state);
1289 inline bool is_at_poll_safepoint();
1290
1291 // JavaThread termination and lifecycle support:
1292 void smr_delete();
1293 bool on_thread_list() const { return _on_thread_list; }
1294 void set_on_thread_list() { _on_thread_list = true; }
1295
1296 // thread has called JavaThread::exit() or is terminated
1297 bool is_exiting() const;
1298 // thread is terminated (no longer on the threads list); we compare
1299 // against the two non-terminated values so that a freed JavaThread
1300 // will also be considered terminated.
1301 bool check_is_terminated(TerminatedTypes l_terminated) const {
1302 return l_terminated != _not_terminated && l_terminated != _thread_exiting;
1303 }
1304 bool is_terminated() const;
1305 void set_terminated(TerminatedTypes t);
1306 // special for Threads::remove() which is static:
1307 void set_terminated_value();
1308 void block_if_vm_exited();
1309
1310 bool doing_unsafe_access() { return _doing_unsafe_access; }
1311 void set_doing_unsafe_access(bool val) { _doing_unsafe_access = val; }
1312
1313 bool do_not_unlock_if_synchronized() { return _do_not_unlock_if_synchronized; }
1314 void set_do_not_unlock_if_synchronized(bool val) { _do_not_unlock_if_synchronized = val; }
1315
1316 inline void set_polling_page_release(void* poll_value);
1317 inline void set_polling_page(void* poll_value);
1318 inline volatile void* get_polling_page();
1319
1320 private:
1321 // Support for thread handshake operations
1322 HandshakeState _handshake;
1323 public:
1324 void set_handshake_operation(HandshakeOperation* op) {
1325 _handshake.set_operation(this, op);
1326 }
1327
1328 bool has_handshake() const {
1329 return _handshake.has_operation();
1330 }
1331
1332 void handshake_process_by_self() {
1333 _handshake.process_by_self(this);
1334 }
1335
1336 void handshake_process_by_vmthread() {
1337 _handshake.process_by_vmthread(this);
1338 }
1339
1340 // Suspend/resume support for JavaThread
1341 private:
1342 inline void set_ext_suspended();
1343 inline void clear_ext_suspended();
1344
1345 public:
1346 void java_suspend(); // higher-level suspension logic called by the public APIs
1347 void java_resume(); // higher-level resume logic called by the public APIs
1348 int java_suspend_self(); // low-level self-suspension mechanics
1349
1350 private:
1351 // mid-level wrapper around java_suspend_self to set up correct state and
1352 // check for a pending safepoint at the end
1353 void java_suspend_self_with_safepoint_check();
1354
1355 public:
1356 void check_and_wait_while_suspended() {
1357 assert(JavaThread::current() == this, "sanity check");
1358
1359 bool do_self_suspend;
1360 do {
1361 // were we externally suspended while we were waiting?
1362 do_self_suspend = handle_special_suspend_equivalent_condition();
1363 if (do_self_suspend) {
1364 // don't surprise the thread that suspended us by returning
1365 java_suspend_self();
1366 set_suspend_equivalent();
1367 }
1368 } while (do_self_suspend);
1369 }
1370 static void check_safepoint_and_suspend_for_native_trans(JavaThread *thread);
1371 // Check for async exception in addition to safepoint and suspend request.
1372 static void check_special_condition_for_native_trans(JavaThread *thread);
1373
1374 // Same as check_special_condition_for_native_trans but finishes the
1375 // transition into thread_in_Java mode so that it can potentially
1376 // block.
1377 static void check_special_condition_for_native_trans_and_transition(JavaThread *thread);
1378
1379 bool is_ext_suspend_completed(bool called_by_wait, int delay, uint32_t *bits);
1380 bool is_ext_suspend_completed_with_lock(uint32_t *bits) {
1381 MutexLocker ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1382 // Warning: is_ext_suspend_completed() may temporarily drop the
1383 // SR_lock to allow the thread to reach a stable thread state if
1384 // it is currently in a transient thread state.
1385 return is_ext_suspend_completed(false /* !called_by_wait */,
1386 SuspendRetryDelay, bits);
1387 }
1388
1389 // We cannot allow wait_for_ext_suspend_completion() to run forever or
1390 // we could hang. SuspendRetryCount and SuspendRetryDelay are normally
1391 // passed as the count and delay parameters. Experiments with specific
1392 // calls to wait_for_ext_suspend_completion() can be done by passing
1393 // other values in the code. Experiments with all calls can be done
1394 // via the appropriate -XX options.
1395 bool wait_for_ext_suspend_completion(int count, int delay, uint32_t *bits);
1396
1397 // test for suspend - most (all?) of these should go away
1398 bool is_thread_fully_suspended(bool wait_for_suspend, uint32_t *bits);
1399
1400 inline void set_external_suspend();
1401 inline void clear_external_suspend();
1402
1403 bool is_external_suspend() const {
1404 return (_suspend_flags & _external_suspend) != 0;
1405 }
1406 // Whenever a thread transitions from native to vm/java it must suspend
1407 // if external|deopt suspend is present.
1408 bool is_suspend_after_native() const {
1409 return (_suspend_flags & (_external_suspend JFR_ONLY(| _trace_flag))) != 0;
1410 }
1411
1412 // external suspend request is completed
1413 bool is_ext_suspended() const {
1414 return (_suspend_flags & _ext_suspended) != 0;
1415 }
1416
1417 bool is_external_suspend_with_lock() const {
1418 MutexLocker ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1419 return is_external_suspend();
1420 }
1421
1422 // Special method to handle a pending external suspend request
1423 // when a suspend equivalent condition lifts.
1424 bool handle_special_suspend_equivalent_condition() {
1425 assert(is_suspend_equivalent(),
1426 "should only be called in a suspend equivalence condition");
1427 MutexLocker ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1428 bool ret = is_external_suspend();
1429 if (!ret) {
1430 // not about to self-suspend so clear suspend equivalence
1431 clear_suspend_equivalent();
1432 }
1433 // implied else:
1434 // We have a pending external suspend request so we leave the
1435 // suspend_equivalent flag set until java_suspend_self() sets
1436 // the ext_suspended flag and clears the suspend_equivalent
1437 // flag. This insures that wait_for_ext_suspend_completion()
1438 // will return consistent values.
1439 return ret;
1440 }
1441
1442 // utility methods to see if we are doing some kind of suspension
1443 bool is_being_ext_suspended() const {
1444 MutexLocker ml(SR_lock(), Mutex::_no_safepoint_check_flag);
1445 return is_ext_suspended() || is_external_suspend();
1446 }
1447
1448 bool is_suspend_equivalent() const { return _suspend_equivalent; }
1449
1450 void set_suspend_equivalent() { _suspend_equivalent = true; }
1451 void clear_suspend_equivalent() { _suspend_equivalent = false; }
1452
1453 // Thread.stop support
1454 void send_thread_stop(oop throwable);
1455 AsyncRequests clear_special_runtime_exit_condition() {
1456 AsyncRequests x = _special_runtime_exit_condition;
1457 _special_runtime_exit_condition = _no_async_condition;
1458 return x;
1459 }
1460
1461 // Are any async conditions present?
1462 bool has_async_condition() { return (_special_runtime_exit_condition != _no_async_condition); }
1463
1464 void check_and_handle_async_exceptions(bool check_unsafe_error = true);
1465
1466 // these next two are also used for self-suspension and async exception support
1467 void handle_special_runtime_exit_condition(bool check_asyncs = true);
1468
1469 // Return true if JavaThread has an asynchronous condition or
1470 // if external suspension is requested.
1471 bool has_special_runtime_exit_condition() {
1472 // Because we don't use is_external_suspend_with_lock
1473 // it is possible that we won't see an asynchronous external suspend
1474 // request that has just gotten started, i.e., SR_lock grabbed but
1475 // _external_suspend field change either not made yet or not visible
1476 // yet. However, this is okay because the request is asynchronous and
1477 // we will see the new flag value the next time through. It's also
1478 // possible that the external suspend request is dropped after
1479 // we have checked is_external_suspend(), we will recheck its value
1480 // under SR_lock in java_suspend_self().
1481 return (_special_runtime_exit_condition != _no_async_condition) ||
1482 is_external_suspend() || is_trace_suspend();
1483 }
1484
1485 void set_pending_unsafe_access_error() { _special_runtime_exit_condition = _async_unsafe_access_error; }
1486
1487 inline void set_pending_async_exception(oop e);
1488
1489 // Fast-locking support
1490 bool is_lock_owned(address adr) const;
1491
1492 // Accessors for vframe array top
1493 // The linked list of vframe arrays are sorted on sp. This means when we
1494 // unpack the head must contain the vframe array to unpack.
1495 void set_vframe_array_head(vframeArray* value) { _vframe_array_head = value; }
1496 vframeArray* vframe_array_head() const { return _vframe_array_head; }
1497
1498 // Side structure for deferring update of java frame locals until deopt occurs
1499 GrowableArray<jvmtiDeferredLocalVariableSet*>* deferred_locals() const { return _deferred_locals_updates; }
1500 void set_deferred_locals(GrowableArray<jvmtiDeferredLocalVariableSet *>* vf) { _deferred_locals_updates = vf; }
1501
1502 // These only really exist to make debugging deopt problems simpler
1503
1504 void set_vframe_array_last(vframeArray* value) { _vframe_array_last = value; }
1505 vframeArray* vframe_array_last() const { return _vframe_array_last; }
1506
1507 // The special resourceMark used during deoptimization
1508
1509 void set_deopt_mark(DeoptResourceMark* value) { _deopt_mark = value; }
1510 DeoptResourceMark* deopt_mark(void) { return _deopt_mark; }
1511
1512 intptr_t* must_deopt_id() { return _must_deopt_id; }
1513 void set_must_deopt_id(intptr_t* id) { _must_deopt_id = id; }
1514 void clear_must_deopt_id() { _must_deopt_id = NULL; }
1515
1516 void set_deopt_compiled_method(CompiledMethod* nm) { _deopt_nmethod = nm; }
1517 CompiledMethod* deopt_compiled_method() { return _deopt_nmethod; }
1518
1519 Method* callee_target() const { return _callee_target; }
1520 void set_callee_target (Method* x) { _callee_target = x; }
1521
1522 // Oop results of vm runtime calls
1523 oop vm_result() const { return _vm_result; }
1524 void set_vm_result (oop x) { _vm_result = x; }
1525
1526 Metadata* vm_result_2() const { return _vm_result_2; }
1527 void set_vm_result_2 (Metadata* x) { _vm_result_2 = x; }
1528
1529 MemRegion deferred_card_mark() const { return _deferred_card_mark; }
1530 void set_deferred_card_mark(MemRegion mr) { _deferred_card_mark = mr; }
1531
1532 #if INCLUDE_JVMCI
1533 int pending_deoptimization() const { return _pending_deoptimization; }
1534 jlong pending_failed_speculation() const { return _pending_failed_speculation; }
1535 bool has_pending_monitorenter() const { return _pending_monitorenter; }
1536 void set_pending_monitorenter(bool b) { _pending_monitorenter = b; }
1537 void set_pending_deoptimization(int reason) { _pending_deoptimization = reason; }
1538 void set_pending_failed_speculation(jlong failed_speculation) { _pending_failed_speculation = failed_speculation; }
1539 void set_pending_transfer_to_interpreter(bool b) { _pending_transfer_to_interpreter = b; }
1540 void set_jvmci_alternate_call_target(address a) { assert(_jvmci._alternate_call_target == NULL, "must be"); _jvmci._alternate_call_target = a; }
1541 void set_jvmci_implicit_exception_pc(address a) { assert(_jvmci._implicit_exception_pc == NULL, "must be"); _jvmci._implicit_exception_pc = a; }
1542
1543 virtual bool in_retryable_allocation() const { return _in_retryable_allocation; }
1544 void set_in_retryable_allocation(bool b) { _in_retryable_allocation = b; }
1545 #endif // INCLUDE_JVMCI
1546
1547 // Exception handling for compiled methods
1548 oop exception_oop() const { return _exception_oop; }
1549 address exception_pc() const { return _exception_pc; }
1550 address exception_handler_pc() const { return _exception_handler_pc; }
1551 bool is_method_handle_return() const { return _is_method_handle_return == 1; }
1552
1553 void set_exception_oop(oop o) { (void)const_cast<oop&>(_exception_oop = o); }
1554 void set_exception_pc(address a) { _exception_pc = a; }
1555 void set_exception_handler_pc(address a) { _exception_handler_pc = a; }
1556 void set_is_method_handle_return(bool value) { _is_method_handle_return = value ? 1 : 0; }
1557
1558 void clear_exception_oop_and_pc() {
1559 set_exception_oop(NULL);
1560 set_exception_pc(NULL);
1561 }
1562
1563 // Stack overflow support
1564 //
1565 // (small addresses)
1566 //
1567 // -- <-- stack_end() ---
1568 // | |
1569 // | red pages |
1570 // | |
1571 // -- <-- stack_red_zone_base() |
1572 // | |
1573 // | guard
1574 // | yellow pages zone
1575 // | |
1576 // | |
1577 // -- <-- stack_yellow_zone_base() |
1578 // | |
1579 // | |
1580 // | reserved pages |
1581 // | |
1582 // -- <-- stack_reserved_zone_base() --- ---
1583 // /|\ shadow <-- stack_overflow_limit() (somewhere in here)
1584 // | zone
1585 // \|/ size
1586 // some untouched memory ---
1587 //
1588 //
1589 // --
1590 // |
1591 // | shadow zone
1592 // |
1593 // --
1594 // x frame n
1595 // --
1596 // x frame n-1
1597 // x
1598 // --
1599 // ...
1600 //
1601 // --
1602 // x frame 0
1603 // -- <-- stack_base()
1604 //
1605 // (large addresses)
1606 //
1607
1608 private:
1609 // These values are derived from flags StackRedPages, StackYellowPages,
1610 // StackReservedPages and StackShadowPages. The zone size is determined
1611 // ergonomically if page_size > 4K.
1612 static size_t _stack_red_zone_size;
1613 static size_t _stack_yellow_zone_size;
1614 static size_t _stack_reserved_zone_size;
1615 static size_t _stack_shadow_zone_size;
1616 public:
1617 inline size_t stack_available(address cur_sp);
1618
1619 static size_t stack_red_zone_size() {
1620 assert(_stack_red_zone_size > 0, "Don't call this before the field is initialized.");
1621 return _stack_red_zone_size;
1622 }
1623 static void set_stack_red_zone_size(size_t s) {
1624 assert(is_aligned(s, os::vm_page_size()),
1625 "We can not protect if the red zone size is not page aligned.");
1626 assert(_stack_red_zone_size == 0, "This should be called only once.");
1627 _stack_red_zone_size = s;
1628 }
1629 address stack_red_zone_base() {
1630 return (address)(stack_end() + stack_red_zone_size());
1631 }
1632 bool in_stack_red_zone(address a) {
1633 return a <= stack_red_zone_base() && a >= stack_end();
1634 }
1635
1636 static size_t stack_yellow_zone_size() {
1637 assert(_stack_yellow_zone_size > 0, "Don't call this before the field is initialized.");
1638 return _stack_yellow_zone_size;
1639 }
1640 static void set_stack_yellow_zone_size(size_t s) {
1641 assert(is_aligned(s, os::vm_page_size()),
1642 "We can not protect if the yellow zone size is not page aligned.");
1643 assert(_stack_yellow_zone_size == 0, "This should be called only once.");
1644 _stack_yellow_zone_size = s;
1645 }
1646
1647 static size_t stack_reserved_zone_size() {
1648 // _stack_reserved_zone_size may be 0. This indicates the feature is off.
1649 return _stack_reserved_zone_size;
1650 }
1651 static void set_stack_reserved_zone_size(size_t s) {
1652 assert(is_aligned(s, os::vm_page_size()),
1653 "We can not protect if the reserved zone size is not page aligned.");
1654 assert(_stack_reserved_zone_size == 0, "This should be called only once.");
1655 _stack_reserved_zone_size = s;
1656 }
1657 address stack_reserved_zone_base() {
1658 return (address)(stack_end() +
1659 (stack_red_zone_size() + stack_yellow_zone_size() + stack_reserved_zone_size()));
1660 }
1661 bool in_stack_reserved_zone(address a) {
1662 return (a <= stack_reserved_zone_base()) &&
1663 (a >= (address)((intptr_t)stack_reserved_zone_base() - stack_reserved_zone_size()));
1664 }
1665
1666 static size_t stack_yellow_reserved_zone_size() {
1667 return _stack_yellow_zone_size + _stack_reserved_zone_size;
1668 }
1669 bool in_stack_yellow_reserved_zone(address a) {
1670 return (a <= stack_reserved_zone_base()) && (a >= stack_red_zone_base());
1671 }
1672
1673 // Size of red + yellow + reserved zones.
1674 static size_t stack_guard_zone_size() {
1675 return stack_red_zone_size() + stack_yellow_reserved_zone_size();
1676 }
1677
1678 static size_t stack_shadow_zone_size() {
1679 assert(_stack_shadow_zone_size > 0, "Don't call this before the field is initialized.");
1680 return _stack_shadow_zone_size;
1681 }
1682 static void set_stack_shadow_zone_size(size_t s) {
1683 // The shadow area is not allocated or protected, so
1684 // it needs not be page aligned.
1685 // But the stack bang currently assumes that it is a
1686 // multiple of page size. This guarantees that the bang
1687 // loop touches all pages in the shadow zone.
1688 // This can be guaranteed differently, as well. E.g., if
1689 // the page size is a multiple of 4K, banging in 4K steps
1690 // suffices to touch all pages. (Some pages are banged
1691 // several times, though.)
1692 assert(is_aligned(s, os::vm_page_size()),
1693 "Stack bang assumes multiple of page size.");
1694 assert(_stack_shadow_zone_size == 0, "This should be called only once.");
1695 _stack_shadow_zone_size = s;
1696 }
1697
1698 void create_stack_guard_pages();
1699 void remove_stack_guard_pages();
1700
1701 void enable_stack_reserved_zone();
1702 void disable_stack_reserved_zone();
1703 void enable_stack_yellow_reserved_zone();
1704 void disable_stack_yellow_reserved_zone();
1705 void enable_stack_red_zone();
1706 void disable_stack_red_zone();
1707
1708 inline bool stack_guard_zone_unused();
1709 inline bool stack_yellow_reserved_zone_disabled();
1710 inline bool stack_reserved_zone_disabled();
1711 inline bool stack_guards_enabled();
1712
1713 address reserved_stack_activation() const { return _reserved_stack_activation; }
1714 void set_reserved_stack_activation(address addr) {
1715 assert(_reserved_stack_activation == stack_base()
1716 || _reserved_stack_activation == NULL
1717 || addr == stack_base(), "Must not be set twice");
1718 _reserved_stack_activation = addr;
1719 }
1720
1721 // Attempt to reguard the stack after a stack overflow may have occurred.
1722 // Returns true if (a) guard pages are not needed on this thread, (b) the
1723 // pages are already guarded, or (c) the pages were successfully reguarded.
1724 // Returns false if there is not enough stack space to reguard the pages, in
1725 // which case the caller should unwind a frame and try again. The argument
1726 // should be the caller's (approximate) sp.
1727 bool reguard_stack(address cur_sp);
1728 // Similar to above but see if current stackpoint is out of the guard area
1729 // and reguard if possible.
1730 bool reguard_stack(void);
1731
1732 address stack_overflow_limit() { return _stack_overflow_limit; }
1733 void set_stack_overflow_limit() {
1734 _stack_overflow_limit =
1735 stack_end() + MAX2(JavaThread::stack_guard_zone_size(), JavaThread::stack_shadow_zone_size());
1736 }
1737
1738 // Misc. accessors/mutators
1739 void set_do_not_unlock(void) { _do_not_unlock_if_synchronized = true; }
1740 void clr_do_not_unlock(void) { _do_not_unlock_if_synchronized = false; }
1741 bool do_not_unlock(void) { return _do_not_unlock_if_synchronized; }
1742
1743 #ifndef PRODUCT
1744 void record_jump(address target, address instr, const char* file, int line);
1745 #endif // PRODUCT
1746
1747 // For assembly stub generation
1748 static ByteSize threadObj_offset() { return byte_offset_of(JavaThread, _threadObj); }
1749 #ifndef PRODUCT
1750 static ByteSize jmp_ring_index_offset() { return byte_offset_of(JavaThread, _jmp_ring_index); }
1751 static ByteSize jmp_ring_offset() { return byte_offset_of(JavaThread, _jmp_ring); }
1752 #endif // PRODUCT
1753 static ByteSize jni_environment_offset() { return byte_offset_of(JavaThread, _jni_environment); }
1754 static ByteSize pending_jni_exception_check_fn_offset() {
1755 return byte_offset_of(JavaThread, _pending_jni_exception_check_fn);
1756 }
1757 static ByteSize last_Java_sp_offset() {
1758 return byte_offset_of(JavaThread, _anchor) + JavaFrameAnchor::last_Java_sp_offset();
1759 }
1760 static ByteSize last_Java_pc_offset() {
1761 return byte_offset_of(JavaThread, _anchor) + JavaFrameAnchor::last_Java_pc_offset();
1762 }
1763 static ByteSize frame_anchor_offset() {
1764 return byte_offset_of(JavaThread, _anchor);
1765 }
1766 static ByteSize callee_target_offset() { return byte_offset_of(JavaThread, _callee_target); }
1767 static ByteSize vm_result_offset() { return byte_offset_of(JavaThread, _vm_result); }
1768 static ByteSize vm_result_2_offset() { return byte_offset_of(JavaThread, _vm_result_2); }
1769 static ByteSize thread_state_offset() { return byte_offset_of(JavaThread, _thread_state); }
1770 static ByteSize saved_exception_pc_offset() { return byte_offset_of(JavaThread, _saved_exception_pc); }
1771 static ByteSize osthread_offset() { return byte_offset_of(JavaThread, _osthread); }
1772 #if INCLUDE_JVMCI
1773 static ByteSize pending_deoptimization_offset() { return byte_offset_of(JavaThread, _pending_deoptimization); }
1774 static ByteSize pending_monitorenter_offset() { return byte_offset_of(JavaThread, _pending_monitorenter); }
1775 static ByteSize pending_failed_speculation_offset() { return byte_offset_of(JavaThread, _pending_failed_speculation); }
1776 static ByteSize jvmci_alternate_call_target_offset() { return byte_offset_of(JavaThread, _jvmci._alternate_call_target); }
1777 static ByteSize jvmci_implicit_exception_pc_offset() { return byte_offset_of(JavaThread, _jvmci._implicit_exception_pc); }
1778 static ByteSize jvmci_counters_offset() { return byte_offset_of(JavaThread, _jvmci_counters); }
1779 #endif // INCLUDE_JVMCI
1780 static ByteSize exception_oop_offset() { return byte_offset_of(JavaThread, _exception_oop); }
1781 static ByteSize exception_pc_offset() { return byte_offset_of(JavaThread, _exception_pc); }
1782 static ByteSize exception_handler_pc_offset() { return byte_offset_of(JavaThread, _exception_handler_pc); }
1783 static ByteSize stack_overflow_limit_offset() { return byte_offset_of(JavaThread, _stack_overflow_limit); }
1784 static ByteSize is_method_handle_return_offset() { return byte_offset_of(JavaThread, _is_method_handle_return); }
1785 static ByteSize stack_guard_state_offset() { return byte_offset_of(JavaThread, _stack_guard_state); }
1786 static ByteSize reserved_stack_activation_offset() { return byte_offset_of(JavaThread, _reserved_stack_activation); }
1787 static ByteSize suspend_flags_offset() { return byte_offset_of(JavaThread, _suspend_flags); }
1788
1789 static ByteSize do_not_unlock_if_synchronized_offset() { return byte_offset_of(JavaThread, _do_not_unlock_if_synchronized); }
1790 static ByteSize should_post_on_exceptions_flag_offset() {
1791 return byte_offset_of(JavaThread, _should_post_on_exceptions_flag);
1792 }
1793 static ByteSize doing_unsafe_access_offset() { return byte_offset_of(JavaThread, _doing_unsafe_access); }
1794
1795 // Returns the jni environment for this thread
1796 JNIEnv* jni_environment() { return &_jni_environment; }
1797
1798 static JavaThread* thread_from_jni_environment(JNIEnv* env) {
1799 JavaThread *thread_from_jni_env = (JavaThread*)((intptr_t)env - in_bytes(jni_environment_offset()));
1800 // Only return NULL if thread is off the thread list; starting to
1801 // exit should not return NULL.
1802 if (thread_from_jni_env->is_terminated()) {
1803 thread_from_jni_env->block_if_vm_exited();
1804 return NULL;
1805 } else {
1806 return thread_from_jni_env;
1807 }
1808 }
1809
1810 // JNI critical regions. These can nest.
1811 bool in_critical() { return _jni_active_critical > 0; }
1812 bool in_last_critical() { return _jni_active_critical == 1; }
1813 inline void enter_critical();
1814 void exit_critical() {
1815 assert(Thread::current() == this, "this must be current thread");
1816 _jni_active_critical--;
1817 assert(_jni_active_critical >= 0, "JNI critical nesting problem?");
1818 }
1819
1820 // Checked JNI: is the programmer required to check for exceptions, if so specify
1821 // which function name. Returning to a Java frame should implicitly clear the
1822 // pending check, this is done for Native->Java transitions (i.e. user JNI code).
1823 // VM->Java transistions are not cleared, it is expected that JNI code enclosed
1824 // within ThreadToNativeFromVM makes proper exception checks (i.e. VM internal).
1825 bool is_pending_jni_exception_check() const { return _pending_jni_exception_check_fn != NULL; }
1826 void clear_pending_jni_exception_check() { _pending_jni_exception_check_fn = NULL; }
1827 const char* get_pending_jni_exception_check() const { return _pending_jni_exception_check_fn; }
1828 void set_pending_jni_exception_check(const char* fn_name) { _pending_jni_exception_check_fn = (char*) fn_name; }
1829
1830 // For deadlock detection
1831 int depth_first_number() { return _depth_first_number; }
1832 void set_depth_first_number(int dfn) { _depth_first_number = dfn; }
1833
1834 private:
1835 void set_monitor_chunks(MonitorChunk* monitor_chunks) { _monitor_chunks = monitor_chunks; }
1836
1837 public:
1838 MonitorChunk* monitor_chunks() const { return _monitor_chunks; }
1839 void add_monitor_chunk(MonitorChunk* chunk);
1840 void remove_monitor_chunk(MonitorChunk* chunk);
1841 bool in_deopt_handler() const { return _in_deopt_handler > 0; }
1842 void inc_in_deopt_handler() { _in_deopt_handler++; }
1843 void dec_in_deopt_handler() {
1844 assert(_in_deopt_handler > 0, "mismatched deopt nesting");
1845 if (_in_deopt_handler > 0) { // robustness
1846 _in_deopt_handler--;
1847 }
1848 }
1849
1850 private:
1851 void set_entry_point(ThreadFunction entry_point) { _entry_point = entry_point; }
1852
1853 public:
1854
1855 // Frame iteration; calls the function f for all frames on the stack
1856 void frames_do(void f(frame*, const RegisterMap*));
1857
1858 // Memory operations
1859 void oops_do(OopClosure* f, CodeBlobClosure* cf);
1860
1861 // Sweeper operations
1862 virtual void nmethods_do(CodeBlobClosure* cf);
1863
1864 // RedefineClasses Support
1865 void metadata_do(MetadataClosure* f);
1866
1867 // Debug method asserting thread states are correct during a handshake operation.
1868 DEBUG_ONLY(void verify_states_for_handshake();)
1869
1870 // Misc. operations
1871 char* name() const { return (char*)get_thread_name(); }
1872 void print_on(outputStream* st, bool print_extended_info) const;
1873 void print_on(outputStream* st) const { print_on(st, false); }
1874 void print() const;
1875 void print_value();
1876 void print_thread_state_on(outputStream*) const PRODUCT_RETURN;
1877 void print_thread_state() const PRODUCT_RETURN;
1878 void print_on_error(outputStream* st, char* buf, int buflen) const;
1879 void print_name_on_error(outputStream* st, char* buf, int buflen) const;
1880 void verify();
1881 const char* get_thread_name() const;
1882 protected:
1883 // factor out low-level mechanics for use in both normal and error cases
1884 virtual const char* get_thread_name_string(char* buf = NULL, int buflen = 0) const;
1885 public:
1886 const char* get_threadgroup_name() const;
1887 const char* get_parent_name() const;
1888
1889 // Accessing frames
1890 frame last_frame() {
1891 _anchor.make_walkable(this);
1892 return pd_last_frame();
1893 }
1894 javaVFrame* last_java_vframe(RegisterMap* reg_map);
1895
1896 // Returns method at 'depth' java or native frames down the stack
1897 // Used for security checks
1898 Klass* security_get_caller_class(int depth);
1899
1900 // Print stack trace in external format
1901 void print_stack_on(outputStream* st);
1902 void print_stack() { print_stack_on(tty); }
1903
1904 // Print stack traces in various internal formats
1905 void trace_stack() PRODUCT_RETURN;
1906 void trace_stack_from(vframe* start_vf) PRODUCT_RETURN;
1907 void trace_frames() PRODUCT_RETURN;
1908 void trace_oops() PRODUCT_RETURN;
1909
1910 // Print an annotated view of the stack frames
1911 void print_frame_layout(int depth = 0, bool validate_only = false) NOT_DEBUG_RETURN;
1912 void validate_frame_layout() {
1913 print_frame_layout(0, true);
1914 }
1915
1916 // Returns the number of stack frames on the stack
1917 int depth() const;
1918
1919 // Function for testing deoptimization
1920 void deoptimize();
1921 void make_zombies();
1922
1923 void deoptimized_wrt_marked_nmethods();
1924
1925 public:
1926 // Returns the running thread as a JavaThread
1927 static inline JavaThread* current();
1928
1929 // Returns the active Java thread. Do not use this if you know you are calling
1930 // from a JavaThread, as it's slower than JavaThread::current. If called from
1931 // the VMThread, it also returns the JavaThread that instigated the VMThread's
1932 // operation. You may not want that either.
1933 static JavaThread* active();
1934
1935 inline CompilerThread* as_CompilerThread();
1936
1937 protected:
1938 virtual void pre_run();
1939 virtual void run();
1940 void thread_main_inner();
1941 virtual void post_run();
1942
1943
1944 private:
1945 GrowableArray<oop>* _array_for_gc;
1946 public:
1947
1948 void register_array_for_gc(GrowableArray<oop>* array) { _array_for_gc = array; }
1949
1950 public:
1951 // Thread local information maintained by JVMTI.
1952 void set_jvmti_thread_state(JvmtiThreadState *value) { _jvmti_thread_state = value; }
1953 // A JvmtiThreadState is lazily allocated. This jvmti_thread_state()
1954 // getter is used to get this JavaThread's JvmtiThreadState if it has
1955 // one which means NULL can be returned. JvmtiThreadState::state_for()
1956 // is used to get the specified JavaThread's JvmtiThreadState if it has
1957 // one or it allocates a new JvmtiThreadState for the JavaThread and
1958 // returns it. JvmtiThreadState::state_for() will return NULL only if
1959 // the specified JavaThread is exiting.
1960 JvmtiThreadState *jvmti_thread_state() const { return _jvmti_thread_state; }
1961 static ByteSize jvmti_thread_state_offset() { return byte_offset_of(JavaThread, _jvmti_thread_state); }
1962
1963 // JVMTI PopFrame support
1964 // Setting and clearing popframe_condition
1965 // All of these enumerated values are bits. popframe_pending
1966 // indicates that a PopFrame() has been requested and not yet been
1967 // completed. popframe_processing indicates that that PopFrame() is in
1968 // the process of being completed. popframe_force_deopt_reexecution_bit
1969 // indicates that special handling is required when returning to a
1970 // deoptimized caller.
1971 enum PopCondition {
1972 popframe_inactive = 0x00,
1973 popframe_pending_bit = 0x01,
1974 popframe_processing_bit = 0x02,
1975 popframe_force_deopt_reexecution_bit = 0x04
1976 };
1977 PopCondition popframe_condition() { return (PopCondition) _popframe_condition; }
1978 void set_popframe_condition(PopCondition c) { _popframe_condition = c; }
1979 void set_popframe_condition_bit(PopCondition c) { _popframe_condition |= c; }
1980 void clear_popframe_condition() { _popframe_condition = popframe_inactive; }
1981 static ByteSize popframe_condition_offset() { return byte_offset_of(JavaThread, _popframe_condition); }
1982 bool has_pending_popframe() { return (popframe_condition() & popframe_pending_bit) != 0; }
1983 bool popframe_forcing_deopt_reexecution() { return (popframe_condition() & popframe_force_deopt_reexecution_bit) != 0; }
1984 void clear_popframe_forcing_deopt_reexecution() { _popframe_condition &= ~popframe_force_deopt_reexecution_bit; }
1985 #ifdef CC_INTERP
1986 bool pop_frame_pending(void) { return ((_popframe_condition & popframe_pending_bit) != 0); }
1987 void clr_pop_frame_pending(void) { _popframe_condition = popframe_inactive; }
1988 bool pop_frame_in_process(void) { return ((_popframe_condition & popframe_processing_bit) != 0); }
1989 void set_pop_frame_in_process(void) { _popframe_condition |= popframe_processing_bit; }
1990 void clr_pop_frame_in_process(void) { _popframe_condition &= ~popframe_processing_bit; }
1991 #endif
1992
1993 int frames_to_pop_failed_realloc() const { return _frames_to_pop_failed_realloc; }
1994 void set_frames_to_pop_failed_realloc(int nb) { _frames_to_pop_failed_realloc = nb; }
1995 void dec_frames_to_pop_failed_realloc() { _frames_to_pop_failed_realloc--; }
1996
1997 private:
1998 // Saved incoming arguments to popped frame.
1999 // Used only when popped interpreted frame returns to deoptimized frame.
2000 void* _popframe_preserved_args;
2001 int _popframe_preserved_args_size;
2002
2003 public:
2004 void popframe_preserve_args(ByteSize size_in_bytes, void* start);
2005 void* popframe_preserved_args();
2006 ByteSize popframe_preserved_args_size();
2007 WordSize popframe_preserved_args_size_in_words();
2008 void popframe_free_preserved_args();
2009
2010
2011 private:
2012 JvmtiThreadState *_jvmti_thread_state;
2013
2014 // Used by the interpreter in fullspeed mode for frame pop, method
2015 // entry, method exit and single stepping support. This field is
2016 // only set to non-zero by the VM_EnterInterpOnlyMode VM operation.
2017 // It can be set to zero asynchronously (i.e., without a VM operation
2018 // or a lock) so we have to be very careful.
2019 int _interp_only_mode;
2020
2021 public:
2022 // used by the interpreter for fullspeed debugging support (see above)
2023 static ByteSize interp_only_mode_offset() { return byte_offset_of(JavaThread, _interp_only_mode); }
2024 bool is_interp_only_mode() { return (_interp_only_mode != 0); }
2025 int get_interp_only_mode() { return _interp_only_mode; }
2026 void increment_interp_only_mode() { ++_interp_only_mode; }
2027 void decrement_interp_only_mode() { --_interp_only_mode; }
2028
2029 // support for cached flag that indicates whether exceptions need to be posted for this thread
2030 // if this is false, we can avoid deoptimizing when events are thrown
2031 // this gets set to reflect whether jvmtiExport::post_exception_throw would actually do anything
2032 private:
2033 int _should_post_on_exceptions_flag;
2034
2035 public:
2036 int should_post_on_exceptions_flag() { return _should_post_on_exceptions_flag; }
2037 void set_should_post_on_exceptions_flag(int val) { _should_post_on_exceptions_flag = val; }
2038
2039 private:
2040 ThreadStatistics *_thread_stat;
2041
2042 public:
2043 ThreadStatistics* get_thread_stat() const { return _thread_stat; }
2044
2045 // Return a blocker object for which this thread is blocked parking.
2046 oop current_park_blocker();
2047
2048 private:
2049 static size_t _stack_size_at_create;
2050
2051 public:
2052 static inline size_t stack_size_at_create(void) {
2053 return _stack_size_at_create;
2054 }
2055 static inline void set_stack_size_at_create(size_t value) {
2056 _stack_size_at_create = value;
2057 }
2058
2059 // Machine dependent stuff
2060 #include OS_CPU_HEADER(thread)
2061
2062 public:
2063 void set_blocked_on_compilation(bool value) {
2064 _blocked_on_compilation = value;
2065 }
2066
2067 bool blocked_on_compilation() {
2068 return _blocked_on_compilation;
2069 }
2070 protected:
2071 bool _blocked_on_compilation;
2072
2073
2074 // JSR166 per-thread parker
2075 private:
2076 Parker* _parker;
2077 public:
2078 Parker* parker() { return _parker; }
2079
2080 // Biased locking support
2081 private:
2082 GrowableArray<MonitorInfo*>* _cached_monitor_info;
2083 public:
2084 GrowableArray<MonitorInfo*>* cached_monitor_info() { return _cached_monitor_info; }
2085 void set_cached_monitor_info(GrowableArray<MonitorInfo*>* info) { _cached_monitor_info = info; }
2086
2087 // clearing/querying jni attach status
2088 bool is_attaching_via_jni() const { return _jni_attach_state == _attaching_via_jni; }
2089 bool has_attached_via_jni() const { return is_attaching_via_jni() || _jni_attach_state == _attached_via_jni; }
2090 inline void set_done_attaching_via_jni();
2091
2092 // Stack dump assistance:
2093 // Track the class we want to initialize but for which we have to wait
2094 // on its init_lock() because it is already being initialized.
2095 void set_class_to_be_initialized(InstanceKlass* k);
2096 InstanceKlass* class_to_be_initialized() const;
2097
2098 private:
2099 InstanceKlass* _class_to_be_initialized;
2100
2101 };
2102
2103 // Inline implementation of JavaThread::current
2104 inline JavaThread* JavaThread::current() {
2105 Thread* thread = Thread::current();
2106 assert(thread->is_Java_thread(), "just checking");
2107 return (JavaThread*)thread;
2108 }
2109
2110 inline CompilerThread* JavaThread::as_CompilerThread() {
2111 assert(is_Compiler_thread(), "just checking");
2112 return (CompilerThread*)this;
2113 }
2114
2115 // Dedicated thread to sweep the code cache
2116 class CodeCacheSweeperThread : public JavaThread {
2117 CompiledMethod* _scanned_compiled_method; // nmethod being scanned by the sweeper
2118 public:
2119 CodeCacheSweeperThread();
2120 // Track the nmethod currently being scanned by the sweeper
2121 void set_scanned_compiled_method(CompiledMethod* cm) {
2122 assert(_scanned_compiled_method == NULL || cm == NULL, "should reset to NULL before writing a new value");
2123 _scanned_compiled_method = cm;
2124 }
2125
2126 // Hide sweeper thread from external view.
2127 bool is_hidden_from_external_view() const { return true; }
2128
2129 bool is_Code_cache_sweeper_thread() const { return true; }
2130
2131 // Prevent GC from unloading _scanned_compiled_method
2132 void oops_do(OopClosure* f, CodeBlobClosure* cf);
2133 void nmethods_do(CodeBlobClosure* cf);
2134 };
2135
2136 // A thread used for Compilation.
2137 class CompilerThread : public JavaThread {
2138 friend class VMStructs;
2139 private:
2140 CompilerCounters* _counters;
2141
2142 ciEnv* _env;
2143 CompileLog* _log;
2144 CompileTask* volatile _task; // print_threads_compiling can read this concurrently.
2145 CompileQueue* _queue;
2146 BufferBlob* _buffer_blob;
2147
2148 AbstractCompiler* _compiler;
2149 TimeStamp _idle_time;
2150
2151 public:
2152
2153 static CompilerThread* current();
2154
2155 CompilerThread(CompileQueue* queue, CompilerCounters* counters);
2156 ~CompilerThread();
2157
2158 bool is_Compiler_thread() const { return true; }
2159
2160 virtual bool can_call_java() const;
2161
2162 // Hide native compiler threads from external view.
2163 bool is_hidden_from_external_view() const { return !can_call_java(); }
2164
2165 void set_compiler(AbstractCompiler* c) { _compiler = c; }
2166 AbstractCompiler* compiler() const { return _compiler; }
2167
2168 CompileQueue* queue() const { return _queue; }
2169 CompilerCounters* counters() const { return _counters; }
2170
2171 // Get/set the thread's compilation environment.
2172 ciEnv* env() { return _env; }
2173 void set_env(ciEnv* env) { _env = env; }
2174
2175 BufferBlob* get_buffer_blob() const { return _buffer_blob; }
2176 void set_buffer_blob(BufferBlob* b) { _buffer_blob = b; }
2177
2178 // Get/set the thread's logging information
2179 CompileLog* log() { return _log; }
2180 void init_log(CompileLog* log) {
2181 // Set once, for good.
2182 assert(_log == NULL, "set only once");
2183 _log = log;
2184 }
2185
2186 void start_idle_timer() { _idle_time.update(); }
2187 jlong idle_time_millis() {
2188 return TimeHelper::counter_to_millis(_idle_time.ticks_since_update());
2189 }
2190
2191 #ifndef PRODUCT
2192 private:
2193 IdealGraphPrinter *_ideal_graph_printer;
2194 public:
2195 IdealGraphPrinter *ideal_graph_printer() { return _ideal_graph_printer; }
2196 void set_ideal_graph_printer(IdealGraphPrinter *n) { _ideal_graph_printer = n; }
2197 #endif
2198
2199 // Get/set the thread's current task
2200 CompileTask* task() { return _task; }
2201 void set_task(CompileTask* task) { _task = task; }
2202 };
2203
2204 inline CompilerThread* CompilerThread::current() {
2205 return JavaThread::current()->as_CompilerThread();
2206 }
2207
2208 // The active thread queue. It also keeps track of the current used
2209 // thread priorities.
2210 class Threads: AllStatic {
2211 friend class VMStructs;
2212 private:
2213 static int _number_of_threads;
2214 static int _number_of_non_daemon_threads;
2215 static int _return_code;
2216 static uintx _thread_claim_token;
2217 #ifdef ASSERT
2218 static bool _vm_complete;
2219 #endif
2220
2221 static void initialize_java_lang_classes(JavaThread* main_thread, TRAPS);
2222 static void initialize_jsr292_core_classes(TRAPS);
2223
2224 public:
2225 // Thread management
2226 // force_daemon is a concession to JNI, where we may need to add a
2227 // thread to the thread list before allocating its thread object
2228 static void add(JavaThread* p, bool force_daemon = false);
2229 static void remove(JavaThread* p, bool is_daemon);
2230 static void non_java_threads_do(ThreadClosure* tc);
2231 static void java_threads_do(ThreadClosure* tc);
2232 static void java_threads_and_vm_thread_do(ThreadClosure* tc);
2233 static void threads_do(ThreadClosure* tc);
2234 static void possibly_parallel_threads_do(bool is_par, ThreadClosure* tc);
2235
2236 // Initializes the vm and creates the vm thread
2237 static jint create_vm(JavaVMInitArgs* args, bool* canTryAgain);
2238 static void convert_vm_init_libraries_to_agents();
2239 static void create_vm_init_libraries();
2240 static void create_vm_init_agents();
2241 static void shutdown_vm_agents();
2242 static bool destroy_vm();
2243 // Supported VM versions via JNI
2244 // Includes JNI_VERSION_1_1
2245 static jboolean is_supported_jni_version_including_1_1(jint version);
2246 // Does not include JNI_VERSION_1_1
2247 static jboolean is_supported_jni_version(jint version);
2248
2249 // The "thread claim token" provides a way for threads to be claimed
2250 // by parallel worker tasks.
2251 //
2252 // Each thread contains a "token" field. A task will claim the
2253 // thread only if its token is different from the global token,
2254 // which is updated by calling change_thread_claim_token(). When
2255 // a thread is claimed, it's token is set to the global token value
2256 // so other threads in the same iteration pass won't claim it.
2257 //
2258 // For this to work change_thread_claim_token() needs to be called
2259 // exactly once in sequential code before starting parallel tasks
2260 // that should claim threads.
2261 //
2262 // New threads get their token set to 0 and change_thread_claim_token()
2263 // never sets the global token to 0.
2264 static uintx thread_claim_token() { return _thread_claim_token; }
2265 static void change_thread_claim_token();
2266 static void assert_all_threads_claimed() NOT_DEBUG_RETURN;
2267
2268 // Apply "f->do_oop" to all root oops in all threads.
2269 // This version may only be called by sequential code.
2270 static void oops_do(OopClosure* f, CodeBlobClosure* cf);
2271 // This version may be called by sequential or parallel code.
2272 static void possibly_parallel_oops_do(bool is_par, OopClosure* f, CodeBlobClosure* cf);
2273
2274 // Apply "f->do_oop" to roots in all threads that
2275 // are part of compiled frames
2276 static void compiled_frame_oops_do(OopClosure* f, CodeBlobClosure* cf);
2277
2278 static void convert_hcode_pointers();
2279 static void restore_hcode_pointers();
2280
2281 // Sweeper
2282 static void nmethods_do(CodeBlobClosure* cf);
2283
2284 // RedefineClasses support
2285 static void metadata_do(MetadataClosure* f);
2286 static void metadata_handles_do(void f(Metadata*));
2287
2288 #ifdef ASSERT
2289 static bool is_vm_complete() { return _vm_complete; }
2290 #endif // ASSERT
2291
2292 // Verification
2293 static void verify();
2294 static void print_on(outputStream* st, bool print_stacks, bool internal_format, bool print_concurrent_locks, bool print_extended_info);
2295 static void print(bool print_stacks, bool internal_format) {
2296 // this function is only used by debug.cpp
2297 print_on(tty, print_stacks, internal_format, false /* no concurrent lock printed */, false /* simple format */);
2298 }
2299 static void print_on_error(outputStream* st, Thread* current, char* buf, int buflen);
2300 static void print_on_error(Thread* this_thread, outputStream* st, Thread* current, char* buf,
2301 int buflen, bool* found_current);
2302 static void print_threads_compiling(outputStream* st, char* buf, int buflen, bool short_form = false);
2303
2304 // Get Java threads that are waiting to enter a monitor.
2305 static GrowableArray<JavaThread*>* get_pending_threads(ThreadsList * t_list,
2306 int count, address monitor);
2307
2308 // Get owning Java thread from the monitor's owner field.
2309 static JavaThread *owning_thread_from_monitor_owner(ThreadsList * t_list,
2310 address owner);
2311
2312 // Number of threads on the active threads list
2313 static int number_of_threads() { return _number_of_threads; }
2314 // Number of non-daemon threads on the active threads list
2315 static int number_of_non_daemon_threads() { return _number_of_non_daemon_threads; }
2316
2317 // Deoptimizes all frames tied to marked nmethods
2318 static void deoptimized_wrt_marked_nmethods();
2319
2320 struct Test; // For private gtest access.
2321 };
2322
2323
2324 // Thread iterator
2325 class ThreadClosure: public StackObj {
2326 public:
2327 virtual void do_thread(Thread* thread) = 0;
2328 };
2329
2330 class SignalHandlerMark: public StackObj {
2331 private:
2332 Thread* _thread;
2333 public:
2334 SignalHandlerMark(Thread* t) {
2335 _thread = t;
2336 if (_thread) _thread->enter_signal_handler();
2337 }
2338 ~SignalHandlerMark() {
2339 if (_thread) _thread->leave_signal_handler();
2340 _thread = NULL;
2341 }
2342 };
2343
2344
2345 #endif // SHARE_RUNTIME_THREAD_HPP