WebSVN – HelenOS-historic – Blame – /kernel/trunk/generic/include/proc/thread.h/

Rev	Author	Line No.	Line
1	jermar	1	/*
		2	* Copyright (C) 2001-2004 Jakub 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
		29	#ifndef __THREAD_H__
		30	#define __THREAD_H__
		31
		32	#include <arch/thread.h>
		33	#include <synch/spinlock.h>
		34	#include <arch/context.h>
56	vana	35	#include <fpu_context.h>
1	jermar	36	#include <arch/types.h>
		37	#include <typedefs.h>
		38	#include <time/timeout.h>
		39	#include <synch/rwlock.h>
173	jermar	40	#include <config.h>
788	jermar	41	#include <adt/list.h>
1	jermar	42
173	jermar	43	#define THREAD_STACK_SIZE STACK_SIZE
1	jermar	44
		45	#define THREAD_USER_STACK 1
		46
		47	enum state {
410	jermar	48	Invalid, /*< It is an error, if thread is found in this state. /
		49	Running, /*< State of a thread that is currently executing on some CPU. /
		50	Sleeping, /*< Thread in this state is waiting for an event. /
		51	Ready, /*< State of threads in a run queue. /
		52	Entering, /*< Threads are in this state before they are first readied. /
		53	Exiting /*< After a thread calls thread_exit(), it is put into Exiting state. /
1	jermar	54	};
		55
		56	extern char *thread_states[];
		57
		58	#define X_WIRED (1<<0)
		59	#define X_STOLEN (1<<1)
		60
		61	struct thread {
410	jermar	62	link_t rq_link; /*< Run queue link. /
		63	link_t wq_link; /*< Wait queue link. /
		64	link_t th_link; /*< Links to threads within containing task. /
		65	link_t threads_link; /*< Link to the list of all threads. /
1	jermar	66
557	jermar	67	/** Lock protecting thread structure.
		68	*
		69	* Protects the whole thread structure except list links above.
		70	* Must be acquired before T.lock for each T of type task_t.
		71	*
		72	*/
623	jermar	73	SPINLOCK_DECLARE(lock);
1	jermar	74
410	jermar	75	void (* thread_code)(void ); /< Function implementing the thread. /
		76	void thread_arg; /< Argument passed to thread_code() function. /
1	jermar	77
410	jermar	78	context_t saved_context; /*< From here, the stored context is restored when the thread is scheduled. /
		79	context_t sleep_timeout_context; /*< From here, the stored failover context is restored when sleep times out. /
		80
		81	waitq_t sleep_queue; /< Wait queue in which this thread sleeps. /
		82	timeout_t sleep_timeout; /*< Timeout used for timeoutable sleeping. /
		83	volatile int timeout_pending; /*< Flag signalling sleep timeout in progress. /
		84
125	jermar	85	fpu_context_t saved_fpu_context;
		86	int fpu_context_exists;
		87
		88	/*
		89	* Defined only if thread doesn't run.
		90	* It means that fpu context is in CPU that last time executes this thread.
		91	* This disables migration
		92	*/
		93	int fpu_context_engaged;
		94
1	jermar	95	rwlock_type_t rwlock_holder_type;
		96
410	jermar	97	void (* call_me)(void ); /< Funtion to be called in scheduler before the thread is put asleep. /
		98	void call_me_with; /< Argument passed to call_me(). /
		99
		100	state_t state; /*< Thread's state. /
		101	int flags; /*< Thread's flags. /
1	jermar	102
410	jermar	103	cpu_t cpu; /< Thread's CPU. /
		104	task_t task; /< Containing task. /
1	jermar	105
410	jermar	106	__u64 ticks; /*< Ticks before preemption. /
1	jermar	107
413	jermar	108	int priority; /*< Thread's priority. Implemented as index to CPU->rq /
410	jermar	109	__u32 tid; /*< Thread ID. /
1	jermar	110
410	jermar	111	ARCH_THREAD_DATA; /*< Architecture-specific data. /
1	jermar	112
410	jermar	113	__u8 kstack; /< Thread's kernel stack. /
1	jermar	114	};
		115
557	jermar	116	/** Thread list lock.
		117	*
		118	* This lock protects all link_t structures chained in threads_head.
		119	* Must be acquired before T.lock for each T of type thread_t.
		120	*
		121	*/
		122	extern spinlock_t threads_lock;
		123
410	jermar	124	extern link_t threads_head; /*< List of all threads in the system. /
1	jermar	125
		126	extern void thread_init(void);
		127	extern thread_t thread_create(void ( func)(void ), void arg, task_t *task, int flags);
		128	extern void thread_ready(thread_t *t);
		129	extern void thread_exit(void);
		130
		131	extern void thread_sleep(__u32 sec);
		132	extern void thread_usleep(__u32 usec);
		133
		134	extern void thread_register_call_me(void (* call_me)(void ), void call_me_with);
777	palkovsky	135	extern void thread_print_list(void);
787	palkovsky	136	extern void thread_destroy(thread_t *t);
1	jermar	137
		138	#endif

Subversion Repositories HelenOS-historic

(root)/kernel/trunk/generic/include/proc/thread.h/ – Rev 814