Skip to content

Installation

Mull ships as three kinds of packages:

  • mull: mull-runner and mull-reporter, which work with any LLVM version
  • mull-<N>: the compiler plugin for LLVM <N>, which pulls in mull
  • mull-extras-<N>: optional tools for LLVM <N>, which pull in mull: mull-instrument-<N> adds mutants to LLVM bitcode, mull-rewriter-<N> writes the mutants of a report into the sources

To install a precompiled package run one of the following commands.

The version number at the end must match the version of Clang/LLVM used.

Terminal window
# macOS
brew install mull-project/mull/mull@19
Terminal window
# Debian / Ubuntu
curl -1sLf 'https://dl.cloudsmith.io/public/mull-project/mull-stable/setup.deb.sh' | sudo -E bash
sudo apt-get install mull-19
Terminal window
# RedHat
curl -1sLf 'https://dl.cloudsmith.io/public/mull-project/mull-stable/setup.rpm.sh' | sudo -E bash
sudo yum install mull-19

The optional tools install the same way: brew install mull-project/mull/mull-extras@19, sudo apt-get install mull-extras-19 or sudo yum install mull-extras-19.

If these fail with 402 Payment Required, see Cloudsmith bandwidth limit.

Check the installation:

Terminal window
mull-runner --version

The output should look similar:

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)