DOI: 10.5281/zenodo.702959
title: Hardware Synthesis of Weakly Consistent C Concurrency

description: Hardware Synthesis of Weakly Consistency C Concurrency

This webpage contains additional material for the paper Hardware Synthesis of Weakly Consistent C Concurrency (FPGA17paper.pdf). 

Contents


	Verifying that our scheduling constraints implement the C11 standard
	Verifying the lock-free circular buffer
	Motivating examples
	Experimental Data


1. Verifying that our scheduling constraints implement the C11 standard

As explained in Section 4.4, we have used the Alloy tool to verify that our scheduling constraints are sufficient to implement the memory consistency model defined by the C11 standard. In alloy.zip, we provide the Alloy model files that we used. The first four are taken from Wickerson et al.'s work on comparing memory consistency models; the fifth is new.


	relations.als contains helper functions.
	exec.als encodes general program executions.
	exec_C.als encodes C11 program executions.
	c11.als encodes the constraints imposed by the C11 memory consistency model.
	question.als encodes our scheduling constraints, and several queries for checking that these scheduling constraints are strong enough to enforce the constraints required by the C11 memory consistency model.


To reproduce our result, save the five files above into the same directory, download Alloy, open question.als in Alloy, and run the queries contained within.

2. Verifying the lock-free circular buffer

As explained in Section 5.1, we have used the CppMem tool to verify that our case-study application, a lock-free circular buffer, is free from data races. In order to make the verification feasible, we removed the while-loop, replaced the array variable with a scalar, removed some unimportant local variables, and simplified the increment function. Below, we give the actual code that we verified.<br>
<br>
int main() {<br>
  atomic_int tail = 0;<br>
  atomic_int head = 0;<br>
  int arr = 0;<br>
  {{{ {<br>
    int chead = head.load(memory_order_acquire);<br>
    int ctail = tail.load(memory_order_relaxed);<br>
    if (ctail+1 != chead) {<br>
      arr = 42;<br>
      tail.store(ctail+1, memory_order_release);<br>
    }<br>
  } ||| {<br>
    int ctail = tail.load(memory_order_acquire);<br>
    int chead = head.load(memory_order_relaxed);<br>
    if (ctail != chead) {<br>
      arr;<br>
      head.store(chead+1, memory_order_release);<br>
    }<br>
  } }}}<br>
  return 0;<br>
}

To reproduce our result, paste the code above into CppMem's web interface and click Run. The tool should report (after a couple of minutes) that the code has 92 candidate executions, of which two are consistent, neither of which exhibit data races.

3. Motivating Examples

We provide the actual code that displays coherence and message-passing violation in motivating-examples.zip, as described in Section 2 of our paper. These examples have been tested and verified on LegUp's VM. For convenience, we have included the output logs of each experiment for viewing. We include a "transcript" of the execution and a schedule trace, which can be visualised using LegUp's scheduleviewer.

4. Experimental Data

We also provide the raw experiment data from Section 5 of our paper. We conduct two experiments, for which we provided raw data on all seven design points.


	chaining.csv contains the raw data for the chaining experiment.
	bursting.csv contains the raw data for the bursting experiment.
	The version number are from 1 to 7 for Unsound, SC, OMP criticals, SC atomics, Weak atomics, Mutexes and OMP atomics respectively.