Structure representing a thread. More...

#include <chschd.h>

Collaboration diagram for ch_thread:

Data Fields
threads_queue_t	queue
	Threads queue header. More...

tprio_t	prio
	Thread priority. More...

struct port_context	ctx
	Processor context. More...

thread_t *	newer
	Newer registry element. More...

thread_t *	older
	Older registry element. More...

const char *	name
	Thread name or `NULL`. More...

stkalign_t *	wabase
	Working area base address. More...

tstate_t	state
	Current thread state. More...

tmode_t	flags
	Various thread flags. More...

trefs_t	refs
	References to this thread. More...

tslices_t	ticks
	Number of ticks remaining to this thread. More...

volatile systime_t	time
	Thread consumed time in ticks. More...

union {
msg_t rdymsg
	Thread wakeup code. More...

msg_t exitcode
	Thread exit code. More...

void * wtobjp
	Pointer to a generic "wait" object. More...

thread_reference_t * wttrp
	Pointer to a generic thread reference object. More...

msg_t sentmsg
	Thread sent message. More...

struct ch_semaphore * wtsemp
	Pointer to a generic semaphore object. More...

struct ch_mutex * wtmtxp
	Pointer to a generic mutex object. More...

eventmask_t ewmask
	Enabled events mask. More...

}	u
	State-specific fields. More...

threads_list_t	waiting
	Termination waiting list. More...

threads_queue_t	msgqueue
	Messages queue. More...

eventmask_t	epending
	Pending events mask. More...

struct ch_mutex *	mtxlist
	List of the mutexes owned by this thread. More...

tprio_t	realprio
	Thread's own, non-inherited, priority. More...

void *	mpool
	Memory Pool where the thread workspace is returned. More...

time_measurement_t	stats
	Thread statistics. More...

Detailed Description

Structure representing a thread.

Note: Not all the listed fields are always needed, by switching off some not needed ChibiOS/RT subsystems it is possible to save RAM space by shrinking this structure.

Definition at line 153 of file chschd.h.

Field Documentation

threads_queue_t ch_thread::queue

Threads queue header.

Definition at line 154 of file chschd.h.

Referenced by chSchReadyAheadI(), chSchReadyI(), chSysIntegrityCheckI(), list_insert(), list_remove(), queue_dequeue(), queue_fifo_remove(), queue_insert(), queue_isempty(), queue_lifo_remove(), queue_notempty(), and queue_prio_insert().

tprio_t ch_thread::prio

Thread priority.

Definition at line 155 of file chschd.h.

Referenced by _thread_init(), chMtxLockS(), chMtxUnlock(), chMtxUnlockAll(), chMtxUnlockAllS(), chMtxUnlockS(), chSchDoReschedule(), chSchDoRescheduleAhead(), chSchDoRescheduleBehind(), chSchWakeupS(), chThdGetPriorityX(), queue_notempty(), and queue_prio_insert().

struct port_context ch_thread::ctx

Processor context.

Definition at line 156 of file chschd.h.

thread_t* ch_thread::newer

Newer registry element.

Definition at line 158 of file chschd.h.

Referenced by chRegNextThread(), and chSysIntegrityCheckI().

thread_t* ch_thread::older

Older registry element.

Definition at line 159 of file chschd.h.

Referenced by chSysIntegrityCheckI().

const char* ch_thread::name

Thread name or NULL.

Definition at line 166 of file chschd.h.

Referenced by _thread_init(), chRegGetThreadNameX(), and chRegSetThreadNameX().

stkalign_t* ch_thread::wabase

Working area base address.

Note: This pointer is used for stack overflow checks and for dynamic threading.

Definition at line 175 of file chschd.h.

Referenced by chThdCreateStatic(), chThdCreateSuspendedI(), and chThdGetWorkingAreaX().

tstate_t ch_thread::state

Current thread state.

Definition at line 180 of file chschd.h.

Referenced by _thread_init(), _trace_switch(), chEvtSignalI(), chMsgGet(), chMsgRelease(), chMsgSend(), chMsgWait(), chMtxLockS(), chSchGoSleepS(), chSchReadyAheadI(), chSchReadyI(), chSchWakeupS(), chThdDoDequeueNextI(), chThdRelease(), chThdResumeI(), chThdResumeS(), chThdStart(), chThdStartI(), chThdTerminatedX(), and chThdWait().

tmode_t ch_thread::flags

Various thread flags.

Definition at line 184 of file chschd.h.

Referenced by _thread_init(), chThdCreateFromHeap(), chThdCreateFromMemoryPool(), chThdExitS(), chThdRelease(), chThdShouldTerminateX(), and chThdTerminate().

trefs_t ch_thread::refs

References to this thread.

Definition at line 189 of file chschd.h.

Referenced by _thread_init(), chRegFirstThread(), chRegNextThread(), chThdAddRef(), chThdExitS(), chThdRelease(), and chThdWait().

tslices_t ch_thread::ticks

Number of ticks remaining to this thread.

Definition at line 195 of file chschd.h.

Referenced by _thread_init(), chSchDoReschedule(), chSchDoRescheduleBehind(), and chSchGoSleepS().

volatile systime_t ch_thread::time

Thread consumed time in ticks.

Note: This field can overflow.

Definition at line 202 of file chschd.h.

Referenced by _thread_init(), and chThdGetTicksX().

msg_t ch_thread::rdymsg

Thread wakeup code.

Note: This field contains the low level message sent to the thread by the waking thread or interrupt handler. The value is valid after exiting the chSchWakeupS() function.

Definition at line 216 of file chschd.h.

Referenced by chCondBroadcastI(), chCondSignalI(), chCondWaitS(), chEvtSignalI(), chMsgSend(), chSchGoSleepS(), chSchWakeupS(), chSemAddCounterI(), chSemResetI(), chSemSignalI(), chSemSignalWait(), chThdDoDequeueNextI(), chThdResumeI(), and chThdSuspendS().