freertos-8.0.1/Source/include/list.h File Reference

Data Structures
struct	xLIST
struct	xLIST_ITEM
struct	xMINI_LIST_ITEM

Macros
#define	configLIST_VOLATILE
#define	listCURRENT_LIST_LENGTH(pxList)   ( ( pxList )->uxNumberOfItems )
#define	listGET_END_MARKER(pxList)   ( ( ListItem_t const * ) ( &( ( pxList )->xListEnd ) ) )
#define	listGET_HEAD_ENTRY(pxList)   ( ( ( pxList )->xListEnd ).pxNext )
#define	listGET_ITEM_VALUE_OF_HEAD_ENTRY(pxList)   ( ( ( pxList )->xListEnd ).pxNext->xItemValue )
#define	listGET_LIST_ITEM_OWNER(pxListItem)   ( ( pxListItem )->pvOwner )
#define	listGET_LIST_ITEM_VALUE(pxListItem)   ( ( pxListItem )->xItemValue )
#define	listGET_NEXT(pxListItem)   ( ( pxListItem )->pxNext )
#define	listGET_OWNER_OF_HEAD_ENTRY(pxList)   ( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )
#define	listGET_OWNER_OF_NEXT_ENTRY(pxTCB, pxList)
#define	listIS_CONTAINED_WITHIN(pxList, pxListItem)   ( ( BaseType_t ) ( ( pxListItem )->pvContainer == ( void * ) ( pxList ) ) )
#define	listLIST_IS_EMPTY(pxList)   ( ( BaseType_t ) ( ( pxList )->uxNumberOfItems == ( UBaseType_t ) 0 ) )
#define	listLIST_IS_INITIALISED(pxList)   ( ( pxList )->xListEnd.xItemValue == portMAX_DELAY )
#define	listLIST_ITEM_CONTAINER(pxListItem)   ( ( pxListItem )->pvContainer )
#define	listSET_LIST_ITEM_OWNER(pxListItem, pxOwner)   ( ( pxListItem )->pvOwner = ( void * ) ( pxOwner ) )
#define	listSET_LIST_ITEM_VALUE(pxListItem, xValue)   ( ( pxListItem )->xItemValue = ( xValue ) )

Typedefs
typedef struct xLIST	List_t
typedef struct xLIST_ITEM	ListItem_t
typedef struct xMINI_LIST_ITEM	MiniListItem_t

Functions
UBaseType_t	uxListRemove (ListItem_t *const pxItemToRemove)
void	vListInitialise (List_t *const pxList)
void	vListInitialiseItem (ListItem_t *const pxItem)
void	vListInsert (List_t *const pxList, ListItem_t *const pxNewListItem)
void	vListInsertEnd (List_t *const pxList, ListItem_t *const pxNewListItem)

#define configLIST_VOLATILE

#define listCURRENT_LIST_LENGTH

(

pxList

)

( ( pxList )->uxNumberOfItems )

#define listGET_END_MARKER

(

pxList

)

( ( ListItem_t const * ) ( &( ( pxList )->xListEnd ) ) )

#define listGET_HEAD_ENTRY

(

pxList

)

( ( ( pxList )->xListEnd ).pxNext )

#define listGET_ITEM_VALUE_OF_HEAD_ENTRY

(

pxList

)

( ( ( pxList )->xListEnd ).pxNext->xItemValue )

#define listGET_LIST_ITEM_OWNER

(

pxListItem

)

( ( pxListItem )->pvOwner )

#define listGET_LIST_ITEM_VALUE

(

pxListItem

)

( ( pxListItem )->xItemValue )

#define listGET_NEXT

(

pxListItem

)

( ( pxListItem )->pxNext )

#define listGET_OWNER_OF_HEAD_ENTRY

(

pxList

)

( (&( ( pxList )->xListEnd ))->pxNext->pvOwner )

#define listGET_OWNER_OF_NEXT_ENTRY	(		pxTCB,
			pxList
	)

Value:

{                                                                                           \
List_t * const pxConstList = ( pxList );                                                    \
    /* Increment the index to the next item and return the item, ensuring */                \
    /* we don't return the marker used at the end of the list.  */                          \
    ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext;                            \
	if( ( void * ) ( pxConstList )->pxIndex == ( void * ) &( ( pxConstList )->xListEnd ) ) \
    {                                                                                       \
        ( pxConstList )->pxIndex = ( pxConstList )->pxIndex->pxNext;                        \
    }                                                                                       \
    ( pxTCB ) = ( pxConstList )->pxIndex->pvOwner;                                          \
}

