GenMC is a stateless model checker for C programs that works on the level of LLVM Intermediate Representation.
This repository mirrors an internal repository and is only updated periodically. For changes between different versions please refer to the CHANGELOG.
Author: Michalis Kokologiannakis.
To pull a container containing GenMC from Docker Hub please issue the following command:
docker pull genmc/genmc
You will need a C++20-compliant compiler and an LLVM installation. The LLVM versions currently supported are: 10.0.1, 11.0.0, 12.0.1, 13.0.0, 14.0.0, 15.0.0, 16.0.0 (deprecated: 7.0.1, 8.0.1, 9.0.1).
In order to use the tool on a Debian-based installation, you need the following packages:
autoconf automake clang llvm llvm-dev libffi-dev
brew, the following packages are necessary:
autoconf automake llvm libffi
For a default build issue:
This will leave the
genmc executable in the build directory.
You can either run it from there (as in the examples below), or issue
Alternatively, the following following command will build the
executable in parallel and will also run a subset of all the tests
that come with the system to see if the system was built correctly or
make -j check
For a default build issue:
To see a list of available options run:
To run a particular testcase run:
./genmc [options] <file>
For more detailed usage examples please refer to the manual.
Undefined references to symbols that involve types
This probably indicates that you are using an old version of LLVM with a new version of libstdc++. Configuring with the following flags should fix the problem:
CXXFLAGS="-D_GLIBCXX_USE_CXX11_ABI=0" ./configure --with-llvm=LLVM_PATH
Linking problems under Arch Linux:
Arch Linux does not provide the
libclang*.afiles required for linking against
clanglibraries. In order to for linking to succeed, please change the last line in
src/Makefile.amto the following:
genmc_LDADD = libgenmc.a -lclang-cpp
GenMC (with the exception of some files, see Exceptions) is distributed under the GPL, version 3 or (at your option) later. Please see the COPYING file for details on GPLv3.
Part of the code in the files listed below are originating from the LLVM Compiler Framework, version 3.5. These parts are licensed under the University of Illinois/NCSA Open Source License as well as under GPLv3. Please see the LLVMLICENSE file for details on the University of Illinois/NCSA Open Source License.
Additionally, the files within the
include directory are licensed
under their own licenses.
Please see the respective header for more information on a specific file's license.
For feedback, questions, and bug reports please send an e-mail to
michalis AT mpi-sws DOT org.