RUNLIM(1)

✨ runlim — bestie, it's a benchmark runner ✨

okay so before we even get into it: this is the manual page for runlim, from the General Commands Manual section of your friendly neighbourhood man pages. it's a program to run benchmarks. yes, that's the whole NAME section, we're starting strong 💅

🌸 SYNOPSIS 🌸

runlim [ options ...] command [ arguments ...]

like. you give it a command. it runs it. that's the vibe 🫶

🦋 DESCRIPTION 🦋

run — yep, that's what it's called in the description, we don't question it — is a tool you use to run and control benchmarks. it executes whatever command you hand it (with optional arguments), takes lil samples of resource usage while it's going, and then — this is the main character moment — kills the process and all its child processes if a certain time and/or space limit gets exhausted. periodt 💀

every 100 milliseconds, runlim grabs a sample of the program's resource utilization, and it logs status info to stderr every 1 second. and if you want? you can log that status to a file instead. optionally. your call bestie ✨

now for the multi-threaded girlies 👑 — you can limit those by setting a wall clock timeout. runlim follows the same time accumulation scheme as GNU time for multi-threaded programs and for programs that spawn multiple child processes: the time spent in each thread/child gets summed up 🧮 — unless you're only interested in walk clock time, in which case, different story, do your thing 🌈

🎀 OPTIONS 🎀

runlim accepts the following options:

• -h, --help — show a summary of the options. your girl loves a summary 💖
• --version — show the version of the program. iconic. we love a version number 🎀
• -o FILE, --output-file=FILE — overwrite or create FILE for output logging. so like, log to a file, not just vibes ✨
• -s NUM, --space-limit=NUM — set the space limit to NUM megabytes 📦
• -t NUM, --time-limit=NUM — set the time limit to NUM seconds ⏰
• -r NUM, --real-time-limit=NUM — set the real time limit to NUM seconds 🕰️ (that's the wall clock one, bestie)
• -k, --kill — propagate signals 🔪

💜 SEE ALSO 💜

go read these too, they're all lowkey related:

time(1), timelimit(1), timeout(1), time(7).

👑 AUTHOR 👑

runlim was written by Armin Biere and Toni Jussila. legends, honestly 🫶

this manual page was written by Thomas Krennwallner <tkren@kr.tuwien.ac.at>, for the Debian project (and may be used by others). slay 💅

ok that's the whole page, no cap. go run some benchmarks, bestie 🌸

this page was dated February 11, 2011 and it lives in section 1 of the manual under the name RUNLIM — mwah, that's it, that's the sign-off 💖✨