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 the following virtual devices, using curated test suites.

  • AVH
  • FVP
  • QEMU

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, s390, sh4, sparc64, x86_64)

  • Emulation systems (QEMU or FVP or AVH)

  • 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 TuxRun:

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.

TuxLAVA Library

TuxRun uses TuxLAVA library to generate LAVA job definition files.

Known issues

Known issues when booting on different virtual platforms.

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


Release history Release notifications | RSS feed

Download files

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

Source Distribution

tuxrun-1.2.2.tar.gz (306.7 kB view details)

Uploaded Source

Built Distribution

tuxrun-1.2.2-py3-none-any.whl (24.9 kB view details)

Uploaded Python 3

File details

Details for the file tuxrun-1.2.2.tar.gz.

File metadata

  • Download URL: tuxrun-1.2.2.tar.gz
  • Upload date:
  • Size: 306.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.28.1

File hashes

Hashes for tuxrun-1.2.2.tar.gz
Algorithm Hash digest
SHA256 37c0565a66c0bd5ef84d22841fb43a83a007a1d26b80796815bc04503514871e
MD5 981a7917b327cd9f115b8ea03d429e9f
BLAKE2b-256 5ed37b9128241ef695fb892b8ca946a4d81b7ebb366bc868406c2b6ebd913b14

See more details on using hashes here.

File details

Details for the file tuxrun-1.2.2-py3-none-any.whl.

File metadata

  • Download URL: tuxrun-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 24.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.28.1

File hashes

Hashes for tuxrun-1.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5e56afe9fec2b74855e453c295e040200b947060fce5686f40252f6ee8f90421
MD5 8cc1238278d446016f00e5136cff78db
BLAKE2b-256 b5a939ebc9a24871079d58f5be46288248dd05f18ebe5263e7f20df1122b683c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page