#define listIS_CONTAINED_WITHIN	(		pxList,
			pxListItem
	)		( ( BaseType_t ) ( ( pxListItem )->pvContainer == ( void * ) ( pxList ) ) )

#define listLIST_IS_EMPTY

(

pxList

)

( ( BaseType_t ) ( ( pxList )->uxNumberOfItems == ( UBaseType_t ) 0 ) )

#define listLIST_IS_INITIALISED

(

pxList

)

( ( pxList )->xListEnd.xItemValue == portMAX_DELAY )

#define listLIST_ITEM_CONTAINER

(

pxListItem

)

( ( pxListItem )->pvContainer )

#define listSET_LIST_ITEM_OWNER	(		pxListItem,
			pxOwner
	)		( ( pxListItem )->pvOwner = ( void * ) ( pxOwner ) )

#define listSET_LIST_ITEM_VALUE	(		pxListItem,
			xValue
	)		( ( pxListItem )->xItemValue = ( xValue ) )

typedef struct xLIST List_t

typedef struct xLIST_ITEM ListItem_t

typedef struct xMINI_LIST_ITEM MiniListItem_t

UBaseType_t uxListRemove

(

ListItem_t *const

pxItemToRemove

)

References mtCOVERAGE_TEST_DELAY, mtCOVERAGE_TEST_MARKER, NULL, xLIST_ITEM::pvContainer, xLIST::pxIndex, xLIST_ITEM::pxNext, xLIST_ITEM::pxPrevious, and xLIST::uxNumberOfItems.

Referenced by prvAddCurrentTaskToDelayedList(), prvCheckDelayedList(), prvCheckPendingReadyList(), prvCheckTasksWaitingTermination(), vCoRoutineAddToDelayedList(), vTaskPlaceOnEventList(), vTaskPlaceOnUnorderedEventList(), vTaskRemoveFromUnorderedEventList(), xCoRoutineRemoveFromEventList(), xTaskIncrementTick(), xTaskRemoveFromEventList(), xTaskRemoveFromUnorderedEventList(), and xTaskResumeAll().

void vListInitialise

(

List_t *const

pxList

)

References listSET_LIST_INTEGRITY_CHECK_1_VALUE, listSET_LIST_INTEGRITY_CHECK_2_VALUE, xLIST::pxIndex, xMINI_LIST_ITEM::pxNext, xMINI_LIST_ITEM::pxPrevious, xLIST::uxNumberOfItems, xMINI_LIST_ITEM::xItemValue, and xLIST::xListEnd.

Referenced by prvInitialiseCoRoutineLists(), prvInitialiseTaskLists(), xEventGroupCreate(), and xQueueGenericReset().

void vListInitialiseItem

(

ListItem_t *const

pxItem

)

References listSET_FIRST_LIST_ITEM_INTEGRITY_CHECK_VALUE, listSET_SECOND_LIST_ITEM_INTEGRITY_CHECK_VALUE, NULL, and xLIST_ITEM::pvContainer.

Referenced by prvInitialiseTCBVariables(), and xCoRoutineCreate().

void vListInsert	(	List_t *const	pxList,
		ListItem_t *const	pxNewListItem
	)

References listTEST_LIST_INTEGRITY, listTEST_LIST_ITEM_INTEGRITY, portTickType, xLIST_ITEM::pvContainer, xLIST_ITEM::pxNext, xLIST_ITEM::pxPrevious, xMINI_LIST_ITEM::pxPrevious, xLIST::uxNumberOfItems, xLIST_ITEM::xItemValue, and xLIST::xListEnd.

Referenced by prvAddCurrentTaskToDelayedList(), vCoRoutineAddToDelayedList(), and vTaskPlaceOnEventList().

void vListInsertEnd	(	List_t *const	pxList,
		ListItem_t *const	pxNewListItem
	)

References listTEST_LIST_INTEGRITY, listTEST_LIST_ITEM_INTEGRITY, mtCOVERAGE_TEST_DELAY, xLIST_ITEM::pvContainer, xLIST::pxIndex, xLIST_ITEM::pxNext, xLIST_ITEM::pxPrevious, and xLIST::uxNumberOfItems.

Referenced by prvAddCurrentTaskToDelayedList(), vTaskPlaceOnEventList(), vTaskPlaceOnUnorderedEventList(), xCoRoutineRemoveFromEventList(), and xTaskRemoveFromEventList().