Wait object. More...

#include <stk_common.h>

Inheritance diagram for stk::IWaitObject:

Collaboration diagram for stk::IWaitObject:

Public Types
typedef DLHeadType	ListHeadType
	List head type for IWaitObject elements.
typedef DLEntryType	ListEntryType
	List entry type of IWaitObject elements.
typedef DListEntry< IWaitObject, _ClosedLoop >	DLEntryType
	Convenience alias for this entry type. Used to avoid repeating the full template spelling.
typedef DListHead< IWaitObject, _ClosedLoop >	DLHeadType
	Convenience alias for the corresponding list head type.

Public Member Functions
virtual TId	GetTid () const =0
	Get thread Id of this task.
virtual void	Wake (bool timeout)=0
	Wake task.
virtual bool	IsTimeout () const =0
	Check if task woke up due to a timeout.
virtual bool	Tick (Timeout elapsed_ticks)=0
	Update wait object's waiting time.
DLHeadType *	GetHead () const
	Get the list head this entry currently belongs to.
DLEntryType *	GetNext () const
	Get the next entry in the list.
DLEntryType *	GetPrev () const
	Get the previous entry in the list.
bool	IsLinked () const
	Check whether this entry is currently a member of any list.
	operator IWaitObject * ()
	Implicit conversion to a mutable pointer to the host object (T).
	operator const IWaitObject * () const
	Implicit conversion to a const pointer to the host object (T).

Private Member Functions
void	Link (DLHeadType head, DLEntryType next, DLEntryType *prev)
	Wire this entry into a list between prev and next.
void	Unlink ()
	Remove this entry from its current list.

Private Attributes
DLHeadType *	m_head
	Owning list head, or `NULL` when the entry is not linked.
DLEntryType *	m_next
	Next entry in the list, or `NULL` (open list boundary) / first entry (closed loop).
DLEntryType *	m_prev
	Previous entry in the list, or `NULL` (open list boundary) / last entry (closed loop).

Detailed Description

Wait object.

Definition at line 211 of file stk_common.h.

Member Typedef Documentation

◆ DLEntryType

typedef DListEntry<IWaitObject, _ClosedLoop> stk::util::DListEntry< IWaitObject, _ClosedLoop >::DLEntryType

inherited

Convenience alias for this entry type. Used to avoid repeating the full template spelling.

Definition at line 70 of file stk_linked_list.h.

◆ DLHeadType

typedef DListHead<IWaitObject, _ClosedLoop> stk::util::DListEntry< IWaitObject, _ClosedLoop >::DLHeadType

inherited

Convenience alias for the corresponding list head type.

Definition at line 75 of file stk_linked_list.h.

◆ ListEntryType

typedef DLEntryType stk::IWaitObject::ListEntryType

List entry type of IWaitObject elements.

Definition at line 222 of file stk_common.h.

◆ ListHeadType

typedef DLHeadType stk::IWaitObject::ListHeadType

List head type for IWaitObject elements.

Definition at line 217 of file stk_common.h.

Member Function Documentation

◆ GetHead()

DLHeadType * stk::util::DListEntry< IWaitObject, _ClosedLoop >::GetHead ( ) const

inlineinherited

Get the list head this entry currently belongs to.

Returns: Pointer to the owning DListHead, or NULL if the entry is not linked.

Definition at line 80 of file stk_linked_list.h.

80{ return m_head; }

stk::util::DListEntry

Intrusive doubly-linked list node. Embed this as a base class in any object (T) that needs to partici...

Definition stk_linked_list.h:58

◆ GetNext()

DLEntryType * stk::util::DListEntry< IWaitObject, _ClosedLoop >::GetNext ( ) const

inlineinherited

Get the next entry in the list.

Returns: Pointer to the next DListEntry, or NULL if this is the last entry (open list) or the first entry (closed loop, where next wraps to first).

Note: In a closed loop (_ClosedLoop == true) this pointer is never NULL when the entry is linked.

Definition at line 88 of file stk_linked_list.h.

88{ return m_next; }

◆ GetPrev()

DLEntryType * stk::util::DListEntry< IWaitObject, _ClosedLoop >::GetPrev ( ) const

inlineinherited

Get the previous entry in the list.

Returns: Pointer to the previous DListEntry, or NULL if this is the first entry (open list) or the last entry (closed loop, where prev wraps to last).

Note: In a closed loop (_ClosedLoop == true) this pointer is never NULL when the entry is linked.

Definition at line 96 of file stk_linked_list.h.

96{ return m_prev; }

◆ GetTid()

virtual TId stk::IWaitObject::GetTid ( ) const

pure virtual

Get thread Id of this task.

Returns: Thread Id.

Implemented in stk::Kernel< TMode, TSize, TStrategy, TPlatform >::KernelTask::WaitObject.

Referenced by stk::test::TEST(), stk::test::Test_SyncWait(), and stk::sync::Mutex::Unlock().

Here is the caller graph for this function:

◆ IsLinked()

bool stk::util::DListEntry< IWaitObject, _ClosedLoop >::IsLinked ( ) const

inlineinherited

Check whether this entry is currently a member of any list.

Returns: true if linked (m_head != NULL); false otherwise.

Definition at line 101 of file stk_linked_list.h.

101{ return (GetHead() != nullptr); }

stk::util::DListEntry< IWaitObject, false >::GetHead

DLHeadType * GetHead() const

Definition stk_linked_list.h:80

◆ IsTimeout()

virtual bool stk::IWaitObject::IsTimeout ( ) const

pure virtual

Check if task woke up due to a timeout.

Returns: Returns true if timeout, false otherwise.

Implemented in stk::Kernel< TMode, TSize, TStrategy, TPlatform >::KernelTask::WaitObject.

