Skip to content

K Framework Release 5.3.54
Compare
Choose a tag to compare
@rv-jenkins rv-jenkins released this 23 May 11:20
· 4300 commits to master since this release
v5.3.54
707c9a0

Installing the K Framework Package

We currently strive to provide packages for the following platforms:

  • Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
  • Debian Bullseye
  • Arch Linux
  • MacOS X Mojave/Homewbrew
  • Docker Images

Pre-installation Notes

  • We do not currently support running K natively on Windows. To use K on
    Windows 10, you are encouraged to install the
    Windows Subsystem for Linux (version 2)
    and follow the instructions for installing Ubuntu Focal.

    If you have already installed WSL, before proceeding, you will need to
    enter the WSL environment. You can do this by:

    1. opening up the command prompt (accessible by searching cmd or
      command prompt from the start menu);
    2. using the wsl.exe command to access the WSL environment.

  • To use K in other non-linux environments (e.g. Windows 8 or earlier),
    you will need to use a virtual machine (VM) software. We assume you have:

    1. Created a virtual machine
    2. Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
      virtual machine

    Consult your virtual machine software if you need help with the above
    steps. We recommend the free VirtualBox virtual machine software.

    Before proceeding, follow the virtual machine softare UI to start your
    Linux virtual machine and enter the command line environment.

  • WSL and virtual machine users should be aware that, if you use your web
    browser to download the package, you will need to make it accessible to
    the command line environment. For this reason, we recommend downloading the
    package from the command line directly using a tool like wget. For
    example, you could copy the package download URL and then type:

    wget <package-download-url>

    where <package-download-url> is replaced by the URL you just copied.

  • K depends on version 4.8.15 of Z3, which may not be supplied by package
    managers. If this is the case, it should be built and installed from source
    following the
    instructions in
    the Z3 repository. Other versions (older and newer) are not supported by K,
    and may lead to incorrect behaviour or performance issues.

Downloading Packages

Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master build.

Installing Packages

For version X.Y.Z, disto DISTRO, and package ID ID, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.

  • On Linux systems, K will typically be installed under /usr.
  • On macOS/brew, K will typically be installed under /usr/local.

Ubuntu Focal (20.04)

sudo apt install ./kframework_X.Y.Z_amd64_focal.deb

Ubuntu Jammy (22.04)

sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb

Debian Bullseye

sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb

Arch Linux

pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst

MacOS X Mojave/Homebrew

Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.

With brew installed, do the following to install the K Framework brew package
(with build number BN):

brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v

Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.

Homebrew Alternate Installation

To directly install the latest K Framework brew package without needing to
download it separately, do the following:

brew install kframework/k/kframework

Or, to streamline future K Framework upgrades, you can tap the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.

brew tap kframework/k
brew install kframework

Docker Images

Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.

Each release at COMMIT_ID has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID.
The latest master build Docker image can be accessed with COMMIT_ID set to
master.

To run the image directly:

docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID

and to make a Docker Image based on it, use the following line in your
Dockerfile:

FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID

We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID tags.

Testing Packages

The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.

  1. Start by copying the K tutorial to some work directory
    (e.g. $HOME/pl-tutorial) from the K distribution root. Using a Linux
    package, this command typically will be like:

    $ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial

    On macOS/brew, this command typically will be like:

    $ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial

    This step is needed because sometimes only the root user can run the
    examples in the default installation directory.

  2. Now you can try to run some programs:

    $ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped
$ make kompile
$ krun tests/diverse/factorial.simple
Assets 10
Loading