Reference

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

History

--baselog until Debian 8 (Jessie); --duration until Debian 8 (Jessie); --fifo until Debian 8 (Jessie); --frag until Debian 8 (Jessie); --gnuplot until Debian 8 (Jessie); --help until Debian 8 (Jessie); --logdir until Debian 8 (Jessie); --no-mlock until Debian 8 (Jessie); --qos until Debian 8 (Jessie); --rr until Debian 8 (Jessie); --spacing until Debian 8 (Jessie); -D until Debian 8 (Jessie); -G until Debian 8 (Jessie); -K until Debian 8 (Jessie); -b until Debian 8 (Jessie); -f until Debian 8 (Jessie); -g until Debian 8 (Jessie); -h until Debian 8 (Jessie); -l until Debian 8 (Jessie); -q until Debian 8 (Jessie); -r until Debian 8 (Jessie); -s until Debian 8 (Jessie).