adbrucker
/
lh-l4v
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
lh-l4v/spec/cspec
History
Matthew Brecknell 16f87e04fe regression: use python3 for mk_umm_types 
I previously updated the `#!` in `mk_umm_types.py` to use `python3`, but
forgot to remove the explicit `python` call from `kernel.mk`.

Signed-off-by: Matthew Brecknell <Matthew.Brecknell@data61.csiro.au>
 		2020-08-10 13:45:35 +10:00
..
ARM licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
ARM_HYP licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
RISCV64 riscv cspec/crefine: update ctcb_size_bits to 9 2020-06-08 20:41:09 +08:00
X64 licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
c regression: use python3 for mk_umm_types 2020-08-10 13:45:35 +10:00
KernelInc_C.thy licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
KernelState_C.thy licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
README.md license: provide documentation under CC-BY-SA-4.0 2020-03-16 14:19:15 +08:00
Substitute.thy licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
TypHeapLimits.thy licenses: convert license tags to SPDX 2020-03-13 14:38:24 +08:00
mk_umm_types.py regression: force use of python3 2020-04-01 14:31:36 +11:00

README.md

The C Semantics of seL4

l4v/spec/cspec/

This directory contains the entry point for the automatic translation of the seL4 source code into Isabelle/HOL.

The C semantics of the kernel is produced by first configuring and preprocessing the C sources for a specific platform and then parsing it into Isabelle using the C parser in l4v/tools/c-parser.

To inspect the output of this translation, build the image CSpec and interactively inspect the constants the parser has defined.

Top-Level Theory

The top-level theory file for this module is Kernel_C for the bare translation of seL4 into Isabelle, and KernelInc_C for additional automatic proofs about generated bitfield functions.

Building

The corresponding Isabelle sessions for this module are CKernel and CSpec. CSpec contains CKernel plus automated bitfield proofs.

To build the image, run the corresponding session in directory l4v/spec, e.g.:

make CSpec

This will also configure and preprocess the kernel sources.

Expect this build to take about 30 min on a modern machine and to require close to 4GB of memory. For further sessions building on top of CSpec, usually at least 16GB of main memory are required together with a 64-bit setup of Isabelle.

The target architecture may be specified by setting the L4V_ARCH environment variable. It determines both which configuration of seL4 is used, as well as indicating the architecture-specific definitions and proofs to use. The default architecture is ARM and will be selected if none is provided. See l4v/spec/cspec/c/Makefile for seL4 configuration details.

Remarks

To speed up interactive development, the bitfield code generator can be configured to skip the corresponding proofs and produce sorried (unproven) property statements only. To achieve this, set the environment variable SORRY_BITFIELD_PROOFS to TRUE.