XRT-RUNNER(1)

💅 XRT-RUNNER — ok bestie, time to run some workloads ✨

So like, this is xrt-runner(1), a User Commands page, and it's literally the girl whose whole job is executing XRT runner recipe/profile workloads. She's booked, she's busy, she's iconic. Let's get into it 🎀

✨ SYNOPSIS ✨

xrt-runner [--recipe recipe.json] [--profile profile.json]
[--script runner.json] [--iterations N] [--threads N] [--queue-limit N]
[--dir PATH] [--mode latency|throughput|validate] [--verbose N]
[--progress] [--report [FILE]]

🌸 DESCRIPTION 🌸

xrt-runner runs XRT workloads, and those workloads are defined by either recipe and profile JSON files, or by a runner script if you're doing the multi-threaded thing. That's it, that's the vibe. Two whole ways to feed her and she eats every time 💖

👑 OPTIONS 👑

• --recipe — the recipe file you want to run. that's the one, bestie 🍓
• --profile — the execution profile file. it's giving configuration, it's giving structure ✨
• --script — a runner script, for when you want multi-threaded execution. main character energy fr 🧚
• --iterations — overrides the profile iterations. you said how many, she does how many, no questions 💅
• --threads — how many worker threads you get in script mode. more threads, more girlies working at once 🫶
• --queue-limit — the maximum pending jobs in script mode. a lil bouncer at the door keeping the line from getting unhinged 😭
• --dir — the directory containing the referenced artifacts. everything she needs, all in one place, organized, slay 🎀
• --mode — run only the selected mode: latency, throughput, or validate. pick one, she's focused 🌈
• --verbose — sets the XRT verbosity level. turn it up when you need to know everything, no cap 👀
• --progress — shows execution progress. live updates, we love to see it 🔥
• --report — writes the metrics report to a file — or straight to stdout when you don't hand her a file. generous queen 💜

💖 SEE ALSO 💖

• xrt-smi(1)

ok that's the whole page bestie, go run something iconic 💅✨

this was the XRT XRT-RUNNER(1) page, dated March 2026 — mwah, take care of her 🫶