---
name: "rt-app"
section: "1"
platform: "linux"
package: "rt-app"
version: "1.0-1.2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rt-app"
---

# rt-app(1)

Test application for simulating a real-time periodic load

```

```

## NAME

rt-app - Test application for simulating a real-time periodic load

## SYNOPSIS

**rt-app** *\<config-file\>*

## INTRODUCTION

**rt-app** is a test application that starts multiple periodic threads in order to simulate a real-time periodic load.

The code is currently maintained on GitHub: *https://github.com/scheduler-tools/rt-app*

## REQUIREMENTS

**rt-app** runs on GNU/Linux.  It needs json-c to run, and a 3.14 or later linux kernel supporting the SCHED\_DEADLINE policy (unless built without the optional libdl).

## USAGE

**rt-app** *\<config\_file\>* where config file is a full/relative path to a JSON file or "-" (without quotes) to read JSON data from stdin.

See  */usr/share/doc/rt-app/tutorial.txt* for details of the JSON config file format

## SEE ALSO

**workgen** *\<config\_file\>* can be used instead of rt-app directly. 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. See **workgen**(7)

The python merge script ( */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*

## FILES

```
Numerous example workloads and building blocks can be found in
/usr/share/doc/rt-app/examples/*.json
```