1RT-MIGRATE-TEST(8)          System Manager's Manual         RT-MIGRATE-TEST(8)
2
3
4
5# SPDX-License-Identifier: GPL-2.0-only
6

NAME

8       rt-migrate-test - real-time task migration program
9

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

20       This program follows the usual GNU command line syntax, with  long  op‐
21       tions starting with two dashes ('--').
22
23       In  the summary of options, a value in brackets (), indicates a default
24       value
25
26       -c, --check
27              Stop if lower prio task is quicker than higher (off)
28
29       -D, --duration=TIME
30              Specify a length for the test run.
31              Append 'm', 'h', or 'd' to specify minutes, hours or days.
32
33       -e, --equal
34              Use equal prio for #CPU-1 tasks (requires > 2 CPUS)
35
36       -h, --help
37              Display usage
38
39       --json=FILENAME
40              Write final results into FILENAME, JSON formatted.
41
42       -l --loops=LOOPS
43              Number of iterations to run (50)
44
45       -m, --maxerr=TIME
46              Max allowed error (microsecs)
47
48       -p, --prio=PRIO
49              base priority to start RT tasks with (2)
50
51       -r, --run-time=TIME
52              Run time (ms) to busy loop the threads (20)
53
54       -s, --sleep-time=TIME
55              Sleep time (ms) between intervals (100)
56
57       [NR_TASKS]
58              number of tasks to run (number of cpus + 1)
59

AUTHOR

61       rt-migrate-test was written by Steven Rostedt <srostedt@redhat.com>
62
63       This manual page was written by John Kacur <jkacur@redhat.com>
64
65
66
67                              September 18, 2020            RT-MIGRATE-TEST(8)
Impressum