Skip to main content

Command line tool for testing Linux under QEMU

Project description

TuxRun Logo

Pipeline Status coverage report PyPI version Code style: black PyPI - License

Documentation - Repository - Issues

TuxRun, by Linaro, is a command line tool for testing Linux on QEMU or FVP, using curated test suites. TuxRun is a part of TuxSuite, a suite of tools and services to help with Linux kernel development.

[[TOC]]

About TuxRun

Testing the Linux kernel is as simple as using QEMU but it gets complicated when you want to support the following combinations:

  • Architectures (arm64, armv5, armv7, i386, mips32, mips32el, mips64, mips64el, ppc32, ppc64, ppc64le, riscv64, sparc64, x86_64)

  • Emulation systems (QEMU or FVP)

  • Tests (every test suite has dependencies on the rootfs)

Each of those items requires specific configuration and root file systems. In order to allow for reproducible tests, TuxRun uses containers runtimes (Docker or Podman).

Installing TuxRun

There are several options for installing TuxMake:

Using TuxRun

To use TuxRun, compile your own linux kernel for arm64, for example using TuxMake.

Then call tuxrun:

tuxrun --device qemu-arm64 --kernel /path/to/Image

TuxRun will automatically start qemu-system with the right arguments and the right root filesystem.

Examples

Boot test a mipsel kernel at https://mykernel.org/vmlinux:

tuxrun --device qemu-mips32el \
       --kernel https://mykernel.org/vmlinux

Running ltp-smoke:

tuxrun --device qemu-mips32el \
       --kernel https://mykernel.org/vmlinux \
       --test ltp-smoke

Using a custom root file system

tuxrun --device qemu-mips32el \
       --kernel https://mykernel.org/vmlinux \
       --rootfs https://mykernel.org/rootfs.tar.xz

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tuxrun, version 0.15.3
Filename, size File type Python version Upload date Hashes
Filename, size tuxrun-0.15.3-py3-none-any.whl (37.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tuxrun-0.15.3.tar.gz (53.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page