annotate agent/src/os/win32/Reaper.hpp @ 3917:eca1193ca245

4965777: GC changes to support use of discovered field for pending references Summary: If and when the reference handler thread is able to use the discovered field to link reference objects in its pending list, so will GC. In that case, GC will scan through this field once a reference object has been placed on the pending list, but not scan that field before that stage, as the field is used by the concurrent GC thread to link discovered objects. When ReferenceHandleR thread does not use the discovered field for the purpose of linking the elements in the pending list, as would be the case in older JDKs, the JVM will fall back to the old behaviour of using the next field for that purpose. Reviewed-by: jcoomes, mchung, stefank
author ysr
date Wed, 07 Sep 2011 13:55:42 -0700
parents c18cbe5936b8
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
2 * Copyright (c) 2000, Oracle and/or its affiliates. All rights reserved.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load
duke
parents:
diff changeset
4 *
a61af66fc99e Initial load
duke
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load
duke
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load
duke
parents:
diff changeset
7 * published by the Free Software Foundation.
a61af66fc99e Initial load
duke
parents:
diff changeset
8 *
a61af66fc99e Initial load
duke
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load
duke
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load
duke
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load
duke
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load
duke
parents:
diff changeset
13 * accompanied this code).
a61af66fc99e Initial load
duke
parents:
diff changeset
14 *
a61af66fc99e Initial load
duke
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load
duke
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load
duke
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load
duke
parents:
diff changeset
18 *
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
21 * questions.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 #ifndef _REAPER_
a61af66fc99e Initial load
duke
parents:
diff changeset
26 #define _REAPER_
a61af66fc99e Initial load
duke
parents:
diff changeset
27
a61af66fc99e Initial load
duke
parents:
diff changeset
28 #include <vector>
a61af66fc99e Initial load
duke
parents:
diff changeset
29 #include <windows.h>
a61af66fc99e Initial load
duke
parents:
diff changeset
30
a61af66fc99e Initial load
duke
parents:
diff changeset
31 typedef void ReaperCB(void* userData);
a61af66fc99e Initial load
duke
parents:
diff changeset
32
a61af66fc99e Initial load
duke
parents:
diff changeset
33 /** A Reaper maintains a thread which waits for child processes to
a61af66fc99e Initial load
duke
parents:
diff changeset
34 terminate; upon termination it calls a user-specified ReaperCB to
a61af66fc99e Initial load
duke
parents:
diff changeset
35 clean up resources associated with those child processes. */
a61af66fc99e Initial load
duke
parents:
diff changeset
36
a61af66fc99e Initial load
duke
parents:
diff changeset
37 class Reaper {
a61af66fc99e Initial load
duke
parents:
diff changeset
38 private:
a61af66fc99e Initial load
duke
parents:
diff changeset
39 Reaper& operator=(const Reaper&);
a61af66fc99e Initial load
duke
parents:
diff changeset
40 Reaper(const Reaper&);
a61af66fc99e Initial load
duke
parents:
diff changeset
41
a61af66fc99e Initial load
duke
parents:
diff changeset
42 public:
a61af66fc99e Initial load
duke
parents:
diff changeset
43 Reaper(ReaperCB*);
a61af66fc99e Initial load
duke
parents:
diff changeset
44 ~Reaper();
a61af66fc99e Initial load
duke
parents:
diff changeset
45
a61af66fc99e Initial load
duke
parents:
diff changeset
46 // Start the reaper thread.
a61af66fc99e Initial load
duke
parents:
diff changeset
47 bool start();
a61af66fc99e Initial load
duke
parents:
diff changeset
48
a61af66fc99e Initial load
duke
parents:
diff changeset
49 // Stop the reaper thread. This is called automatically in the
a61af66fc99e Initial load
duke
parents:
diff changeset
50 // reaper's destructor. It is not thread safe and should be called
a61af66fc99e Initial load
duke
parents:
diff changeset
51 // by at most one thread at a time.
a61af66fc99e Initial load
duke
parents:
diff changeset
52 bool stop();
a61af66fc99e Initial load
duke
parents:
diff changeset
53
a61af66fc99e Initial load
duke
parents:
diff changeset
54 // Register a given child process with the reaper. This should be
a61af66fc99e Initial load
duke
parents:
diff changeset
55 // called by the application's main thread. When that process
a61af66fc99e Initial load
duke
parents:
diff changeset
56 // terminates, the cleanup callback will be called with the
a61af66fc99e Initial load
duke
parents:
diff changeset
57 // specified userData in the context of the reaper thread. Callbacks
a61af66fc99e Initial load
duke
parents:
diff changeset
58 // are guaranteed to be called serially, so they can safely refer to
a61af66fc99e Initial load
duke
parents:
diff changeset
59 // static data as well as the given user data.
a61af66fc99e Initial load
duke
parents:
diff changeset
60 void registerProcess(HANDLE processHandle, void* userData);
a61af66fc99e Initial load
duke
parents:
diff changeset
61
a61af66fc99e Initial load
duke
parents:
diff changeset
62 private:
a61af66fc99e Initial load
duke
parents:
diff changeset
63 // For thread safety of register()
a61af66fc99e Initial load
duke
parents:
diff changeset
64 CRITICAL_SECTION crit;
a61af66fc99e Initial load
duke
parents:
diff changeset
65
a61af66fc99e Initial load
duke
parents:
diff changeset
66 ReaperCB* cb;
a61af66fc99e Initial load
duke
parents:
diff changeset
67
a61af66fc99e Initial load
duke
parents:
diff changeset
68 // State variables
a61af66fc99e Initial load
duke
parents:
diff changeset
69 volatile bool active;
a61af66fc99e Initial load
duke
parents:
diff changeset
70 volatile bool shouldShutDown;
a61af66fc99e Initial load
duke
parents:
diff changeset
71
a61af66fc99e Initial load
duke
parents:
diff changeset
72 struct ProcessInfo {
a61af66fc99e Initial load
duke
parents:
diff changeset
73 HANDLE handle;
a61af66fc99e Initial load
duke
parents:
diff changeset
74 void* userData;
a61af66fc99e Initial load
duke
parents:
diff changeset
75 };
a61af66fc99e Initial load
duke
parents:
diff changeset
76
a61af66fc99e Initial load
duke
parents:
diff changeset
77 // Bookkeeping
a61af66fc99e Initial load
duke
parents:
diff changeset
78 std::vector<ProcessInfo> procInfo;
a61af66fc99e Initial load
duke
parents:
diff changeset
79
a61af66fc99e Initial load
duke
parents:
diff changeset
80 // Synchronization between application thread and reaper thread
a61af66fc99e Initial load
duke
parents:
diff changeset
81 HANDLE event;
a61af66fc99e Initial load
duke
parents:
diff changeset
82
a61af66fc99e Initial load
duke
parents:
diff changeset
83 // Entry point for reaper thread
a61af66fc99e Initial load
duke
parents:
diff changeset
84 void reaperThread();
a61af66fc99e Initial load
duke
parents:
diff changeset
85
a61af66fc99e Initial load
duke
parents:
diff changeset
86 // Static function which is actual thread entry point
a61af66fc99e Initial load
duke
parents:
diff changeset
87 static DWORD WINAPI reaperThreadEntry(LPVOID data);
a61af66fc99e Initial load
duke
parents:
diff changeset
88 };
a61af66fc99e Initial load
duke
parents:
diff changeset
89
a61af66fc99e Initial load
duke
parents:
diff changeset
90 #endif // #defined _REAPER_