---
name: "runlim"
section: "1"
platform: "linux"
package: "runlim"
version: "1.10-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/runlim"
---

# runlim(1)

a program to run benchmarks

## NAME

runlim - a program to run benchmarks

## SYNOPSIS

**runlim** \[ *options*  ...\]  *command*  \[ *arguments*  ...\]

## DESCRIPTION

**run** is a tool that can be used to run and control benchmarks. It executes a given *command* with (optional) *arguments*, samples resource usage during the run, and kills the process (and its child processes) if a certain time and/or space limit is exhausted.

Every 100 milliseconds, **runlim** takes a sample of the program's resource utilization, and logs status information to stderr every second. Optionally, the status can be logged to a file.

Multi-threaded programs can be limited by setting a wall clock timeout.  **runlim** follows the time accumulation scheme of **GNU** **time** for multi-threaded programs and programs that spawn multiple child-processes: time spent in each thread/child is summed up, unless you are only interested in walk clock time.

## OPTIONS

**runlim** accepts the following options:

- **-h, --help**

  Show summary of options.

- **--version**

  Show version of program.

- **-o FILE, --output-file=FILE**

  Overwrite or create FILE for output logging.

- **-s NUM, --space-limit=NUM**

  Set space limit to NUM megabytes.

- **-t NUM, --time-limit=NUM**

  Set time limit to NUM seconds.

- **-r NUM, --real-time-limit=NUM**

  Set real time limit to NUM seconds.

- **-k, --kill**

  Propagate signals.

## SEE ALSO

[**time**(1)](/time/1.md), [**timelimit**(1)](/timelimit/1.md), [**timeout**(1)](/timeout/1.md), [**time**(7)](/time/7.md).\

## AUTHOR

runlim was written by Armin Biere and Toni Jussila.

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