rt-app(1)

📦 version 1.0, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 rt-app — the manual, but make it cute 💖

okay bestie, gather round, because this one is literally the manual page for rt-app from the General Commands Manual section, and we're about to make it make sense. no cap. 🫶

✨ NAME ✨

rt-app — a test application for simulating a real-time periodic load. yes that's the whole vibe. it does the thing. 💅

🌸 SYNOPSIS 🌸

rt-app <config-file>

that's it. that's the whole synopsis. one argument. iconic behaviour honestly. 👑

🦋 INTRODUCTION 🦋

okay so rt-app is a test application, right, and what it does is it starts multiple periodic threads in order to simulate a real-time periodic load. that's the entire job description. no side quests. 🎀

and the way that the code is currently maintained on GitHub at:

https://github.com/scheduler-tools/rt-app

go say hi. star it. it's giving open source royalty fr fr. ⭐

🌈 REQUIREMENTS 🌈

  • rt-app runs on GNU/Linux. periodt, we don't do other platforms here.
  • it needs json-c to run. non-negotiable bestie.
  • and it needs a 3.14 or later linux kernel supporting the SCHED_DEADLINE policy — unless it was built without the optional libdl. so like, check your kernel version before you come crying to me, okay? 😭
this is the "make sure you actually meet the requirements" section and yes it matters, don't skip it 💀

👑 USAGE 👑

so you run:

rt-app <config_file>

where config file is a full/relative path to a JSON file — or, plot twist, "-" (without quotes, bestie, without quotes) to read JSON data from stdin. yes, you can pipe it. main character behaviour. 🧚

and for the details of the JSON config file format, go look at:

/usr/share/doc/rt-app/tutorial.txt

read it. love it. it's right there. 💜

💫 SEE ALSO 💫

  • workgen <config_file> can be used instead of rt-app directly. the way that it allows more freedom in writing the JSON workload files, by having a less strict grammar — which is useful for defining multiple similar events. it will parse, check and update the JSON workload file before passing it to rt-app. so it's like a lil assistant that preps everything for you. slay. see workgen(7). 🎀
  • the python merge script at /usr/share/doc/rt-app/examples/merge.py can be used to combine JSON snippets into the config file. e.g:
./merge.py -o combined.json global.json resources.json thread0.json thread1.json thread2.json thread3.json

like, it takes all your lil JSON pieces and welds them into one combined.json. ate. 🔥

🍓 FILES 🍓

numerous example workloads and building blocks can be found in:

/usr/share/doc/rt-app/examples/*.json

go browse. go explore. go be inspired. it's giving free homework answers. 🙈

reminder bestie: every path, every flag, every requirement above is exactly as written — I did not make any of it up, and neither should you 💅

okay that's the whole page, mwah 💖 — this was rt-app, from the General Commands Manual, version rt-app dated 2016-01-25, still out here being rt-app(1) and still serving real-time periodic load realness. bye bestie, go schedule something. 🫶✨🌸

📦 where this page comes from