uthread_exit() replaced with uthread_destroy()
[akaros.git] / user / parlib / include / uthread.h
1 #ifndef _UTHREAD_H
2 #define _UTHREAD_H
3
4 #include <vcore.h>
5 #include <ros/syscall.h>
6
7 #define UTHREAD_DONT_MIGRATE            0x001 /* don't move to another vcore */
8
9 /* Thread States */
10 #define UT_CREATED      1
11 #define UT_RUNNABLE     2
12 #define UT_RUNNING      3
13 #define UT_BLOCKED      4
14 #define UT_DYING        5
15
16 /* Bare necessities of a user thread.  2LSs should allocate a bigger struct and
17  * cast their threads to uthreads when talking with vcore code.  Vcore/default
18  * 2LS code won't touch udata or beyond. */
19 struct uthread {
20         struct user_trapframe utf;
21         struct ancillary_state as;
22         void *tls_desc;
23         int flags;
24         struct syscall *sysc;   /* syscall we're blocking on, if any */
25         int state;
26 };
27 extern __thread struct uthread *current_uthread;
28
29 /* 2L-Scheduler operations.  Can be 0.  Examples in pthread.c. */
30 struct schedule_ops {
31         /* Functions supporting thread ops */
32         struct uthread *(*sched_init)(void);
33         void (*sched_entry)(void);
34         struct uthread *(*thread_create)(void (*func)(void), void *);
35         void (*thread_runnable)(struct uthread *);
36         void (*thread_yield)(struct uthread *);
37         void (*thread_destroy)(struct uthread *);
38         void (*thread_blockon_sysc)(struct syscall *);
39         /* Functions event handling wants */
40         void (*preempt_pending)(void);
41         void (*spawn_thread)(uintptr_t pc_start, void *data);   /* don't run yet */
42 };
43 extern struct schedule_ops *sched_ops;
44
45 /* Functions to make/manage uthreads.  Can be called by functions such as
46  * pthread_create(), which can wrap these with their own stuff (like attrs,
47  * retvals, etc). */
48
49 /* Creates a uthread.  Will pass udata to sched_ops's thread_create.  Func is
50  * what gets run, and if you want args, wrap it (like pthread) */
51 struct uthread *uthread_create(void (*func)(void), void *udata);
52 void uthread_runnable(struct uthread *uthread);
53 void uthread_yield(bool save_state);
54 void uthread_destroy(struct uthread *uthread);
55 /* Block the calling uthread on sysc until it makes progress or is done */
56 void ros_syscall_blockon(struct syscall *sysc);
57
58 /* Utility function.  Event code also calls this. */
59 bool check_preempt_pending(uint32_t vcoreid);
60
61 bool register_evq(struct syscall *sysc, struct event_queue *ev_q);
62 void deregister_evq(struct syscall *sysc);
63
64 /* Helpers, which sched_entry() can call */
65 void run_current_uthread(void);
66 void run_uthread(struct uthread *uthread);
67
68 #endif /* _UTHREAD_H */