Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
jStar is a verification tool based on separation logic.
OCaml Java Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
doc
lib
library
playground
scripts
src
unit_tests
.gitignore
COPYRIGHT
LICENSE.txt
Makefile
README
configure
setjstarenv
setjstarenv.bat

README

The jStar Verifier
==================

jStar is a highly-customisable automatic verification tool based on separation
logic aiming at object-oriented programs written in Java.

There is a tutorial for the tool here:
   ./doc/tutorial/jstartut.pdf

For more information, see http://www.jstarverifier.org



Building on *nix / Mac OSX
---------------------------

Use the standard incantation.
  ./configure --prefix DIR
  make install

(NOTE: In some environments, such as Mac OS Leopard, dynlink.cmxa is
unavailable, leading to a compile error. In that case, try "make install.byte".)

Assuming that DIR/bin is in your path, you should now be able to run jStar.
  jstar

Optionally, run the tests to see that all is OK.
  make test

Dependencies:

* OCaml >=3.11
  http://caml.inria.fr/download.en.html
  Debian / Ubuntu: ocaml, ocaml-native-compilers



Building on Win32
-----------------

Open the Visual Studio Command Prompt. 
 - If you obtained Microsoft tools not as a part of Visual Studio, just open
   Command Prompt and manually set up necessary PATH and INCLUDE directories.)

Check that the make tool is in path.
 - If using Cywgin/MinGW based make, then just add Cygwin/MinGW bin directory
   to path. In addition, set the LIB environment variable to empty. This is
   due to problems that arise when make deals with directories containing
   empty spaces (like "Program Files"). You will probably have to manually set
   up additional include path for OCaml compiler to Visual C++ Runtime
   Libraries and Windows SDK libraries.

To run the build process, call: 
  make build

To set the environment variables necessary for jStar to run:
  setjstarenv.bat

After the build process has finished, you may have to add extension .exe to
compiled binaries located in jStar's bin subdirectory.


Dependencies:

* Microsoft-based native Win32 port of OCaml: 
  http://caml.inria.fr/pub/distrib/ocaml-3.11/ocaml-3.11.0-win-msvc.exe

* FlexDLL: http://alain.frisch.fr/flexdll.html
  (solves the problem that Windows DLL cannot refer to symbols defined
  in the main application or in previously loaded DLLs)

* Microsoft Macro Assembler (ml.exe), Microsoft Visual C++ and 
  Microsoft Windows SDK libraries. (if you are not using Visual Studio,
  these tools can be obtained for free at Microsoft site)

* Unix make tool (e.g., the one distributed with Cygwin or MinGW)
Something went wrong with that request. Please try again.