replica
/
diffblue-cbmc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
diffblue-cbmc/jbmc/README.md

55 lines
1.6 KiB
Markdown
Raw Normal View History

Add JBMC README
2018-05-16 16:58:23 +08:00
[![Build Status][travis_img]][travis] [![Build Status][appveyor_img]][appveyor]
About
=====
JBMC is a Bounded Model Checker for Java programs. It supports
checking for runtime exceptions and user-definde assertions.
The verification is performed by unwinding the loops in the program
and passing the resulting equation to a decision procedure.
[More info...](http://www.cprover.org/jbmc)
Versions
========
Get the [latest release](https://github.com/diffblue/cbmc/releases)
* Releases are tested and for production use.
Get the current *develop* version: `git clone https://github.com/diffblue/cbmc.git`
* Develop versions are not recommended for production use.
Prerequisites
============
JBMC compiles CBMC as part of its build process and as such has all the pre-requisites of CBMC. These can be viewed at: [diffblue/cbmc:COMPILING](http://github.com/diffblue/cbmc/blob/master/COMPILING)
Compilation
===========
To compile you need to run the command:
```bash
JBMC: Added java-models-library dependency This commit adds a dependency to the java-models-library (https://github.com/diffblue/java-models-library). This repository contains models for number of classes derived from the java standard library. These models are needed to support concurrency. This means that the process of building JBMC has changed slightly as one first needs to download the java-models-library. I.E: make -C jbmc/src java-models-library-download make -C jbmc/src Due possible licensing issues, the ability to automatically embed the java core models into JBMC has been removed. Instead, one must explicitly use the '--classpath' option to load the models. Consequently, the '--no-core-models' option and related code was removed as it is no longer relevant. Commit also adds a new make target, 'make dist'. This target in addition to building jbmc will create a 'dist' directory with two sub-folders, bin and lib. Executables will be copied to the former, while 'core-models.jar' will copied to the latter. Note: src/org/cprover/CProver.java has also been removed as this has been superseded by the CProver.java in the java-models-library.
2018-05-22 23:40:13 +08:00
make -C jbmc/src java-models-library-download
Add JBMC README
2018-05-16 16:58:23 +08:00
make -C jbmc/src
```
JBMC: Added java-models-library dependency This commit adds a dependency to the java-models-library (https://github.com/diffblue/java-models-library). This repository contains models for number of classes derived from the java standard library. These models are needed to support concurrency. This means that the process of building JBMC has changed slightly as one first needs to download the java-models-library. I.E: make -C jbmc/src java-models-library-download make -C jbmc/src Due possible licensing issues, the ability to automatically embed the java core models into JBMC has been removed. Instead, one must explicitly use the '--classpath' option to load the models. Consequently, the '--no-core-models' option and related code was removed as it is no longer relevant. Commit also adds a new make target, 'make dist'. This target in addition to building jbmc will create a 'dist' directory with two sub-folders, bin and lib. Executables will be copied to the former, while 'core-models.jar' will copied to the latter. Note: src/org/cprover/CProver.java has also been removed as this has been superseded by the CProver.java in the java-models-library.
2018-05-22 23:40:13 +08:00
Add JBMC README
2018-05-16 16:58:23 +08:00
Output
======
Compiling produces an executable called `jbmc` which by default can be found in `jbmc/src/jbmc/jbmc`
Reporting bugs and contributing to the code base
================================================
See [CBMC](https://github.com/diffblue/cbmc/blob/develop/README.md))
License
=======
4-clause BSD license, see `LICENSE` file.
[travis]: https://travis-ci.org/diffblue/cbmc
[travis_img]: https://travis-ci.org/diffblue/cbmc.svg?branch=develop
[appveyor]: https://ci.appveyor.com/project/diffblue/cbmc/
[appveyor_img]: https://ci.appveyor.com/api/projects/status/github/diffblue/cbmc?svg=true&branch=develop