Rev 3471 | Rev 3611 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 3471 | Rev 3606 | ||
---|---|---|---|
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 | * |
- | |
39 | * Functions in this file are executed directly in each thread, which |
- | |
40 | * may or may not be the subject of debugging. The udebug_stoppable_begin/end() |
- | |
41 | * functions are also executed in the clock interrupt handler. To avoid |
- | |
42 | * deadlock, functions in this file are protected from the interrupt |
- | |
43 | * by locking the recursive lock THREAD->udebug.int_lock (just an atomic |
- | |
44 | * variable). This prevents udebug_stoppable_begin/end() from being |
- | |
45 | * executed in the interrupt handler (they are skipped). |
- | |
46 | * |
- | |
47 | * Functions in udebug_ops.c and udebug_ipc.c execute in different threads, |
- | |
48 | * so they needn't be protected from the (preemptible) interrupt-initiated |
- | |
49 | * code. |
- | |
50 | */ |
38 | */ |
51 | 39 | ||
52 | #include <synch/waitq.h> |
40 | #include <synch/waitq.h> |
53 | #include <debug.h> |
41 | #include <debug.h> |
54 | #include <udebug/udebug.h> |
42 | #include <udebug/udebug.h> |
55 | #include <errno.h> |
43 | #include <errno.h> |
56 | #include <arch.h> |
44 | #include <arch.h> |
57 | 45 | ||
58 | static inline void udebug_int_lock(void) |
- | |
59 | { |
- | |
60 | atomic_inc(&THREAD->udebug.int_lock); |
- | |
61 | } |
- | |
62 | - | ||
63 | static inline void udebug_int_unlock(void) |
- | |
64 | { |
- | |
65 | atomic_dec(&THREAD->udebug.int_lock); |
- | |
66 | } |
- | |
67 | 46 | ||
68 | /** Initialize udebug part of task structure. |
47 | /** Initialize udebug part of task structure. |
69 | * |
48 | * |
70 | * Called as part of task structure initialization. |
49 | * Called as part of task structure initialization. |
71 | * @param ut Pointer to the structure to initialize. |
50 | * @param ut Pointer to the structure to initialize. |
72 | */ |
51 | */ |
73 | void udebug_task_init(udebug_task_t *ut) |
52 | void udebug_task_init(udebug_task_t *ut) |
74 | { |
53 | { |
75 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
54 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
76 | ut->dt_state = UDEBUG_TS_INACTIVE; |
55 | ut->dt_state = UDEBUG_TS_INACTIVE; |
77 | ut->begin_call = NULL; |
56 | ut->begin_call = NULL; |
78 | ut->not_stoppable_count = 0; |
57 | ut->not_stoppable_count = 0; |
79 | ut->evmask = 0; |
58 | ut->evmask = 0; |
80 | } |
59 | } |
81 | 60 | ||
82 | /** Initialize udebug part of thread structure. |
61 | /** Initialize udebug part of thread structure. |
83 | * |
62 | * |
84 | * Called as part of thread structure initialization. |
63 | * Called as part of thread structure initialization. |
85 | * @param ut Pointer to the structure to initialize. |
64 | * @param ut Pointer to the structure to initialize. |
86 | */ |
65 | */ |
87 | void udebug_thread_initialize(udebug_thread_t *ut) |
66 | void udebug_thread_initialize(udebug_thread_t *ut) |
88 | { |
67 | { |
89 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
68 | mutex_initialize(&ut->lock, MUTEX_PASSIVE); |
90 | waitq_initialize(&ut->go_wq); |
69 | waitq_initialize(&ut->go_wq); |
91 | 70 | ||
92 | /* |
- | |
93 | * At the beginning the thread is stoppable, so int_lock be set, too. |
- | |
94 | */ |
- | |
95 | atomic_set(&ut->int_lock, 1); |
- | |
96 | - | ||
97 | ut->go_call = NULL; |
71 | ut->go_call = NULL; |
98 | ut->uspace_state = NULL; |
72 | ut->uspace_state = NULL; |
99 | ut->stop = true; |
73 | ut->go = false; |
100 | ut->stoppable = true; |
74 | ut->stoppable = true; |
101 | ut->debug_active = false; |
75 | ut->debug_active = false; |
102 | ut->cur_event = 0; /* none */ |
76 | ut->cur_event = 0; /* none */ |
103 | } |
77 | } |
104 | 78 | ||
105 | /** Wait for a GO message. |
79 | /** Wait for a GO message. |
106 | * |
80 | * |
107 | * When a debugging event occurs in a thread or the thread is stopped, |
81 | * When a debugging event occurs in a thread or the thread is stopped, |
108 | * this function is called to block the thread until a GO message |
82 | * this function is called to block the thread until a GO message |
109 | * is received. |
83 | * is received. |
110 | * |
84 | * |
111 | * @param wq The wait queue used by the thread to wait for GO messages. |
85 | * @param wq The wait queue used by the thread to wait for GO messages. |
112 | */ |
86 | */ |
113 | static void udebug_wait_for_go(waitq_t *wq) |
87 | static void udebug_wait_for_go(waitq_t *wq) |
114 | { |
88 | { |
115 | int rc; |
89 | int rc; |
116 | ipl_t ipl; |
90 | ipl_t ipl; |
117 | 91 | ||
118 | ipl = waitq_sleep_prepare(wq); |
92 | ipl = waitq_sleep_prepare(wq); |
119 | 93 | ||
120 | wq->missed_wakeups = 0; /* Enforce blocking. */ |
94 | wq->missed_wakeups = 0; /* Enforce blocking. */ |
121 | rc = waitq_sleep_timeout_unsafe(wq, SYNCH_NO_TIMEOUT, SYNCH_FLAGS_NONE); |
95 | rc = waitq_sleep_timeout_unsafe(wq, SYNCH_NO_TIMEOUT, SYNCH_FLAGS_NONE); |
122 | 96 | ||
123 | waitq_sleep_finish(wq, rc, ipl); |
97 | waitq_sleep_finish(wq, rc, ipl); |
124 | } |
98 | } |
125 | 99 | ||
126 | /** Do a preliminary check that a debugging session is in progress. |
100 | /** Do a preliminary check that a debugging session is in progress. |
127 | * |
101 | * |
128 | * This only requires the THREAD->udebug.lock mutex (and not TASK->udebug.lock |
102 | * This only requires the THREAD->udebug.lock mutex (and not TASK->udebug.lock |
129 | * mutex). For an undebugged task, this will never block (while there could be |
103 | * mutex). For an undebugged task, this will never block (while there could be |
130 | * collisions by different threads on the TASK mutex), thus improving SMP |
104 | * collisions by different threads on the TASK mutex), thus improving SMP |
131 | * perormance for undebugged tasks. |
105 | * perormance for undebugged tasks. |
132 | * |
106 | * |
133 | * @return True if the thread was in a debugging session when the function |
107 | * @return True if the thread was in a debugging session when the function |
134 | * checked, false otherwise. |
108 | * checked, false otherwise. |
135 | */ |
109 | */ |
136 | static bool udebug_thread_precheck(void) |
110 | static bool udebug_thread_precheck(void) |
137 | { |
111 | { |
138 | bool res; |
112 | bool res; |
139 | 113 | ||
140 | mutex_lock(&THREAD->udebug.lock); |
114 | mutex_lock(&THREAD->udebug.lock); |
141 | res = THREAD->udebug.debug_active; |
115 | res = THREAD->udebug.debug_active; |
142 | mutex_unlock(&THREAD->udebug.lock); |
116 | mutex_unlock(&THREAD->udebug.lock); |
143 | 117 | ||
144 | return res; |
118 | return res; |
145 | } |
119 | } |
146 | 120 | ||
147 | /** Start of stoppable section. |
121 | /** Start of stoppable section. |
148 | * |
122 | * |
149 | * A stoppable section is a section of code where if the thread can be stoped. In other words, |
123 | * A stoppable section is a section of code where if the thread can be stoped. In other words, |
150 | * if a STOP operation is issued, the thread is guaranteed not to execute |
124 | * if a STOP operation is issued, the thread is guaranteed not to execute |
151 | * any userspace instructions until the thread is resumed. |
125 | * any userspace instructions until the thread is resumed. |
152 | * |
126 | * |
153 | * Having stoppable sections is better than having stopping points, since |
127 | * Having stoppable sections is better than having stopping points, since |
154 | * a thread can be stopped even when it is blocked indefinitely in a system |
128 | * a thread can be stopped even when it is blocked indefinitely in a system |
155 | * call (whereas it would not reach any stopping point). |
129 | * call (whereas it would not reach any stopping point). |
156 | */ |
130 | */ |
157 | void udebug_stoppable_begin(void) |
131 | void udebug_stoppable_begin(void) |
158 | { |
132 | { |
159 | int nsc; |
133 | int nsc; |
160 | call_t *db_call, *go_call; |
134 | call_t *db_call, *go_call; |
161 | 135 | ||
162 | ASSERT(THREAD); |
136 | ASSERT(THREAD); |
163 | ASSERT(TASK); |
137 | ASSERT(TASK); |
164 | 138 | ||
165 | udebug_int_lock(); |
- | |
166 | - | ||
167 | /* Early check for undebugged tasks */ |
139 | /* Early check for undebugged tasks */ |
168 | if (!udebug_thread_precheck()) { |
140 | if (!udebug_thread_precheck()) { |
169 | udebug_int_unlock(); |
- | |
170 | return; |
141 | return; |
171 | } |
142 | } |
172 | 143 | ||
173 | mutex_lock(&TASK->udebug.lock); |
144 | mutex_lock(&TASK->udebug.lock); |
174 | 145 | ||
175 | nsc = --TASK->udebug.not_stoppable_count; |
146 | nsc = --TASK->udebug.not_stoppable_count; |
176 | 147 | ||
177 | /* Lock order OK, THREAD->udebug.lock is after TASK->udebug.lock */ |
148 | /* Lock order OK, THREAD->udebug.lock is after TASK->udebug.lock */ |
178 | mutex_lock(&THREAD->udebug.lock); |
149 | mutex_lock(&THREAD->udebug.lock); |
179 | ASSERT(THREAD->udebug.stoppable == false); |
150 | ASSERT(THREAD->udebug.stoppable == false); |
180 | THREAD->udebug.stoppable = true; |
151 | THREAD->udebug.stoppable = true; |
181 | 152 | ||
182 | if (TASK->udebug.dt_state == UDEBUG_TS_BEGINNING && nsc == 0) { |
153 | if (TASK->udebug.dt_state == UDEBUG_TS_BEGINNING && nsc == 0) { |
183 | /* |
154 | /* |
184 | * This was the last non-stoppable thread. Reply to |
155 | * This was the last non-stoppable thread. Reply to |
185 | * DEBUG_BEGIN call. |
156 | * DEBUG_BEGIN call. |
186 | */ |
157 | */ |
187 | 158 | ||
188 | db_call = TASK->udebug.begin_call; |
159 | db_call = TASK->udebug.begin_call; |
189 | ASSERT(db_call); |
160 | ASSERT(db_call); |
190 | 161 | ||
191 | TASK->udebug.dt_state = UDEBUG_TS_ACTIVE; |
162 | TASK->udebug.dt_state = UDEBUG_TS_ACTIVE; |
192 | TASK->udebug.begin_call = NULL; |
163 | TASK->udebug.begin_call = NULL; |
193 | 164 | ||
194 | IPC_SET_RETVAL(db_call->data, 0); |
165 | IPC_SET_RETVAL(db_call->data, 0); |
195 | ipc_answer(&TASK->answerbox, db_call); |
166 | ipc_answer(&TASK->answerbox, db_call); |
196 | 167 | ||
197 | } else if (TASK->udebug.dt_state == UDEBUG_TS_ACTIVE) { |
168 | } else if (TASK->udebug.dt_state == UDEBUG_TS_ACTIVE) { |
198 | /* |
169 | /* |
199 | * Active debugging session |
170 | * Active debugging session |
200 | */ |
171 | */ |
201 | 172 | ||
202 | if (THREAD->udebug.debug_active && THREAD->udebug.stop) { |
173 | if (THREAD->udebug.debug_active == true && |
- | 174 | THREAD->udebug.go == false) { |
|
203 | /* |
175 | /* |
204 | * Thread was requested to stop - answer go call |
176 | * Thread was requested to stop - answer go call |
205 | */ |
177 | */ |
206 | 178 | ||
207 | /* Make sure nobody takes this call away from us */ |
179 | /* Make sure nobody takes this call away from us */ |
208 | go_call = THREAD->udebug.go_call; |
180 | go_call = THREAD->udebug.go_call; |
209 | THREAD->udebug.go_call = NULL; |
181 | THREAD->udebug.go_call = NULL; |
210 | ASSERT(go_call); |
182 | ASSERT(go_call); |
211 | 183 | ||
212 | IPC_SET_RETVAL(go_call->data, 0); |
184 | IPC_SET_RETVAL(go_call->data, 0); |
213 | IPC_SET_ARG1(go_call->data, UDEBUG_EVENT_STOP); |
185 | IPC_SET_ARG1(go_call->data, UDEBUG_EVENT_STOP); |
214 | 186 | ||
215 | THREAD->udebug.cur_event = UDEBUG_EVENT_STOP; |
187 | THREAD->udebug.cur_event = UDEBUG_EVENT_STOP; |
216 | 188 | ||
217 | ipc_answer(&TASK->answerbox, go_call); |
189 | ipc_answer(&TASK->answerbox, go_call); |
218 | } |
190 | } |
219 | } |
191 | } |
220 | 192 | ||
221 | mutex_unlock(&THREAD->udebug.lock); |
193 | mutex_unlock(&THREAD->udebug.lock); |
222 | mutex_unlock(&TASK->udebug.lock); |
194 | mutex_unlock(&TASK->udebug.lock); |
223 | } |
195 | } |
224 | 196 | ||
225 | /** End of a stoppable section. |
197 | /** End of a stoppable section. |
226 | * |
198 | * |
227 | * This is the point where the thread will block if it is stopped. |
199 | * This is the point where the thread will block if it is stopped. |
228 | * (As, by definition, a stopped thread must not leave its stoppable section). |
200 | * (As, by definition, a stopped thread must not leave its stoppable section). |
229 | */ |
201 | */ |
230 | void udebug_stoppable_end(void) |
202 | void udebug_stoppable_end(void) |
231 | { |
203 | { |
232 | /* Early check for undebugged tasks */ |
204 | /* Early check for undebugged tasks */ |
233 | if (!udebug_thread_precheck()) { |
205 | if (!udebug_thread_precheck()) { |
234 | udebug_int_unlock(); |
- | |
235 | return; |
206 | return; |
236 | } |
207 | } |
237 | 208 | ||
238 | restart: |
209 | restart: |
239 | mutex_lock(&TASK->udebug.lock); |
210 | mutex_lock(&TASK->udebug.lock); |
240 | mutex_lock(&THREAD->udebug.lock); |
211 | mutex_lock(&THREAD->udebug.lock); |
241 | 212 | ||
242 | if (THREAD->udebug.debug_active && |
213 | if (THREAD->udebug.debug_active && |
243 | THREAD->udebug.stop == true) { |
214 | THREAD->udebug.go == false) { |
244 | TASK->udebug.begin_call = NULL; |
215 | TASK->udebug.begin_call = NULL; |
245 | mutex_unlock(&THREAD->udebug.lock); |
216 | mutex_unlock(&THREAD->udebug.lock); |
246 | mutex_unlock(&TASK->udebug.lock); |
217 | mutex_unlock(&TASK->udebug.lock); |
247 | 218 | ||
248 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
219 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
249 | 220 | ||
250 | goto restart; |
221 | goto restart; |
251 | /* must try again - have to lose stoppability atomically */ |
222 | /* Must try again - have to lose stoppability atomically. */ |
252 | } else { |
223 | } else { |
253 | ++TASK->udebug.not_stoppable_count; |
224 | ++TASK->udebug.not_stoppable_count; |
254 | ASSERT(THREAD->udebug.stoppable == true); |
225 | ASSERT(THREAD->udebug.stoppable == true); |
255 | THREAD->udebug.stoppable = false; |
226 | THREAD->udebug.stoppable = false; |
256 | 227 | ||
257 | mutex_unlock(&THREAD->udebug.lock); |
228 | mutex_unlock(&THREAD->udebug.lock); |
258 | mutex_unlock(&TASK->udebug.lock); |
229 | mutex_unlock(&TASK->udebug.lock); |
259 | } |
230 | } |
260 | - | ||
261 | udebug_int_unlock(); |
- | |
262 | } |
231 | } |
263 | 232 | ||
264 | /** Upon being scheduled to run, check if the current thread should stop. |
233 | /** Upon being scheduled to run, check if the current thread should stop. |
265 | * |
234 | * |
266 | * This function is called from clock(). Preemption is enabled. |
235 | * This function is called from clock(). Preemption is enabled. |
267 | * interrupts are disabled, but since this is called after |
236 | * interrupts are disabled, but since this is called after |
268 | * being scheduled-in, we can enable them, if we're careful enough |
237 | * being scheduled-in, we can enable them, if we're careful enough |
269 | * not to allow arbitrary recursion or deadlock with the thread context. |
238 | * not to allow arbitrary recursion or deadlock with the thread context. |
270 | */ |
239 | */ |
271 | void udebug_before_thread_runs(void) |
240 | void udebug_before_thread_runs(void) |
272 | { |
241 | { |
273 | ipl_t ipl; |
242 | ipl_t ipl; |
274 | 243 | ||
275 | return; |
244 | return; |
276 | ASSERT(!PREEMPTION_DISABLED); |
- | |
277 | - | ||
278 | /* |
- | |
279 | * Prevent agains re-entering, such as when preempted inside this |
- | |
280 | * function. |
- | |
281 | */ |
- | |
282 | if (atomic_get(&THREAD->udebug.int_lock) != 0) |
- | |
283 | return; |
- | |
284 | - | ||
285 | udebug_int_lock(); |
- | |
286 | 245 | ||
287 | ipl = interrupts_enable(); |
246 | ipl = interrupts_enable(); |
288 | 247 | ||
289 | /* Now we're free to do whatever we need (lock mutexes, sleep, etc.) */ |
248 | /* Now we're free to do whatever we need (lock mutexes, sleep, etc.) */ |
290 | 249 | ||
291 | /* Check if we're supposed to stop */ |
250 | /* Check if we're supposed to stop */ |
292 | udebug_stoppable_begin(); |
251 | udebug_stoppable_begin(); |
293 | udebug_stoppable_end(); |
252 | udebug_stoppable_end(); |
294 | 253 | ||
295 | interrupts_restore(ipl); |
254 | interrupts_restore(ipl); |
296 | - | ||
297 | udebug_int_unlock(); |
- | |
298 | } |
255 | } |
299 | 256 | ||
300 | /** Syscall event hook. |
257 | /** Syscall event hook. |
301 | * |
258 | * |
302 | * Must be called before and after servicing a system call. This generates |
259 | * Must be called before and after servicing a system call. This generates |
303 | * a SYSCALL_B or SYSCALL_E event, depending on the value of @a end_variant. |
260 | * a SYSCALL_B or SYSCALL_E event, depending on the value of @a end_variant. |
304 | */ |
261 | */ |
305 | void udebug_syscall_event(unative_t a1, unative_t a2, unative_t a3, |
262 | void udebug_syscall_event(unative_t a1, unative_t a2, unative_t a3, |
306 | unative_t a4, unative_t a5, unative_t a6, unative_t id, unative_t rc, |
263 | unative_t a4, unative_t a5, unative_t a6, unative_t id, unative_t rc, |
307 | bool end_variant) |
264 | bool end_variant) |
308 | { |
265 | { |
309 | call_t *call; |
266 | call_t *call; |
310 | udebug_event_t etype; |
267 | udebug_event_t etype; |
311 | 268 | ||
312 | etype = end_variant ? UDEBUG_EVENT_SYSCALL_E : UDEBUG_EVENT_SYSCALL_B; |
269 | etype = end_variant ? UDEBUG_EVENT_SYSCALL_E : UDEBUG_EVENT_SYSCALL_B; |
313 | 270 | ||
314 | udebug_int_lock(); |
- | |
315 | - | ||
316 | /* Early check for undebugged tasks */ |
271 | /* Early check for undebugged tasks */ |
317 | if (!udebug_thread_precheck()) { |
272 | if (!udebug_thread_precheck()) { |
318 | udebug_int_unlock(); |
- | |
319 | return; |
273 | return; |
320 | } |
274 | } |
321 | 275 | ||
322 | mutex_lock(&TASK->udebug.lock); |
276 | mutex_lock(&TASK->udebug.lock); |
323 | mutex_lock(&THREAD->udebug.lock); |
277 | mutex_lock(&THREAD->udebug.lock); |
324 | 278 | ||
325 | /* Must only generate events when in debugging session and have go */ |
279 | /* Must only generate events when in debugging session and is go. */ |
326 | if (THREAD->udebug.debug_active != true || |
280 | if (THREAD->udebug.debug_active != true || |
327 | THREAD->udebug.stop == true || |
281 | THREAD->udebug.go == false || |
328 | (TASK->udebug.evmask & UDEBUG_EVMASK(etype)) == 0) { |
282 | (TASK->udebug.evmask & UDEBUG_EVMASK(etype)) == 0) { |
329 | mutex_unlock(&THREAD->udebug.lock); |
283 | mutex_unlock(&THREAD->udebug.lock); |
330 | mutex_unlock(&TASK->udebug.lock); |
284 | mutex_unlock(&TASK->udebug.lock); |
331 | return; |
285 | return; |
332 | } |
286 | } |
333 | 287 | ||
334 | //printf("udebug_syscall_event\n"); |
288 | //printf("udebug_syscall_event\n"); |
335 | call = THREAD->udebug.go_call; |
289 | call = THREAD->udebug.go_call; |
336 | THREAD->udebug.go_call = NULL; |
290 | THREAD->udebug.go_call = NULL; |
337 | 291 | ||
338 | IPC_SET_RETVAL(call->data, 0); |
292 | IPC_SET_RETVAL(call->data, 0); |
339 | IPC_SET_ARG1(call->data, etype); |
293 | IPC_SET_ARG1(call->data, etype); |
340 | IPC_SET_ARG2(call->data, id); |
294 | IPC_SET_ARG2(call->data, id); |
341 | IPC_SET_ARG3(call->data, rc); |
295 | IPC_SET_ARG3(call->data, rc); |
342 | //printf("udebug_syscall_event/ipc_answer\n"); |
296 | //printf("udebug_syscall_event/ipc_answer\n"); |
343 | 297 | ||
344 | THREAD->udebug.syscall_args[0] = a1; |
298 | THREAD->udebug.syscall_args[0] = a1; |
345 | THREAD->udebug.syscall_args[1] = a2; |
299 | THREAD->udebug.syscall_args[1] = a2; |
346 | THREAD->udebug.syscall_args[2] = a3; |
300 | THREAD->udebug.syscall_args[2] = a3; |
347 | THREAD->udebug.syscall_args[3] = a4; |
301 | THREAD->udebug.syscall_args[3] = a4; |
348 | THREAD->udebug.syscall_args[4] = a5; |
302 | THREAD->udebug.syscall_args[4] = a5; |
349 | THREAD->udebug.syscall_args[5] = a6; |
303 | THREAD->udebug.syscall_args[5] = a6; |
350 | 304 | ||
351 | /* |
305 | /* |
352 | * Make sure udebug.stop is true when going to sleep |
306 | * Make sure udebug.go is false when going to sleep |
353 | * in case we get woken up by DEBUG_END. (At which |
307 | * in case we get woken up by DEBUG_END. (At which |
354 | * point it must be back to the initial true value). |
308 | * point it must be back to the initial true value). |
355 | */ |
309 | */ |
356 | THREAD->udebug.stop = true; |
310 | THREAD->udebug.go = false; |
357 | THREAD->udebug.cur_event = etype; |
311 | THREAD->udebug.cur_event = etype; |
358 | 312 | ||
359 | ipc_answer(&TASK->answerbox, call); |
313 | ipc_answer(&TASK->answerbox, call); |
360 | 314 | ||
361 | mutex_unlock(&THREAD->udebug.lock); |
315 | mutex_unlock(&THREAD->udebug.lock); |
362 | mutex_unlock(&TASK->udebug.lock); |
316 | mutex_unlock(&TASK->udebug.lock); |
363 | 317 | ||
364 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
318 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
365 | - | ||
366 | udebug_int_unlock(); |
- | |
367 | } |
319 | } |
368 | 320 | ||
369 | /** Thread-creation event hook. |
321 | /** Thread-creation event hook. |
370 | * |
322 | * |
371 | * Must be called when a new userspace thread is created in the debugged |
323 | * Must be called when a new userspace thread is created in the debugged |
372 | * task. Generates a THREAD_B event. |
324 | * task. Generates a THREAD_B event. |
373 | * |
325 | * |
374 | * @param t Structure of the thread being created. Not locked, as the |
326 | * @param t Structure of the thread being created. Not locked, as the |
375 | * thread is not executing yet. |
327 | * thread is not executing yet. |
376 | */ |
328 | */ |
377 | void udebug_thread_b_event(struct thread *t) |
329 | void udebug_thread_b_event(struct thread *t) |
378 | { |
330 | { |
379 | call_t *call; |
331 | call_t *call; |
380 | 332 | ||
381 | udebug_int_lock(); |
- | |
382 | - | ||
383 | mutex_lock(&TASK->udebug.lock); |
333 | mutex_lock(&TASK->udebug.lock); |
384 | mutex_lock(&THREAD->udebug.lock); |
334 | mutex_lock(&THREAD->udebug.lock); |
385 | 335 | ||
386 | LOG("udebug_thread_b_event\n"); |
336 | LOG("udebug_thread_b_event\n"); |
387 | LOG("- check state\n"); |
337 | LOG("- check state\n"); |
388 | 338 | ||
389 | /* Must only generate events when in debugging session */ |
339 | /* Must only generate events when in debugging session */ |
390 | if (THREAD->udebug.debug_active != true) { |
340 | if (THREAD->udebug.debug_active != true) { |
391 | LOG("- debug_active: %s, udebug.stop: %s\n", |
341 | LOG("- debug_active: %s, udebug.go: %s\n", |
392 | THREAD->udebug.debug_active ? "yes(+)" : "no(-)", |
342 | THREAD->udebug.debug_active ? "yes(+)" : "no(-)", |
393 | THREAD->udebug.stop ? "yes(-)" : "no(+)"); |
343 | THREAD->udebug.go ? "yes(-)" : "no(+)"); |
394 | mutex_unlock(&THREAD->udebug.lock); |
344 | mutex_unlock(&THREAD->udebug.lock); |
395 | mutex_unlock(&TASK->udebug.lock); |
345 | mutex_unlock(&TASK->udebug.lock); |
396 | return; |
346 | return; |
397 | } |
347 | } |
398 | 348 | ||
399 | LOG("- trigger event\n"); |
349 | LOG("- trigger event\n"); |
400 | 350 | ||
401 | call = THREAD->udebug.go_call; |
351 | call = THREAD->udebug.go_call; |
402 | THREAD->udebug.go_call = NULL; |
352 | THREAD->udebug.go_call = NULL; |
403 | IPC_SET_RETVAL(call->data, 0); |
353 | IPC_SET_RETVAL(call->data, 0); |
404 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_B); |
354 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_B); |
405 | IPC_SET_ARG2(call->data, (unative_t)t); |
355 | IPC_SET_ARG2(call->data, (unative_t)t); |
406 | 356 | ||
407 | /* |
357 | /* |
408 | * Make sure udebug.stop is true when going to sleep |
358 | * Make sure udebug.go is false when going to sleep |
409 | * in case we get woken up by DEBUG_END. (At which |
359 | * in case we get woken up by DEBUG_END. (At which |
410 | * point it must be back to the initial true value). |
360 | * point it must be back to the initial true value). |
411 | */ |
361 | */ |
412 | THREAD->udebug.stop = true; |
362 | THREAD->udebug.go = false; |
413 | THREAD->udebug.cur_event = UDEBUG_EVENT_THREAD_B; |
363 | THREAD->udebug.cur_event = UDEBUG_EVENT_THREAD_B; |
414 | 364 | ||
415 | ipc_answer(&TASK->answerbox, call); |
365 | ipc_answer(&TASK->answerbox, call); |
416 | 366 | ||
417 | mutex_unlock(&THREAD->udebug.lock); |
367 | mutex_unlock(&THREAD->udebug.lock); |
418 | mutex_unlock(&TASK->udebug.lock); |
368 | mutex_unlock(&TASK->udebug.lock); |
419 | 369 | ||
420 | LOG("- sleep\n"); |
370 | LOG("- sleep\n"); |
421 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
371 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
422 | - | ||
423 | udebug_int_unlock(); |
- | |
424 | } |
372 | } |
425 | 373 | ||
426 | /** Thread-termination event hook. |
374 | /** Thread-termination event hook. |
427 | * |
375 | * |
428 | * Must be called when the current thread is terminating. |
376 | * Must be called when the current thread is terminating. |
429 | * Generates a THREAD_E event. |
377 | * Generates a THREAD_E event. |
430 | */ |
378 | */ |
431 | void udebug_thread_e_event(void) |
379 | void udebug_thread_e_event(void) |
432 | { |
380 | { |
433 | call_t *call; |
381 | call_t *call; |
434 | 382 | ||
435 | udebug_int_lock(); |
- | |
436 | - | ||
437 | mutex_lock(&TASK->udebug.lock); |
383 | mutex_lock(&TASK->udebug.lock); |
438 | mutex_lock(&THREAD->udebug.lock); |
384 | mutex_lock(&THREAD->udebug.lock); |
439 | 385 | ||
440 | LOG("udebug_thread_e_event\n"); |
386 | LOG("udebug_thread_e_event\n"); |
441 | LOG("- check state\n"); |
387 | LOG("- check state\n"); |
442 | 388 | ||
443 | /* Must only generate events when in debugging session */ |
389 | /* Must only generate events when in debugging session. */ |
444 | if (THREAD->udebug.debug_active != true) { |
390 | if (THREAD->udebug.debug_active != true) { |
445 | /* printf("- debug_active: %s, udebug.stop: %s\n", |
391 | /* printf("- debug_active: %s, udebug.go: %s\n", |
446 | THREAD->udebug.debug_active ? "yes(+)" : "no(-)", |
392 | THREAD->udebug.debug_active ? "yes(+)" : "no(-)", |
447 | THREAD->udebug.stop ? "yes(-)" : "no(+)");*/ |
393 | THREAD->udebug.go ? "yes(-)" : "no(+)");*/ |
448 | mutex_unlock(&THREAD->udebug.lock); |
394 | mutex_unlock(&THREAD->udebug.lock); |
449 | mutex_unlock(&TASK->udebug.lock); |
395 | mutex_unlock(&TASK->udebug.lock); |
450 | return; |
396 | return; |
451 | } |
397 | } |
452 | 398 | ||
453 | LOG("- trigger event\n"); |
399 | LOG("- trigger event\n"); |
454 | 400 | ||
455 | call = THREAD->udebug.go_call; |
401 | call = THREAD->udebug.go_call; |
456 | THREAD->udebug.go_call = NULL; |
402 | THREAD->udebug.go_call = NULL; |
457 | IPC_SET_RETVAL(call->data, 0); |
403 | IPC_SET_RETVAL(call->data, 0); |
458 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_E); |
404 | IPC_SET_ARG1(call->data, UDEBUG_EVENT_THREAD_E); |
459 | 405 | ||
460 | /* Prevent any further debug activity in thread */ |
406 | /* Prevent any further debug activity in thread. */ |
461 | THREAD->udebug.debug_active = false; |
407 | THREAD->udebug.debug_active = false; |
462 | THREAD->udebug.cur_event = 0; /* none */ |
408 | THREAD->udebug.cur_event = 0; /* none */ |
463 | THREAD->udebug.stop = true; /* set to initial value */ |
409 | THREAD->udebug.go = false; /* set to initial value */ |
464 | 410 | ||
465 | ipc_answer(&TASK->answerbox, call); |
411 | ipc_answer(&TASK->answerbox, call); |
466 | 412 | ||
467 | mutex_unlock(&THREAD->udebug.lock); |
413 | mutex_unlock(&THREAD->udebug.lock); |
468 | mutex_unlock(&TASK->udebug.lock); |
414 | mutex_unlock(&TASK->udebug.lock); |
469 | 415 | ||
470 | /* Leave int_lock enabled */ |
416 | /* |
471 | /* This event does not sleep - debugging has finished in this thread */ |
417 | * This event does not sleep - debugging has finished |
- | 418 | * in this thread. |
|
- | 419 | */ |
|
472 | } |
420 | } |
473 | 421 | ||
474 | static void breakpoint_trap_event(uintptr_t addr, udebug_event_t etype) |
422 | static void breakpoint_trap_event(uintptr_t addr, udebug_event_t etype) |
475 | { |
423 | { |
476 | call_t *call; |
424 | call_t *call; |
477 | 425 | ||
478 | udebug_int_lock(); |
- | |
479 | - | ||
480 | mutex_lock(&TASK->udebug.lock); |
426 | mutex_lock(&TASK->udebug.lock); |
481 | mutex_lock(&THREAD->udebug.lock); |
427 | mutex_lock(&THREAD->udebug.lock); |
482 | 428 | ||
483 | /* Must only generate events when in debugging session and have go */ |
429 | /* Must only generate events when in debugging session and have go. */ |
484 | if (THREAD->udebug.debug_active != true || |
430 | if (THREAD->udebug.debug_active != true || |
485 | THREAD->udebug.stop == true) { |
431 | THREAD->udebug.go == false) { |
486 | mutex_unlock(&THREAD->udebug.lock); |
432 | mutex_unlock(&THREAD->udebug.lock); |
487 | mutex_unlock(&TASK->udebug.lock); |
433 | mutex_unlock(&TASK->udebug.lock); |
488 | udebug_int_unlock(); |
- | |
489 | return; |
434 | return; |
490 | } |
435 | } |
491 | 436 | ||
492 | /* Verify that the event is enabled */ |
437 | /* Verify that the event is enabled */ |
493 | if ((TASK->udebug.evmask & UDEBUG_EVMASK(etype)) == 0) { |
438 | if ((TASK->udebug.evmask & UDEBUG_EVMASK(etype)) == 0) { |
494 | mutex_unlock(&THREAD->udebug.lock); |
439 | mutex_unlock(&THREAD->udebug.lock); |
495 | mutex_unlock(&TASK->udebug.lock); |
440 | mutex_unlock(&TASK->udebug.lock); |
496 | udebug_int_unlock(); |
- | |
497 | return; |
441 | return; |
498 | } |
442 | } |
499 | 443 | ||
500 | printf("udebug_breakpoint/trap_event\n"); |
444 | printf("udebug_breakpoint/trap_event\n"); |
501 | call = THREAD->udebug.go_call; |
445 | call = THREAD->udebug.go_call; |
502 | THREAD->udebug.go_call = NULL; |
446 | THREAD->udebug.go_call = NULL; |
503 | 447 | ||
504 | IPC_SET_RETVAL(call->data, 0); |
448 | IPC_SET_RETVAL(call->data, 0); |
505 | IPC_SET_ARG1(call->data, etype); |
449 | IPC_SET_ARG1(call->data, etype); |
506 | IPC_SET_ARG2(call->data, addr); |
450 | IPC_SET_ARG2(call->data, addr); |
507 | 451 | ||
508 | /* |
452 | /* |
509 | * Make sure udebug.stop is true when going to sleep |
453 | * Make sure udebug.go is false when going to sleep |
510 | * in case we get woken up by DEBUG_END. (At which |
454 | * in case we get woken up by DEBUG_END. (At which |
511 | * point it must be back to the initial true value). |
455 | * point it must be back to the initial true value). |
512 | */ |
456 | */ |
513 | THREAD->udebug.stop = true; |
457 | THREAD->udebug.go = false; |
514 | THREAD->udebug.cur_event = etype; |
458 | THREAD->udebug.cur_event = etype; |
515 | 459 | ||
516 | printf("- send answer\n"); |
460 | printf("- send answer\n"); |
517 | ipc_answer(&TASK->answerbox, call); |
461 | ipc_answer(&TASK->answerbox, call); |
518 | 462 | ||
519 | mutex_unlock(&THREAD->udebug.lock); |
463 | mutex_unlock(&THREAD->udebug.lock); |
520 | mutex_unlock(&TASK->udebug.lock); |
464 | mutex_unlock(&TASK->udebug.lock); |
521 | 465 | ||
522 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
466 | udebug_wait_for_go(&THREAD->udebug.go_wq); |
523 | - | ||
524 | udebug_int_unlock(); |
- | |
525 | } |
467 | } |
526 | 468 | ||
527 | void udebug_breakpoint_event(uintptr_t addr) |
469 | void udebug_breakpoint_event(uintptr_t addr) |
528 | { |
470 | { |
529 | breakpoint_trap_event(addr, UDEBUG_EVENT_BREAKPOINT); |
471 | breakpoint_trap_event(addr, UDEBUG_EVENT_BREAKPOINT); |
530 | } |
472 | } |
531 | 473 | ||
532 | void udebug_trap_event(uintptr_t addr) |
474 | void udebug_trap_event(uintptr_t addr) |
533 | { |
475 | { |
534 | breakpoint_trap_event(addr, UDEBUG_EVENT_TRAP); |
476 | breakpoint_trap_event(addr, UDEBUG_EVENT_TRAP); |
535 | } |
477 | } |
536 | 478 | ||
537 | /** |
479 | /** |
538 | * Terminate task debugging session. |
480 | * Terminate task debugging session. |
539 | * |
481 | * |
540 | * Gracefully terminates the debugging session for a task. If the debugger |
482 | * Gracefully terminates the debugging session for a task. If the debugger |
541 | * is still waiting for events on some threads, it will receive a |
483 | * is still waiting for events on some threads, it will receive a |
542 | * FINISHED event for each of them. |
484 | * FINISHED event for each of them. |
543 | * |
485 | * |
544 | * @param ta Task structure. ta->udebug.lock must be already locked. |
486 | * @param ta Task structure. ta->udebug.lock must be already locked. |
545 | * @return Zero on success or negative error code. |
487 | * @return Zero on success or negative error code. |
546 | */ |
488 | */ |
547 | int udebug_task_cleanup(struct task *ta) |
489 | int udebug_task_cleanup(struct task *ta) |
548 | { |
490 | { |
549 | thread_t *t; |
491 | thread_t *t; |
550 | link_t *cur; |
492 | link_t *cur; |
551 | int flags; |
493 | int flags; |
552 | ipl_t ipl; |
494 | ipl_t ipl; |
553 | 495 | ||
554 | LOG("udebug_task_cleanup()\n"); |
496 | LOG("udebug_task_cleanup()\n"); |
555 | LOG("task %" PRIu64 "\n", ta->taskid); |
497 | LOG("task %" PRIu64 "\n", ta->taskid); |
556 | 498 | ||
557 | udebug_int_lock(); |
- | |
558 | - | ||
559 | if (ta->udebug.dt_state != UDEBUG_TS_BEGINNING && |
499 | if (ta->udebug.dt_state != UDEBUG_TS_BEGINNING && |
560 | ta->udebug.dt_state != UDEBUG_TS_ACTIVE) { |
500 | ta->udebug.dt_state != UDEBUG_TS_ACTIVE) { |
561 | LOG("udebug_task_cleanup(): task not being debugged\n"); |
501 | LOG("udebug_task_cleanup(): task not being debugged\n"); |
562 | return EINVAL; |
502 | return EINVAL; |
563 | } |
503 | } |
564 | 504 | ||
565 | /* Finish debugging of all userspace threads */ |
505 | /* Finish debugging of all userspace threads */ |
566 | for (cur = ta->th_head.next; cur != &ta->th_head; cur = cur->next) { |
506 | for (cur = ta->th_head.next; cur != &ta->th_head; cur = cur->next) { |
567 | t = list_get_instance(cur, thread_t, th_link); |
507 | t = list_get_instance(cur, thread_t, th_link); |
568 | 508 | ||
569 | mutex_lock(&t->udebug.lock); |
509 | mutex_lock(&t->udebug.lock); |
570 | 510 | ||
571 | ipl = interrupts_disable(); |
511 | ipl = interrupts_disable(); |
572 | spinlock_lock(&t->lock); |
512 | spinlock_lock(&t->lock); |
573 | 513 | ||
574 | flags = t->flags; |
514 | flags = t->flags; |
575 | 515 | ||
576 | spinlock_unlock(&t->lock); |
516 | spinlock_unlock(&t->lock); |
577 | interrupts_restore(ipl); |
517 | interrupts_restore(ipl); |
578 | 518 | ||
579 | /* Only process userspace threads */ |
519 | /* Only process userspace threads. */ |
580 | if ((flags & THREAD_FLAG_USPACE) != 0) { |
520 | if ((flags & THREAD_FLAG_USPACE) != 0) { |
581 | /* Prevent any further debug activity in thread */ |
521 | /* Prevent any further debug activity in thread. */ |
582 | t->udebug.debug_active = false; |
522 | t->udebug.debug_active = false; |
583 | t->udebug.cur_event = 0; /* none */ |
523 | t->udebug.cur_event = 0; /* none */ |
584 | 524 | ||
585 | /* Still has go? */ |
525 | /* Is the thread still go? */ |
586 | if (t->udebug.stop == false) { |
526 | if (t->udebug.go == true) { |
587 | /* |
527 | /* |
588 | * Yes, so clear go. As debug_active == false, |
528 | * Yes, so clear go. As debug_active == false, |
589 | * this doesn't affect anything. |
529 | * this doesn't affect anything. |
590 | */ |
530 | */ |
591 | t->udebug.stop = true; |
531 | t->udebug.go = false; |
592 | 532 | ||
593 | /* Answer GO call */ |
533 | /* Answer GO call */ |
594 | LOG("answer GO call with EVENT_FINISHED\n"); |
534 | LOG("answer GO call with EVENT_FINISHED\n"); |
595 | IPC_SET_RETVAL(t->udebug.go_call->data, 0); |
535 | IPC_SET_RETVAL(t->udebug.go_call->data, 0); |
596 | IPC_SET_ARG1(t->udebug.go_call->data, |
536 | IPC_SET_ARG1(t->udebug.go_call->data, |
597 | UDEBUG_EVENT_FINISHED); |
537 | UDEBUG_EVENT_FINISHED); |
598 | 538 | ||
599 | ipc_answer(&ta->answerbox, t->udebug.go_call); |
539 | ipc_answer(&ta->answerbox, t->udebug.go_call); |
600 | t->udebug.go_call = NULL; |
540 | t->udebug.go_call = NULL; |
601 | } else { |
541 | } else { |
602 | /* |
542 | /* |
603 | * Debug_stop is already at initial value. |
543 | * Debug_stop is already at initial value. |
604 | * Yet this means the thread needs waking up. |
544 | * Yet this means the thread needs waking up. |
605 | */ |
545 | */ |
606 | 546 | ||
607 | /* |
547 | /* |
608 | * t's lock must not be held when calling |
548 | * t's lock must not be held when calling |
609 | * waitq_wakeup. |
549 | * waitq_wakeup. |
610 | */ |
550 | */ |
611 | waitq_wakeup(&t->udebug.go_wq, WAKEUP_FIRST); |
551 | waitq_wakeup(&t->udebug.go_wq, WAKEUP_FIRST); |
612 | } |
552 | } |
613 | } |
553 | } |
614 | mutex_unlock(&t->udebug.lock); |
554 | mutex_unlock(&t->udebug.lock); |
615 | } |
555 | } |
616 | 556 | ||
617 | ta->udebug.dt_state = UDEBUG_TS_INACTIVE; |
557 | ta->udebug.dt_state = UDEBUG_TS_INACTIVE; |
618 | ta->udebug.debugger = NULL; |
558 | ta->udebug.debugger = NULL; |
619 | 559 | ||
620 | udebug_int_unlock(); |
- | |
621 | - | ||
622 | return 0; |
560 | return 0; |
623 | } |
561 | } |
624 | 562 | ||
625 | 563 | ||
626 | /** @} |
564 | /** @} |
627 | */ |
565 | */ |
628 | 566 |