rt-migrate-test(8)

Usage

rt-migrate-test [{-c | --check}] [{-D | --duration TIME}] [{-e | --equal}] [{-h | --help}] [--json FILENAME] [{-l | --loops LOOPS}] [{-m | --maxerr TIME}] [{-p | --prio PRIO}] [{-r | --run-time TIME}] [{-s | --sleep-time TIME}] [NR_TASKS]

# SPDX-License-Identifier: GPL-2.0-only

Overview

Test real-time multiprocessor scheduling of tasks to ensure the highest priority tasks are running on all available CPUs

Options

This program follows the usual GNU command line syntax, with long options starting with two dashes ('--').

In the summary of options, a value in brackets (), indicates a default value

-c, --check: Stop if lower prio task is quicker than higher (off)

-D, --duration=TIME: Specify a length for the test run.
Append 'm', 'h', or 'd' to specify minutes, hours or days.

-e, --equal: Use equal prio for #CPU-1 tasks (requires > 2 CPUS)

-h, --help: Display usage

--json=FILENAME: Write final results into FILENAME, JSON formatted.

-l --loops=LOOPS: Number of iterations to run (50)

-m, --maxerr=TIME: Max allowed error (microsecs)

-p, --prio=PRIO: base priority to start RT tasks with (2)

-r, --run-time=TIME: Run time (ms) to busy loop the threads (20)

-s, --sleep-time=TIME: Sleep time (ms) between intervals (100)

[NR_TASKS]: number of tasks to run (number of cpus + 1)

Releases

6 releases since Debian 9 (Stretch); the text changed 3 times.

--duration since Debian 11 (Bullseye); --equal since Debian 12 (Bookworm); --json since Debian 12 (Bookworm); -D since Debian 11 (Bullseye).