Mercurial > hg > truffle
annotate agent/src/share/classes/sun/jvm/hotspot/debugger/cdbg/ProcessControl.java @ 6763:fac3dd92ebaf
7195372: Wrong copyright in new files
Summary: Fixed copyrights
Reviewed-by: dholmes
Contributed-by: Bill Pittore <bill.pittore@oracle.com>
author | bpittore |
---|---|
date | Wed, 19 Sep 2012 17:22:49 -0400 |
parents | c18cbe5936b8 |
children |
rev | line source |
---|---|
0 | 1 /* |
1552
c18cbe5936b8
6941466: Oracle rebranding changes for Hotspot repositories
trims
parents:
0
diff
changeset
|
2 * Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved. |
0 | 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 * | |
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 | 22 * |
23 */ | |
24 | |
25 package sun.jvm.hotspot.debugger.cdbg; | |
26 | |
27 import sun.jvm.hotspot.debugger.*; | |
28 | |
29 /** <P> A highly experimental interface for process control and debug | |
30 events. May not be sufficiently portable; for this reason it has | |
31 been factored out from the CDebugger interface and support for it | |
32 is optional. </P> | |
33 | |
34 <P> The ProcessControl interface defines a process control and | |
35 event model for debugging. When a process is attached to by the | |
36 base Debugger, all threads in the target process are suspended. | |
37 The ProcessControl interface allows resumption and re-suspension | |
38 of the threads in the target process, setting of breakpoints, and | |
39 reception of debugging events (breakpoint hit, signal received, | |
40 etc.). </P> | |
41 | |
42 <P> Debugging events are generated one at a time by the target | |
43 process. They must be queued up by the underlying debugging | |
44 mechanism so that an attempt to send a second debugging event | |
45 blocks until the first has been serviced with a call to | |
46 debugEventResume. </P> */ | |
47 | |
48 public interface ProcessControl { | |
49 /** Suspends all threads in the target process. A process is already | |
50 suspended when attached to by {@link | |
51 sun.jvm.hotspot.debugger.Debugger.attach(int)}. The application | |
52 should check for the presence of a debug event via | |
53 debugEventPoll() upon re-suspending the target process (if one | |
54 is not yet known to be present.) | |
55 | |
56 @throw DebuggerException if the process is already suspended or | |
57 if the suspension failed for some other reason. */ | |
58 public void suspend() throws DebuggerException; | |
59 | |
60 /** Resumes all threads in the target process. | |
61 | |
62 @throw DebuggerException if the process is not suspended or if | |
63 the resumption failed for some other reason. */ | |
64 public void resume() throws DebuggerException; | |
65 | |
66 /** Indicates whether the target process is suspended. */ | |
67 public boolean isSuspended() throws DebuggerException; | |
68 | |
69 /** Sets a breakpoint at the given address. The target process must | |
70 be suspended in order to set a breakpoint. | |
71 | |
72 @throw DebuggerException if the breakpoint could not be set for | |
73 some reason, including that a breakpoint is already set at that | |
74 address or that the underlying debugging mechanism does not | |
75 support that many breakpoints. */ | |
76 public void setBreakpoint(Address addr) | |
77 throws UnmappedAddressException, DebuggerException; | |
78 | |
79 /** Clears a breakpoint at the given address. The target process | |
80 must be suspended in order to clear a breakpoint. | |
81 | |
82 @throw DebuggerException if the breakpoint could not be cleared | |
83 for some reason, including that there was no breakpoint at that | |
84 address. */ | |
85 public void clearBreakpoint(Address addr) throws DebuggerException; | |
86 | |
87 /** Indicates whether a breakpoint is set at the given address. */ | |
88 public boolean isBreakpointSet(Address addr) throws DebuggerException; | |
89 | |
90 /** Polls for the presence of a debug event. Does not wait for one | |
91 to be generated; returns null if none was pending. The target | |
92 process does not need to be suspended. Returns the same | |
93 DebugEvent object until the debug event is handled via | |
94 debugEventContinue. Typically the application will suspend the | |
95 target process upon reception of a debug event but before | |
96 handling it via a call to debugEventContinue. This ensures that | |
97 the state of the thread which generated the debug event is | |
98 precisely what it was when the event was generated. | |
99 | |
100 @return The pending debug event, or null if none pending. */ | |
101 public DebugEvent debugEventPoll() throws DebuggerException; | |
102 | |
103 /** Informs the target process to resume past this debug event. The | |
104 target process does not need to be suspended. Breakpoint debug | |
105 events must be handled transparently by the implementation to | |
106 re-execute the instruction and replace the breakpoint. (Ideally | |
107 they should be replaced in such a way that there is no race | |
108 condition between the re-execution and the re-insertion of the | |
109 breakpoint.) All other kinds of exceptions or signals are passed | |
110 on to the target process. | |
111 | |
112 @throw DebuggerException if no debug event is pending. */ | |
113 public void debugEventContinue() | |
114 throws DebuggerException; | |
115 } |