Skip to main content
TuxLAVA Logo

PyPI version Code style: black PyPI - License

Documentation - Repository - Issues

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.

Table of Contents

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.

Download files

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

Source Distribution

tuxlava-0.24.0.tar.gz (130.4 kB view details)

Uploaded Source

Built Distribution

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

tuxlava-0.24.0-py3-none-any.whl (101.1 kB view details)

Uploaded Python 3

File details

Details for the file tuxlava-0.24.0.tar.gz.

File metadata

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

File hashes

Hashes for tuxlava-0.24.0.tar.gz
Algorithm Hash digest
SHA256 d360511cffa09817285444ef2eaa795ecd0d2fca79dbf18c1f6755e33f67b4ae
MD5 99d732998aafa82871eb5a7ae0449afd
BLAKE2b-256 a971878659c1e32adc0be24f9e01a2571738792e75bd3364bb6de9e90f4e602e

See more details on using hashes here.

File details

Details for the file tuxlava-0.24.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for tuxlava-0.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8d4a3be374d58f85d5699d2148739f4208958a4cca6f0ad4a4e8af36ac7a6425
MD5 f73514770eb5bb6d00d9e1d4d39b2a25
BLAKE2b-256 5fd87f9891f855504ac3363bd6adcdb3abd46c05e5d16791e85954ca01f4d2a4

See more details on using hashes here.

Supported by

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