2 * Internal Threading header
3 * - Only for use by stuff that needs access to the thread type.
5 #ifndef _THREADS_INT_H_
6 #define _THREADS_INT_H_
13 typedef struct sMessage
15 struct sMessage *Next; //!< Next message in thread's inbox
16 tTID Source; //!< Source thread ID
17 Uint Length; //!< Length of message data in bytes
18 Uint8 Data[]; //!< Message data
22 * \brief Core threading structure
25 typedef struct sThread
29 * \brief Next thread in current list
30 * \note Required to be first for linked list hacks to work
33 struct sThread *GlobalNext; //!< Next thread in global list
34 struct sThread *GlobalPrev; //!< Previous thread in global list
35 tShortSpinlock IsLocked; //!< Thread's spinlock
36 volatile int Status; //!< Thread Status
37 void *WaitPointer; //!< What (Mutex/Thread/other) is the thread waiting on
38 int RetStatus; //!< Return Status
40 Uint TID; //!< Thread ID
41 Uint TGID; //!< Thread Group (Process)
42 struct sThread *Parent; //!< Parent Thread
43 Uint UID, GID; //!< User and Group
44 char *ThreadName; //!< Name of thread
46 // --- arch/proc.c's responsibility
50 //! Memory Manager State
51 tMemoryState MemState;
53 //! State on task switch
54 tTaskState SavedState;
57 int CurFaultNum; //!< Current fault number, 0: none
58 tVAddr FaultHandler; //!< Fault Handler
60 tMsg * volatile Messages; //!< Message Queue
61 tMsg *LastMessage; //!< Last Message (speeds up insertion)
63 int Quantum, Remaining; //!< Quantum Size and remaining timesteps
64 int Priority; //!< Priority - 0: Realtime, higher means less time
66 Uint Config[NUM_CFG_ENTRIES]; //!< Per-process configuration
75 THREAD_STAT_NULL, // Invalid process
76 THREAD_STAT_ACTIVE, // Running and schedulable process
77 THREAD_STAT_SLEEPING, // Message Sleep
78 THREAD_STAT_MUTEXSLEEP, // Mutex Sleep
79 THREAD_STAT_SEMAPHORESLEEP, // Semaphore Sleep
80 THREAD_STAT_WAITING, // ??? (Waiting for a thread)
81 THREAD_STAT_PREINIT, // Being created
82 THREAD_STAT_ZOMBIE, // Died/Killed, but parent not informed
83 THREAD_STAT_DEAD, // Awaiting burial (free)
84 THREAD_STAT_BURIED // If it's still on the list here, something's wrong
86 static const char * const casTHREAD_STAT[] = {
89 "THREAD_STAT_SLEEPING",
90 "THREAD_STAT_MUTEXSLEEP",
91 "THREAD_STAT_SEMAPHORESLEEP",
92 "THREAD_STAT_WAITING",
93 "THREAD_STAT_PREINIT",
100 extern BOOL gaThreads_NoTaskSwitch[MAX_CPUS];
103 extern tThread *Proc_GetCurThread(void);
105 extern tThread *Threads_GetThread(Uint TID);
106 extern void Threads_SetPriority(tThread *Thread, int Pri);
107 extern int Threads_Wake(tThread *Thread);
108 extern void Threads_Kill(tThread *Thread, int Status);
109 extern void Threads_AddActive(tThread *Thread);
110 extern tThread *Threads_RemActive(void);
111 extern tThread *Threads_GetNextToRun(int CPU, tThread *Last);
113 extern tThread *Threads_CloneTCB(Uint *Err, Uint Flags);
114 extern tThread *Threads_CloneThreadZero(void);