Installation

Note

Looking for help? We’ve got you covered! ❤️

Precompiled packages (arm64 and x86_64) are available on Cloudsmith and on GitHub.

Please, refer to the Hacking on Mull to build Mull from sources.

Install on Linux

The following examples setup mull repos on deb- and rpm-based systems, respectively:

# Ubuntu / Debian
curl -1sLf 'https://dl.cloudsmith.io/public/mull-project/mull-stable/setup.deb.sh' | sudo -E bash
# Red Hat
curl -1sLf 'https://dl.cloudsmith.io/public/mull-project/mull-stable/setup.rpm.sh' | sudo -E bash

Mull ships as two kinds of packages:

• mull: mull-runner and mull-reporter, which work with any LLVM version

• mull-<N>: the compiler plugin and mull-instrument for LLVM <N>, which pull in mull

Install the plugin for your LLVM version:

# Ubuntu / Debian
sudo apt-get update && apt-get install mull-19
# Red Hat
sudo yum update && yum install mull-21

Check if everything works:

$ mull-runner --version
mull-runner 0.36.0

Mull: Practical mutation testing and fault injection for C and C++
Home: https://mull-project.com
Plugins:
  /usr/lib/mull-ir-frontend-19 (mull 0.36.0, LLVM 19.1.7)

Note

Before 0.36.0 the tools had versioned names (mull-runner-19). They are still installed as symlinks to mull-runner and mull-reporter, but will be removed in a future release.

Install from GitHub Releases

The same packages are attached to every GitHub release, in case Cloudsmith is unavailable. Download mull (Mull-<version>-<os>-<arch>-<os version>) and the plugin for your LLVM version (Mull-<N>-<version>-LLVM-<N.x.y>-<os>-<arch>-<os version>), then install both files so that the package manager pulls in their dependencies:

# Ubuntu 24.04, x86_64, LLVM 19
gh release download 0.36.0 --repo mull-project/mull \
  --pattern 'Mull-0.36.0-ubuntu-amd64-24.04.deb' \
  --pattern 'Mull-19-0.36.0-*-ubuntu-amd64-24.04.deb'
sudo apt-get install ./Mull-*.deb

# RHEL 9.6, x86_64, LLVM 21
gh release download 0.36.0 --repo mull-project/mull \
  --pattern 'Mull-0.36.0-rhel-amd64-9.6.rpm' \
  --pattern 'Mull-21-0.36.0-*-rhel-amd64-9.6.rpm'
sudo dnf install ./Mull-*.rpm

Without gh, download the same files from the release page. Packages installed this way don’t get updates, so repeat the steps to upgrade.

Install on macOS

Use Homebrew, or download the latest version from GitHub Releases.

$ brew install mull-project/mull/mull@19
$ mull-runner --version
mull-runner 0.36.0

Mull: Practical mutation testing and fault injection for C and C++
Home: https://mull-project.com
Plugins:
  /opt/homebrew/lib/mull-ir-frontend-19 (mull 0.36.0, LLVM 19.1.7)