Using Colibri2 with Why3

Why3 is the main target of Colibri2: the goals of the benchmarks that guide its development are Why3 proofs of programs.

  1. Install Colibri2: put the static binary in your PATH under the name colibri2, or opam install colibri2.
  2. Let Why3 find it:
    why3 config detect
    

    Why3 calls colibri2 --version and chooses the driver that matches the version: colibri2.drv for Colibri2 0.7, colibri2_0_6.drv for 0.6, colibri2_0_5.drv for 0.4 and 0.5. It also adds the alternative colibri2,counterexamples, which asks for a model of an invalid goal.

    Colibri2 0.7 is known to the development version of Why3 (merge request !1412), and so to the Why3 releases after 1.9: its driver also translates the bitwise operations of int.Bitwise to the builtins of Colibri2. Why3 1.9 knows Colibri2 up to 0.6.

  3. Use it as any other prover, in the IDE or with why3 prove -P colibri2 file.mlw.

The driver translates some functions of the Why3 standard library to builtins of Colibri2 (absolute value, division and remainder rounded toward zero, square root, the conversions between bit-vectors and integers): see the builtins.

Options

Why3 runs colibri2 --time=<s> --size=<MB> --show-steps <file>. Useful options for a direct use (colibri2 --help lists them all):