TuxRun Logo

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.

Table of Contents

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 links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

3 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for ben_copeland from gravatar.com ben_copeland Avatar for ivoire from gravatar.com ivoire Avatar for roxell from gravatar.com roxell

Credits

Author: Antonio Terceiro

Maintainer: Anders Roxell

License

MIT License

Requires

Python >=3.10

Classifiers

Report project as malware

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.11.0.tar.gz (290.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tuxrun-1.11.0-py3-none-any.whl (27.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for tuxrun-1.11.0.tar.gz
Algorithm Hash digest
SHA256 aeac0bc3c6ce6c9f2ee36d41eb4f10a909307aecb4ed250602a3fc28e0401c0d
MD5 4d05c876d38139a7810e3a8889c42acf
BLAKE2b-256 3ec3d33754ef1d8a664e92fe7082b75d825141823fb8db5b8df6ea39800938d4

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for tuxrun-1.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eb061a6781f50bce0daff464a0359fcb88b3459fde634c2db940cafe6ccde6ec
MD5 31212a21dfd93bb741a24cbb1e0ddcd0
BLAKE2b-256 f3b55ddd572951d0bee3b0da5af8f20470d66fddf756daf0f6347587211f3dbe

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.11.0 This release

2 files

1.10.0

2 files

1.9.0

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.0

2 files

1.0.0

2 files

0.77.0

2 files

0.76.0

2 files

0.75.0

2 files

0.74.2

2 files

0.74.1

2 files

0.74.0

2 files

0.73.3

2 files

0.73.2

2 files

0.73.1

2 files

0.73.0

2 files

0.72.2

2 files

0.72.1

2 files

0.71.0

2 files

0.70.0

2 files

0.69.2

2 files

0.69.1

2 files

0.69.0

2 files

0.68.2

2 files

0.68.1

2 files

0.68.0

2 files

0.67.0

2 files

0.66.2

2 files

0.66.1

2 files

0.66.0

2 files

0.65.0

2 files

0.64.4

2 files

0.64.3

2 files

0.64.2

2 files

0.64.1

2 files

0.64.0

2 files

0.63.2

2 files

0.63.1

2 files

0.63.0

2 files

0.62.2

2 files

0.62.1

2 files

0.62.0

2 files

0.61.0

2 files

0.60.1

2 files

0.60.0

2 files

0.59.2

2 files

0.59.0

2 files

0.58.1

2 files

0.58.0

2 files

0.57.0

2 files

0.56.0

2 files

0.54.0

2 files

0.53.0

2 files

0.52.0

2 files

0.51.0

2 files

0.50.0

2 files

0.49.2

2 files

0.49.1

2 files

0.49.0

2 files

0.48.0

2 files

0.47.0

2 files

0.46.0

2 files

0.45.0

2 files

0.44.2

2 files

0.44.1

2 files

0.44.0

2 files

0.43.1

2 files

0.43.0

2 files

0.42.0

2 files

0.41.0

2 files

0.40.0

2 files

0.39.0

2 files

0.38.1

2 files

0.38.0

2 files

0.37.2

2 files

0.37.1

2 files

0.37.0

2 files

0.36.0

2 files

0.35.2

2 files

0.35.1

2 files

0.35.0

2 files

0.34.2

2 files

0.34.1

2 files

0.34.0

2 files

0.33.0

2 files

0.32.2

2 files

0.32.1

2 files

0.32.0

2 files

0.31.1

2 files

0.31.0

2 files

0.30.0

2 files

0.29.0

2 files

0.28.0

2 files

0.27.1

2 files

0.27.0

2 files

0.26.0

2 files

0.25.0

2 files

0.24.0

2 files

0.23.2

2 files

0.23.1

2 files

0.23.0

2 files

0.22.1

2 files

0.22.0

2 files

0.21.4

2 files

0.21.3

2 files

0.21.2

2 files

0.21.1

2 files

0.21.0

2 files

0.20.0

2 files

0.19.3

2 files

0.19.2

2 files

0.19.1

2 files

0.19.0

2 files

0.18.3

2 files

0.18.2

2 files

0.18.1

2 files

0.18.0

2 files

0.17.4

2 files

0.17.3

2 files

0.17.2

2 files

0.17.1

2 files

0.17.0

2 files

0.16.2

2 files

0.16.1

2 files

0.16.0

2 files

0.15.3

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

0.14.0

2 files

0.13.0

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.6

2 files

0.9.5

2 files

0.9.4

2 files

0.9.3

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.3

2 files

0.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page