• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2013 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef ART_RUNTIME_THREAD_STATE_H_
18 #define ART_RUNTIME_THREAD_STATE_H_
19 
20 #include <iosfwd>
21 
22 namespace art {
23 
24 // State stored in our C++ class Thread.
25 // When we refer to "a suspended state", or when function names mention "ToSuspended" or
26 // "FromSuspended", we mean any state other than kRunnable, i.e. any state in which the thread is
27 // guaranteed not to access the Java heap. The kSuspended state is merely one of these.
28 enum class ThreadState : uint8_t {
29   // `kRunnable` was previously 67 but it is now set to 0 so that we do not need to extract
30   // flags from the thread's `state_and_flags` to check for any flag being set while Runnable.
31   // Note: All atomic accesses for a location should use the same data size,
32   // so the incorrect old approach of reading just 16 bits has been rewritten.
33 
34   //                                   Java
35   //                                   Thread.State   JDWP state
36   kTerminated = 66,                 // TERMINATED     TS_ZOMBIE    Thread.run has returned, but Thread* still around
37   kRunnable = 0,                    // RUNNABLE       TS_RUNNING   runnable
38   kObsoleteRunnable = 67,           // ---            ---          obsolete value
39   kTimedWaiting = 68,               // TIMED_WAITING  TS_WAIT      in Object.wait() with a timeout
40   kSleeping,                        // TIMED_WAITING  TS_SLEEPING  in Thread.sleep()
41   kBlocked,                         // BLOCKED        TS_MONITOR   blocked on a monitor
42   kWaiting,                         // WAITING        TS_WAIT      in Object.wait()
43   kWaitingForLockInflation,         // WAITING        TS_WAIT      blocked inflating a thin-lock
44   kWaitingForTaskProcessor,         // WAITING        TS_WAIT      blocked waiting for taskProcessor
45   kWaitingForGcToComplete,          // WAITING        TS_WAIT      blocked waiting for GC
46   kWaitingForCheckPointsToRun,      // WAITING        TS_WAIT      GC waiting for checkpoints to run
47   kWaitingPerformingGc,             // WAITING        TS_WAIT      performing GC
48   kWaitingForDebuggerSend,          // WAITING        TS_WAIT      blocked waiting for events to be sent
49   kWaitingForDebuggerToAttach,      // WAITING        TS_WAIT      blocked waiting for debugger to attach
50   kWaitingInMainDebuggerLoop,       // WAITING        TS_WAIT      blocking/reading/processing debugger events
51   kWaitingForDebuggerSuspension,    // WAITING        TS_WAIT      waiting for debugger suspend all
52   kWaitingForJniOnLoad,             // WAITING        TS_WAIT      waiting for execution of dlopen and JNI on load code
53   kWaitingForSignalCatcherOutput,   // WAITING        TS_WAIT      waiting for signal catcher IO to complete
54   kWaitingInMainSignalCatcherLoop,  // WAITING        TS_WAIT      blocking/reading/processing signals
55   kWaitingForDeoptimization,        // WAITING        TS_WAIT      waiting for deoptimization suspend all
56   kWaitingForMethodTracingStart,    // WAITING        TS_WAIT      waiting for method tracing to start
57   kWaitingForVisitObjects,          // WAITING        TS_WAIT      waiting for visiting objects
58   kWaitingForGetObjectsAllocated,   // WAITING        TS_WAIT      waiting for getting the number of allocated objects
59   kWaitingWeakGcRootRead,           // WAITING        TS_WAIT      waiting on the GC to read a weak root
60   kWaitingForGcThreadFlip,          // WAITING        TS_WAIT      waiting on the GC thread flip (CC collector) to finish
61   kNativeForAbort,                  // WAITING        TS_WAIT      checking other threads are not run on abort.
62   kStarting,                        // NEW            TS_WAIT      native thread started, not yet ready to run managed code
63   kNative,                          // RUNNABLE       TS_RUNNING   running in a JNI native method
64   kSuspended,                       // RUNNABLE       TS_RUNNING   suspended by GC or debugger
65 };
66 std::ostream& operator<<(std::ostream& os, ThreadState rhs);
67 
68 }  // namespace art
69 
70 #endif  // ART_RUNTIME_THREAD_STATE_H_
71