https://github.com/appliedfm/coq-vsu-int_or_ptr
https://github.com/appliedfm/coq-vsu-int_or_ptr
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/appliedfm/coq-vsu-int_or_ptr
- Owner: appliedfm
- License: mit
- Created: 2022-02-03T00:00:17.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-03-04T04:59:56.000Z (over 4 years ago)
- Last Synced: 2024-12-31T01:42:12.616Z (over 1 year ago)
- Language: Coq
- Size: 49.8 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# coq-vsu-int_or_ptr
[](https://github.com/appliedfm/coq-vsu-int_or_ptr/actions/workflows/build.yml)
A [Verified Software Unit](https://github.com/appliedfm/coq-vsu) for using aligned pointers as integers.
Implemented in C, modeled in [Coq](https://coq.inria.fr), and proven correct using the [Verified Software Toolchain](https://vst.cs.princeton.edu/).
Compatible with [CompCert](https://compcert.org/).
## Verification status
Specifications are provided for the following targets:
- [x] `x86_64-linux`
- [x] `x86_32-linux`
Proofs are checked by our [CI infrastructure](https://github.com/appliedfm/coq-vsu-int_or_ptr/actions/workflows/build.yml).
## Packages
* `coq-vsu-int_or_ptr-src` - C source code
* `coq-vsu-int_or_ptr-vst` - VST model, spec, & proof (`x86_64-linux`)
* `coq-vsu-int_or_ptr-vst-32` - VST model, spec, & proof (`x86_32-linux`)
## Installing
Installation is performed by `opam` with help by [coq-vsu](https://github.com/appliedfm/coq-vsu).
```console
$ opam pin -n -y .
$ opam install coq-vsu-int_or_ptr-vst coq-vsu-int_or_ptr-vst-32
```
## Using the C library
The C library is installed to the path given by `vsu -I`. For example:
```console
$ tree `vsu -I`
/home/tcarstens/.opam/coq-8.14/lib/coq-vsu/lib/include
└── coq-vsu-int_or_ptr
├── int_or_ptr.h
└── src
└── int_or_ptr.c
2 directories, 2 files
$
```
## Using the Coq library
The `coq-vsu-int_or_ptr-vst` and `coq-vsu-int_or_ptr-vst-32` are both target-specific. As such, they are sometimes installed into locations outside of Coq's search path. Fortunately, these libraries can be found by calling `vsu --show-coq-variant-path=PACKAGE`. For example:
```console
$ echo `vsu --show-coq-variant-path=coq-vsu-int_or_ptr-vst-32`
/home/tcarstens/.opam/coq-8.14/lib/coq/../coq-variant/appliedfm/32/int_or_ptr
$
```
The `vsu` tool can also be used to supply Coq with the correct arguments for importing the target-specific libraries. For example:
```
$ tcarstens@pop-os:~/formal_methods/coq-vsu-int_or_ptr$ coqtop \
`vsu -Q coq-vsu-int_or_ptr-vst-32` \
`vsu -Q coq-compcert-32` \
`vsu -Q coq-vst-32`
Welcome to Coq 8.14.0
Coq < From VST Require Import floyd.proofauto.
Coq < From appliedfm Require Import int_or_ptr.vst.spec.spec.
Coq < Check int_or_ptr__is_int_spec.
int_or_ptr__is_int_spec
: ident * funspec
Coq <
```
## Building without `opam`
The general pattern looks like this:
```console
$ make [verydeepclean|deepclean|clean]
$ make BITSIZE={opam|64|32} [all|_CoqProject|clightgen|theories]
```
`BITSIZE` determines which `compcert` target to use. If unspecified, the default value is `opam`:
* `opam` and `64` both use `x86_64-linux`
* `32` uses `x86_32-linux`
### Example: `x86_64-linux`
```console
$ make verydeepclean ; make
```
### Example: `x86_32-linux`
```console
$ make verydeepclean ; make BITSIZE=32
```
#
[](https://github.com/coq/coq)
[](https://compcert.org/)
[](https://vst.cs.princeton.edu/)
[](https://applied.fm)