aboutsummaryrefslogtreecommitdiff
path: root/kern/sched_prim.h
diff options
context:
space:
mode:
authorPasha <pasha@member.fsf.org>2024-02-20 18:49:50 +0000
committerPasha <pasha@member.fsf.org>2024-02-20 18:49:50 +0000
commit5e0b8d508ed51004bd836384293be00950ee62c9 (patch)
treee3f16b1aa8b7177032ce3ec429fbad2b1d92a876 /kern/sched_prim.h
downloadgnumach-riscv-5e0b8d508ed51004bd836384293be00950ee62c9.tar.gz
gnumach-riscv-5e0b8d508ed51004bd836384293be00950ee62c9.tar.bz2
init gnumach copy
Diffstat (limited to 'kern/sched_prim.h')
-rw-r--r--kern/sched_prim.h189
1 files changed, 189 insertions, 0 deletions
diff --git a/kern/sched_prim.h b/kern/sched_prim.h
new file mode 100644
index 0000000..c250b22
--- /dev/null
+++ b/kern/sched_prim.h
@@ -0,0 +1,189 @@
+/*
+ * Mach Operating System
+ * Copyright (c) 1992,1991,1990,1989,1988,1987 Carnegie Mellon University
+ * All Rights Reserved.
+ *
+ * Permission to use, copy, modify and distribute this software and its
+ * documentation is hereby granted, provided that both the copyright
+ * notice and this permission notice appear in all copies of the
+ * software, derivative works or modified versions, and any portions
+ * thereof, and that both notices appear in supporting documentation.
+ *
+ * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
+ * CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
+ * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
+ *
+ * Carnegie Mellon requests users of this software to return to
+ *
+ * Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
+ * School of Computer Science
+ * Carnegie Mellon University
+ * Pittsburgh PA 15213-3890
+ *
+ * any improvements or extensions that they make and grant Carnegie Mellon
+ * the rights to redistribute these changes.
+ */
+/*
+ * File: sched_prim.h
+ * Author: David Golub
+ *
+ * Scheduling primitive definitions file
+ *
+ */
+
+#ifndef _KERN_SCHED_PRIM_H_
+#define _KERN_SCHED_PRIM_H_
+
+#include <mach/boolean.h>
+#include <mach/message.h> /* for mach_msg_timeout_t */
+#include <kern/lock.h>
+#include <kern/kern_types.h> /* for thread_t */
+
+/*
+ * Possible results of assert_wait - returned in
+ * current_thread()->wait_result.
+ */
+#define THREAD_AWAKENED 0 /* normal wakeup */
+#define THREAD_TIMED_OUT 1 /* timeout expired */
+#define THREAD_INTERRUPTED 2 /* interrupted by clear_wait */
+#define THREAD_RESTART 3 /* restart operation entirely */
+
+typedef void *event_t; /* wait event */
+
+typedef void (*continuation_t)(void); /* continuation */
+
+#define thread_no_continuation ((continuation_t) 0) /* no continuation */
+
+/*
+ * Exported interface to sched_prim.c.
+ */
+
+extern void sched_init(void);
+
+extern void assert_wait(
+ event_t event,
+ boolean_t interruptible);
+extern void clear_wait(
+ thread_t thread,
+ int result,
+ boolean_t interrupt_only);
+extern void thread_sleep(
+ event_t event,
+ simple_lock_t lock,
+ boolean_t interruptible);
+extern void thread_wakeup(void); /* for function pointers */
+extern boolean_t thread_wakeup_prim(
+ event_t event,
+ boolean_t one_thread,
+ int result);
+extern boolean_t thread_invoke(
+ thread_t old_thread,
+ continuation_t continuation,
+ thread_t new_thread);
+extern void thread_block(
+ continuation_t continuation);
+extern void thread_run(
+ continuation_t continuation,
+ thread_t new_thread);
+extern void thread_set_timeout(
+ int t);
+extern void thread_setrun(
+ thread_t thread,
+ boolean_t may_preempt);
+extern void thread_dispatch(
+ thread_t thread);
+extern void thread_continue(
+ thread_t old_thread);
+extern void thread_go(
+ thread_t thread);
+extern void thread_will_wait(
+ thread_t thread);
+extern void thread_will_wait_with_timeout(
+ thread_t thread,
+ mach_msg_timeout_t msecs);
+extern boolean_t thread_handoff(
+ thread_t old_thread,
+ continuation_t continuation,
+ thread_t new_thread);
+extern void recompute_priorities(void *param);
+extern void update_priority(
+ thread_t thread);
+extern void compute_my_priority(
+ thread_t thread);
+extern void thread_bind(
+ thread_t thread,
+ processor_t processor);
+extern void compute_priority(
+ thread_t thread,
+ boolean_t resched);
+extern void thread_timeout_setup(
+ thread_t thread);
+
+/*
+ * Routines defined as macros
+ */
+
+#define thread_wakeup(x) \
+ thread_wakeup_prim((x), FALSE, THREAD_AWAKENED)
+#define thread_wakeup_with_result(x, z) \
+ thread_wakeup_prim((x), FALSE, (z))
+#define thread_wakeup_one(x) \
+ thread_wakeup_prim((x), TRUE, THREAD_AWAKENED)
+
+/*
+ * Machine-dependent code must define these functions.
+ */
+
+extern void thread_bootstrap_return(void) __attribute__((noreturn));
+extern void thread_exception_return(void) __attribute__((noreturn));
+extern void __attribute__((__noreturn__)) thread_syscall_return(kern_return_t);
+
+extern thread_t switch_context(
+ thread_t old_thread,
+ continuation_t continuation,
+ thread_t new_thread);
+extern void stack_handoff(
+ thread_t old_thread,
+ thread_t new_thread);
+
+/*
+ * These functions are either defined in kern/thread.c
+ * via machine-dependent stack_attach and stack_detach functions,
+ * or are defined directly by machine-dependent code.
+ */
+
+extern kern_return_t stack_alloc(
+ thread_t thread,
+ void (*resume)(thread_t));
+extern boolean_t stack_alloc_try(
+ thread_t thread,
+ void (*resume)(thread_t));
+extern void stack_free(
+ thread_t thread);
+
+/*
+ * Convert a timeout in milliseconds (mach_msg_timeout_t)
+ * to a timeout in ticks (for use by set_timeout).
+ * This conversion rounds UP so that small timeouts
+ * at least wait for one tick instead of not waiting at all.
+ */
+
+#define convert_ipc_timeout_to_ticks(millis) \
+ (((millis) * hz + 999) / 1000)
+
+void set_pri(thread_t th, int pri, boolean_t resched);
+void do_thread_scan(void);
+thread_t choose_pset_thread(processor_t myprocessor, processor_set_t pset);
+
+#if DEBUG
+#include <kern/sched.h> /* for run_queue_t */
+
+void checkrq(run_queue_t rq, const char *msg);
+void thread_check(thread_t th, run_queue_t rq);
+#endif /* DEBUG */
+
+extern void idle_thread(void) __attribute__((noreturn));
+extern void sched_thread(void);
+extern int stuck_count;
+
+#endif /* _KERN_SCHED_PRIM_H_ */