Return to sched_prim.h CVS log

Up to [GnuMach] / OSKit-Mach / kern

Annotation of OSKit-Mach/kern/sched_prim.h, revision 1.1

1.1     ! root        1: /* 
        !             2:  * Mach Operating System
        !             3:  * Copyright (c) 1992,1991,1990,1989,1988,1987 Carnegie Mellon University
        !             4:  * All Rights Reserved.
        !             5:  * 
        !             6:  * Permission to use, copy, modify and distribute this software and its
        !             7:  * documentation is hereby granted, provided that both the copyright
        !             8:  * notice and this permission notice appear in all copies of the
        !             9:  * software, derivative works or modified versions, and any portions
        !            10:  * thereof, and that both notices appear in supporting documentation.
        !            11:  * 
        !            12:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
        !            13:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
        !            14:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
        !            15:  * 
        !            16:  * Carnegie Mellon requests users of this software to return to
        !            17:  * 
        !            18:  *  Software Distribution Coordinator  or  [email protected]
        !            19:  *  School of Computer Science
        !            20:  *  Carnegie Mellon University
        !            21:  *  Pittsburgh PA 15213-3890
        !            22:  * 
        !            23:  * any improvements or extensions that they make and grant Carnegie Mellon
        !            24:  * the rights to redistribute these changes.
        !            25:  */
        !            26: /*
        !            27:  *     File:   sched_prim.h
        !            28:  *     Author: David Golub
        !            29:  *
        !            30:  *     Scheduling primitive definitions file
        !            31:  *
        !            32:  */
        !            33: 
        !            34: #ifndef        _KERN_SCHED_PRIM_H_
        !            35: #define _KERN_SCHED_PRIM_H_
        !            36: 
        !            37: #include <mach/boolean.h>
        !            38: #include <mach/message.h>      /* for mach_msg_timeout_t */
        !            39: #include <kern/lock.h>
        !            40: #include <kern/kern_types.h>   /* for thread_t */
        !            41: 
        !            42: /*
        !            43:  *     Possible results of assert_wait - returned in
        !            44:  *     current_thread()->wait_result.
        !            45:  */
        !            46: #define THREAD_AWAKENED                0               /* normal wakeup */
        !            47: #define THREAD_TIMED_OUT       1               /* timeout expired */
        !            48: #define THREAD_INTERRUPTED     2               /* interrupted by clear_wait */
        !            49: #define THREAD_RESTART         3               /* restart operation entirely */
        !            50: 
        !            51: typedef        void    *event_t;                       /* wait event */
        !            52: 
        !            53: typedef        void    (*continuation_t)(void);        /* continuation */
        !            54: 
        !            55: /*
        !            56:  *     Exported interface to sched_prim.c.
        !            57:  */
        !            58: 
        !            59: extern void    sched_init(void);
        !            60: 
        !            61: extern void    assert_wait(
        !            62:        event_t         event,
        !            63:        boolean_t       interruptible);
        !            64: extern void    clear_wait(
        !            65:        thread_t        thread,
        !            66:        int             result,
        !            67:        boolean_t       interrupt_only);
        !            68: extern void    thread_sleep(
        !            69:        event_t         event,
        !            70:        simple_lock_t   lock,
        !            71:        boolean_t       interruptible);
        !            72: extern void    thread_wakeup();                /* for function pointers */
        !            73: extern void    thread_wakeup_prim(
        !            74:        event_t         event,
        !            75:        boolean_t       one_thread,
        !            76:        int             result);
        !            77: extern boolean_t thread_invoke(
        !            78:        thread_t        old_thread,
        !            79:        continuation_t  continuation,
        !            80:        thread_t        new_thread);
        !            81: extern void    thread_block(
        !            82:        continuation_t  continuation);
        !            83: extern void    thread_run(
        !            84:        continuation_t  continuation,
        !            85:        thread_t        new_thread);
        !            86: extern void    thread_set_timeout(
        !            87:        int             t);
        !            88: extern void    thread_setrun(
        !            89:        thread_t        thread,
        !            90:        boolean_t       may_preempt);
        !            91: extern void    thread_dispatch(
        !            92:        thread_t        thread);
        !            93: extern void    thread_continue(
        !            94:        thread_t        old_thread);
        !            95: extern void    thread_go(
        !            96:        thread_t        thread);
        !            97: extern void    thread_will_wait(
        !            98:        thread_t        thread);
        !            99: extern void    thread_will_wait_with_timeout(
        !           100:        thread_t        thread,
        !           101:        mach_msg_timeout_t msecs);
        !           102: extern boolean_t thread_handoff(
        !           103:        thread_t        old_thread,
        !           104:        continuation_t  continuation,
        !           105:        thread_t        new_thread);
        !           106: extern void    recompute_priorities();
        !           107: 
        !           108: /*
        !           109:  *     Routines defined as macros
        !           110:  */
        !           111: 
        !           112: #define thread_wakeup(x)                                               \
        !           113:                thread_wakeup_prim((x), FALSE, THREAD_AWAKENED)
        !           114: #define thread_wakeup_with_result(x, z)                                        \
        !           115:                thread_wakeup_prim((x), FALSE, (z))
        !           116: #define thread_wakeup_one(x)                                           \
        !           117:                thread_wakeup_prim((x), TRUE, THREAD_AWAKENED)
        !           118: 
        !           119: /*
        !           120:  *     Machine-dependent code must define these functions.
        !           121:  */
        !           122: 
        !           123: extern void    thread_bootstrap_return(void);
        !           124: extern void    thread_exception_return(void);
        !           125: #ifdef __GNUC__
        !           126: extern void    __volatile__ thread_syscall_return(kern_return_t);
        !           127: #else
        !           128: extern void    thread_syscall_return(kern_return_t);
        !           129: #endif
        !           130: extern thread_t        switch_context(
        !           131:        thread_t        old_thread,
        !           132:        continuation_t  continuation,
        !           133:        thread_t        new_thread);
        !           134: extern void    stack_handoff(
        !           135:        thread_t        old_thread,
        !           136:        thread_t        new_thread);
        !           137: 
        !           138: /*
        !           139:  *     These functions are either defined in kern/thread.c
        !           140:  *     via machine-dependent stack_attach and stack_detach functions,
        !           141:  *     or are defined directly by machine-dependent code.
        !           142:  */
        !           143: 
        !           144: extern void    stack_alloc(
        !           145:        thread_t        thread,
        !           146:        void            (*resume)(thread_t));
        !           147: extern boolean_t stack_alloc_try(
        !           148:        thread_t        thread,
        !           149:        void            (*resume)(thread_t));
        !           150: extern void    stack_free(
        !           151:        thread_t        thread);
        !           152: 
        !           153: /*
        !           154:  *     Convert a timeout in milliseconds (mach_msg_timeout_t)
        !           155:  *     to a timeout in ticks (for use by set_timeout).
        !           156:  *     This conversion rounds UP so that small timeouts
        !           157:  *     at least wait for one tick instead of not waiting at all.
        !           158:  */
        !           159: 
        !           160: #define convert_ipc_timeout_to_ticks(millis)   \
        !           161:                (((millis) * hz + 999) / 1000)
        !           162: 
        !           163: #endif /* _KERN_SCHED_PRIM_H_ */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.