TuxLAVA is a command-line tool and Python library that simplifies creating LAVA job definitions for various device types. Developed by Linaro, it's part of TuxSuite and streamlines Linux kernel test automation.

AVH
FASTBOOT
FVP
NFS
QEMU
SSH

TuxLAVA is a part of TuxSuite, a suite of tools and services to help with Linux kernel development.

Installing TuxLAVA
Examples
Using TuxLAVA as a command line
Using TuxLAVA as a library
Contributing

Installing TuxLAVA

Examples

LAVA job to boot test a mipsel kernel at https://url/to/vmlinux:

tuxlava --device qemu-mips32el \
    --kernel https://url/to/vmlinux

Generate a LAVA job with ltp-smoke test:

tuxlava --device qemu-mips32el \
    --kernel https://url/to/vmlinux \
    --test ltp-smoke

Using TuxLAVA as a command line

Call tuxlava as follows:

tuxlava --device nfs-x86_64 \
    --kernel https://url/to/Image \
    --modules https://url/to/modules /usr/ \
    --rootfs https://url/to/rootfs \
    --tests boot

The --kernel, --modules, and --rootfs arguments can be URLs (e.g. https://...), file URLs (e.g. file:///...), or absolute file paths (e.g. /path/to/Image).

TuxLAVA will output the LAVA job to the stdout with the provided arguments for x86_64 device

The complete list of tuxlava options is available with the following command:

tuxlava --help

Using TuxLAVA as a library

TuxLAVA can be used as a python library as follows:

#!/usr/bin/env python

from tuxlava.jobs import Job

job = Job(
    device="nfs-x86_64",
    kernel="https://url/to/bzImage",
    rootfs="https://url/to/rootfs.tar.xz",
    tests=["ltp-smoke", "ltp-math"],
    modules="https://url/to/modules.tar.xz",
    parameters={"LAVA_JOB_PRIORITY": 50},
    timeouts={"deploy": 20},
)
job.initialize()
print(job.render())

Contributing

Contributions, bug reports and feature requests are welcome! Please see the issues or open a pull request.

Release files for tuxlava 0.26.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tuxlava 0.26.0
File	Size	Uploaded
tuxlava-0.26.0.tar.gz	116.6 kB	Sep 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for tuxlava 0.26.0
File	Interpreter	ABI	Platform	Reset
tuxlava-0.26.0-py3-none-any.whl 109.2 kB Sep 24, 2026	Python 3	none	any	Details

Total release size: 225.7 kB

Release files / tuxlava-0.26.0.tar.gz

Download URL	tuxlava-0.26.0.tar.gz
Size	116.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`250b3cb40ab97f638948ac2c7a717a85d0d644c4e64b610d73eb4d14e45f117e`
BLAKE2b-256 checksum How to use checksums	`4ebd7d681e8f7e4c6f6f3139cdab0ffecf925864eb887c931f3275055742ff18`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`python-requests/2.34.2`

Release files / tuxlava-0.26.0-py3-none-any.whl

Download URL	tuxlava-0.26.0-py3-none-any.whl
Size	109.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c2a5eacd5cd0dd0135ad32ed2198fc44164bed3f94d98bfd3866a217a773bf14`
BLAKE2b-256 checksum How to use checksums	`fdb5116e574f71f610b9b3ef1994ffdc85f2db97498c4d4aa1bdefc6ff6671b1`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`python-requests/2.34.2`