0
|
1 /*
|
|
2 * Copyright 1997-2005 Sun Microsystems, Inc. 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
|
|
20 * CA 95054 USA or visit www.sun.com if you need additional information or
|
|
21 * have any questions.
|
|
22 *
|
|
23 */
|
|
24
|
|
25 // The OSThread class holds OS-specific thread information. It is equivalent
|
|
26 // to the sys_thread_t structure of the classic JVM implementation.
|
|
27
|
|
28 // The thread states represented by the ThreadState values are platform-specific
|
|
29 // and are likely to be only approximate, because most OSes don't give you access
|
|
30 // to precise thread state information.
|
|
31
|
|
32 // Note: the ThreadState is legacy code and is not correctly implemented.
|
|
33 // Uses of ThreadState need to be replaced by the state in the JavaThread.
|
|
34
|
|
35 enum ThreadState {
|
|
36 ALLOCATED, // Memory has been allocated but not initialized
|
|
37 INITIALIZED, // The thread has been initialized but yet started
|
|
38 RUNNABLE, // Has been started and is runnable, but not necessarily running
|
|
39 MONITOR_WAIT, // Waiting on a contended monitor lock
|
|
40 CONDVAR_WAIT, // Waiting on a condition variable
|
|
41 OBJECT_WAIT, // Waiting on an Object.wait() call
|
|
42 BREAKPOINTED, // Suspended at breakpoint
|
|
43 SLEEPING, // Thread.sleep()
|
|
44 ZOMBIE // All done, but not reclaimed yet
|
|
45 };
|
|
46
|
|
47 // I'd make OSThread a ValueObj embedded in Thread to avoid an indirection, but
|
|
48 // the assembler test in java.cpp expects that it can install the OSThread of
|
|
49 // the main thread into its own Thread at will.
|
|
50
|
|
51
|
|
52 class OSThread: public CHeapObj {
|
|
53 friend class VMStructs;
|
|
54 private:
|
|
55 //void* _start_proc; // Thread start routine
|
|
56 OSThreadStartFunc _start_proc; // Thread start routine
|
|
57 void* _start_parm; // Thread start routine parameter
|
|
58 volatile ThreadState _state; // Thread state *hint*
|
|
59 jint _interrupted; // Thread.isInterrupted state
|
|
60
|
|
61 // Note: _interrupted must be jint, so that Java intrinsics can access it.
|
|
62 // The value stored there must be either 0 or 1. It must be possible
|
|
63 // for Java to emulate Thread.currentThread().isInterrupted() by performing
|
|
64 // the double indirection Thread::current()->_osthread->_interrupted.
|
|
65
|
|
66 // Methods
|
|
67 public:
|
|
68 void set_state(ThreadState state) { _state = state; }
|
|
69 ThreadState get_state() { return _state; }
|
|
70
|
|
71 // Constructor
|
|
72 OSThread(OSThreadStartFunc start_proc, void* start_parm);
|
|
73
|
|
74 // Destructor
|
|
75 ~OSThread();
|
|
76
|
|
77 // Accessors
|
|
78 OSThreadStartFunc start_proc() const { return _start_proc; }
|
|
79 void set_start_proc(OSThreadStartFunc start_proc) { _start_proc = start_proc; }
|
|
80 void* start_parm() const { return _start_parm; }
|
|
81 void set_start_parm(void* start_parm) { _start_parm = start_parm; }
|
|
82
|
|
83 bool interrupted() const { return _interrupted != 0; }
|
|
84 void set_interrupted(bool z) { _interrupted = z ? 1 : 0; }
|
|
85
|
|
86 // Printing
|
|
87 void print_on(outputStream* st) const;
|
|
88 void print() const { print_on(tty); }
|
|
89
|
|
90 // For java intrinsics:
|
|
91 static ByteSize interrupted_offset() { return byte_offset_of(OSThread, _interrupted); }
|
|
92
|
|
93 // Platform dependent stuff
|
|
94 #include "incls/_osThread_pd.hpp.incl"
|
|
95 };
|
|
96
|
|
97
|
|
98 // Utility class for use with condition variables:
|
|
99 class OSThreadWaitState : public StackObj {
|
|
100 OSThread* _osthread;
|
|
101 ThreadState _old_state;
|
|
102 public:
|
|
103 OSThreadWaitState(OSThread* osthread, bool is_object_wait) {
|
|
104 _osthread = osthread;
|
|
105 _old_state = osthread->get_state();
|
|
106 if (is_object_wait) {
|
|
107 osthread->set_state(OBJECT_WAIT);
|
|
108 } else {
|
|
109 osthread->set_state(CONDVAR_WAIT);
|
|
110 }
|
|
111 }
|
|
112 ~OSThreadWaitState() {
|
|
113 _osthread->set_state(_old_state);
|
|
114 }
|
|
115 };
|
|
116
|
|
117
|
|
118 // Utility class for use with contended monitors:
|
|
119 class OSThreadContendState : public StackObj {
|
|
120 OSThread* _osthread;
|
|
121 ThreadState _old_state;
|
|
122 public:
|
|
123 OSThreadContendState(OSThread* osthread) {
|
|
124 _osthread = osthread;
|
|
125 _old_state = osthread->get_state();
|
|
126 osthread->set_state(MONITOR_WAIT);
|
|
127 }
|
|
128 ~OSThreadContendState() {
|
|
129 _osthread->set_state(_old_state);
|
|
130 }
|
|
131 };
|