Rev 2925 | Rev 3026 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
1 | jermar | 1 | /* |
2071 | jermar | 2 | * Copyright (c) 2001-2004 Jakub Jermar |
1 | jermar | 3 | * All rights reserved. |
4 | * |
||
5 | * Redistribution and use in source and binary forms, with or without |
||
6 | * modification, are permitted provided that the following conditions |
||
7 | * are met: |
||
8 | * |
||
9 | * - Redistributions of source code must retain the above copyright |
||
10 | * notice, this list of conditions and the following disclaimer. |
||
11 | * - Redistributions in binary form must reproduce the above copyright |
||
12 | * notice, this list of conditions and the following disclaimer in the |
||
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 |
||
15 | * derived from this software without specific prior written permission. |
||
16 | * |
||
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 |
||
19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
||
20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
||
21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
||
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 |
||
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 |
||
26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
||
27 | */ |
||
28 | |||
1757 | jermar | 29 | /** @addtogroup genericproc |
1702 | cejka | 30 | * @{ |
31 | */ |
||
32 | |||
1248 | jermar | 33 | /** |
1702 | cejka | 34 | * @file |
1248 | jermar | 35 | * @brief Thread management functions. |
36 | */ |
||
37 | |||
1 | jermar | 38 | #include <proc/scheduler.h> |
39 | #include <proc/thread.h> |
||
40 | #include <proc/task.h> |
||
1078 | jermar | 41 | #include <proc/uarg.h> |
1 | jermar | 42 | #include <mm/frame.h> |
43 | #include <mm/page.h> |
||
44 | #include <arch/asm.h> |
||
2030 | decky | 45 | #include <arch/cycle.h> |
1 | jermar | 46 | #include <arch.h> |
47 | #include <synch/synch.h> |
||
48 | #include <synch/spinlock.h> |
||
49 | #include <synch/waitq.h> |
||
50 | #include <synch/rwlock.h> |
||
51 | #include <cpu.h> |
||
52 | #include <func.h> |
||
53 | #include <context.h> |
||
2502 | jermar | 54 | #include <adt/avl.h> |
788 | jermar | 55 | #include <adt/list.h> |
1 | jermar | 56 | #include <time/clock.h> |
2089 | decky | 57 | #include <time/timeout.h> |
7 | jermar | 58 | #include <config.h> |
59 | #include <arch/interrupt.h> |
||
10 | jermar | 60 | #include <smp/ipi.h> |
76 | jermar | 61 | #include <arch/faddr.h> |
1104 | jermar | 62 | #include <atomic.h> |
195 | vana | 63 | #include <memstr.h> |
777 | palkovsky | 64 | #include <print.h> |
787 | palkovsky | 65 | #include <mm/slab.h> |
66 | #include <debug.h> |
||
1066 | jermar | 67 | #include <main/uinit.h> |
1288 | jermar | 68 | #include <syscall/copy.h> |
69 | #include <errno.h> |
||
2446 | jermar | 70 | #include <console/klog.h> |
7 | jermar | 71 | |
1 | jermar | 72 | |
1571 | jermar | 73 | /** Thread states */ |
74 | char *thread_states[] = { |
||
75 | "Invalid", |
||
76 | "Running", |
||
77 | "Sleeping", |
||
78 | "Ready", |
||
79 | "Entering", |
||
80 | "Exiting", |
||
2451 | jermar | 81 | "Lingering" |
1571 | jermar | 82 | }; |
83 | |||
2502 | jermar | 84 | /** Lock protecting the threads_tree AVL tree. |
2067 | jermar | 85 | * |
86 | * For locking rules, see declaration thereof. |
||
87 | */ |
||
1158 | jermar | 88 | SPINLOCK_INITIALIZE(threads_lock); |
1 | jermar | 89 | |
2925 | svoboda | 90 | /** AVL tree of all threads. |
1636 | jermar | 91 | * |
2502 | jermar | 92 | * When a thread is found in the threads_tree AVL tree, it is guaranteed to |
2067 | jermar | 93 | * exist as long as the threads_lock is held. |
1636 | jermar | 94 | */ |
2502 | jermar | 95 | avltree_t threads_tree; |
1636 | jermar | 96 | |
623 | jermar | 97 | SPINLOCK_INITIALIZE(tidlock); |
2216 | decky | 98 | thread_id_t last_tid = 0; |
1 | jermar | 99 | |
787 | palkovsky | 100 | static slab_cache_t *thread_slab; |
906 | palkovsky | 101 | #ifdef ARCH_HAS_FPU |
102 | slab_cache_t *fpu_context_slab; |
||
103 | #endif |
||
107 | decky | 104 | |
2067 | jermar | 105 | /** Thread wrapper. |
107 | decky | 106 | * |
2067 | jermar | 107 | * This wrapper is provided to ensure that every thread makes a call to |
108 | * thread_exit() when its implementing function returns. |
||
1 | jermar | 109 | * |
413 | jermar | 110 | * interrupts_disable() is assumed. |
107 | decky | 111 | * |
1 | jermar | 112 | */ |
452 | decky | 113 | static void cushion(void) |
1 | jermar | 114 | { |
15 | jermar | 115 | void (*f)(void *) = THREAD->thread_code; |
116 | void *arg = THREAD->thread_arg; |
||
2032 | decky | 117 | THREAD->last_cycle = get_cycle(); |
1 | jermar | 118 | |
2039 | decky | 119 | /* This is where each thread wakes up after its creation */ |
15 | jermar | 120 | spinlock_unlock(&THREAD->lock); |
413 | jermar | 121 | interrupts_enable(); |
1 | jermar | 122 | |
123 | f(arg); |
||
2039 | decky | 124 | |
125 | /* Accumulate accounting to the task */ |
||
126 | ipl_t ipl = interrupts_disable(); |
||
127 | |||
128 | spinlock_lock(&THREAD->lock); |
||
2042 | decky | 129 | if (!THREAD->uncounted) { |
130 | thread_update_accounting(); |
||
131 | uint64_t cycles = THREAD->cycles; |
||
132 | THREAD->cycles = 0; |
||
133 | spinlock_unlock(&THREAD->lock); |
||
134 | |||
135 | spinlock_lock(&TASK->lock); |
||
136 | TASK->cycles += cycles; |
||
137 | spinlock_unlock(&TASK->lock); |
||
138 | } else |
||
139 | spinlock_unlock(&THREAD->lock); |
||
2039 | decky | 140 | |
141 | interrupts_restore(ipl); |
||
142 | |||
1 | jermar | 143 | thread_exit(); |
144 | /* not reached */ |
||
145 | } |
||
146 | |||
787 | palkovsky | 147 | /** Initialization and allocation for thread_t structure */ |
148 | static int thr_constructor(void *obj, int kmflags) |
||
149 | { |
||
1820 | decky | 150 | thread_t *t = (thread_t *) obj; |
107 | decky | 151 | |
787 | palkovsky | 152 | spinlock_initialize(&t->lock, "thread_t_lock"); |
153 | link_initialize(&t->rq_link); |
||
154 | link_initialize(&t->wq_link); |
||
155 | link_initialize(&t->th_link); |
||
1854 | jermar | 156 | |
157 | /* call the architecture-specific part of the constructor */ |
||
158 | thr_constructor_arch(t); |
||
787 | palkovsky | 159 | |
906 | palkovsky | 160 | #ifdef ARCH_HAS_FPU |
2440 | jermar | 161 | #ifdef CONFIG_FPU_LAZY |
906 | palkovsky | 162 | t->saved_fpu_context = NULL; |
2440 | jermar | 163 | #else |
164 | t->saved_fpu_context = slab_alloc(fpu_context_slab, kmflags); |
||
906 | palkovsky | 165 | if (!t->saved_fpu_context) |
166 | return -1; |
||
2440 | jermar | 167 | #endif |
906 | palkovsky | 168 | #endif |
169 | |||
2118 | decky | 170 | t->kstack = (uint8_t *) frame_alloc(STACK_FRAMES, FRAME_KA | kmflags); |
2440 | jermar | 171 | if (!t->kstack) { |
906 | palkovsky | 172 | #ifdef ARCH_HAS_FPU |
173 | if (t->saved_fpu_context) |
||
2440 | jermar | 174 | slab_free(fpu_context_slab, t->saved_fpu_context); |
906 | palkovsky | 175 | #endif |
842 | palkovsky | 176 | return -1; |
906 | palkovsky | 177 | } |
787 | palkovsky | 178 | |
3018 | svoboda | 179 | spinlock_initialize(&t->udebug.lock, "thread_debug_lock"); |
2848 | svoboda | 180 | |
787 | palkovsky | 181 | return 0; |
182 | } |
||
183 | |||
184 | /** Destruction of thread_t object */ |
||
185 | static int thr_destructor(void *obj) |
||
186 | { |
||
1820 | decky | 187 | thread_t *t = (thread_t *) obj; |
787 | palkovsky | 188 | |
1854 | jermar | 189 | /* call the architecture-specific part of the destructor */ |
190 | thr_destructor_arch(t); |
||
191 | |||
1760 | palkovsky | 192 | frame_free(KA2PA(t->kstack)); |
906 | palkovsky | 193 | #ifdef ARCH_HAS_FPU |
194 | if (t->saved_fpu_context) |
||
2440 | jermar | 195 | slab_free(fpu_context_slab, t->saved_fpu_context); |
906 | palkovsky | 196 | #endif |
787 | palkovsky | 197 | return 1; /* One page freed */ |
198 | } |
||
199 | |||
107 | decky | 200 | /** Initialize threads |
201 | * |
||
202 | * Initialize kernel threads support. |
||
203 | * |
||
204 | */ |
||
1 | jermar | 205 | void thread_init(void) |
206 | { |
||
15 | jermar | 207 | THREAD = NULL; |
625 | palkovsky | 208 | atomic_set(&nrdy,0); |
2067 | jermar | 209 | thread_slab = slab_cache_create("thread_slab", sizeof(thread_t), 0, |
2087 | jermar | 210 | thr_constructor, thr_destructor, 0); |
2067 | jermar | 211 | |
906 | palkovsky | 212 | #ifdef ARCH_HAS_FPU |
2067 | jermar | 213 | fpu_context_slab = slab_cache_create("fpu_slab", sizeof(fpu_context_t), |
2087 | jermar | 214 | FPU_CONTEXT_ALIGN, NULL, NULL, 0); |
906 | palkovsky | 215 | #endif |
1158 | jermar | 216 | |
2502 | jermar | 217 | avltree_create(&threads_tree); |
1 | jermar | 218 | } |
219 | |||
107 | decky | 220 | /** Make thread ready |
221 | * |
||
222 | * Switch thread t to the ready state. |
||
223 | * |
||
224 | * @param t Thread to make ready. |
||
225 | * |
||
226 | */ |
||
1 | jermar | 227 | void thread_ready(thread_t *t) |
228 | { |
||
229 | cpu_t *cpu; |
||
230 | runq_t *r; |
||
413 | jermar | 231 | ipl_t ipl; |
625 | palkovsky | 232 | int i, avg; |
1 | jermar | 233 | |
413 | jermar | 234 | ipl = interrupts_disable(); |
1 | jermar | 235 | |
236 | spinlock_lock(&t->lock); |
||
237 | |||
2440 | jermar | 238 | ASSERT(!(t->state == Ready)); |
1086 | palkovsky | 239 | |
2067 | jermar | 240 | i = (t->priority < RQ_COUNT - 1) ? ++t->priority : t->priority; |
1 | jermar | 241 | |
16 | jermar | 242 | cpu = CPU; |
1854 | jermar | 243 | if (t->flags & THREAD_FLAG_WIRED) { |
2268 | jermar | 244 | ASSERT(t->cpu != NULL); |
1 | jermar | 245 | cpu = t->cpu; |
246 | } |
||
1083 | palkovsky | 247 | t->state = Ready; |
1 | jermar | 248 | spinlock_unlock(&t->lock); |
249 | |||
107 | decky | 250 | /* |
1 | jermar | 251 | * Append t to respective ready queue on respective processor. |
252 | */ |
||
253 | r = &cpu->rq[i]; |
||
254 | spinlock_lock(&r->lock); |
||
255 | list_append(&t->rq_link, &r->rq_head); |
||
256 | r->n++; |
||
257 | spinlock_unlock(&r->lock); |
||
258 | |||
475 | jermar | 259 | atomic_inc(&nrdy); |
625 | palkovsky | 260 | avg = atomic_get(&nrdy) / config.cpu_active; |
783 | palkovsky | 261 | atomic_inc(&cpu->nrdy); |
1 | jermar | 262 | |
413 | jermar | 263 | interrupts_restore(ipl); |
1 | jermar | 264 | } |
265 | |||
107 | decky | 266 | /** Create new thread |
267 | * |
||
268 | * Create a new thread. |
||
269 | * |
||
2925 | svoboda | 270 | * @param func Thread's implementing function. |
271 | * @param arg Thread's implementing function argument. |
||
272 | * @param task Task to which the thread belongs. The caller must |
||
273 | * guarantee that the task won't cease to exist during the |
||
274 | * call. The task's lock may not be held. |
||
275 | * @param flags Thread flags. |
||
276 | * @param name Symbolic name. |
||
277 | * @param uncounted Thread's accounting doesn't affect accumulated task |
||
278 | * accounting. |
||
107 | decky | 279 | * |
2925 | svoboda | 280 | * @return New thread's structure on success, NULL on failure. |
107 | decky | 281 | * |
282 | */ |
||
2067 | jermar | 283 | thread_t *thread_create(void (* func)(void *), void *arg, task_t *task, |
2436 | jermar | 284 | int flags, char *name, bool uncounted) |
1 | jermar | 285 | { |
286 | thread_t *t; |
||
822 | palkovsky | 287 | ipl_t ipl; |
288 | |||
787 | palkovsky | 289 | t = (thread_t *) slab_alloc(thread_slab, 0); |
842 | palkovsky | 290 | if (!t) |
291 | return NULL; |
||
1 | jermar | 292 | |
822 | palkovsky | 293 | /* Not needed, but good for debugging */ |
2067 | jermar | 294 | memsetb((uintptr_t) t->kstack, THREAD_STACK_SIZE * 1 << STACK_FRAMES, |
2087 | jermar | 295 | 0); |
822 | palkovsky | 296 | |
297 | ipl = interrupts_disable(); |
||
298 | spinlock_lock(&tidlock); |
||
299 | t->tid = ++last_tid; |
||
300 | spinlock_unlock(&tidlock); |
||
301 | interrupts_restore(ipl); |
||
302 | |||
303 | context_save(&t->saved_context); |
||
2067 | jermar | 304 | context_set(&t->saved_context, FADDR(cushion), (uintptr_t) t->kstack, |
2087 | jermar | 305 | THREAD_STACK_SIZE); |
822 | palkovsky | 306 | |
307 | the_initialize((the_t *) t->kstack); |
||
308 | |||
309 | ipl = interrupts_disable(); |
||
310 | t->saved_context.ipl = interrupts_read(); |
||
311 | interrupts_restore(ipl); |
||
312 | |||
1066 | jermar | 313 | memcpy(t->name, name, THREAD_NAME_BUFLEN); |
314 | |||
822 | palkovsky | 315 | t->thread_code = func; |
316 | t->thread_arg = arg; |
||
317 | t->ticks = -1; |
||
2030 | decky | 318 | t->cycles = 0; |
2042 | decky | 319 | t->uncounted = uncounted; |
822 | palkovsky | 320 | t->priority = -1; /* start in rq[0] */ |
321 | t->cpu = NULL; |
||
1854 | jermar | 322 | t->flags = flags; |
822 | palkovsky | 323 | t->state = Entering; |
324 | t->call_me = NULL; |
||
325 | t->call_me_with = NULL; |
||
326 | |||
327 | timeout_initialize(&t->sleep_timeout); |
||
1502 | jermar | 328 | t->sleep_interruptible = false; |
822 | palkovsky | 329 | t->sleep_queue = NULL; |
330 | t->timeout_pending = 0; |
||
1288 | jermar | 331 | |
332 | t->in_copy_from_uspace = false; |
||
333 | t->in_copy_to_uspace = false; |
||
1579 | jermar | 334 | |
335 | t->interrupted = false; |
||
1571 | jermar | 336 | t->detached = false; |
337 | waitq_initialize(&t->join_wq); |
||
338 | |||
822 | palkovsky | 339 | t->rwlock_holder_type = RWLOCK_NONE; |
210 | decky | 340 | |
822 | palkovsky | 341 | t->task = task; |
342 | |||
860 | decky | 343 | t->fpu_context_exists = 0; |
344 | t->fpu_context_engaged = 0; |
||
1854 | jermar | 345 | |
2502 | jermar | 346 | avltree_node_initialize(&t->threads_tree_node); |
347 | t->threads_tree_node.key = (uintptr_t) t; |
||
2801 | svoboda | 348 | |
2817 | svoboda | 349 | /* Init debugging stuff */ |
3018 | svoboda | 350 | udebug_thread_initialize(&t->udebug); |
2502 | jermar | 351 | |
2067 | jermar | 352 | /* might depend on previous initialization */ |
2799 | svoboda | 353 | thread_create_arch(t); |
2440 | jermar | 354 | |
355 | if (!(flags & THREAD_FLAG_NOATTACH)) |
||
356 | thread_attach(t, task); |
||
357 | |||
358 | return t; |
||
359 | } |
||
360 | |||
2839 | svoboda | 361 | /** Destroy thread structure of an unattached thread. |
362 | * |
||
363 | * Thread t must only have been created and never attached. |
||
364 | */ |
||
365 | void thread_unattached_free(thread_t *t) |
||
366 | { |
||
367 | slab_free(thread_slab, t); |
||
368 | } |
||
369 | |||
370 | |||
2440 | jermar | 371 | /** Destroy thread memory structure |
372 | * |
||
373 | * Detach thread from all queues, cpus etc. and destroy it. |
||
374 | * |
||
375 | * Assume thread->lock is held!! |
||
376 | */ |
||
377 | void thread_destroy(thread_t *t) |
||
378 | { |
||
2451 | jermar | 379 | ASSERT(t->state == Exiting || t->state == Lingering); |
2440 | jermar | 380 | ASSERT(t->task); |
381 | ASSERT(t->cpu); |
||
382 | |||
383 | spinlock_lock(&t->cpu->lock); |
||
384 | if (t->cpu->fpu_owner == t) |
||
385 | t->cpu->fpu_owner = NULL; |
||
386 | spinlock_unlock(&t->cpu->lock); |
||
387 | |||
388 | spinlock_unlock(&t->lock); |
||
389 | |||
390 | spinlock_lock(&threads_lock); |
||
2502 | jermar | 391 | avltree_delete(&threads_tree, &t->threads_tree_node); |
2440 | jermar | 392 | spinlock_unlock(&threads_lock); |
393 | |||
394 | /* |
||
395 | * Detach from the containing task. |
||
396 | */ |
||
397 | spinlock_lock(&t->task->lock); |
||
398 | list_remove(&t->th_link); |
||
399 | spinlock_unlock(&t->task->lock); |
||
2446 | jermar | 400 | |
401 | /* |
||
402 | * t is guaranteed to be the very last thread of its task. |
||
403 | * It is safe to destroy the task. |
||
404 | */ |
||
405 | if (atomic_predec(&t->task->refcount) == 0) |
||
2440 | jermar | 406 | task_destroy(t->task); |
407 | |||
408 | slab_free(thread_slab, t); |
||
409 | } |
||
410 | |||
411 | /** Make the thread visible to the system. |
||
412 | * |
||
413 | * Attach the thread structure to the current task and make it visible in the |
||
2502 | jermar | 414 | * threads_tree. |
2440 | jermar | 415 | * |
416 | * @param t Thread to be attached to the task. |
||
417 | * @param task Task to which the thread is to be attached. |
||
418 | */ |
||
419 | void thread_attach(thread_t *t, task_t *task) |
||
420 | { |
||
421 | ipl_t ipl; |
||
422 | |||
423 | /* |
||
2902 | svoboda | 424 | * Attach to the specified task. |
2440 | jermar | 425 | */ |
2446 | jermar | 426 | ipl = interrupts_disable(); |
2440 | jermar | 427 | spinlock_lock(&task->lock); |
2902 | svoboda | 428 | atomic_inc(&task->refcount); |
429 | /* Must not count kbox thread into lifecount */ |
||
430 | if (t->flags & THREAD_FLAG_USPACE) |
||
431 | atomic_inc(&task->lifecount); |
||
432 | list_append(&t->th_link, &task->th_head); |
||
1579 | jermar | 433 | spinlock_unlock(&task->lock); |
434 | |||
435 | /* |
||
822 | palkovsky | 436 | * Register this thread in the system-wide list. |
437 | */ |
||
2902 | svoboda | 438 | spinlock_lock(&threads_lock); |
439 | avltree_insert(&threads_tree, &t->threads_tree_node); |
||
440 | spinlock_unlock(&threads_lock); |
||
822 | palkovsky | 441 | |
442 | interrupts_restore(ipl); |
||
1 | jermar | 443 | } |
444 | |||
1687 | jermar | 445 | /** Terminate thread. |
107 | decky | 446 | * |
2067 | jermar | 447 | * End current thread execution and switch it to the exiting state. All pending |
448 | * timeouts are executed. |
||
107 | decky | 449 | */ |
1 | jermar | 450 | void thread_exit(void) |
451 | { |
||
413 | jermar | 452 | ipl_t ipl; |
1 | jermar | 453 | |
2902 | svoboda | 454 | if (THREAD->flags & THREAD_FLAG_USPACE) { |
2903 | svoboda | 455 | /* Generate udebug THREAD_E event */ |
456 | udebug_thread_e_event(); |
||
457 | |||
2902 | svoboda | 458 | if (atomic_predec(&TASK->lifecount) == 0) { |
459 | /* |
||
460 | * We are the last userspace thread in the task that |
||
461 | * still has not exited. With the exception of the |
||
462 | * moment the task was created, new userspace threads |
||
463 | * can only be created by threads of the same task. |
||
464 | * We are safe to perform cleanup. |
||
465 | */ |
||
2446 | jermar | 466 | ipc_cleanup(); |
2902 | svoboda | 467 | futex_cleanup(); |
2446 | jermar | 468 | klog_printf("Cleanup of task %llu completed.", |
469 | TASK->taskid); |
||
470 | } |
||
471 | } |
||
472 | |||
1 | jermar | 473 | restart: |
413 | jermar | 474 | ipl = interrupts_disable(); |
15 | jermar | 475 | spinlock_lock(&THREAD->lock); |
2067 | jermar | 476 | if (THREAD->timeout_pending) { |
477 | /* busy waiting for timeouts in progress */ |
||
15 | jermar | 478 | spinlock_unlock(&THREAD->lock); |
413 | jermar | 479 | interrupts_restore(ipl); |
1 | jermar | 480 | goto restart; |
481 | } |
||
2446 | jermar | 482 | |
15 | jermar | 483 | THREAD->state = Exiting; |
484 | spinlock_unlock(&THREAD->lock); |
||
1 | jermar | 485 | scheduler(); |
1595 | palkovsky | 486 | |
487 | /* Not reached */ |
||
488 | while (1) |
||
489 | ; |
||
1 | jermar | 490 | } |
491 | |||
107 | decky | 492 | |
493 | /** Thread sleep |
||
494 | * |
||
495 | * Suspend execution of the current thread. |
||
496 | * |
||
497 | * @param sec Number of seconds to sleep. |
||
498 | * |
||
499 | */ |
||
1780 | jermar | 500 | void thread_sleep(uint32_t sec) |
1 | jermar | 501 | { |
2067 | jermar | 502 | thread_usleep(sec * 1000000); |
1 | jermar | 503 | } |
107 | decky | 504 | |
1571 | jermar | 505 | /** Wait for another thread to exit. |
506 | * |
||
507 | * @param t Thread to join on exit. |
||
508 | * @param usec Timeout in microseconds. |
||
509 | * @param flags Mode of operation. |
||
510 | * |
||
511 | * @return An error code from errno.h or an error code from synch.h. |
||
512 | */ |
||
1780 | jermar | 513 | int thread_join_timeout(thread_t *t, uint32_t usec, int flags) |
1571 | jermar | 514 | { |
515 | ipl_t ipl; |
||
516 | int rc; |
||
517 | |||
518 | if (t == THREAD) |
||
519 | return EINVAL; |
||
520 | |||
521 | /* |
||
522 | * Since thread join can only be called once on an undetached thread, |
||
523 | * the thread pointer is guaranteed to be still valid. |
||
524 | */ |
||
525 | |||
526 | ipl = interrupts_disable(); |
||
527 | spinlock_lock(&t->lock); |
||
528 | ASSERT(!t->detached); |
||
529 | spinlock_unlock(&t->lock); |
||
1687 | jermar | 530 | interrupts_restore(ipl); |
1571 | jermar | 531 | |
1687 | jermar | 532 | rc = waitq_sleep_timeout(&t->join_wq, usec, flags); |
1571 | jermar | 533 | |
534 | return rc; |
||
535 | } |
||
536 | |||
537 | /** Detach thread. |
||
538 | * |
||
2451 | jermar | 539 | * Mark the thread as detached, if the thread is already in the Lingering |
540 | * state, deallocate its resources. |
||
1571 | jermar | 541 | * |
542 | * @param t Thread to be detached. |
||
543 | */ |
||
544 | void thread_detach(thread_t *t) |
||
545 | { |
||
546 | ipl_t ipl; |
||
547 | |||
548 | /* |
||
2183 | jermar | 549 | * Since the thread is expected not to be already detached, |
1571 | jermar | 550 | * pointer to it must be still valid. |
551 | */ |
||
552 | ipl = interrupts_disable(); |
||
553 | spinlock_lock(&t->lock); |
||
554 | ASSERT(!t->detached); |
||
2451 | jermar | 555 | if (t->state == Lingering) { |
1571 | jermar | 556 | thread_destroy(t); /* unlocks &t->lock */ |
557 | interrupts_restore(ipl); |
||
558 | return; |
||
559 | } else { |
||
560 | t->detached = true; |
||
561 | } |
||
562 | spinlock_unlock(&t->lock); |
||
563 | interrupts_restore(ipl); |
||
564 | } |
||
565 | |||
107 | decky | 566 | /** Thread usleep |
567 | * |
||
568 | * Suspend execution of the current thread. |
||
569 | * |
||
570 | * @param usec Number of microseconds to sleep. |
||
571 | * |
||
572 | */ |
||
1780 | jermar | 573 | void thread_usleep(uint32_t usec) |
1 | jermar | 574 | { |
575 | waitq_t wq; |
||
576 | |||
577 | waitq_initialize(&wq); |
||
578 | |||
1502 | jermar | 579 | (void) waitq_sleep_timeout(&wq, usec, SYNCH_FLAGS_NON_BLOCKING); |
1 | jermar | 580 | } |
581 | |||
107 | decky | 582 | /** Register thread out-of-context invocation |
583 | * |
||
584 | * Register a function and its argument to be executed |
||
585 | * on next context switch to the current thread. |
||
586 | * |
||
587 | * @param call_me Out-of-context function. |
||
588 | * @param call_me_with Out-of-context function argument. |
||
589 | * |
||
590 | */ |
||
1 | jermar | 591 | void thread_register_call_me(void (* call_me)(void *), void *call_me_with) |
592 | { |
||
413 | jermar | 593 | ipl_t ipl; |
1 | jermar | 594 | |
413 | jermar | 595 | ipl = interrupts_disable(); |
15 | jermar | 596 | spinlock_lock(&THREAD->lock); |
597 | THREAD->call_me = call_me; |
||
598 | THREAD->call_me_with = call_me_with; |
||
599 | spinlock_unlock(&THREAD->lock); |
||
413 | jermar | 600 | interrupts_restore(ipl); |
1 | jermar | 601 | } |
777 | palkovsky | 602 | |
2504 | jermar | 603 | static bool thread_walker(avltree_node_t *node, void *arg) |
2502 | jermar | 604 | { |
605 | thread_t *t; |
||
606 | |||
607 | t = avltree_get_instance(node, thread_t, threads_tree_node); |
||
608 | |||
609 | uint64_t cycles; |
||
610 | char suffix; |
||
611 | order(t->cycles, &cycles, &suffix); |
||
2712 | decky | 612 | |
613 | if (sizeof(void *) == 4) |
||
614 | printf("%-6llu %-10s %#10zx %-8s %#10zx %-3ld %#10zx %#10zx %9llu%c ", |
||
615 | t->tid, t->name, t, thread_states[t->state], t->task, |
||
616 | t->task->context, t->thread_code, t->kstack, cycles, suffix); |
||
617 | else |
||
618 | printf("%-6llu %-10s %#18zx %-8s %#18zx %-3ld %#18zx %#18zx %9llu%c ", |
||
619 | t->tid, t->name, t, thread_states[t->state], t->task, |
||
620 | t->task->context, t->thread_code, t->kstack, cycles, suffix); |
||
2502 | jermar | 621 | |
622 | if (t->cpu) |
||
623 | printf("%-4zd", t->cpu->id); |
||
624 | else |
||
625 | printf("none"); |
||
626 | |||
2712 | decky | 627 | if (t->state == Sleeping) { |
628 | if (sizeof(uintptr_t) == 4) |
||
629 | printf(" %#10zx", t->sleep_queue); |
||
630 | else |
||
631 | printf(" %#18zx", t->sleep_queue); |
||
632 | } |
||
2502 | jermar | 633 | |
634 | printf("\n"); |
||
2504 | jermar | 635 | |
636 | return true; |
||
2502 | jermar | 637 | } |
638 | |||
777 | palkovsky | 639 | /** Print list of threads debug info */ |
640 | void thread_print_list(void) |
||
641 | { |
||
642 | ipl_t ipl; |
||
643 | |||
644 | /* Messing with thread structures, avoid deadlock */ |
||
645 | ipl = interrupts_disable(); |
||
646 | spinlock_lock(&threads_lock); |
||
2030 | decky | 647 | |
2712 | decky | 648 | if (sizeof(uintptr_t) == 4) { |
649 | printf("tid name address state task " |
||
650 | "ctx code stack cycles cpu " |
||
651 | "waitqueue\n"); |
||
652 | printf("------ ---------- ---------- -------- ---------- " |
||
653 | "--- ---------- ---------- ---------- ---- " |
||
654 | "----------\n"); |
||
655 | } else { |
||
656 | printf("tid name address state task " |
||
657 | "ctx code stack cycles cpu " |
||
658 | "waitqueue\n"); |
||
659 | printf("------ ---------- ------------------ -------- ------------------ " |
||
660 | "--- ------------------ ------------------ ---------- ---- " |
||
661 | "------------------\n"); |
||
662 | } |
||
777 | palkovsky | 663 | |
2504 | jermar | 664 | avltree_walk(&threads_tree, thread_walker, NULL); |
1158 | jermar | 665 | |
777 | palkovsky | 666 | spinlock_unlock(&threads_lock); |
1060 | palkovsky | 667 | interrupts_restore(ipl); |
777 | palkovsky | 668 | } |
1066 | jermar | 669 | |
1158 | jermar | 670 | /** Check whether thread exists. |
671 | * |
||
672 | * Note that threads_lock must be already held and |
||
673 | * interrupts must be already disabled. |
||
674 | * |
||
675 | * @param t Pointer to thread. |
||
676 | * |
||
677 | * @return True if thread t is known to the system, false otherwise. |
||
678 | */ |
||
679 | bool thread_exists(thread_t *t) |
||
680 | { |
||
2502 | jermar | 681 | avltree_node_t *node; |
682 | |||
683 | node = avltree_search(&threads_tree, (avltree_key_t) ((uintptr_t) t)); |
||
1158 | jermar | 684 | |
2502 | jermar | 685 | return node != NULL; |
1158 | jermar | 686 | } |
687 | |||
2030 | decky | 688 | |
689 | /** Update accounting of current thread. |
||
690 | * |
||
691 | * Note that thread_lock on THREAD must be already held and |
||
692 | * interrupts must be already disabled. |
||
693 | * |
||
694 | */ |
||
695 | void thread_update_accounting(void) |
||
696 | { |
||
697 | uint64_t time = get_cycle(); |
||
698 | THREAD->cycles += time - THREAD->last_cycle; |
||
699 | THREAD->last_cycle = time; |
||
700 | } |
||
701 | |||
1066 | jermar | 702 | /** Process syscall to create new thread. |
703 | * |
||
704 | */ |
||
2436 | jermar | 705 | unative_t sys_thread_create(uspace_arg_t *uspace_uarg, char *uspace_name, |
706 | thread_id_t *uspace_thread_id) |
||
1066 | jermar | 707 | { |
1210 | vana | 708 | thread_t *t; |
709 | char namebuf[THREAD_NAME_BUFLEN]; |
||
1103 | jermar | 710 | uspace_arg_t *kernel_uarg; |
1288 | jermar | 711 | int rc; |
1066 | jermar | 712 | |
1288 | jermar | 713 | rc = copy_from_uspace(namebuf, uspace_name, THREAD_NAME_BUFLEN); |
714 | if (rc != 0) |
||
1780 | jermar | 715 | return (unative_t) rc; |
1066 | jermar | 716 | |
2470 | jermar | 717 | /* |
718 | * In case of failure, kernel_uarg will be deallocated in this function. |
||
719 | * In case of success, kernel_uarg will be freed in uinit(). |
||
720 | */ |
||
721 | kernel_uarg = (uspace_arg_t *) malloc(sizeof(uspace_arg_t), 0); |
||
722 | |||
1288 | jermar | 723 | rc = copy_from_uspace(kernel_uarg, uspace_uarg, sizeof(uspace_arg_t)); |
724 | if (rc != 0) { |
||
725 | free(kernel_uarg); |
||
1780 | jermar | 726 | return (unative_t) rc; |
1288 | jermar | 727 | } |
1078 | jermar | 728 | |
2440 | jermar | 729 | t = thread_create(uinit, kernel_uarg, TASK, |
730 | THREAD_FLAG_USPACE | THREAD_FLAG_NOATTACH, namebuf, false); |
||
2087 | jermar | 731 | if (t) { |
2440 | jermar | 732 | if (uspace_thread_id != NULL) { |
733 | int rc; |
||
734 | |||
735 | rc = copy_to_uspace(uspace_thread_id, &t->tid, |
||
736 | sizeof(t->tid)); |
||
737 | if (rc != 0) { |
||
738 | /* |
||
739 | * We have encountered a failure, but the thread |
||
740 | * has already been created. We need to undo its |
||
741 | * creation now. |
||
742 | */ |
||
743 | |||
744 | /* |
||
2446 | jermar | 745 | * The new thread structure is initialized, but |
746 | * is still not visible to the system. |
||
2440 | jermar | 747 | * We can safely deallocate it. |
748 | */ |
||
749 | slab_free(thread_slab, t); |
||
750 | free(kernel_uarg); |
||
751 | |||
752 | return (unative_t) rc; |
||
753 | } |
||
754 | } |
||
755 | thread_attach(t, TASK); |
||
1210 | vana | 756 | thread_ready(t); |
2440 | jermar | 757 | |
2903 | svoboda | 758 | /* Generate udebug THREAD_B event */ |
759 | udebug_thread_b_event(t); |
||
2867 | svoboda | 760 | |
2440 | jermar | 761 | return 0; |
2216 | decky | 762 | } else |
1078 | jermar | 763 | free(kernel_uarg); |
1066 | jermar | 764 | |
1780 | jermar | 765 | return (unative_t) ENOMEM; |
1066 | jermar | 766 | } |
767 | |||
768 | /** Process syscall to terminate thread. |
||
769 | * |
||
770 | */ |
||
1780 | jermar | 771 | unative_t sys_thread_exit(int uspace_status) |
1066 | jermar | 772 | { |
1210 | vana | 773 | thread_exit(); |
774 | /* Unreachable */ |
||
775 | return 0; |
||
1066 | jermar | 776 | } |
1702 | cejka | 777 | |
2187 | decky | 778 | /** Syscall for getting TID. |
779 | * |
||
2216 | decky | 780 | * @param uspace_thread_id Userspace address of 8-byte buffer where to store |
781 | * current thread ID. |
||
782 | * |
||
783 | * @return 0 on success or an error code from @ref errno.h. |
||
2187 | decky | 784 | */ |
2216 | decky | 785 | unative_t sys_thread_get_id(thread_id_t *uspace_thread_id) |
2187 | decky | 786 | { |
787 | /* |
||
788 | * No need to acquire lock on THREAD because tid |
||
789 | * remains constant for the lifespan of the thread. |
||
790 | */ |
||
2216 | decky | 791 | return (unative_t) copy_to_uspace(uspace_thread_id, &THREAD->tid, |
792 | sizeof(THREAD->tid)); |
||
2187 | decky | 793 | } |
794 | |||
1757 | jermar | 795 | /** @} |
1702 | cejka | 796 | */ |