Referenced by stk::sync::Event::RemoveWaitObject(), stk::test::TEST(), stk::test::TEST(), stk::test::Test_SyncWait(), stk::sync::Mutex::TimedLock(), stk::sync::ConditionVariable::Wait(), stk::sync::Event::Wait(), and stk::sync::Semaphore::Wait().

Here is the caller graph for this function:

◆ Link()

void stk::util::DListEntry< IWaitObject, _ClosedLoop >::Link	(	DLHeadType *	head,
		DLEntryType *	next,
		DLEntryType *	prev )

inlineprivateinherited

Wire this entry into a list between prev and next.

Parameters

[in]	head	The owning DListHead. Stored as a back-pointer for IsLinked() and ownership checks.
[in]	next	The entry that will follow this one, or `NULL` if this becomes the last entry.
[in]	prev	The entry that will precede this one, or `NULL` if this becomes the first entry.

Note: Called exclusively by DListHead::Link(). Assumes the entry is not currently linked. Updates the neighbours' forward/back pointers to splice this entry in.

Definition at line 137 of file stk_linked_list.h.

    {
        m_head = head;
        m_next = next;
        m_prev = prev;
 
        if (m_prev != nullptr)
            m_prev->m_next = this;
 
        if (m_next != nullptr)
            m_next->m_prev = this;
    }

◆ operator const IWaitObject *()

stk::util::DListEntry< IWaitObject, _ClosedLoop >::operator const IWaitObject * ( ) const

inlineinherited

Implicit conversion to a const pointer to the host object (T).

Note: Safe because T must derive from DListEntry<T, _ClosedLoop>. Eliminates the need for explicit static_cast at call sites.; MISRA deviation: [STK-DEV-004] Rule 5-2-x.

Definition at line 115 of file stk_linked_list.h.

115{ return static_cast<const T *>(this); }

◆ operator IWaitObject *()

stk::util::DListEntry< IWaitObject, _ClosedLoop >::operator IWaitObject* ( )

inlineinherited

Implicit conversion to a mutable pointer to the host object (T).

Note: Safe because T must derive from DListEntry<T, _ClosedLoop>. Eliminates the need for explicit static_cast at call sites.; MISRA deviation: [STK-DEV-004] Rule 5-2-x.

Definition at line 108 of file stk_linked_list.h.

108{ return static_cast<T *>(this); }

◆ Tick()

virtual bool stk::IWaitObject::Tick ( Timeout elapsed_ticks )

pure virtual

Update wait object's waiting time.

Parameters

[in] elapsed_ticks Number of ticks elapsed between this and previous calls, in case of KERNEL_TICKLESS mode this value can be >1, for non-tickless mode it is always 1.

Returns: Returns true if update caused a timeout of the object, false otherwise.

Implemented in stk::Kernel< TMode, TSize, TStrategy, TPlatform >::KernelTask::WaitObject.

Referenced by stk::ISyncObject::Tick().

Here is the caller graph for this function:

◆ Unlink()

void stk::util::DListEntry< IWaitObject, _ClosedLoop >::Unlink ( )

inlineprivateinherited

Remove this entry from its current list.

Note: Called exclusively by DListHead::Unlink(). Patches the neighbours' pointers to bridge over this entry, then clears m_head, m_next, and m_prev to NULL so the entry is in a clean unlinked state.; Does not update DListHead::m_count or m_first / m_last — those are the responsibility of the calling DListHead::Unlink().

Definition at line 157 of file stk_linked_list.h.

    {
        if (m_prev != nullptr)
            m_prev->m_next = m_next;
 
        if (m_next != nullptr)
            m_next->m_prev = m_prev;
 
        m_head = nullptr;
        m_next = nullptr;
        m_prev = nullptr;
    }

◆ Wake()

virtual void stk::IWaitObject::Wake ( bool timeout )

pure virtual

Wake task.

Parameters

[in] timeout Pass true if the task is waking due to timeout expiry. false if waking due to a successful signal.

Note: The implementation is responsible for removing this wait object from the synchronization object's wait list (via ISyncObject::RemoveWaitObject) as part of the wake sequence.

Implemented in stk::Kernel< TMode, TSize, TStrategy, TPlatform >::KernelTask::WaitObject.

Referenced by stk::ISyncObject::Tick(), stk::sync::Mutex::Unlock(), stk::ISyncObject::WakeAll(), and stk::ISyncObject::WakeOne().

Here is the caller graph for this function:

Member Data Documentation

◆ m_head

DLHeadType* stk::util::DListEntry< IWaitObject, _ClosedLoop >::m_head

privateinherited

Owning list head, or NULL when the entry is not linked.

Definition at line 170 of file stk_linked_list.h.

◆ m_next

DLEntryType* stk::util::DListEntry< IWaitObject, _ClosedLoop >::m_next

privateinherited

Next entry in the list, or NULL (open list boundary) / first entry (closed loop).

Definition at line 171 of file stk_linked_list.h.

◆ m_prev

DLEntryType* stk::util::DListEntry< IWaitObject, _ClosedLoop >::m_prev

privateinherited

Previous entry in the list, or NULL (open list boundary) / last entry (closed loop).

Definition at line 172 of file stk_linked_list.h.

The documentation for this class was generated from the following file:

stk_common.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ DLEntryType

◆ DLHeadType

◆ ListEntryType

◆ ListHeadType

Member Function Documentation

◆ GetHead()

◆ GetNext()

◆ GetPrev()

◆ GetTid()

◆ IsLinked()

◆ IsTimeout()

◆ Link()

◆ operator const IWaitObject *()

◆ operator IWaitObject *()

◆ Tick()

◆ Unlink()

◆ Wake()

Member Data Documentation

◆ m_head

◆ m_next

◆ m_prev