Rev 4386 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 4386 | Rev 4387 | ||
---|---|---|---|
1 | /* |
1 | /* |
2 | * Copyright (c) 2008 Jiri Svoboda |
2 | * Copyright (c) 2008 Jiri Svoboda |
3 | * All rights reserved. |
3 | * All rights reserved. |
4 | * |
4 | * |
5 | * Redistribution and use in source and binary forms, with or without |
5 | * Redistribution and use in source and binary forms, with or without |
6 | * modification, are permitted provided that the following conditions |
6 | * modification, are permitted provided that the following conditions |
7 | * are met: |
7 | * are met: |
8 | * |
8 | * |
9 | * - Redistributions of source code must retain the above copyright |
9 | * - Redistributions of source code must retain the above copyright |
10 | * notice, this list of conditions and the following disclaimer. |
10 | * notice, this list of conditions and the following disclaimer. |
11 | * - Redistributions in binary form must reproduce the above copyright |
11 | * - Redistributions in binary form must reproduce the above copyright |
12 | * notice, this list of conditions and the following disclaimer in the |
12 | * notice, this list of conditions and the following disclaimer in the |
13 | * documentation and/or other materials provided with the distribution. |
13 | * documentation and/or other materials provided with the distribution. |
14 | * - The name of the author may not be used to endorse or promote products |
14 | * - The name of the author may not be used to endorse or promote products |
15 | * derived from this software without specific prior written permission. |
15 | * derived from this software without specific prior written permission. |
16 | * |
16 | * |
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
27 | */ |
27 | */ |
28 | 28 | ||
29 | /** @addtogroup generic |
29 | /** @addtogroup generic |
30 | * @{ |
30 | * @{ |
31 | */ |
31 | */ |
32 | 32 | ||
33 | /** |
33 | /** |
34 | * @file |
34 | * @file |
35 | * @brief Udebug hooks and data structure management. |
35 | * @brief Udebug hooks and data structure management. |
36 | * |
36 | * |
37 | * Udebug is an interface that makes userspace debuggers possible. |
37 | * Udebug is an interface that makes userspace debuggers possible. |
38 | */ |
38 | */ |
39 | 39 | ||
40 | #include <synch/waitq.h> |
40 | #include <synch/waitq.h> |
41 | #include <debug.h> |
41 | #include <debug.h> |
42 | #include <udebug/udebug.h> |
42 | #include <udebug/udebug.h> |
43 | #include <errno.h> |
43 | #include <errno.h> |
44 | #include <print.h> |
44 | #include <print.h> |
45 | #include <arch.h> |
45 | #include <arch.h> |
46 | 46 | ||
47 | 47 | ||
48 | /** Initialize udebug part of task structure. |
48 | /** Initialize udebug part of task structure. |
49 | * |
49 | * |
50 | * Called as part of task structure initialization. |
50 | * Called as part of task structure initialization. |
51 | * @param ut Pointer to the structure to initialize. |
51 | * @param ut Pointer to the structure to initialize. |
52 | */ |
52 | */ |
53 | void udebug_task_init(udebug_task_t *ut) |
53 | void udebug_task_init(udebug_task_t *ut) |
54 | { |
54 | { |
55 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
55 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
56 | ut->dt_state = UDEBUG_TS_INACTIVE; |
56 | ut->dt_state = UDEBUG_TS_INACTIVE; |
57 | ut->begin_call = NULL; |
57 | ut->begin_call = NULL; |
58 | ut->not_stoppable_count = 0; |
58 | ut->not_stoppable_count = 0; |
59 | ut->evmask = 0; |
59 | ut->evmask = 0; |
60 | } |
60 | } |
61 | 61 | ||
62 | /** Initialize udebug part of thread structure. |
62 | /** Initialize udebug part of thread structure. |
63 | * |
63 | * |
64 | * Called as part of thread structure initialization. |
64 | * Called as part of thread structure initialization. |
65 | * @param ut Pointer to the structure to initialize. |
65 | * @param ut Pointer to the structure to initialize. |
66 | */ |
66 | */ |
67 | void udebug_thread_initialize(udebug_thread_t *ut) |
67 | void udebug_thread_initialize(udebug_thread_t *ut) |
68 | { |
68 | { |
69 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
69 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
70 | waitq_initialize(&ut->go_wq); |
70 | waitq_initialize(&ut->go_wq); |
71 | 71 | ||
72 | ut->go_call = NULL; |
72 | ut->go_call = NULL; |
73 | ut->uspace_state = NULL; |
73 | ut->uspace_state = NULL; |
74 | ut->go = false; |
74 | ut->go = false; |
75 | ut->stoppable = true; |
75 | ut->stoppable = true; |
76 | ut->active = false; |
76 | ut->active = false; |
77 | ut->cur_event = 0; /* none */ |
77 | ut->cur_event = 0; /* none */ |
78 | } |
78 | } |
79 | 79 | ||
80 | /** Wait for a GO message. |
80 | /** Wait for a GO message. |
81 | * |
81 | * |
82 | * When a debugging event occurs in a thread or the thread is stopped, |
82 | * When a debugging event occurs in a thread or the thread is stopped, |
83 | * this function is called to block the thread until a GO message |
83 | * this function is called to block the thread until a GO message |
84 | * is received. |
84 | * is received. |
85 | * |
85 | * |
86 | * @param wq The wait queue used by the thread to wait for GO messages. |
86 | * @param wq The wait queue used by the thread to wait for GO messages. |
87 | */ |
87 | */ |
88 | static void udebug_wait_for_go(waitq_t *wq) |
88 | static void udebug_wait_for_go(waitq_t *wq) |
89 | { |
89 | { |
90 | int rc; |
90 | int rc; |
91 | ipl_t ipl; |
91 | ipl_t ipl; |
92 | 92 | ||
93 | ipl = waitq_sleep_prepare(wq); |
93 | ipl = waitq_sleep_prepare(wq); |
94 | 94 | ||
95 | wq->missed_wakeups = 0; /* Enforce blocking. */ |
95 | wq->missed_wakeups = 0; /* Enforce blocking. */ |
96 | rc = waitq_sleep_timeout_unsafe(wq, SYNCH_NO_TIMEOUT, SYNCH_FLAGS_NONE); |
96 | rc = waitq_sleep_timeout_unsafe(wq, SYNCH_NO_TIMEOUT, SYNCH_FLAGS_NONE); |
97 | 97 | ||
98 | waitq_sleep_finish(wq, rc, ipl); |
98 | waitq_sleep_finish(wq, rc, ipl); |
99 | } |
99 | } |
100 | 100 | ||
101 | /** Do a preliminary check that a debugging session is in progress. |
- | |
102 | * |
- | |
103 | * This only requires the THREAD->udebug.lock mutex (and not TASK->udebug.lock |
- | |
104 | * mutex). For an undebugged task, this will never block (while there could be |
- | |
105 | * collisions by different threads on the TASK mutex), thus improving SMP |
- | |
106 | * perormance for undebugged tasks. |
- | |
107 | * |
- | |
108 | * @return True if the thread was in a debugging session when the function |
- | |
109 | * checked, false otherwise. |
- | |
110 | */ |
- | |
111 | static bool udebug_thread_precheck(void) |
- | |
112 | { |
- | |
113 | bool res; |
- | |
114 | - | ||
115 | mutex_lock(&THREAD->udebug.lock); |
- | |
116 | res = THREAD->udebug.active; |
- | |
117 | mutex_unlock(&THREAD->udebug.lock); |
- | |
118 | - | ||
119 | return res; |
- | |
120 | } |
- | |
121 | - | ||
122 | /** Start of stoppable section. |
101 | /** Start of stoppable section. |
123 | * |
102 | * |
124 | * A stoppable section is a section of code where if the thread can be stoped. In other words, |
103 | * A stoppable section is a section of code where if the thread can be stoped. In other words, |
125 | * if a STOP operation is issued, the thread is guaranteed not to execute |
104 | * if a STOP operation is issued, the thread is guaranteed not to execute |
126 | * any userspace instructions until the thread is resumed. |
105 | * any userspace instructions until the thread is resumed. |
127 | * |
106 | * |
128 | * Having stoppable sections is better than having stopping points, since |
107 | * Having stoppable sections is better than having stopping points, since |
129 | * a thread can be stopped even when it is blocked indefinitely in a system |
108 | * a thread can be stopped even when it is blocked indefinitely in a system |
130 | * call (whereas it would not reach any stopping point). |
109 | * call (whereas it would not reach any stopping point). |
131 | */ |
110 | */ |
132 | void udebug_stoppable_begin(void) |
111 | void udebug_stoppable_begin(void) |
133 | { |
112 | { |
134 | int nsc; |
113 | int nsc; |
135 | call_t *db_call, *go_call; |
114 | call_t *db_call, *go_call; |
136 | 115 | ||
137 | ASSERT(THREAD); |
116 | ASSERT(THREAD); |
138 | ASSERT(TASK); |
117 | ASSERT(TASK); |
139 | 118 | ||
140 | mutex_lock(&TASK->udebug.lock); |
119 | mutex_lock(&TASK->udebug.lock); |
141 | 120 | ||
142 | nsc = --TASK->udebug.not_stoppable_count; |
121 | nsc = --TASK->udebug.not_stoppable_count; |
143 | 122 | ||
144 | /* Lock order OK, THREAD->udebug.lock is after TASK->udebug.lock */ |
123 | /* Lock order OK, THREAD->udebug.lock is after TASK->udebug.lock */ |
145 | mutex_lock(&THREAD->udebug.lock); |
124 | mutex_lock(&THREAD->udebug.lock); |
146 | ASSERT(THREAD->udebug.stoppable == false); |
125 | ASSERT(THREAD->udebug.stoppable == false); |
147 | THREAD->udebug.stoppable = true; |
126 | THREAD->udebug.stoppable = true; |
148 | 127 | ||
149 | if (TASK->udebug.dt_state == UDEBUG_TS_BEGINNING && nsc == 0) { |
128 | if (TASK->udebug.dt_state == UDEBUG_TS_BEGINNING && nsc == 0) { |
150 | /* |
129 | /* |
151 | * This was the last non-stoppable thread. Reply to |
130 | * This was the last non-stoppable thread. Reply to |
152 | * DEBUG_BEGIN call. |
131 | * DEBUG_BEGIN call. |
153 | */ |
132 | */ |
154 | 133 | ||
155 | db_call = TASK->udebug.begin_call; |
134 | db_call = TASK->udebug.begin_call; |
156 | ASSERT(db_call); |
135 | ASSERT(db_call); |
157 | 136 | ||
158 | TASK->udebug.dt_state = UDEBUG_TS_ACTIVE; |
137 | TASK->udebug.dt_state = UDEBUG_TS_ACTIVE; |
159 | TASK->udebug.begin_call = NULL; |
138 | TASK->udebug.begin_call = NULL; |
160 | 139 | ||
161 | IPC_SET_RETVAL(db_call->data, 0); |
140 | IPC_SET_RETVAL(db_call->data, 0); |
162 | ipc_answer(&TASK->answerbox, db_call); |
141 | ipc_answer(&TASK->answerbox, db_call); |
163 | 142 | ||
164 | } else if (TASK->udebug.dt_state == UDEBUG_TS_ACTIVE) { |
143 | } else if (TASK->udebug.dt_state == UDEBUG_TS_ACTIVE) { |
165 | /* |
144 | /* |
166 | * Active debugging session |
145 | * Active debugging session |
167 | */ |
146 | */ |
168 | 147 | ||
169 | if (THREAD->udebug.active == true && |
148 | if (THREAD->udebug.active == true && |
170 | THREAD->udebug.go == false) { |
149 | THREAD->udebug.go == false) { |
171 | /* |
150 | /* |
172 | * Thread was requested to stop - answer go call |
151 | * Thread was requested to stop - answer go call |
173 | */ |
152 | */ |
174 | 153 | ||
175 | /* Make sure nobody takes this call away from us */ |
154 | /* Make sure nobody takes this call away from us */ |
176 | go_call = THREAD->udebug.go_call; |
155 | go_call = THREAD->udebug.go_call; |
177 | THREAD->udebug.go_call = NULL; |
156 | THREAD->udebug.go_call = NULL; |
178 | ASSERT(go_call); |
157 | ASSERT(go_call); |
179 | 158 | ||
180 | IPC_SET_RETVAL(go_call->data, 0); |
159 | IPC_SET_RETVAL(go_call->data, 0); |
181 | IPC_SET_ARG1(go_call->data, UDEBUG_EVENT_STOP); |
160 | IPC_SET_ARG1(go_call->data, UDEBUG_EVENT_STOP); |
182 | 161 | ||
183 | THREAD->udebug.cur_event = UDEBUG_EVENT_STOP; |
162 | THREAD->udebug.cur_event = UDEBUG_EVENT_STOP; |
184 | 163 | ||
185 | ipc_answer(&TASK->answerbox, go_call); |
164 | ipc_answer(&TASK->answerbox, go_call); |
186 | } |
165 | } |
187 | } |
166 | } |
188 | 167 | ||
189 | mutex_unlock(&THREAD->udebug.lock); |
168 | mutex_unlock(&THREAD->udebug.lock); |
190 | mutex_unlock(&TASK->udebug.lock); |
169 | mutex_unlock(&TASK->udebug.lock); |
191 | } |
170 | } |
192 | 171 | ||
193 | /** End of a stoppable section. |
172 | /** End of a stoppable section. |
194 | * |
173 | * |
195 | * This is the point where the thread will block if it is stopped. |
174 | * This is the point where the thread will block if it is stopped. |
196 | * (As, by definition, a stopped thread must not leave its stoppable section). |
175 | * (As, by definition, a stopped thread must not leave its stoppable section). |
197 | */ |
176 | */ |
198 | void udebug_stoppable_end(void) |
177 | void udebug_stoppable_end(void) |
199 | { |
178 | { |
200 | restart: |
179 | restart: |
201 | mutex_lock(&TASK->udebug.lock); |
180 | mutex_lock(&TASK->udebug.lock); |
202 | mutex_lock(&THREAD->udebug.lock); |
181 | mutex_lock(&THREAD->udebug.lock); |
203 | 182 | ||
204 | if (THREAD->udebug.active && THREAD->udebug.go == false) { |
183 | if (THREAD->udebug.active && THREAD->udebug.go == false) { |
205 | TASK->udebug.begin_call = NULL; |
184 | TASK->udebug.begin_call = NULL; |
206 | mutex_unlock(&THREAD->udebug.lock); |
185 | mutex_unlock(&THREAD->udebug.lock); |
207 | mutex_unlock(&TASK->udebug.lock); |
186 | mutex_unlock(&TASK->udebug.lock); |
208 | 187 | ||
209 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
188 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
210 | 189 | ||
211 | goto restart; |
190 | goto restart; |
212 | /* Must try again - have to lose stoppability atomically. */ |
191 | /* Must try again - have to lose stoppability atomically. */ |
213 | } else { |
192 | } else { |
214 | ++TASK->udebug.not_stoppable_count; |
193 | ++TASK->udebug.not_stoppable_count; |
215 | ASSERT(THREAD->udebug.stoppable == true); |
194 | ASSERT(THREAD->udebug.stoppable == true); |
216 | THREAD->udebug.stoppable = false; |
195 | THREAD->udebug.stoppable = false; |
217 | 196 | ||
218 | mutex_unlock(&THREAD->udebug.lock); |
197 | mutex_unlock(&THREAD->udebug.lock); |
219 | mutex_unlock(&TASK->udebug.lock); |
198 | mutex_unlock(&TASK->udebug.lock); |
220 | } |
199 | } |
221 | } |
200 | } |
222 | 201 | ||
223 | /** Upon being scheduled to run, check if the current thread should stop. |
202 | /** Upon being scheduled to run, check if the current thread should stop. |
224 | * |
203 | * |
225 | * This function is called from clock(). |
204 | * This function is called from clock(). |
226 | */ |
205 | */ |
227 | void udebug_before_thread_runs(void) |
206 | void udebug_before_thread_runs(void) |
228 | { |
207 | { |
229 | /* Check if we're supposed to stop */ |
208 | /* Check if we're supposed to stop */ |
230 | udebug_stoppable_begin(); |
209 | udebug_stoppable_begin(); |
231 | udebug_stoppable_end(); |
210 | udebug_stoppable_end(); |
232 | } |
211 | } |
233 | 212 | ||
234 | /** Syscall event hook. |
213 | /** Syscall event hook. |
235 | * |
214 | * |
236 | * Must be called before and after servicing a system call. This generates |
215 | * Must be called before and after servicing a system call. This generates |
237 | * a SYSCALL_B or SYSCALL_E event, depending on the value of @a end_variant. |
216 | * a SYSCALL_B or SYSCALL_E event, depending on the value of @a end_variant. |
238 | */ |
217 | */ |
239 | void udebug_syscall_event(unative_t a1, unative_t a2, unative_t a3, |
218 | void udebug_syscall_event(unative_t a1, unative_t a2, unative_t a3, |
240 | unative_t a4, unative_t a5, unative_t a6, unative_t id, unative_t rc, |
219 | unative_t a4, unative_t a5, unative_t a6, unative_t id, unative_t rc, |
241 | bool end_variant) |
220 | bool end_variant) |
242 | { |
221 | { |
243 | call_t *call; |
222 | call_t *call; |
244 | udebug_event_t etype; |
223 | udebug_event_t etype; |
245 | 224 | ||
246 | etype = end_variant ? UDEBUG_EVENT_SYSCALL_E : UDEBUG_EVENT_SYSCALL_B; |
225 | etype = end_variant ? UDEBUG_EVENT_SYSCALL_E : UDEBUG_EVENT_SYSCALL_B; |
247 | 226 | ||
248 | /* Early check for undebugged tasks */ |
- | |
249 | if (!udebug_thread_precheck()) { |
- | |
250 | return; |
- | |
251 | } |
- | |
252 | - | ||
253 | mutex_lock(&TASK->udebug.lock); |
227 | mutex_lock(&TASK->udebug.lock); |
254 | mutex_lock(&THREAD->udebug.lock); |
228 | mutex_lock(&THREAD->udebug.lock); |
255 | 229 | ||
256 | /* Must only generate events when in debugging session and is go. */ |
230 | /* Must only generate events when in debugging session and is go. */ |
257 | if (THREAD->udebug.active != true || THREAD->udebug.go == false || |
231 | if (THREAD->udebug.active != true || THREAD->udebug.go == false || |
258 | (TASK->udebug.evmask & UDEBUG_EVMASK(etype)) == 0) { |
232 | (TASK->udebug.evmask & UDEBUG_EVMASK(etype)) == 0) { |
259 | mutex_unlock(&THREAD->udebug.lock); |
233 | mutex_unlock(&THREAD->udebug.lock); |
260 | mutex_unlock(&TASK->udebug.lock); |
234 | mutex_unlock(&TASK->udebug.lock); |
261 | return; |
235 | return; |
262 | } |
236 | } |
263 | 237 | ||
264 | /* Fill in the GO response. */ |
238 | /* Fill in the GO response. */ |
265 | call = THREAD->udebug.go_call; |
239 | call = THREAD->udebug.go_call; |
266 | THREAD->udebug.go_call = NULL; |
240 | THREAD->udebug.go_call = NULL; |
267 | 241 | ||
268 | IPC_SET_RETVAL(call->data, 0); |
242 | IPC_SET_RETVAL(call->data, 0); |
269 | IPC_SET_ARG1(call->data, etype); |
243 | IPC_SET_ARG1(call->data, etype); |
270 | IPC_SET_ARG2(call->data, id); |
244 | IPC_SET_ARG2(call->data, id); |
271 | IPC_SET_ARG3(call->data, rc); |
245 | IPC_SET_ARG3(call->data, rc); |
272 | 246 | ||
273 | THREAD->udebug.syscall_args[0] = a1; |
247 | THREAD->udebug.syscall_args[0] = a1; |
274 | THREAD->udebug.syscall_args[1] = a2; |
248 | THREAD->udebug.syscall_args[1] = a2; |
275 | THREAD->udebug.syscall_args[2] = a3; |
249 | THREAD->udebug.syscall_args[2] = a3; |
276 | THREAD->udebug.syscall_args[3] = a4; |
250 | THREAD->udebug.syscall_args[3] = a4; |
277 | THREAD->udebug.syscall_args[4] = a5; |
251 | THREAD->udebug.syscall_args[4] = a5; |
278 | THREAD->udebug.syscall_args[5] = a6; |
252 | THREAD->udebug.syscall_args[5] = a6; |
279 | 253 | ||
280 | /* |
254 | /* |
281 | * Make sure udebug.go is false when going to sleep |
255 | * Make sure udebug.go is false when going to sleep |
282 | * in case we get woken up by DEBUG_END. (At which |
256 | * in case we get woken up by DEBUG_END. (At which |
283 | * point it must be back to the initial true value). |
257 | * point it must be back to the initial true value). |
284 | */ |
258 | */ |
285 | THREAD->udebug.go = false; |
259 | THREAD->udebug.go = false; |
286 | THREAD->udebug.cur_event = etype; |
260 | THREAD->udebug.cur_event = etype; |
287 | 261 | ||
288 | ipc_answer(&TASK->answerbox, call); |
262 | ipc_answer(&TASK->answerbox, call); |
289 | 263 | ||
290 | mutex_unlock(&THREAD->udebug.lock); |
264 | mutex_unlock(&THREAD->udebug.lock); |
291 | mutex_unlock(&TASK->udebug.lock); |
265 | mutex_unlock(&TASK->udebug.lock); |
292 | 266 | ||
293 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
267 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
294 | } |
268 | } |
295 | 269 | ||
296 | /** Thread-creation event hook combined with attaching the thread. |
270 | /** Thread-creation event hook combined with attaching the thread. |
297 | * |
271 | * |
298 | * Must be called when a new userspace thread is created in the debugged |
272 | * Must be called when a new userspace thread is created in the debugged |
299 | * task. Generates a THREAD_B event. Also attaches the thread @a t |
273 | * task. Generates a THREAD_B event. Also attaches the thread @a t |
300 | * to the task @a ta. |
274 | * to the task @a ta. |
301 | * |
275 | * |
302 | * This is necessary to avoid a race condition where the BEGIN and THREAD_READ |
276 | * This is necessary to avoid a race condition where the BEGIN and THREAD_READ |
303 | * requests would be handled inbetween attaching the thread and checking it |
277 | * requests would be handled inbetween attaching the thread and checking it |
304 | * for being in a debugging session to send the THREAD_B event. We could then |
278 | * for being in a debugging session to send the THREAD_B event. We could then |
305 | * either miss threads or get some threads both in the thread list |
279 | * either miss threads or get some threads both in the thread list |
306 | * and get a THREAD_B event for them. |
280 | * and get a THREAD_B event for them. |
307 | * |
281 | * |
308 | * @param t Structure of the thread being created. Not locked, as the |
282 | * @param t Structure of the thread being created. Not locked, as the |
309 | * thread is not executing yet. |
283 | * thread is not executing yet. |
310 | * @param ta Task to which the thread should be attached. |
284 | * @param ta Task to which the thread should be attached. |
311 | */ |
285 | */ |
312 | void udebug_thread_b_event_attach(struct thread *t, struct task *ta) |
286 | void udebug_thread_b_event_attach(struct thread *t, struct task *ta) |
313 | { |
287 | { |
314 | call_t *call; |
288 | call_t *call; |
315 | 289 | ||
316 | mutex_lock(&TASK->udebug.lock); |
290 | mutex_lock(&TASK->udebug.lock); |
317 | mutex_lock(&THREAD->udebug.lock); |
291 | mutex_lock(&THREAD->udebug.lock); |
318 | 292 | ||
319 | thread_attach(t, ta); |
293 | thread_attach(t, ta); |
320 | 294 | ||
321 | LOG("Check state"); |
295 | LOG("Check state"); |
322 | 296 | ||
323 | /* Must only generate events when in debugging session */ |
297 | /* Must only generate events when in debugging session */ |
324 | if (THREAD->udebug.active != true) { |
298 | if (THREAD->udebug.active != true) { |
325 | LOG("udebug.active: %s, udebug.go: %s", |
299 | LOG("udebug.active: %s, udebug.go: %s", |
326 | THREAD->udebug.active ? "Yes(+)" : "No", |
300 | THREAD->udebug.active ? "Yes(+)" : "No", |
327 | THREAD->udebug.go ? "Yes(-)" : "No"); |
301 | THREAD->udebug.go ? "Yes(-)" : "No"); |
328 | mutex_unlock(&THREAD->udebug.lock); |
302 | mutex_unlock(&THREAD->udebug.lock); |
329 | mutex_unlock(&TASK->udebug.lock); |
303 | mutex_unlock(&TASK->udebug.lock); |
330 | return; |
304 | return; |
331 | } |
305 | } |
332 | 306 | ||
333 | LOG("Trigger event"); |
307 | LOG("Trigger event"); |
334 | call = THREAD->udebug.go_call; |
308 | call = THREAD->udebug.go_call; |
335 | THREAD->udebug.go_call = NULL; |
309 | THREAD->udebug.go_call = NULL; |
336 | IPC_SET_RETVAL(call->data, 0); |
310 | IPC_SET_RETVAL(call->data, 0); |
337 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_B); |
311 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_B); |
338 | IPC_SET_ARG2(call->data, (unative_t)t); |
312 | IPC_SET_ARG2(call->data, (unative_t)t); |
339 | 313 | ||
340 | /* |
314 | /* |
341 | * Make sure udebug.go is false when going to sleep |
315 | * Make sure udebug.go is false when going to sleep |
342 | * in case we get woken up by DEBUG_END. (At which |
316 | * in case we get woken up by DEBUG_END. (At which |
343 | * point it must be back to the initial true value). |
317 | * point it must be back to the initial true value). |
344 | */ |
318 | */ |
345 | THREAD->udebug.go = false; |
319 | THREAD->udebug.go = false; |
346 | THREAD->udebug.cur_event = UDEBUG_EVENT_THREAD_B; |
320 | THREAD->udebug.cur_event = UDEBUG_EVENT_THREAD_B; |
347 | 321 | ||
348 | ipc_answer(&TASK->answerbox, call); |
322 | ipc_answer(&TASK->answerbox, call); |
349 | 323 | ||
350 | mutex_unlock(&THREAD->udebug.lock); |
324 | mutex_unlock(&THREAD->udebug.lock); |
351 | mutex_unlock(&TASK->udebug.lock); |
325 | mutex_unlock(&TASK->udebug.lock); |
352 | 326 | ||
353 | LOG("Wait for Go"); |
327 | LOG("Wait for Go"); |
354 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
328 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
355 | } |
329 | } |
356 | 330 | ||
357 | /** Thread-termination event hook. |
331 | /** Thread-termination event hook. |
358 | * |
332 | * |
359 | * Must be called when the current thread is terminating. |
333 | * Must be called when the current thread is terminating. |
360 | * Generates a THREAD_E event. |
334 | * Generates a THREAD_E event. |
361 | */ |
335 | */ |
362 | void udebug_thread_e_event(void) |
336 | void udebug_thread_e_event(void) |
363 | { |
337 | { |
364 | call_t *call; |
338 | call_t *call; |
365 | 339 | ||
366 | mutex_lock(&TASK->udebug.lock); |
340 | mutex_lock(&TASK->udebug.lock); |
367 | mutex_lock(&THREAD->udebug.lock); |
341 | mutex_lock(&THREAD->udebug.lock); |
368 | 342 | ||
369 | LOG("Check state"); |
343 | LOG("Check state"); |
370 | 344 | ||
371 | /* Must only generate events when in debugging session. */ |
345 | /* Must only generate events when in debugging session. */ |
372 | if (THREAD->udebug.active != true) { |
346 | if (THREAD->udebug.active != true) { |
373 | LOG("udebug.active: %s, udebug.go: %s", |
347 | LOG("udebug.active: %s, udebug.go: %s", |
374 | THREAD->udebug.active ? "Yes" : "No", |
348 | THREAD->udebug.active ? "Yes" : "No", |
375 | THREAD->udebug.go ? "Yes" : "No"); |
349 | THREAD->udebug.go ? "Yes" : "No"); |
376 | mutex_unlock(&THREAD->udebug.lock); |
350 | mutex_unlock(&THREAD->udebug.lock); |
377 | mutex_unlock(&TASK->udebug.lock); |
351 | mutex_unlock(&TASK->udebug.lock); |
378 | return; |
352 | return; |
379 | } |
353 | } |
380 | 354 | ||
381 | LOG("Trigger event"); |
355 | LOG("Trigger event"); |
382 | call = THREAD->udebug.go_call; |
356 | call = THREAD->udebug.go_call; |
383 | THREAD->udebug.go_call = NULL; |
357 | THREAD->udebug.go_call = NULL; |
384 | IPC_SET_RETVAL(call->data, 0); |
358 | IPC_SET_RETVAL(call->data, 0); |
385 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_E); |
359 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_E); |
386 | 360 | ||
387 | /* Prevent any further debug activity in thread. */ |
361 | /* Prevent any further debug activity in thread. */ |
388 | THREAD->udebug.active = false; |
362 | THREAD->udebug.active = false; |
389 | THREAD->udebug.cur_event = 0; /* none */ |
363 | THREAD->udebug.cur_event = 0; /* none */ |
390 | THREAD->udebug.go = false; /* set to initial value */ |
364 | THREAD->udebug.go = false; /* set to initial value */ |
391 | 365 | ||
392 | ipc_answer(&TASK->answerbox, call); |
366 | ipc_answer(&TASK->answerbox, call); |
393 | 367 | ||
394 | mutex_unlock(&THREAD->udebug.lock); |
368 | mutex_unlock(&THREAD->udebug.lock); |
395 | mutex_unlock(&TASK->udebug.lock); |
369 | mutex_unlock(&TASK->udebug.lock); |
396 | 370 | ||
397 | /* |
371 | /* |
398 | * This event does not sleep - debugging has finished |
372 | * This event does not sleep - debugging has finished |
399 | * in this thread. |
373 | * in this thread. |
400 | */ |
374 | */ |
401 | } |
375 | } |
402 | 376 | ||
403 | /** |
377 | /** |
404 | * Terminate task debugging session. |
378 | * Terminate task debugging session. |
405 | * |
379 | * |
406 | * Gracefully terminates the debugging session for a task. If the debugger |
380 | * Gracefully terminates the debugging session for a task. If the debugger |
407 | * is still waiting for events on some threads, it will receive a |
381 | * is still waiting for events on some threads, it will receive a |
408 | * FINISHED event for each of them. |
382 | * FINISHED event for each of them. |
409 | * |
383 | * |
410 | * @param ta Task structure. ta->udebug.lock must be already locked. |
384 | * @param ta Task structure. ta->udebug.lock must be already locked. |
411 | * @return Zero on success or negative error code. |
385 | * @return Zero on success or negative error code. |
412 | */ |
386 | */ |
413 | int udebug_task_cleanup(struct task *ta) |
387 | int udebug_task_cleanup(struct task *ta) |
414 | { |
388 | { |
415 | thread_t *t; |
389 | thread_t *t; |
416 | link_t *cur; |
390 | link_t *cur; |
417 | int flags; |
391 | int flags; |
418 | ipl_t ipl; |
392 | ipl_t ipl; |
419 | 393 | ||
420 | if (ta->udebug.dt_state != UDEBUG_TS_BEGINNING && |
394 | if (ta->udebug.dt_state != UDEBUG_TS_BEGINNING && |
421 | ta->udebug.dt_state != UDEBUG_TS_ACTIVE) { |
395 | ta->udebug.dt_state != UDEBUG_TS_ACTIVE) { |
422 | return EINVAL; |
396 | return EINVAL; |
423 | } |
397 | } |
424 | 398 | ||
425 | LOG("Task %" PRIu64, ta->taskid); |
399 | LOG("Task %" PRIu64, ta->taskid); |
426 | 400 | ||
427 | /* Finish debugging of all userspace threads */ |
401 | /* Finish debugging of all userspace threads */ |
428 | for (cur = ta->th_head.next; cur != &ta->th_head; cur = cur->next) { |
402 | for (cur = ta->th_head.next; cur != &ta->th_head; cur = cur->next) { |
429 | t = list_get_instance(cur, thread_t, th_link); |
403 | t = list_get_instance(cur, thread_t, th_link); |
430 | 404 | ||
431 | mutex_lock(&t->udebug.lock); |
405 | mutex_lock(&t->udebug.lock); |
432 | 406 | ||
433 | ipl = interrupts_disable(); |
407 | ipl = interrupts_disable(); |
434 | spinlock_lock(&t->lock); |
408 | spinlock_lock(&t->lock); |
435 | 409 | ||
436 | flags = t->flags; |
410 | flags = t->flags; |
437 | 411 | ||
438 | spinlock_unlock(&t->lock); |
412 | spinlock_unlock(&t->lock); |
439 | interrupts_restore(ipl); |
413 | interrupts_restore(ipl); |
440 | 414 | ||
441 | /* Only process userspace threads. */ |
415 | /* Only process userspace threads. */ |
442 | if ((flags & THREAD_FLAG_USPACE) != 0) { |
416 | if ((flags & THREAD_FLAG_USPACE) != 0) { |
443 | /* Prevent any further debug activity in thread. */ |
417 | /* Prevent any further debug activity in thread. */ |
444 | t->udebug.active = false; |
418 | t->udebug.active = false; |
445 | t->udebug.cur_event = 0; /* none */ |
419 | t->udebug.cur_event = 0; /* none */ |
446 | 420 | ||
447 | /* Is the thread still go? */ |
421 | /* Is the thread still go? */ |
448 | if (t->udebug.go == true) { |
422 | if (t->udebug.go == true) { |
449 | /* |
423 | /* |
450 | * Yes, so clear go. As active == false, |
424 | * Yes, so clear go. As active == false, |
451 | * this doesn't affect anything. |
425 | * this doesn't affect anything. |
452 | */ |
426 | */ |
453 | t->udebug.go = false; |
427 | t->udebug.go = false; |
454 | 428 | ||
455 | /* Answer GO call */ |
429 | /* Answer GO call */ |
456 | LOG("Answer GO call with EVENT_FINISHED."); |
430 | LOG("Answer GO call with EVENT_FINISHED."); |
457 | IPC_SET_RETVAL(t->udebug.go_call->data, 0); |
431 | IPC_SET_RETVAL(t->udebug.go_call->data, 0); |
458 | IPC_SET_ARG1(t->udebug.go_call->data, |
432 | IPC_SET_ARG1(t->udebug.go_call->data, |
459 | UDEBUG_EVENT_FINISHED); |
433 | UDEBUG_EVENT_FINISHED); |
460 | 434 | ||
461 | ipc_answer(&ta->answerbox, t->udebug.go_call); |
435 | ipc_answer(&ta->answerbox, t->udebug.go_call); |
462 | t->udebug.go_call = NULL; |
436 | t->udebug.go_call = NULL; |
463 | } else { |
437 | } else { |
464 | /* |
438 | /* |
465 | * Debug_stop is already at initial value. |
439 | * Debug_stop is already at initial value. |
466 | * Yet this means the thread needs waking up. |
440 | * Yet this means the thread needs waking up. |
467 | */ |
441 | */ |
468 | 442 | ||
469 | /* |
443 | /* |
470 | * t's lock must not be held when calling |
444 | * t's lock must not be held when calling |
471 | * waitq_wakeup. |
445 | * waitq_wakeup. |
472 | */ |
446 | */ |
473 | waitq_wakeup(&t->udebug.go_wq, WAKEUP_FIRST); |
447 | waitq_wakeup(&t->udebug.go_wq, WAKEUP_FIRST); |
474 | } |
448 | } |
475 | } |
449 | } |
476 | mutex_unlock(&t->udebug.lock); |
450 | mutex_unlock(&t->udebug.lock); |
477 | } |
451 | } |
478 | 452 | ||
479 | ta->udebug.dt_state = UDEBUG_TS_INACTIVE; |
453 | ta->udebug.dt_state = UDEBUG_TS_INACTIVE; |
480 | ta->udebug.debugger = NULL; |
454 | ta->udebug.debugger = NULL; |
481 | 455 | ||
482 | return 0; |
456 | return 0; |
483 | } |
457 | } |
484 | 458 | ||
485 | 459 | ||
486 | /** @} |
460 | /** @} |
487 | */ |
461 | */ |
488 | 462 |