blob: 776242ffe048d55ad2a723d57cf0f93df869701a (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
|
/*
*(c) Copyright QNX Software Systems Ltd. 2002.
* All Rights Reserved.
*
*/
package org.eclipse.cdt.debug.core.cdi.model;
import org.eclipse.cdt.debug.core.cdi.CDIException;
import org.eclipse.cdt.debug.core.cdi.ICDILocation;
import org.eclipse.cdt.debug.core.cdi.ICDISession;
/**
*
* Represents a debuggable process. This is a root object of the CDI
* model.
*
* @since Jul 8, 2002
*/
public interface ICDITarget extends ICDIObject {
/**
* Returns the debug session this target is contained in.
*
* @return the debug session this target is contained in
*/
ICDISession getSession();
/**
* Gets the target process.
*
* @return the output stream connected to the normal input of the
* target process.
*/
Process getProcess();
/**
* Returns the threads contained in this target.
* An empty collection is returned if this target contains no
* threads.
*
* @return a collection of threads
* @throws CDIException if this method fails. Reasons include:
*/
ICDIThread[] getThreads() throws CDIException;
/**
* Set the current thread on the target.
* @param - ICDThread
*/
void setCurrentThread(ICDIThread current) throws CDIException;
/**
* Evaluates the expression specified by the given string.
* Returns the evaluation result as a String.
*
* @param - expression string to be evaluated
* @return the result of the evaluation
* @throws CDIException if this method fails. Reasons include:
*/
String evaluateExpressionToString(String expressionText)
throws CDIException;
/**
* Returns whether this target is terminated.
*
* @return whether this target is terminated
*/
boolean isTerminated();
/**
* Causes this target to terminate.
*
* @throws CDIException if this method fails. Reasons include:
*/
void terminate() throws CDIException;
/**
* Returns whether this target is disconnected.
*
* @return whether this target is disconnected
*/
boolean isDisconnected();
/**
* Disconnects this target from the debuggable process. Generally,
* disconnecting ends a debug session with this target, but allows
* the debuggable program to continue running.
*
* @throws CDIException if this method fails. Reasons include:
*/
void disconnect() throws CDIException;
/**
* Restarts the execution of this target.
*
* @throws CDIException if this method fails. Reasons include:
*/
void restart() throws CDIException;
/**
* Returns whether this target is currently suspended.
*
* @return whether this target is currently suspended
*/
boolean isSuspended();
/**
* Causes this target to resume its execution.
* Has no effect on a target that is not suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void resume() throws CDIException;
/**
* Causes this target to suspend its execution.
* Has no effect on an already suspended target.
*
* @throws CDIException if this method fails. Reasons include:
*/
void suspend() throws CDIException;
/**
* Equivalent to stepReturn(true)
* @throws CDIException if this method fails. Reasons include:
*/
void stepReturn() throws CDIException;
/**
* If execute is true, continue running until just after function. if
* If execute is false, cancel execution of the function and stop the
* program after the function.
* Can only be called when the associated target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void stepReturn(boolean execute) throws CDIException;
/**
* Steps over the current source line. Can only be called
* when the associated target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void stepOver() throws CDIException;
/**
* Steps into the current source line. Can only be called
* when the associated target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void stepInto() throws CDIException;
/**
* Steps over the current machine instruction. Can only be called
* when the associated target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void stepOverInstruction() throws CDIException;
/**
* Steps into the current machine instruction. Can only be called
* when the associated target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void stepIntoInstruction() throws CDIException;
/**
* Continues running until location is reached. Can only be called when the associated
* target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void runUntil(ICDILocation location) throws CDIException;
/**
* Resume execution at location. Note the jump() does not change stackframe.
* The result is undefined if jump outside of the stacframe i.e function.
* Can only be called when the associated target is suspended.
*
* @throws CDIException if this method fails. Reasons include:
*/
void jump(ICDILocation location) throws CDIException;
/**
* Method signal, resume execution without giving a signal.
* @throws CDIException
*/
void signal() throws CDIException;
/**
* Resume execution where the program stopped but immediately give the
* signal.
*
* @param signal
* @throws CDIException
*/
void signal(ICDISignal signal) throws CDIException;
/**
* Returns the currently selected thread.
*
* @return the currently selected thread
* @throws CDIException if this method fails. Reasons include:
*/
ICDIThread getCurrentThread() throws CDIException;
}
|
