summaryrefslogtreecommitdiff
path: root/FreeRTOS/Test/CBMC/proofs/Queue/QueueReceive/QueueReceive_harness.c
blob: 533f69caf7c6c00bafabb820683d2a1b9a0d8b97 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
/*
 * FreeRTOS memory safety proofs with CBMC.
 * Copyright (C) 2019 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
 *
 * Permission is hereby granted, free of charge, to any person
 * obtaining a copy of this software and associated documentation
 * files (the "Software"), to deal in the Software without
 * restriction, including without limitation the rights to use, copy,
 * modify, merge, publish, distribute, sublicense, and/or sell copies
 * of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be
 * included in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 *
 * http://aws.amazon.com/freertos
 * http://www.FreeRTOS.org
 */

#include "FreeRTOS.h"
#include "queue.h"
#include "queue_init.h"
#include "tasksStubs.h"
#include "cbmc.h"

/* prvUnlockQueue is going to decrement this value to 0 in the loop.
   We need a bound for the loop. Using 4 has a reasonable performance resulting
   in 3 unwinding iterations of the loop. The loop is mostly modifying a
   data structure in task.c that is not in the scope of the proof. */
#ifndef LOCK_BOUND
	#define LOCK_BOUND 4
#endif

/* This code checks for time outs. This value is used to bound the time out
   wait period. The stub function xTaskCheckForTimeOut used to model
   this wait time will be bounded to this define. */
#ifndef QUEUE_RECEIVE_BOUND
	#define QUEUE_RECEIVE_BOUND 4
#endif

/* If the item size is not bounded, the proof does not finish in a reasonable
   time due to the involved memcpy commands. */
#ifndef MAX_ITEM_SIZE
	#define MAX_ITEM_SIZE 20
#endif

QueueHandle_t xQueue;

/* This method is used to model side effects of concurrency.
   The initialization of pxTimeOut is not relevant for this harness. */
void vTaskInternalSetTimeOutState( TimeOut_t * const pxTimeOut ){
	__CPROVER_assert(__CPROVER_w_ok(&(pxTimeOut->xOverflowCount), sizeof(BaseType_t)), "pxTimeOut should be a valid pointer and xOverflowCount writable");
	__CPROVER_assert(__CPROVER_w_ok(&(pxTimeOut->xTimeOnEntering), sizeof(TickType_t)), "pxTimeOut should be a valid pointer and xTimeOnEntering writable");
	xQueue->uxMessagesWaiting = nondet_BaseType_t();
}

void harness(){
	vInitTaskCheckForTimeOut(0, QUEUE_RECEIVE_BOUND - 1);

	xQueue = xUnconstrainedQueueBoundedItemSize(MAX_ITEM_SIZE);


	TickType_t xTicksToWait;
	if(xState == taskSCHEDULER_SUSPENDED){
		xTicksToWait = 0;
	}

    if(xQueue){
		xQueue->cTxLock = LOCK_BOUND - 1;
		xQueue->cRxLock = LOCK_BOUND - 1;

    	void *pvBuffer = pvPortMalloc(xQueue->uxItemSize);
    	if(!pvBuffer){
    		xQueue->uxItemSize = 0;
    	}
    	xQueueReceive( xQueue, pvBuffer, xTicksToWait );
    }

}