Skip to content

Student Lab 2026 ​

Welcome to the Gillian student lab!

This lab takes the Separation Logic and Compositional Symbolic Execution theory you've seen in the lectures, and re-contextualises it with a semi-automatic verification tool built with Gillian.

Getting started: Personal device ​

  1. Ensure the following is installed:

    • VSCode
    • Z3
      • This is available on most package managers (brew, apt-get, etc.) as z3
    • The current Gillian release: follow the link, then download and extract the relevant wisl and gillian-c2 archives for your system
  2. Clone the lab repository and open it in VSCode.

    bash
    git clone https://github.com/GillianPlatform/gillian-lab.git --branch STUDENT_2026
    code gillian-lab
  3. Install the Gillian VSCode extension.

  4. Make sure the extension is set up; in your VSCode settings, under 'Extensions' > 'The Gillian Platform':

    • If the wisl and gillian-c2 binaries aren't on your PATH, then set 'Bin Directory' to the directory containing those binaries
    • If z3 isn't on your PATH, then under the 'WISL' subsection, set add an environment variable Z3_EXEC, set to the path to the z3 binary
  5. Open an exercise file (such as 0a_intro_auto.wisl); you should see blue underlines that signify verification errors.

Getting started: Lab machine ​

  1. Copy the lab files to your home directory and open it in VSCode.

    bash
    cp -r /vol/rr/gillian-lab/26/exercises ~/gillian-lab
    code ~/gillian-lab
  2. Install the Gillian VSCode extension.

  3. Open an exercise file (such as 0a_intro_auto.wisl); you should see blue underlines that signify verification errors.

Misc. notes ​

  • The language server highlights compilation errors (and other unexpected problems) in red, and verification failures in blue.
  • The debugger supports breakpoints! This can be handy when restarting the debugger after making changes to your code; assign breakpoints to the relevant lines and click the Continue button .
  • If you get a SIGPIPE or "Broken pipe" error, try making a small change to your code and trying again.
    • Note from Nat: I have *absolutely no idea* why this happens. Even with a repro, it disappears if I try to track it down 🙃
  • If Gillian seems stuck or unresponsive, or if the WISL language server fails to start, try opening the Command Palette with (F1 or Ctrl+Shift+P by default) and running the "Reload window" command.