LAVA-RUN(1)

👑 LAVA-RUN(1) — the lava-run girlies' guide 💅

okay so bestie, welcome to lava-run, from the General Commands Manual (yes, section 1, we're in the big leagues 🎀). pull up a chair, grab a boba, and let's get into it.

---

✨ NAME ✨

lava-run — run jobs on LAVA devices 🌸

---

💖 SUMMARY 💖

so lava-run runs a LAVA test job on the reserved device, exactly as scheduled by the lava-scheduler, and then publishes the test result back to the server. it's giving courier. it's giving messenger pigeon but make it CI 🦋

jobs are scheduled by the server, but lowkey you can also just run them by calling lava-run directly. main character energy, no middleman.

if you wanna see an up-to-date list of supported target devices, just go look at the device types on the relevant server. that's it. that's the vibe check. ✨

---

🎀 USAGE 🎀

lava-run [-h] --job-id ID --output-dir DIR [--validate]
       [--url URL] [--token token] --device PATH [--dispatcher PATH]
       [--env-dut PATH] [--debug] definition

---

💅 OPTIONS 💅

🌈 positional arguments:

• definition — the job definition. that's the whole snack right there.

⭐ optional arguments:

• -h, --help — show this help message and exit. the classic. the icon. the "i don't know what i'm doing so i ask politely" button 🙈
• --job-id ID — Job identifier. this alters the process name for easier debugging, so when you're staring at ps output at 2am you can actually tell which job is which. obsessed.
• --output-dir DIR — Directory for temporary resources. it's where the temporary stuff goes. you know. the little guys 🍓
• --validate — validate the job file, do not execute any steps. the description is saved into description.yaml. so like, a vibe check before the actual performance. no cap, this one's a good idea.
• --debug — Start remote pdb right before running the job, for debugging. yeah bestie we're going IN with the debugger 🔥

🧚 logging:

• --url URL — URL of the server to send logs.
• --token token — token for server authentication. keep it secret, keep it safe, don't post it in the group chat 💀

🦋 configuration files:

• --device PATH — Device configuration
• --dispatcher PATH — Dispatcher configuration
• --env-dut PATH — DUT environment

---

💜 MORE INFO 💜

for more information on writing job definition and tests, look at:

• https://validation.linaro.org/static/docs/v2/first-job.html
• https://validation.linaro.org/static/docs/v2/contents.html#writing-tests-for-lava

---

🌸 AUTHOR 🌸

Linaro Validation Team 👑

---

🫶 COPYRIGHT 🫶

2010-2023, Linaro Limited

---

and that's the whole page, bestie 💖 this one's from 2023.01, dated January 23, 2023 — so it's giving slightly vintage but still absolutely slaying. go forth and run those jobs, lava-run girlies, periodt ✨🌈🎀