1RTEVAL(8) System Manager's Manual RTEVAL(8)
2
6 rteval - evaluate latency performance of a realtime Linux system
7
9 rteval [ -hvsLSDOZ ] [-d duration ] [-w workdir ] [-l loaddir ] [-X
10 host ]
11 The rteval program is used to evaluate the realtime performance of a
14 realtime Linux kernel on a particular hardware system. There is nothing
15 that actually requires a realtime Linux kernel, but the latency mea‐
16 surements will usually be pretty bad on a stock Linux kernel.
17
21 These programs follow the usual GNU command line syntax, with long op‐
22 tions starting with two dashes ('--').
23 A summary of options is included below.
24 -h, --help
26 print a help message
27 -d, --duration=DURATION
29 Specify the length of the measurement run. DURATION is an inte‐
30 ger with an optional suffix indicating the units:
31 s - seconds
33 m - minutes
34 h - hours
35 d - days
36 for example to execute a ten minute run of rteval:
37 $ rteval --duration=10m
38 -v, --verbose
40 Increase the verbosity of output during the test run
41 -w WORKDIR, --workdir=WORKDIR
43 Tell rteval to change directory to WORKDIR before creating any
44 subdirectories for report files. The default WORKDIR is the di‐
45 rectory in which rteval was started.
46 -l LOADDIR, --loaddir=LOADDIR
48 Tell rteval where to find the source for the loads
49 --loads-cpulist=CPULIST
51 List of CPUs where loads will run
52 --measurement-cpulist=CPULIST
54 List of CPUs where measurement applciation will run
55 -s, --sysreport
57 Have rteval run the sysreport utility after a run to gather in‐
58 formation on the running system.
59 -D, --debug
61 Turn on debugging prints during run
62 -X HOST, --xmprpc-submit=HOST
64 Have rteval send report data to HOST following the run, using
65 XML-RPC
66 -P, --xmlrpc-no-abort
68 Do not abort if XML-RPC server do not respond to ping request
69 -Z, --summarize
71 Have rteval summarize an existing report. This will not cause
72 loads or meausurement utilities to be run.
73 -H, --raw-histogram
75 Generate raw histogram data for an already existing XML report
76 -f INIFILE, --inifile=INIFILE
78 Initialization file for configuring loads and behavior
79 -a COMMENT, --annotate=COMMENT
81 Add a little annotation which is stored in the report
82 -L, --logging
84 Log the output of the loads in the report directory
85 -O, --onlyload
87 Only run the loads (don't run measurement threads)
88 -S KERNEL_VERSION, --source-download=KERNEL_VERSION
90 download a source kernel from kernel.org and exit
91
95 These are options that affect the execution behavior of the measurement
96 and load modules.
97 --cyclictest-priority=PRIORITY
99 SCHED_FIFO priority for measurement threads (default: 95)
100 --cyclictest-interval=INTERVAL
102 Measurement thread interval in microseconds (default: 100)
103 --cyclictest-distance=DISTANCE
105 Interval increment in microseconds (default: 0)
106 --cyclictest-buckets=NBUCKETS
108 Number of 1 microsecond histogram buckets (default: 3500)
109 --hackbench-jobspercore=N
111 Number of jobs per online-core for hackbench load
112 --kcompile-jobspercore=N
114 Number of jobs per online-core for kernel compile load
115
118 rteval-YYYYMMDD-S This is a directory created by rteval to hold the
119 summary.xml file as well as other files collected on the system. It is
120 the current Year, Month, and Day, followed by a sequence number for
121 multiple runs on the same day.
122 summary.xml This is an XML file that contains information about a test
124 run and the host system upon which rteval was run. dmesg This is the
125 output of the dmesg(1) program immediately following system boot. It is
126 copied from /var/log/dmesg.
127
130 cyclictest(8).
131
133 rteval was written by Clark Williams <williams@redhat.com>
134 XML-RPC and database code by David Sommerseth <davids@redhat.com>
136 august 27, 2009 RTEVAL(8)