Sail is a language for describing the instruction-set architecture (ISA) semantics of processors. Sail aims to provide a engineer-friendly, vendor-pseudocode-like language for describing instruction semantics. It is essentially a first-order imperative language, but with lightweight dependent typing for numeric types and bitvector lengths, which are automatically checked using Z3. It has been used for several papers, available from http://www.cl.cam.ac.uk/~pes20/sail/.

This repository contains the Coq support library for models produced by Sail for the Coq theorem prover. The main Sail repository contains the Sail tool for processing Sail specifications and translating them into Coq.

We suggest using the opam package manager if you also used it to install Coq. See the instructions on using opam with Coq for more information. The coq-sail package depends on the coq-bbv package for its implementation of bitvectors.

It's also possible to build the library locally without opam using the Makefile in the src directory. You can also change the bitvector library used by changing the src/MachineWord.v symbolic link.

An opam package is also available using the stdpp-unstable bitvector library. It changes the Coq library name so that it can be installed alongside the BBV version, so references to Sail in the models should be replaced by SailStdpp. Sail can do this when generating Coq output using the arguments -coq_alt_modules SailStdpp.Base -coq_alt_modules SailStdpp.Real.

The library has the same licensing terms as the main Sail tool. These can be found in LICENSE.

This work was partially supported by the UK Government Industrial Strategy Challenge Fund (ISCF) under the Digital Security by Design (DSbD) Programme, to deliver a DSbDtech enabled digital platform (grant 105694). This project has received funding from the European Research Council (ERC) under the European Union’s Horizon 2020 research and innovation programme (grant agreement No 789108, ELVER). This work was partially supported by EPSRC grant EP/K008528/1 REMS: Rigorous Engineering for Mainstream Systems, an ARM iCASE award, and EPSRC IAA KTF funding. This work was partially supported by donations from Arm and Google. Approved for public release; distribution is unlimited. This research is sponsored by the Defense Advanced Research Projects Agency (DARPA) and the Air Force Research Laboratory (AFRL), under contracts FA8750-10-C-0237 ("CTSRD") and FA8650-18-C-7809 ("CIFV"). The views, opinions, and/or findings contained in these articles OR presentations are those of the author(s)/presenter(s) and should not be interpreted as representing the official views or policies of the Department of Defense or the U.S. Government.