Command line tool for testing Linux under QEMU
Project description
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.
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
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
Built Distribution
File details
Details for the file tuxrun-0.68.1.tar.gz.
File metadata
- Download URL: tuxrun-0.68.1.tar.gz
- Upload date:
- Size: 355.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.28.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 142447f469959541b2aae1d7f8b30c76ebc4589c38b353416323fc0d565126f2 |
|
| MD5 | 5062d5360b93085324fa21741a125108 |
|
| BLAKE2b-256 | 4a182adb0d2a387ae0b8c7a07345326317721f7a0ac4fb0b78b0ee1a556d64ba |
File details
Details for the file tuxrun-0.68.1-py3-none-any.whl.
File metadata
- Download URL: tuxrun-0.68.1-py3-none-any.whl
- Upload date:
- Size: 72.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.28.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7e52a924cd90bc1b22ff1a2e228b47a715ab6ebe55d48ca29fcc358cc90f9bd3 |
|
| MD5 | 6c180821fa9e126cdd8b06842d0cc849 |
|
| BLAKE2b-256 | 66360a9b987c95339a8aa7b3d9a17897a58a478564255a71224584f251422854 |
