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 the Thread structure.

Definition at line 87 of file chthreads.h.

#include <chthreads.h>

Inheritance diagram for Thread:

[legend]

Collaboration diagram for Thread:

[legend]

Data Fields
Thread *	p_next
	Next in the list/queue.
Thread *	p_prev
	Previous in the queue.
tprio_t	p_prio
	Thread priority.
struct context	p_ctx
	Processor context.
Thread *	p_newer
	Newer registry element.
Thread *	p_older
	Older registry element.
const char *	p_name
	Thread name or `NULL`.
stkalign_t *	p_stklimit
	Thread stack boundary.
tstate_t	p_state
	Current thread state.
tmode_t	p_flags
	Various thread flags.
trefs_t	p_refs
	References to this thread.
tslices_t	p_preempt
	Number of ticks remaining to this thread.
volatile systime_t	p_time
	Thread consumed time in ticks.
ThreadsList	p_waiting
	Termination waiting list.
ThreadsQueue	p_msgqueue
	Messages queue.
msg_t	p_msg
	Thread message.
eventmask_t	p_epending
	Pending events mask.
Mutex *	p_mtxlist
	List of the mutexes owned by this thread.
tprio_t	p_realprio
	Thread's own, non-inherited, priority.
void *	p_mpool
	Memory Pool where the thread workspace is returned.
msg_t	rdymsg
	Thread wakeup code.
msg_t	exitcode
	Thread exit code.
void *	wtobjp
	Pointer to a generic "wait" object.
eventmask_t	ewmask
	Enabled events mask.

Field Documentation

Thread* Thread::p_next

Next in the list/queue.

Reimplemented from ThreadsQueue.

Definition at line 88 of file chthreads.h.

Referenced by chSchDoRescheduleAhead(), chSchReadyI(), dequeue(), fifo_remove(), list_insert(), list_remove(), prio_insert(), and queue_insert().

Thread* Thread::p_prev

Previous in the queue.

Reimplemented from ThreadsQueue.

Definition at line 90 of file chthreads.h.

Referenced by dequeue(), lifo_remove(), prio_insert(), and queue_insert().

tprio_t Thread::p_prio

Thread priority.

Definition at line 92 of file chthreads.h.

Referenced by _thread_init(), chMtxLockS(), chMtxUnlock(), chMtxUnlockAll(), chMtxUnlockS(), chSchWakeupS(), and prio_insert().

struct context Thread::p_ctx

Processor context.

Definition at line 93 of file chthreads.h.

Thread* Thread::p_newer

Newer registry element.

Definition at line 95 of file chthreads.h.

Referenced by chRegNextThread().

Thread* Thread::p_older

Older registry element.

Definition at line 96 of file chthreads.h.

const char* Thread::p_name

Thread name or NULL.

Definition at line 103 of file chthreads.h.

Referenced by _thread_init().

stkalign_t* Thread::p_stklimit

Thread stack boundary.

Definition at line 109 of file chthreads.h.

Referenced by _thread_init().

tstate_t Thread::p_state

Current thread state.

Definition at line 114 of file chthreads.h.

Referenced by _thread_init(), chEvtSignalI(), chMsgRelease(), chMsgSend(), chMsgWait(), chMtxLockS(), chSchDoRescheduleAhead(), chSchReadyI(), chSchWakeupS(), chThdRelease(), chThdResume(), chThdWait(), and dbg_trace().

tmode_t Thread::p_flags

Various thread flags.

Definition at line 118 of file chthreads.h.

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

trefs_t Thread::p_refs

References to this thread.

Definition at line 123 of file chthreads.h.

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

tslices_t Thread::p_preempt

Number of ticks remaining to this thread.

Definition at line 129 of file chthreads.h.

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

volatile systime_t Thread::p_time

Thread consumed time in ticks.

Note:: This field can overflow.

Definition at line 136 of file chthreads.h.

Referenced by _thread_init().

msg_t 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 150 of file chthreads.h.

Referenced by chCondBroadcastI(), chCondSignalI(), chCondWaitS(), chEvtSignalI(), chIQPutI(), chIQResetI(), chMsgSend(), chOQGetI(), chOQResetI(), chSchWakeupS(), chSemAddCounterI(), chSemResetI(), chSemSignalI(), and chSemSignalWait().