LinuxCommandLibrary

lavadecode

Decode Lava language files

SYNOPSIS

lavadecode [options...] [input_file]

PARAMETERS

-h, --help
    Show help message and exit

-o , --output
    Write output to specified file (default: stdout)

--output-format
    Set format: yaml (default), json, or text

-d, --debug
    Enable verbose debug logging

-V, --version
    Display lavadecode version

DESCRIPTION

lavadecode is a utility in the Linaro Automated Validation Architecture (LAVA) ecosystem for converting compact binary output from LAVA test jobs into human-readable formats. LAVA is widely used for automated testing of embedded Linux systems, kernels, and bootloaders on CI platforms.

During LAVA test execution, test shells (like lava-test-shell) generate efficient binary logs containing test results, measurements, pass/fail statuses, and runtime data. These binaries are transmitted from DUTs (Devices Under Test) to servers but require decoding for analysis. lavadecode parses this data, reconstructing structured output for easy integration with reporting tools, dashboards, or scripts.

Common workflows involve downloading job output tarballs from LAVA servers, extracting the binary (job-output), and piping/decoding it. Supports YAML (default), JSON, or text formats, making it ideal for parsing in automation pipelines. Essential for kernel developers, distro maintainers, and hardware validation teams.

CAVEATS

Input from stdin if no file specified; requires LAVA client libraries (e.g., python3-lava). Binary must be valid LAVA output or parsing fails silently.

EXAMPLE USAGE

lavadecode job-output > results.yaml
lavadecode --output-format json input.bin

INSTALLATION

On Debian/Ubuntu: sudo apt install lava-dev or pip install lava-dispatcher

HISTORY

Developed by Linaro as part of LAVA v1 (2012-2015), matured in LAVA v2 (2016+). Actively maintained for embedded CI; latest releases align with LAVA dispatcher updates.

SEE ALSO

lava-test-shell(1), lava(7)

Copied to clipboard