lavadecode
Decode Lava language files
SYNOPSIS
lavadecode [options...] [input_file]
PARAMETERS
-h, --help
Show help message and exit
-o
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)


