Contents

• Introduction
• Language
• Semantics
• Tools

Introduction

What is CIVL?

CIVL stands for Concurrency Intermediate Verification Language. The CIVL platform encompasses:

1. the programming language CIVL-C, a dialect of C with additional primitives supporting concurrency, specification, and modeling;
2. verification and analysis tools, including a symbolic execution-based model checker for checking various properties of, or finding defects in, CIVL-C programs; and
3. tools that translate from commonly-used languages/APIs to CIVL-C.

A user can write programs in CIVL-C directly, or use one of the front-ends that translates from a "real" programming language to CIVL-C.

When used in the first way, CIVL-C may be considered a modeling language, similar to Promela (the language used by the model checker Spin). This is useful for exploring and verifying algorithms, especially concurrent algorithms. The main difference between CIVL-C and Promela is that CIVL-C includes almost all of the language constructs in C, including floating-point numbers, arrays of any type, structs, functions, pointers, dynamic allocation (malloc and free), and pointer arithmetic. Like Spin, the CIVL verifier can be used to perform an exhaustive search of a state space. Unlike Spin, the CIVL verifier uses symbolic execution, so in a CIVL state, variables may be assigned symbolic expressions, not just concrete values. This allows the verifier to check properties of the form the assertions hold for all possible inputs and the two given programs are functionally equivalent.

When used in the second way, a C program using MPI, CUDA, OpenMP, or Pthreads, (or even some combination of these APIs), will be automatically translated into CIVL-C and then verified. The advantages of such a framework are clear: the developer of a new verification technique could implement it for CIVL-C and then immediately see its impact across a broad range of concurrent programs. Likewise, when a new concurrency API is introduced, one only needs to implement a translator from it to CIVL-C in order to reap the benefits of all the verification tools in the platform. Programmers would have a valuable verification and debugging tool, while API designers could use CIVL as a "sandbox" to investigate possible API modifications, additions, and interactions.

This manual covers all aspects of the CIVL framework, and is organized in parts as follows:

1. this introduction, including "quick start" instructions for downloading and installing CIVL and several examples;
2. a complete description of the CIVL-C language;
3. a formal semantics for the language; and
4. a description of the tools in the framework.

Installation and Quick Start

# Install the automated theorem prover CVC4, following instructions at ​http://cvc4.cs.stanford.edu/web/. You only need the binary (cvc4), which must be in your PATH. # Install the automated theorem prover Z3, following instructions at ​https://github.com/Z3Prover/z3. You only need the binary (z3), which must be in your PATH. # Install a Java 8 SDK. Later versions of Java may also work. See ​https://www.oracle.com/technetwork/java/javase/downloads/index.html. # Download and unpack the latest stable release of CIVL from ​http://vsl.cis.udel.edu/lib/sw/civl/current/latest/release/.

Examples

Verifying Programs

Verifying C Programs

Verifying C/MPI Programs

Verifying C/OpenMP Programs

Verifying CUDA-C Programs

Verifying C/Pthreads Programs

Verifying Fortran Programs

(under development)

Language

Semantics

Tools