The VerCors verification toolset for verifying parallel and concurrent software
Switch branches/tags
Nothing to show
Clone or download
wytseoortwijn Merge pull request #145 from HenkMulder/win_fix
Update Windows runtime classpath for scala version 2.12
Latest commit eab0097 Dec 18, 2018

README.md

VerCors Verification Toolset

This repository hosts VerCors, a toolset for the verification of concurrent and parallel programs. VerCors aims to verify many different concurrency constructs, including: heterogeneous concurrency (Java and C), GPU kernels using barriers and atomics (OpenCL), and compiler directives as used in deterministic parallelism (OpenMP). VerCors is able to prove data-race freedom, memory safety, and functional correctness of (concurrent) programs written in Java, C, OpenCL, OpenMP, and PVL (Prototypal Verification Language, a procedural toy language for prototyping new verification features). Moreover, VerCors is designed to be language-independent, which makes adding new front-end languages a straightforward engineering effort.

A list of verified examples and case studies is maintained online and can be found here. This webpage also contains an online interface for VerCors and allows to try VerCors online.

Installation Instructions

The VerCors toolset can be installed and used on MacOS X, Linux, and Windows (via Cygwin). When using Windows make sure that the environment variable JAVA_HOME is configured. A basic installation requires:

If you have these requirements, proceed to 'Building'. On MacOS X, the easiest way to get them is:

  1. Be sure to have installed Homebrew
  2. brew tap homebrew/cask-versions
  3. brew cask install java8
  4. brew install ant
  5. Rest of the instructions below

Building

For a basic build of VerCors the following steps should be taken:

  1. Clone the VerCors repository using git clone https://github.com/utwente-fmt/vercors.git and move into the cloned directory, cd vercors.
  2. Build VerCors with Ant by running ant clean, followed by ant.
  3. Test whether the build was successful by running ./unix/bin/vct --test=examples/manual --tool=silicon --lang=pvl,java.

The last command tests the VerCors installation by verifying a large collection of examples (from the ./examples directory). This command should eventually report that all ? tests passed.

Usage instructions

VerCors verifies programs that are annotated with JML-style specifications (the underlying theory uses separation logic with permission accounting). Details on the specification language can be found on the VerCors Wiki pages. Furthermore, a large collection of example programs can be found (and verified) in the ./examples directory.

The VerCors toolset can be used from the main directory by running ./unix/bin/vct --silver=silicon <filepath>, with <filepath> the path of the (Java, C, or PVL) file to verify.

Contact

Related papers

A complete list of papers on the VerCors project is given here.

License

Copyright (c) 2008 - 2018 Formal Methods and Tools, University of Twente All rights reserved.

The license to VerCors is a mozilla open source license as described in LICENSE.TXT in the root of this project. It is a free to use, share-alike license. Should this license be too restrictive for your purpose, please let us know by creating an issue in our bug tracker. Direct contributors (people who send us pull-requests or edit this repository directly) are expected to agree with any license that the University of Twente might decide. If you do not agree with future license changes, please instead fork this repository as allowed under the conditions of LICENSE.TXT.