File: README.md

package info (click to toggle)
haskell-what4 1.5.1-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,240 kB
  • sloc: haskell: 34,630; makefile: 5
file content (23 lines) | stat: -rw-r--r-- 1,090 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# Bitvector Abstract Domain Formalization

The module `What4.Utils.BVDomain` implements an abstract domain for
sized bitvectors, using an interval-based representation. Many of the
algorithms in this module are subtle and not obviously correct.

To increase confidence in the correctness of that code, the file
`bvdomain.cry` in this directory contains a formalization of those
algorithms in Cryptol (<https://cryptol.net>).

Use the following command to prove all of the correctness properties
in the Cryptol specification using the z3 prover:

    cryptol bvdomain.cry -c :prove

NOTE: This verification only asserts the correctness of the Cryptol
specification, not of the actual Haskell implementation; the
correspondence between the Haskell and Cryptol versions must be
checked by manual inspection. Keep in mind that the Haskell version
uses the unbounded `Integer` type throughout, and uses bitwise masking
to reduce modulo 2^n; on the other hand, the Cryptol code uses
fixed-width bitvector types where this masking is implicit. Otherwise
the structure of the code is very similar.