validation: Use spec:* references

Update #3716.
This commit is contained in:
Sebastian Huber
2023-05-08 17:04:23 +02:00
parent 64fdb08900
commit 649dc37c8f
15 changed files with 67 additions and 64 deletions

View File

@@ -73,7 +73,7 @@
*
* - Check that the CONFIGURE_MAXIMUM_PRIORITY application configuration
* option resulted in the expected system setting using
* /rtems/task/if/maximum-priority.
* spec:/rtems/task/if/maximum-priority.
*
* - Check that the Deterministic Priority Scheduler which was configured by
* the CONFIGURE_SCHEDULER_PRIORITY application configuration in the test
@@ -122,7 +122,7 @@ static void AcfgValOneCpu_Action_0( void )
/*
* Check that the CONFIGURE_MAXIMUM_PRIORITY application configuration option
* resulted in the expected system setting using
* /rtems/task/if/maximum-priority.
* spec:/rtems/task/if/maximum-priority.
*/
T_eq_u32( RTEMS_MAXIMUM_PRIORITY, 127 );

View File

@@ -132,11 +132,11 @@
*
* - Check the configured CONFIGURE_TASK_STACK_ALLOCATOR hook. Using the
* test stack allocator validates also
* /acfg/if/init-task-construct-storage-size, since the
* spec:/acfg/if/init-task-construct-storage-size, since the
* test_task_stack_allocate() allocate handler only supports
* CONFIGURE_MAXIMUM_TASKS minus one stacks and the validation test for
* /rtems/task/req/create-errors creates for some pre-condition variants
* all tasks until RTEMS_TOO_MANY is returned. In addition,
* spec:/rtems/task/req/create-errors creates for some pre-condition
* variants all tasks until RTEMS_TOO_MANY is returned. In addition,
* test_task_stack_allocate() checks that the allocation size is greater
* than or equal to TEST_MINIMUM_STACK_SIZE which validates
* CONFIGURE_MINIMUM_TASK_STACK_SIZE.
@@ -342,11 +342,12 @@ static void AcfgValAcfg_Action_0( void )
/*
* Check the configured CONFIGURE_TASK_STACK_ALLOCATOR hook. Using the test
* stack allocator validates also /acfg/if/init-task-construct-storage-size,
* since the test_task_stack_allocate() allocate handler only supports
* stack allocator validates also
* spec:/acfg/if/init-task-construct-storage-size, since the
* test_task_stack_allocate() allocate handler only supports
* CONFIGURE_MAXIMUM_TASKS minus one stacks and the validation test for
* /rtems/task/req/create-errors creates for some pre-condition variants all
* tasks until RTEMS_TOO_MANY is returned. In addition,
* spec:/rtems/task/req/create-errors creates for some pre-condition variants
* all tasks until RTEMS_TOO_MANY is returned. In addition,
* test_task_stack_allocate() checks that the allocation size is greater than
* or equal to TEST_MINIMUM_STACK_SIZE which validates
* CONFIGURE_MINIMUM_TASK_STACK_SIZE.

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API partition
* class objects defined by /rtems/req/ident-local.
* class objects defined by spec:/rtems/req/ident-local.
*
* @{
*/
@@ -83,7 +83,7 @@ static rtems_status_code ClassicBarrierIdentAction(
/**
* @brief Run the generic object identification tests for Classic API partition
* class objects defined by /rtems/req/ident-local.
* class objects defined by spec:/rtems/req/ident-local.
*/
static void RtemsBarrierValIdent_Action_0( void )
{

View File

@@ -72,7 +72,7 @@
* This test case performs the following actions:
*
* - Run the event send and receive tests for the application event set defined
* by /rtems/event/req/send-receive.
* by spec:/rtems/event/req/send-receive.
*
* @{
*/
@@ -105,7 +105,7 @@ static rtems_event_set GetPendingEvents( Thread_Control *thread )
/**
* @brief Run the event send and receive tests for the application event set
* defined by /rtems/event/req/send-receive.
* defined by spec:/rtems/event/req/send-receive.
*/
static void RtemsEventValSendReceive_Action_0( void )
{
@@ -140,7 +140,7 @@ T_TEST_CASE( RtemsEventValSendReceive )
* This test case performs the following actions:
*
* - Run the event send and receive tests for the system event set defined by
* /rtems/event/req/send-receive.
* spec:/rtems/event/req/send-receive.
*
* @{
*/
@@ -178,7 +178,7 @@ static rtems_event_set GetPendingSystemEvents( Thread_Control *thread )
/**
* @brief Run the event send and receive tests for the system event set defined
* by /rtems/event/req/send-receive.
* by spec:/rtems/event/req/send-receive.
*/
static void RtemsEventValSystemSendReceive_Action_0( void )
{

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API message queue
* class objects defined by /rtems/req/ident.
* class objects defined by spec:/rtems/req/ident.
*
* @{
*/
@@ -95,7 +95,7 @@ static rtems_status_code ClassicMessageIdentAction(
/**
* @brief Run the generic object identification tests for Classic API message
* queue class objects defined by /rtems/req/ident.
* queue class objects defined by spec:/rtems/req/ident.
*/
static void RtemsMessageValIdent_Action_0( void )
{

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API partition
* class objects defined by /rtems/req/ident.
* class objects defined by spec:/rtems/req/ident.
*
* @{
*/
@@ -84,7 +84,7 @@ static rtems_status_code ClassicPartIdentAction(
/**
* @brief Run the generic object identification tests for Classic API partition
* class objects defined by /rtems/req/ident.
* class objects defined by spec:/rtems/req/ident.
*/
static void RtemsPartValIdent_Action_0( void )
{

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API rate monotonic
* class objects defined by /rtems/req/ident-local.
* class objects defined by spec:/rtems/req/ident-local.
*
* @{
*/
@@ -83,7 +83,7 @@ static rtems_status_code ClassicRatemonIdentAction(
/**
* @brief Run the generic object identification tests for Classic API rate
* monotonic class objects defined by /rtems/req/ident-local.
* monotonic class objects defined by spec:/rtems/req/ident-local.
*/
static void RtemsRatemonValIdent_Action_0( void )
{

View File

@@ -405,7 +405,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
case RtemsSemReqFlush_Post_Action_FlushFIFO: {
/*
* The calling task shall flush the semaphore as specified by
* /score/tq/req/flush-fifo.
* spec:/score/tq/req/flush-fifo.
*/
ScoreTqReqFlushFifo_Run( &ctx->tq_ctx, false );
break;
@@ -414,7 +414,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
case RtemsSemReqFlush_Post_Action_FlushPriority: {
/*
* The calling task shall flush the semaphore as specified by
* /score/tq/req/flush-priority.
* spec:/score/tq/req/flush-priority.
*/
ScoreTqReqFlushPriority_Run( &ctx->tq_ctx, true );
break;
@@ -423,7 +423,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
case RtemsSemReqFlush_Post_Action_FlushPriorityCeiling: {
/*
* The calling task shall flush the semaphore as specified by
* /score/tq/req/flush-priority.
* spec:/score/tq/req/flush-priority.
*/
ScoreTqReqFlushPriority_Run( &ctx->tq_ctx, false );
break;
@@ -432,7 +432,7 @@ static void RtemsSemReqFlush_Post_Action_Check(
case RtemsSemReqFlush_Post_Action_FlushPriorityInherit: {
/*
* The calling task shall flush the semaphore as specified by
* /score/tq/req/flush-priority-inherit.
* spec:/score/tq/req/flush-priority-inherit.
*/
ScoreTqReqFlushPriorityInherit_Run( &ctx->tq_ctx );
break;

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API semaphore
* class objects defined by /rtems/req/ident.
* class objects defined by spec:/rtems/req/ident.
*
* @{
*/
@@ -84,7 +84,7 @@ static rtems_status_code ClassicSemIdentAction(
/**
* @brief Run the generic object identification tests for Classic API semaphore
* class objects defined by /rtems/req/ident.
* class objects defined by spec:/rtems/req/ident.
*/
static void RtemsSemValIdent_Action_0( void )
{

View File

@@ -390,7 +390,7 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_SemSeizeTry: {
/*
* The calling task shall try to seize the semaphore as specified by
* /score/sem/req/seize-try.
* spec:/score/sem/req/seize-try.
*/
ctx->tq_sem_ctx.get_count = TQSemGetCountClassic;
ctx->tq_sem_ctx.set_count = TQSemSetCountClassic;
@@ -401,7 +401,7 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_SemSeizeWait: {
/*
* The calling task shall wait to seize the semaphore as specified by
* /score/sem/req/seize-wait.
* spec:/score/sem/req/seize-wait.
*/
ctx->tq_sem_ctx.get_count = TQSemGetCountClassic;
ctx->tq_sem_ctx.set_count = TQSemSetCountClassic;
@@ -412,8 +412,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_MtxSeizeTry: {
/*
* The calling task shall try to seize the mutex as specified by
* /score/mtx/req/seize-try where an enqueue blocks, a recursive seize is
* allowed, and no locking protocol is used.
* spec:/score/mtx/req/seize-try where an enqueue blocks, a recursive
* seize is allowed, and no locking protocol is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -426,8 +426,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_MtxSeizeWait: {
/*
* The calling task shall wait to seize the mutex as specified by
* /score/mtx/req/seize-wait where an enqueue blocks, a recursive seize
* is allowed, and no locking protocol is used.
* spec:/score/mtx/req/seize-wait where an enqueue blocks, a recursive
* seize is allowed, and no locking protocol is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -440,8 +440,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_InheritMtxSeizeTry: {
/*
* The calling task shall try to seize the mutex as specified by
* /score/mtx/req/seize-try where an enqueue blocks, a recursive seize is
* allowed, and a priority inheritance protocol is used.
* spec:/score/mtx/req/seize-try where an enqueue blocks, a recursive
* seize is allowed, and a priority inheritance protocol is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -454,8 +454,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_InheritMtxSeizeWait: {
/*
* The calling task shall wait to seize the mutex as specified by
* /score/mtx/req/seize-wait where an enqueue blocks, a recursive seize
* is allowed, and a priority inheritance protocol is used.
* spec:/score/mtx/req/seize-wait where an enqueue blocks, a recursive
* seize is allowed, and a priority inheritance protocol is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_mtx_ctx.protocol = TQ_MTX_NO_PROTOCOL;
@@ -468,8 +468,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_CeilingMtxSeizeTry: {
/*
* The calling task shall try to seize the mutex as specified by
* /score/mtx/req/seize-try where an enqueue blocks, a recursive seize is
* allowed, and a priority ceiling is used.
* spec:/score/mtx/req/seize-try where an enqueue blocks, a recursive
* seize is allowed, and a priority ceiling is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_mtx_ctx.protocol = TQ_MTX_PRIORITY_CEILING;
@@ -482,8 +482,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_CeilingMtxSeizeWait: {
/*
* The calling task shall wait to seize the mutex as specified by
* /score/mtx/req/seize-wait where an enqueue blocks, a recursive seize
* is allowed, and a priority ceiling is used.
* spec:/score/mtx/req/seize-wait where an enqueue blocks, a recursive
* seize is allowed, and a priority ceiling is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_mtx_ctx.protocol = TQ_MTX_PRIORITY_CEILING;
@@ -496,8 +496,8 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_MrsPMtxSeizeTry: {
/*
* The calling task shall try to seize the mutex as specified by
* /score/mtx/req/seize-try where an enqueue is sticky, a recursive seize
* returns an error status, and a priority ceiling is used.
* spec:/score/mtx/req/seize-try where an enqueue is sticky, a recursive
* seize returns an error status, and a priority ceiling is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_STICKY;
ctx->tq_mtx_ctx.protocol = TQ_MTX_MRSP;
@@ -510,7 +510,7 @@ static void RtemsSemReqObtain_Post_Action_Check(
case RtemsSemReqObtain_Post_Action_MrsPMtxSeizeWait: {
/*
* The calling task shall wait to seize the mutex as specified by
* /score/mtx/req/seize-wait where an enqueue is sticky, a recursive
* spec:/score/mtx/req/seize-wait where an enqueue is sticky, a recursive
* seize returns an error status, and a priority ceiling is used.
*/
ctx->tq_mtx_ctx.base.enqueue_variant = TQ_ENQUEUE_STICKY;

View File

@@ -331,7 +331,7 @@ static void RtemsSemReqRelease_Post_Action_Check(
case RtemsSemReqRelease_Post_Action_BinarySurrender: {
/*
* The calling task shall surrender the binary semaphore as specified by
* /score/sem/req/surrender.
* spec:/score/sem/req/surrender.
*/
ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_ctx.get_owner = NULL;
@@ -345,7 +345,7 @@ static void RtemsSemReqRelease_Post_Action_Check(
case RtemsSemReqRelease_Post_Action_CountingSurrender: {
/*
* The calling task shall surrender the counting semaphore as specified
* by /score/sem/req/surrender.
* by spec:/score/sem/req/surrender.
*/
ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_ctx.get_owner = NULL;
@@ -359,8 +359,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
case RtemsSemReqRelease_Post_Action_MtxSurrender: {
/*
* The calling task shall surrender the mutex as specified by
* /score/mtx/req/surrender where an enqueue blocks, a recursive seize is
* allowed, the owner is checked, and no locking protocol is used.
* spec:/score/mtx/req/surrender where an enqueue blocks, a recursive
* seize is allowed, the owner is checked, and no locking protocol is
* used.
*/
ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;
@@ -375,9 +376,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
case RtemsSemReqRelease_Post_Action_InheritMtxSurrender: {
/*
* The calling task shall surrender the mutex as specified by
* /score/mtx/req/surrender where an enqueue blocks, a recursive seize is
* allowed, the owner is checked, and a priority inheritance protocol is
* used.
* spec:/score/mtx/req/surrender where an enqueue blocks, a recursive
* seize is allowed, the owner is checked, and a priority inheritance
* protocol is used.
*/
ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;
@@ -392,8 +393,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
case RtemsSemReqRelease_Post_Action_CeilingMtxSurrender: {
/*
* The calling task shall surrender the mutex as specified by
* /score/mtx/req/surrender where an enqueue blocks, a recursive seize is
* allowed, the owner is checked, and a priority ceiling is used.
* spec:/score/mtx/req/surrender where an enqueue blocks, a recursive
* seize is allowed, the owner is checked, and a priority ceiling is
* used.
*/
ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_BLOCKS;
ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;
@@ -408,9 +410,9 @@ static void RtemsSemReqRelease_Post_Action_Check(
case RtemsSemReqRelease_Post_Action_MrsPMtxSurrender: {
/*
* The calling task shall surrender the mutex as specified by
* /score/mtx/req/surrender where an enqueue is sticky, a recursive seize
* returns an error status, the owner is checked, and a priority ceiling
* is used.
* spec:/score/mtx/req/surrender where an enqueue is sticky, a recursive
* seize returns an error status, the owner is checked, and a priority
* ceiling is used.
*/
ctx->tq_ctx.enqueue_variant = TQ_ENQUEUE_STICKY;
ctx->tq_ctx.get_owner = TQGetOwnerClassicSem;

View File

@@ -273,7 +273,7 @@ static void RtemsSemReqTimeout_Post_Action_Check(
case RtemsSemReqTimeout_Post_Action_Timeout: {
/*
* The semaphore obtain timeout actions shall be done as specified by
* /score/tq/req/timeout.
* spec:/score/tq/req/timeout.
*/
ctx->tq_ctx.wait = TQ_WAIT_TIMED;
ScoreTqReqTimeout_Run( &ctx->tq_ctx );
@@ -283,7 +283,7 @@ static void RtemsSemReqTimeout_Post_Action_Check(
case RtemsSemReqTimeout_Post_Action_TimeoutMrsP: {
/*
* The semaphore obtain timeout actions shall be done as specified by
* /score/tq/req/timeout-mrsp.
* spec:/score/tq/req/timeout-mrsp.
*/
ctx->tq_ctx.wait = TQ_WAIT_TIMED;
ScoreTqReqTimeoutMrsp_Run( &ctx->tq_ctx );
@@ -293,7 +293,7 @@ static void RtemsSemReqTimeout_Post_Action_Check(
case RtemsSemReqTimeout_Post_Action_TimeoutPriorityInherit: {
/*
* The semaphore obtain timeout actions shall be done as specified by
* /score/tq/req/timeout-priority-inherit.
* spec:/score/tq/req/timeout-priority-inherit.
*/
ctx->tq_ctx.wait = TQ_WAIT_FOREVER;
ScoreTqReqTimeoutPriorityInherit_Run( &ctx->tq_ctx );

View File

@@ -167,7 +167,7 @@ static void RtemsTaskReqIdent_Pre_Name_Prepare(
/*
* While the ``name`` is not equal to RTEMS_WHO_AM_I or ``id`` parameter
* is equal to NULL, the behaviour of rtems_task_ident() shall be
* specified by /rtems/req/ident.
* specified by spec:/rtems/req/ident.
*/
ctx->id = NULL;
/* Preparation performed by RtemsReqIdent_Run() */

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API timer class
* objects defined by /rtems/req/ident-local.
* objects defined by spec:/rtems/req/ident-local.
*
* @{
*/
@@ -83,7 +83,7 @@ static rtems_status_code ClassicTimerIdentAction(
/**
* @brief Run the generic object identification tests for Classic API timer
* class objects defined by /rtems/req/ident-local.
* class objects defined by spec:/rtems/req/ident-local.
*/
static void RtemsTimerValIdent_Action_0( void )
{

View File

@@ -66,7 +66,7 @@
* This test case performs the following actions:
*
* - Run the generic object identification tests for Classic API user extension
* class objects defined by /rtems/req/ident-local.
* class objects defined by spec:/rtems/req/ident-local.
*
* @{
*/
@@ -83,7 +83,7 @@ static rtems_status_code ClassicUserExtIdentAction(
/**
* @brief Run the generic object identification tests for Classic API user
* extension class objects defined by /rtems/req/ident-local.
* extension class objects defined by spec:/rtems/req/ident-local.
*/
static void RtemsUserextValIdent_Action_0( void )
{