ACTRIS COQ DEVELOPMENT
This directory contains the artifact for the paper "Actris: Session Type Based Reasoning in Separation Logic".
It has been built and tested with the following dependencies
In order to build, install the above dependencies and then run
make -j [num CPU cores]
to compile Actris.
Theory of Actris
The theory of Actris (semantics of channels, the CPS model, and the proof rules) can be found in the directory theories/channel. The files correspond to the following parts of the paper:
- theories/channel/channel.v: The definitional semantics of bidirectional channels in terms of Iris's HeapLang language.
- theories/channel/proto_model.v: The CPS model of Dependent Separation Protocols.
-
theories/channel/proto_channel.v: The
definition of the connective
↣
for channel ownership, and lemmas corresponding to the Actris proof rules. The relevant proof rules are as follows:-
new_chan_proto_spec
: proof rule fornew_chan
. -
send_proto_spec
andsend_proto_spec_packed
: proof rules forsend
, the first version is more convenient to use in Coq, but otherwise the same assend_proto_spec_packed
, which is the rule in the paper. -
recv_proto_spec
andrecv_proto_spec_packed
: proof rules forrecv
, the first version is more convenient to use in Coq, but otherwise the same asrecv_proto_spec_packed
, which is the rule in the paper. -
select_spec
: proof rule forselect
. -
branch_spec
: proof rule forbranch
.
-
Weakest preconditions and Coq tactics
The presentation of Actris logic in the paper makes use of Hoare triples. In Coq, we make use of weakest preconditions because these are more convenient for interactive theorem proving using the the proof mode tactics. To state concise program specifications, we use the notion of Texan Triples from Iris, which provides a convenient "Hoare triple"-like syntax around weakest preconditions:
{{{ P }}} e {{{ x .. y, RET v; Q }}} :=
□ ∀ Φ, P -∗ ▷ (∀ x .. y, Q -∗ Φ v) -∗ WP e {{ Φ }}
In order to prove programs using Actris, one can make use of a combination of Iris's symbolic execution tactics for HeapLang programs and Actris's symbolic execution tactics for message passing. The Actris tactics are as follows:
-
wp_send (t1 .. tn) with "selpat"
: symbolically executesend c v
by looking up ownership of a send protocolH : c ↣ <!> y1 .. yn, MSG v; {{ P }}; prot
in the proof mode context. The tactic instantiates the variablesy1 .. yn
using the termst1 .. tn
and usesselpat
to proveP
. If fewer termst
are given than variablesy
, they will be instantiated using existential variables (evars). The tactic will putH : c ↣ prot
back into the context. -
wp_recv (x1 .. xn) as "ipat"
: symbolically executerecv c
by looking upH : c ↣ <?> y1 .. yn, MSG v; {{ P }}; prot
in the proof mode context. The variablesy1 .. yn
are introduced asx1 .. xn
, and the predicateP
is introduced using the introduction patternipat
. The tactic will putH : c ↣ prot
back into the context. -
wp_select with "selpat"
: symbolically executeselect c b
by looking upH : c ↣ prot1 {Q1}<+>{Q2} prot2
in the proof mode context. The selection patternselpat
is used to resolve eitherQ1
orQ2
, based on the chosen branchb
. The tactic will putH : c ↣ prot1
orH : c ↣ prot2
back into the context based on the chosen branchb
. -
wp_branch as ipat1 | ipat2
: symbolically executebranch c e1 e2
by looking upH : c ↣ prot1 {Q1}<&>{Q2} prot2
in the proof mode context. The result of the tactic involves two subgoals, in whichQ1
andQ2
are introduced using the introduction patternsipat1
andipat2
, respectively. The tactic will putH : c ↣ prot1
andH : c ↣ prot2
back into the contexts of the two respectively goals.
Examples
The examples can be found in the direction theories/examples.
The following list gives a mapping between the examples in the paper and their mechanization in Coq:
- Introduction: theories/examples/basics.v
- Tour of Actris
- 2.3 Basic: theories/examples/sort.v
- 2.4 Higher-Order Functions: theories/examples/sort.v
- 2.5 Branching: theories/examples/sort_br_del.v
- 2.6 Recursion: theories/examples/sort_br_del.v
- 2.7 Delegation: theories/examples/sort_br_del.v
- 2.8 Dependent: theories/examples/sort_fg.v
- Manifest sharing via locks
- 3.1 Sample program: theories/examples/basics.v
- 3.2 Distributed mapper: theories/examples/map.v
- Case study: map reduce:
- Utilities for shuffling/grouping: theories/utils/group.v
- Implementation and verification: theories/examples/map_reduce.v
Differences between the formalization and the paper
There are a number of small differences between the paper presentation of Actris and the formalization in Coq, that are briefly discussed here.
-
Connectives for physical ownership of channels
In the paper, physical ownership of a channel is formalized using a single connective(c1,c2) ↣ (vs1,vs2)
, while the mechanization has two connectives for the endpoints and one for connecting them, namely:-
chan_own γ Left vs1
andchan_own γ Right vs1
-
is_chan N γ c1 c2
Here,γ
is a ghost name andN
an invariant name. This setup is less intuitive but gives rise to a more practical Jacobs/Piessens-style spec ofrecv
that does not need a closing view shift (to handle the case that the buffer is empty).
-
-
Later modalities in primitive rules for channels
The primitive rules forsend
andrecv
(send_spec
andrecv_spec
in theories/channel/channel.v) contain three later (▷
) modalities, which are omitted for brevity's sake in the paper. These later modalities expose that these operations perform at least three steps in the operational semantics, and are needed to deal with the three levels of indirection in the invariant for protocols:- the
▶
in the CPS encoding of protocols, - the higher-order ghost state used for ownership of protocols, and
- the opening of the protocol invariant.
- the